Terminals - TERMNL

The Terminals (TERMNL) views display information about currently installed terminals.

Supplied views

To access from the main menu, click:

CICS operations views > Terminal operations views > Terminals

Table 1. Views in the supplied Terminals (TERMNL) view set
View Notes
Terminals

EYUSTARTTERMNL.ACQUIRE

Acquires a terminal (VTAM only).
Terminals

EYUSTARTTERMNL.CANCEL

Cancels automatic initiation descriptor (AID) queuing for a terminal.
Terminals

EYUSTARTTERMNL.DETAIL1

Detailed information about a selected terminal.
Terminals

EYUSTARTTERMNL.DETAILED

Detailed information about a selected terminal.
Terminals

EYUSTARTTERMNL.DISCARD

Discard a terminal from the CICS system where it is installed. The terminal must be out of service before it can be discarded.
Terminals

EYUSTARTTERMNL.FORCEPURGE

Any transaction running with this terminal is immediately terminated abnormally. Data integrity is not guaranteed. In some extreme cases (for example, if an error occurs during backout processing), CICS might terminate abnormally.
Terminals

EYUSTARTTERMNL.INSERVICE

Set the terminal in-service and available for use. For VTAM, INSERVICE means that the terminal can be ACQUIRED.
Terminals

EYUSTARTTERMNL.OUTSERVICE

Set the terminal out-of-service, and not available for transactions. Any current transaction is allowed to complete normally, but no further transactions are allowed to use the terminal. For VTAM, setting a terminal OUTSERVICE also causes it to be released and the operator is signed off, either immediately or when the current transaction has terminated.
Terminals

EYUSTARTTERMNL.PURGE

Take a terminal out of service and sets its PURGETYPE value to PURGE, so that transactions associated with the terminal are purged normally.
Terminals

EYUSTARTTERMNL.RELEASE

Releases a terminal.
Terminals

EYUSTARTTERMNL.SET

Set attributes according to the new values specified in input fields.
Terminals

EYUSTARTTERMNL.TABULAR

Tabular information about terminals installed in CICS systems.

Actions

Table 2. Actions available for TERMNL views
Action Description
ACQUIRE Acquires a terminal (VTAM only).
CANCEL Cancels automatic initiation descriptor (AID) queuing for a terminal.
DISCARD Discard a terminal from the CICS system where it is installed. The terminal must be out of service before it can be discarded.
FORCEPURGE Any transaction running with this terminal is immediately terminated abnormally. Data integrity is not guaranteed. In some extreme cases (for example, if an error occurs during backout processing), CICS might terminate abnormally.
INSERVICE Set the terminal in-service and available for use. For VTAM, INSERVICE means that the terminal can be ACQUIRED.
KILL The task is to be terminated. System and data integrity is not guaranteed. The KILL option extends the PURGE and FORCEPURGE options. It should be used only after an attempt has been made to PURGE or FORCEPURGE a task. The KILL option does not guarantee integrity of any kind but in some situations it allows the user to free up a stalled region enabling the region to continue processing. In some cases, for example, if a task is killed during backout processing, CICS terminates abnormally.
OUTSERVICE Set the terminal out-of-service, and not available for transactions. Any current transaction is allowed to complete normally, but no further transactions are allowed to use the terminal. For VTAM, setting a terminal OUTSERVICE also causes it to be released and the operator is signed off, either immediately or when the current transaction has terminated.
PURGE Take a terminal out of service and sets its PURGETYPE value to PURGE, so that transactions associated with the terminal are purged normally.
RELEASE Releases a terminal.
SET Set attributes according to the new values specified in input fields.

Fields

Table 3. Fields in TERMNL views
Field Attribute name Description
Access method ACCESSMETHOD The access method defined for the terminal as one of the following:
  • VTAM
  • BSAM
  • BTAM
  • BGAM
  • TCAM
  • TCAMSNA
  • CONSOLE
Acquire status ACQSTATUS Under VTAM, indicates whether CICS is in session with the logical unit represented by this terminal. If this field is NOTAPPLIC, it means the access method is something other than VTAM. Input Values:
  • ACQUIRED
  • RELEASED
  • NOTAPPLIC
  • COLDACQ
  • ACQUIRING
  • RELEASING
