z/OS V1R6.0 DFSMS Access Method Services for Catalogs

Invoking from ProgramYou cannot use the IDCAMS ALLOCATE command after using ATTACH to callIDCAMS. If you do, ALLOCATE fails with an ATTACH return code.The syntax of the LINK or ATTACH macro instruction is:[label] LINK|ATTACH EP=IDCAMS,PARAM=(optionaddr[,dnameaddr][,pgnoaddr][,iolistaddr][,auxlistaddr]),VL=1EP=IDCAMSspecifies that the program to be invoked is IDCAMS.PARAM=specifies the addresses of the parameters to be passed to IDCAMS. Thesevalues can be coded:optionaddrspecifies the address of an option list, which can be specified in the PARMparameter of the EXEC statement and is a valid set of parameters for theaccess method services PARM command. If you do not want to specify anyoptions, this address must point to a halfword of binary zeros. Figure 31on page 425 shows the format of the options list.dnameaddrspecifies the address of a list of alternate ddnames for standard data setsused during IDCAMS processing. If standard ddnames are used and this isnot the last parameter in the list, it should point to a halfword of binaryzeros. If it is the last parameter, it can be omitted. Figure 31 on page 425shows the format of the alternate ddname list.pgnoaddrspecifies the address of a 3- to 6-byte area that contains an EBCDICstarting page number for the system output file. If the page number is notspecified, but this is not the last parameter in the list, the parameter mustpoint to a halfword of binary zeros. If it is the last parameter, it can beomitted. If omitted, the default page number is 1. Figure 31 shows theformat of the page number area.iolistaddrspecifies the address of a list of externally controlled data sets and theaddresses of corresponding I/O routines. If no external I/O routines aresupplied, this parameter can be omitted. Figure 31 shows the format of theI/O list.auxlistaddrspecifies the address of the auxiliary list. Figure 31 on page 425 shows theformat of the auxiliary list.VL=1causes the high-order bit of the last address parameter of the PARAM listto be set to 1.422 z/OS V1R6.0 DFSMS Access Method Services for Catalogs