The communication area at INSTALL for terminals

The layout of the communication area is shown in Figure 1.
Figure 1. Autoinstall control program's communication area at INSTALL
 
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
 
The parameter list contains the following information:
  1. Standard Header. Byte 1 indicates the request type (this is hexadecimal character X'F0' for INSTALL).
  2. Pointer to a 2-byte length field, followed by the NETNAME of the resource requesting LOGON.
  3. 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.
  4. 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.
  5. 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.

For example, if a 3270 printer attempts to autoinstall, the subset of matching models includes all the types in z/OS Communications Server category 2 that you have defined as models. This subset could include any of the following:
  • 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.

Figure 2 shows all of these fields in their required order.
Figure 2. Autoinstall control program's parameter list at INSTALL
The picture shows, in graphical format, the communication area described in the preceding pages. The communication area consists of five fullwords, as follows: Standard Header. Byte 1 indicates the request type (this is hexadecimal character F0 for INSTALL). Bytes 2 and 3 contain the CICS component code, 'ZC'. Byte 4 is reserved.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. 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. This storage area contains the following fields: Modelname8-byte input/output field.Terminal ID4-byte output field.Printer ID4-byte output field.Altprinter ID4-byte output field.Return code1-byte output field.Printer NETNAME8-byte input/output field.Altprinter NETNAME8-byte input/output field.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.


dfha384.html | Timestamp icon Last updated: Sunday, 4 June 2017