SNA Switching Services Commands

show snasw class-of-service [brief | detail]

Syntax Description show snasw class-of-service [brief | detail]

Syntax Description

brief	(Optional) Indicates a one-line display per displayed resource. For COS entries the brief version displays COS name, transmission priority, and number of node and TG rows.
detail	(Optional) Indicates a detailed, multiline display of all fields returned for COS display.

Syntax Description show snasw connection-network [brief | detail]

Syntax Description

brief	(Optional) Indicates a one-line display per resource. For connection-network entries, the brief version displays the connection network name, the number of attached ports, and the port names in the connection network.
detail	(Optional) Indicates a detailed, multiline display of all fields returned for connection-network display.

Syntax Description show snasw directory [name resourcenamefilter] [brief | detail ]

Syntax Description

name resourcenamefilter	(Optional) Indicates the fully qualified name of the resource (1 to 17 characters). Only resource names that match the specified name are displayed.
brief	(Optional) Indicates a one-line display for each resource. For directory entries, the brief version displays resource name, owning CP name, network node server name, and entry type.
detail	(Optional) Indicates a detailed, multiline display of all fields returned for the directory display.

Syntax Description show snasw dlctrace [all | last number-records | next number-records] [brief | detail] [filter filter-string] [id recordid]

Syntax Description

all	(Optional) Indicates that all records in the dlctrace buffer are displayed.
last number-records	(Optional) Indicates the last n frames before the record identified in the ID operand (or before the last record in the trace if the ID operand is not coded) are displayed.
next number-records	(Optional) Indicates the next frames after the record identified in the ID operand (or from the beginning of the trace if the ID operand is not coded) are displayed.
brief	(Optional) Indicates a one-line display per trace entry describing the type of frame traced.
detail	(Optional) Indicates a a detailed, multiline display of the frame that displays the brief information plus a hexadecimal dump of the entire frame.
filter filter-string	(Optional) Indicates that a string follows against which the formatted trace output are filtered. Only frames that contain the filter-string are displayed.
id recordid	(Optional) Indicates the 1 to 999,999 trace record identifier. Only the frame ID that matches the record specified is displayed.

Syntax Description show snasw dlus [brief | detail]

Syntax Description

brief	(Optional) Indicates that one line per DLUS is displayed. For dlus, the brief version includes the DLUS name, state (active or inactive), port name, cpname, node type, and number of active PUs on the DLUS.
detail	(Optional) Indicates the detailed, multiline display that shows all fields returned for DLUS displayed.

Syntax Description show snasw ipstrace [all | next number-records | last number-records] [filter filter-string] [id recordid]

Syntax Description

all	(Optional) Specifies all records are displayed
next number-records	(Optional) Displays records from beginning or following record IS.
last number-records	(Optional) Indicates that the last n frames before the record identified in the ID operand (or before the last record in the trace if the ID operand is not coded) are displayed.
filter filter-string	(Optional) Indicates that a string follows against which the formatted trace output is filtered. Only frames that contain the filter-string are displayed.
id recordid	(Optional) Indicates the 1 to 999,999 trace record identifier. Only the frame ID that matches the record specified are displayed.

Syntax Description show snasw link [brief | detail] [cpname cpnamefilter] [name linknamefilter] [port portnamefilter] [rmac macfilter] [xid xidfilter]

Syntax Description

brief	(Optional) Indicates that one line per link is displayed. For links, the brief version should include the link name, state (active or inactive), port name, cpname, and node type information.
detail	(Optional) Indicates that a detailed, multiline display that shows all fields returned for links displayed.
cpname cpnamefilter	(Optional) Indicates a fully qualified cpname (1 to 17 characters). Only links with CP names (as known to the router) that match the specified cpname are displayed.
name linknamefilter	(Optional) Indicates the name of the link to be displayed. Only links matching this name are displayed.
port portnamefilter	(Optional) Indicates the handle "naming" for the specific port (1 to 8 characters). All links associated with a port matching the filter are displayed.
rmac macfilter	(Optional) Indicates a 48-bit MAC address in hexadecimal form. Only links with a remote MAC address matching the MAC address specified are displayed.
xid xidfilter	(Optional) Indicates a 4-byte XID (idnum/idblk) specified in hexadecimal form. Only links matching the configured XID are displayed.

Syntax Description show snasw lu [brief | detail] [name luname] [pu puname]

Syntax Description

brief	(Optional) Indicates that one line per link is displayed. For LU, the brief display includes LU name, PU name, DLUS name, and PLU name.
detail	(Optional) Indicates that a detailed, multiline display that shows all possible fields returned for the link is displayed.
name luname	(Optional) Indicates an LU name to filter. Only LUs matching the specified name are displayed.
pu puname	(Optional) Indicates a PU name to filter. Only LUs for the specified name PU are displayed.

