-
Cisco IOS Bridging and IBM Networking Command Reference, Volume 2 of 2: IBM Networking, Release 12.3
-
IBM Networking Commands: A through B
-
IBM Networking Commands: C through D
-
IBM Networking Commands: D
-
IBM Networking Commands: E through O
-
IBM Networking Commands: P through S
-
IBM Networking Commands: S
-
IBM Networking Commands: show ext through show ext
-
IBM Networking Commands: show fra through show txc
-
IBM Networking Commands: S through X
-
Table Of Contents
show dlsw transparent neighbor
sec-profile
To specify a security profile to be associated with a listen point, use the sec-profile command in TN3270 listen-point configuration mode. To remove this specification, use the no form of this command.
sec-profile profilename
no sec-profile profilename
Syntax Description
Defaults
No default behavior or values
Command Modes
TN3270 listen-point configuration
Command History
Usage Guidelines
If this command is not entered or if the no form of the command is entered, the security profile reverts to the profile configured in the default-profile command. If no default profile is specified, the listen point accepts only nonsecure connections
This command has no retroactive effect.
Examples
The following example specifies LAM as the security profile name for all new clients connecting to listen point 10.10.10.1 until the sec-profile LAM1 command is configured. Once the sec-profile LAM1 command is configured, all new client connections to 10.10.10.1 will use LAM1 as the profile name.
tn3270-serversecurityprofile LAM sslkeylen 128servercert slot0:lamcertificate reloadprofile LAM1 sslkeylen 40servercert slot0:lam1certificate reloadlisten-point 10.10.10.1sec-profile LAMpu DIRECT 012ABCDE tok 0 04Sec-profile LAM1security (TN3270)
To enable security on the TN3270 server, use the security command in TN3270 server configuration mode. To turn off security on the TN3270 server, use the no form of this command.
security
no security
Syntax Description
This command has no arguments or keywords.
Defaults
The default is to have security enabled.
Command Modes
TN3270 server configuration
Command History
Usage Guidelines
If the no form of this command is configured, any listen points that contain a security profile definition are reconfigured and are no longer secure. Sessions already established on the listen point will continue to run in the same mode (secure or nonsecure) as originally configured. If sessions are active on a listen point, a message will be sent to the console stating that the listen point has sessions running with an outdated security specification. A shutdown/restart sequence must be performed on the listen point if the user wants the sessions on the listen point to use the new specification.
Entering the security command moves the user into security configuration mode. Entering the no form of this command moves the user to a TN3270 server configuration mode.
This command has no retroactive effect.
Examples
In the following example, security is enabled on the TN3270 server:
tn3270-serversecurityprofile secure-1 ss1servercert
To specify the location of the TN3270 server's security certificate in the router's Flash memory, use the servercert command in profile configuration mode.
servercert location
Syntax Description
location
Hexadecimal string of up to 63 characters specifying the location of the server's certificate in the Flash memory.
Defaults
No default behavior or values
Command Modes
Profile configuration
Command History
Usage Guidelines
The certificate is in X.509 format, signed by a certification authority (CA). The certificate must be created offline. It cannot be created using the Cisco IOS software. Use third-party software or a Windows-based utility. The certificate should be in privacy enhanced mail (PEM) or Base 64 format. The output from the certificate generation contains two parts: the certificate and the private key. Concatenate these two files to create a single certificate file in PEM or Base 64 format.
Store the concatenated file in Flash memory using TFIP and the location entered using the servercert location command. If the file does not exist in the Flash memory when the command is entered, an error message is displayed indicating that the file does not exist. The first time this command is configured the certificate is automatically loaded from the specified location. Subsequent changes to the location file do not cause the certificate to be read automatically into system's memory. The certificate reload command must be entered to read the certificate into memory. If the user exits from the profile configuration mode without configuring the servercert command, a warning message is displayed. The warning message indicates that it is mandatory to configure a certificate using the servercert command.
Examples
The following example specifies that slot0:lam is the location of the security certificate:
tn3270-serversecurityprofile LAM sslkeylen 512servercert slot0:lamcertificate reloadRelated Commands
profile
Specifies a name and a security protocol for a security profile and enters profile configuration mode.
show alps ascu
To display the status of the Airline Product Set (ALPS) agent-set control unit (ASCU), use the show alps ascu command in user EXEC or privileged EXEC mode.
show alps ascu [interface [id]] [detail]
Syntax Description
Command Modes
User EXEC
Privileged EXECCommand History
11.3(6)T
This command was introduced.
12.0(5)T
The output of this command was modified.
12.1(2)T
The output for the detail version of this command was modified.
Examples
The following sample output from the show alps ascu command:
router# show alps ascuinterface dlc id a1 a2 circuit pkt_tx pkt_rx state----------------------------------------------------------------------Serial1/2 ALC 5F 41 42 MATIP-ALC 0 0 DOWNSerial1/3 UTS 21 23 4A MATIP 0 0 DOWNSerial1/6 ALC 5F 41 45 MATIP-ALC 0 0 DOWNSerial1/6 ALC 6F 41 44 MATIP-ALC 0 0 DOWNTotal number of ASCUs: 4Total number of up ASCUs: 0The following is sample output from the show alps ascu detail command for ASCUs 4F and 6F on serial interface 1/6:
Router# show alps ascu detailascu 4F on i/f Serial1/6, dlc = ALC, state = UPdefault-circuit = MATIP-ALC, a1 = 41, a2 = 45max_msg_len = 962, retry_option = none, alias = 6Ferr_disp_terminal = 114, err_disp_line = 102pkt_tx = 0, byte_tx = 0, pkt_rx = 0, byte_rx = 0bad_CCC = 0, garbledMsgs = 0, T1Timeouts = 0ascu 6F on i/f Serial1/6, dlc = ALC, state = DOWNdefault-circuit = MATIP-ALC, a1 = 41, a2 = 44max_msg_len = 962, retry_option = noneerr_disp_terminal = 114, err_disp_line = 102pkt_tx = 0, byte_tx = 0, pkt_rx = 0, byte_rx = 0bad_CCC = 0, garbledMsgs = 0, T1Timeouts = 14Table 6 describes the significant fields in the display.
Related Commands
show alps circuits
To display the status of the Airline Product Set (ALPS) circuits, use the show alps circuits command in user EXEC or privileged EXEC mode. If a circuit name is specified, then only the status of that circuit will be displayed; otherwise, the status of all circuits will be displayed.
show alps circuits [peer ipaddress] [name name] [detail]
Syntax Description
Command Modes
User EXEC
Prvileged EXECCommand History
Examples
The following is sample output from the show alps circuits command:
router# show alps circuitsname pri_peer curr_peer dlc state pkt_tx pkt_rx--------------------------------------------------------------------------------CKT1 172.18.60.201 0.0.0.0 NONE DISC 0 0CKT2 172.18.60.201 0.0.0.0 NONE DISC 0 0MATIP 10.100.1.2 0.0.0.0 UTS DISC 0 0MATIP-ALC 10.100.1.2 0.0.0.0 ALC INOP 0 0Total number of circuits: 4Total number of connected circuits: 0The following is sample output from the show alps circuits command using the detail keyword:
router# show alps circuit name matip-alc detailMATIP-ALC: dlc = ALC, conn_type = PERM, state = INOP, uptime = 00:00:00down reason = noReasonpri_peer = 10.100.1.2, sec_peer = 0.0.0.0curr_peer = 0.0.0.0,local_hld = 4D02, remote_hld = 7F7Femtox: hostlink = 255, x121 = 1234lifetime_tmr = 4, idle_tmr = 60, retry_tmr = 30pkt_tx = 0, byte_tx = 0, pkt_rx = 0, byte_rx = 0src_corr = 0, dst_corr = 0drops_q_overflow = 0, drops_ckt_disabled = 0drops_lifetime_tmr = 0, drops_invalid_ascu = 0ascus: (41,42)U, (41,44)U, (41,45)UTotal number of ASCUs: 3show alps peers
To display the status of the Airline Product Set (ALPS) partner peers, use the show alps peers command in user EXEC or privileged EXEC mode.
show alps peers [ipaddress address] [detail]
Syntax Description
ipaddress address
(Optional) Displays only the status of that agent-set control unit (ASCU).
detail
(Optional) Displays detailed output.
Command Modes
User EXEC
Privileged EXECCommand History
Usage Guidelines
If an IP address is specified, then only the status of that peer will be displayed; otherwise, the status of all peers will be displayed.
Examples
The following is sample output from the show alps peers detail command:
router# show alps peers detailTCP:10.227.50.106, conn_id = MATIP_A_CKT-2protocol = MATIP_A, fport = 350, lport = 11592type = DYN, create = ADMIN, state = OPENED, uptime = 00:00:53down reason = unknownpkt_tx = 1071, byte_tx = 37264, pkt_rx = 1066, byte_rx = 36010Drops:giants = 0, q_overflow = 0, peer_down = 0, ver_mismatch = 0
Related Commands
alps primary-peer
Specifies the primary TCP peer and, optionally, a backup TCP peer for this ALPS circuit.
alps remote-peer
Specifies the partner IP address.
show bsc
To display statistics about the interfaces on which Bisync is configured, use the show bsc command in privileged EXEC mode.
show bsc [group bstun-group-number] [address address-list]
Syntax Description
group bstun-group-number
(Optional) block serial tunnel (BSTUN) group number. Valid numbers are decimal integers in the range from 1 to 255.
address address-list
(Optional) List of poll addresses.
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output from the show bsc command:
Router# show bscBSC pass-through on Serial4:HDX enforcement state: IDLE.Frame sequencing state: IDLE.Total Tx Counts: 0 frames(total). 0 frames(data). 0 bytes.Total Rx Counts: 0 frames(total). 0 frames(data). 0 bytes.BSC local-ack on serial5:Secondary state is CU_Idle.Control units on this interface:Poll address: C2. Select address: E2.State is Active.Tx Counts: 1137 frames(total). 0 frames(data). 1137 bytes.Rx Counts: 1142 frames(total). 0 frames(data). 5710 bytes.Poll address: C3. Select address: E3 *CURRENT-CU*State is Active.Tx Counts: 1136 frames(total). 0 frames(data). 1136 bytes.Rx Counts: 1142 frames(total). 0 frames(data). 5710 bytes.Total Tx Counts: 2273 frames(total). 0 frames(data). 2273 bytes.Total Rx Counts: 2284 frames(total). 0 frames(data). 11420 bytes.The following is sample output from the show bsc command specifying BSTUN group 50:
Router# show bsc group 50BSC local-ack on serial5:Secondary state is CU_Idle.Control units on this interface:Poll address: C2. Select address: E2.State is Active.Tx Counts: 1217 frames(total). 0 frames(data). 1217 bytes.Rx Counts: 1222 frames(total). 0 frames(data). 6110 bytes.Poll address: C3. Select address: E3 *CURRENT-CU*State is Active.Tx Counts: 1214 frames(total). 0 frames(data). 1214 bytes.Rx Counts: 1220 frames(total). 0 frames(data). 6100 bytes.Total Tx Counts: 2431 frames(total). 0 frames(data). 2431 bytes.Total Rx Counts: 2442 frames(total). 0 frames(data). 12200 bytes.The following is sample output from the show bsc command specifying BSTUN group 50 and poll address C2:
Router# show bsc group 50 address C2BSC local-ack on serial5:Secondary state is CU_Idle.Control units on this interface:Poll address: C2. Select address: E2.State is Active.Tx Counts: 1217 frames(total). 0 frames(data). 1217 bytes.Rx Counts: 1222 frames(total). 0 frames(data). 6110 bytes.Total Tx Counts: 1217 frames(total). 0 frames(data). 1217 bytes.Total Rx Counts: 1222 frames(total). 0 frames(data). 6110 bytes.The following is sample output from the show bsc command specifying poll address C2:
Router# show bsc address C2BSC pass-through on Serial4:HDX enforcement state: IDLE.Frame sequencing state: IDLE.Total Tx Counts: 0 frames(total). 0 frames(data). 0 bytes.Total Rx Counts: 0 frames(total). 0 frames(data). 0 bytes.BSC local-ack on serial5:Secondary state is CU_Idle.Control units on this interface:Poll address: C2. Select address: E2.State is Active.Tx Counts: 1137 frames(total). 0 frames(data). 1137 bytes.Rx Counts: 1142 frames(total). 0 frames(data). 5710 bytes.Total Tx Counts: 1137 frames(total). 0 frames(data). 1137 bytes.Total Rx Counts: 1142 frames(total). 0 frames(data). 5710 bytes.Table 8 describes the fields shown in the display.
.
show bstun
To display the current status of serial tunnel (STUN) connections, use the show bstun command in privileged EXEC mode.
show bstun [group bstun-group-number] [address address-list]
Syntax Description
group bstun-group-number
(Optional) Block Serial Tunneling (BSTUN) group number. Valid numbers are decimal integers in the range from 1 to 255.
address address-list
(Optional) List of poll addresses.
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output from the show bstun command with no options:
Router# show bstunThis peer: 172.26.54.111*Serial0/0 (group 201 [bsc-local-ack]) route transport address dlci lsap state rx_pkts tx_pkts dropsC1 TCP 172.26.54.2 closed 0 0 0 C2 TCP 172.26.54.2 closed 0 0 0 C3 TCP 172.26.54.2 closed 0 0 0The following is sample output from the show bstun command using the new BIP configuration:
Router# show bstunThis peer: 172.26.54.111*Serial0/0 (group 201 [bsc-local-ack]) route transport address fport lport state rx_pkts tx_pkts dropsC1 BIP 172.26.54.2 2002 1963 closed 0 0 0 C2 BIP 172.26.54.2 2001 1963 closed 0 0 0 C3 BIP 172.26.54.2 2000 1963 closed 0 0 0Table 9 describes the significant fields shown in the output.
show controllers channel
To display Channel Port Adapter (CPA)-specific information, including the loaded microcode, use the show controllers channel command in user EXEC or privileged EXEC mode.
show controllers channel [slot/port]
Syntax Description
Command Modes
User EXEC
Prvileged EXECCommand History
Examples
The following is sample output from the show controllers channel command:
Router# show controllers channel 5/0ECPA 5, hardware version 1.0, microcode version 26.0Mailbox commands: 0 forevers, 0 max elapsed usecsMicrocode loaded from flash slot0:xcpa26-0_kernel_xcpaLoaded:seg_eca Rev. 0 Compiled by cip-release on 01-Apr-98EPROM version 1.0, VPLD version 1.1ECA0: hw version 255, microcode version C50602D1Load metrics:Memory sram 2964552/4096K, dram 11552952/16MCPU 1m 0%, 5m 0%, 60m 0%DMA 1m 0%, 5m 0%, 60m 0%ECA0 1m 0%, 5m 0%, 60m 0%Interface Channel5/0Hardware is Escon ChannelHW Registers control status=0x0001EC07 LED control=0x00045DD5HW Poll Register 4B05D4E0:[00000001]Free buffer queuesqueue=0 max_entries=128 size=600 head=39 ring=4B095F00queue=1 max_entries=32 size=4520 head=31 ring=4B095E40queue=2 max_entries=64 size=4520 head=63 ring=4B096140Tx Queuesqueue=0 head=0 tail=0 tx_cnt=0 tx_pakcnt=0max_entries=128 type=1 poll_index=0 ring=4B0963C0fspak buffers swapped out=0queue=1 head=31 tail=31 tx_cnt=0 tx_pakcnt=0max_entries=32 type=2 poll_index=1 ring=4B096280fspak buffers swapped out=0Rx Queuesmax_entries=221 poll_index=3 head=57 ring=4B096800max packets per interrupt count = 0show dbconn connection
To display the status of Cisco Transaction Connection (CTRC) connections to DATABASE2 (DB2), use the show dbconn connection command in user EXEC or privileged EXEC mode.
show dbconn connection [connection-id | server server-name | userid user-id | rdbname rdb-name]
Syntax Description
Defaults
If you do not specify any keywords, this command displays information for all CTRC connections to DB2 on the current router.
Command Modes
User EXEC
Prvileged EXECCommand History
11.3(2)T
This command was introduced.
12.0(5)XN
This command moved from the CDBC feature to the CTRC feature.
Examples
The following is sample output from the show dbconn connection command:
Router# show dbconn connectionID Server Userid ClientIPAddress Connect Idle6127E428 SERVERA ALLIE 10.999.989.36 00:01:26 00:01:126127D34C BUDDY 10.999.989.84 00:00:48 00:00:41The following is sample output from the show dbconn connection command for a specified connection:
Router# show dbconn connection 6127D34Cconnection id: 6127D34Cconnection state: activeserver: BUDDYrdbname: DB2510userid: (none)client name:local ip-address: 10.147.235.2local port: 500client ip-address: 10.999.989.84client port: 4258connect time: 00:53:27idle time: 00:00:04 (client)bytes received from client: 30478bytes received from host: 318222client: licensed StarSQLTable 10 describes the fields shown in the display.
Related Commands
show dbconn license
To display the status of Cisco Transaction Connection (CTRC) licenses for DATABASE2 (DB2) communications, use the show dbconn license command in user EXEC or privileged EXEC mode.
show dbconn license
Syntax Description
This command has no arguments or keywords
Defaults
No default behavior or values
Command Modes
User EXEC
Prvileged EXECCommand History
11.3(2)T
This command was introduced.
12.0(5)XN
This command moved from the Cisco Database Connection (CDBC) feature to the Cisco Transaction Connection (CTRC) feature.
Usage Guidelines
This command produces the same results as the show txconn license command because Cisco Transaction Connection (CTRC) licenses are shared between DB2 connections and Customer Information Control System (CICS) conversations.
Examples
The following is sample output for a CTRC router that is configured to allow up to 1000 connections until January 1, 2005:
Router# show dbconn licenseCTRC is licensed for 1000 connections, 756 connections in useExpires on 1-1-2005.Related Commands
show dbconn ports
To display information about ports that Cisco Transaction Connection (CTRC) is using for communications to DATABASE2 (DB2), use the show dbconn ports command in user EXEC or privileged EXEC mode.
show dbconn ports
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
User EXEC
Prvileged EXECCommand History
11.3(2)T
This command was introduced.
12.0(5)XN
This command moved from the Cisco Database Connection (CDBC) feature to the Cisco Transaction Connection (CTRC) feature.
Examples
The following is sample output from the show dbconn ports command:
Router# show dbconn portsPort State446 listening447 listeningTable 11 describes the fields shown in the display.
Table 11 show dbconn ports Field Descriptions
Port
Port number.
State
Listening or disabled status.
Related Commands
show dbconn server
To display information about Cisco Transaction Connection (CTRC) servers configured for DATABASE2 (DB2) communications, use the show dbconn server command in user EXEC or privileged EXEC mode.
show dbconn server [server-name]
Syntax Description
Defaults
If no server name is specified, this command displays information for all CTRC servers configured for DB2 communications on the current router.
Command Modes
User EXEC
Prvileged EXECCommand History
11.3(2)T
This command was introduced.
12.0(5)XN
This command moved from the Cisco Database Connection (CDBC) feature to the Cisco Transaction Connection (CTRC) feature.
Examples
The following is sample output from the show dbconn server command:
Router# show dbconn serverServer Port IPAddress RDBName State NumConnSERVERA 446 0.0.0.0 MATTY enabled 56SERVERB 446 0.0.0.0 SCU_DSNM enabled 24SERVERC 446 0.0.0.0 DSN4 enabled 19SERVERD 446 0.0.0.0 MKTG enabled 130SERVERE 446 0.0.0.0 ABBY enabled 76SERVERF 446 0.0.0.0 DB2510 enabled 320SERVERG 446 0.0.0.0 ELLE enabled 3SERVERH 446 0.0.0.0 SUNSET enabled 0SERVERI 446 0.0.0.0 NELL enabled 1SERVERJ 446 10.989.999.32 SAMPLE enabled 12SERVERK 446 0.0.0.0 DB2410 enabled 154SERVERL 446 0.0.0.0 SQLDS enabled 50SERVERM 446 0.0.0.0 STELLA disabled 0SERVERN 446 10.10.19.4 OAK enabled 2SERVERO 447 0.0.0.0 DB2510 enabled 237BUDDY 446 0.0.0.0 DB2510 enabled 756The following is sample output from the show dbconn server command where the server BUDDY is specified:
Router# show dbconn server BUDDYserver: BUDDYserver state: enabled (accepting connections)ip-address: 0.0.0.0port: 446rdbname: DB2510connection type: SNArlu: STARW.DSNV510mode: IBMRDBtpname: \x076DBidle-timeout: 0 (none)window-size: 4096 bytesdatabase server name: (unknown)database product id: (unknown)PEM: not configurednumber of connections: 0RDB server: activeWLM: inactive-enabledTable 12 describes the fields shown in the display.
show dbconn statistic
To display all Cisco Transaction Connection (CTRC) statistics concerning communications with DATABASE2 (DB2), use the show dbconn statistic command in privileged EXEC mode.
show dbconn statistic [kind {histogram | summary}] name {chains | clientturnaround | connectionsdown | connectionsup | dump | hostreceived | hostresponse | hostsent | latency | maxconnections}
Syntax Description
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Command History
Usage Guidelines
Summary statistics are displayed by time period, where:
•
[24] indicates statistics for the hour in progress.
•
At the top of each hour, the statistics for the current period are moved from [24] to the appropriate period, [00] through [23], and [24] is reset to 0.
In the following example, at 3 a.m. the statistics for the current period are moved to [02], overwriting the old statistics for that period, and [24] is reset to 0:
At 2:59 a.m.:
[24]=228[00]=217 [01]=352 [02]=209 [03]=313 [04]=156 . . .Mid-1 am 1-2 a.m. 2-3 a.m. 3-4 a.m. 4-5 a.m. . . .02-24-2001 02-24-2001 02-24-2001 02-23-2001 02-23-2001 . . .At 3 a.m.:
[24]=0[00]=217 [01]=352 [02]=228 [03]=313 [04]=156 . . .Mid-1 am 1-2 a.m. 2-3 a.m. 3-4 a.m. 4-5 a.m. . . .02-24-2001 02-24-2001 02-24-2001 02-24-2001 02-23-2001 . . .Examples
The following command displays all the statistics relating to communications with DB2:
Router# show dbconn statistic name dumpThe following example shows the connectionsup statistic in histogram format.
Router# show dbconn statistic kind histogram name connectionsupNumber of Connections Created800 ^^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ ^ | ^ ^| | | | || | | | || | | | | | | || | | | | | | | | ^| | | | | | | | | || | | | | | | | | |400 | | | | | | | | | || | | | | | | | | || | | | | | | | | | || | | | | | | | | | || | | | | | | | | | || | | | | | | | | | | || | | | | | | | | | | || | | | | | | | | | | |- - - - - - - - - - - - - - - - - - - - - - - -12 1 2 3 4 5 6 7 8 9 10 11 12 1 2 3 4 5 6 7 8 9 10 11 *PM AMThe following example shows the connectionsup statistic in the default summary format.
Router# show dbconn statistic name connectionsupNumber of Connections Createdyesterday today today----hour--- ----PM---- ----AM---- ----PM----12:00-12:59 0 0 536 *01:00-01:59 726 002:00-02:59 718 003:00-03:59 597 004:00-04:59 549 005:00-05:59 607 006:00-06:59 298 007:00-07:59 162 508:00-08:59 3 70409:00-09:59 0 81710:00-10:59 0 72511:00-11:59 0 59824-hour total: 5636 (excludes hour in progress *)Related Commands
clear dbconn statistic
Clears statistics related to CTRC communications with DB2.
show dbconn wlm
To display information about a Cisco Transaction Connection (CTRC) server that is configured to use Workload Manager for DATABASE2 (DB2) communications, use the show dbconn wlm command in user EXEC or privileged EXEC mode.
show dbconn wlm server-name
Syntax Description
server-name
Name of the CTRC server that is configured to use Workload Manager to manage DB2 communications.
Defaults
No default behavior or values
Command Modes
EXEC
Command History
11.3(2)T
This command was introduced.
12.0(5)XN
This command moved from the Cisco Database Connection (CDBC) feature to the Cisco Transaction Connection (CTRC) feature.
Examples
The following is sample output from the show dbconn wlm command for a TCP/IP-enabled DB2 server:
Router# show dbconn wlmIP Port Weight Hits10.147.235.2 500 251 9010.147.235.2 501 182 6410.147.235.2 502 29 0Following is sample output from the show dbconn wlm command for a DB2 server in a Systems Network Architecture (SNA) network:
Router# show dbconn wlmRLU Weight HitsSTARW.DSNV510 500 230As each connection is established with DB2, CTRC obtains information from the Workload Manager subsystem to calculate the best route to use for the next connection. The fastest and most available connection is assigned the highest weight, and the Hits column shows how many times CTRC has used that route.
Related Commands
show dbconn connection
Displays the status of CTRC connections to DB2.
show dbconn ports
Displays information about CTRC ports used for DB2 communications.
show dlsw capabilities
To display the configuration of a specific peer or all peers, use the show dlsw capabilities command in privileged EXEC mode.
show dlsw capabilities [interface type number | ip-address ip-address | local]
Syntax Description
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output from the show dlsw capabilities command:
Router# show dlsw capabilitiesDLSw: Capabilities for peer 10.1.1.6(2065)vendor id (OUI) : '00C' (cisco)version number : 1release number : 0init pacing window : 20unsupported saps : nonenum of tcp sessions : 1loop prevent support : noicanreach mac-exclusive : noicanreach netbios-excl. : noreachable mac addresses : nonereachable netbios names : nonecisco version number : 1peer group number : 0border peer capable : nopeer cost : 3biu-segment configured : noUDP Unicast support : yeslocal-ack configured : yespriority configured : noconfigured ip address : 1.1.1.6peer type : confversion string :Cisco Internetwork Operating System SoftwareIOS (tm) RSP Software (RSP-JSV-M), Version 11.3(4), RELEASE SOFTWARE (fc1)Copyright (c) 1986-1998 by cisco Systems, Inc.Compiled Tue 16-Jun-98 04:29 by phanguyeTable 13 describes the fields shown in the display.
show dlsw circuits
To display the state of all circuits involving this MAC address as a source and destination, use the show dlsw circuits command in privileged EXEC mode.
show dlsw circuits [detail] [mac-address address | sap-value value | circuit-id]
Syntax Description
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output from the show dlsw circuits command:
Router# show dlsw circuitsIndex local addr(lsap) remote addr(dsap) state uptime4060086272 4000.0000.0056(F0) 4001.0000.0049(F0) CONNECTED 00:00:13Total number of circuits connected: 1The following is sample output from the show dlsw circuits command with the detail argument:
Router# show dlsw circuits detailIndex local addr(lsap) remote addr(dsap) state uptime194 0800.5a9b.b3b2(F0) 800.5ac1.302d(F0) CONNECTED 00:00:13PCEP: 995AA4 UCEP: A52274Port: To0/0 peer 172.18.15.166(2065)Flow-Control-Tx SQ CW:20, Permitted:28; Rx CW:22, Granted:25 Op:IWOCongestion: LOW(02), Flow Op: Half: 12/5 Reset 1/0RIF = 0680.0011.0640Table 14 describes the fields shown in the display.
.
show dlsw local-circuit
To display the state of all locally-switched DLSw+ circuits, use the show dlsw local-circuit privileged EXEC command.
show dlsw local-circuit [mac-address address | sap-value value | circuit-id]
Syntax Description
Defaults
No default behavior or values.
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output from the show dlsw local-circuit command:
Router# show dlsw local-circuit~ key mac-addr sap state port rif34886696 4000.1111.22c1 04 CONNECTED Se2/0 --no rif--~ PCEP: 2145198 UCEP: 2145428~ 4000.3745.0001 04 CONNECTED DL0 --no rif--~ PCEP: 2176C90 UCEP: 2145428Table 14 describes significant fields shown in the display
.
show dlsw fastcache
To display the fast cache for Fast Sequenced Transport (FST) and direct-encapsulated peers, use the show dlsw fastcache command in privileged EXEC mode.
show dlsw fastcache
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output from the show dlsw fastcache command with an FST peer:
Router# show dlsw fastcachepeer local-mac remote-mac l/r sap rifFST 10.2.32.1 0800.5a8f.881c 0800.5a8f.8822 04/04 0680.02D5.1360The following is sample output from the show dlsw fastcache command:
Router# show dlsw fastcachepeer local-mac remote-mac l/r sap rifIF Se1 0800.5a8f.881c 0800.5a8f.8822 F0/F0 0680.02D5.1360Table 16 describes the fields shown in the display.
.
show dlsw peers
To display data-link switching plus (DLSw) peer information, use the show dlsw peers command in privileged EXEC mode.
show dlsw peers [interface type number | ip-address ip-address | ssp-dlx [interface type number | ip-address ip-address] | udp]
Syntax Description
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output from the show dlsw peers command:
Router# show dlsw peers udpPeers: tot-Q'd total-rx total-tx tot-retx tot-drop curr-Q'd TCP uptime1.1.1. 0 23 0 0 0 0 0 00:01:02Total number of connected peers: 2Total number of connections: 8The following is sample output from the show dlsw peers command with a TCP connection:
Router# show dlsw peersPeers: state pkts_rx pkts_tx type drops ckts TCP uptimeTCP 10.1.91.1High priority CONNECT 43 40 conf 0 1 0 00:01:02Medium priority CONNECT 0 0 conf 0 - 0 00:01:02Normal priority CONNECT 4 41 conf 0 - 5 00:01:02Low priority CONNECT 1 0 conf 0 - 0 00:01:02TCP 10.1.93.1High priority CONNECT 3 3 conf 0 0 0 00:00:58Medium priority CONNECT 0 0 conf 0 - 0 00:00:58Normal priority CONNECT 0 0 conf 0 - 0 00:00:58Low priority CONNECT 0 39 conf 0 - 0 00:00:58Total number of connected peers: 2Total number of connections: 8The following is sample output from the show dlsw peers command with a Direct Frame Relay connection:
Router # show dlsw peersPeers: state pkts_rx pkts_tx type drops ckts TCP uptimeIF SE1 16 connect 53 2597 conf 0 - - 00:04:09Total number of connected peers: 2Total number of connections: 8The following is sample output from the show dlsw peers command with a Direct Frame Relay with local acknowledgment (LLC2) connection:
Router # show dlsw peersPeers: state pkts_rx pkts_tx type drops ckts TCP uptimeLLC2 SE1 16 connect 1179 108 conf 0 1 - - 00:04:09Total number of connected peers: 2Total number of connections: 8The following is sample output from the show dlsw peers ssp-dlx command:
Router # show dlsw peers ssp-dlxPeer:10.1.1.6 received transmittedCUR_ex Can U Reach Explorers 5 2CUR_cs Can U Reach Circuit Start 2 5ICR_ex I Can Reach Explorers 4 5ICR_cs I Can Reach Circuit Start 4 1ACK Reach Acknowledgement 1 4XID Frame 22 20CONQ Contact Remote Station 4 0CONR Remote Station Contacted 0 4INFO Information (I) Frame 39 39HLTQ Halt Data Link 0 1HLTR Data Link Halted 1 0HLTN Halt Data Link (no ack) 1 2CAPX Capabilities Exchange 2 2Total SSP Primitives 85 85DLX Peer Test Request 122 146DLX Peer Test Response 146 122DLX Border to Border Message 53 9--> SSP:CUR Can U Reach 53 2--> SSP:DATA Data Frames 0 7Last SSP Received: INFOLast SSP Sent: ICRTotal number of connected peers:1Total number of connections: 1Table 17 describes the significant fields shown in the display.
.
show dlsw reachability
To display data-link switching plus (DLSw+) reachability information, use the show dlsw reachability command in privileged EXEC mode.
show dlsw reachability [group [value] | local | remote | mac-address [address] | netbios-names [name]]
Syntax Description
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Command History
Usage Guidelines
If none of the group, local, or remote options is specified, then the caches will be displayed in the following order: local, remote, and group.
Examples
The following is sample output from the show dlsw reachability group command:
Router# show dlsw reachability groupDLSw Group MAC address reachability cache listMac Addr Group0000.3072.1070 10DLSW Group NetBIOS Name reachability cache listNetBIOS Name GroupThe following is sample output from the show dlsw reachability command:
Router# show dlsw reachabilityDLSw MAC address reachability cache listMac Addr status Loc. peer/port rif0000.f641.91e8 SEARCHING LOCAL0006.7c9a.7a48 FOUND LOCAL TokenRing0/0 0CB0.0011.3E71.A041.0DE5.06400800.5a4b.1cbc SEARCHING LOCAL0800.5a54.ee59 SEARCHING LOCAL0800.5a8f.9c3f FOUND LOCAL TokenRing0/0 08B0.A041.0DE5.06404000.0000.0050 FOUND LOCAL TokenRing0/0 0CB0.0011.3E71.A041.0DE5.06404000.0000.0306 FOUND LOCAL TokenRing0/0 0CB0.0011.3E71.A041.0DE5.06404000.0000.0307 SEARCHING LOCAL4000.0000.0308 SEARCHING LOCAL4000.1234.56c1 FOUND LOCAL Serial3/7 --no rif--4000.1234.56c2 FOUND LOCAL Serial3/7 --no rif--4000.3000.0100 FOUND LOCAL TokenRing0/0 08B0.A041.0DE5.06404000.4000.ff40 SEARCHING LOCAL4000.7470.00e7 SEARCHING LOCAL4000.ac0b.0001 FOUND LOCAL TokenRing0/0 08B0.A041.0DE5.06404001.0000.0064 FOUND LOCAL TokenRing0/0 0CB0.0011.3E71.A041.0DE5.06404001.3745.1088 FOUND LOCAL TokenRing0/0 08B0.A041.0DE5.06404100.0131.1030 FOUND LOCAL TokenRing0/010B0.FFF1.4041.0041.3E71.A041.0DE5.0640DLSw NetBIOS Name reachability cache listNetBIOS Name status Loc. peer/port rifAPPNCLT2 FOUND LOCAL TokenRing0/0 08B0.A041.0DE5.0640The following is sample output from the show dlsw reachability command with the mac-address keyword:
Router# show dlsw reachability mac-address 4000.00000306DLSw MAC address reachability cache listMac Addr status Loc. peer/port rif4000.0000.0306 FOUND LOCAL TokenRing0/0 0CB0.0011.3E71.A041.0DE5.0640The following is sample output from the show dlsw reachability command with the netbios-names keyword:
Router# show dlsw reachability netbios-namesDLSw NetBIOS Name reachability cache listNetBIOS Name status Loc. peer/port rifAPPNCLT2 FOUND LOCAL TokenRing0/0 08B0.A041.0DE5.0640Table 18 describes the significant fields shown in the display.
.
show dlsw statistics
To display the number of frames that have been processed in the local, remote, and group cache, use the show dlsw statistics command in privileged EXEC mode.
show dlsw statistics [border-peers]
Syntax Description
border-peers
(Optional) Displays the number of frames processed in the local, remote, and group caches.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output from the show dlsw statistics command. The output displays the number of frames processed in the local, remote, and group cache.
Router# show dlsw statistics border-peers100 Border Peer Frames processed10 Border frames found Local20 Border frames found Remote17 Border frames found Group Cacheshow dlsw transparent cache
To display the master circuit cache for each transparent bridged domain, use the show dlsw transparent cache command in privileged EXEC mode.
show dlsw transparent cache
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Command History
Usage Guidelines
Issue the show dlsw transparent cache command on the master router of the transparent bridged domain.
Examples
The following is sample output from the show dlsw transparent cache command:
Router# show dlsw transparent cacheInterface Ethernet0/1Circuit Cachelocal addr(lsap) remote addr(dsap) state Owner0000.3028.92b6(08) 0007.0db1.238c(08) POSITIVE SELF0000.3028.92b6(08) 0008.dec3.609e(12) NEGATIVE 0009.fa50.0b1cTotal number of circuits in the Cache:2show dlsw transparent map
To display MAC address mappings on the local router and any mappings for which the local router is acting as backup for a neighbor peer, use the show dlsw transparent map command in privileged EXEC mode.
show dlsw transparent map
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Command History
Usage Guidelines
Issue the show dlsw transparent map command to ensure that the local MAC address is the address created in the dlsw transparent map command. The command should be issued on all the routers configured for the Ethernet Redundancy feature to ensure the local MAC addresses match.
Examples
The following is sample output from the show dlsw transparent map command on two routers configured for the Ethernet Redundancy feature:
Router6# show dlsw transparent mapInterface Ethernet6/2LOCAL Mac REMOTE MAC BACKUP--------- ---------- ------0008.dec3.0080 0008.dec3.609e 0007.7fb0.1080 STATIC0008.dec3.0040 0008.dec3.609e 0007.7fb0.1080 DYNAMIC(Passive)Router7# show dlsw transparent mapInterface Ethernet0/1LOCAL Mac REMOTE MAC BACKUP--------- ---------- ------0008.dec3.0080 0008.dec3.609e 0006.3a0a.1a55 DYNAMIC(Passive)0008.dec3.0040 0008.dec3.609e 0006.3a0a.1a55 STATICThe output from Router 6 and Router 7 shows the created MAC addresses are 0008.dec3.0080 and 0008.dec3.0040.
show dlsw transparent neighbor
To display data-link switching plus (DLSw) neighbors in a transparent bridged domain, use the show dlsw transparent neighbor command in privileged EXEC mode.
show dlsw transparent neighbor
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output from the show dlsw transparent neighbor command:
Router# show dlsw transparent neighborInterface ATM0.10006.e278.6c0e SELF Master0009.fa50.0b1c Rcvd Master-Accepted VALIDThe output shows that Router 7 is the master router whose MAC address is 0006.e278.6c0e. The other router, with a MAC address of 0009.fa50.0b1c, is a slave router on the common domain. The master router received a packet from the slave and notes the router is VALID.
show dspu
To display the status of the downstream physical unit (DSPU) feature, use the show dspu command in privileged EXEC mode.
show dspu [pool pool-name | pu {host-name | pu-name}] [all]
Syntax Description
Defaults
No default behavior or values
Command Modes
Privileged EXEC
Command History
Examples
The following is sample output from the show dspu command. It shows a summary of the DSPU status.
Router# show dspudspu host HOST_NAMEA interface PU STATUS ssssssssFRAMES RECEIVED nnnnnn FRAMES SENT nnnnnnLUs USED BY DSPU nnn LUs ACTIVE nnnLUs USED BY API nnn LUs ACTIVE nnnLUs ACTIVATED BY HOST BUT NOT USED nnndspu host HOST_NAMEB interface PU STATUS ssssssssFRAMES RECEIVED nnnnnn FRAMES SENT nnnnnnLUs USED BY DSPU nnn LUs ACTIVE nnnLUs USED BY API nnn LUs ACTIVE nnnLUs ACTIVATED BY HOST BUT NOT USED nnndspu pu PU_NAMEE interface PU STATUS ssssssssFRAMES RECEIVED nnnnnn FRAMES SENT nnnnnnLUs USED BY DSPU nnn LUs ACTIVE nnnLUs USED BY API nnn LUs ACTIVE nnnLUs ACTIVATED BY HOST BUT NOT USED nnndspu pu PU_NAMEF interface PU STATUS ssssssssFRAMES RECEIVED nnnnnn FRAMES SENT nnnnnnLUs USED BY DSPU nnn LUs ACTIVE nnnLUs USED BY API nnn LUs ACTIVE nnnLUs ACTIVATED BY HOST BUT NOT USED nnnThe following is sample output from the show dspu command with the pu keyword:
Router# show dspu pu putestdspu pu PUTEST interface PU STATUS ssssssssRMAC remote_mac RSAP remote_sap LSAP local_sapXID xid RETRIES retry_count RETRY_TIMEOUT retry_timeoutWINDOW window_size MAXIFRAME max_iframeFRAMES RECEIVED nnnnnn FRAMES SENT nnnnnnLUs USED BY DSPU nnn LUs ACTIVE nnnLUs USED BY API nnn LUs ACTIVE nnnLUs ACTIVATED BY HOST BUT NOT USED nnnThe following is sample output from the show dspu command with the all keyword:
Router# show dspu pu putest alldspu pu PUTEST interface PU STATUS ssssssssRMAC remote_mac RSAP remote_sap LSAP local_sapXID xid RETRIES retry_count RETRY_TIMEOUT retry_timeoutWINDOW window_size MAXIFRAME max_iframeFRAMES RECEIVED nnnnnn FRAMES SENT nnnnnnLU nnn PEER PU HOST_NAMEA PEER LU nnn STATUS ttttttttFRAMES RECEIVED nnnnnn FRAMES SENT nnnnnnLU nnn PEER PU HOST_NAMEA PEER LU nnn STATUS ttttttttFRAMES RECEIVED nnnnnn, FRAMES SENT nnnnnnLU nnn PEER PU HOST_NAMEB PEER LU nnn STATUS ttttttttFRAMES RECEIVED nnnnnn, FRAMES SENT nnnnnnThe following example shows a summary of the LUs in a pool:
Router# show dspu pool poolnamedspu pool poolname host HOST_NAMEA lu start-lu end-luThe following example shows the details of all the LUs in a pool:
Router# show dspu pool poolname alldspu pool poolname host HOST_NAMEA lu start-lu end-luDSPU POOL poolname INACTIVITY_TIMEOUT timeout-valuelu nnn host HOST_NAMEA peer lu nnn pu PU_NAMEF status ttttttttlu nnn host HOST_NAMEA peer lu nnn pu PU_NAMEF status ttttttttlu nnn host HOST_NAMEA peer lu nnn pu PU_NAMEF status tttttttt