Function

To display network connections that are defined to JES2. This command allows the display of connections defined by CONNECT initialization statements, $ADD commands or NCC records from other nodes.

This command has parameters you can use as a filtering technique to limit the type of information to search, or the amount of information to display. See Using filtering to control and display information for additional information.

One or more parameters on this command accepts wild cards. Parameter descriptions will note that.

Parameters

CES

Displays the connection event sequence (CES) for non-static connections.

MA|MEMBA|MEMBERA[=membera]

The member number at the NODEA end of the connection. You can specify the MEMBERA parameter without any keyword to obtain information about all members, or you can specify the member number to obtain information about a specific member.

Default: The default is 1. The value for MEMBERA if NODEA is the local node must be a 1. If the member number is greater than a 1 for the local node, the command is rejected.

MB|MEMBB|MEMBERB[=memberb]

The member number at the NODEB end of the connection. You can specify the MEMBERB parameter without any keyword to obtain information about all members, or you can specify the member number to obtain information about a specific member.

Default: The default is 1. The value for MEMBERB if NODEB is the local node must be a 1. If the member number is greater than a 1 for the local node, the command is rejected.

NA|NODEA[=nodea]

The node name at one end of the connection. You can specify the NODEA parameter without any keyword to obtain information about all connections, or you can specify the 1 to 8 alphanumeric or special ($, #, or @) symbolic node name (xxxxxxxx) or node number (nnnn) to obtain information about a specific node.

You can also specify wild cards on this parameter. See Using wildcards for additional information. You must specify the NAME= parameter of the NODE initialization statement for the referenced node or the node number.

NB|NODEB[=nodeb]

The node name at the other end of the connection. You can specify the NODEB parameter without any keyword to obtain information about all connections, or you can specify the 1 to 8 alphanumeric or special ($, #, or @) symbolic node name (xxxxxxxx) or node number (nnnn) to obtain information about a specific node.

You can also specify wild cards on this parameter. See Using wildcards for additional information. You must specify the NAME= parameter of the NODE initialization statement for the referenced node.

PATHMGR[=No|RESET|Yes]

Displays whether this connection supports path manager type protocols.

PRIVATE[=No|Yes]

Displays whether the connection between this node and an adjacent node is broadcast to the rest of the network.

REST[=rest]

Displays an integer (0-2000) that represents the resistance rating of the connection as viewed by the installation manager and coordinated with other installations. You can specify wild cards on this parameter. See Using wildcards for additional information.

For information about resistances, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

STATIC[=No|Yes]

Displays whether (YES) or not (NO) the connection is static.

STATUS[=ACTIVE|HELD|INACTIVE]

Displays the status of the connection. The following are valid types of status:

ACTIVE

JES2 displays only active connections, which include the following (in addition to ACTIVE without qualification):

ACTIVE(HELD) is displayed when a static connection exists but the underlying connection is in the process of signing on.

ACTIVE(INACTIVE) is displayed when a static connection exists but the underlying connection is inactive.

INACTIVE

JES2 displays only inactive connections.

HELD

JES2 only displays connections in the process of signing on.

STATE[=EXTRA|INUSE|PENDING|RESTMAX| UNCONNECTED]

This parameter further describes the state of an active connection. It is only displayed when STATUS=ACTIVE.

The keyword values and their meanings are:

EXTRA

Connection is currently not a part of any path and is not needed to reach any node.

INUSE

Connection is currently in use in some path to a node.

PENDING

An INUSE STATIC connection to an adjacent node for which the corresponding line is not currently signed on.

RESTMAX

Connection is not in use because all paths that can make use of it have reached their resistance limit (as specified on NJEDEF RESTMAX).

UNCONNECTED

Static connection between two nodes, neither of which are reachable by any path.

TIME

Displays the time JES2 received the connection record for a connection or the time the operator issued a command that changed a static connection.

Authority Required

This command requires display authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Scope

Single member. The response to this command will be a display of information about this member only. You might want to use this command to get information about all members in the MAS. To do so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP815 message is issued in response to this command.

Examples

 1   $D CONNECT,NODEA=PHOENIX,NODEB=TUCSON

The above example displays all existing connections between members of the node PHOENIX and the node TUCSON.

The above example displays all direct connections into member 2 of the PHOENIX node.