The CPGOPT statement (Control Program Generator OPTions) defines the options for generating the IOCF file.
Several CPGOPT statements can be issued for the same IOGEN run. For operands that are specified more than once, it is the latest valid value that applies. No comma may be specified for the operand named first.
CPGOPT |
[,REPLACE=Y / N] [,PROT=*FILE / *PRINT / *SPOOL] |
REPLACE
Controls overwriting of the SYSDAT.BS2.<ver>.IOCF[.<name>] and SYSDAT.IOGEN.<ver>.IOCF[.<name>] files. In this case <name> is the name from the GEN statement.
REPLACE=Y
The files are to be overwritten.
REPLACE=N
The files are not to be overwritten (default value).
I.e. generation is canceled if the SYSDAT.BS2.<ver>.IOCF[.<name>] file or the (temporary) file SYSDAT.IOGEN.<ver>.IOCF[.<name>] exists.
PROT
Controls the logging of the subroutine IOCGEN.
PROT=*FILE
The log of the IOCGEN run is output to the SYSLST.IOGEN.<ver>.IOCF[.<name>] file (default). If this file already exists then it is overwritten.
PROT=*PRINT
The log of the IOCGEN run is written to the current SYSLST file (after the IOGEN log). At the end of the program, a print job is created for the SYSLST file.
PROT=*SPOOL
The log of the IOCGEN run is written to the current SYSLST file (after the IOGEN log). You can control the use of the SYSLST file or permit control by the operating system for example, printing on /EXIT-JOB).