This chapter includes all of the configuration and monitoring commands applicable to DLSw. It contains these sections:
About DLSw Configuration and Monitoring Commands
Accessing the DLSw Configuration Prompt
Accessing the DLSw Monitoring Prompt
DLSw Commands
About DLSw Configuration and Monitoring
DLSw configuration commands are available at the DLSw config> prompt. Changes made to the router's configuration do not take effect immediately. They only become part of the router's non-volatile configuration memory when it restarts.
Conversely, DLSw monitoring commands are available at the DLSw> prompt. Monitoring commands take effect immediately, but do not become part of router's non-volatile configuration memory. Thus, while monitoring commands allow you to make real-time changes to the router's configuration, these changes are temporary. The router's configuration memory overwrites them when the router restarts.
Monitoring consists of these actions:
Commands
Monitoring the protocols and network interfaces currently in use by the router.
Displaying ELS (Event Logging System) messages relating to router activities and performance.
Making real-time changes to the DLSw configuration without permanently affecting the router's non-volatile configuration memory.
If the Config> prompt does not appear immediately, press Return again. All DLSw configuration commands are entered at the DLSw config> prompt. To access this prompt, enter protocol dls as shown:MOS Operator Control
* config
Config>
Config>protocol dls
DLSw protocol user configuration
DLSw config>
You enter DLSw monitoring commands at the DLSw> prompt. To access this prompt, enter protocol dls at the Monitor> prompt as shown:MOS Operator Control
* monitor
Monitor>
Monitor> protocol dls
DLSw>
[C] means the command is available at the DLSw config> prompt. [M] means the command is available at the DLSw> prompt.
Add [C] [M]
Configures an SDLC link station or a TCP neighbor IP address.
Syntax: add
add sdlc
Interface #[0]?
SDLC Address [C1]?
Source MAC Address [0000C9123456]
Idblk in Hex (0-0xfff) [0]?
Idnum in Hex (0-0xfffff) [0]?
LLC Source SAP (0 for auto-assign) [0]?
LLC Destination SAP [4]?
Destination MAC Address [400000000001]?
tcp
Adds the IP address of the DLSw neighbor to which the TCP is connected. You can make this connection in two ways: manual configuration of IP neighboring addresses or with DLSw groups.
Example: add tcp
Enter the DLSw neighbor IP Address [0.0.0.0]? 128.185.14.1
Transmit Buffer Size (Decimal) [5120]?
Receive Buffer Size (Decimal) [5120]?
Maximum Segment Size (Decimal) [1024]?
Enable/Disable Keepalive? (E/D) - [D]?
Neighbor Priority (H/M/L) [M]?
BAN [C] [M]
Displays the Boundary Access Node (BAN) configuring or monitoring prompt. See Using Boundary Access Node for information on the commands available at these prompts.
ban
BAN (Boundary Access Node) configuration
BAN config>
close-sap
Interface # [0]?
Enter SAP in hex (range 0-F4), 'SNA', 'NB' or 'LNM' [4]? nb
SAP F0 closed on interface 0
Delete [C] [M]
Removes an SDLC link station or a TCP neighbor IP address from the DLSw configuration.
Delete [C]
Syntax: delete
delete sdlc
Interface #[0]?
SDLC Address [C1]?
Record deleted
tcp
Removes the IP address of the DLSw neighbor to which you are making the TCP connection.
Example: delete tcp
IP Address [0.0.0.0]? 128.185.14.1
delete sdlc
Interface #[0]?
SDLC Address [C1]?
Record deleted
tcp
Removes the IP address of the DLSw neighbor to which you are making the TCP connection. This also terminates the TCP connection if one exists.
Example: delete tcp
IP Address [0.0.0.0]? 128.185.14.1
disable dls
disable llc
disable sdlc
Interface #[0]? 1
SDLC Address [C1]?
Record updated
disable auto
enable dls
enable llc
enable sdlc
Interface #[0]? 1
SDLC Address [C1]?
Record updated
enable auto-tcp-reconnect
enable llc
enable sdlc
Interface #[0]? 1
SDLC Address [C1]?
Record updated
enable auto
join-group
Group ID (1-64 Decimal) [1]? 2
Client/Server or neighbor Group member (C/S/P)- [C]?
Transmit Buffer Size (Decimal) [5120]?
Receive Buffer Size (Decimal) [5120]?
Maximum Segment Size (Decimal) [1024]?
Enable/Disable Keepalive (E/D)- [D]?
Neighbor Priority (H/M/L) [M]?
Leave-Group [C] [M]
Removes the router from any specified DLSw groups that you configured with the join-group command.
Leave-Group [C]
In the configuration environment, leave-group does not affect existing TCP connections belonging to the specified group.
Syntax: leave-group group#
leave-group 2
leave-group 2
list dls
DLSw is ENABLED
LLC2 send Disconnect is ENABLED
Automatic TCP connection ALWAYS CONNECT
SRB Segment number 0030
MAC <-> IP mapping cache size 128
Max DLSw sessions 3000
DLSw global memory allotment 60000
LLC per-session memory allotment 8192
SDLC per-session memory allotment 4096
NetBIOS UI-frame memory allotment 40960
Database age timer 1200 seconds
Max wait timer for ICANREACH 20 seconds
Wait timer for LLC test response 15 seconds
Wait timer for SDLC test response 15 seconds
Join Group Interval 900 seconds
Neighbor priority wait timer 2.0 seconds
groups
Displays group information for a DLSw neighbor previously configured with the join-group command.
Example: list groups
Group Role Xmit Bufsize Rcv Bufsize Max Segsize Keepalive Priority
1 CLIENT 5120 5120 1024 DISABLED MEDIUM
llc2 sap parameters
Displays the LLC2 parameters configured with the set llc2 command (see the set command on page 77 for a complete explanation of these parameters). You set these parameters for each interface. If you did not use the set llc2 command to change the LLC2 parameters, no output is generated.
SAP t1 t2 ti n2 n3 tw rw nw acc
0 1 1 30 8 1 2 2 1 0
open
Displays all open SAPs and their associated interfaces.
Example: list open
Interface SAP
0 0
0 4
1 4
list priority
Priority for SNA DLSw sessions is MEDIUM
Priority for NetBIOS DLSw sessions is MEDIUM
Message allocation by C/H/M/L priority is 4/3/2/1
Maximum frame size for NetBIOS is 2052
list sdlc
Net Addr Status Idblk Idnum Source SAP/MAC Dest SAP/MAC
5 C1 Enabled 017 A0021 04 4018997E05C1 04 401AA9200C1
tcp neighbors
Displays configured DLSw neighbors that are TCP neighbors. The neighbors were configured with the add tcp command.
Example: list tcp
Neighbor Xmit Bufsize Rcv Bufsize Max Segsize Keepalive Priority
-------- ------------ ----------- ----------- --------- --------
128.185.122.234 5120 5120 1024 DISABLED MEDIUM
dls global
Displays DLS global parameter information.
Example: list dls global
DLSw is ENABLED
LLC2 send Disconnect is ENABLED
Automatic TCP connection ALWAYS CONNECT
SRB Segment number 000
MAC <-> IP mapping cache size 128
Max DLSw sessions 1000
DLSw global memory allotment 141056
LLC per-session memory allotment 8192
SDLC per-session memory allotment 4096
NetBIOS UI-frame memory allotment 40960
Database age timer 1200 seconds
Max wait timer for ICANREACH 20 seconds
Wait timer for LLC test response 15 seconds
Wait timer for SDLC test response 15 seconds
Join Group Interval 900 seconds
Neighbor priority wait timer 2.0 seconds
dls sessions all
Displays current dls session information.
Example: list dls session all
Source Destination State Flags Dest. IP Addr Id
1. 400000000003 04 500000000003 04 Connected 128.185.236.51 2 2
dls sessions ban
Displays current information on BAN sessions.
Example: list dls session ban
BAN port number (user 0 for all ports) [0]?
No active sessions
list dls session dest
Destination MAC Address [40000000001]? 50000000003
Source Destination State Flags Dest. IP Addr Id
1. 400000000003 500000000003 Connected 128.185.236.51 2
2. 400000000002 500000000003 Connected 128.185.236.52 3
list dls session detail
Session Identifier [1]?
Source Destination State Dest. IP Addr Id
1. 400000000003 500000000003 04 Connected 128.185.236.51 2
Personality: TARGET
XIDs sent: 2
XIDs rcvd: 0
Datagrams sent: 0
Datagrams rcvd: 0
Info frames sent: 15
Info frames rcvd: 0
RIF: 0620 0202 B0B0
dls session ip
Displays IP session information.
Example: list dls session ip
Source Destination State Dest.IP Addr Id
1.400000000003 500000000003 04 Connected 128.185.236.51 1
list dls sessions nb
Source Destination State Flags Dest. IP Addr Id
1. 0000C91373C1 F0 0003152CCCE6 F0 Connected 128.185.236.245 92
list dls session range
Start [1]?
Stop [1]?
Source Destination State Dest. IP Addr Id
1.400000000003 500000000003 04 Connected 128.185.236.51 2
list dls session src
Source MAC Address [400000000001]?
Source Destination State Flags Dest. IP Addr Id
1. SDLC 04 400000000002 04 Connected 10.1.49.401 1
list dls session state
DISCONECT = 0, RSLV_PEND = 1
CIRC_PEND = 2, CIRC_EST = 3
CIR_RSTRT = 4, CONN_PEND = 5
CONT_PEND = 6, CONNECTED = 7
DISC_PEND = 8, HALT_PEND = 9
REST_PEND = 10
Enter state value (0-10) [7]?Source Destination State Flags Dest. IP Addr Id
1. 400000000003 04 10005AF181A4 04 Connected 128.185.236.84 0
2. 400000000002 04 400000000088 04 Connected 128.185.236.84 1
list dls cache all
Mac Address Secs to live IP Address(es) Largest Frame
1. 10005AF1809B 810 128.185.236.84 1470
2. 10005AF181A4 1170 128.185.236.84 2052
3. 400000000088 1170 128.185.236.84 2052
list dls cache range
Start[2]?
Stop[2]?
Mac Address Secs to live IP Address(es) Largest Frame
2. 10005AF181A4 1170 128.185.236.84 2052
The currently in use field shows the total amount of memory currently allocated by DLS. This includes all session allocations, control messages and TCP receive buffers. Note: To change the memory allocation use the set memory command.
Example:list dls memory
Total DLSw bytes requested: 141056
Global receive pool bytes granted: 84633
Currently in use: 0
Global transmit pool bytes granted: 56423
Currently in use: 232
No active sessions
list groups
Group Role Xmit Bufsize Rcv Bufsize Max Segsize Keepalive Priority
1 CLIENT 5120 5120 1024 DISABLED MEDIUM
llc2 open
Displays information that pertains to LLC2. The options (open SAPs, SAP parameters, and sessions) for LLC2 are described below and on the following pages.
|
Open
| Displays information for all currently open SAPs on interfaces between LLC2 peers. |
Interface SAP
0 0
0 4
list llc2 sap
SAP T1 t2 ti n2 n3 tw rw nw acc
list llc2 sessions all
SAP Int. Remote Addr Local Addr State RIF
1. 04 6 400000000003 500000000003 CONTACTED 0620 0202 B0B0
llc2 sessions range
Displays current information for the selected range of LLC2 sessions.
Example: list llc2 sessions range
Start[1]?
Stop[1]?
SAP Int. Remote Addr Local Addr State RIF
1. 04 6 400000000003 50000000000 Contacted 0620 0202 B0B0
list sdlc sessions
NET Addr. Source SAP Dst SAP Dest Mac InQ OutQ State
1. 2 C1 04 04 40:00:00:00:00:02 00 00 Contacted
list sdlc config
Interface #, or 'ALL' [0]? 5
Net Addr Status Idblk Idnum Source SAP/MAC Dest SAP/MAC
5 C1 Enabled 000 00000 04 4018997E05C1 04 401AAB9200C1
list tcp capabilities
Enter the DLSw neighbor IP Address [0.0.0.0]? 1.1.1.2
Vendor ID: 0000C9
Vendor version: Netrix (tm) 5.2
Initial pacing window: 12
Preferred TCP connections: 1
Supported SAPs: 00 04 08 0C
list tcp config
Neighbor Xmit Bufsize Rcv Bufsize MaxSegsize Keepalive Priority
128.185.122.234 5120 5120 1024 DISABLED MEDIUM
list tcp sessions
Group IP Address Conn State Version Active Sess SessCreates
1 1.1.1.1 ESTABLISHED AIW V1R0 2 4
list tcp statistics
Enter the DLSw neighbor IP Address [0.0.0.0]? 1.1.1.1
Transmitted Received
----------- -----------
Data Messages 217 314
Data Bytes 31648 43796
Control Messages 64 74
CanYouReach Explorer Messages 6 0
ICanReach Explorer Messages 0 4
NameQuery Explorer Messages 0 0
NameRecognized Explorer Messages 0 0
netbios
NetBIOS Support User Configuration
NetBIOS config>
open-sap
Interface # [0]?
Enter SAP in hex (range 0-F4), 'SNA', 'NB' or 'LNM' [4]? lnm
SAP F4 opened on interface 0
Set [C] [M]
Configures the size of the MAC address-to-IP address mapping cache, LLC2 parameters, maximum number of DLSw sessions, SRB segment number, protocol timers, and TCP receive buffer size.
Set [C]
Syntax: set
set cache
MAC <-> IP cache size (4 - 65535) [128]?
set llc2
Enter SAP in hex (range 0-FE) [0]?
Reply timer (T1) in sec. [1]?
Receive Ack timer (T2) in 100 millisec. [1]?
Inactivity Timer (Ti) in sec. [30]?
Transmit Window (Tw), 1-128, 0=default [2]?
Receive Window (Rw), 127 Max [2]?
Acks needed to increment Ww (Nw) [1]?
Max Retry value (N2) [8]?
Number I-frames received before sending ACK (N3) [1]?
maximum #-of-sessions
Sets the maximum number of DLSw sessions that the DLSw protocol can support.
Example: set maximum
Maximum number of DLSw sessions (1-60000) [1000]?
set memory
Number of bytes to allocate for DLSw (at least 26368) [141056]?
Number of bytes to allocate per LLC session [8192]?
Number of bytes to allocate per SDLC session [4096]?
Number of bytes to allocate for NetBIOS UI-frames [40960]?
set srb
Enter segment number hex (1-FFF) [5]?
set timers
Database age timer (1-1000 secs. Decimal) [1200]?
Max wait timer ICANREACH (1-1000 secs Decimal) [20]?
Wait timer LLC test response (1-1000 secs. Decimal) [15]?
Wait timer SDLC test response (1-1000 secs. Decimal) [15]?
Group join timer interval (1-60000 secs. Decimal) [15]?
Neighbor priority wait timer (1.0-5.0 secs. Decimal) [5.0]?
priority
Lets you specify the circuit priorities to use for SNA circuits and NetBIOS circuits. You can use this command to specify circuit priority as Critical, High, Medium, or Low. Note that you must assign circuit priorities in descending order from Critical to Low.
The router uses the priority value you assign to selectively limit the burst-length of specific types of traffic. For example, if you assign SNA traffic a priority of Critical and NetBIOS traffic a priority of Medium, with a message allocation of 4/3/2/1, the router processes 4 SNA frames before it processes 2 NetBIOS frames. After the router processes 2 NetBIOS frames, it processes 4 SNA frames, and so on. In this scenario, two thirds of available bandwidth is dedicated to SNA traffic (a ratio of 4 to 2). Note that the router counts frames, rather than bytes, when allocating bandwidth according to the priorities you assign.
You can also use this command to set the maximum frame size to use for NetBIOS. Set this parameter to the largest frame size you expect to need, and no larger. Setting the frame size larger than needed reduces the number of available buffers.
Example: set priority
Priority for SNA DLSw sessions (C/H/M/L) [M]?
Priority for NetBIOS DLSw sessions (C/H/M/L) [M]?
Message allocation by C/H/M/L priority (4 digits) [4/3/2/1]?
Maximum NetBIOS frame size (516, 1470, 2052, or 4399) [2052]?
set llc2
Enter SAP in hex (range 0-F4) [0]?
Reply timer (T1) in sec. [1]?
Receive Ack timer (T2) in 100 millisec. [1]?
Inactivity Timer (Ti) in sec. [30]?
Transmit Window (Tw), 1-128, 0=default [2]?
Receive Window (Rw), 127 Max [2]?
Acks needed to increment Ww (Nw) [1]?
Max Retry value (N2) [8]?
Number I-frames received before sending ACK (N3) [1]?
memory
Specifies the total amount of memory allocated to DLSw and the total amount of memory to be allotted to each DLSw session. This command affects only new DLSw sessions.
Example: set memory
Number of bytes to allocate for DLSw (at least 26368) [141056]?
Number of bytes to allocate per LLC session [8192]?
Number of bytes to allocate per SDLC session [4096]?
Number of bytes to allocate for NetBIOS UI-frames [40960]?
The SDLC and LLC allocations will affect new sessions only
set priority
Priority for SNA DLSw sessions (C/H/M/L) [M]?
Priority for NetBIOS DLSw sessions (C/H/M/L) [M]?
Message allocation by C/H/M/L priority (4 digits) [4/3/2/1]?
Maximum NetBIOS frame size (516, 1470, 2052, or 4399) [2052]?
set timers
Database age timeout (1-10000 secs. Decimal) [1200]?
Max wait timer ICANREACH (1-1000 secs. Decimal) [30]?
Wait timer LLC test response (1-1000 secs. Decimal) [15]?
Wait timer SDLC test response (1-1000 secs. Decimal) [15]?
Group join timer interval (1-60000 secs. Decimal) [900]?
Neighbor priority wait timer (1.0-5.0 secs. Decimal) [5.0]?
Exit [C] [M]
Use the exit command to return to the Config> or Monitor> prompt.
Example: exit