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.
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.
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.
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".
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:
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.
If the parameter is set to "TR"...
If the parameter contains a sequence of hexadecimal characters, it will be set in the XID frame sent.
This parameter is meaningful only for Master ports, therefore when the parameter ROLE: is set to "PRI".
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").
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.
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 |
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.
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) |
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.