DISPLAY DIRECTRY command

Abbreviations

When using an abbreviation in place of an operand, code the abbreviation exactly as shown in the table. For example, when coding the abbreviation for SCOPE=ALL, code only EVERY or E. Do not code SCOPE=E.

Purpose

The DISPLAY DIRECTRY (directory) command displays information from the directory database about a resource and the resources that it serves and owns. For example, you can display a network node along with the end nodes that it serves and the LUs that it owns. This command is valid only when it is issued at a network node or an interchange node.

Operands

ID=name

Specifies the name of a network node, end node, or LU in the directory database. The resource name can be network-qualified. If you do not specify the network identifier, VTAM® uses the identifier of the host from which you are issuing the command.

You can specify an asterisk (*) or (*NETWORK) as the network ID portion of a network-qualified name. The * is useful for displaying a resource for which you do not know the network ID. The * is also useful for displaying several resources with the same name that are found in multiple networks, if you also specify the MAX operand on the command.

MAX

Specifies the maximum number of resources to display when the resource name on the ID operand is specified as being in any network. That is, the network ID portion of the network-qualified resource name is specified as asterisk (*) or (*NETWORK). For example, ID=*.a01n can be specified. MAX is valid only when any network resource name is specified on the ID operand.

MAX=*

Specifies that the value of the DSPLYMAX start option is used to limit the display output.

MAX=number_of_resources

Specifies the maximum number of resources that VTAM displays for this command. The valid range is 1 to the value of DSPLYMAX. The default is the value specified for the DSPLYDEF start option.

The resource name might exist in more networks than the number you specify on the MAX operand. However, VTAM searches only for the number of instances that you have specified. When that number is found, VTAM does not search any further. This saves processing time for the command and gives you control over the amount of display output generated by the command. If fewer resources are found than you have specified on MAX, VTAM displays only the resources that are found.

SCOPE

Specifies the required scope of the display.

SCOPE=ALL

Displays information for the resource specified on the ID operand and the resources it serves or owns, if any. If the specified resource is a network node, VTAM displays information about the network node, the end nodes it serves, and the LUs it owns. If the specified resource is an end node, VTAM displays information about the end node and the LUs it serves. If the specified resource is an LU, the display output is the same for SCOPE=ALL and SCOPE=ONLY.

SCOPE=ALL is not valid if you specify ID=*.name.

Attention: In a large network, displaying a network node or end node with SCOPE=ALL might generate an undesirably large display.

SCOPE=NSEARCH

Specifies that a network search is to be performed for the resource specified on the ID operand. The command returns all instances of the resource in the local domain and the first instance where the resource is found in other domains and subnetworks. The network search uses all possible search types (subarea, adjacent SSCP list, central directory server, broadcast, and cross-subnetwork) to find a resource that may go undetected by the search logic of individual session requests.

SCOPE=ONLY

Displays information only for the resource specified on the ID operand.

Resulting display

If the resource type that is displayed is EN, the node might actually be a network node, end node, or SSCP. This is because in a mixed APPN and subarea network, CPs, and SSCPs that are found in or through a subarea network are represented in this host (the host from which you are issuing this command) as end nodes that are served by the interchange node through which the resource was found.

The DISPLAY DIRECTRY command might show a resource name appearing in several networks even though the resource actually exists in only one network. This can happen if intermediate SSCPs are pre-V4R1 and they pass only the 8-character resource name. The real network ID is therefore lost and other network IDs might be subsequently assumed.