The SDLC (SDLC) ports

Configuration of the SDLC ports
Statistics of the SDLC ports
SNMP traps generated for the SDLC ports


The communication ports SDLC are used within the Abilis CPX for converting SDLC frames into QLLC ones and vice versa, according to the IBM specifications.

Configuration of the SDLC port top

The SDLC port is provided with the parameters described in this section.

Here is an example on how to display the SDLC port parameters. The shown values are the default ones.

[15:43:20] ABILIS_CPX: D P PO:321

PO:321 ------------------------------------------------------------------------
SDLC   lowpo:NONE  TYPE:USER     MCAU:NO   ps:2048   pvc:0     bsvc:0
       role:SEC    MAXOUT:7      T1:3000   T2:3000   T5:0      N2:7

If parameter PVC: and/or BSVC: are set to a value bigger than zero, the display will be the following (in the example BSVC:2):

[15:43:20] ABILIS_CPX: D P PO:321

PO:321 ------------------------------------------------------------------------
SDLC   lowpo:NONE  TYPE:USER     MCAU:NO   ps:2048   pvc:0     bsvc:2
       role:SEC    MAXOUT:7      T1:3000   T2:3000   T5:0      N2:7
       PU:0   add:01   PROT:QLLC  n1:2100  GEN:YES    SLOWPOLL:15   LOG:DS
              AC:NO    RTY:INC    TB:6     NRTY:NOMAX               

       PU:1   add:02   PROT:QLLC  n1:2100  GEN:YES    SLOWPOLL:15   LOG:NO
              AC:NO    RTY:INC    TB:6     NRTY:NOMAX

If parameter ROLE: is set to "PRI" the visualization will be:

[15:43:20] ABILIS_CPX: D P PO:321

PO:321 ------------------------------------------------------------------------
SDLC   lowpo:NONE  TYPE:USER     MCAU:NO   ps:2048   pvc:0     bsvc:2
       role:PRI    MAXOUT:7      T1:3000   T2:3000   T5:0      N2:7
       QTINFO:*
       PU:0   add:01   PROT:QLLC  n1:2100  GEN:YES    SLOWPOLL:15   LOG:DS
              AC:NO    RTY:INC    TB:6     NRTY:NOMAX               QTCHK:NO
              QXID:TR

       PU:1   add:02   PROT:QLLC  n1:2100  GEN:YES    SLOWPOLL:15   LOG:NO
              AC:NO    RTY:INC    TB:6     NRTY:NOMAX               QTCHK:NO
              QXID:TR

To activate changes made on the parameters displayed by low case characters, it is needed to restart the system; on the contrary for activating changes made on low case parameters it is enough to execute the initialisation command INIT PO:. Changes made on the parameter LOG:, of each Physical Unit, are immediately active.

Detail of the SDLC port parameters


LOWPO: Identifier of the Abilis CPX lower level port
NONE 1 - 999, NONE

It sets the Abilis CPX lower level port. It can only be a SYNC or PLINKE. port.

Value "NONE" isolates the SDLC port from the lower level ones.


TYPE: Port type
USER NETWORK, USER

This parameter is used for setting how the port has to behave if data compression is active.

The port connected to the X.25 network is defined NETWORK port; the one connected to the user equipment USER port.

The NETWORK port sends compressed data and expands the received ones; the USER port compresses the received data and sends the expanded ones.

A configuration error of this parameter will cause the virtual channel to be teared down as soon as data are transmitted. If the user equipment detects the error, it will generate the X25 diagnostic code, while if the Abilis CPX will detect the error, it will tear down the virtual channel using the diagnostic codes F0,C2 (Expansion error) or F0,C3 (Compressed data format not valid) or F0,AA (Compression protocol not compatible).


MCAU: Cause code modification in CLEAR packets sent
NO YES, NO

If MCAU is set to NO, Abilis CPX transports, without any changes, the cause and diagnostic code of the CLEAR packets; it also uses the F0 cause code and the suitable diagnostic one for all the CLEAR packets internally generated.

