INQUIRE NETNAME

Retrieve information about a terminal or session.

INQUIRE NETNAME/TERMINAL

Read syntax diagramSkip visual syntax diagramINQUIRE NETNAME( data-value)TERMINAL(data-area)options
options
Read syntax diagramSkip visual syntax diagramfor options, see INQUIRE TERMINAL

Conditions: NOTAUTH, TERMIDERR

Description

The INQUIRE NETNAME command returns information about a particular terminal or session, just as the INQUIRE TERMINAL command does. The primary difference is that you identify the terminal by its network identifier, instead of its CICS® terminal identifier. For a physical terminal, the network identifier is the name by which the terminal is known to z/OS® Communications Server. For ISC sessions, it is the name by which the session (or session group, if there are parallel sessions) is known to z/OS Communications Server. For MRO sessions, it is the name used by the connected region to log on to the interregion communication program.

Thus, compared with INQUIRE TERMINAL, the roles of the NETNAME and TERMINAL options are reversed; NETNAME is required, and you supply a data-value containing the 8-character network identifier of the terminal about which you are inquiring. TERMINAL is optional. If you use it, CICS returns the corresponding 4-character CICS terminal identifier in the data-area you provide.

The other options for INQUIRE TERMINAL return the same information in an INQUIRE NETNAME command as they do in an INQUIRE TERMINAL command.

If there are multiple entries for a netname, and the inquiry is not part of a browse, the first entry found is returned. Entries are searched in the following sequence:
  1. z/OS Communications Server terminals and consoles, in alphanumeric sequence.
  2. Connections, in alphanumeric sequence. The leading session is returned (in a browse, all sessions are returned).

Note that this order is not guaranteed to be maintained in future releases.

Browsing

You can also browse through the definitions of all the netnames installed in your system by using the browse options (START, NEXT, and END) on INQUIRE NETNAME or INQUIRE TERMINAL commands. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.

Note that connections without sessions, such as indirect connections, or remote connections that are not in use, are not returned. If you want all connections to be returned, use the INQUIRE CONNECTION command.

See INQUIRE TERMINAL for details of the options and conditions that apply to the INQUIRE NETNAME command.