DECnet NCP SHOW — VMS DECNet_SNA_Gateway_2.0
Use the SNANCP SHOW commands to display the following information
about the Gateway components:
o SUMMARY - brief information about the component.
o STATUS - dynamic information about the component, such as the
current state.
o CHARACTERISTICS - static information about the component,
such as parameter values.
o COUNTERS - operational counters for the component.
o LOGGING - information about Gateway event logging.
For some components, in place of a specific component-id, you can
specify KNOWN for information on all the components defined, or ACTIVE
for information on all active components.
Specify 'TO file-spec' if you want to file the SHOW information
instead of displaying it on your terminal.
Additional information available:
ACCESS_NAMECIRCUITLINELOGGINGLUPU
SERVER
ACCESS_NAME
The SHOW ACCESS NAME command displays information about the specified
access name.
FORMAT:
SHOW access-name-component parameter [qualifier]
ACCESS NAME COMPONENTS:
ACCESS NAME access-name-id
Displays information for a particular access name. Enter the
access-name-id as a string of 1 to 16 alphanumeric characters.
KNOWN ACCESS NAMES
Displays information for all known access names.
Do not include an underscore in "ACCESS NAME".
Additional information available:
CHARACTERISTICS
Displays information about access name definitions. The access name DATA parameter will be shown only if you have given the privileged user name and password in the USE SYSTEM command. If you have not specified the privileged access control information, the DATA parameter value will not be displayed. Instead, you will see the character string *SET* to indicate that a value has been set for this parameter.
SUMMARY
Displays existing access names and notes. This is the default for SHOW ACCESS NAME.
Example
SNANCP> SHOW KNOWN ACCESS NAMES This command displays a list of all access names and any notes specified for the names.
CIRCUIT
The SHOW CIRCUIT command displays information about the specified
circuit.
FORMAT:
SHOW circuit-component parameter [qualifier]
CIRCUIT COMPONENTS:
CIRCUIT circuit-id
Displays information for a particular circuit. Enter
circuit-id in the format SDLC-n or CHAN-n.
ACTIVE CIRCUITS
Displays information for all active circuits.
KNOWN CIRCUITS
Displays information for all known circuits.
Additional information available:
CHARACTERISTICSCOUNTERSSTATUSSUMMARY
CHARACTERISTICS
Displays information about the parameters that have been set for the circuit.
COUNTERS
Displays information about circuit counters.
STATUS
Displays status information about the circuits. This may be merely the circuit-id and state, or it may include additional information.
SUMMARY
Displays the circuit-id, state, and note. This is the default for SHOW CIRCUIT.
Circuit states
A circuit can be in any of the following states:
Off the circuit has not been set on
On-starting the circuit has been set on and the Gateway
is waiting for the IBM host to establish
communications
On the IBM host is communicating with the Gateway
On-timed out the Gateway has lost communication with the IBM host
because of a poll timeout (SDLC circuits only)
On-disconnected the IBM host has ended the communication with
the Gateway
On-IBM loopback the IBM host is doing modem loopback tests -
the state of the circuit will return to 'on'
when the loopback tests have been completed.
(SDLC circuits only).
A circuit is ACTIVE when it is in any of the 'on' states.
Example
1. SNANCP> SHOW CIRCUIT SDLC-3
This command provides a summary display of circuit
information for the synchronous link named SDLC-3.
2. SNANCP> SHOW CIRCUIT CHAN-0 COUNTERS
This command provides a display of the circuit counters for
the channel-attached link CHAN-0.
LINE
The SHOW LINE command displays information about the specified line.
FORMAT:
SHOW line-component parameter [qualifier]
LINE COMPONENTS:
LINE line-id
Displays information for a particular line. Enter the line-id
in the format SYN-n or CQ-n.
ACTIVE LINES
Displays information for all active lines.
KNOWN LINES
Displays information for all known lines.
Additional information available:
CHARACTERISTICSCOUNTERSSTATUSSUMMARY
CHARACTERISTICS
Displays information about the parameters that have been set for the line.
COUNTERS
Displays information about line counters.
STATUS
Displays status information for the specified line. This may be merely the line-id and state, or it may include additional information.
SUMMARY
Displays the line-id, state, and note string. This is the default for SHOW LINE.
Line states
The line state is either OFF or ON. There are no substates displayed for lines.
Example
1. SNANCP> SHOW LINE SYN-2
This command provides summary information for line SYN-2.
2. SNANCP> SHOW LINE CQ-0 COUNTERS
This command provides line counter information for line CQ-0.
LOGGING
The SHOW LOGGING command displays information about the current
logging parameters.
FORMAT:
SHOW logging-component parameter [qualifier]
LOGGING COMPONENTS:
LOGGING MONITOR
Displays information for logging monitors..
LOGGING FILE
Displays information for logging files.
KNOWN LOGGING
Displays information for monitor and file logging types.
Additional information available:
CHARACTERISTICSKNOWN_SINKSSINK_NODESTATUS
SUMMARY
CHARACTERISTICS
Displays information about logging parameters.
KNOWN_SINKS
Format: KNOWN SINKS Specifies that information is to be displayed for all known sink nodes. KNOWN SINKS is the default, unless you explicitly use the SINK NODE parameter.
SINK_NODE
Format: SINK NODE node-id Specifies the sink node for which you want information. If you do not enter this parameter, information is displayed for all known sink nodes.
STATUS
Displays status information about logging. This may include information such as whether there is a LOGGING FILE or LOGGING MONITOR component.
SUMMARY
Displays summary information such as, the type and the state of logging. This is the default for SHOW LOGGING.
Example
1. SNANCP> SHOW KNOWN LOGGING STATUS
This command displays status information on current logging.
2. SNANCP> SHOW LOGGING MONITOR SINK NODE SPLASH TO HOCKNEY.LOG
This command displays information about the sink node SPLASH
and the state of logging. The display is written to the text
file HOCKNEY.LOG in the current directory.
LU
The SHOW LU command displays information about specified LU(s).
FORMAT:
SHOW lu-component [component-qualifier] parameter [qualifier]
LU COMPONENTS:
LU lu-id
Displays information for the specified LU. Enter the lu-id in
the format pu-id.nnn, for example, SNA-0.1.
ACTIVE LUS
Displays information for all active LUs.
KNOWN LUS
Displays information for all known LUs.
Additional information available:
CHARACTERISTICSCOUNTERSSTATUSSUMMARY
LU statesComponent QualifiersExample
CHARACTERISTICS
Displays information about the levels of event logging for the specified LU(s).
COUNTERS
Displays information about counters for the latest LU-LU session. The latest session can be either the current session or the last session. Counters from the latest session are automatically set to zero at the start of each new session.
STATUS
Displays the LU identification, LU status, and BIND parameters, if the
specified LU is any of the active states. The BIND parameters for an
active LU can include any of the following:
Parameter Format
LU Type Decimal number
Primary LU 8 characters
RU size (in) Decimal number
RU size (out) Decimal number
TS profile Decimal number
FM profile Decimal number
Secondary send pacing Decimal number
Secondary receive pacing Decimal number
Last receive check Hex number
Last transmit check Hex number
Logon mode table entry 8 characters
The Last Receive Check shows the IBM status code for the last error
that occurred while the IBM system was receiving information. The
Last Transmit Check shows the IBM status code for the last error that
occurred while the IBM system was transmitting information.
SUMMARY
Displays the LU identification, state, note (if one exists), and associated server (if applicable) for the specified LU. SUMMARY is the default for SHOW LU.
LU states
An LU can be in any one of the following states. However, the states
that you will usually see are active, active-in-session, and inactive.
inactive this Gateway LU does not have an active
session with an SSCP
inactive-listening same as inactive except that a server is
connected and listening on the LU (it is
listening for a BIND)
pending-active the Gateway is the process of setting up
the LU-SSCP session
pending-active-listening same as pending-active except that a
server is connected and listening on
the LU (it is listening for a BIND)
active there is an LU-SSCP session active
active-listening same as active except that a server is
connected and listening on the LU (it is
listening for a BIND)
active-bind-requested an LU-SSCP session is active and a server
has requested an LU-LU session with an
IBM application. No BIND message has been
received.
active-bind-in-progress a LU-LU session with an IBM application
has been requested, and a BIND from the
IBM application is being processed
active-in-session an LU-LU session is active, and a server
is connected. For example, a DECnet/SNA
Gateway TE user might be using a CICS
application on the IBM host.
active-unbind-requested an LU-LU session is active. A server has
requested the SSCP to end the LU-LU
session with an IBM application. No
UNBIND message has been received.
active-unbind-in-progress an LU-LU session with an IBM application
is still active. An UNBIND message has
been received and is being processed.
pending-inactive the LU-SSCP session is in the process
of being terminated
pending-inactive-listening same as pending-inactive except
that there is a server listening
on the LU
Component Qualifiers
AUTHORIZATION auth-id
KNOWN AUTHORIZATIONS
Displays information about the authorization entry you specify. Enter
the auth-id as as string of up to 16 alphanumeric characters, for
example, POP_ARTISTS.
If you use one of the component qualifiers, you may use only the
SUMMARY or CHARACTERISTICS parameter. For example, the following
command displays summary information.
SNANCP> SHOW LU SNA-0.1 KNOWN AUTHORIZATION
The following command displays output on authorization characteristics
(you must be a privileged user to use this command):
SNANCP> SHOW LU SNA-0.1 KNOWN AUTHORIZATION CHARACTERISTICS
Example
SNANCP> SHOW LU SNA-0.1 This command will cause the SUMMARY information to be displayed.
PU
The SHOW PU command displays information about the specified PU(s).
FORMAT:
SHOW pu-component parameter [qualifier]
PU COMPONENTS:
PU pu-id
Displays information for the specified PU. Enter the pu-id in
the format SNA-nnn, for example, SNA-0.
ACTIVE PUS
Displays information for all active PUs.
KNOWN PUS
Displays information for all known PUs.
Additional information available:
CHARACTERISTICSCOUNTERSSTATUSSUMMARY
CHARACTERISTICS
Displays information about the parameters that have been set for the specified PU(s).
COUNTERS
Displays information about PU counters. The display includes information on the number of active LUs.
STATUS
Displays status information for the specified PU(s). This may be merely the PU identification and state, or it may include additional information.
SUMMARY
Displays the PU identification, state, and note string. This is the default for SHOW PU.
PU states
A PU can be in the following states: inactive the PU-SSCP session is inactive active the PU-SSCP session is active
Example
SNANCP> SHOW PU SNA-0 This command will cause the summary information to be displayed.
SERVER
The SHOW SERVER command displays information about the specified
server.
FORMAT:
SHOW server-component [component-qualifier] parameter [qualifier]
SERVER COMPONENTS:
SERVER server-id
Displays information for the specified server. The server-id
is one of the following: DHCF, RJE, or SNA-ACCESS.
KNOWN SERVERS
Displays information for all three servers.
Additional information available:
CHARACTERISTICSCOUNTERSSTATUSSUMMARY
CHARACTERISTICS
Displays information about the current characteristics of the specified server. The SHOW SERVER DHCF CHARACTERISTICS display differs slightly from the display for other servers.
COUNTERS
Displays information about the counters for the current session. There are no SNANCP counters for the RJE server; counters for RJE are maintained by the host-based RJE multiplexer (RJEMPX).
STATUS
Displays the server name and state. If applicable, this parameter also displays the corresponding DECnet logical link number and the DECnet node name, as well as specific information about the connected LUs for each server. The SHOW SERVER STATUS display is different for each server.
SUMMARY
Displays the server name, state, and note text. This SUMMARY display is the default for SHOW SERVER.
Component Qualifiers
The following component qualifiers apply only to the SNA-ACCESS server. LU lu-id Displays information on outbound session allocation parameters for the specified LU. KNOWN LUS Displays information on outbound session allocation parameters for all LUs allocated to the SNA-ACCESS server.
Example
1. SNANCP> SHOW KNOWN SERVERS
This command displays the name, state, and notes for all
known servers.
2. SNANCP> SHOW SERVER SNA-ACCESS KNOWN LUS
This command displays all outbound session allocation
parameters, for all LUs that are enabled for outbound session
allocation with the SNA-ACCESS server..