If MCAU is set to YES, Abilis CPX forces the cause code of the CLEAR packet sent to the value 00 (DTE originated), either for the external CLEAR and the internal ones.

warning! The changes made on this parameter are immediately activated, without the need of initialisation commands.


PS: Maximum packet size (bytes)
2048 16, 32, 64, 128, 256, 512, 1024, 2048

It sets the maximum size (bytes) of packets to be sent or received.


PVC: Number of permanent connections
0 0 - 16

It sets the number of PVC connections.


BSVC: Number of bidirectional switched connections
0 0 - 16

It sets the number of BSVC connections.


ROLE: Port role
SEC SEC, PRI

It sets the port role: Master or Slave.

Value Meaning
PRI The Master port controls the connection establishment and polls all the PU configured
SEC The slave port can only send data after being polled by a SDLC station


MAXOUT: Maximum number of unacknowledged frames
7 1 - 7

It sets the maximum number of frames to be sent without receiving their acknowledgement.

This value is common to all the PU configured.


T1: Longest idle interval in NRM mode
3000 100 - 65535 (milliseconds)

It sets the longest time interval for waiting a polling response in NRM mode (Normal Response Mode).

This parameter is meaningful only for Master ports, therefore when the parameter ROLE: is set to "PRI".


T2: Longest idle interval in NDM mode
3000 100 - 65535 (milliseconds)

It sets the longest time interval for waiting a polling response in NDM mode (Normal Disconnect Mode).

This parameter is meaningful only for Master ports, therefore when the parameter ROLE: is set to "PRI".


T5: Polling interval
0 100 - 65535 (milliseconds)

It sets the time interval between sending a polling frame and its successive ones.

This parameter is meaningful only for Master ports, therefore when the parameter ROLE: is set to "PRI".


N2: Maximum number of frame repetitions
7 0 - 99

It sets the maximum number of consecutive retransmission of the same frame.


QTINFO: Informative string for the QLLC TEST frames (Only if ROLE:PRI)
* *, from 1 up to 10 hexadecimal digits

It sets the informative string accepted in the QLLC TEST frames. The value "*" (asterisk) stands for "any string", allowing to accept QLLC TEST frames with any value of the informative strings.

This parameter is meaningful only for Master ports, therefore when the parameter ROLE: is set to "PRI".

Detail of the parameter of the Physical Units SDLC


PU: Identifier of the Physical Unit
NONE 0 - 15

It sets the identifier of the PU SDLC.


ADD: Address of the Physical Unit
0x00 0x00 - 0xFE

It sets the address of the PU SDLC.

The value "0x00" is used to disable the PU, in this way it is not activated by the SDLC port.


PROT: Conversion protocol type
QLLC QLLC, QLLC2, QSYNC

It sets the conversion protocol type to apply.


N1: Maximum length of the SDLC frame (Flags and CRC not included)
2100 128 - 2100 bytes

It sets the maximum length of the SDLC frame (Flags and CRC not included).


GEN: DISC/DM frame generation
YES NO, YES

It enables the generation of DISC/QDICS or DM/QDM frames.

If the parameter is set to "NO", the driver never generates this kind of frame, but it is only received from outside and managed.


SLOWPOLL: Polling interval for the auto-connection procedure
15 1 - 255 (in seconds)

It sets the waiting interval between a connection attempt and its successive one.

This parameter is used by the auto-connection procedure only if the parameter AC: is set to "TEST" or "XID" or "SDLC" or "POLL".


LOG: Events logging activation and generation of alarm signals
DS NO, D, S, A, L, T, ALL, +E

Usually this parameter makes possible to activate/deactivate logging functionalities of meaningful events of the port as well as the detection and signalling of alarms in case of critical events.

The following table shows the available options and the related functionalities usable by the parameter:

