IBM SC34-6814-04 User Manual
Page 594
Note: The communications area for INSTALL of virtual terminals is the same as
that for INSTALL of shipped terminals and connections—that is why the field
names contain the word “SHIPPED”.
INSTALL_SHIPPED_STANDARD
A fullword input field containing the following information:
INSTALL_SHIPPED_EXIT_FUNCTION
A 1-byte field that indicates the type of resource being installed. For
install of Client virtual terminals the equated value is
INSTALL_SHIPPED_TERM (X'F7').
INSTALL_SHIPPED_EXIT_COMPONENT
A 2-byte component code, which is set to ‘ZC’.
INSTALL_SHIPPED_CLASH
A 1-character input field that indicates whether the supplied TERMID is already
in use in this region.
Y
The name passed to the CICS autoinstall function is already in use in
this region to identify an installed remote terminal or connection.
N
The name passed to the CICS autoinstall function is not already in use
in this region to identify a remote terminal or connection.
INSTALL_SHIPPED_NETNAME_PTR
A fullword pointer to an 8-character field containing the netname of the Client
workstation. This field contains the same value as the field pointed to by
INSTALL_SHIPPED_APPLID_PTR.
INSTALL_SHIPPED_SELECTED_PTR
A fullword pointer to the return fields. The output fields, for use by your
program, are:
*--------------------------------------------------------------------------*
* Remote install parameter list - Client virtual terminal function
9
*
*--------------------------------------------------------------------------*
INSTALL_SHIPPED_COMMAREA
DSECT
Install Parameter List
*
INSTALL_SHIPPED_STANDARD
DS
F
Standard field
ORG INSTALL_SHIPPED_STANDARD
INSTALL_SHIPPED_EXIT_FUNCTION
DS
XL1
Install type
INSTALL_SHIPPED_TERM
EQU X’F9’
Install virtual terminal
INSTALL_SHIPPED_EXIT_COMPONENT
DS CL2
Component ID ’ZC’
INSTALL_SHIPPED_CLASH
DS
CL1
Install clash Y/N
ORG ,
INSTALL_SHIPPED_NETNAME_PTR
DS
A
Pointer to netname of Client
INSTALL_SHIPPED_SELECTED_PTR
DS
A
Pointer to return fields
INSTALL_SHIPPED_TERMID_PTR
DS
A
Pointer to incoming TERMID
INSTALL_SHIPPED_APPLID_PTR
DS
A
Pointer to applid of Client
INSTALL_SHIPPED_SYSID_PTR
DS
A
Pointer to sysid of Client
INSTALL_SHIPPED_CORRID_PTR
DS
A
Pointer to correlation ID
INSTALL_SHIPPED_SELECTED_PARMS
DSECT ,
DS
CL8
Reserved
SELECTED_SHIPPED_TERMID
DS
CL4
Selected TERMID
DS
CL4
Reserved
DS
CL4
Reserved
SELECTED_SHIPPED_RETURN_CODE
DS
CL1
Selected return code
RETURN_OK
EQU X’00’
Accept request
REJECT
EQU X’01’
Reject request
*
Figure 53. Autoinstall control program’s communications area at INSTALL. For Client virtual terminals.
572
Customization Guide