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.

Note: Substitute your own values for the operands that are shown in italics in the DEFTERM job shown in Figure 1.
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.

Having defined the console devices in the CSD, ensure that their resource definitions are installed in the running CICS region. You can install the definitions in one of two ways, as follows:
  1. Include the group list that contains the resource definitions on the GRPLIST system initialization parameter in the CICS startup job.
  2. 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.
DFHLIST, the CICS-defined group list created when you initialize the CSD with the DFHCSDUP INITIALIZE command, does not include any resource definitions for console devices. However, the CSD is initialized with 2 groups that contain console 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.



dfha23q.html | Timestamp icon Last updated: Sunday, 4 June 2017