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

Invoking from ProgramLOAD and CALL Macro InstructionsAccess method services is also invoked with a LOAD of the module IDCAMS,followed by a CALL to that module. The syntax of the LOAD macro instruction is:[label] LOAD {EP=IDCAMS|EPLOC=address of name}where:EP=IDCAMSis the entry point name of the IDCAMS program to be loaded into virtualstorage.EPLOC=address of nameis the address of an 8-byte character string IDCAMSbb.After loading IDCAMS, register 15 must be loaded with the address returned fromthe LOAD macro. Use CALL to pass control to IDCAMS. The syntax of the CALLmacro instruction is:LR 15,0[label] CALL (15),(optionaddr[,dnameaddr][,pgnoaddr][,iolistaddr][,auxlistaddr]),VLwhere:15 is the register containing the address of the entry point to be given control.optionaddrspecifies the address of an options list that 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 31 onpage 425 shows the format of the options list.dnameaddrspecifies the address of a list of alternate ddnames for standard data sets usedduring IDCAMS processing. If standard ddnames are used and this is not thelast parameter in the list, it should point to a halfword of binary zeros. If it isthe last parameter, it can be omitted. Figure 31 on page 425 shows the formatof the alternate ddname list.pgnoaddrspecifies the address of a 6-byte area that contains an EBCDIC starting pagenumber for the system output file. If the page number is not specified, but thisis not the last parameter in the list, the parameter must point to a halfword ofbinary zeros. If it is the last parameter, it can be omitted. If omitted, the defaultpage number is 1. Figure 31 on page 425 shows the format of the page numberarea.Appendix D. Invoking Access Method Services from Your Program 423