Option Meaning
D Recording of the driver state changes and/or the meaningful events in Debug Log
S Recording of the driver state changes and/or the meaningful events in the System Log
A Periodic detection of possible alarms. The detected alarms can be displayed the command ALARM VIEW or by the analogous command available on the UTILITY of the LCD display on the front panel
L On alarm detection, acoustic signal generation plus a message on the LCD display. This function depends on activation of alarms detection by the "A" option
T Generation by the Agent SNMP of Abilis CPX of SNMP traps corresponding to any change of the driver state and/or occurring of meaningful events

Beside the already described options the following values are also allowed:

Option Meaning
NO It means that all the logging functionalities, alarms detection and generation, above mentioned, are disabled.
ALL It means that all the logging functionalities, alarms detection and generation, above mentioned, are enabled.
+E This option added to one or more of the previous ones, extends its (their) set of meaningful events.
The value "ALL+E" activates all the options and extends the set of meaningful events.
The value "NO+E" is meaningless so it is ignored.

Options can be combined together.

Some examples:

By using the characters "+" and "-" as prefix of one or more options is possible to add or delete one or more functionalities without setting from the scratch the value of the parameters.

Some examples:

warning! The changes made on this parameter are immediately activated, without the need of initialization commands.


AC: Auto-connection mode
NO NO, DCD; TEST, XID, SNRM, POLL

It selects the auto-connection mode.

Value Meaning
NO No auto-connection procedure is applied
DCD This auto-connection procedure automatically generates a called whenever the driver leaves the "DOWN" state and reaches the "UP" one. If the call is unsuccessful the port will repeat the call as many times as the value of the parameter RTY:.
TEST
XID
SNRM
POLL
The "autoconnection" procedure is applied as in the "DCD" case, however there are some differences, depending on the port role: - Master: before call generation an unnumbered frame specified (TEST or XID or SNRM or POLL) is sent. If no the acknowledgement frame is not received within the time interval specified in the parameter T2:, the port will wait until the time interval, specified in the parameter SLOWPOLL:, elapses and then start again the procedure. - Slave: before call generation the port has to receive an unnumbered specified frame (TEST or XID or SNRM or POLL).


RTY: Calls repetition mode
INC LIN, INC

It allows to select the calls repetition mode.

Value Meaning
LIN The time interval to wait, between a call attempt and the successive one, is fixed and configurable through the parameter TB:
INC The time interval to wait, between a call attempt and the successive one, is doubled at every attempt starting from the value defined in the parameter TB:


TB: Time interval between calls repetitions
6 6 - 255 seconds

It defines the smallest time interval to be waited between a call attempt and its successive one.


NRTY: Maximum number of call repetitions
0 0 - 65534, NOMAX

It specifies the maximum number of call repetitions:

Value Description
0 No call is made
NOMAX Calls are repeated indefinitely
1 - 65534 Calls are repeated as many times as the configured value


QTCHK: Activation of the control function of the QLLC TEST frames (Only if ROLE:PRI)
NO NO, YES

It activates the control function of the QLLC TEST frames.

This parameter is meaningful only for Master ports, therefore when the parameter ROLE: is set to "PRI".


QXID: Response string for the QLLC XID frames (Only if ROLE:PRI)
TR from 1 up to 15 hexadecimal digits, TR

It sets a sequence of hexadecimal characters to send in the QLLC XID.

This parameter is meaningful only for Master ports, therefore when the parameter ROLE: is set to "PRI".

Statistics of the SDLC ports top

How to check state and statistics of the SDLC ports through the command D S.

[15:43:20] ABILIS_CPX: D S PO:322 .

PO:322 ------------------------------------------------------------------------
SDLC   STATE:N/A
       ------------------------- SDLC PU diagnostics --------------------------
       Pu0 Pu1 Pu2 Pu3 Pu4 Pu5 Pu6 Pu7 Pu8 Pu9 Pu10 Pu11 Pu12 Pu13 Pu14 Pu15
        00  00  00  00  00  00  00  00  00  00   00   00   00   00   00   00
         F   F   F   F   F   F   F   F   F   F    F    F    F    F    F    F
       ------------------------------------------------------------------------
       (QLLC: 0=Down; 1=Ready; 2,3,5=Connected; 7=Calling; 8=Delay; 9=Stopped)
       (PU  : 2=Disconnected(NDM); 3=Connecting; 5=Connected(NRM); F=N/A)
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       T3-EXP     |           |0          |UNK-ADD    |0          |           |
       SHORT      |0          |0          |
       ------------------------------------------------------------------------

