Terminals - TERMNL
The Terminals (TERMNL) views display information about currently installed terminals.
Supplied views
To access from the main menu, click:
| 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
| 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
| Field | Attribute name | Description |
|---|---|---|
| Access method | ACCESSMETHOD | The access method defined for the terminal as one of the following:
|
| 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:
|
| 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.
|
| 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.
|
| 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:
|
| 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:
|
| 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.
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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:
|
| 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. |