The communication area at INSTALL for terminals
Fullword 1 Standard Header
Byte 1 Function Code (X'F0' for INSTALL)
Bytes 2 - 3 Component Code Always 'ZC'
Byte 4 Reserved Always X'00'
Fullword 2 Pointer to NETNAME_FIELD
Fullword 3 Pointer to MODELNAME_LIST
Fullword 4 Pointer to SELECTED_PARMS
Fullword 5 Pointer to CINIT_RU
- Standard Header. Byte 1 indicates the request type (this is hexadecimal character X'F0' for INSTALL).
- Pointer to a 2-byte length field, followed by the NETNAME of the resource requesting LOGON.
- Pointer to an array of names of eligible autoinstall models. The array is preceded by a 2-byte field describing the number of 8-byte name elements in the array. If there are no elements in the array, the number field is set to zero.
- Pointer to the area of storage that you use to return information to CICS®, and where the MTS information from the z/OS® Communications Server CINIT is stored.
- Pointer to z/OS Communications Server LOGON data (the CINIT request unit). The data is preceded by a 2-byte length field, indicating the length of the CINIT request unit, and includes the 3-character NS header. The format of the CINIT request unit is described in the SNA Network Product Formats manual.
CICS passes a list of eligible autoinstall models in the area addressed by fullword 3 of the parameter list.
If the model name is not supplied by MTS, the control program must select a model from this list that is suitable for the device logging on, and move the model name to the first 8 bytes of the area addressed by fullword 4 of the parameter list.
- DEVICE(3270) TERMMODEL(2)
- DEVICE(3270) TERMMODEL(1)
- DEVICE(3270P) TERMMODEL(2)
- DEVICE(3270P) TERMMODEL(1)
- DEVICE(3275) TERMMODEL(2)
- DEVICE(3275) TERMMODEL(1).
The control program selects one model from this list, and CICS uses this model to build the TCTTE for the device. The default autoinstall control program, DFHZATDX, always selects the first model name in the list.
If you are not using MTS but need a printer ID or NETNAME (or an alternative printer ID or NETNAME) associated with this terminal, then your control program can supply this in the area addressed by fullword 4.
If you are using MTS, CICS passes the control program the printer and alternative printer NETNAMEs specified on the z/OS Communications Server ASLTAB macro.
Before returning to CICS, the control program must supply a CICS terminal name for the device logging on, and must set the return code field to X'00' if the autoinstall request is to be allowed.