Extended statistics are available for SDLC ports, here is an example of the command D SE execution:

[15:43:20] ABILIS_CPX: D SE PO:321 .

PO:321 ------------------------------------------------------------------------
SDLC   --- Cleared 004:22:08:51 ago, at 21/05/1999 11:36:46 -------------------
       Pu:0     Add:01                    LAST-UNN-FRAMES IN:00  OUT:00
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       UNK-FRM    |0          |0          |T2-EXP     |0          |           |
       T1-EXP     |           |0          |N2-OVR     |           |0          |
       REP        |0          |0          |INFO       |0          |0          |
       CHAR       |0          |0          |RR         |0          |0          |
       RNR        |0          |0          |REJ        |0          |0          |
       FRMR       |0          |0          |SNRM       |0          |0          |
       UA         |0          |0          |DISC       |0          |0          |
       RD         |0          |0          |DM         |0          |0          |
       TEST       |0          |0          |XID        |0          |0          |
       ------------------------------------------------------------------------  
       Pu:1     Add:02                    LAST-UNN-FRAMES IN:00  OUT:00
       -----------|---INPUT---|--OUTPUT---|-----------|---INPUT---|--OUTPUT---|
       UNK-FRM    |0          |0          |T2-EXP     |0          |           |
       T1-EXP     |           |0          |N2-OVR     |           |0          |
       REP        |0          |0          |INFO       |0          |0          |
       CHAR       |0          |0          |RR         |0          |0          |
       RNR        |0          |0          |REJ        |0          |0          |
       FRMR       |0          |0          |SNRM       |0          |0          |
       UA         |0          |0          |DISC       |0          |0          |
       RD         |0          |0          |DM         |0          |0          |
       TEST       |0          |0          |XID        |0          |0          |
       ------------------------------------------------------------------------

The information "Cleared DDD:HH:MM:SS ago, at DD/MM/YYYY HH:MM:SS", referred by the extended statistics, shows the time interval elapsed from the last reset of statistics (by the format "days:hours:minutes:seconds") and date/time of its execution (by the format "day:month:year" and "hours:minutes:seconds").

Detail of the state fields and statistics of the SDLC ports


Current state of the SDLC driver
N/A

The SDLC port state is not available, that's why the value "N/A" will be always shown.


T3-EXP: Number of times the "T3" polling timeout ran over
0 - 4.294.967.295

The counter "T3" is incremented every time the "T3" polling timeout, expected for Slave stations in case of NRM, runs over.


UNK-ADD: Number of received frames with unknown address
0 - 4.294.967.295

The counter UNK-ADD is incremented every time a frame, whose address is unknown, is received.


SHORT: Number of too short frames received
0 - 4.294.967.295

The counter SHORT (INPUT) is incremented every time the SDLC driver receives too short frames. The counter SHORT (OUTPUT) is incremented every time the SDLC driver receives, from the upper level, frames too short.

Detail of the state fields of the Physical Unit SDLC


PuXX: Identifier of the PU SDLC
Pu0, Pu1, Pu2, …, Pu15

Identifier of the PU SDLC.


YY: Address of the PU SDLC
0x00 - 0xFE

Address of the PU SDLC.

The value "0x00" is used to disable the PU. A PU is active only if its address is not 0x00.


Z: Current state of the PU SDLC
0, 1, 2, 3, 5, 7, 8, 9, F

It shows the numeric value correspondent to the current state of the Physical Unit:

