Terminal definitions - TERMDEF

The Terminal definition (TERMDEF) views display information about the unique characteristics of the terminal device definitions (including visual display units, printers and operating system consoles) with which CICS communicates.

Supplied views

To access from the main menu, click:

Administration views > CICS resource definitions > Terminal definitions

Table 1. Views in the supplied Terminal definitions (TERMDEF) view set
View Notes
Terminal definitions

EYUSTARTTERMDEF.ADDTOGRP

Add one or more terminal definitions to a resource group.
Terminal definitions

EYUSTARTTERMDEF.CREATE

Create a terminal definition and add it to the data repository.
Terminal definitions

EYUSTARTTERMDEF.DETAILED

Detailed information about a selected terminal definition.
Terminal definitions

EYUSTARTTERMDEF.INSTALL

Install a terminal definition in an active system.
Terminal definitions

EYUSTARTTERMDEF.REMOVE

Remove a terminal definition from the data repository.
Terminal definitions

EYUSTARTTERMDEF.TABULAR

Tabular information about all terminal definitions for the current context.

Actions

Table 2. Actions available for TERMDEF views
Action Description
ADDTOGRP Add one or more terminal definitions to a resource group.
CREATE Create a terminal definition and add it to the data repository.
CSDCOPY Copy a CICS CSD resource definition.
CSDINSTALL Install a CICS CSD resource definition into an active system.
INSTALL Install a terminal definition in an active system.
REMOVE Remove a terminal definition from the data repository.
UPDATE Update a terminal definition in the data repository.

Fields

Table 3. Fields in TERMDEF views
Field Attribute name Description
Hardware COPY feature for alternate printer ALTPRINTCOPY Indicates whether CICS is to use the hardware copy feature to satisfy a print request on the printer named in the ALTPRINTER option. Values are:
  • YES - CICS is to use the hardware copy feature.
  • NO - CICS is not to use the hardware copy feature.
Alternate printer name ALTPRINTER The name of a 3270 printer to be used, if the printer named in the PRINTER attribute of this terminal definition is unavailable. The name may be up to four characters in length. For further details, see the PRINTER attribute. If you specify an ALTPRINTER without specifying a PRINTER, ALTPRINTER is ignored.
Associated printer ASSOCPRNTR The 4-character TERMINAL name of the definition for the printer.
OS/2 asynchronous line speed (bits per second) ASYNCBPS The OS/2 asynchronous line speed in bits per second.
3151 asynchronous port (OS/2) ASYNCPORT The 3151 asynchronous port (OS/2 only). Values are COM1 through COM8.
Automatic transaction initialization allowed ATI Indicates whether CICS can initiate a task automatically (ATI) with this terminal as its principal facility:
  • YES - The terminal can be used in ATI.
  • NO - The terminal cannot be used in ATI.
Level of attach-time security ATTACHSEC The level of attach time user security required for the connection:
  • LOCAL - The authority of the user is taken to be that of the link itself, and you rely on link security alone to protect your resource.
  • IDENTIFY - Incoming attach requests must specify a user identifier. Specify IDENTIFY when the connecting terminal has a security manager.
  • MIXIDPE - A connection is able to support attaches using either or both of the IDENTIFY and PERSISTENT security types. The security type used depends on the incoming attach.
  • PERSISTENT - This involves a user sign-on to a remote system that persists over multiple conversations until the user signs off from the remote system. In this way, the user's ID and password are passed only on the first (sign-on) attach. Subsequent attach requests require only the user's ID.
  • VERIFY - Incoming attach requests must specify a user identifier and a user password. Specify VERIFY when the connecting terminal has no security manager and therefore requires verification.
Autoconnect to occur for terminal AUTOCONNECT Indicates whether CICS should attempt to establish (bind) a session with this terminal when communication with VTAM is established. Values are:
  • ALL - CICS binds the session, both contention-winners and contention-losers.
  • YES - CICS binds the session, contention-winners only.
  • NO - CICS does not bind a session.
Model for autoinstall option AUTOINSMODEL Specifies whether this terminal definition can be used as a model terminal definition for autoinstall:
  • NO - This definition is not used as a model for autoinstall. It is used only as a definition for a specific device that is not autoinstalled.
  • ONLY - This definition is used only as a model for autoinstall. It is not used as a definition for a specific device.
  • YES - This definition is used for a specific device that is not autoinstalled. The definition is also used as a model for automatic installation.