Syntax Description

This command has no arguments or keywords.

Syntax Description

This command has no arguments or keywords.

Syntax Description show snasw pdlog [brief | detail ] [all | next number-records | last number-records] [filter filterstring] [id recordid]

Syntax Description

brief	(Optional) Indicates that a one-line description for each pdlog entry is returned.
detail	(Optional) Indicates that a multiline display is returned.
all	(Optional) Specifies all records are displayed
next number-records	(Optional) Displays records from the beginning or following a record ID.
last number-records	(Optional) Indicates that the last n frames before the record identified in the ID operand (or before the last record in the trace if the ID operand is not coded) are displayed.
filter filterstring	(Optional) Shows output filtered on a specific string.
id recordid	(Optional) Indicates the 1 to 99999 trace record identifier. Only the frame ID that matches the record specified is displayed.

Syntax Description show snasw port [brief | detail] [name portnamefilter]

Syntax Description

brief	(Optional) Indicates that a one-line description for each port entry is displayed.
detail	(Optional) Indicates that a multiline display is returned.
name portnamefilter	(Optional) Indicates the name of the port to filter for which information is displayed. Only ports matching name are displayed.

Syntax Description show snasw pu [brief | detail] [dlus dlusfilter] [name punamefilter]

Syntax Description

brief	(Optional) Indicates that one-line per PU is displayed. For PU, the brief version includes the PU name, PU ID, state, defined DLUS, and current DLUS.
detail	(Optional) Indicates that a detailed, multiline display that shows all possible fields returned for a link is displayed.
dlus dlusfilter	(Optional) Indicates the fully qualified DLUS name (1 to 17 characters). Only PUs that are currently served by the DLUS specified are displayed.
name punamefilter	(Optional) Indicates the handle "naming" of the PU (1 to 8 characters). Only links matching this name are displayed.

Syntax Description show snasw rtp [brief | detail] [class-of-service cosname] [name connectionnamefilter] [tcid tcidconnection]

Syntax Description

brief	(Optional) Indicates that one-line per RTP is displayed. For RTP, the brief version includes the RTP name, local TCID, remote TCID, remote cpname, and COS.
detail	(Optional) Indicates a detailed, multiline display with all fields returned for RTP is displayed.
class-of-service cosname	(Optional) Shows specific HPR RTP connections by COS name.
name connectionnamefilter	(Optional) Indicates the name of the RTP connection (1 to 8 characters). Only TG records origins or destinations that match the specified name or node records are displayed.
tcid tcidconnection	(Optional) Shows the specific HPR RTP connection for the local TCID connections.

Syntax Description

local	(Optional) Indicates that the scope of the display is limited to the types of sessions indicated. Local sessions are those that terminate on the node. Examples include CP-CP sessions and DLUR-DLUS sessions.
dlur	(Optional) Indicates that the scope of the display is limited to the types of sessions indicated. DLUS sessions are LU-LU sessions passing through the node, which are using the DLUR for dependent session.
intermediate	(Optional) Indicates that the scope of the display is limited to the types of sessions indicated. Intermediate sessions are LU-LU sessions passing through the node and are not DLUR-associated.
name sessionnamefilter	(Optional) Indicates the fully qualified name (1 to 17 characters). Only sessions that have a local or remote endpoint LU name matching the supplied name are displayed.
pcid pcidfilter	(Optional) Indicates an 8-byte PCID specified in hexadecimal form. All sessions matching the PCID filter are displayed.
brief	(Optional) Indicates that one-line per session is displayed. For sessions, the brief version includes PCID, state (active or inactive), session endpoint LU names, and mode
detail	(Optional) Indicates a detailed, multiline display that shows all fields returned for the session is displayed.

Syntax Description

This command has no arguments or keywords.

Syntax Description show snasw summary-ipstrace [all | next number-records | last number-records] [id recordid ] [filter filter-string]

Syntax Description

all	(Optional) Specifies all records are displayed
next number-records	(Optional) Displays records from the start or starting with the record ID.
last number-records	(Optional) Displays records from the end or prior to the record ID. Indicates that the last n frames before the record identified in the ID operand (or before the last record in the trace if the ID operand is not coded) are displayed.
id recordid	(Optional) Indicates a 1 to 999,999 trace record identifier.
filter filter-string	(Optional) Indicates that a string follows against which the formatted trace output is filtered. Only frames that contain the filter-string are displayed.

Syntax Description show snasw topology [name cpnamefilter] [brief | detail]