Driver States Meaning Values shown in:
System Log Debug Log Display LCD
SDLC (Physical Unit) 0 The QLLC is in the DOWN state, it cannot receive or make calls dn dn  
1 The QLLC is in the READY state, it can receive or make calls
2 The QLLC is in the CONNECTED state, the PU in the DISCONNECTED one (Normal Disconnect Mode)
3 The QLLC is in the CONNECTED state, the PU in the CONNECTING one
7 The QLLC is in the CALLING state
8 The QLLC is in the DELAY state, it can receive calls
9 The QLLC is in the STOPPED state, it can receive calls st st  
5 The QLLC is in the CONNECTED state, the PU in the CONNECTED one CN CN  
F It identifies a not active, not available PU NA NA  

Detail of the extended statistics of the Physical Unit SDLC


Pu: Identifier of the Physical Unit SDLC
0 - 15

Identifier of the Physical Unit SDLC.


Add: Address of the Physical Unit SDLC
0x00 - 0xFE

Address of the Physical Unit SDLC.

The value "0x00" is used to disable the PU. A PU is active only if its address is not 0x00.


LAST-UNN-FRAMES: Control field of the last unnumbered frame received/sent
0x00 - 0xFF

The field LAST-UNN-FRAMES IN shows the content of the control field of the last unnumbered frame received, while the LAST-UNN-FRAMES OUT shows the one of the last unnumbered frame sent.


UNK-FRM: Number of received frames with unknown address
0 - 4.294.967.295

The counter UNK-FRM is incremented every time a frame, whit address unknown, is received.


T2-EXP: Number of times that "T2:" timeout ran over
0 - 4.294.967.295

The counter T2-EXP (INPUT) is incremented every time the timeout, configured in the parameter T2:, run over.


T1-EXP: Number of times that "T1:" timeout ran over
0 - 4.294.967.295

The counter T1-EXP (INPUT) is incremented every time the timeout, configured in the parameter T1:, run over.


N2-OVR: Number of times the maximum retransmission number has been reached
0 - 4.294.967.295

The counter N2-OVR (OUTPUT) is incremented every time the maximum number of retransmission, set in the parameter N2:, is reached.


REP: Number of repeated frame sent/received
0 - 4.294.967.295

The counter REP (INPUT) is incremented every time the Abilis CPX receives a repeated frame, while the counter REP (OUTPUT) every time a sent frame is repeated.


INFO: Number of INFO frames received/sent
0 - 4.294.967.295

The counter INFO (INPUT) is incremented every time an INFO frame is received. The counter INFO (OUTPUT) is incremented every time an INFO frame is sent.


CHAR: Number of characters received/sent
0 - 4.294.967.295

The counter INFO (INPUT) is incremented every time an INFO frame is received. The counter INFO (OUTPUT) is incremented every time an INFO frame is sent.


RR: Number of RR frames received/sent
0 - 4.294.967.295

The counter RR (INPUT) is incremented every time a RR frame is received, while the counter RR (OUTPUT) every time a RR frame is sent.


RNR: Number of RNR frames received/sent
0 - 4.294.967.295

The counter RNR (INPUT) is incremented every time a RNR frame is received, while the counter RNR (OUTPUT) every time a RNR frame is sent.


REJ: Number of REJ frames received/sent
0 - 4.294.967.295

The counter REJ (INPUT) is incremented every time a REJ frame is received, while the counter REJ (OUTPUT) every time a REJ frame is sent.


FRMR: Number of FRMR frames received/sent
0 - 4.294.967.295

The counter FRMR (INPUT) is incremented every time Abilis CPX receives a FRMR frame, while the counter FRMR (OUTPUT) every time a FRMR frame is sent.


SNRM: SNRM frames received/sent
0 - 4.294.967.295

The counter SNRM (INPUT) is incremented every a SNRM frame is received, while the counter SNRM (OUTPUT) every time a SNRM frame is sent.


UA: Number of UA frames received/sent
0 - 4.294.967.295

The counter UA (INPUT) is incremented every time a UA frame is received, while the counter UA (OUTPUT) every time a UA frame is sent.


DISC: Number of DISC frames received/sent
0 - 4.294.967.295

