Sample autoinstall control programs for terminals

The CICS-supplied default autoinstall program is an assembler-language command-level program, named DFHZATDX. The source of the default program is provided in COBOL, PL/I, and C, as well as in assembler language.

The names of the supplied programs and their associated copy books, and the CICSTS55.CICS libraries in which they can be found, are summarized in Table 1. Note that the COBOL, PL/I, and C copy books each have an alias of DFHTCUDS.

Table 1. Autoinstall programs and copy books
Language Member name Alias Library
Programs:
  • Assembler
  • COBOL
  • PL/I
  • C
  
  • DFHZATDX
  • DFHZCTDX
  • DFHZPTDX
  • DFHZDTDX
    
  • None
  • None
  • None
  • None
    
  • SDFHSAMP
  • SDFHSAMP
  • SDFHSAMP
  • SDFHSAMP
Copy books:  
  • Assembler
  • COBOL
  • PL/I
  • C
    
  • DFHTCUDS
  • DFHTCUD
  • DFHTCUDP
  • DFHTCUD
    
  • None
  • DFHTCUDS
  • DFHTCUDS
  • DFHTCUDS
    
  • SDFHMAC
  • SDFHCOB
  • SDFHPL1
  • SDFHC370

The module generated from the assembler-language source program is part of the pregenerated library shipped in CICSTS55.CICS.SDFHLOAD. You can use it without modification, or you can customize it according to your own requirements. If you choose to alter the code in the sample program, take a copy of the sample and modify it. After modification, use the appropriate procedure to translate, assemble, and link-edit your module. Then put the load module into a user library that is concatenated before CICSTS55.CICS.SDFHLOAD in the DFHRPL statement. (This method applies to completely new modules as well as modified sample modules.) For more guidance information about the supplied procedures, see Using the CICS-supplied procedures to install application programs. Do not overwrite the sample with your customized module, because subsequent service may overwrite your module. You must install a new resource definition for a customized user program.

The default action of the sample program, on INSTALL, is to select the first model in the list, and derive the terminal identifier from the last four nonblank characters of the NETNAME, set the status byte, and return to CICS®. If there are no models in the list, it returns with no action.

The default action, on DELETE, is to address the passed parameter list, and return to CICS with no action.

You can customize the sample program to carry out any processing that suits your installation. Examples of customization are given in Customizing the sample program. Generally, your user program could:
  • Count and limit the total number of logged-on terminals.
  • Count and limit the number of automatically installed terminals.
  • Keep utilization information about specific terminals.
  • Map TERMINAL name and NETNAME.
  • Map TNADDR (TCP/IP client address, IP port and, optionally, host name) of automatically installed terminals.
  • Do general logging.
  • Handle special cases (for example, always allow specific terminals or users to log on).
  • Send messages to the operator.
  • Exercise network-wide control over autoinstall. A network-wide, global autoinstall control program can reside on one CICS system. When an autoinstall request is received by a control program on a remote CICS system, this global control program can be invoked and data transferred from one control program to another.