Syntax Description

name cpnamefilter	(Optional) Indicates the fully qualified name of the CP (1 to 17 characters). Only records that match the cpname specified are displayed.
brief	(Optional) Indicates one line per topology record is displayed.
detail	(Optional) Indicates a detailed, multiline display of topology information.

Syntax Description

netid.name	Fully qualified CP name for this node, consisting of both network ID and cpname.
netid	Partial CP name, which consists of only a network ID. If this option is selected, the hostname or IP address operands must also be configured to complete the fully qualified cpname.
hostname	(Optional) Indicates a CP name built using the hostname configured on the router. When configuring this operand, code a netid only. The last eight characters of the hostname are used to complete the CP name.
ip-address interface-name	(Optional) Indicates the CP name built by deriving the cpname from the IP address on the interface indicated in the interface-name. When configured, this operand requires a netid operand. In addition, a portion of the cpname may be configured. The remaining characters of the cpname that are not configured are generated from the IP address indicated. The generated characters are derived from a hexadecimal format of the IP address for the interface specified.

Syntax Description

link linkname [session session address]	(Optional) Specifies the link name upon which the DLC trace is filtered (one to eight characters). All incoming and outgoing frames matching this link are traced.
port portname	(Optional) Specifies the port name upon which the port is filtered (one to eight characters). All incoming and outgoing frames matching this port are traced.
rmac mac-address-value [session session address]	(Optional) Indicates the MAC address upon which the DLC trace is filtered. All incoming and outgoing frames matching this MAC address are traced.
rtp rtp-name	(Optional) Specifies the RTP name upon which the RTP is filtered (one to eight characters). All incoming and outgoing frames matching this RTP connection name are traced.
type	(Optional) Indicates that a frame type filter follows. Use the type operand to further refine the filter to specify frame types.
cls	(Optional) Indicates that commands to the local DLC are traced.
hpr-cntl	(Optional) Indicates that the HPR format identifier 5 (FID5), which does not carry an SNA data payload, is traced.
hpr-data	(Optional) Indicates that the HPR format identifier 5 (FID5), which carry an SNA data payload, is traced.
isr	(Optional) Indicates that the SNA and APPN format identifier 2 (FID2) are traced.
xid	(Optional) Indicates that the XID frames are traced.

Syntax Description

buffer-size buffer-size-value	(Optional) Specifies the size (in kilobytes) of the DLC trace buffer requested. The minimum buffer size is 100, while the maximum is 16000.
file filename	(Optional) Specifies the file name for the DLC trace buffer file when writing this file to the file server. Use the following format: protocol://host/path/filename.
timestamp	(Optional) Appends the current date and time to the end of the file when it is dumped.
frame-size frame-size-value	(Optional) Indicates the size of the frame that is traced within the DLC trace. All data beyond the size value are truncated and are not included in the trace. The default is that the entire frame is traced.
auto-terse	(Optional) Indicates LU-LU and SSCP-LU session data frames should be truncated after the SNA RH. Control frames (for example, XID, BIND, ACTPU) are traced in their entirety.
format	(Optional) Indicates the format the DLC trace is written to when writing to a file server.
brief	(Optional) Indicates a text file is written with a one-line-per-frame summary for each frame.
detail	(Optional) Indicates a text file is written with a frame summary line followed by a complete hexadecimal dump of the frame.
analyzer	(Optional) Indicates a binary file is generated that is readable by several popular network analyzer products. This format uses the Network Associates Sniffer file format.

Syntax Description

primary-dlus-name	Specifies the fully qualified name of the primary DLUS (3 to 17 characters).
backup backup-dlus-name	(Optional) Indicates configuration of a backup DLUS. A backup DLUS is used when the primary DLUS is unreachable or cannot service a specific downstream device. The fully qualified name of the backup DLUS is 3 to 17 characters in length.
prefer-active	(Optional) Indicates that if an active DLUS/DLUR connection was established, an incoming PU will retry exclusively on the active DLUS connection and will not attempt to connect to a different DLUS.
retry interval count	(Optional) Indicates that the DLUR retry parameters follow this statement. Interval indicates the time period between attempts to connect a DLUS if one is not serving a specific PU. Retry indicates the number of times the current or primary DLUS is retried before attempting to connect to a backup or currently inactive DLUS.

Syntax Description

