Example 7: JCLIN for load modules residing in a UNIX file system

A load module can reside in a UNIX file system. To determine where the load module resides, SMP/E uses the following information, in addition to the usual JCL statements needed for load modules:
  • The PATH operand on the SYSLIB or SYSLMOD statement associated with the load module. The PATH operand alerts SMP/E to the fact that the load module resides in a UNIX file system; however, the PATH value specified is ignored.
  • The LIBRARYDD comment statement immediately following the statement with the PATH operand. This comment statement specifies the ddname to be associated with the PATH value on the previous DD statement.
  • The user-provided DDDEF entry whose name matches the ddname on the LIBRARYDD comment statement. The DDDEF entry specifies the directory portion of the pathname identified by the ddname. SMP/E uses the PATH value specified in the DDDEF entry to allocate the pathname, and does not check whether this value matches the PATH value specified on the SYSLIB or SYSLMOD DD statement associated with the LIBRARYDD comment statement.
Following are examples of job steps containing SYSLMOD and SYSLIB DD statements that use the PATH operand.
   //STEP1 EXEC PGM=IEWBLINK,PARM='RENT,REUS'
 1 //SYSLMOD DD PATH='/path_name1/'
 2 //*LIBRARYDD=BPXLOAD1
   //AOS12   DD DSN=SYS1.AOS12,DISP=SHR
   //SYSLIN  DD *
      INCLUDE AOS12(MOD00001)
      INCLUDE AOS12(MOD00002)
      ENTRY MOD00001
      NAME LMOD01(R)
   /*
   //STEP2 EXEC PGM=IEWBLINK,PARM='CALL,RENT,REUS'
   //SYSLMOD DD PATH=SYS1.LINKLIB,DISP=OLD
   //AOS12   DD DSN=SYS1.AOS12,DISP=SHR
 3 //SYSLIB  DD PATH='/path_calllib3/'
 4 //*LIBRARYDD=BPXCALL3
 3 //        DD PATH='/path_calllib4/'
 4 //*LIBRARYDD=BPXCALL4
   //SYSLIN  DD *
      INCLUDE AOS12(MOD00005)
      INCLUDE AOS12(MOD00006)
      ENTRY MOD00005
      NAME LMOD03(R)
   /*
 1 
Because the SYSLMOD statement specifies a PATH operand, SMP/E expects the next statement to be a LIBRARYDD comment statement.
 2 
Using the ddname on the LIBRARYDD comment statement, SMP/E updates the LMOD entry for LMOD01 to specify a SYSLIB value of BPXLOAD1. The user needs to provide a DDDEF entry for BPXLOAD1, specifying the appropriate pathname.
 3 
The SYSLIB DD statement is a concatenation of two DD statements that specify the PATH operand.
 4 
Using the ddnames on the LIBRARYDD comment statements and the low-level qualifier of the data set specified on the DSN operand, SMP/E updates the LMOD entry for LMOD03 to specify a CALLLIBS subentry list with the values BPXCALL3, and BPXCALL4. The user needs to provide DDDEF entries for BPXCALL3 and BPXCALL4, specifying the appropriate pathnames.