TERMNL - Terminals

The TERMNL view shows general information about currently installed terminals. An example of how to use this view can be found in Checking the status of a terminal.

Availability

The TERMNL view is available for all managed CICS® systems.

Access

Issue command:
TERMNL [terminal [netname [INSERVICE|OUTSERVICE|GOINGOUT]]]

terminal
is the specific or generic ID of a currently installed terminal, or * for all terminals.

netname
is a specific or generic netname, or * for all netnames. Use this parameter to find out which terminals are associated with which netnames.

INSERVICE|OUTSERVICE|GOINGOUT
Limits the view to terminals that are in service, out of service, or in the process of going out of service. If you omit this parameter, terminals are included in the view regardless of their status.

If you do not specify parameters, the view includes information about all terminals within the current scope.

Note:
Some terminal names might contain lower case characters. You cannot inquire on these in the EUI using a filter because TSO converts lower case characters to upper case. For example ab* will be converted to AB* and as a result no data will be retrieved.
Select:
TERMINAL from the OPERATE menu, and TERMNL from the TERMINAL submenu.
Hyperlink from:
the Term ID field of the TASK view.

Figure 139 is an example of the TERMNL view.

Figure 139. The TERMNL view
 27FEB2005  21:29:06 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =TERMNL============EYUPLX01=EYUPLX01=27FEB2005==21:29:05=CPSM========160===
 CMD Term CICS     Netname  Acquire  Service    ATI TTI Cre User     Tran
 --- ID-- System-- -------- Status-- Status---- --- --- Ses ID------ ID--
     -990 EYUMAS1A EYUMAS1B RELEASED OUTSERVICE YES YES YES DAVEJEF
     -990 EYUMAS4A EYUMAS1B RELEASED OUTSERVICE YES YES YES DAVEJEF
     -991 EYUMAS1A EYUMAS1B RELEASED OUTSERVICE YES YES YES DAVEJEF
     -991 EYUMAS4A EYUMAS1B RELEASED OUTSERVICE YES YES YES DAVEJEF
     -992 EYUMAS1A EYUMAS1B RELEASED OUTSERVICE YES YES YES DAVEJEF
     -992 EYUMAS4A EYUMAS1B RELEASED OUTSERVICE YES YES YES DAVEJEF
     -993 EYUMAS1A EYUMAS1B RELEASED OUTSERVICE YES YES YES DAVEJEF
     -993 EYUMAS4A EYUMAS1B RELEASED OUTSERVICE YES YES YES DAVEJEF
     -994 EYUMAS1A EYUMAS1B RELEASED OUTSERVICE YES YES YES DAVEJEF
     -994 EYUMAS4A EYUMAS1B RELEASED OUTSERVICE YES YES YES DAVEJEF
     -995 EYUMAS1A EYUMAS1B RELEASED OUTSERVICE YES YES YES DAVEJEF
     -995 EYUMAS4A EYUMAS1B RELEASED OUTSERVICE YES YES YES DAVEJEF
     -996 EYUMAS1A EYUMAS1B RELEASED OUTSERVICE YES YES YES DAVEJEF
     -996 EYUMAS4A EYUMAS1B RELEASED OUTSERVICE YES YES YES DAVEJEF
     -997 EYUMAS1A EYUMAS1B RELEASED OUTSERVICE YES YES YES DAVEJEF
     -997 EYUMAS4A EYUMAS1B RELEASED OUTSERVICE YES YES YES DAVEJEF
 

Action commands

Table 269 shows the action commands you can issue from the TERMNL view. The overtype fields are shown in Table 270.

The action commands and overtype fields for the TERMNL view are available for all managed CICS systems for which TERMNL is valid, except as noted in Table 269.

Table 269. TERMNL action commands
Primary command Line command Description
ACQuire
terminal sysname
ACQ Acquires a terminal (VTAM only).
CANcel
terminal sysname
CAN Cancels automatic initiation descriptor (AID) queuing for a terminal.

CANcel is available for CICS Transaction Server for OS/390, Version 1 Release 3 and later systems.

DiSCard
terminal sysname
DSC Discards a terminal from the CICS system where it is installed. The terminal must be out of service before it can be discarded.

DiSCard is available for systems running the CICS TS for OS/390.

FORcepurge
terminal sysname
FOR Takes a terminal out of service and sets its PURGETYPE value to FORCEPURGE, so that transactions associated with the terminal are purged immediately.
PURge
terminal sysname
PUR Takes a terminal out of service and sets its PURGETYPE value to PURGE, so that transactions associated with the terminal are purged normally.
n/a SET Sets a terminal attribute according to the new value you specify in an overtype field (see Table 270).
Note:
The value you specified in the Require Set field on the CICSPlex® System Manager entry panel determines whether or not you must use the SET command when you overtype a field.
Where:
terminal
Is the specific or generic name of a terminal.
sysname
Is the specific or generic name of a CICS system.

Table 270. TERMNL view overtype fields
Field name Values
Acquire Status ACQUIRED | COLDACQ | RELEASED (VTAM only)
Service Stat INSERVICE | OUTSERVICE
ATI YES | NO
TTI YES | NO
Cre Ses YES | NO (VTAM only)

Hyperlinks

Table 271 shows the hyperlink field on the TERMNL view.

Table 271. TERMNL view hyperlink field
Hyperlink field View displayed Description
Term ID TERMNLD Detailed view of the specified terminal.
Note:
You can also display the TERMNLS view by issuing the SUM display command.
[[ Contents Previous Page | Next Page Index ]]