Defining TSO users as console devices
You can define TSO users as console devices to CICS using either an explicitly-defined TERMINAL definition for each TSO user, or use the console autoinstall facility.
To define a TSO user as a console, specify the console name used by the TSO user on the CONSNAME attribute of the DEFINE TERMINAL command. By default, the console name is the user's TSO user ID. You are recommended to define consoles to CICS with preset security by using the USERID operand, so that the TSO user does not have to sign on using the CESN transaction. Otherwise, the TSO user's CICS signon password is displayed when entered for the CESN transaction.
For an example of the DEFINE command required to define a TSO user, see Figure 1.
For information about defining consoles (or terminals) with preset security, see the Security facilities in CICS.
- AUTINSTMODEL(YES)
- Specifies whether this TERMINAL definition can be used as a model for autoinstall purposes.
- AUTINSTNAME(name)
- The name assigned to this autoinstall model definition, and by which the model is known to the autoinstall control program.
- CONSNAME(consname)
- A unique 8-character console name, which corresponds to the NAME
parameter in the CONSOLnn PARMLIB member
that defines the console, or matches the console name used by a TSO
user.
You must define CONSNAME even for an autoinstall model.
- GROUP(grpname)
- A unique name for the group to which the console resource definition is to belong.
- LIST(yourlist)
- The startup group list containing the group in which you have defined the console definitions. If your new group list does not include the required CICS-supplied resources as well as your own, specify DFHLIST and yourlist on the GRPLIST system initialization parameter of your CICS startup job.
- TERMINAL(trmidnt|autc)
- A unique 4-character terminal identifier trmidnt as the name by which CICS is to identify the console in the TCT terminal entry (TCTTE), or a dummy name autc in the case of an autoinstall model definition.
- USERID(tsouser)
- The CICS preset security userid to be used to sign on this console device.
If you have defined a console device in your CSD as CONSNAME(INTERNAL), you can use it to issue commands using MVS job control language. It is also used by authorized programs that use the MGCR macro to issue MVS commands.
- Include the group list that contains the resource definitions on the GRPLIST system initialization parameter in the CICS startup job.
- During CICS execution, install the console device group by using the RDO command CEDA INSTALL GROUP(groupname), where groupname is the name of the resource group containing the console device definitions.
- DFH$CNSL
- This group contains definitions for three consoles. The group is intended for use with the installation verification procedures and the CICS-supplied sample programs. You can add this to your own group list, and alter the definitions to define your own console devices.
- DFHTERMC
- This group contains a single definition of an autoinstall model definition for an MVS console.
If you decide to create new terminal definitions for your console devices, you can specify the CICS-supplied TYPETERM definition, DFHCONS, on the TYPETERM(name) parameter. This TYPETERM definition for console devices is generated in the group DFHTYPE when you initialize the CSD.