[Digital logo]
[HR]

DECnet-Plus
Network Control Language Reference

Previous | Contents

Argument:
link halted reason Reason why the LAPB protocol entered the halted state.
disc Link halt caused by remote end.
dm Link halt caused by remote end.
fbit error Link halt caused by remote end.
frmr Link halt caused by remote end.
implementation specific Link halt caused by implementation-specific error.
local Link halt due to local management action.
maximum retry Link halt due to the number of retries reaching the maximum specified in the characteristic retry maximum.
physical Link halt due to failure of the Physical layer.
unsolicited ua Link halt caused by remote end.
user Initialization was result of local user action.
window error Link halt caused by remote end.

link initializing

Generated when the protocol has been successfully initialized or reinitialized.

Argument:
link initializing reason Reason why the LAPB protocol entered the initializing state.

The reasons are the same as described for the link halted reason argument for the link halted event.

link inoperative

Generated when the status attribute protocol state is set to inoperative.

link maintenance

Generated when the status attribute protocol state is set to maintenance.

link resetting

Generated when the LAPB protocol is being reset successfully.

Argument:
link resetting reason Reason why the link is resetting.
fbit error Link reset caused by remote end.
frmr Link reset caused by remote end.
implementation specific Link reset is due to implementation-specific error.
maximum retry Link reset due to the number of retries reaching the value specified in the characteristic retry maximum.
sabm Link reset caused by remote end.
unsolicited ua Link reset caused by remote end.
window error Link reset caused by remote end.

link running

Generated when the LAPB protocol has been initialized successfully and the status attribute protocol state has been set to running.

link setup failed

Generated when the LAPB protocol has failed to initialize correctly after the maximum number of allowed attempts.

link state changed

Generated for each link state transition. The link state shows the new link state.

Argument:
final state The new setting of the state attribute (on or off).

pdu receive overrun

Generated each time the underlying physical layer indicates that a receive overrun has been detected.

pdu transmit failed

Generated when a call to transmit a frame at the Physical layer via the internal framing interface fails.

Argument:
pdu transmit failure reason Failure reason returned by the Physical layer.
disabled The line has been disabled by network management action.
line down The line is in the failed state.
no service The Physical layer service is not available.

13.2.7 Exception Messages

For enable:

client data size not supportable

The data size specified on opening the port cannot now be supported.

incompatible communications mode

The protocol cannot be operated because of an incompatible line.

Argument:
reason Reason why the line is incompatible with the protocol.
asynchronous mode The physical line does not support asynchronous mode.
crc not supported The physical line does not support the physical link for CRC operation.
half-duplex mode The physical line needs to be in full-duplex mode.

open physical port failed

The open port failed at the Physical layer.

Argument:
reason Reason why the open port failed.
insufficient resources A physical port cannot be created due to a lack of system resources.
invalid argument An illegal data type or value was supplied to the called routines.
line not available The physical line has already been assigned to another port.
no such physical line A physical line having the specified name does not exist.

13.3 lapb port

A lapb port entity represents an access point for LAPB module clients to Data Link layer services. The port-name refers to the port managed by this command.
show [node node-id] lapb port port-name [all [attributes] | all identifiers | all status ]

13.3.1 Identifier Attributes

name

Simple name assigned to the port when it is created.

13.3.2 Status Attributes

client name

Name of the client with which the port is associated.

link

Name of the link with which the port is associated.

state

State of the lapb port entity.
open The port is assigned to a client.
open disabled The port is assigned to a client, but the associated link is disabled.

type

Type of port.
sequenced The port is used for sending LAPB data.
unsequenced The port is used for sending loopback data. This is only possible if the maintenance mode characteristic of the relevant lapb link entity is set to true.

Chapter 14
LLC2 Module

This chapter describes all the commands you can use to manage the entities that constitute the LLC2 module. The LLC2 module implements one of the protocols in the Data Link layer described by the Digital Network Architecture (DNA).

Figure 14-1 shows the hierarchical relationship of the entities that constitute the LLC2 module.

Figure 14-1 Hierarchy of LLC2 Module Entities

14.1 llc2

The llc2 entity is the top-level entity in the LLC2 module hierarchy of entities. The LLC2 module controls the operation of the logical link control (LLC) Type 2 data link protocol for local area networks (LANs).
create [node node-id] llc2
delete [node node-id] llc2
show [node node-id] llc2 [all [attributes] | all characteristics ]

14.1.1 Characteristic Attributes

version

Version number of the DNA LLC2 architecture to which this implementation conforms. You cannot modify this characteristic. To display this attribute, specify all or version.

14.2 llc2 port

An llc2 port entity represents an access point to the services offered to clients by the LLC2 module. The simple-name refers to the port managed by this command.
show [node node-id] llc2 port simple-name [all [attributes] | all identifiers | all status ]