Name of autoinstall model definition AUTOINSNAME The name by which this model definition is known in the autoinstall control program. The name can be up to eight characters in length.
Bind password BINDPASSWORD A password of up to 16 hexadecimal characters (0-9, A-F) (APPC only).
Bind-time security BINDSECURITY Specifies whether an external security manager (ESM) is being used for bind-time security:
  • NO - No external bind-time security is required.
  • YES - If security is active and the XAPPC system initialization parameter is set to YES, an ESM is called.
Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • DREPAPI - Resource was last changed by a CICSPlex SM API command.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification.
Last modification CHANGETIME The local date and time when the definition was last changed.
Last modification user ID CHANGEUSRID The user ID that made the last modification.
Code page CODEPAGE The terminal code page identifier.
Extended color feature COLOR Indicates whether the device has the extended color feature, which allows colors to be chosen for each field or character (COLOR or NOCOLOR).
Console name CONSNAME The unique name of the console device within a CICS region, regardless of the MVS image to which it is connected. You cannot install two console definitions with the same CONSNAME. The CONSNAME corresponds to the name defined for the console in the MVS SYS1.PARMLIB member, CONSOLnn. The length of CONSNAME must be 2-8 characters and must begin with an alphabetic character or one of #, @, or $.
Console ID CONSOLE Indicates, for an MVS console only, the identifier for the console.
Time created CREATETIME The local date and time when the definition was created.
CSD group CSDGROUP The name of the CSD group for this CICS resource definition. This field is ignored for BAS definitions.
Version DEFVER The version number of the BAS resource definition, from 1 to 15. This field is ignored for CICS CSD resource definitions.
Description code page DESCCODEPAGE The code page of the description field. This field is ignored for CICS CSD resource definitions.
Description DESCRIPTION A description of the terminal definition.
Window style (OS/2) FULLSCREEN This attribute is obsolete.
Graphic character set code GCHARCODE A halfword binary field giving the graphic character set global identifier (GCSGID), which identifies the set of graphic characters that can be input or output at this terminal. This applies only to graphic terminals; for others 0 is returned.
Extended highlight supported HIGHLITE Indicates whether the 3270 device or SCS printer has the extended highlight facility, which enables fields or characters to be displayed in reverse-video, underline mode, or blinking. The options are HILIGHT or NOHILIGHT.
Terminal inservice INSERVICE The status of the terminal that is being defined:
  • YES - Transactions may be initiated and messages may automatically be sent to the terminal.
  • NO - The terminal can neither receive messages nor transmit input.
Katakana feature supported KATAKANA Indicates whether the device is a Katakana terminal (YES or NO).
Logmode name MODENAME The name that is passed to VTAM as the LOGMODE name (APPC single session terminals only) .
Name NAME The name of the terminal definition.
Language for NLS-enabled messages NATLANG A 1-character alphanumeric value that identifies the national language originally defined for use with this terminal. If you leave this blank, CICS uses the system default as specified in the system initialization table (SIT).
VTAM network name NETNAME The network name that identifies the terminal to ACF/VTAM. The name may be up to 8 characters in length and must start with an alphabetic character. If you do not specify a name, the NETNAME defaults to the TERMINAL name.

The NETNAME must be unique except in the case of a remote terminal. That is, you cannot install two local terminals with the same NETNAME, or a local terminal and any connection with the same NETNAME. However, the NETNAME for a remote terminal can be the same as the NETNAME for any other terminal or the NETNAME for any connection.

