Returning information to CICS
At the INSTALL event, the autoinstall control program is responsible for allowing or denying the installation of a new console resource in the CICS® region. This decision can be based on a number of installation-dependent factors, such as security, or the total number of connected terminals. CICS takes no part in any such checking. You decide whether any such checking takes place, and how it is done.
About this task
If you want an INSTALL request to proceed, perform these
steps in your autoinstall control program:
- Return an autoinstall model name in the first 8 bytes of the area addressed by fullword 4 of the parameter list.
- Supply a CICS terminal name (TERMID) in the next four bytes of the return area. DFHZATDX and DFHZATDY take the last four non-blank characters of the console name (addressed by fullword 2 of the parameter list) as the terminal name. If this does not meet with your installation's naming conventions, code your own autoinstall program.
- Set the return code to X'00'. On entry to the autoinstall control program, the return code always has a nonzero value. If you do not change this, the autoinstall request is rejected.
- Set the delete delay period, or leave it set to the default value of 60 minutes.
Note that these are the only attributes of the TERMINAL
definition that can be set by the autoinstall control program; all
other attributes must come from one of the following sources:
- The MVS™ console interface block (CIB)
- The autoinstall model TERMINAL definition
- The TYPETERM definition to which it refers.
If your control program decides to reject the INSTALL request, it should return to CICS with a non-zero value in the return code. Having completed processing, the control program must return to CICS by issuing an EXEC CICS RETURN command.