CEMT INQUIRE NETNAME
Retrieve information about a network.
In the CICS Explorer, the Terminals operations view provides a functional equivalent to this command.
Description
If you are familiar with network names, you might prefer to use this command as an alternative to the CEMT INQUIRE TERMINAL command.
Input
- Type
CEMT INQUIRE NETNAME
(or suitable abbreviations for the keywords). The resulting display lists the status. - Type
CEMT INQUIRE NETNAME
(or suitable abbreviations for the keywords), followed by the attributes that are necessary to limit the range of information that you require. For example, if you entercemt i n ins ati
, the result shows details of network names that are in service and available for use.
- (value)
- Specifies an 8-character network name.
- ALL
- The default.
Sample screen
If you place the cursor against a specific entry in the list and press ENTER, CICS® shows an expanded format, as shown in Figure 2.
Displayed fields
- AIDCOUNT (data area)
- Returns a fullword binary field that contains the number of automatic initiate descriptor (AIDs) queued for the specified terminal. If there are no AIDs, a 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 within CICS or,
if the terminal is an ISC session, by transactions that are using
this session as an alternate facility to communicate with another
system. The values are as follows:
- ATI
- The terminal is available for use.
- NOATI
- The terminal is not available for use.
Note:- You can reset this value by overtyping it with a different value.
- A terminal cannot be defined with both NOATI and NOTTI.
- CID (value)
- Displays
an 8-character correlation identifier that is set only for sessions,
and only after a session is acquired. (The value relates to the previously
acquired session if there was one, if the session is not acquired).
CID is set as follows:
- For LU6.2 sessions, it is an 8-character hexadecimal 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.
- 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.
- CREATESESS (z/OS Communications Server only)
- Displays
whether the terminal can be acquired automatically by ATI transactions.
This cannot be specified for IRC sessions. The values are as follows:
- CREATE
- If the terminal is not in session, CICS acquires it if the terminal is required for 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 there are no allocatable sessions left, 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 as
follows:
- RTERMINAL
- The terminal is owned by another CICS region.
- RSESSION
- The terminal is a session of a connection that is owned by another CICS region.
- 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)
- Indicates
that this panel relates to a NETNAME inquiry and displays 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, the NETNAME is the name by which the session (or group of sessions) is known to z/OS Communications Server.
- For IRC sessions, the NETNAME is the name used by the connected region to logon to the interregion communication program (DFHIRP).
- For EXCI sessions, the NETNAME is DFHGEN for generic sessions
and, for specific sessions, it is the value of the user_name parameter
used in the EXCI INITIALISE_USER call. When an inquiry is made on DFHGEN, the name is an 8-character field with a leading and trailing blank (' DFHGEN '). The name must be enclosed in quotes and include the blanks, so you enter the command on the screen as follows:
CEMT INQ NETNAME(' DFHGEN ')
- For remote devices, the NETNAME is the name by which the device is known to the z/OS Communications Server in the terminal-owning region.
Note: 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
- Displays
the z/OS Communications Server
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 as follows:
- 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 that indicates the priority of this 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 the transactions running with the named terminal are to be
purged. The values are as follows:
- PURGE
- Transactions are to be terminated only if system and data integrity can be maintained. A transaction is to be purged if its definition specifies SPURGE=NO.
- FORCEPURGE
- Transactions are to be purged immediately. This can lead to unpredictable results and is for use in exceptional circumstances.
- REMOTESYSTEM (value)
- Displays
the 4-character name of a connection, if the subject of the inquiry
is a remote terminal. The named connection can be either a connection
entry that links towards 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 system named in the REMOTESYSTEM field has not been installed, and no value was specified for the REMOTESYSNET option when the terminal was defined.
- SERVSTATUS
- Displays
whether the terminal is available for use. The values are as follows:
- INSERVICE
- The terminal is available for use. For z/OS Communications Server, INSERVICE means that the terminal can be ACQUIRED. For IRC sessions, INSERVICE means that the connection to the MRO partner is INSERVICE.
- OUTSERVICE
- The
terminal is not available for use. Setting a terminal OUTSERVICE means
that the terminal can no longer be used by transactions. If PURGE
or FORCEPURGE is also specified, any transaction that is using the
terminal is terminated abnormally. If PURGE or FORCEPURGE is not specified,
the transaction can terminate normally, but no further transactions
can use the terminal. For z/OS Communications
Server, setting a terminal OUTSERVICE also causes it to be released
and the operator to be signed off, either immediately or when the
current transaction has is completed.
For IRC sessions, OUTSERVICE means that the connection to the MRO partner is OUTSERVICE.
In an LU6.1 ISC session, the connection is set OUTSERVICE if there are no allocatable sessions 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)
- Displays a 4-character terminal identifier (1 - 4 characters) as specified in an installed terminal definition.
- TERMSTATUS (z/OS Communications Server only)
- Displays
whether CICS is in session
with the logical unit represented by this terminal. The values are
as follows:
- 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 terminated immediately if you also specify the PURGE option, otherwise the session is terminated when the current active transaction finishes.
For physical terminals and LU6.1 sessions, you can reset this value by overtyping it with a different value or with the following:- COLDACQ
- This is a special form of ACQUIRED, where no resynchronization is required. If the previous session abended, the use of COLDACQ overrides CICS integrity control. This might lead to integrity problems. Also check the CSMT log for an activity keypoint after the restart of a session following a CICS failure. If there is no activity keypoint, issue COLDACQ again after the next emergency restart.
- TRANSACTION (value)
- Displays a 4-character string that indicates 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 as follows:
- TTI
- This terminal can be used by transactions.
- NOTTI
- This terminal cannot be used by transactions.
You can reset this value by overtyping it with a different value.
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 userid, as specified in the DFLTUSER system initialization parameter, is returned.