14.2.1 Identifier Attributes

name

Simple name assigned to the port when it is created.

14.2.2 Status Attributes

client

Name of the client that opened the port.

link name

Name of the llc2 sap link entity with which this port is associated.

state

State of the llc2 port entity.
open The port is assigned to a client and is enabled.
open disabled The port is assigned to a client but is disabled.

14.3 llc2 sap

Each llc2 port entity has an llc2 sap (service access point) entity associated with it. An llc2 sap entity allows links to be multiplexed over its associated port.
create [node node-id] llc2 sap simple-name
delete [node node-id] llc2 sap simple-name
disable [node node-id] llc2 sap simple-name
enable [node node-id] llc2 sap simple-name
set [node node-id] llc2 sap simple-name {lan station local-entity-name | local lsap address hex-number }
show [node node-id] llc2 sap simple-name [all [attributes] | all characteristics | all counters | all status | all identifiers ]

14.3.1 Characteristic Attributes

lan station

Default: No entity name Value: Local-entity-name
Name of the LAN station entity used by the SAP. You must specify a value for this attribute before you enable the SAP.

local lsap address

Default: 7E Value: Hex-number
Address of the local link service access point (LSAP) to be used. The lowest significant bit of this value must be clear; that is, the address must be an individual address.

14.3.2 Counter Attributes

creation time

Time at which this entity was created.

times sap state changed

Number of times the status attribute state has changed from on to off, or from off to on.

14.3.3 Identifier Attributes

name

Simple name assigned to the llc2 sap when it is created.

14.3.4 Status Attributes

lan port

Name of the LAN port that is opened and enabled when this SAP is successfully enabled. If the SAP is not enabled, this status has a null value.

maximum pdu size

Largest frame size, in octets, that can be used to send or receive data on this SAP.

state

State of the llc2 sap entity.
off The SAP is disabled.
on The SAP is enabled.

uid

Entity's unique identifier, which is generated when the entity is created.

14.3.5 Event Messages

sap state changed

Generated when the status attribute state changes from on to off, or from off to on.

Argument:
new sap state New state of the SAP.

14.3.6 Exception Messages

For enable:

enable lan port failed

The LAN port could not be enabled.

Argument:
reason Specifies why the enable command failed.
invalid argument Software error.
insufficient resources There are insufficient system resources to enable the port.
SAP address not available The SAP address specified by the LSAP (local service access point) address characteristic is already being used, or is invalid.

link data size not supportable

The data size specified by the maximum data size characteristic of one of the sap link entities cannot be supported by the SAP.

open lan port failed

A LAN port could not be opened.

Argument:
reason Why the port could not be opened.
invalid argument Software error.
insufficient resources There are insufficient system resources to open the port.
LAN station not available The LAN station specified by the lan station characteristic is not usable.
no such LAN station The LAN station specified by the lan station characteristic does not exist.

14.4 llc2 sap link

An llc2 sap link entity represents one of the links that operates over a particular SAP (service access point).
create [node node-id] llc2 sap link simple-name link simple-name
delete [node node-id] llc2 sap link simple-name link simple-name
disable [node node-id] llc2 sap link simple-name link simple-name
enable [node node-id] llc2 sap link simple-name link simple-name
set [node node-id] llc2 sap link simple-name link simple-name {acknowledge timer milliseconds | busy timer milliseconds | holdback timer milliseconds | local receive window size integer | maximum data size octets | poll timer milliseconds | reject timer milliseconds | remote lsap address hex-number | remote mac address lan-address | retry maximum integer }
show [node node-id] llc2 sap link simple-name link simple-name [all [attributes] | all characteristics | all counters | all identifiers | all status ]

14.4.1 Characteristic Attributes

acknowledge timer

Default: 1000 Value: 1--60000
Time, in milliseconds, that the link waits for an acknowledgment before initiating recovery action. The granularity of this timer is 10 milliseconds. Values that are not multiples of 10 are rounded up.

busy timer

Default: 10000 Value: 1--60000
Time, in milliseconds, that the link waits for indication of the clearance of a busy condition at the remote station. The granularity of this timer is 10 milliseconds. Values that are not multiples of 10 are rounded up.

holdback timer

Default: 500 Value: 0--60000
Delay, in milliseconds, before an acknowledgment must be sent. The granularity of this timer is 10 milliseconds. Values that are not multiples of 10 are rounded up.

local receive window size

Default: 127 Value: 1--127
Window size used by the link for receiving frames.

maximum data size

Default: 1028 Value: 1--65531
Largest frame size, in octets, that the link can use to send or receive data. This value does not include the size of the frame header.

poll timer

