DISPLAY VTAMSTOR command

Abbreviations

Purpose

The DISPLAY VTAMSTOR command displays storage contents associated with VTAM® modules and resources.

Operands

ADDRESS=storage_address

Specifies the address (in hexadecimal). The storage address must be in the range of 0–7FFFFFFF.

LENGTH=decimal_number_of_bytes

Specifies the number of bytes in decimal to display. The valid range is 1–value of DSPLYMAX multiplied by 16.

MODULE=module_name

Specifies a module name (or CSECT name). The module name must be eight characters in length and begin with the VTAM prefixes ACY, IST, IUT, or IVT.

NETADDR

Specifies the network address of a resource. The following notes apply to subrarea_address and element_address:

subarea_address

Specifies the subarea portion of the network address. Leading zeros are acceptable but not required. If omitted, subarea_address defaults to the subarea number of the host. Acceptable values are 1–FFFF in hexadecimal; 1–65535 in decimal. If the value is greater than the host's MXSUBNUM start option, the command will be rejected.

element_address

Specifies the element portion of the network address. Leading zeros are acceptable but not required. Acceptable values range from 0–FFFF in hexadecimal; 0–65535 in decimal.

D

Indicates that the subarea and element addresses are specified in decimal.

X

Indicates that the subarea and element addresses are specified in hexadecimal.

Note:

1. To display an Enhanced network address, you must incorporate the index into either the subarea_address or the element_address. Leading zeros are acceptable but not required. If omitted, the index defaults to 0. Acceptable values are 1-1FA in hexadecimal and 1-506 in decimal.
2. To incorporate the index into either the subarea_address or the element_address, perform the following actions:
   • In hexadecimal format, concatenate the index in front of the 2–byte subarea or element. For example, subarea 2, index 1, element 3 can be entered as NETADDR=(10002,3) or NETADDR=(2,10003).
   • In decimal format, multiply the index by 65536 and add it to the subarea or element. For example, subarea 2, index 1, element 3 can be entered as NETADDR=(65538,3,d) or NETADDR=(2,65539,d).

NETID=network_id

Specifies the network identifier. If omitted, the network identifier of the host is used.

RESOURCE=resource_name

Specifies the network-qualified name of the resource for which the resource definition table entry is to be displayed. If the network identifier is omitted, the network of the host is used.

Tip: If you are specifying a model resource (APPL or CDRSC), you can use wildcard characters in the name you specify. The use of wildcard characters on the RESOURCE operand does not depend on the value of the DSPLYWLD start option.

TYPE

Specifies the type of resource that the RESOURCE operand identifies. This operand is valid only when used with the RESOURCE operand. If several types of resources share the same name, TYPE can be used to identify which resource the command should act on.

TYPE=CDRM

Displays the resource definition table entry for the SSCP (represented as a CDRM).

TYPE=CP

Displays the resource definition table entry for the host CP (represented as an application) or an adjacent CP (represented as a CDRSC)

TYPE=LUALIAS

Displays the resource definition table entry for the CDRSC whose name is associated with the LUALIAS. If a network-qualified name is specified, VTAM does not search for an LUALIAS with that resource name. For more information about CDRSCs that are defined with an LUALIAS, see the z/OS Communications Server: SNA Resource Definition Reference.

TYPE=RESOURCE

Displays the resource definition table entry for the resource named on the RESOURCE operand. VTAM searches for the resource in the following order:

1. VTAM searches for an SSCP (CDRM), a host CP (application), or an adjacent CP (CDRSC) by the name specified on the RESOURCE operand and displays the resource definition table entry for the first resource found.
2. If VTAM does not find an SSCP, a host CP, or an adjacent CP, it searches for a resource with the name specified on the RESOURCE operand and displays the resource definition table entry for the resource, if it finds it.
3. If VTAM does not find a resource by that name, it searches for a USERVAR with the name specified on the RESOURCE operand and displays the resource definition table entry for the resource, if it finds it.
4. If VTAM does not find a USERVAR by that name, or a USERVAR is found but the resource defined as the value of the USERVAR is not found, it searches for an LUALIAS with the name specified on the RESOURCE operand and displays the resource definition table entry for the CDRSC, if it finds it.

TYPE=SHADOW

Displays the resource definition table entry for a shadow resource, if it exists. Included in the information displayed is the real resource that caused the displayed resource to become a shadow resource.

For more information about shadow resources, see the z/OS Communications Server: SNA Network Implementation Guide.

TYPE=SSCP

Displays the resource definition table entry for the SSCP (represented as a CDRM).

TYPE=USERVAR

Displays the resource definition table entry for the resource whose name is associated with the USERVAR.

TYPE=XCFCP

For an APPN node, this displays the resource definition table entry (RDTE) for the dynamic XCF local SNA PU representing the connection to another VTAM in the XCF group, when the RESOURCE operand specifies the CP name or SSCP name of the other VTAM. For a pure subarea node, this displays the RDTE of the dynamic XCF TRLE representing the connectivity to another VTAM node in the XCF group, when the RESOURCE operand specifies the CP name or SSCP name of the other VTAM.

XLENGTH=hex_number_of_bytes

Specifies the number of bytes in hexadecimal to display. The valid range is 1–value of DSPLYMAX multiplied by 16, converted to hexadecimal.

Resulting display