Alternate page height ALTPAGEHT The alternate page height defined for use by BMS when the alternate page size is selected.
Alternate page width ALTPAGEWD The alternate page width defined for use by BMS when the alternate page size is selected.
Alternate printer ALTPRINTER The name of a 3270 printer for use as an alternative to the preferred printer.
Hardware COPY feature for alternate printer ALTPRTCOPYST Indicates whether CICS is to use the hardware COPY feature to satisfy a print request from the alternate printer.

Input Values: ALTPRTCOPY, NOALTPRTCOPY

Alternate screen height ALTSCRNHT The alternate screen height defined for use by BMS when the alternate screen size is selected.
Alternate screen width ALTSCRNWD The alternate screen width defined for use by BMS when the alternate screen size is selected.
Alternate-map-set suffix ALTSUFFIX A 1-character numeric suffix that BMS appends to map set names, as specified on the DFHMSD TYPE macro. If this field is blank, it means that no suffix is added to map set names. This applies only when the screen has the alternate size and suffixing is in use.
APL keyboard feature APLKYBDST Indicates whether the 3270 device has the APL keyboard feature. Values are APLKYBDS or NOAPLKYB.
APL text feature APLTEXTST Indicates whether the 3270 device has the APL text feature. Values are APLTEXT or NOAPLTEX.
ASCII data stream type ASCII Identifies the type of ASCII data stream being used.
  • ASCII7 - A 7-bit ASCII datastream.
  • ASCII8 - An 8-bit ASCII datastream.
  • NOTAPPLIC - Not applicable.
Automatic transaction initiation (ATI) status ATISTATUS Indicates whether CICS can initiate a task automatically (ATI) with this terminal as its principal facility.

Input Values: ATI, NOATI

Audible alarm feature AUDALARMST Indicates whether the device has the audible alarm feature for a 3270 display or a 3270 printer attached to a 3651 controller (AUDALARM or NOAUDALARM).
Session binding status AUTOCONNECT Identifies whether sessions with this terminal are to be established when CICS is initialized or whenever communication with VTAM is started.
  • ALLCONN - Same as AUTOCONN
  • AUTOCONN - CICS binds associated sessions.
  • NONAUTOCONN - CICS does not bind associated sessions.
  • NOTAPPLIC - The terminal is not a VTAM terminal, or is a remote terminal, a surrogate, or a model.
Background transparency feature BACKTRANSST Indicates whether the device has the background transparency feature (BACKTRANS or NOBACKTRANS).
Extended color feature COLORST Indicates whether the device has the extended color feature, which allows colors to be chosen for each field or character (COLOR or NOCOLOR).
Console ID CONSOLE Indicates, for an MVS console only, the identifier for the console.
Copy feature in control unit COPYST Indicates whether the copy feature for a 3270 display or printer is included in the 3270 control unit (COPY or NOCOPY).
Correlation ID CORRELID The 8-character correlation-id, as follows:
  • For LU6.1 sessions, NETNAMEQ.
  • .For LU6.2 sessions, a token that is common to the two connected sessions.
  • .For MRO sessions, the terminal ID of the session at the other end of the MRO link to which this session is connected.
Session creation status CREATESESS Under VTAM, indicates whether the terminal can be acquired automatically by ATI transactions. If this field is NOTAPPLIC, it means the access method is something other than VTAM. The options are CREATE, NOCREATE, NOTAPPLIC.
Device data stream type DATASTREAM Identifies the device data stream type:
  • DS3270 - 3270 Datastream
  • NOTAPPLIC - Not applicable
  • SCS - SNA character strings
Default page height DEFPAGEHT The default page height defined for use by BMS when the default page size is selected.
Default page width DEFPAGEWD The default page width defined for use by BMS when the default page size is selected.
Default screen height DEFSCRNHT The default screen height defined for use by BMS when the default screen size is selected.
Default screen width DEFSCRNWD The default screen width defined for use by BMS when the default screen size is selected.
Device type DEVICE The terminal or session type as recorded in the TCTTE.