Default: 1000 Value: 1--60000
Time, in milliseconds, that the link waits for a response with the F-bit set. The granularity of this timer is 10 milliseconds. Values that are not multiples of 10 are rounded up.

reject timer

Default: 3000 Value: 1--60000
Time, in milliseconds, that the link waits for a reply to a REJ (reject) frame. The granularity of this timer is 10 milliseconds. Values that are not multiples of 10 are rounded up.

remote lsap address

Default: 7E Value: hex-number
Address of the destination LSAP (link service access point) to be used by the link. The lowest significant bit must be clear; that is, the address must be an individual address.

remote mac address

Default: 00-00-00-00-00-00 Value: lan-address
Destination MAC address to be used by the link. The lowest significant bit of the first octet must be clear; that is, the address must be an individual address.

retry maximum

Default: 10 Value: 1--255
Maximum number of times that the link retransmits a frame before assuming a fatal error and taking more drastic recovery action.

14.4.2 Counter Attributes

creation time

Time at which this entity was created.

data octets received

Number of data octets received in I-frames and UI-frames from the remote end of the link. This value does not include data octets in retransmissions.

data octets sent

Number of data octets transmitted in I-frames and UI-frames to the remote end of the link. This value does not include data octets in retransmissions.

data pdus received

Number of I-frames and UI-frames received from the remote end of the link. This value does not include retransmissions.

data pdus sent

Number of I-frames and UI-frames transmitted to the remote end of the link. This value does not include retransmissions.

frmrs received

Number of FRMR (frame reject) frames received.

frmrs sent

Number of FRMR (frame reject) frames generated as a result of invalid incoming frames.

polls received

Number of command frames received with the P-bit set.

rejs received

Number of REJ (reject) frames received.

rejs sent

Number of REJ (reject) frames transmitted.

rnrs received

Number of RNR (receive not ready) frames received.

rnrs sent

Number of RNR (receive not ready) frames transmitted.

times acknowledge timer expired

Number of times the local acknowledge timer has expired.

times busy timer expired

Number of times the local busy timer has expired.

times link halted

Number of times the link's status attribute protocol state was set to halted.

times link initializing

Number of times the link's status attribute protocol state was set to initializing.

times link inoperative

Number of times the link's status attribute protocol state was set to inoperative.

times link resetting

Number of times the link's status attribute protocol state was set to resetting.

times link running

Number of times the link's status attribute protocol state was set to running. When the link enters the running state, the protocol has been successfully initalized or reset.

times link setup failed

Number of times the LLC2 protocol fails to initialize correctly after the maximum number of retries.

times link state changed

Number of times the link's status attribute STATE changed from on to off, or from off to on.

times poll timer expired

Number of times the local poll timer has expired.

times reject timer expired

Number of times the local reject timer has expired.

xids received

Number of XID frames received.

xids sent

Number of XID frames transmitted.

14.4.3 Identifier Attributes

name

Simple name assigned to the link when it is created.

14.4.4 Status Attributes

protocol state

State of the LLC2 protocol with respect to the remote station.
error The protocol is in a recognized error state.
halted The protocol has halted.
initializing The protocol is being initialized.
inoperative The protocol cannot be started because the LAN station cannot provide a connection to a remote system.
resetting The protocol is being reset.
running The protocol is running normally.

remote llc class

Class of the remote LLC.
1 Class 1 LLC. Only type 1 operation is supported.
2 Class 2 LLC. Both type 1 and type 2 operations are supported.
unknown The class has not yet been established. The class is not established until XID frames have been exchanged between the local and remote LLC implementations.

remote receive window size

Window size used by the remote station for receiving frames. The local station uses this value as its window for transmitting frames.

state

State of the llc2 link entity.
off The link is disabled.
on The link is enabled.

uid

Entity's unique identifier, which is generated when the entity is created.

14.4.5 Event Messages

frame reject generated

Generated when the receipt of a frame causes an FRMR (frame reject) frame to be generated and transmitted to the remote station.

Arguments:
frame Contents of the header of the frame that caused the FRMR frame to be generated.
frame reject reason Why the FRMR frame was rejected.
control A received control field is undefined or is not implemented.
format The frame contains an unallowed information field, or contains a supervisory or unnumbered field of incorrect length.
length A received information field exceeds the maximum length.
nr A received control field contains an invalid N(R).
ns A received control field contains an invalid N(S).
nonspecific The frame contains an unspecified number or type of errors.
generated frmr Contents of the generated FRMR frame that is sent to the remote station.

frame reject received

Generated when an FRMR (frame reject) frame is received from the remote station.

Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]

[HR] 

  NCL_PROFILE_012.HTML
  OSSG Documentation
   2-DEC-1996 12:48:03.27

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal