CEMT INQUIRE TERMINAL

Retrieve information about terminals.

In the CICS Explorer, the Terminals view provides a functional equivalent to this command.

Description

INQUIRE TERMINAL returns information about a named terminal that is present in the terminal control table (TCT).

In an SNA environment, a terminal is the CICS® representation of an SNA logical unit with which CICS can be in communication. An SNA environment is one in which CICS is using z/OS® Communications Server as the access method for communication with SNA logical units.

This logical unit can be:
  • A physical terminal (such as a 3277)
  • A function of a cluster controller, such as a 3790 Type 2 batch function
  • An IP interconnectivity (IPIC) session, intersystem communication (ISC) session, or interregion communication (IRC) session that has been generated by the CEDA transaction
  • A remote terminal
  • A remote session; that is, a session of a remote connection

If you are familiar with network names, you might prefer to use the command that uses these names. See CEMT INQUIRE NETNAME.

The terminal entry displayed can also be an MVS™ console.

The message TEMP OUT SERVICE can be displayed if recovery is in progress for the terminal. The TEMP OUT SERVICE indicator is reset by refreshing the screen, or by overtyping the INS field with INS or OUT. If TEMP OUT SERVICE continues to be displayed, the cause of the indicator must be investigated.

Input

Press the Clear key to clear the screen. You can start this transaction in two ways:
  • Type CEMT INQUIRE TERMINAL. You get a display that lists the status.
  • Type CEMT INQUIRE TERMINAL followed by the other attributes that are necessary to limit the range of information that you require. So, for example, if you enter CEMT INQUIRE TERMINAL i at, the resulting display shows you the details of only those terminals that are in service and available for use. If you enter CEMT INQUIRE TERMINAL rem(cicr), the display shows you only remote terminals (or remote ISC or IRC sessions) owned by the system that the local CICS knows as CICR.
You can use these methods to change various attributes:
  • Overtype your changes on the INQUIRE screen after using tab to go to the appropriate field. See Overtyping a display.
  • Use the CEMT SET TERMINAL command.
(value)
Is a terminal identifier (1 - 4 characters) as specified in an installed terminal definition.
If the terminal name is, for example, S201, code this option in the following way:
CEMT INQUIRE TERMINAL(S201)
ALL
Is the default. For example, if you inquire about terminals, you receive information about all terminals, unless you specify a terminal identifier, a terminal class identifier, or a system identifier.
CLASS (value)
Is the 1- or 2-character suffix of a terminal list table (TLT).

If you do not specify a terminal identifier or class identifier, by default you receive information about all the terminals.

Sample screen

Figure 1. CEMT INQUIRE TERMINAL screen
 IN TERM
 STATUS:  RESULTS - OVERTYPE TO MODIFY
  Ter(CBRF)           Pri( 000 ) Pag Ins Ati Tti Rte
     Net(CBRF    )                      Rem(CBR ) Rna(CBRF)
  Ter(CERR)           Pri( 000 ) Pag Ins     Tti Loc
     Con(*ERRCON*    )
  Ter(CTSO)           Pri( 000 ) Pag Ins     Tti Loc
     Con(PKING       )
  Ter(KING)           Pri( 000 ) Pag Ins     Tti Loc
     Con(PRUEKING    )
  Ter(RNAL)           Pri( 000 ) Pag Ins     Tti Loc
     Con(INTERNAL    )
  Ter(S225) Tra(CEMT) Pri( 000 ) Pag Ins Ati Tti Loc
     Net(IGCS225 ) Acq     Tas(0000068)           Nqn(GBIBMIYA.IGCS225 )
  Ter(S280) Tra(CEMT) Pri( 000 ) Pag Ins Ati Tti Loc
     Net(IGCS280 ) Acq     Tas(0000063)           Nqn(GBIBMIYA.IGCS280 )
  Ter(TC12) Tra(CEMT) Pri( 000 ) Pag Ins Ati Tti Loc
     Net(IYCWTC12) Acq     Tas(0000072)           Nqn(GBIBMIYA.IYCWTC12)
  Ter(-AAZ)           Pri( 000 ) Aut Ins Ati Tti Ses
     Net(TMPLATE1) Rel                  Rem(CBPS)
  Ter(-AA0)           Pri( 000 ) Aut Ins Ati Tti Ses
     Net(TMPLATE1) Rel Cre              Rem(CBPS)
+ Ter(-AA1)           Pri( 000 ) Aut Out Ati Tti Ses
     Net(TMPLATE1) Rel Cre              Rem(CBPS)
Note: There are blank fields on the screen where a value does not apply or is ‘negative'; that is, the value begins with ‘No'. To modify these fields, locate them by using tab (they are shown in the same sequence as in the expanded format), and overtype with input valid for that field. You might find it more convenient to use the expanded format when setting one of these values. Negating is easier because you are overtyping a field with its negative. Doing this prevents the result from being displayed.

Place the cursor against a specific entry in the list and press Enter; CICS shows an expanded format as shown in Figure 2.

Figure 2. The expanded display of an individual entry
 IN TERM
 RESULT - OVERTYPE TO MODIFY
   Terminal(bell)
   Transaction()
   Priority( 000 )
   Pagestatus( Pageable )
   Servstatus( Inservice )
   Atistatus( Noati )
   Ttistatus( Tti )
   Nature(Local)
   Purgetype(              )
   Netname()
   Console(BELL)
   Termstatus(              )
   Createsess(              )
   Task(00000)
   Remotesystem()
   Nqn(GBIBMIYA.IYCQTC03)
   Rname()
   Rnetname()
+  Cid()

CEMT INQUIRE TERMINAL

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE TERMINAL ALL( value)CLASS( value)TRANSACTION( value)CONSOLE( value)PRIORITY( value)PAGEABLEAUTOPAGEABLEINSERVICEOUTSERVICEATINOATITTINOTTIRTERMINALRSESSIONSESSIONLOCALACQUIREDRELEASEDCOLDACQCREATENOCREATEPURGEFORCEPURGENETNAME( value)TASK( value)REMOTESYSTEM( value)NQNAME( value)RNAME( value)RNETNAME( value)USERID( value)CID( value)

Displayed fields

AIDCOUNT (data area)
Returns a fullword binary field giving the number of Automatic Initiate® Descriptors (AIDs) queued for the specified terminal. If there are no AIDs, then an AIDCOUNT value of 0 is returned. The count represents the number of AIDs on the CICS system that issued the command.
ATISTATUS
Displays whether the terminal is available for use by transactions that are automatically initiated from CICS or, if the terminal is an ISC session, by transactions that are using this session as an alternative way to communicate with another system. The values are:
ATI
The terminal is available for use.
NOATI
The terminal is not available for use.
Note:
  1. You can reset this value by overtyping it with a different value.
  2. You cannot define a terminal with both NOATI and NOTTI.
CID (value)
Displays an 8-character correlation-identifier that is set only for sessions, and only after a session has been acquired. The value relates to the previously acquired session if there was one, if the session is not acquired. CID is set in the following ways:
  • For LU6.2 sessions, it is an 8-character token that is common to the two end sessions that are connected together.
  • For MRO sessions, it is set to the termid of the session on the system to which this session is connected.
  • For LU6.1 sessions to IMS, it is set to the value of NETNAMEQ as defined or negotiated.
  • For other LU6.1 sessions, it is set to the value supplied by the other end of the 6.1 session.
Using CID, you can relate the two parts of an LU6.2, MRO, or LU61 conversation:
  • For LU6.2, you can inquire on the same CID.
  • For MRO, you can locate the session with the terminal name.
  • For LU6.1 to IMS, you can inquire on the netname.
  • For other LU6.1, you can use the name to inquire on the connected system.
CONSOLE (value)
Displays, for an MVS console only, a 12-byte string that contains the identifier of the console, in two parts. If the device is not a console, CICS returns 12 blanks.

If the console is autoinstalled, or is defined explicitly with a console name, the name is returned in the first 8 bytes, and the last 4 bytes are blank.

If the console is defined by a numeric identifier, the string is divided into two parts, separated by a period (.) in the ninth byte position. The 12-byte string contains the following information:
  • The first 8 bytes contain the MVS console name, if it is known, or the string *UNKNOWN if it is not known.
  • A period separating the name from the numeric ID.
  • The last 3 bytes contain the numeric console ID.
CREATESESS (z/OS Communications Server only)
Displays whether the terminal can be acquired automatically by ATI transactions. You cannot specify this field for IRC sessions. The values are:
CREATE
If the terminal is not in session, CICS acquires it if it is needed to satisfy an ATI request.
NOCREATE
If the terminal is not in session, CICS does not acquire it to satisfy an ATI request. A session must be started by, for example, a logon request or a CEMT SET TERMINAL ACQUIRED command before the ATI request can be satisfied.

If NOCREATE is set for an LU6.1 ISC session and no allocatable sessions remain, the connection is placed OUTSERVICE.

You can reset this value by overtyping it with a different value.

NATURE
Displays the nature of the terminal; that is, whether it is a physical device or a session; and whether it is local or remote. The values are:
RTERMINAL
The terminal is a remote device.
RSESSION
The terminal is a session of a remote connection.
SESSION
The terminal is an ISC or IRC session.
LOCAL
The terminal is directly attached to this system and is a physical device or a function of a cluster controller.
NETNAME (value)
Shows an 8-character network name.

For a physical terminal, the Netname is the name by which this terminal is known to z/OS Communications Server.

For ISC sessions, it is the name by which the session (or group of sessions) is known to z/OS Communications Server.

For IRC sessions, it is the name used by the connected region to log on to the interregion communication program (DFHIRP).

For a remote terminal, it is the name by which the terminal is known to the z/OS Communications Server in the remote region. (For a remote terminal routed from a pre-CICS TS for z/OS, Version 5.4 region, Netname is blank.)

If the netname is a z/OS Communications Server LU alias, it is different from the netname component of the NQNAME, which always contains the real netname.

NQNAME (value)
Displays the 17-character network-qualified name.

Remote terminals do not have an NQNAME value.

If the status (Termstatus) is RELEASED, NQNAME displays the netname.

PAGESTATUS
Displays whether pages after the first in a series are written to the terminal on request from the operator or automatically. The values are:
PAGEABLE
Pages are written on request.
AUTOPAGEABLE
Pages are written automatically.

You can reset this value by overtyping it with a different value.

PRIORITY (value)
Displays a 3-character string identifying the priority of a terminal relative to other terminals. The priority of a task is the sum of the transaction priority, the terminal priority, and the operator priority. Priority has no meaning for terminals that are ISC sessions being used as alternative facilities.

The value is in the range 0 - 255, where 255 is the highest priority.

You can reset this value by overtyping it with a different value.

PURGETYPE (input only field)
Specifies whether transactions running with the named terminal are to be purged. The values are:
PURGE
Transactions are stopped only if system and data integrity can be maintained. A transaction is purged if its definition specifies SPURGE=NO.
FORCEPURGE
Transactions are to be purged immediately. This can lead to unpredictable results and are for use in exceptional circumstances.
REMOTESYSTEM (value)
Displays the first four characters of a connection, if the subject of the inquiry is a remote terminal. The named connection can be either a connection entry that links toward the terminal-owning region (TOR), or an indirect connection that provides the netname of the TOR.

Otherwise, this field is blank.

RNAME (value)
Displays the 4-character name by which this terminal is known in the system in which it is defined (the TOR). RNAME applies only to terminals defined as remote; for others, blanks are displayed.
RNETNAME (value)
Displays the 8-character netname of the owning TOR, if the subject of the inquiry is a remote terminal. If this field is blank and the terminal is remote, the indirect connection, displayed in REMOTESYSTEM, contains the netname of the TOR.
SERVSTATUS
Displays whether the terminal is available for use. These are the values:
INSERVICE
The terminal is available for use. For z/OS Communications Server, Ins(ervice) means that the terminal can be ACQUIRED. For IRC sessions, Ins(service) means that the connection to the MRO partner is INSERVICE.
OUTSERVICE
The terminal is not available for use. Setting a terminal Out(service) means that the terminal can no longer be used by transactions. If PURGE or FORCEPURGE is also specified, any transaction that uses the terminal is stopped abnormally. If PURGE or FORCEPURGE is not specified, the transaction ends normally, but no more transactions can use the terminal.

For z/OS Communications Server, setting a terminal Out(service) also causes it to be released and the operator to be signed off, either immediately or when the current transaction has ended. For IRC sessions, Out(service) means that the connection to the MRO partner is OUTSERVICE.

In an LU6.1 ISC session, the connection is set Out(service) if there are no allocatable sessions are left.

For physical terminals and LU6.1 sessions, you can reset this value by overtyping it with a different value.

TASK (value)
Displays the task number of the transaction that is running on this terminal.
TERMINAL (value)
Indicates that this panel relates to a TERMINAL inquiry and displays a 4-character terminal identifier as defined in an installed terminal definition. This option includes all terminals and sessions, but not logical device codes (LDCs), model TCTTEs, mode groups, or system entries. See also Netname.
TERMSTATUS (z/OS Communications Server only)
Displays whether CICS is in session with the logical unit represented by this terminal. Theses are the values:
ACQUIRED
CICS is in session with the logical unit represented by the terminal.
RELEASED
CICS is not in session with the logical unit represented by the terminal. If you set this option to RELEASED, a session is stopped immediately if you also specify the PURGE option; otherwise, the session is ended when the current active transaction is completed.
For physical terminals and LU6.1 sessions, you can reset this value by overtyping it with a different value or with:
COLDACQ
CICS is in session with the logical unit represented by the terminal, where no resynchronization is required.
TRANSACTION (value)
Displays a 4-character string identifying the name of the transaction currently being processed with this terminal as its principal facility or as a secondary facility.
TTISTATUS
Displays whether the terminal can be used by the transactions that are initiated from this terminal. The values are:
TTI
This terminal can be used by transactions.
NOTTI
This terminal cannot be used by transactions.
Note:
  1. You can reset this value by overtyping it with a different value.
  2. A terminal cannot be defined with both NOATI and NOTTI.
USERID (data-area)
Returns the 8-character identifier of the user signed on at this terminal or session.

If there is no signed-on user, the default user ID, as specified in the DFLTUSER system initialization parameter, is returned.