Possible values: BATCHLU, BIPROG, BISYNCH, CDRDLPRT, CONTNLU, HARDCOPY, INTACTLU, ISCMMCONV, LUCMODGRP, LUCSESS, LUTYPE4, LUTYPE6, MAGTAPE, RESSYS, SDLC, SEQDISK, SYSTEM3, SYSTEM7, SYS7BSCA, TCONSOLE, TELETYPE, TTCAM, TWX3335, T1050, T1053, T2260L, T2260R, T2265, T2740, T2741BCD, T2741COR, T2770, T2780, T3275R, T3277L, T3277R, T3284L, T3284R, T3286L, T3286R, T3600BI, T3601, T3614, T3650ATT, T3735, T3650PIPE, T3650USER, T3653HOST, T3740, T3780, T3790, T3790SCSP, T3790UP, T7770, VIDEOTERM

Device busy status DEVICEST Indicates the status of the device.
  • BUSY - The device is busy.
  • NOTBUSY - The device is not busy.
Disconnect Requests status DISCREQST Indicates whether CICS is to honor disconnect requests from an application.

Input Values: DISCREQ, NODISCREQ, NOTAPPLIC

Dual-case keyboard status DUALCASEST Indicates whether the terminal has a typewriter keyboard or an operator console keyboard. Values are:
  • DUALCASE - The terminal has a typewriter keyboard.
  • NODUALCASE - The terminal has an operator console keyboard (this keyboard is not restricted to a single case), or is not a 3270 display.
Exit tracing status EXITTRACING Under VTAM, indicates whether exit tracing is active for the terminal. A value of NOTAPPLIC means the access method is something other than VTAM.

Input Values: EXITTRACE, NOEXITTRACE

Extended data stream support EXTENDEDDSST Indicates whether the 3270 device or SCS printer supports extensions to the 3270 data stream. The options are EXTENDEDDS or NOEXTENDEDDS.
Function management header (FMH) option FMHPARMST Indicates whether the device supports function management header (FMH) data built by BMS from user-supplied parameters. The options are FMHPARM or NOFMHPARM.
Forms feed feature FORMFEEDST Indicates whether the device has the forms feed feature. The options are FORMFEED and NOFORMFEED.
Graphic character set global ID GCHARS The graphic character set global ID (GCSGID). This ID is a registered number in the range 1 - 65534 that identifies the set of graphic characters that can be input or output at this terminal. A value of zero means no GCSGID value was defined.
Code page global ID GCODES The code page global ID (CPGID). This ID is a registered number in the range 1 - 65534 that identifies the EBCDIC code page that defines the code points for the characters that can be input or output at this terminal. A value of zero means no CPGID value was defined.
Horizontal form feature HFORMST Indicates whether the device has the horizontal forms feature, which enables BMS to use horizontal tabbing when formatting documents for output. The options are HFORM or NOHFORM.
Extended highlight feature HILIGHTST 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.
Number of input messages INPMSGCNT The number of operator-initiated inputs to the terminal, including initial transaction input and input as a result of a conversational read to the terminal.
Katakana terminal KATAKANAST Indicates whether the device is a Katakana terminal (KATAKANA or NOKATAKANA).
Selector pen feature LIGHTPENST Indicates whether a 3270 display has the selector pen feature. The options are LIGHTPEN or NOLIGHTPEN.
Real link connection for remote TOR LINKSYSTEM For remote terminals only, the 4-character name of the connection that is the real link towards the TOR.
Last map referenced in SEND MAP command MAPNAME The name of the BMS map that was most recently referenced in the MAP option of a SEND MAP command processed for this terminal.
Last map set referenced in SEND MAP command MAPSETNAME The name of the BMS map set that was most recently referenced in the MAPSET option of a SEND MAP command processed for this terminal.
Mode name MODENAME Under APPC, the name of a group of parallel sessions (to which this terminal belongs) that have similar characteristics.
Magnetic slot reader MSRCONTROLST Indicates whether the terminal is an 8775 or 3643 device with a magnetic slot reader. The options are MSRCONTR or NOMSRCON.
National language ID NATLANG A 1-character alphanumeric value that identifies the national language originally defined for use with this terminal.
Terminal definition type NATURE Indicates the nature of the terminal definition as one of the following:
  • TERMINAL - Physical terminal definition
  • MODEL - Model terminal definition, specific to a type of terminal
  • SESSION - Remote (APPC) session
  • SURROGAT - Surrogate terminal definition
Network name NETNAME Under VTAM, the name by which this logical unit (either a terminal or a session) is known. If this field is blank, it means the access method is something other than VTAM.
Next transaction ID NEXTTRANSID The name of the next transaction to run after an EXEC CICS RETURN command.