The counter DISC (INPUT) is incremented every time a DISC frame is received, while the counter DISC (OUTPUT) every time a DISC frame is sent.


RD: Number of RD frames received/sent
0 - 4.294.967.295

The counter RD (INPUT) is incremented every time a RD frame is received, while the counter RD (OUTPUT) every time a RD frame is sent.


DM: Number of DM frames received/sent
0 - 4.294.967.295

The counter DM (INPUT) is incremented every time a DM frame is received, while the counter DM (OUTPUT) every time a DM frame is sent.


TEST: Number of TEST frames received/sent
0 - 4.294.967.295

The counter TEST (INPUT) is incremented every time a TEST frame is received, while the counter TEST (OUTPUT) every time a TEST frame is sent.


XID: Number of XID frames received/sent
0 - 4.294.967.295

The counter XID (INPUT) is incremented every time a XID frame is received, while the counter XID (OUTPUT) every time a XID frame is sent.

SNMP traps generated for the SDLC ports top

The SNMP Agent of the Abilis CPX sends traps in correspondence of meaningful state changes relating to the Physical Unit of the SDLC ports.

Trap own code Trap mnemonic SNMP variables shown in the trap Description
24 cxTrapSdlcPuDown cxPortIndex, cxPortType, cxSdlcDiagPuIndex, cxSdlcDiagPuAddr, cxSdlcDiagPuState, sysUpTime The SNMP Agent of the Abilis CPX generates this kind of trap every time the Physical Unit SDLC reaches the DOWN state
25 cxTrapSdlcPuStopped cxPortIndex, cxPortType, cxSdlcDiagPuIndex, cxSdlcDiagPuAddr, cxSdlcDiagPuState, sysUpTime The SNMP Agent of the Abilis CPX generates this kind of trap every time the Physical Unit SDLC reaches the STOPPED state
26 cxTrapSdlcPuConnectedNRM cxPortIndex, cxPortType, cxSdlcDiagPuIndex, cxSdlcDiagPuAddr, cxSdlcDiagPuState, sysUpTime The SNMP Agent of the Abilis CPX generates this kind of trap every time the Physical Unit SDLC reaches the CONNECTED state (Normal Response Mode)

Detail of the SNMP variables shown in the SDLC port traps


cxPortIndex SDLC port which the SNMP trap refers to
0 - 999

This variable stores the CPX port number, which the SNMP trap refers to.


cxPortType Type and description of the SDLC port, which the trap refers to
type - description

This variable shows either the port type which the trap refers to (in this case SDLC) and the description eventually associated to it.


cxSdlcDiagPuIndex PU identifier of the SDLC port which the trap refers to
0 - 15

PU identifier of the SDLC port which the trap refers to.


cxSdlcDiagPuAddr PU address of the SDLC port which the trap refers to
0x00 - 0xFE

PU address of the SDLC port which the trap refers to.


cxSdlcDiagPuState PU current state of the HDLCT port which the trap refers to
qllcDown(0), qllcReday(1), qllcConnected-PuDisconnected(2), qllcConnected-PuConnecting(3), qllcConnected-PuConnectedNRM(5), qllcCalling(7), qllcDelay(8), qllcStopped(9), not-available(15)

This variable shows the current state of Physical Unit SDLC which the trap refers to. The following table shows the relationship among the state value stored in the SNMP variable and the ones obtained executing the command D S.

Value of the SNMP variable Correspondent state of the PU SDLC
qllcDown(0) 0
qllcReday(1) 1
qllcConnected-PuDisconnected(2) 2
qllcConnected-PuConnecting(3) 3
qllcConnected-PuConnectedNRM(5) 5
qllcCalling(7) 7
qllcDelay(8) 8
qllcStopped(9) 9
not-available(15) F


sysUpTime Elapsed time from the system start to the event occurrence
0 - 4.294.967.295 or "ddd:hh:mm:ss"

This variable stores the elapsed time (in cent of second) from the system start to the SNMP trap event occurrence.

This value is usually shown by the format days:hours:minutes:seconds.

printPrint this page