all	Indicates all configured trace and problem determination buffers should be transferred. The file operand must be configured on the enabling configuration command for the buffers to be dumped. Traces that run but do not have the file operand coded are not transferred.
dlctrace	Indicates the DLC trace buffer is transferred to a file server. If file is configured on the snasw dlctrace command, the URL specified is used for transferring the DLC trace file. If file is not configured on the snasw dlctrace command, the transfer protocol will default to TFTP, and the user is prompted for the remote host and file name for the transferred file.
ipstrace	Indicates the IPS trace buffer is transferred to a file server. If file is configured on the snasw ipstrace command, the URL specified is used for transferring the ipstrace file. If file is not configured on the snasw ipstrace command, the transfer protocol will default to TFTP, and the user is prompted for the remote host and file name for the transferred file.
summary-ipstrace	Indicates the summary IPS trace buffer is transferred to a file server. If file is coded on the snasw summary-ipstrace command, the URL specified is used for transferring the summary ipstrace file. If file is not coded on the snasw ipstrace command, the transfer protocol will default to TFTP, and the user is prompted for the remote host and file name for the transferred file.
pdlog	Indicates the problem determination log buffer is transferred to a file server. If file is coded on the snasw pdlog command, the URL specified is used for transferring the pdlog file. If file is not coded, the transfer protocol will default to TFTP, and the user is prompted for the remote host and file name for the transferred file.

Syntax Description

cpcp	(Optional) Indicates that an event is issued for CP-CP session state changes.
defined-ls	(Optional) Indicates that an event is issued for state changes on defined links.
dlc	(Optional) Indicates DLC state changes.
implicit-ls	(Optional) Indicates state change on implicit links.
port	(Optional) Indicates that an event is issued for port state changes.

Syntax Description

as	(Optional) Specifies a filter on the Address Space component.
asm	(Optional) Specifies a filter on the Address Space Manager component.
bm	(Optional) Specifies a filter on the Buffer Management component.
ch	(Optional) Specifies a filter on the CH component.
cpc	(Optional) Specifies a filter on the CPIC component.
cs	(Optional) Specifies a filter on the Configuration Services component.
di	(Optional) Specifies a filter on the DI component.
dlc	(Optional) Specifies a filter on the Data Link Control component.
dma	(Optional) Specifies a filter on the DMA component.
dr	(Optional) Specifies a filter on the DLUR component.
ds	(Optional) Specifies a filter on the Directory Services component.
es	(Optional) Specifies a filter on the ES component.
ha	(Optional) Specifies a filter on the HA component.
hpr	(Optional) Specifies a filter on the HPR component.
hs	(Optional) Specifies a filter on the Half Session component.
lm	(Optional) Specifies a filter on the LU Manager component.
mds	(Optional) Specifies a filter on the Management Data Stream component.
ms	(Optional) Specifies a filter on the Management Services component.
nof	(Optional) Specifies a filter on the Node Operator Facility component.
pc	(Optional) Specifies a filter on the Path Control component
ps	(Optional) Specifies a filter on the Presentation Services component.
pu	(Optional) Specifies a filter on the PU Manager component.
px	(Optional) Specifies a filter on the PU Concentration component.
rm	(Optional) Specifies a filter on the Resource Manager component.
rtp	(Optional) Specifies a filter on the RTP component
ru	(Optional) Specifies a filter on the Request Unit Interface component.
scm	(Optional) Specifies a filter on the Session Connect Manager component.
sco	(Optional) Specifies a filter on the SCO component.
sm	(Optional) Specifies a filter on the Session Manager component.
spc	(Optional) Specifies a filter on the SPC component.
ss	(Optional) Specifies a filter on the Session Services component.
trs	(Optional) Specifies a filter on the Topology Routing Services component.

Syntax Description

buffer-size buffer-size-value	(Optional) Indicates that this trace command controls the size of the buffer used for storing ipstrace elements (in kilobytes). The default is 500 KB. The minimum buffer size if 10 KB; the maximum is 16000 KB.
file filename	(Optional) Specifies the file name for the IPS trace buffer file when writing this file to the server.
timestamp	(Optional) Appends the current date and time to the end of the file when it is dumped.

Syntax Description

linkname	Indicates the one-to-eight character local name for this link. This name is used to identify the link in show and privileged EXEC commands.
port portname	Specifies the SNASw port from which this link will connect.
rmac mac-address	Specifies the 48-bit MAC address of the destination station. Either this operand or ip-dest is required. RMAC is required for all links associated with ports that are not HPR/IP ports.
ip-dest ip-address	Indicates the IP address or DNS name of the destination stations. Either this operand or rmac is required. For all links associated with HPR/IP ports, ip-dest is required.
rsap sap-value	(Optional) Indicates the destination SAP value, which defaults to 4.
nns	(Optional) Configures the adjacent link as a preferred network node server.
tgp	(Optional) Configures a TG characteristic profile for route calculation.
high	(Optional) Prefers this link over links with TG profile of medium or low.
low	(Optional) Prefers this link when links with a TG profile of high or medium is not available.
medium	(Optional) Prefers this link when links with a TG profile of low is not available.
secure	(Optional) Prefers this link with when a secure TG is required by the appn class-of-service in use.
nostart	(Optional) Indicates that the link will not start automatically when defined.