Input Values: Any valid transaction ID

Network qualified name NQNAME The network qualified name if one was sent by VTAM at logon time.
Outboard formatting support OBFORMATST Indicates whether the device supports outboard formatting.

Input Values: OBFORMAT, NOOBFORMAT

Outboard operator IDs used OBOPERIDST For 3790 and 3770 batch data interchange logical units, indicates whether outboard operator IDs are used by CICS to support the BMS routing facilities required for this terminal (OBOPERID or NOOBOPERID).
Operator ID OPERID Returns the 3-character operator identification code of the user signed on at the terminal.

Note: If the terminal is a surrogate terminal, this value may not be current; it represents the user signed on at the time the terminal definition was shipped from the owning CICS region to this one, who may since have signed off. The OPERID may also be different from that of the user currently signed on if it has been changed with the SET TERMINAL command.

Field outlining support OUTLINEST Indicates whether the device supports field outlining. The options are OUTLINE or NOOUTLINE.
Number of output messages OUTMSGCNT The number of output messages written to the terminal by either an application program or CICS.
Current page height PAGEHT The page height currently in use for the device.
BMS paging status PAGESTATUS Indicates whether pages after the first in a series are written to the terminal automatically or on request from the operator.

Input Values: AUTOPAGEABLE, PAGEABLE

Current page width PAGEWD The page width currently in use for the device.
Partitions status PARTITIONSST Indicates whether the device can use partitions (PARTITIONS or NOPARTITIONS).
Total pipeline-throwaway count PMSGCNT The total throwaway count. A throwaway occurs when input is received for a pipeline pool terminal and none are available.
Maximum pipeline-throwaway count PMSGCONSEC The maximum number of throwaways. A throwaway occurs when input is received for a pipeline pool terminal and none are available.
Number of consecutive pipeline-throwaways PMSGGRPCNT The number of consecutive throwaways. A throwaway occurs when input is received for a pipeline pool terminal and none are available.
Number of polls sent to terminal POLLCNT Under TCAM or BSAM, the number of polls that have been sent to the terminal. If this field is blank, it means the access method is something other than TCAM or BSAM.
Printer adaptor feature PRINTADAPTST Indicates whether the device supports a printer adaptor feature (PRINTADAPT or NOPRINTADAPT).
Printer name PRINTER The name of the preferred printer CICS is to use in response to a print request from this device.

Input Values: Any valid printer ID

Programmed symbol facility support PROGSYMBOLST Indicates whether the programmed symbol facility can be used on this 3270 device of SCS printer. The options are PROGSYMBOL or NOPROGSYMBOL .
Hardware COPY feature for preferred printer PRTCOPYST Indicates whether CICS is to use the hardware COPY feature to satisfy a print request from the preferred printer.

Input Values: PRTCOPY, NOPRTCOPY

Query option QUERYST Indicates whether the device supports the use of the QUERY structured field to determine its characteristics:
  • ALLQUERY - The QUERY function is supported each time the device is connected.
  • COLDQUERY - The QUERY function is supported only when the device is first connected after a cold start of CICS.
  • NOQUERY - The QUERY function is not supported.
Release Request status RELREQST Indicates whether CICS is to honor release requests from VTAM for the logical unit.

Input Values: RELREQ, NORELREQ, NOTAPPLIC

Name of terminal in remote CICS REMOTENAME The 4-character name of this terminal in the remote CICS region in which it is defined. REMOTENAME applies only to terminals defined as remote; for others the value returned is blanks
Remote TOR net name REMOTESYSNET For remote terminals only, the 8-character netname of the owning TOR.
Remote system name REMOTESYSTEM returns the 4-character name of a connection or the first 4 characters of an IPCONN name.

The named connection can be either a connection entry that that links towards the TOR, or an indirect connection that provides the netname of the TOR.

For IPIC connections, the first 4 characters of the IPCONN name on the IPCONN definition which is in service and acquired is used.