If the CICS region supports VTAM dynamic LU alias (that is, LUAPFX=xx is specified on the CICS region's APPL statement), the terminal with this NETNAME is assumed to be in the same network as the CICS region. If the terminal is in another network, it must be defined to VTAM on a CDRSC definition with a predefined LUALIAS (LUALIAS=netname) to override VTAM dynamic allocation. In this case, netname on the LUALIAS parameter must match the NETNAME defined on this terminal resource definition.
Operator identifier for BMS OPERID The 3-character operator ID to be associated with the terminal.
Operator priority OPERPRIORITY the operator priority to be used in determining task processing priority for each transaction attached to the terminal, in the range 0 through 255. If you leave this field blank, CICSPlex SM uses the default value for your CICS environment, if there is one.
Operator resource security keys OPERRSL Specifies the preset resource security keys for the device as one or more decimal values in the range 1 through 64.
Operator transaction security keys OPERSEC Specifies the preset transaction security keys for the device as one or more decimal values in the range 1 through 64.
Terminal type (OS/2) OS2TERMTYP This attribute is obsolete.
Pool name for pipeline terminal POOL The pool name for a 3600 or 3650 pipeline terminal pooled with other pipeline terminals.
Printer close mode PRINCLSMODE This attribute is obsolete.
Send messages to printer PRINTEDMSG This attribute is obsolete.
Printer name PRINTER The name of the primary 3270 printer to be used to respond to an ISSUE PRINT command, or a PRINT request from an operator pressing a program access (PA) key. The name may be up to four characters in length.
Hardware copy feature PRINTERCOPY Indicates whether CICS is to use the hardware copy feature to satisfy a print request. Values are:
  • YES - CICS is to use the hardware copy feature.
  • NO - CICS is not to use the hardware copy feature.
Send end of report indicator PRINTIMMED This attribute is obsolete.
Terminal name in the remote system REMOTENAME The 4-character name of this terminal in the remote CICS region in which it is defined. This applies only to terminals defined as remote; for others the value returned is blanks.
Remote system network name REMOTESYSNET The network name (APPLID) of the region that owns the terminal. This is used where there is no direct link between the region in which this definition is installed and the terminal-owning region.
Remote system name REMOTESYSTEM The name that identifies the intercommunication link to the system that owns the terminal. The name can be up to 4 characters in length.
REMOTESYSTEM is one of these identifiers:
  • For IPIC connections, the first 4 characters of the IPCONN name on the IPCONN definition, which is in service and acquired.
  • For MRO and APPC connections, the CONNECTION name on the CONNECTION DEFINITION. If the CONNECTION name is not specified, or if the name is specified as the sysid of the local system, the terminal is local to this system. If the name is the name of another system, the terminal is remote. You can therefore use the same definition for the terminal in both the local system and a remote system.

If you have intermediate systems between this CICS and the terminal-owning region, REMOTESYSTEM specifies the first link in the path to the TOR. If more then one path is possible, REMOTESYSTEM specifies the first link in the preferred path.

REMOTESYSTEM is ignored if you specify AUTINSTMODEL(YES) or AUTINSTMODEL(ONLY)

Screen height SCRHIGH A halfword binary field giving the height (in lines) of the current screen size.
Screen width SCRWIDTH A halfword binary field giving the current width of the terminal screen (in characters).
Security name of the remote system SECURITYNAME The security name of the remote system. In a CICS system with security initialized (SEC=YES or MIGRATE), the security name is used to establish the authority of the remote system. The security name (or USERID on the sessions definition) must be a valid RACF user ID on your system. Access to protected resources on your system is based on the RACF user profile and its group membership.
Solicited messages SOLICITED Specifies whether CICS messages issued to a console should be treated by NetView as solicited or unsolicited:
  • NO - CICS messages are to be treated as unsolicited
  • YES - CICS messages are to be treated as solicited. When SOLICITED(YES) is specified for a console, CICS adds the console name or the console identification number, and a command and response token to each console
Spool destination SPOOLDEST This attribute is obsolete.
Spool print resource security level (RSL) SPOOLPRTRSL This attribute is obsolete.
Spool printer inactive time allowed SPOOLPRTTO This attribute is obsolete.
Default spool printer name SPOOLTO This attribute is obsolete.
Concurrent task limit for pipeline session TASKLIMIT The number of concurrent tasks allowed to run in a pipeline session or in a pool of pipeline sessions:
  • NO - No concurrent tasks are allowed.
  • number - The number of concurrent tasks allowed to run, in the range 1 through 32767.
Terminal priority TERMPRIORITY The priority of the terminal relative to other terminals, in the range 0-255.
Fixed transaction ID TRANSACTION The 4-character identifier of the transaction being executed by the task for which this terminal is the principal facility. Blanks are returned if no task is currently running at the terminal
Typeterm definition name TYPETERM The name of the TYPETERM definition to be associated with this TERMINAL definition. The name can be up to eight characters in length.
Uppercase translation UPCASETR Indicates whether the uppercase translate option is supported for transactions associated with this terminal. The options are UCTRAN, NOUCTRAN, TRANIDONLY.
Use default user USEDFLTUSER Indicate whether the terminal should use the default user ID specified for a CICS system, therefore specifying the kind of security checking that will take place for each inbound attach FMH:
  • N/A - The USEDFLTUSER value does not apply to this definition and should not be validated by CICSPlex SM.
  • NO - Do not use the default user ID. Each inbound attach FMH will be checked for the presence of those fields required by the ATTACHSEC option and if the required fields are not present a protocol violation message will be issued and the attach will fail.
  • YES - Use the default user ID specified on the DFLTUSER SIT parameter for the CICS system. Some checks on the validity of the attach FMH are bypassed. This provides the same level of security as in releases of CICS prior to CICS/ESA 4.1.
Length of the user area for the terminal USERAREALEN The address of the TCTUA containing the process control information for this terminal.
User data area 1 USERDATA1 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 2 USERDATA2 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 3 USERDATA3 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User ID USERID The user identifier used for sign-on and referred to in security error messages, security violation messages, and the audit trail. It must be a valid user ID defined to the security manager.
Workstation setup (OS/2) WSSETUP This attribute is obsolete.


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