IBM Books

Access Integration Services Software User's Guide Version 3.3


Configuring and Monitoring SDLC Relay

This chapter includes an overview of the Synchronous Data Link Control (SDLC) Relay function and describes its configuration and operational commands.

For further information on when to use DLSw SDLC versus SDLC Relay, refer to "Relationship to the SDLC Relay Function" in the "Using DLSw" chapter of Protocol Configuration and Monitoring Reference Volume 1.

The chapter includes the following sections:


Overview of SDLC Relay

SDLC Relay is a function that transports SDLC packets encapsulated in IP over an IP connection. SDLC connections consist of a primary (polling) end point and a secondary (polled) end point. They are either point-to-point (one primary and one secondary device) or multipoint (one primary and several secondary devices). SDLC Relay maintains this design, except that routers forward the frames between the primary and secondary SDLC devices.

Figure 26 shows an example of an SDLC Relay configuration with the primary SDLC device connected to two secondary SDLC control units.

Figure 26. Example of an SDLC Relay Configuration

Figure

As shown, the primary and secondary SDLC devices are each locally attached to a router. The routers communicate over an IP connection or tunnel and serve as a pipe between the SDLC end points. During configuration, you define the connections to the routers as virtual groups. You also assign arbitrary numbers to these groups to identify them for the router. A local group includes a local port, which is a router's local interface. Each local group has one corresponding remote group that consists of a remote port, which is the interface of the remote router, and the address of an IP tunnel that connects the local router to the remote router. The remote router is the local router's peer. For example, Router B and Router C are remote routers for Router A. The IP address of the tunnel must be the internal IP address of the remote router. Refer to the set internal-IP-address command in the Protocol Configuration and Monitoring Reference Volume 2 for more information.

Each port is also identified as primary or secondary, depending upon the final end point of the connection. Within each group, one port is primary and one is secondary. Although the groups in the example have the same number for the local group and the corresponding remote group, this matching is not required. For example, for Router A, local group 2 includes the local primary port for local group 2. The corresponding remote group is also numbered 2, but it could have been identified by another number.

The secondary SDLC control units connected to Router B in this example are not connected to the same line. This is an example of a virtual multipoint connection. If the SDLC control units are directly connected to the same line, that is considered a physical connection. Within one network, you can have both physical and virtual connections.

In a multipoint network, the secondary devices are identified by one-byte or two-byte station addresses. All SDLC relay routers within one SDLC network must use the same number of address bytes, either all one-byte or all two-byte. The routers identify the secondary SDLC control units dynamically. Based upon that knowledge, the routers can transmit frames for a particular device to that device. Broadcast frames continue to be broadcast from the sending device to all other devices in the network.

Only the half-duplex transmission mode is supported. This means that request-to-send (RTS) must be raised before each transmission. Clear-to-send (CTS) does not remain up permanently.


Basic Configuration Procedure

This section outlines the minimum configuration steps required to get the SDLC Relay protocol up and running. For more explanation of the parameters, see Overview of SDLC Relay and the descriptions of the configuration commands.


Dynamic Reconfiguration

You can use the Talk 5 reset interface# and activate interface# commands to activate all SDLC Relay parameters that you have configured on an interface using Talk 6. Alternatively, you can restart or reload the router to make your new configuration changes take effect.


Accessing the SDLC Relay Configuration Environment

To access the SDLC relay (SRLY) configuration environment:

  1. At the Config> prompt, enter set data-link srly.

  2. Enter the interface number.

  3. To configure the SRLY interface, enter the network interface# command. The SRLY interface# Config> prompt is displayed when network interface# is entered:
    Config>network 2
    SDLC Relay interface user configuration
    SRLY 1 Config>
    

  4. To configure the SRLY protocol parameters, enter the protocol sdlc command. The SDLC Relay config> prompt is displayed when protocol sdlc is entered:
    Config>protocol sdlc
    SDLC Relay protocol user configuration
    SDLC Relay config>
    

SDLC Relay Configuration Commands

This section summarizes the SDLC Relay configuration commands. Both the network and protocol parameters for SDLC Relay are documented in this chapter.

The SDLC Relay configuration commands allow you to specify router parameters for interfaces transmitting SDLC Relay frames. Table 52 shows the commands for both the network sdlc and protocol sdlc.

Table 52. SDLC Relay Configuration Commands Summary
Command Network SRLY Protocol SDLC Function
 ? (Help)   yes   yes   Lists all of the SDLC Relay configuration commands or lists the options associated with specific commands. 
 Add      yes   Adds groups, local ports, and remote ports. 
 Delete      yes   Deletes groups and ports. 
 Disable      yes   Disables groups and ports. 
 Enable      yes   Enables groups and ports. 
 List   yes   yes   Displays entire SDLC Relay and group specific configurations. 
 Set   yes      Sets the link parameters and remote station parameters. 
 Exit   yes   yes   Exits the SDLC Relay configuration environment and returns to the CONFIG environment. 

Add

Use the add command to add local groups, local ports, and remote ports.

Syntax:

add
group local-group# group-type local-group-name
 
local-port
 
remote-port

group
Defines a local group. A local group is identified by a number and a name.

Example: add group

Local group number: [1]? 
Local group name []? CHICAGO-TO-MIAMI 
(P)oint-to-Point or (M)ultipoint: [P]? 

Local-group-number
The group number that you are designating to identify the local group.

Local-group-name
This is the name of this local group. You can use up to 32 ASCII characters to name the local group. If you do not provide a name, the default name of LOCAL-GROUP-n is used, where n is the local group number.

Group-type
The group types are point-to-point or multipoint.

local-port
Identifies the interface that you are using for the local port.

Example: add local-port

Local group number: [1]? 
Interface number: [0]? 3
(P)rimary or (S)econdary: [S]? p  

Local group number
The local group number for the port.

Network or interface number
The network or interface number of the router that designates the local port.

Primary or Secondary
Designates the port type, primary (P) or secondary (S). The default is secondary.

remote-port
Identifies the port directly connected to the serial line on the remote router.

Example: add remote-port

Local group number: [1]? 
IP address of remote router: [0.0.0.0]? 9.67.2.3
Is the remote's upper group number limit 255 (current) or 15 (migration): [255]? 
Remote router group number: [1]? 
Does the connection use 2-byte station addressing: [Y]? 
(P)rimary or (S)econdary: [S]? s   

Group number
The local group number for the port.

IP address of remote router
The internal IP address of the remote router. It identifies the IP tunnel that connects the router to the remote router.

Upper group number limit
Support level of the remote router, defined by the upper limit of group numbers that you can use. The default is current, which is a limit of 255 and a range of 1 to 255.

Remote router group number
The group number of the remote group to which this remote port belongs. The local and remote group number are not required to be the same number.

Two-byte or one-byte station addressing
The number of bytes in the station address. The station address is the SDLC address of the secondary SDLC device. The default is two bytes.

Primary or Secondary
Designates the port type, primary (P) or secondary (S). The default is secondary.

Delete

Use the delete command to remove group numbers, local ports, and remote ports.

Syntax:

delete
group . . .
 
local-port . . .
remote-port