Screen height SCREENHEIGHT The height of the current 3270 screen, which is either the ALTSCRNHT or DEFSCRNHT value.
Screen width SCREENWIDTH The width of the current 3270 screen, which is either the ALTSCRNWD or DEFSCRNWD value.
Preset security status SECURITY Indicates whether the terminal has preset security (PRESET or NOPRESET).
Service status SERVSTATUS Indicates whether the terminal is currently in service, out of service, or in the process of going out of service. The options are GOINGOUT, INSERVICE, OUTSERVICE
Session type SESSIONTYPE For terminals that are acting as sessions with another CICS system, the type of session as one of the following:
  • LU61 - An LUTYPE6.1 session.
  • APPCSINGLE - A single APPC session.
  • APPCPARALLEL - A parallel APPC session group.
  • NOTAPPLIC - The terminal is not one of the above.
Sign-on status SIGNONSTATUS Indicates whether the terminal currently has a signed on user (SIGNEDON or SIGNEDOFF).
Mixed EBCDIC/DBCS support SOSIST Indicates whether the device supports mixed EBCDIC and double-byte character set (DBCS) fields. The options are SOSI or NOSOSI.
Number of storage violations STGVCNT The number of storage violations that have occurred on the terminal.
Terminal input-output area (TIOA) storage STORAGE The average TIOA storage allowed at this terminal.
Id of task currently executing at terminal TASKID The ID of the user task currently executing at this terminal.
TCAM message control flag TCAMCONTROL Returns a 1-character TCAM control byte giving one of the following codes to identify which segment of a message has passed between CICS and TCAM. The meanings are:
  • 00 Null
  • 40 Intermediate part of message
  • F1 First part of message
  • F2 Last part of message
  • F3 Whole message
  • F4 Intermediate part of message, end of record
  • F5 First part of message, end of record
  • F6 Last part of message, end of record
  • F7 Whole message, end of record
  • FE TCAM is not active
  • FF Not applicable (non-TCAM terminal)
Terminal ID TERMID The terminal name as specified in the installed terminal definition.
Terminal model number TERMMODEL The terminal model number, as specified in the TYPETERM definition. A value of N/A means this terminal is an LU6.2 or MRO session.
Terminal priority TERMPRIORITY The priority of the terminal relative to other terminals.

Input Values: 0 - 255.

Terminal type TERMTYPE The type of terminal.
Number of transaction errors TERRCNT The number of transactions associated with the terminal that could not be started.
Text-keyboard feature TEXTKYBDST Indicates whether the 3270 device has the text keyboard feature. The options are TEXTKYBD or NOTEXTKYBD.
Text-print feature TEXTPRINTST Indicates whether a 3288 printer has the text-print feature. The options are TEXTPRINT or NOTEXTPRINT.
Terminal tracing type TRACING Describes the tracing activity associated with the terminal as either standard or special. The options are STANTRACE or SPECTRACE.
Number of transactions TRANCNT The number of transactions, both nonconversational and pseudoconversational, that were started at the terminal.
Current transaction name TRANSACTION The name of the transaction currently executing with this terminal as its principal facility.
Terminal transaction initiation (TTI) status TTISTATUS Indicates whether this terminal can be used by transactions initiated from this terminal. The options are TTI or NOTTI
Uppercase translate option support UCTRANST Indicates whether the upper case translate option is supported for transactions associated with this terminal. The options are UCTRAN, NOUCTRAN, TRANIDONLY.
Terminal user area (TCTUA) address USERAREA The address of the user area.
Terminal user area (TCTUA) length USERAREALEN The length of the user area.
User ID USERID The 8-character identifier of the user signed on at this terminal or session. If there is no signed-on user, the value will be the default user ID, as specified in the DFLTUSER system initialization parameter.
User name USERNAME returns the 20-character name of the user signed on at this terminal or session (that is, the name corresponding to the USERID option value). If the information, which is provided by the external security manager, is shorter than 20 bytes, CICS pads it to 20 with trailing blanks. Blanks are returned if there is no signed on user.
Extended validation feature VALIDATIONST Indicates whether the device has the extended validation feature. The options are VALIDATION or NOVALIDATION.
Vertical form feature VFORMST Indicates whether the device has the vertical form feature, which enables BMS to use vertical tabbing when formatting documents for output (VFORM or NOVFORM).
Number of transmission errors or disconnects XERRCNT The number of errors recorded if this is a terminal or the number of disconnects if this is an EXCI session.
ZCP tracing status ZCPTRACING Under VTAM, controls the tracing activity associated with the VTAM control component of CICS. A value of NOTAPPLIC means the access method is something other than VTAM. The options are ZCPTRACE or NOZCPTRACE.


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