How to determine the appropriate SYSLIB concatenation

The recommended method for determining the appropriate SYSLIB concatenation treats the distribution libraries as totally separate from the target libraries.

Note: The example shown is for processing a zone for SREL Z038 containing the z/OS® base control program (BCP). For other zones, follow the recommendations for the products residing in those zones.

Treating the distribution libraries as separate from the target libraries ensures that only the latest tested version of a macro is used during an assembly. Thus, the SYSLIB concatenation at ACCEPT is different from that at APPLY.

The SMPMTS data set contains macros from SYSMODs that are applied. Therefore, the proper SYSLIB concatenation for APPLY processing includes the SMPMTS data set, as is shown in Figure 1.

Figure 1. APPLY SYSLIB concatenation: APPLY different from ACCEPT

//* ------ Include SMPMTS first
//* ------ followed by all macro target libraries
//* ------ followed by all distribution
//*        libraries
//SYSLIB   DD  DSN=SYS1.SMPMTS,DISP=OLD
//         DD  DSN=SYS1.MACLIB,DISP=OLD
//         DD  DSN=SYS1.MODGEN,DISP=OLD
//* ------ IF YOU NEED TO ASSEMBLE JES SOURCE MODULES:
//* ------ either HASPSRC (JES2) or JES3MAC (JES3)
//         DD  DSN=SYS1.HASPSRC,DISP=OLD
//         DD  DSN=SYS1.SISTMAC1,DISP=OLD
//         DD  DSN=SYS1.ATSOMAC,DISP=OLD
//         DD     •
//         DD     • other macro target libraries
//         DD     •
//         DD     •
//         DD     • any macro distribution libraries needed
//         DD     •

During ACCEPT processing, the macros in the SMPMTS and in the target macro libraries are not considered to have been tested. The SMPMTS is, therefore, not concatenated. Figure 2 shows the proper SYSLIB concatenation for ACCEPT.

Figure 2. ACCEPT SYSLIB concatenation: APPLY different from ACCEPT

//* ------ Include only macro distribution
//*        libraries
//         DD  DSN=SYS1.AMACLIB,DISP=OLD
//SYSLIB   DD  DSN=SYS1.AMODGEN,DISP=OLD
//* ------ IF YOU NEED TO ASSEMBLE JES SOURCE MODULES:
//* ------ either HASPSRC (JES2) or JES3MAC (JES3)
//         DD  DSN=SYS1.HASPSRC,DISP=OLD
//         DD  DSN=SYS1.AISTMAC1,DISP=OLD
//         DD  DSN=SYS1.ATSOMAC,DISP=OLD
//         DD     •
//         DD     • other macro distribution libraries
//         DD     •