Cics Action On Return From The Control Program; The Autoinstall Control Program At Delete - IBM SC34-6814-04 Customization Manual

CICS action on return from the control program

When CICS receives control back from the autoinstall control program, it examines
the return code field:
v If the return code is zero, and the other required information supplied is
v If the return code is not zero, CICS rejects the connection request in the same
For all autoinstall activity, messages are written to the transient data destination
CADL. If an INSTALL fails, a message is sent to CADL, with a reason code. You
can check the output from CADL to find out why an autoinstall request failed.

The autoinstall control program at DELETE

To provide symmetry of control over the autoinstall process, the autoinstall control
program is also invoked when:
v A console autoinstall request was accepted by the user program, but the
v The delete delay period has passed since the console was last used and CICS is
Input to the program is through a communication area, addressed by DFHEICAP.
The layout of the communication area is shown in Figure 46.
Fullword 1 Standard Header
Byte 1 Function Code
Bytes 2 - 3 Component Code
Byte 4 Reserved
Fullword 2 Terminal ID of console being deleted
Fullword 3 Consolename of console being deleted
Bytes 1-2 Deleted consolename length
Bytes 3-4 Start of deleted consolename ID
Next 6 bytes Remainder of deleted consolename ID
Figure 46. Autoinstall control program's communication area at DELETE for consoles
The parameter list contains the following information:
1. A standard header, where byte 1 indicates the request type (this is hexadecimal
2. The second fullword contains the termid of the console that is being deleted.
3. The third fullword contains, in the first two bytes, the length of the deleted
4. The last 6 bytes of the communications area contains the remainder of the
540
Customization Guide
satisfactory, CICS schedules the transaction specified on the MODIFY command
to complete the request. If the installation process fails, the autoinstall control
program is driven again, as though a DELETE function is being processed.
way that it rejects an attempt by an unknown console to send a modify request to
CICS when autoinstall is not enabled.
INSTALL process failed.
running with AICONS=YES in effect. You can query this status of autoinstall for
consoles by issuing a CEMT INQUIRE AUTOINSTALL command. If
AICONS=YES is specified, CEMT INQUIRE AUTOINSTALL displays
CONSOLES(PROGAUTO).
(X'FE')
Always 'ZC'
Always X'00'
character X'FE' for DELETE), and bytes 2 to 3 contain the component code,
which is always ZC for consoles.
console name and, in the last two bytes, the first and second characters of the
console name.
console name (third to eighth characters).