Feedback
Table Of Contents
SNA Switching Services Commands
SNA Switching Services Commands
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.
ping sna
To initiate an APPC session with a named destination LU 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 packets] [-i number-iterations] [-m mode] [-n] [-r] [-s size] [-t tpname] [-u userid -p password] destination
Syntax Description
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 integrated into Cisco IOS Release 12.0 T.
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.CP001Related Commands
show snasw class-of-service
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
Defaults
The default display is brief.
Command History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0 T.
Examples
The following is a truncated example of the show snasw class-of-service command:
Router# show snasw class-of-serviceNumber of class of service definitions 7SNA Classes of ServiceName Trans. Pri. Node Rows TG Rows-------- ----------- --------- -------1> #BATCH Low 8 82> #INTER High 8 83> CPSVCMG Network 8 84> #BATCHSC Low 8 85> #CONNECT Medium 8 86> #INTERSC High 8 87> SNASVCMG Network 8 8Router# show snasw class-of-service detailNumber of class of service definitions 71>Class of service name #BATCHTransmission priority LowNumber of node rows 8Number of TG rows 81.1>Node row weight 5Congestion min NoCongestion max NoRoute additional resistance min 0Route additional resistance max 31Related Commands
show snasw connection-network
To display the connection networks (virtual nodes) defined to the local node, use the show snasw connection-network command.
show snasw connection-network [brief | detail]
Syntax Description
Defaults
The default display is brief.
Command History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0 T.
Examples
The following is an example of the show snasw connection-network command:
Router# show snasw connection-networkConnection network definitions 1SNA Connection NetworksResource Name Attached Ports Port Name(s)----------------- -------------- --------------------------------1> CISCO.VN 1 TR0Router# show snasw connection-network detailConnection network definitions 11>Connection network name CISCO.VNEffective capacity 16 MbpsCost per connect time 0Cost per byte 0Propagation delay 384 microsecondsUser defined parameter 1 128User defined parameter 2 128User defined parameter 3 128Security Nonsecure1.1>Port name TR0Related Commands
show snasw directory
To display the SNASw directory entries, use the show snasw directory command.
show snasw directory [name resourcenamefilter] [brief | detail ]
Syntax Description
Defaults
The default display is brief.
Command History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0 T.
Examples
The following is an example of the show snasw directory command:
Router# show snasw directoryTotal Directory Entries 2SNA Directory EntriesResource Name Owning CP Name NN Server Entry Type----------------- ----------------- ----------------- ----------1> CISCO.A CISCO.A CISCO.B Registry2> CISCO.B CISCO.B CISCO.B HomeRouter# show snasw directory detailTotal Directory Entries 21>Resource name CISCO.ANN server name CISCO.BEntry type RegistryLocation Local to this domainResource owner's CP name CISCO.AApparent resource owner's CP nameWildcard Explicit2>Resource name CISCO.BNN server name CISCO.BEntry type HomeLocation Local to this nodeResource owner's CP name CISCO.BApparent resource owner's CP nameWildcard ExplicitRelated Commands
show snasw dlctrace
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
Defaults
If id recordid is specified, next is the default parameter; if not, last is the default parameter.
The default display is brief.
Command History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0 T.
Examples
The following is an example of the show snasw dlctrace command:
Router# show snasw dlctrace id 2467 next 20DLC Trace Output2467 LINKT In sz:43 HPR +Rsp IPM slctd nws:00072468 LINKT In sz:212 HPR +Rsp IPM slctd nws:00072469 LINKT In sz:52 HPR CP CAPABILITIES2470 LINKT In sz:221 HPR CP CAPABILITIES2471 LINKT Out sz:282 HPR MIS2472 LINKT Out sz:43 HPR +Rsp IPM slctd nws:00072473 LINKT In sz:154 HPR Rq Bind CISCO.B CISCO.A2474 LINKT In sz:323 HPR Rq Bind CISCO.B CISCO.A2475 LINKT Out sz:361 HPR MIS2476 LINKT Out sz:132 HPR +Rsp Bind2477 LINKT In sz:102 HPR fmh5 CP CAPABILITIES2478 LINKT In sz:271 HPR fmh5 CP CAPABILITIES2479 LINKT Out sz:282 HPR MIS2480 LINKT Out sz:43 HPR +Rsp IPM slctd nws:00072481 LINKT Out sz:291 HPR MIS2482 LINKT Out sz:52 HPR CP CAPABILITIES2483 LINKT In sz:43 HPR +Rsp IPM slctd nws:00072484 LINKT In sz:212 HPR +Rsp IPM slctd nws:00072485 LINKT Out sz:45 HPR2486 LINKT In sz:45 HPRRouter# show snasw dlctrace id 2486 detailDLC Trace Output2486 LINKT In sz:45 HPR10:08:36.14, 14 March 19930000 C60080FF 00000000 00010000 00000400 *F...............*0010 0A000000 00000001 7E050E00 00000000 *........=.......*0020 01000001 7E000000 00000000 00 *....=........ *Related Commands
show snasw dlus
To display the SNASw DLUS objects, use the show snasw dlus command.
show snasw dlus [brief | detail]
Syntax Description
Defaults
The default display is brief.
Command History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0 T.
Examples
The following is an example of the show snasw dlus command:
Router# show snasw dlusNumber of Dependent LU Servers2SNA Dependent LU ServersDLUS Name Default? Backup? Pipe State PUs----------------- -------- ------- ---------------- -------1> NETA.SJMVS3 Yes No Active 12> NETA.SJMVS4 No Yes Inactive 0Router# show snas dlus detailNumber of Dependent LU Servers21>DLUS name NETA.SJMVS3Is this the default DLUS YesIs this the backup default DLUS NoPipe state ActiveNumber of active PUs 1DLUS pipe statistics:REQACTPUs sent 1REQACTPU responses received 1ACTPUs received 1ACTPU responses sent 1DACTPUs received 0DACTPU responses sent 0REQDACTPUs sent 0REQDACTPU responses received 0ACTLUs received 16ACTLU responses sent 1DACTLUs received 0DACTLU responses sent 0SSCP-PU MUs sent 0SSCP-PU MUs received 0SSCP-LU MUs sent 19SSCP-LU MUs received 3Related Commands
show snasw ipstrace
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
Defaults
No default behaviors or values.
Command History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0 T.
Examples
The following is an example of the show snasw ipstrace command:
Router# show snasw ipstrace423452 : DLC_UI_MU : PC(2350000) -> DLC(2300000) Q 203/14/1993 10:11:36.1800000000 00000000 61BB3F50 00800000 00000000 00000000 00000000 00000000000000FF 000000FF 00000000 00000000 05010000 000000FF 50130000 002D00D202340000 03000000 00000000 61BB3FB0 00140050 0000017E 000100FF 0000000000000000 01000000 00000000 00000000 0000017E 00000000 00000000 0000000000000000 00000000 00000000 00000000 00000000 00000000 00000000 0000000000000000 00000000 00000000 00000000 00000000 00000000 00000000 0000000000000000 00000000 00000000 00000000 00C6C600 80FF0000 00000001 0000000004000A00 00000000 00017E05 0E000000 01000100 00017E00 00000000 00000000Related 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.
show snasw link
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
Defaults
The default display is brief.
Command History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0 T.
Examples
The following is an example of the show snasw link command:
Router# show snasw linkNumber of links 1SNA Links HPRLink Name State Port Name Adjacent CP Name Node Type Sess Sup--------- ------- --------- ---------------- ------------ ---- ---1> LINKT Active TR0 CISCO.B Network Node 0 YesRouter# show snasw link detailNumber of links 11>Link name LINKTPort name TR0DLC type Token-ringDestination DLC Address 000B.1AA4.9280.04Link state ActiveLink substate ActiveNumber of active sessions traversing link 0Adjacent Node Id X'FFF00000'Max send frame data (BTU) size 4400Adjacent node CP name CISCO.BAdjacent node type Network NodeCP-CP session support YesLink station role SecondaryTransmission group number 21Limited resource NoEffective capacity 16 MbpsCost per connect time 0Cost per byte 0Propagation delay 384 microsecondsUser defined parameter 1 128User defined parameter 2 128User defined parameter 3 128Security NonsecureRouting Information FieldPrimary DLUS NameBackup DLUS NameDownstream PU NameRetry link station YesDynamic link station NoAdjacent node is a migration node NoLink station statistics:Total XID bytes sent 466Total XID bytes received 344Total XID frames sent 5Total XID frames received 4Total data bytes sent 752Total data bytes received 685Total data frames sent 8Total data frames received 9Total session control frames sent 0Total session control frames received 0Total number of successful XID exchanges 1Total number of unsuccessful XID exchanges 0Related Commands
show snasw lu
To display the SNA Switching Services (SNASw) dependent logical units (LU)s, use the show snasw lu command in user EXEC or privileged EXEC mode.
show snasw lu [brief | detail] [name lu-name] [pu pu-name]
Syntax Description
Defaults
The default display is brief.
Command Modes
User EXEC
Privileged EXECCommand History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0 T.
Examples
The following sample display is from the show snasw lu command:
Router# show snasw luNumber of DLUR LUs 49SNA DLUR LUsLU Name PU Name DLUS Name PLU Name-------- -------- ----------------- -----------------1> CWBC0601 CWBC06 NETA.MVSD2> CWBC0602 CWBC06 NETA.MVSDThe following is sample output from the show snasw lu detail command:
Router# show snasw lu detailNumber of DLUR LUs 491>LU name CWBC0601LU status ActiveSLU status No sessionPU name CWBC06DLUS name NETA.MVSDPrimary LU nameLU location DownstreamLU FSM history (00,00)->(01,01)->(02,0E)->(03,03)->04SLU FSM history (00,10)->00Table 3 describes the significant fields shown in the output.
Related Commands
show snasw dlus
Displays the SNASw DLUS objects.
show snasw pu
Displays the SNASw PUs that require or request SSCP-PU services.
show snasw mode
To display the SNASw modes, use the show snasw mode command.
show snasw mode
Syntax 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 integrated into Cisco IOS Release 12.0 T.
Examples
The following is an example of the show snasw mode command:
Router# show snasw modeNumber of modes 8SNA ModesName Associated COS--------- --------------1> #BATCH #BATCH2> #INTER #INTER3> CPSVCMG CPSVCMG4> #CONNECT5> #BATCHSC #BATCHSC6> #INTERSC #INTERSC7> CPSVRMGR SNASVCMG8> SNASVCMG SNASVCMGRelated Commands
show snasw node
To display details and statistics of the SNASw operation, use the show snasw node command.
show snasw node
Syntax Description
This command has no arguments or keywords.
Defaults
No default behaviors or values.
Command History
Examples
The following is an example of the show snasw node command:
Router# show snasw nodeNode type Branch Network NodeNode name NETA.NODECP alias NODENode ID X'FFF00000'Time active 9 days, 11 hrs, 57 mins, 13 secsDefined LS good XID exchanges 2Defined LS bad XID exchanges 0Dynamic LS good XID exchanges 243Dynamic LS bad XID exchanges 0Number of active ISR sessions 0DLUR release level 1Branch extender architecture version 1Mode to COS mapping supported NoMS includes Multiple Domain Support YesMDS send alert queue size 10Maximum locates 10000Directory cache size 10000Maximum directroy entries (0 is unlimited) 0Locate timeout in seconds (0 is no timeout) 540COS cache size 8Topology database routing tree cache size 8Topology database routing tree cache use limit 1Maximum nodes stored in database (0 unlimited) 0Maximum TGs stored in database (0 unlimited) 0Maximum allowed ISR sessions 22000Maximum receive RU size for ISR sessions 61440Maximum receive pacing window 7Storing endpoint RSCVs for debug YesStoring ISR RSCVs for debug NoStoring DLUR RSCVs for debug NoDLUR support YesHPR support YesRTP short request retry limit 6RTP path switch route attempts 6RTP path switch time LOW priority 480 secondsRTP path switch time MEDIUM priority 240 secondsRTP path switch time HIGH priority 120 secondsRTP path switch time NETWORK priority 60 secondsPD log capture level Problem level entriesPD log size 500 kilobytesPD log path disk0:IPS tracing InactiveDLC tracing ActiveDLC trace format DetailedDLC trace size 500 kilobytesDLC trace path tftp://10.102.16.25/tftp/node.dlctNumber of links 3Number of local endpoint sessions 4Number of non-DLUR intermediate sessions 0Number of DLUR intermediate sessions 0Number of DLUR PUs 0Number of DLUR LUs 0Related Commands
show snasw pdlog
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
Defaults
The default display is brief.
Command History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0 T.
Examples
The following is an example of the show snasw pdlog command:
Router# show snasw pdlogProblem Determination Log Output**** 00000014 - AUDIT 512:727 (0) ****CP-CP sessions establishedAdjacent CP name = CISCO.A1015 compliant = 01Topology awareness of CP-CP sessions support = 01CP Capabilities :000C12C1 00000000 82844000>From ../dcl/nssrcctp.c 589 :at 0:10:24, 1 March 93Related Commands
Controls message logging to the console and the SNA problem determination log cyclic buffer.
show snasw port
To display the SNASw port objects, use the show snasw port command.
show snasw port [brief | detail] [name portnamefilter]
Syntax Description
Defaults
The default display is brief.
Command History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0 T.
Examples
The following is an example of the show snasw port command:
Router# show snasw portNumber of ports 3SNA PortsName State SAP HPR-SAP Interface-------- -------- --- ------- ---------------------1> ETH0 Active x04 xC8 Ethernet0/02> SER1 Active xC8 Serial0/03> TR0 Active x04 xC8 TokenRing0/0Router# show snasw port detailNumber of ports 31>Port name ETH0Interface name Ethernet0/0DLC name ETH0Port state ActiveSAP X'04'HPR SAP X'C8'Port type Shared Access Transport FacilityPort number 0Link station role NegotiableLimited resource NoMax send frame data (BTU) size 1436Maximum receive BTU size 1436Effective capacity 16 MbpsCost per connect time 0Cost per byte 0Propagation delay 384 microsecondsUser defined parameter 1 128User defined parameter 2 128User defined parameter 3 128Security NonsecureTotal available link stations 3000Number reserved for inbound link stations 0Number reserved for outbound link stations 0HPR support NoHPR requires link level error recovery NoRetry link stations YesMaximum activation attempts 0Implicit links are uplink to End Nodes NoActivation XID exchange limit 9Non-activation XID exchange limit 5Target pacing window size 7Related Commands
show snasw pu
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
Defaults
The default display is brief.
Command History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0 T.
Examples
The following is an example of the show snasw pu command:
Router# show snasw puNumber of DLUR PUs 1SNA DLUR PUsPU Name PU ID State Defined DLUS Current DLUS-------- -------- -------- ----------------- -----------------1> PL9101 19103001 Active NETA.SJMVS3Router# show snasw pu detailNumber of DLUR PUs 11>PU name PL9101Define DLUS nameBackup DLUS nameActive DLUS name NETA.SJMVS3PU ID (IDBLK/IDNUM) X'19103001'PU location DownstreamPU status ActiveDLUS session state ActiveAutomatic Network Shutdown support StopDLUS retry timeout (seconds) 0DLUS retry limit 0DLUS pipe PCID X'FC0B862E4B1CE8FB'DLUS pipe CP Name NETA.DLUR2Related Commands
show snasw rtp
To display the SNASw RTP connections, use the show snasw rtp command.
show snasw rtp [brief | detail] [class-of-service cosname] [cpname netid.cpname] [name connectionnamefilter] [tcid tcidconnection]
Syntax Description
Defaults
The default display is brief.
Command History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0 T.
Examples
The following is an example of the show snasw rtp command:
Router# show snasw rtpNumber of RTP connections 1SNA RTP ConnectionsLocal TCID (hex) Remote TCID (hex) Remote CP Name COS---------------- ----------------- ----------------- --------1> 0000000001000000 0000000001000000 CISCO.B CPSVCMGRouter# show snasw rtp detailNumber of RTP connections 11>Local NCEID X'4052303030303031'Local TCID X'0000000001000000'Remote TCID X'0000000001000000'Remote CP name CISCO.BClass of service name CPSVCMGLiveness timer 180Short request timer 704Number of short request timeouts 0Total bytes sent 484Total bytes received 484Total bytes resent 0Total bytes discarded 0Total packets sent 24Total packets received 25Total packets resent 0Total packets discarded 0Total Session Connector frames sent 2Total Session Connector frames received 2Number of invalid SNA frames received 0Number of gaps detected 0Minimum send rate 1597Current send rate 1597Maximum send rate 1597Minimum receive rate 0Current receive rate 0Maximum receive rate 0Burst size 8192Smoothed round trip delay time 352Last round trip delay time 8Number of active sessions 2Link name of first hop LINKTPerforming ISR boundary function NoRTP connection type CP-CP sessionRSCV Length 18Route CISCO.A<-tg21-> CISCO.BRelated Commands
show snasw session
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
Defaults
The default display is brief.
Command History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0 T.
Examples
The following is an example of the show snasw session command:
Router# show snasw sessionNumber of local endpoint sessions 4SNA Local Endpoint SessionsPCID (hex) Partner LU Name Link Name Mode COS---------------- ----------------- --------- -------- -------1> F4276146FE1472AB CISCO.C @I000003 CPSVCMG CPSVCMG2> F42754959A918058 CISCO.C @I000003 CPSVCMG CPSVCMG3> F4276146FE1472AA CISCO.A @R000002 CPSVCMG CPSVCMG4> F4276DF74485118B CISCO.A @R000002 CPSVCMG CPSVCMGNumber of intermediate sessions 2SNA Intermediate SessionsPCID (hex) Primary LU Name Secondary LU Name Mode COS---------------- ----------------- ----------------- -------- -------1> F42754959A918059 CISCO.C CISCO.A SNASVCMG SNASVCMG2> F42754959A91805A CISCO.C CISCO.A #INTER #INTERNumber of intermediate DLUR sessions 0SNA DLUR Assisted Intermediate SessionsPCID (hex) Primary LU Name Secondary LU Name Mode COS---------------- ----------------- ----------------- -------- -------Router# show snasw session detailNumber of local endpoint sessions 41>Partner LU name CISCO.CMode name CPSVCMGClass of service name CPSVCMGTransmission priority NetworkCarried over a limited resource NoPolarity PrimaryContention CONWINNERSSCP ID received in ACTPU X'000000000000'Session timeout period (ms) 0Outbound LFSID (SIDH,SIDL,ODAI) X'02',X'00',B'0'Procedure correlator ID (PCID) X'F4276146FE1472AB'PCID generator CP name CISCO.BFID2 Session ID X'F4276146FE1472AB'Link name @I000003Session statistics:Maximum send RU size 1152Maximum receive RU size 1152Total data frames sent 3Total data frames received 1Total FMD data frames sent 3Total FMD data frames received 1Total bytes sent 511Total bytes received 15Max send pacing window 7Max receive pacing window 7Current send pacing window 7Current receive pacing window 7Related Commands
show snasw statistics
To display the SNASw node-wide information, use the show snasw statistics command.
show snasw statistics
Syntax 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 integrated into Cisco IOS Release 12.0 T.
Examples
The following is an example of the show snasw statistics command:
Router# show snasw statisticsSNASw Subsystem Uptime 3 hrs, 19 mins, 36 secsDirectory Statistics:Maximum number of cache entries 10000Current number of cache entries 0Current number of home entries 2Current number of registry entries 4Total number of entries in directory 6Total cache hits 0Total cache misses 0Number of directed locates sent 2Number of directed locates returned not found 0Number of directed locates received 0Number of broadcast locates sent 0Number of broadcast locates returned not found 0Number of broadcast locates received 0Number of locates outstanding 0Topology Statistics:Maximum number of nodes 0Current number of nodes 4Total number of received TDUs 0Total number of sent TDUs 0Total received TDUs with lower RSN 0Total received TDUs with equal RSN 0Total received TDUs with higher RSN 0Total received TDUs with higher odd value RSN 0Total node state changes requiring TDUs 0Total database inconsistencies detected 0Total number of timer based TDUs generated 0Total number of node records purged 0Total received TG updates with lower RSN 0Total received TG updates with equal RSN 0Total received TG updates with higher RSN 0Total received TG updates with higher odd RSN 0Total TG state changes requiring TG updates 5Total TG database inconsistencies detected 0Total number of timer TG updates generated 0Total number of TG records purged 0Total number of routes calculated 2Total number of routes rejected 0Total number of cache hits in route calculation 0Total number of cache misses in rte calculation 7Total number of TDU wars detected 0Number of processes 23CPU/Memory usage per SNA Switch processProcess Name CPU Time (ms) Memory Used (bytes)----------------------------------- ------------- -------------------1> NOF API 20 202> N-Base allocated memory 0 794843> Buffer Manager (BM) 12 2324> Node Operator Facility (NOF) 152 131885> Address Space Manager (ASM) 28 12966> Address Space (AS) 24 07> Session Services (SS) 36 16768> Directory Services (DS) 92 5500369> Configuration Services (CS) 48 914810> Management Services (MS) 4 25211> Multiple Domain Support (MDS) 0 379212> Topology & Routing Services (TRS) 24 2236813> Session Connector Manager (SCM) 12 223214> Session Connector (SCO) 0 123215> Session Manager (SM) 56 1341616> Resource Manager (RM) 64 017> Presentation Services (PS) 68 018> Half Session (HS) 29 019> Path Control (PC) 188 5071220> Data Link Control (DLC) 112 14421> Dependent LU Requester (DR) 12 703222> High Performance Routing (HPR) 12 363223> Rapid Transport Protocol (RTP) 116 18460Related Commands
show snasw summary-ipstrace
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
Defaults
No default behaviors or values.
Command History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0 T.
Examples
The following is an example of the show snasw summary-ipstrace command:
Router# show snasw summary-ipstraceIPS Trace Output433414 : VERB_SIGNAL : SCM(20E0000) -> TRS(20D0000) Q 1433415 : VERB_SIGNAL : --(0) -> TRS(20D0000) Q 1433416 : VERB_SIGNAL : TRS(20D0000) -> SS(2080000) Q 1433417 : VERB_SIGNAL : --(0) -> SS(2080000) Q 1433418 : VERB_SIGNAL : SS(2080000) -> CS(20A0000) Q 2433419 : VERB_SIGNAL : --(0) -> CS(20A0000) Q 2433420 : VERB_SIGNAL : CS(20A0000) -> --(2040000) Q 1433421 : VERB_SIGNAL : --(0) -> --(2040000) Q 1433422 : VERB_SIGNAL : --(0) -> NOF(2050000) Q 80433423 : VERB_SIGNAL : --(0) -> NOF(2050000) Q 80433424 : VERB_SIGNAL : NOF(2050000) -> DS(2090000) Q 1433425 : VERB_SIGNAL : --(0) -> DS(2090000) Q 1433426 : VERB_SIGNAL : DS(2090000) -> --(2040000) Q 1433427 : VERB_SIGNAL : --(0) -> --(2040000) Q 1433428 : VERB_SIGNAL : --(0) -> NOF(2050000) Q 80433429 : VERB_SIGNAL : --(0) -> NOF(2050000) Q 80433430 : VERB_SIGNAL : NOF(2050000) -> TRS(20D0000) Q 1433431 : VERB_SIGNAL : --(0) -> TRS(20D0000) Q 1433432 : VERB_SIGNAL : TRS(20D0000) -> --(2040000) Q 1433433 : VERB_SIGNAL : --(0) -> --(2040000) Q 1Related Commands
Copies problem determination logs and traces from internal buffers to an external file server.
show snasw topology
To display the SNASw topology records, use the show snasw topology command.
show snasw topology [name cpnamefilter] [brief | detail]
Syntax Description
Defaults
The default display is brief.
Command History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0 T.
Examples
The following is an example of the show snasw topology command:
Router# show snasw topologyNumber of topology entries 2SNA Topology EntriesDest. Node Name Type TG# TG Type TG Status----------------- ---- --- ---------------- ---------------------1> NETA.MVSD Intr 21 Uplink CP-CP sessions active2> NETA.BERNIEPU Enpt 0 Downlink ActiveThe following is an example of the show snasw topology detail command:
bernie# show snasw topo detailNumber of topology entries 21>Destination node name NETA.MVSDDestination node type IntermediateTransmission Group Number 21Destination addressResource Sequence Number 0TG status CP-CP sessions activeActive CP-CP sessions for this TG YesIs this a branch TG NoBranch link type UplinkEffective capacity 16 MbpsCost per connect time 196Cost per byte 196Propagation delay 384 microsecondsUser defined parameter 1 128User defined parameter 2 128User defined parameter 3 128Security Nonsecure2>Destination node name NETA.BERNIEPUDestination node type EndpointTransmission Group Number 0Destination addressResource Sequence Number 0TG status ActiveActive CP-CP sessions for this TG NoIs this a branch TG NoBranch link type DownlinkEffective capacity 16 MbpsCost per connect time 196Cost per byte 196Propagation delay 384 microsecondsUser defined parameter 1 128User defined parameter 2 128User defined parameter 3 128Security NonsecureRelated Commands
snasw cpname
To define a control point (CP) name for SNASw, use the snasw cpname command in global configuration mode. To deactivate SNASw and remove the CP definition, use the no form of this command.
snasw cpname {netid.cpname | netid [hostname | ip-address interface-name]} [hung-pu-awareness timer-value] [hung-session-awareness timer-value] [locate-timeout timeout-value] [max-pacing-window max-value] [remove-rscvs] [station-segmentation]
no snasw cpname
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
Usage Guidelines
You can also deactivate SNASw without removing the snasw cpname definition by using the snasw stop privileged EXEC command which enables you to stop and restart SNASw without losing the SNASw configuration. If you use no snasw cpname, all SNASw configuration commands that were entered will be lost.
Coding a CP name is required for SNASw. Only one snasw cpname command is allowed at a time. You cannot change the snasw cpname command without first deleting the previous definition by using the no form of the command. If SNASw is active, the no form deactivates it. If SNASw is inactive, using snasw cpname activates it.
Examples
The following are examples of how to configure the snasw cpname command:
snasw cpname NETA.BRANCH5snasw cpname NETBANK2.DLUR0005snasw cpname NETWORKA hostnamesnasw cpname NETA.CP ip-address Loopback0snasw dlcfilter
To filter frames being captured, use the snasw dlcfilter global configuration command. To disable the filtering of frames arriving and leaving SNASw, use the no form of this command.
snasw dlcfilter [link linkname [session session-address]] [port portname] [rmac mac-address-value [session session-address]] [rtp rtp-name [session session-address]] [type [cls] [hpr-cntl] [hpr-data] [isr] [xid]]
no snasw dlcfilter
Syntax Description
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 integrated into Cisco IOS Release 12.0 T.
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 cmc1linksnasw dlcfilter rmac 4001.1234.1001snasw dlcfilter type xidRelated Commands
snasw dlctrace
To trace frames arriving and leaving SNASw, use the snasw dlctrace global configuration command. To deactivate the capture of frame data and free the storage buffer used to capture the data, use the no form of this command.
snasw dlctrace [buffer-size buffer-size-value] [file filename [timestamp]] [frame-size frame-size-value | auto-terse] [format [brief | detail | analyzer]] [nostart]
no snasw dlctrace
Syntax Description
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 integrated into Cisco IOS Release 12.0 T.
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 dlctracesnasw dlctrace buffer-size 5000 file tftp://171.69.120.21/dlcfiles/dlc/trcRelated Commands
snasw dlus
To specify parameters related to DLUR/DLUS functionality, use the snasw dlus global configuration command. To remove the data specified in a previous snasw dlus command, use the no form of this command.
snasw dlus primary-dlus-name [backup backup-dlus-name] [prefer-active] [retry interval count] [once]
no snasw dlus
Syntax Description
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 integrated into Cisco IOS Release 12.0 T.
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.
The prefer-active keyword supersedes the once keyword, which means that if the prefer-active keyword is configured and there is an active DLUS, then all DLUS services requests will be negotiated only with the active DLUS. The DLUR will not send DLUS service requests to other DLUSs. In this situation, the once keyword has no effect.
Examples
The following are examples of how to configure the snasw dlus command:
snasw dlus NETA.HOST1 backup NETA.HOST2snasw dlus NETBANK2.CDERM34 prefer-active retry 30 3Related Commands
snasw dump
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
Defaults
No default behavior or values.
Command History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0 T.
Usage Guidelines
The snasw dump command is used for gathering trace files for diagnosis by Cisco personnel or onsite trace analysis.
TFTP can handle files up to 16 Mb. If you are transferring a file larger than 16 Mb, do not use TFTP. Instead, use FTP or some other file transfer method. To change the transmission protocol, use the file keyword under the snasw trace configuration (for example, snasw dlctrace).
When you use FTP, make sure you configure ip ftp username and ip ftp password to a valid user and password on the system to which the file is being sent.
Examples
The following are examples of how to enter the snasw dump command:
snasw dump allsnasw dump dlctraceRelated Commands
snasw event
To indicate which normal events are logged to the console, use the snasw event global configuration command. To return the events to their default state, use the no form of this command.
snasw event [cpcp] [dlc] [implicit-ls] [port]
no snasw event
Syntax Description
Defaults
By default, only defined links and DLUS 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 integrated into Cisco IOS Release 12.0 T.
12.1(6)
The defined-ls keyword was deleted.
Examples
The following example shows how to configure the snasw event command:
snasw event implicit-lssnasw ip-precedence
To define IP type of service (TOS) precedence settings to be mapped to APPN priorities, use the snasw ip-precedence global configuration command. To remove the precedence settings, use the no form of this command.
snasw ip-precedence link link-setting network network-setting high high-setting medium medium-setting low low-setting
no snasw ip-precedence link link-setting network network-setting high high-setting medium medium-setting low low-setting
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
Examples
The following is an example of how to configure the snasw ip-precedence command:
snasw ip-precedence link 7 network 7 high 7 medium 7 low 7snasw ipsfilter
To filter interprocess signal trace elements being traced using the snasw ipstrace or debug snasw ips commands, use the snasw ipsfilter global configuration command. To remove all filtering, use the no form of this command.
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]
no snasw ipsfilter
Syntax Description
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 integrated into Cisco IOS Release 12.0 T.
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 ssRelated Commands
snasw ipstrace
To set up a trace buffer and begin tracing IPS trace elements, use the snasw ipstrace global configuration command. To turn off the capture of trace elements and to free the trace buffer, use the no form of this command.
snasw ipstrace [buffer-size buffer-size-value] [file filename timestamp]
no snasw ipstrace
Syntax Description
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 integrated into Cisco IOS Release 12.0 T.
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/fileRelated Commands
snasw link
To configure upstream links, use the snasw link global configuration command. To remove the configuration of upstream links, use the no form of this command.
snasw link linkname port portname rmac mac-address | ip-dest ip-address [rsap sap-value] [nns] [tgp [high | low | medium | secure]] [nostart]
no snasw link linkname
Syntax Description
Defaults
The destination SAP value defaults to 4.
The default TG characteristic profile is medium and non-secure.
Command Modes
Global configuration
Command History
12.0(5)XN
This command was introduced.
12.0(7)T
This command was integrated into Cisco IOS Release 12.0T.
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 establish downstream connections to client workstations and devices that are serviced by the SNA switch. Configure client workstations and devices to connect into the SNA switch by configuring an outbound connection on these devices that specifies the MAC address of a port that is active on SNASw. SNASw then creates the downstream link dynamically when the workstation or device connects to SNASw.
If using the ip-dest keyword and using a DNS name instead of an IP address, the DNS name is resolved to an 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.
If the link fails and SNASw switches to a non-preferred NNS (one without the nns keyword configured), SNASw will return CP-CP sessions to the preferred NNS when the NNS link becomes active again. Also, when the nns keyword is configured on a link, that link can be automatically restarted, even after the snasw stop link command is issued. See the snasw stop link command for details.
Examples
The following are examples of how to configure the snasw link command:
snasw link LINKCMC1 port TOKENO rmac 4000.333.4444 rsap 8snasw link HOSTIP port HPRIP ip-dest 172.18.3.44Related Commands
snasw location
To configure the location of a resource, use the snasw location global configuration command. To disable the location of a resource, use the no form of this command.
snasw location resource-name owning-cp cpname
no snasw location resource-name
Syntax Description
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 integrated into Cisco IOS Release 12.0 T.
12.2
Support for wildcards in the cpname argument was added.
Usage Guidelines
The snasw location command is typically used when a LEN node link is established with a destination LU. The snasw location command allows SNASw to route session requests over the LEN node link to the resources named.
When a LEN node connects into an SNASw node, SNASw dynamically learns the CP name of the LEN and places it in its directory. In addition, SNASw dynamically learns the LU names of all LUs on the LEN that initiate independent sessions. Only define the location when an ILU on a LEN device is not sharing the node's CP name and does not initiate the first session. In all other cases the LU's location will be learned dynamically.
The directory entry is created the next time the LEN node connects in. If there is already a link to the LEN node active and you add a new snasw location statement, it will not take effect until the next time the LEN CP connects in.
Do not use the snasw location command 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 for this purpose, 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.
You can also use the wildcard character "*" in location definitions to allow a specific device to connect under different CP names, but a single device cannot connect under multiple CP names at the same time. In this case, the * symbol must be used in only the cpname argument and not the resource-name argument. When the device connects with a CP name that matches the non-wildcard portion of the cpname argument, a corresponding location association will be made for the resource-name with that CP name.
Examples
The following is an example of how to configure the snasw location command:
snasw location NETA.INDEPLU owning-cp NETA.LENHOSTARelated Commands
snasw mode
To define a new mode and associate it with an existing class of service (COS), use the snasw mode global configuration command. To delete the mode, use the no form of this command.
snasw mode mode cos cos
no snasw mode mode cos cos
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
Examples
The following is an example of how to configure the snasw mode command:
snasw mode abcmode cos #INTERsnasw msgdump
To enable automatic dumping of the DLC trace, IPS trace, and problem determination log when a specified SNA Switching Services (SNASw) message is displayed, use the snasw msgdump global configuration command. To disable automatic dumping, use the no form of this command.
snasw msgdump message
no snasw msgdump message
Syntax Description
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
Examples
The following are examples of the snasw msgdump command:
snasw msgdump %SNASW-6-CS_LOG_60snasw pathswitch
To force an HPR pathswitch for an RTP connection, use the snasw pathswitch privileged EXEC command.
snasw pathswitch [rtp-connection-name | all]
Syntax Description
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 integrated into Cisco IOS Release 12.0 T.
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.
Use the snasw pathswitch command if you want to force a switch back to a primary route when it recovers, and the session seems to be hung.
There is not a no form for this command.
Examples
The following is an example of how to execute the snasw pathswitch command:
snasw pathswitch @R000006Related Commands
snasw pdlog
To control message logging to the console and the SNA problem determination log cyclic buffer, use the snasw pdlog global configuration command. To remove previous pdlog configurations, use the no form of this command.
snasw pdlog [problem | exception | info] [buffer-size buffer-size-value] [file filename timestamp]
no snasw pdlog
Syntax Description
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 integrated into Cisco IOS Release 12.0 T.
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.pdlogRelated 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.
snasw port
To specify the Data-link controls (DLCs) used by SNA Switching Services (SNASw), use the snasw port command in global configuration mode. To delete a previously configured port, use the no form of this command.
HPR-IP Ports
snasw port port-name hpr-ip interface-name [ldlc [liveness-time t1-retry-time t1-retry-count]] [maxbtu max-btu-size] [vnname virtual-node-name] [nostart]
no snasw port port-name
VDLC and Virtual Token Ring Ports
snasw port port-name {vdlc ring-group mac mac-address | virtual-TokenRing-interface-name} [conntype nohpr | len | dyncplen] [hpr-sap hpr-sap-value] [max-links link-limit-value] [maxbtu max-btu-size] [nns-required] [sap sap-value] [vnname virtual-node-name] [nostart]
no snasw port port-name
All Other Types of Ports
snasw port port-name interface-name [conntype nohpr | len | dyncplen] [nns-required] [hpr-sap hpr-sap-value] [max-links link-limit-value] [maxbtu max-btu-size] [sap sap-value] [vnname virtual-node-name] [nostart]
no snasw port port-name
Syntax Description
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 integrated into Cisco IOS Release 12.0 T.
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
Two ports cannot be defined on the same interface unless different values are configured for the `sap' and `hrp-sap' keywords on the ports.
Note
The interface must be defined before the ports that use them are defined and activated.
SNASw does not support EtherChannel interfaces (neither port-channel interfaces nor Fast Ethernet interfaces configured with the channel-group command). Do not try to configure a SNASw port with either of these EtherChannel interface types.Examples
The following are examples of how to configure the snasw port command:
snasw port SRBG Virtual-TokenRing0 conntype nohprsnasw port UPSTREAM TokenRing1/1snasw port dlswport vdlc 30 mac 4000.33333.4444snasw port HPRIP hpr-ip Loopback0snasw port TRVLAN Vlan1/1 vnname NETA.CONNETRelated Commands
snasw rtp pathswitch-timers
To tune the Realtime Transport Protocol (RTP) path-switch timers for an SNASwitch, use the snasw rtp pathswitch-timers command in global configuration mode. To restore the default settings for the RTP path-switch timers, use the no form of this command.
snasw rtp pathswitch-timers low-priority medium-priority high-priority network-priority
no snasw rtp pathswitch-timers
Syntax Description
Defaults
low-priority: 480 seconds
medium-priority: 240 seconds
high-priority: 120 seconds
network-priority: 60 secondsCommand Modes
Global configuration
Command History
Usage Guidelines
The arguments for this command should be tuned to match the values specified at the other end of the RTP connection. This endpoint could be another SNASwitch router or any other HPR-capable control point, which will most often be an IBM z/OStm mainframe. In this case, you should match the settings of the HPRPST start option.
The value for each path-switch timer argument must be greater than or equal to the value for the next highest priority timer argument. In other words, the low-priority argument >= medium-priority argument >= high-priority argument >= network-priority argument.
Examples
The following example tunes the RTP path-switch timers:
router(config)# snasw rtp pathswitch-timers 160 80 40 20snasw start
To start SNASw, use the snasw start privileged EXEC command.
snasw start
Syntax 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 integrated into Cisco IOS Release 12.0 T.
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 startRelated Commands
snasw start cp-cp
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 integrated into Cisco IOS Release 12.0 T.
Usage Guidelines
Use the snasw start cp-cp command if CP-CP sessions 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.
Typically, SNASw automatically activates CP-CP sessions as necessary and the snasw start cp-cp command is rarely needed. Frequent CP-CP session failure beyond the timeframe for automatic session retry indicates a problem, and should be reported.
Examples
The following is an example of the snasw start cp-cp command:
snasw start cp-cp NETA.CMCHOSTRelated Commands
snasw start link
To start an inactive defined link, use the snasw start link privileged EXEC command.
snasw start link linkname
Syntax Description
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 integrated into Cisco IOS Release 12.0 T.
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 CMCHOST1Related Commands
snasw start port
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 integrated into Cisco IOS Release 12.0 T.
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 TOKEN0Related Commands
snasw stop
To shut down SNASw, use the snasw stop privileged EXEC command.
snasw stop
Syntax 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 integrated into Cisco IOS Release 12.0 T.
Usage Guidelines
Use the snasw stop command to terminate all sessions, stop all ports and links, and shut down SNASw. When you enter this command, you are prompted for confirmation.
Examples
The following is an example of the snasw stop command:
snasw stopRelated Commands
snasw stop cp-cp
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 integrated into Cisco IOS Release 12.0 T.
Usage Guidelines
If the primary NN server (uplink) fails, CP-CP sessions are established with a backup, if one is available. When the link to the primary recovers, SNASw retains the CP-CP sessions established with the backup and does not automatically switch back to the primary. To force SNASw to switch back to the primary, use the snasw stop cp-cp command. (If the link to the backup fails, SNASw does switch back to the primary automatically.)
You can also use the snasw stop cp-cp command 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 destination LU.
Examples
The following is an example of the snasw stop cp-cp command:
snasw stop cp-cp NETA.CMCHOSTRelated Commands
snasw stop link
To stop an active link, use the snasw stop link privileged EXEC command.
snasw stop link linkname
Syntax Description
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 integrated into Cisco IOS Release 12.0 T.
Usage Guidelines
Use the snasw stop link command to deactivate a link to a specified partner CP. All non-HPR sessions established using the link are disconnected. HPR sessions are disrupted only if there is no alternate route available.
Normally a link stopped with the snasw stop link command must be restarted by issuing the snasw start link command. However, it will be automatically restarted under the following conditions:
•
•
Examples
The following is an example of the snasw stop link command:
snasw stop link CMCHOST1Related Commands
snasw stop port
To stop an active port, use the snasw stop port privileged EXEC command.
snasw stop port portname
Syntax Description
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 integrated into Cisco IOS Release 12.0 T.
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 the port and all links are shut down on the port. HPR sessions are disrupted only if there is no alternate route available.
Examples
The following is an example of the snasw stop port command:
snasw stop port TOKEN0Related Commands
snasw stop session
To terminate an active session, use the snasw stop session privileged EXEC command.
snasw stop session pcid
Syntax Description
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 integrated into Cisco IOS Release 12.0 T.
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.
You can also use the snasw stop session command to free a small amount of memory if the session is no longer being used to transport data and you don't expect to use the session later.
Examples
The following is an example of the snasw stop session command:
snasw stop session C3BBD36EA9CBA1AFRelated Commands
