"DSN_XXX MUST INCLUDE '???'" MNOTE in DBSIDPR assembly

Document ID : KB000018776
Last Modified Date : 03/01/2019
Show Technical Document Details
Issue:

While installing or upgrading CA Datacom, assembly of the DBSYSID macro for the DBSIDPR module returned a Condition Code of 12 with these errors in the assembly listing:

** ASMA254I *** MNOTE *** 3+ 4,DSN_XXX MUST INCLUDE '???' 
** ASMA254I *** MNOTE *** 5+ 12,ERRORS ENCOUNTERED; SYSID MODULE NOT GENERATED 

I have this value coded: DSN_XXX=SYS1.DATACOM.V14R00.MYMUF.CXX, so I don't understand the problem.

Resolution:

Starting with version 14.0 of CA Datacom, we are providing better data integrity and protection for the Multi-User Facility (called MUF) through the use of the Simplify feature. This is a requirement for CA Datacom/AD, enabled in the DBSYSID macro definition with SIMPLIFY_MODE=YES. It is optional for CA Datacom/DB, but highly recommended.

In Simplify mode, we eliminate the possibility of using the wrong CXX or LXX/FXX in the MUF and in other jobs by removing the DD statements for the CXX, FXX, LXX from those jobs. With this feature, the MUF dynamically allocates these files based on value of the DSN_XXX file mask in the DBSIDPR module.

This mask is of the format 'xxxxxxxx.xxxxxxxx.???' where the xxxxxxxx.xxxxxxxx is replaced by the high-level qualifiers of the files you want to use in this MUF. The '???' literal string is required, and the MUF will replace '???' with 'CXX', 'LXX' or 'FXX' as appropriate.

For example, if you want to use these files:

SYS1.DATACOM.V15R00.MYMUF.CXX
S
YS1.DATACOM.V15R00.MYMUF.FXX
SYS1.DATACOM.V15R00.MYMUF.LXX

then you would code this setting in your DBSIDPR: DSN_XXX=SYS1.DATACOM.V15R00.MYMUF.???

Once this value is set correctly, the assembly should be successful.

Additional Information:

For more information about the DBSYSID macro and its various parameters, please refer to the following
Version 15.1: Administrating >  CA Datacom/DB Database and System Administration >  Using the Multi-User Facility > Modifying DBSIDPR Parameters
Version 15.0: Administrating >  CA Datacom/DB Database and System Administration >  Using the Multi-User Facility > Modifying DBSIDPR Parameters
Version 14.0:  CA Datacom/DB Database and System Administration Guide, in the section "Using the Multi-User Facility > Modifying DBSIDPR Parameters"

As always, please contact CA Technologies support for CA Datacom if you have further questions.