Coding the JCL EXEC statement for generating an IOCDS

In the EXEC statement, code the name of the IOCP program in the PGM parameter and code the following PARM options to generate an IOCDS. (The examples later in this chapter describe the JOB and ASSGN statements for an IOCP job.)
Note: You can use PARM parameter defaults to generate an IOCDS and to produce reports. However, the defaults do not allow you to write to the Support Element hard disk.
PARM='WRTCDS=Ax|NO,LINECOUNT=n,CHECKCPC=YES|NO' 
WRTCDS=
Specifies whether IOCP writes an IOCDS to the Support Element hard disk. All WRTCDS options except NO cause IOCP to write an IOCDS. You can write an IOCDS only from an authorized logical partition (that is, I/O Configuration Control Authority is enabled).
Note: If you run z/VSE as a guest under z/VM, writing an IOCDS is not supported.
IOCP writes the IOCDS only if:
  • No errors are encountered during IOCP processing
  • The system operator grants permission in response to message ICP050D
  • The IOCDS is not write protected.
Request IOCP to write the IOCDS only after you have done the following tasks:
  • Checked the syntax of the input statements
  • Generated an IOCDS based on the configuration defined in the statements
  • Reviewed reports on the generated IOCDS
  • Checked to see whether the generated IOCDS is correct.

To replace a write-protected IOCDS, click Disable Write Protection under Options on the Input/Output Configuration window of the Support Element.

When IOCP writes an IOCDS to the Support Element hard disk, it overwrites the previous configuration data in that IOCDS, even if that IOCDS is the active IOCDS. (The active IOCDS is the one used for the last power-on reset.)

The valid options for WRTCDS are Ax and NO.
Ax
Specifies that IOCP writes the Ax IOCDS (where x is 0, 1, 2, or 3) to the Support Element hard disk.
NO
Specifies that IOCP does not write the IOCDS to the Support Element hard disk.

NO is the default if you do not code WRTCDS.

Code or use the default WRTCDS=NO when you test the input file and do not want to write to the Support Element hard disk until you have successfully tested and checked the input file.

Also, you must code or use the default WRTCDS=NO when you run IOCP on a CPC that does not require the IOCP this publication describes. However, certain CPCs permit you to write an IOCDS in anticipation of supporting ICP IOCP.

LINECOUNT=n
Specifies the number of lines that IOCP prints on a page of the IOCP output listing and configuration reports, including the heading of the report. Code a decimal value in the range of 20-99.

If you do not specify LINECOUNT, use the equivalent z/VSE command SET LINECT=n.

CHECKCPC=
YES
Specifies that IOCP generate an IOCDS as follows:
  • Based on the CPC on which IOCP is running if writing an IOCDS. IOCP ignores the SYSTEM= keyword on the ID statement if specified.
  • Based on the CPC on which IOCP is running if not writing an IOCDS and the SYSTEM= keyword was not specified.
  • Based on the SYSTEM= parameter if specified and IOCP is not writing an IOCDS.
YES is the default.
NO
Specifies writing the IOCDS in preparation of a CPC upgrade. IOCP generates an IOCDS based on the SYSTEM= parameter on the ID statement and writes the IOCDS to the current CPC. See Machine rules to determine which SYSTEM= parameters are valid with CHECKCPC=NO and which CPCs can have ICPIOCP write an IOCDS to them.

The IOCDS cannot be used to power-on reset the current CPC until it is upgraded to the type of CPC the IOCDS supports. For example, if IOCP generates an IOCDS for a 8561 CPC using SYSTEM=(8561,1) and writes the IOCDS to a general purpose 3906 model, the IOCDS cannot be used for power-on reset until the 3906 is upgraded to an 8561 model CPC.

A WRTCDS option other than NO is required. Also, the SYSTEM keyword on the ID statement must be specified.

Attention: Use CHECKCPC=NO only in preparation of a CPC upgrade. After the upgrade, write an IOCDS using CHECKCPC=YES at your earliest convenience. Doing so prevents the possibility of using the initial IOCDS for a second upgrade to a CPC that does not support the IOCDS and fails power-on reset.