|
|
Use the commands in this chapter to configure and monitor the SNA Switching Services (SNASw) feature. For SNASw configuration tasks and examples, refer to the "Configuring SNA Switching Services" chapter of the Cisco IOS Bridging and IBM Networking Configuration Guide.
To initiate an APPC session with a named partner node and to run the APING transaction program to check network integrity and timing characteristics, use the ping sna privileged EXEC command.
ping sna [-1] [-c consecutive blocks] [-i number-iterations] [-m mode] [-n] [-r] [-s size] [-t tpname] [-u userid] destination
Syntax Description
-1 (Optional) Sends data from client to server only (no echo). -c consecutive blocks (Optional) Specifies the number of data blocks sent per iteration. -i number-iterations (Optional) Specifies number of iterations. -m mode (Optional) Specifies APPN mode to use. -n (Optional) Skips any security (SECURITY=NONE). -r (Optional) Shows route taken by APPC PING. -s size (Optional) Specifies the size of the of the data block to be transmitted. -t tpname (Optional) Specifies TP to start on the server. -u userid (Optional) Specifies USERID. -p password (Optional) Specifies the password associated with the userid specified after -u. Required when -u is specified. destination Specifies the fully qualified name of the partner logical unit or control point with which an APING transaction should be initiated.
Defaults
If -1 is not specified, ping sna will send the quantity of data represented by -s size, -i number-iterations, and -c consecutive blocks. It will be first sent in the direction from the ping sna requester to the receiver, then in the opposite direction.
If -c is not specified, consecutive data blocks per iteration defaults to 1.
If -i is not specified, number of iterations defaults to 2.
If -m is not specified, the mode defaults to #INTER
If -s is not specified, the size of each block of data transferred defaults to 100 bytes.
If -t is not specified, the default transaction program name on the receiver is APINGD.
Command Modes
Privileged EXEC
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
The ping sna command requires the destination to support the APING transaction program for the ping to succeed.
Examples
The following is an example of the ping sna command contact the destination NETA.CP001:
ping sna NETA.CP001
Related Commands
Displays SNASw session information.
Command
Description
To display the COS definitions predefined to SNASw, use the show snasw class-of-service command.
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.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw class-of-service command:
show snasw class-of-service
This command provides the following output:
Number of class of service definitions 7
SNA Classes of Service
Name Trans. Pri. Node Rows TG Rows
-------- ----------- --------- -------
1> #BATCH Low 8 8
2> #INTER High 8 8
3> CPSVCMG Network 8 8
4> #BATCHSC Low 8 8
5> #CONNECT Medium 8 8
6> #INTERSC High 8 8
7> SNASVCMG Network 8 8
r2612a52# show snasw class-of-service detail
Number of class of service definitions 7
1>
Class of service name #BATCH
Transmission priority Low
Number of node rows 8
Number of TG rows 8
1.1>Node row weight 5
Congestion min No
Congestion max No
Route additional resistance min 0
Route additional resistance max 31
Related Commands
Displays modes predefined to SNASw.
Command
Description
To display the connection networks (virtual nodes) currently known to SNASw, use the show snasw connection-network command.
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.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw connection-network command:
show snasw connection-network
This command provides the following output:
Connection network definitions 1
SNA Connection Networks
Resource Name Attached Ports Port Name(s)
----------------- -------------- --------------------------------
1> CISCO.VN 1 TR0
r3620a52# show snasw connection-network detail
Connection network definitions 1
1>
Connection network name CISCO.VN
Effective capacity 16 Mbps
Cost per connect time 0
Cost per byte 0
Propagation delay 384 microseconds
User defined parameter 1 128
User defined parameter 2 128
User defined parameter 3 128
Security Nonsecure
1.1>Port name TR0
Related Commands
Displays the SNASw link objects.
Command
Description
To display the SNASw directory entries, use the show snasw directory command.
show snasw directory [name resourcenamefilter] [brief | detail ]
Syntax Description
name resourcenamefilter (Optional) Indicates the fully qualified name of the resource 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.
(1 to 17 characters). Only resource names that match the specified name are displayed.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw directory command:
show snasw directory
This command provides the following output:
Total Directory Entries 2
SNA Directory Entries
Resource Name Owning CP Name NN Server Entry Type
----------------- ----------------- ----------------- ----------
1> CISCO.A CISCO.A CISCO.B Registry
2> CISCO.B CISCO.B CISCO.B Home
r2612a52# show snasw directory detail
Total Directory Entries 2
1>
Resource name CISCO.A
NN server name CISCO.B
Entry type Registry
Location Local to this domain
Resource owner's CP name CISCO.A
Apparent resource owner's CP name
Wildcard Explicit
2>
Resource name CISCO.B
NN server name CISCO.B
Entry type Home
Location Local to this node
Resource owner's CP name CISCO.B
Apparent resource owner's CP name
Wildcard Explicit
Related Commands
Configures the location of a resource.
Command
Description
To display the captured DLC trace information to the console, use the show snasw dlctrace command.
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.
Defaults
If id recordid is specified, next is the default parameter; if not, last is the default parameter.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw dlctrace command:
show snasw dlctrace id 2467 next 20
This command provides the following output:
DLC Trace Output 2467 LINKT In sz:43 HPR +Rsp IPM slctd nws:0007 2468 LINKT In sz:212 HPR +Rsp IPM slctd nws:0007 2469 LINKT In sz:52 HPR CP CAPABILITIES 2470 LINKT In sz:221 HPR CP CAPABILITIES 2471 LINKT Out sz:282 HPR MIS 2472 LINKT Out sz:43 HPR +Rsp IPM slctd nws:0007 2473 LINKT In sz:154 HPR Rq Bind CISCO.B CISCO.A 2474 LINKT In sz:323 HPR Rq Bind CISCO.B CISCO.A 2475 LINKT Out sz:361 HPR MIS 2476 LINKT Out sz:132 HPR +Rsp Bind 2477 LINKT In sz:102 HPR fmh5 CP CAPABILITIES 2478 LINKT In sz:271 HPR fmh5 CP CAPABILITIES 2479 LINKT Out sz:282 HPR MIS 2480 LINKT Out sz:43 HPR +Rsp IPM slctd nws:0007 2481 LINKT Out sz:291 HPR MIS 2482 LINKT Out sz:52 HPR CP CAPABILITIES 2483 LINKT In sz:43 HPR +Rsp IPM slctd nws:0007 2484 LINKT In sz:212 HPR +Rsp IPM slctd nws:0007 2485 LINKT Out sz:45 HPR 2486 LINKT In sz:45 HPR r3620a52# show snasw dlctrace detail DLC Trace Output 2486 LINKT In sz:45 HPR 10:08:36.14, 14 March 1993 0000 C60080FF 00000000 00010000 00000400 *F...............* 0010 0A000000 00000001 7E050E00 00000000 *........=.......* 0020 01000001 7E000000 00000000 00 *....=........ *
Related Commands
Traces frames arriving and leaving SNASw. Filters frames being captured.
Command
Description
To display the SNASw DLUS objects, use the show snasw dlus command.
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.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw dlus command:
show snasw dlus
This command provides the following output:
Number of Dependent LU Servers2
SNA Dependent LU Servers
DLUS Name Default? Backup? Pipe State PUs
----------------- -------- ------- ---------------- -------
1> NETA.SJMVS3 Yes No Active 1
2> NETA.SJMVS4 No Yes Inactive 0
dlur2# show snas dlus detail
Number of Dependent LU Servers2
1>
DLUS name NETA.SJMVS3
Is this the default DLUS Yes
Is this the backup default DLUS No
Pipe state Active
Number of active PUs 1
DLUS pipe statistics:
REQACTPUs sent 1
REQACTPU responses received 1
ACTPUs received 1
ACTPU responses sent 1
DACTPUs received 0
DACTPU responses sent 0
REQDACTPUs sent 0
REQDACTPU responses received 0
ACTLUs received 16
ACTLU responses sent 1
DACTLUs received 0
DACTLU responses sent 0
SSCP-PU MUs sent 0
SSCP-PU MUs received 0
SSCP-LU MUs sent 19
SSCP-LU MUs received 3
Related Commands
Specifies parameters related to DLUR/DLUS functionality.
Command
Description
To display the interprocess signal trace on the router console, use the show snasw ipstrace command.
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.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw ipstrace command:
show snasw ipstrace
This command provides the following output:
423452 : DLC_UI_MU : PC(2350000) -> DLC(2300000) Q 2
03/14/1993 10:11:36.18
00000000 00000000 61BB3F50 00800000 00000000 00000000 00000000 00000000
000000FF 000000FF 00000000 00000000 05010000 000000FF 50130000 002D00D2
02340000 03000000 00000000 61BB3FB0 00140050 0000017E 000100FF 00000000
00000000 01000000 00000000 00000000 0000017E 00000000 00000000 00000000
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
00000000 00000000 00000000 00000000 00C6C600 80FF0000 00000001 00000000
04000A00 00000000 00017E05 0E000000 01000100 00017E00 00000000 00000000
Related Commands
Sets up a trace buffer and begins tracing IPS trace elements Filters interprocess signal trace elements being traced using the snasw ipstrace or debug snasw ips commands.
Command
Description
To display the SNASw link objects, use the show snasw link command.
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 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 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.
(1 to 17 characters). Only links with CP names (as known to the router) that match the specified cpname are displayed.
(1 to 8 characters). All links associated with a port matching the filter are displayed.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw link command:
show snasw link
This command provides the following output:
Number of links 1
SNA Links HPR
Link Name State Port Name Adjacent CP Name Node Type Sess Sup
--------- ------- --------- ---------------- ------------ ---- ---
1> LINKT Active TR0 CISCO.B Network Node 0 Yes
r3620a52# show snasw link detail
Number of links 1
1>
Link name LINKT
Port name TR0
DLC type Token-ring
Destination DLC Address 000B.1AA4.9280.04
Link state Active
Link substate Active
Number of active sessions traversing link 0
Adjacent Node Id X'FFF00000'
Max send frame data (BTU) size 4400
Adjacent node CP name CISCO.B
Adjacent node type Network Node
CP-CP session support Yes
Link station role Secondary
Transmission group number 21
Limited resource No
Effective capacity 16 Mbps
Cost per connect time 0
Cost per byte 0
Propagation delay 384 microseconds
User defined parameter 1 128
User defined parameter 2 128
User defined parameter 3 128
Security Nonsecure
Routing Information Field
Primary DLUS Name
Backup DLUS Name
Downstream PU Name
Retry link station Yes
Dynamic link station No
Adjacent node is a migration node No
Link station statistics:
Total XID bytes sent 466
Total XID bytes received 344
Total XID frames sent 5
Total XID frames received 4
Total data bytes sent 752
Total data bytes received 685
Total data frames sent 8
Total data frames received 9
Total session control frames sent 0
Total session control frames received 0
Total number of successful XID exchanges 1
Total number of unsuccessful XID exchanges 0
Related Commands
Configures upstream links.
Command
Description
To display the SNASw dependent LUs, use the show snasw lu command.
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.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw lu command:
show snasw lu
This command provides the following output:
Number of DLUR LUs 1
SNA DLUR LUs
LU Name PU Name DLUS PLU Name
-------- -------- ----------------- -----------------
1> LL910101 PL9101 NETA.SJMVS3 NETA.ITPECHOS
dlur2# show snasw lu detail
Number of DLUR LUs 1
1>
LU name LL910101
PU name PL9101
DLUS name NETA.SJMVS3
Primary LU name NETA.ITPECHOS
LU location Downstream
Related Commands
Displays the SNASw PUs that require or request SSCP-PU services. Displays the SNASw DLUS objects.
Command
Description
To display modes predefined to SNASw, use the show snasw mode command.
show snasw modeSyntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw mode command:
show snasw mode
This command provides the following output:
Number of modes 8
SNA Modes
Name Associated COS
--------- --------------
1> #BATCH #BATCH
2> #INTER #INTER
3> CPSVCMG CPSVCMG
4> #CONNECT
5> #BATCHSC #BATCHSC
6> #INTERSC #INTERSC
7> CPSVRMGR SNASVCMG
8> SNASVCMG SNASVCMG
Related Commands
Displays the COS definitions predefined to SNASw.
Command
Description
To display details and statistics of the SNASw operation, use the show snasw node command.
show snasw nodeSyntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw node command:
show snasw node
This command provides the following output:
Node type Branch Network Node Node name CISCO.A CP alias CISCO Node ID X'FFF00000' Time active 12 mins, 57 secs Defined LS good XID exchanges 1 Defined LS bad XID exchanges 0 Dynamic LS good XID exchanges 0 Dynamic LS bad XID exchanges 0 Number of active ISR sessions 0 DLUR release level 1 Branch extender architecture version 1 Mode to COS mapping supported No MS includes Multiple Domain Support Yes MDS send alert queue size 10 Maximum locates 10000 Directory cache size 10000 Maximum directory entries (0 is unlimited) 0 Locate timeout in seconds (0 is no timeout) 0 COS cache size 8 Topology database routing tree cache size 8 Topology database routing tree cache use limit 1 Maximum nodes stored in database (0 unlimited) 0 Maximum TGs stored in database (0 unlimited) 0 Maximum allowed ISR sessions 22000 Maximum receive RU size for ISR sessions 61440 Maximum receive pacing window 7 Storing endpoint RSCVs for debug Yes Storing ISR RSCVs for debug No Storing DLUR RSCVs for debug No DLUR support Yes HPR support Yes
Related Commands
Displays the SNASw node-wide information.
Command
Description
To display entries in the cyclical problem determination log to the console, use the show snasw pdlog command.
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.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw pdlog command:
show snasw pdlog
This command provides the following output:
Problem Determination Log Output **** 00000014 - AUDIT 512:727 (0) **** CP-CP sessions established Adjacent CP name = CISCO.A 1015 compliant = 01 Topology awareness of CP-CP sessions support = 01 CP Capabilities : 000C12C1 00000000 82844000 >From ../dcl/nssrcctp.c 589 :at 0:10:24, 1 March 93
Related Commands
Controls message logging to the console and the SNA problem determination log cyclic buffer.
Command
Description
To display the SNASw port objects, use the show snasw port command.
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.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw port command:
show snasw port
This command provides the following output:
Number of ports 3
SNA Ports
Name State SAP HPR-SAP Interface
-------- -------- --- ------- ---------------------
1> ETH0 Active x04 xC8 Ethernet0/0
2> SER1 Active xC8 Serial0/0
3> TR0 Active x04 xC8 TokenRing0/0
r3620a52# show snasw port detail
Number of ports 3
1>
Port name ETH0
Interface name Ethernet0/0
DLC name ETH0
Port state Active
SAP X'04'
HPR SAP X'C8'
Port type Shared Access Transport Facility
Port number 0
Link station role Negotiable
Limited resource No
Max send frame data (BTU) size 1436
Maximum receive BTU size 1436
Effective capacity 16 Mbps
Cost per connect time 0
Cost per byte 0
Propagation delay 384 microseconds
User defined parameter 1 128
User defined parameter 2 128
User defined parameter 3 128
Security Nonsecure
Total available link stations 3000
Number reserved for inbound link stations 0
Number reserved for outbound link stations 0
HPR support No
HPR requires link level error recovery No
Retry link stations Yes
Maximum activation attempts 0
Implicit links are uplink to End Nodes No
Activation XID exchange limit 9
Non-activation XID exchange limit 5
Target pacing window size 7
Related Commands
Specifies the DLCs used by SNASw.
Command
Description
To display the SNASw PUs that require or request SSCP-PU services, use the show snasw pu command.
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 name punamefilter (Optional) Indicates the handle "naming" of the PU
(1 to 17 characters). Only PUs that are currently served by the DLUS specified are displayed.
(1 to 8 characters). Only links matching this name are displayed.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw pu command:
show snasw pu
This command provides the following output:
Number of DLUR PUs 1
SNA DLUR PUs
PU Name PU ID State Defined DLUS Current DLUS
-------- -------- -------- ----------------- -----------------
1> PL9101 19103001 Active NETA.SJMVS3
dlur2# show snasw pu detail
Number of DLUR PUs 1
1>
PU name PL9101
Define DLUS name
Backup DLUS name
Active DLUS name NETA.SJMVS3
PU ID (IDBLK/IDNUM) X'19103001'
PU location Downstream
PU status Active
DLUS session state Active
Automatic Network Shutdown support Stop
DLUS retry timeout (seconds) 0
DLUS retry limit 0
DLUS pipe PCID X'FC0B862E4B1CE8FB'
DLUS pipe CP Name NETA.DLUR2
Related Commands
Displays the SNASw DLUS objects.
Command
Description
To display the SNASw RTP connections, use the show snasw rtp command.
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 tcid tcidconnection (Optional) Shows the specific HPR RTP connection for the local TCID connections.
(1 to 8 characters). Only TG records origins or destinations that match the specified name or node records are displayed.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw rtp command:
show snasw rtp
This command provides the following output:
Number of RTP connections 1
SNA RTP Connections
Local TCID (hex) Remote TCID (hex) Remote CP Name COS
---------------- ----------------- ----------------- --------
1> 0000000001000000 0000000001000000 CISCO.B CPSVCMG
r3620a52# show snasw rtp detail
Number of RTP connections 1
1>
Local NCEID X'4052303030303031'
Local TCID X'0000000001000000'
Remote TCID X'0000000001000000'
Remote CP name CISCO.B
Class of service name CPSVCMG
Liveness timer 180
Short request timer 704
Number of short request timeouts 0
Total bytes sent 484
Total bytes received 484
Total bytes resent 0
Total bytes discarded 0
Total packets sent 24
Total packets received 25
Total packets resent 0
Total packets discarded 0
Total Session Connector frames sent 2
Total Session Connector frames received 2
Number of invalid SNA frames received 0
Number of gaps detected 0
Minimum send rate 1597
Current send rate 1597
Maximum send rate 1597
Minimum receive rate 0
Current receive rate 0
Maximum receive rate 0
Burst size 8192
Smoothed round trip delay time 352
Last round trip delay time 8
Number of active sessions 2
Link name of first hop LINKT
Performing ISR boundary function No
RTP connection type CP-CP session
RSCV Length 18
Route CISCO.A
<-tg21-> CISCO.B
Related Commands
Displays the SNASw session objects.
Command
Description
To display the SNASw session objects, use the show snasw session command.
show snasw session [local | dlur | intermediate] [name sessionnamefilter] [pcid pcidfilter] [brief | detail | intermediate]
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 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.
(1 to 17 characters). Only sessions that have a local or remote endpoint LU name matching the supplied name are displayed.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw session command:
show snasw session
This command provides the following output:
Number of local endpoint sessions 4
SNA Local Endpoint Sessions
PCID (hex) Partner LU Name Link Name Mode COS
---------------- ----------------- --------- -------- -------
1> F4276146FE1472AB CISCO.C @I000003 CPSVCMG CPSVCMG
2> F42754959A918058 CISCO.C @I000003 CPSVCMG CPSVCMG
3> F4276146FE1472AA CISCO.A @R000002 CPSVCMG CPSVCMG
4> F4276DF74485118B CISCO.A @R000002 CPSVCMG CPSVCMG
Number of intermediate sessions 2
SNA Intermediate Sessions
PCID (hex) Primary LU Name Secondary LU Name Mode COS
---------------- ----------------- ----------------- -------- -------
1> F42754959A918059 CISCO.C CISCO.A SNASVCMG SNASVCMG
2> F42754959A91805A CISCO.C CISCO.A #INTER #INTER
Number of intermediate DLUR sessions 0
SNA DLUR Assisted Intermediate Sessions
PCID (hex) Primary LU Name Secondary LU Name Mode COS
---------------- ----------------- ----------------- -------- -------
r2612a52# show snasw session detail
Number of local endpoint sessions 4
1>
Partner LU name CISCO.C
Mode name CPSVCMG
Class of service name CPSVCMG
Transmission priority Network
Carried over a limited resource No
Polarity Primary
Contention CONWINNER
SSCP ID received in ACTPU X'000000000000'
Session timeout period (ms) 0
Outbound LFSID (SIDH,SIDL,ODAI) X'02',X'00',B'0'
Procedure correlator ID (PCID) X'F4276146FE1472AB'
PCID generator CP name CISCO.B
FID2 Session ID X'F4276146FE1472AB'
Link name @I000003
Session statistics:
Maximum send RU size 1152
Maximum receive RU size 1152
Total data frames sent 3
Total data frames received 1
Total FMD data frames sent 3
Total FMD data frames received 1
Total bytes sent 511
Total bytes received 15
Max send pacing window 7
Max receive pacing window 7
Current send pacing window 7
Current receive pacing window 7
Related Commands
Displays SNASw link objects.
Command
Description
To display the SNASw node-wide information, use the show snasw statistics command.
show snasw statisticsSyntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw statistics command:
show snasw statistics
This command provides the following output:
SNASw Subsystem Uptime 3 hrs, 19 mins, 36 secs
Directory Statistics:
Maximum number of cache entries 10000
Current number of cache entries 0
Current number of home entries 2
Current number of registry entries 4
Total number of entries in directory 6
Total cache hits 0
Total cache misses 0
Number of directed locates sent 2
Number of directed locates returned not found 0
Number of directed locates received 0
Number of broadcast locates sent 0
Number of broadcast locates returned not found 0
Number of broadcast locates received 0
Number of locates outstanding 0
Toplogy Statistics:
Maximum number of nodes 0
Current number of nodes 4
Total number of received TDUs 0
Total number of sent TDUs 0
Total received TDUs with lower RSN 0
Total received TDUs with equal RSN 0
Total received TDUs with higher RSN 0
Total received TDUs with higher odd value RSN 0
Total node state changes requiring TDUs 0
Total database inconsistencies detected 0
Total number of timer based TDUs generated 0
Total number of node records purged 0
Total received TG updates with lower RSN 0
Total received TG updates with equal RSN 0
Total received TG updates with higher RSN 0
Total received TG updates with higher odd RSN 0
Total TG state changes requiring TG updates 5
Total TG database inconsistencies detected 0
Total number of timer TG updates generated 0
Total number of TG records purged 0
Total number of routes calculated 2
Total number of routes rejected 0
Total number of cache hits in route calculation 0
Total number of cache misses in rte calculation 7
Total number of TDU wars detected 0
Number of processes 23
CPU/Memory usage per SNA Switch process
Process Name CPU Time (ms) Memory Used (bytes)
----------------------------------- ------------- -------------------
1> NOF API 20 20
2> N-Base allocated memory 0 79484
3> Buffer Manager (BM) 12 232
4> Node Operator Facility (NOF) 152 13188
5> Address Space Manager (ASM) 28 1296
6> Address Space (AS) 24 0
7> Session Services (SS) 36 1676
8> Directory Services (DS) 92 550036
9> Configuration Services (CS) 48 9148
10> Management Services (MS) 4 252
11> Multiple Domain Support (MDS) 0 3792
12> Topology & Routing Services (TRS) 24 22368
13> Session Connector Manager (SCM) 12 2232
14> Session Connector (SCO) 0 1232
15> Session Manager (SM) 56 13416
16> Resource Manager (RM) 64 0
17> Presentation Services (PS) 68 0
18> Half Session (HS) 29 0
19> Path Control (PC) 188 50712
20> Data Link Control (DLC) 112 144
21> Dependent LU Requester (DR) 12 7032
22> High Performance Routing (HPR) 12 3632
23> Rapid Transport Protocol (RTP) 116 18460
Related Commands
Displays details and statistics of the SNASw operation.
Command
Description
To display the continuously running "footprint" summary interprocess signal trace on the router console, use the show snasw summary-ipstrace command.
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.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw summary-ipstrace command:
show snasw summary-ipstrace
This command provides the following output:
IPS Trace Output 433414 : VERB_SIGNAL : SCM(20E0000) -> TRS(20D0000) Q 1 433415 : VERB_SIGNAL : --(0) -> TRS(20D0000) Q 1 433416 : VERB_SIGNAL : TRS(20D0000) -> SS(2080000) Q 1 433417 : VERB_SIGNAL : --(0) -> SS(2080000) Q 1 433418 : VERB_SIGNAL : SS(2080000) -> CS(20A0000) Q 2 433419 : VERB_SIGNAL : --(0) -> CS(20A0000) Q 2 433420 : VERB_SIGNAL : CS(20A0000) -> --(2040000) Q 1 433421 : VERB_SIGNAL : --(0) -> --(2040000) Q 1 433422 : VERB_SIGNAL : --(0) -> NOF(2050000) Q 80 433423 : VERB_SIGNAL : --(0) -> NOF(2050000) Q 80 433424 : VERB_SIGNAL : NOF(2050000) -> DS(2090000) Q 1 433425 : VERB_SIGNAL : --(0) -> DS(2090000) Q 1 433426 : VERB_SIGNAL : DS(2090000) -> --(2040000) Q 1 433427 : VERB_SIGNAL : --(0) -> --(2040000) Q 1 433428 : VERB_SIGNAL : --(0) -> NOF(2050000) Q 80 433429 : VERB_SIGNAL : --(0) -> NOF(2050000) Q 80 433430 : VERB_SIGNAL : NOF(2050000) -> TRS(20D0000) Q 1 433431 : VERB_SIGNAL : --(0) -> TRS(20D0000) Q 1 433432 : VERB_SIGNAL : TRS(20D0000) -> --(2040000) Q 1 433433 : VERB_SIGNAL : --(0) -> --(2040000) Q 1
Related Commands
Copies problem determination logs and traces from internal buffers to an external file server.
Command
Description
To display the SNASw topology records, use the show snasw topology command.
show snasw topology [name cpnamefilter] [brief | detail]
Syntax Description
name cpnamefilter (Optional) Indicates the fully qualified name of the CP brief (Optional) Indicates one line per topology record is displayed. detail (Optional) Indicates a detailed, multiline display of topology information.
(1 to 17 characters). Only records that match the cpname specified are displayed.
Defaults
No default behaviors or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following is an example of the show snasw topology command:
show snasw topology
This command provides the following output:
Number of topology entries 3
SNA Topology Entries
Dest. Node Name Type TG# TG Type TG Status
----------------- ---- --- ---------------- ---------------------
1> CISCO.A EN 21 Downlink to BrNN CP-CP sessions active
2> CISCO.C EN 21 Downlink to BrNN CP-CP sessions active
3> CISCO.VN VRN 1 Neutral link Active
r2612a52# show snasw topology detail
Number of topology entries 3
1>
Destination node name CISCO.A
Destination node type End Node
Transmission Group Number 21
Destination address
Resource Sequence Number 6
TG status CP-CP sessions active
Active CP-CP sessions for this TG Yes
Is this a branch TG Yes
Branch link type Downlink to BrNN
Effective capacity 16 Mbps
Cost per connect time 0
Cost per byte 0
Propagation delay 384 microseconds
User defined parameter 1 128
User defined parameter 2 128
User defined parameter 3 128
Security Nonsecure
Related Commands
Displays SNASw link objects.
Command
Description
To define a control point name for SNASw, use the snasw cpname global configuration command. Use the no form of this command to deactivate SNASw and remove the control point definition.
snasw cpname netid.name | netid [hostname] [ip-address interface-name]
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.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
You can also deactivate SNASw without removing the snasw cpname definition using the snasw stop privileged EXEC command.
Coding of a cpname is required for SNASw. Only one snasw cpname command is allowed at a time. The snasw cpname command cannot be changed without first deleting the previous definition using the no form of the command. If SNASw is active, the no form deactivates it. If it is inactive, snasw cpname activates it.
Examples
The following are examples of how to configure the snasw cpname command:
snasw cpname NETA.BRANCH5 snasw cpname NETBANK2.DLUR0005 snasw cpname NETWORKA hostname snasw cpname NETA.CP ip-address Loopback0
Related Commands
Starts SNASw. Shuts down SNASw.
Command
Description
To filter frames being captured, use the snasw dlcfilter global configuration command. Use the no form of this command to disable the filtering of frames arriving and leaving SNASw.
snasw dlcfilter [link linkname [session session address]] [port portname] [rmac mac-address-value [session session address]] [rtp rtp-name] [type [cls] [hpr-cntl] [hpr-data] [isr] [xid]]
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.
Defaults
This command defaults to no filtering, and all frames are traced.
Command Modes
Global configuration
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
The snasw dlcfilter command is typically used to limit the output of the snasw dlctrace command to a manageable amount of trace data. Running the snasw dlctrace consumes CPU and memory. Using the snasw dlctrace command limits the CPU and memory consumption to only the frames that are targeted for tracing.
Up to four different types of filters can be in place at once. If multiple filters are coded for all filters except the type filter, the frame only has to pass a single filter to be included in the trace. If the type filter is coded, the frame must pass the type filter and at least one of the other filters that is coded to be included in the trace.
Examples
The following are examples of how to configure the snasw dlcfilter command:
snasw dlcfilter link cmc1link snasw dlcfilter rmac 4001.1234.1001 snasw dlcfilter type xid
Related Commands
Traces frames arriving and leaving SNASw. debug snasw dlc Displays real-time DLC trace data to the console. Copies problem determination logs and traces from internal buffers to an external file server.
Command
Description
To trace frames arriving and leaving SNASw, use the snasw dlctrace global configuration command. Use the no form of this command to deactivate the capture of frame data and free the storage buffer used to capture the data.
snasw dlctrace [buffer-size buffer-size-value] [file filename [timestamp]] [frame-size frame-size-value | auto-terse] [format | brief | detail | analyzer]
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.
Defaults
Tracing is off.
If a value for the buffer-size-value argument is not specified, then the default is 500, creating a 500 KB buffer.
Command Modes
Global configuration
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
Use the snasw dlctrace command when directed by service personnel or when analysis of frame data entering and leaving SNASw is necessary.
The snasw dlctrace command copies frames into a memory buffer, which can degrade router performance. Therefore, care should be taken when using this command. When issued on a highly used system, the snasw dlcfilter command should be used in conjunction with the snasw dlctrace command to limit the output of the trace.
Use the snasw dump command to dump the trace data to a file server or the show snasw dlctrace command to display captured frames on the console.
When using the analyzer format, portions of the frame are reconstructed from their actual representation on the data link. Because of this format, portions of the data in the header portion of the frame are modified. Specifically, if there was routing information field (RIF) data present on the actual data-link frame, that information is omitted in the dlctrace. In addition, information in the LLC header (for example, Nr, Ns counts) are not reliably transferred to the traced frame. However, the remainder of the frame, including all SNA content, is a reliable representation of the frame as it appeared on the actual upstream or downstream link.
Examples
The following are examples of how to configure the snasw dlctrace command:
snasw dlctrace snasw dlctrace buffer-size 5000 file tftp://171.69.120.21/dlcfiles/dlc/trc
Related Commands
Filters frames being captured. Copies problem determination logs and traces from internal buffers to an external file server. Displays the captured DLC trace information on the console.
Command
Description
To specify parameters related to DLUR/DLUS functionality, use the snasw dlus global configuration command. Use the no form of this command to remove the data specified in a previous snasw dlus command.
snasw dlus primary-dlus-name [backup backup-dlus-name] [prefer-active] [retry interval count]
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.
Defaults
If the prefer-active argument is not specified, each connected downstream station will attempt to connect to the primary DLUS or backup DLUS until the device receives DLUS services.
Command Modes
Global configuration
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
Only one snasw dlus command is allowed at a time. The snasw dlus command cannot be changed without first deleting the previous definition using the no form of the command. DLUS configuration is required if dependent LUs are to be supported by SNASw.
Examples
The following are examples of how to configure the snasw dlus command:
snasw dlus NETA.HOST1 backup NETA.HOST2 snasw dlus NETBANK2.CDERM34 prefer-active retry 30 3
Related Commands
Displays the SNASw DLUS objects.
Command
Description
To copy problem determination logs and traces from internal buffers to an external file server, use the snasw dump privileged EXEC command.
snasw dump all | dlctrace | ipstrace | summary-ipstrace | pdlog
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.
Defaults
No default behavior or values.
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
The snasw dump command is used for gathering trace files for diagnosis by Cisco personnel or onsite trace analysis.
Examples
The following are examples of how to configure the snasw dump command:
snasw dump all snasw dump dlctrace
Related Commands
Traces frames arriving and leaving SNASw. Sets up a trace buffer and begins tracing IPS trace elements. Controls message logging to the console and the SNA problem determination log cyclic buffer.
Command
Description
To indicate which normal events are logged to the console, use the snasw event global configuration command. Use the no form of this command to return the events to their default state.
snasw event [cpcp] [defined-ls] [dlc] [implicit-ls] [port]
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.
Defaults
The following events are sent to the pdlog/console:
Command Modes
Global configuration
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Examples
The following example shows how to configure the snasw event command:
snasw event defined-ls implicit-ls
To filter interprocess signal trace elements being traced via snasw ipstrace or debug snasw ips, use the snasw ipsfilter global configuration command. Use the no form of this command to remove all filtering.
snasw ipsfilter [as] [asm] [bm] [ch] [cpc] [cs] [di] [dlc] [dma] [dr] [ds] [es] [ha] [hpr] [hs] [lm] [mds] [ms] [nof] [pc] [ps] [pu] [px] [rm] [rtp] [ru] [scm] [sco] [sm] [spc] [ss] [trs]
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.
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
The command defaults to no IPS trace filtering.
Examples
The following is an example of how to configure the snasw ipsfilter command:
snasw ipsfilter ds ss
Related Commands
Sets up a trace buffer and begins tracing IPS trace elements. Displays the interprocess signal trace on the router console. debug snasw ips Displays realtime ipstrace information to the console.
Command
Description
To set up a trace buffer and begin tracing IPS trace elements, use the snasw ipstrace global configuration command. Use the no form of this command to turn off the capture of trace elements and to free the trace buffer.
snasw ipstrace [buffer-size buffer-size-value] [file filename timestamp]
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.
Defaults
This command defaults to no tracing with no cyclic buffer allocated.
Command Modes
Global configuration
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
Use the snasw ipstrace command when directed by SNASw personnel.
The snasw ipstrace command copies frames into a memory buffer, which can affect router performance. Therefore, care should be taken when using this command.
The ipstrace information is stored in a cyclic buffer allocated out of main processor memory. Use the snasw dump command to dump the binary trace information to a file server or the show snasw ipstrace command to display captured IPS trace information to the console. The IPS trace is a low-level internal trace.
Examples
The following is an example of how to configure the snasw ipstrace command:
snasw ipstrace buffer-size 1000 file tftp://myhost/path/file
Related Commands
Filters interprocess signal trace elements being traced via the snasw ipstrace or debug snasw ips commands. debug snasw ips Traces internal interprocess signal information within SNASw. Displays interprocess signal trace on the router console. debug snasw ips Displays realtime IPS trace information to the console.
Command
Description
To configure upstream links, use the snasw link global configuration command. Use the no form of this command to remove the configuration of upstream links.
snasw link linkname port portname rmac mac-address | ip-dest ip-address [rsap sap-value] [nns] [tgp high | low | medium | secure] [nostart]
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.
Defaults
The destination SAP value defaults to 4.
Command Modes
Global configuration
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
Use the snasw link command to configure upstream connections to SNA data hosts, services, and DLUS nodes. Do not use this command to connect to client workstations and devices serviced by the SNA switch. Client workstations and devices should be configured to connect into the SNA switch by configuring an outbound connection on these devices that specifies the MAC address of a port active on SNASw.
If using the ip-dest keyword and using a DNS name instead of a IP address, the DNS name is resolved to a IP address at the time the definition is entered (or the time SNASw is started) and will remain resolved to that same address for the duration that SNASw is active. The DNS name is not resolved to an IP address each time the link is restarted.
Examples
The following are examples of how to configure the snasw link command:
snasw link LINKCMC1 port TOKENO rmac 4000.333.4444 rsap 8 snasw link HOSTIP port HPRIP ip-dest 172.18.3.44
Related Commands
Shows the SNASw link objects.
Command
Description
To configure the location of a resource, use the snasw location global configuration command. Use the no form of this command to disable the location of a resource.
snasw location resource-name owning-cp cpname
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.
Defaults
No default behaviors or values.
Command Modes
Global configuration
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
The snasw location command is typically used when a LEN node link is established with a partner node. The snasw location command allows SNASw to route session requests over the LEN node link to the resources named.
The snasw location command should not be used to predefine the location of any resource that can be found dynamically using APPN searches (for example, resources on upstream APPN nodes or upstream/downstream ENs).
It is permissible to use the wildcard character "*" in location definitions to allow a definition to generate name associations for multiple devices. When using the wildcard character, the * symbol must be coded in both the resource-name and the cpname. If any real device attaches with a CP name that matches the non-wildcard portion of the owning-cp cpname specified, a location association will be made that replaces the wildcard characters of the CPname in the position of the resource-name. For example, if a definition "snasw location NETA.LU*01 owning-cp NETA.CP*" is coded and CP with the name NETA.CPABCD connects in, then the resource name NETA.LUABCD01 will be defined to SNASw with owning-cp NETA.CPABCD.
Examples
The following is an example of how to configure the snasw location command:
snasw location NETA.INDEPLU owning-cp NETA.LENHOSTA
Related Commands
Shows SNASw resource directory information.
Command
Description
To force an HPR pathswitch for an RTP connection, use the snasw pathswitch privileged EXEC command.
snasw pathswitch rtp-connection-name all
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.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
If a specific connection name is coded, and no such connection is known to SNASw, the snasw pathswitch command is ignored, and a message is issued. Use the snasw pathswitch command to force an HPR pathswitch for sessions that use this node as an RTP endpoint.
There is not a no form for this command.
Examples
The following is an example of how to configure the snasw pathswitch command:
snasw pathswitch @R000006
Related Commands
Displays the SNASw RTP connections.
Command
Description
To control message logging to the console and the SNA problem determination log cyclic buffer, use the snasw pdlog global configuration command. Use the no form of this command to remove previous pdlog configurations.
snasw pdlog [problem | exception | info] [buffer-size buffer-size-value] [file filename timestamp]
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.
Defaults
If not coded, the snasw pdlog command defaults to an active 500 KB cyclic buffer. Problems, exceptions, and informational messages are always sent to the buffer. By default, only problems go to the console.
Command Modes
Global configuration
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
Use the snasw pdlog command to customize the type of information you prefer to see on the router console from the SNASw feature.
Examples
The following is an example of how to configure the snasw pdlog command:
snasw pdlog exception buffer-size 200 file tftp://my host/files/trace.pdlog
Related Commands
Displays entries in the cyclical problem determination log to the console. Copies problem determination logs and traces from internal buffers to an external file server.
Command
Description
To specify the DLCs used by SNASw, use the snasw port global configuration command. Use the no form of this command to delete a previously configured port.
snasw port portname [hpr-ip | vdlc ring-group mac mac-address] interfacename [conntype nohpr | len | dyncplen] [nns-required] [hpr-sap hpr-sap-value] [max-links link-limit-value] [sap sap-value] [vnname virtual-node-name] [nns] [nostart]
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 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.
(3 to 17 characters) of the connection network being defined.
Defaults
No default behaviors or values.
Command Modes
Global configuration
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
More than one port can be configured (with different port names). A configured port cannot be redefined without first deleting the port using the no form of the port command.
 |
