Invocation from a PL/I Program
Access method services can also be invoked from a PL/I program using the facilities of the IBM® PL/I Optimizing Compiler Licensed Program. IDCAMS must be declared to the compiler as an external entry point with the ASSEMBLER and INTER options. The access method services processor is loaded by issuing a FETCH IDCAMS statement, is reached with a CALL statement, and deleted by a RELEASE IDCAMS statement. The syntax of the CALL statement is:
| Command | Program | Parameters |
|---|---|---|
| CALL | IDCAMS | (options[,dnames][,pageno][,iolist] [,auxlist]); |
where:
- options
- specifies a valid set of parameters for the access method services PARM command. If no parameters are to be specified, options should be a halfword of binary zeros. Figure 1 shows the format of the options area.
- dnames
- specifies a list of alternate ddnames for standard data sets used during IDCAMS processing. If standard ddnames are used and this is not the last parameter in the list, dnames should be a halfword of binary zeros. If it is the last parameter, it can be omitted. Figure 1 shows the format of the alternate ddnames list.
- pageno
- specifies a 6-byte field that contains an EBCDIC starting page number for the system output file. If the page number is not specified, but this is not the last parameter in the list, the parameter must be a halfword of binary zeros. If it is the last parameter, it can be omitted. If not specified, the default page number is 1. Figure 1 shows the format of the page number area.
- iolist
- specifies a list of externally controlled data sets and the addresses of corresponding I/O routines. If no external I/O routines are supplied, this parameter can be omitted. Figure 1 shows the format of the I/O list.
- auxlist
- specifies the auxiliary list. Figure 1 shows the format of the auxiliary list.
Figure 1. Processor Invocation Argument List from Your
Program
Figure 2. Processor Invocation Argument List from Your Program