Syntax Description

resource-name	Indicates the fully qualified name of the resource for which location information is being configured (3 to 17 characters).
owning-cp cpname	Indicates the fully qualified cpname where the resource resides.

Syntax Description

rtp-connection-name	Specifies the RTP connection to path-switch. This is an eight-byte string. You can obtain the value for the rtp-connection-name argument from the show snasw rtp command.
all	Specifies that a pathswitch operation will be initiated for every RTP connection managed by the local node.

Syntax Description

problem	(Optional) Indicates that only problem records are sent to the console. This is the default.
exception	(Optional) Indicates that both problems and exceptions are sent to the console.
info	(Optional) Indicates that informational messages and problems and exceptions are sent to the console.
buffer-size buffer-size-value	(Optional) Indicates the size of the pdlog buffer requested (in kilobytes). The default is 500 KB. The minimum is 10 KB, and the maximum is 16000 KB.
file filename	(Optional) Indicates the URL for writing the pdlog file to a server. Use the following format: protocol://host/path/filename.
timestamp	(Optional) Appends the current date and time to the end of the file when it is dumped.

Syntax Description

portname	Indicates the one- to eight-character name for the port. This argument is used to refer to this port in informational messages and the show snasw port command.
hpr-ip	(Optional) Indicates that the port is HPR/IP.
vdlc ring-group	(Optional) Indicates that the port is VDLC. No interfacename is required. The ring-group argument indicates the source-bridge ring group of which this VDLC port is a member.
mac mac-address	(Optional) Indicates that the virtual source MAC address used for the VDLC port.
interfacename	Indicates the name of the interface over which the port will communicate. Allowable interfaces include Token Ring, Ethernet, VLAN, or loopback.
conntype nohpr | len | dyncplen	(Optional) The keyword conntype indicates the connection type for the port. Conntype can be set to one of three values: nohpr, len, or dyncplen. If not configured, HPR-capable links are established. The keyword nohpr indicates that the HPR is not supported but APPN connections with CP-CP sessions are permitted. The keyword len indicates that APPN connections are not allowed; only LEN node-level connectivity is negotiated. The keyword dyncplen (similar to LEN node in functionality) also replaces the cpname. This option is specifically intended for users with XID3-capable devices that send CP names, but whose CP names configured on these devices have not been configured uniquely across the devices. Therefore, a default cpname must be generated to have a properly functioning APPN connection management and directory function
hpr-sap hpr-sap-value	(Optional) Indicates the local HPR-SAP value.
max-links link-limit-value	(Optional) Indicates the number of links permitted on this port. When this link limit is reached, the port will not respond to inbound connection requests from stations attempting to connect to this port. Outbound connections are still permitted. Maxlinks can only be coded on VDLC and Virtual Token Ring port types.
sap sap-value	(Optional) Indicates the local SAP value.
vnname virt-node-name	(Optional) Indicates the network qualified virtual node name (3 to 17 characters) of the connection network being defined.
nns-required	(Optional) Indicates that this port will not respond to downstream connections requests unless this node has active CP-CP sessions to an upstream NNS. This operand allows configurations with redundant downstream MAC addresses to only allow SNASw nodes that have appropriate upstream connectivity to accept connections from downstream devices.
nostart	(Optional) Indicates that the port will not open automatically when defined.

Syntax Description

This command has no arguments or keywords.

Syntax Description snasw start cp-cp cpname

Syntax Description

cpname

Indicates the fully qualified CP name of the adjacent node with which CP-CP sessions should be started.

Syntax Description

linkname

Indicates the name of the link as configured or shown in show snasw link.

Syntax Description

portname

Indicates the name of the port as configured or shown in the show snasw port command.

Syntax Description

This command has no arguments or keywords.

Syntax Description snasw stop cp-cp cpname

Syntax Description

cpname

Indicates the fully qualified CP name of the adjacent node with which CP-CP sessions should be stopped.

Syntax Description

linkname

Indicates the name of the link as configured or shown in the show snasw link command.

Syntax Description

portname

Indicates the name of the port as configured or shown in the show snasw port command.

Syntax Description

pcid	Procedure correlator ID in 16-digit hexadecimal form.
fqcpname	Fully qualified cpname of the node that generates the PCID.
netid-destination	Fully qualified primary LU name.