Coding the JCL EXEC statement for generating an IOCDS
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:Request IOCP to write the IOCDS only after you have done the following tasks:
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:
- 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.