Note SNASw ports do not dynamically adjust to interface configuration changes that are made when SNASw is active. For example, if you change an interface MAC address or MTU, SNASw may not recognize the new value. If you want to make changes to an interface and want SNA Switch to adjust to the new interface changes, you may need to either delete and redefine the port that is using that interface or stop and restart SNASw. |
Examples
The following are examples of how to configure the snasw port command:
snasw port SRBG Virtual-TokenRing0 conntype nohpr snasw port UPSTREAM TokenRing1/1 snasw port dlswport vdlc 30 mac 4000.33333.4444 snasw port HPRIP hpr-ip Loopback0 snasw port TRVLAN Vlan1/1 vnname NETA.CONNET
Related Commands
Displays the SNASw link objects. Displays the SNASw port objects.
Command
Description
To start SNASw, use the snasw start privileged EXEC command.
snasw startSyntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
If not enough memory exists to start SNASw, a message indicating lack of memory is issued. A CP name must be configured with the snasw cpname command before SNASw will start.
Examples
The following is an example of the snasw start command:
snasw start
Related Commands
Displays the CoS definitions predefined to SNASw. Shuts down SNASw.
Command
Description
To initiate a request to start CP-CP sessions with a partner CP, use the snasw start cp-cp privileged EXEC command.
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.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
The functionality is necessary because it is possible for CP-CP sessions to fail permanently or temporarily, but beyond the timeframe for automatic CP-CP session retry. If the current state of the node mandates that CP-CP sessions cannot be started to the partner (for example, CP-CP sessions already exist on a different upstream link) or no active adjacent CP matches the cpname named, the command fails.
Examples
The following is an example of the snasw start cp-cp command:
snasw start cp-cp NETA.CMCHOST
Related Commands
Terminates CP-CP sessions with a partner CP.
Command
Description
To start an inactive defined link, use the snasw start link privileged EXEC command.
snasw start link linkname
Syntax Description
linkname Indicates the name of the link as configured or shown in show snasw link.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
Use the snasw start link command to initiate a connection sequence for a link that is defined but not currently active. Unless nostart is configured on the link definition, a link is started automatically. Use this command to start links that have nostart configured or links that have been stopped using the snasw stop link privileged EXEC command.
Examples
The following is an example of the snasw start link command:
snasw start link CMCHOST1
Related Commands
Displays the SNASw link objects. Stops an active link.
Command
Description
To start an inactive port, use the snasw start port privileged EXEC command.
snasw start port portname
Syntax Description
portname Indicates the name of the port as configured or shown in the show snasw port command.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
Use the snasw start port command to enable a port that is defined to the configuration but is not currently active. Unless nostart is configured on the port definition, a port is started automatically. Use this command to start ports that have nostart configured or ports that have been stopped using the snasw stop port privileged EXEC command.
Examples
The following is an example of the snasw start port command:
snasw start port TOKEN0
Related Commands
Displays the SNASw port objects. Stops an active port.
Command
Description
To shut down SNASw, use the snasw stop privileged EXEC command.
snasw stopSyntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
Use the snasw stop command to terminate all sessions, stop all ports and links, and shut down SNASw.
Examples
The following is an example of the snasw stop command:
snasw stop
Related Commands
Starts SNASw.
Command
Description
To terminate CP-CP sessions with a partner CP, use the snasw stop cp-cp privileged EXEC command.
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.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
Forcing a CP-CP session termination can be used to clear some fault scenarios such as hung or nonresponsive CP sessions, allowing the SNA switch to potentially restart sessions with the same or alternate partner node.
Examples
The following is an example of the snasw stop cp-cp command:
snasw stop cp-cp NETA.CMCHOST
Related Commands
Initiates a request to start CP-CP sessions with a partner CP.
Command
Description
To stop an active link, use the snasw stop link privileged EXEC command.
snasw stop link linkname
Syntax Description
linkname Indicates the name of the link as configured or shown in the show snasw link command.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
If connectivity to a specified partner CP is no longer desired, the link can be deactivated with this command. All non-HPR sessions established using this link are disconnected.
Examples
The following is an example of the snasw stop link command:
snasw stop link CMCHOST1
Related Commands
Displays the SNASw link objects.
Command
Description
To stop an active port, use the snasw stop port privileged EXEC command.
snasw stop port portname
Syntax Description
portname Indicates the name of the port as configured or shown in the show snasw port command.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
Use the snasw stop port command to disable a specified port without removing it from the configuration. All non-HPR sessions established using this port and all links are shut down on the port.
Examples
The following is an example of the snasw stop port command:
snasw stop port TOKEN0
Related Commands
Starts an inactive port.
Command
Description
To terminate a session that you do not want to remain active, use the snasw stop session privileged EXEC command.
snasw stop session pcid fqcpname netid-destination
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.
Defaults
No default behaviors or values.
Command Modes
Privileged EXEC
Command History
12.0(5)XN This command was introduced. 12.0(7)T This command was migrated to Cisco IOS Release 12.0 T.
Release
Modification
Usage Guidelines
The snasw stop session command is used to clear sessions that are active but in an indeterminate or hung state or if the session partner is not responsive.
Examples
The following is an example of the snasw stop session command:
snasw stop session C3BBD36EA9CBA1AF neta.mvsd
Related Commands
Displays the SNASw session objects.
Command
Description
Posted: Fri Mar 17 12:02:36 PST 2000
Copyright 1989 - 2000©Cisco Systems Inc.