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

Press the Clear key to clear the screen. You can start this transaction in two ways:

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 enter cemt i n ins ati, the result shows details of network names that are in service and available for use.

You can tab to the highlighted or blank fields and overtype them with the required values.

(value): Specifies an 8-character network name.
ALL: The default.

Sample screen

Figure 1. CEMT INQUIRE NETNAME screen

  IN NETNAME
  STATUS:  RESULTS - OVERTYPE TO MODIFY
   Net(IGKS205 ) Tra(CEMT) Pri( 000 ) Pag Ins Ati Tti
           Ter(TC03) Acq     Tas(0000198)           Nqn(GBIBMIYA.IYCQTC03)

Note: When a value does not apply, or is negative (the value begins with No), the fields on the screen are blank. To modify these fields, locate them by tabbing (they appear 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.

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.

Figure 2. The expanded display of an individual entry

IN NET
RESULT - OVERTYPE TO MODIFY
  Netname(IYCQTC03)
  Transaction(CEMT)
  Priority( 000 )
  Pagestatus( Pageable )
  Servstatus( Inservice )
  Atistatus( Ati )
  Ttistatus( Tti )
  Nature(Local)
  Purgetype(              )
  Terminal(944D)
  Termstatus( Acquired )
  Createsess( Nocreate )
  Task(00033)
  Remotesystem()
  Nqname(GBIBMIYA.IYCQTC03)
  Rname()
  Rnetname()
  Cid()
  Userid()

CEMT INQUIRE NETNAME

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.

Using CID, you can relate the two parts of an LU6.2, MRO, or LU61 conversation together:

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.