Filter
Top Products
described in “The communications area at INSTALL for shipped terminals” on
page 526 . The parameter list passed at INSTALL of client virtual terminals is
described in “The communications area at INSTALL for Client virtual terminals” on
page 534. The parameter list passed at INSTALL of MVS consoles is described in
“Chapter 11. Writing a program to control autoinstall of consoles” on page 505. This
section describes only INSTALL of local terminals (including APPC single-session
connections initiated by a CINIT).
The control program is invoked at INSTALL for terminals when both:
v A VTAM logon request has been received from a resource eligible for automatic
installation whose NETNAME is not in the TCT.
v Autoinstall processing has been completed to a point where information (a
terminal identifier and autoinstall model name) from the control program is
required to proceed.
The communication area at INSTALL for terminals
The layout of the communication area is shown in Figure 28.
The parameter list contains the following information:
1. Standard Header. Byte 1 indicates the request type (this is character ‘0’ 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 VTAM CINIT is stored.
5. Pointer to VTAM 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.
Fullword 1 Standard Header
Byte 1 Function Code (X'F0' for INSTALL)
Bytes2-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
Figure 28. Autoinstall control program’s communication area at INSTALL
the autoinstall control program for terminals
488
CICS TS for OS/390: CICS Customization Guide
|
|