group group#
Removes a local group (group#).

local-port group#
Removes the local port for the specified group.

remote-port
Removes the remote port for the specified group.

Example: delete remote-port

            Group number: [1]? 1
           

Group number
The remote group number for the remote port.

Disable

Use the disable command to suppress relaying for an entire relay group or a specific relay port.

Syntax:

disable
group . . .
 
port

group group#
Suppresses transfer of SDLC Relay frames to or from a specific group (group#).

port
Suppresses transfer of SDLC Relay frames to or from a specific local or remote port.

Example: disable port

Local group number: [1]? 
(L)ocal port or (R)emote port: [L]?

Group number
The group number of the local group that includes the port.

Local or remote
Designates whether the port is local or remote.

Enable

Use the enable command to turn on data transfer for an entire group or a specific local interface port.

Syntax:

enable
group . . .
 
port

group group#
Allows transfer of SDLC Relay frames to or from the specified local group (group#).

port
Allows transfer of SDLC Relay frames to or from the specified local or remote port.

Example: enable port

Local group number: [1]? 
(L)ocal port or (R)emote port: [L]?  

Group number
The group number of the group that includes the port.

Local or remote
Designates whether the port is local or remote.

List (for network SRLY)

Use the list command to display the configuration of the SDLC Relay (SRLY) interface.

Syntax:

list
 

Example:

list
Maximum frame size in bytes = 2048
Encoding:  NRZ
Idle State:  Flag
Clocking:  External
Cable Type:  RS-232 DTE
Speed (bps):  0
Transmit Delay Counter:  0

Maximum frame size in bytes
Maximum frame size that can be sent over the link. The maximum frame size must be large enough to accommodate the largest frame and the 6 byte SRLY header.

Encoding
The transmission encoding scheme for the serial interface. Scheme is NRZ (non-return to zero) or NRZI (non-return to zero inverted).

Idle State
The data link idle state: flag or mark.

Clocking
The type of clocking: internal, external.

Cable Type
The serial interface cable type.

Speed (bps)
Lists the speed of the transmit and receive clocks.

Transmit Delay Counter
Number of flags sent between consecutive frames.

List (for protocol SDLC Relay)

Use the list command to display the configuration of a specific group or of all groups.

Syntax:

list
all
group . . .

all
Displays the configurations of all local groups.

Example: list all

SDLC/HDLC Relay Configuration
 
 
 Local group     = 1  
 
 Group Name      = CHICAGO-TO-MIAMI                              
 Group Type      = MULTI                     Enabled       = YES
 Local port      = PRIMARY                   Enabled       = YES
 Interface       = 2   
 Remote port     = SECONDARY                 Enabled       = YES
 Remote group    = 1                         Addressing    = 2-BYTE
 IP Address      = 9.67.2.3                  Code level    = CURRENT
 
 Local group     = 2 
 Group Name      = CHICAGO-TO-RALEIGH
 Group Type      = MULTI                     Enabled       = YES 
 Local port      = PRIMARY                   Enabled       = YES
 Interface       = 3  
 Remote port     = SECONDARY                 Enabled       = YES 
 Remote group    = 2                         Addressing    = 2-BYTE
 IP Address      = 9.67.2.3                  Code level    = CURRENT
 
 Local group     = 3  
 Group Name      = CHICAGO-TO-PITTSBURGH 
 Group Type      = PT-PT                     Enabled       = YES 
 Local port      = PRIMARY                   Enabled       = YES 
 Interface       = 4   
 Remote port     = SECONDARY                 Enabled       = YES 
 Remote group    = 3                         Addressing    = 2-BYTE  
 IP  Address     = 9.67.2.4                  Code level    = CURRENT
 

Local group
Indicates the local group number.

Group Name
Indicates the local group name.

Group Type
Indicates the local group type, which is point-to-point or multipoint.

Local port
Indicates whether the port is primary or secondary and its status, enabled or disabled.

Interface
Indicates the network or interface number of the local port. This number matches the number displayed using the Config list devices command.

Remote port
Indicates whether the remote port is primary or secondary and its status, enabled or disabled.

Remote group
Indicates the group number of the remote group.

Addressing
Indicates whether one-byte or two-byte addressing is used.

IP address
Indicates the internal IP address of the remote router for this group. It identifies the IP tunnel that connects the router to the remote router.

Code level
Indicates the code level, whether current or migration. The code level determines the range of numbers that can be used to identify the groups. Current code level has a range of 1 to 255; migration code level has a range of 0 to 15.

group group#
Displays the configuration of a specified group.

Set

Use the set command to configure the SRLY interface parameters.

Syntax:

set
cable
 
clocking
 
encoding
 
frame-size
 
idle
 
speed
 
transmit-delay

cable
Sets the cable used on the serial interface. The options are:

A DTE cable is used when you are attaching the router to some type of DCE device (for example, a modem or a DSU/CSU).

A DCE cable is used when the router is acting as the DCE and providing the clocking for direct attachment.

clocking internal or external
To connect to a modem or DSU, configure external clocking and select the appropriate DTE cable with the set cable command.

To connect directly to another DTE device, configure internal clocking, select the appropriate DCE cable with the set cable command, and configure the clocking/line speed with the set speed command.

Default: external

Example:
set clocking internal

encoding nrz or nrzi
Configures the SRLY interface's encoding scheme as NRZ (Non-Return to Zero) or NRZI (Non-Return to Zero Inverted). NRZ is the default.

Example:
set encoding nrz

frame-size
Configures the maximum size of the frames that can be transmitted and received on the data link. If this value is set to a larger value than that specified with the add remote-secondary command, then this value is changed to reflect that maximum. The IBM 2212 generates an ELS message warning the user that this value is changing. The user will continue receiving this ELS message until it is changed in the SRAM configuration. Valid entries are shown in Table 53.
Note:The frame size must be large enough to accommodate the largest frame received plus a 15-byte SRLY header.

Table 53. Valid Values for Frame Size in Set Frame-Size Command
Minimum Maximum Default
128 8187 2048

idle flag
Configures the transmit idle state for framing on the SRLY interface. The default is the flag option which provides continuous flags (7E hex) between frames.

The link will receive a flag idle transparently.

idle mark
Configures the transmit idle state for framing on the SRLY interface. The mark option puts the line in a marking state (OFF, 1) between frames.

The link will receive a mark idle transparently.

speed

For internal clocking, use this command to specify the speed of the transmit and receive clock lines.

For external clocking, this command does not affect the operation of the WAN/serial line.

Valid Values:
Internal Clocking: 2400 to 2 048 000 bps
External Clocking: 2400 to 6 312 000 bps
Note:If you want to use a line speed greater than 2 048 000 bps when external clocking is configured, you can only do this on:

  • port 1 of the integrated WAN ports

  • port 1 of the 4-port WAN CPCI or PMC adapter

All other WAN ports on the same adapter must be clocked at 64 000 bps or less.

transmit-delay value
Allows the insertion of a delay between transmitted packets. This command ensures a minimum delay between frames so that it is compatible with older, slower serial devices at the other end. This value is specified as the number of flag bytes that should be sent between consecutive frames. The range is 0 - 15. The default is 0.

Accessing the SDLC Relay Monitoring Environment

To monitor information related to the SDLC Relay interface, access the interface monitoring process by doing the following:

  1. Enter the status command to find the PID for GWCON. (See page *** for sample output of the status command.)

  2. At the OPCON prompt, enter the talk command and the PID for GWCON. For example:
    * talk 5
    +
    

    The GWCON prompt (+) is displayed on the console. If the prompt does not appear when you first enter GWCON, press Return again.

  3. At the GWCON prompt, enter the configuration command to see the protocols and networks for which the router is configured. For example:
    + configuration
    

    See page "Configuration" for more sample output from the configuration command.

  4. Enter the protocol sdlc command. For example:
    + prot sdlc
    SDLC Relay>
    

    The SDLC Relay prompt is displayed on the console. You can then view information about the SDLC Relay groups by entering the SDLC Relay monitoring commands.


SDLC Relay Monitoring Commands

This section summarizes and then explains the SDLC Relay monitoring commands. The SDLC Relay monitoring commands allow you to view parameters for interfaces transmitting SDLC Relay frames. Some of these commands, such as enable and disable also take effect operationally, but they do not affect the configuration. The SDLC Relay> prompt is displayed for all SDLC Relay monitoring commands. Table 54 shows the commands.

Table 54. SDLC Relay Monitoring Commands Summary
Command Function
? (Help) Displays all the commands available for this command level or lists the options for specific commands (if available). See "Getting Help".
 Clear-Port-Statistics   Clears SDLC Relay statistics for the specified port. 
 Disable   Temporarily suppresses groups and ports. 
 Enable   Temporarily turns on groups and ports. 
 List   Displays entire SDLC Relay and group specific configurations. 
Exit Returns you to the previous command level. See "Exiting a Lower Level Environment".

Clear-Port-Statistics

Use the clear-port-statistics command to discard the SDLC Relay statistics for all ports. The statistics include counters for packets forwarded and packets discarded.

Syntax:

clear-port-statistics

clear-port-statistics
Clears port statistics gathered since the last time you restarted the router or cleared statistics.

Example:

clear-port-statistics
Clear all port statistics? (Yes or No): Y

Disable

Use the disable command to suppress data transfer for an entire group or a specific relay port. SRAM (static read access memory) does not permanently store the effects of the disable monitoring command. Therefore when you restart the router, the effects of this command are erased.

Syntax:

disable
group . . .

 
port

group group#
Suppresses transfer of SDLC Relay frames to or from the specified local group (group#).

port
Suppresses transfer of SDLC Relay frames to or from the specified local or remote port.

Enable

Use the enable command to turn on data transfer for an entire group or a specific local interface port. SRAM does not permanently store the effects of the enable monitoring command. Therefore when you restart the router, the effects of this command are erased.

Syntax:

enable
group . . .

 
port

group group#
Allows transfer of SDLC Relay frames to or from the specified local group (group#).

port
Allows transfer of SDLC Relay frames to or from the specified local or remote port.

List

Use the list command to display the configuration of a specific group or of all groups.

Syntax:

list
all

 
group . . .

all
Displays the configurations of all local ports.

Example:

list all
SDLC/HDLC Relay Configuration
 
 
 Local group     = 1  
 
 Group Name      = CHICAGO-TO-MIAMI                              
 Group Type      = MULTI                     Enabled       = YES
 Local port      = PRIMARY                   Enabled       = YES
 Interface       = 2   
 Remote port     = SECONDARY                 Enabled       = YES
 Remote group    = 1                         Addressing    = 2-BYTE
 IP Address      = 9.67.2.3                  Code level    = CURRENT
 
 Local group     = 2 
 Group Name      = CHICAGO-TO-RALEIGH
 Group Type      = MULTI                     Enabled       = YES 
 Local port      = PRIMARY                   Enabled       = YES
 Interface       = 3  
 Remote port     = SECONDARY                 Enabled       = YES 
 Remote group    = 2                         Addressing    = 2-BYTE
 IP Address      = 9.67.2.3                  Code level    = CURRENT
 
 Local group     = 3  
 Group Name      = CHICAGO-TO-PITTSBURGH 
 Group Type      = PT-PT                     Enabled       = YES 
 Local port      = PRIMARY                   Enabled       = YES 
 Interface       = 4   
 Remote port     = SECONDARY                 Enabled       = YES 
 Remote group    = 3                         Addressing    = 2-BYTE  
 IP  Address     = 9.67.2.4                  Code level    = CURRENT
 

Local group
Indicates the local group number.

Group Name
Indicates the local group name.

Group Type
Indicates the local group type, which is point-to-point or multipoint.

Local port
Indicates whether the port is primary or secondary and its status, enabled or disabled.

Interface
Indicates the network or interface number of the local port. This number matches the number displayed using the Talk 6 list devices command or the Talk 5 config command.

Remote port
Indicates whether the remote port is primary or secondary and its status, enabled or disabled.

Remote group
Indicates the group number of the remote group.

Addressing
Indicates whether one-byte or two-byte addressing is used.

IP address
Indicates the internal IP address of the remote router for this group. It identifies the IP tunnel that connects the router to the remote router.

Code level
Indicates the code level, whether current or migration. The code level determines the upper limit of the range of numbers that can be used to identify the groups.

group group#
Displays the configurations of a specified group.

SDLC Relay Interfaces and the GWCON Interface Command

While SDLC Relay interfaces have their own monitoring processes for monitoring purposes, the router also displays complete statistics for installed network interfaces when you use the interface command from the GWCON environment. (For more information on the interface command, refer to "The Operating/Monitoring Process (GWCON - Talk 5) and Commands".)


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]