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:
| 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
| 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
| 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:
|
| 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:
|
| Level of attach-time security | ATTACHSEC | The level of attach time user security required for the connection:
|
| 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:
|
| Model for autoinstall option | AUTOINSMODEL | Specifies whether this terminal definition can be used as a model terminal definition for autoinstall:
|
| 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:
|
| Last modification agent | CHANGEAGENT | The change agent identifier that made the last modification.
|
| 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:
|
| 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:
|
| 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:
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:
|
| 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:
|
| 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:
|
| 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. |