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

Invoking from ProgramARGUMENT LISTOPTIONS LISTREG 1PPI (Problem Program InterfaceARGUMENT LIST)OPTIONSLISTDDNAMESLISTPAGE NUMBERLISTIOLISTAUX LISTLENGTHPAGE NUMBERALENGTHOPTIONSOPTIONS LIST: Required.Provides a way to specify processingoption. If you do not wish tospecify any options, you must set theLENGTH field to binary zeros.LENGTH: Halfword that specifiesthe number of bytes in the OPTIONS field.OPTIONS: Character string thatcontains the processing options of the accessmethod services PARM command. The optionsmay be specified in the PARM field ofthe EXEC statement or they may be set upby the problem program. The options mustcomply with the parameter syntax of theaccess method services PARM command.INPUT/OUTPUT LISTnDDNAME1IOROUTINE1USER DATA1DDNAMEnIOROUTINEnUSER DATAnPAGE NUMBER LIST: Optional. Providesa way to specify the starting page numberfor system output.LENGTH: A halfword that specifies the numberof bytes in the PAGE NUMBER field.PAGE NUMBER: 1- to 4 byte character string thatcan specify the starting page number of systemoutput listing. This value is reset to the currentpage number upon completion of the presentinvocation of the access method services processor.INPUT/OUTPUT LIST: Optional. Provides the means ofidentifying those data sets for which the invokerwishes to manage all I/O operations.n: A fullword that specifies the number of groups ofthree fields that follow. Each group consists of aDDNAME address, an IOROUTINE address, and aUSER DATA address.DDNAME: Address of a character string that identifiesa data set that will result in the invocation of theassociated IOROUTINE for all I/O operations(including OPEN and CLOSE) against the data set.The character string identifies the data set as either a10-byte or 46-byte character string as follows:A 10-byte character string: The first two charactersare ‘DD’. The next 8 characters are the DDNAME fieldvalue left-justified (padded with blanks as necessary),which can appear in the FILE, INFILE, or OUTFILEparameters of any access method services command.The SYSIN and SYSPRINT ddnames can also appear ifthe invoker wishes to manage these data sets.A 46-byte character string: The first two characters are‘DS’. The next 44 characters are the data set nameleft-justified (padded with blanks if necessary), which canappear in the INDATASET, OUTDATASET, or DATASETparameters of any access method services command.DDNAMES LISTLENGTH(2 bytes)binary zeros(8 bytes)binary zeros(8 bytes)binary zeros(8 bytes)binary zeros(8 bytes)SYSINSYSPRINTDDNAMES LIST:Optional. Providesa way to specifyalternative namesfor the SYSIN andSYSPRINT data sets.LENGTH: halfwordthat specifies thenumber of bytes in thereminder of the list.DDNAME: Unseparated8-character ddnames, leftjustified,and padded withblanks. To change thename ofSYSIN or SYSPRINT,supply an alternate namein the same position.If an alternate name isnot supplied, thestandard name is assumed.If the name is not suppliedwith the list, the 8-byteentry must contain binaryzeros. Names in anyposition other than thosefor SYSIN and SYSPRINTare ignored.Note: No record descriptorword (RDW) will be passedback from IDCAMS for theSYSPRINT data set.Figure 31. Processor Invocation Argument List from Your Program (Part 1 of 2)Appendix D. Invoking Access Method Services from Your Program 425