DECnet-Plus
Network Control Language Reference

Arguments:

frmr Contents of the frame reject frame that is returned to the remote station.

frmr reason Reason for rejecting the frame.

control One of the control fields is undefined or not implemented by the local station.

format The frame's control field is invalid because the frame contained information that is not allowed, the frame is supervisory, or the frame is unnumbered and has the wrong length.

length The information field of the frame exceeds the maximum capacity.

nonspecific The received frame contains an unspecified number or type of error.

nr The frame's control field contains an invalid N(R).

received pdu Header of the frame that caused the generation of the event.

frmr received

Generated each time the remote station rejected a frame.

Arguments:

frmr Contents of the frame reject frame that is returned to the remote station.

frmr reason Reason for rejecting the frame.

control One of the control fields is undefined or not implemented by the local station.

format The frame's control field is invalid because the frame contained information that is not allowed, the frame is supervisory, or the frame is unnumbered and has the wrong length.

length The information field of the frame exceeds the maximum capacity.

nonspecific The received frame contains an unspecified number or type of error.

nr The frame's control field contains an invalid N(R).

received pdu Received FRMR that caused the generation of the event.

negotiation failed

Generated each time XID negotiation fails.

Arguments:

local xid The XID that the local station used during the failed negotiation.

negotiation failure reason Reason that negotiation with the remote station failed.

address id not unique The preferred addresses and the address-negotiation unique IDs were identical.

incompatible address modes The remote station wanted to use HDLC's extended addressing which the Digital Network Architecture's implementation does not support.

incompatible crc types Incompatible CRC types were specified by the two stations.

incompatible sequence moduli Incompatible sequence moduli were specified by the two stations.

link type mismatch There has been an attempt to initialize using classes of procedures that are not appropriate for the specified link type.

maximum pdu size too small The negotiated maximum frame size is less than the value of the hdlc link entity's minimum data size characteristic.

negotiation error The remote station performed an illegal negotiation operation.

no response There has been no valid response from the remote station to the generated XID within the number of times specified by the hdlc link entity's retry maximum characteristic.

parameter id not unique The parameter IDs that should be unique are not so.

protocol id mismatch An attempt has been made to initialize sequenced data ports with different protocol IDs.

transmission type mismatch Mismatch in the sync/async bit in the XID.

ui not supported An attempt has been made to initialize without the UI optional function, which is required when running MOP over an HDLC link.

remote xid The XID that the remote station used (if any) during the failed negotiation.

station halted

Generated each time the logical station's status attribute protocol state becomes halted.

Argument:

station halted reason Reason for the logical station to halt its protocol.

disc A DISC frame was received from the remote station.

dm A DM frame was received from the remote station.

fbit error A frame was received from the remote station with an error in the F-bit.

frmr An FRMR frame was received from the remote station.

local The initialization was as a result of the enable command.

maximum retry The number of times a frame has been sent has exceeded the value of the hdlc link entity's retry maximum characteristic.

physical There was a failure in the Physical layer.

unsolicited ua An unsolicited UA frame was received from the remote station.

user The initialization was as a result of local user action.

window error The initialization occurred as part of the recovery from a windowing error.

station initializing

Generated each time the logical station's protocol is successfully initialized or reinitialized.

Argument:

station initializing reason Reason for the logical station to initialize its protocol.

disc A DISC frame was received from the remote station.

dm A DM frame was received from the remote station.

fbit error A frame was received from the remote station with an error in the F-bit.

frmr An FRMR frame was received from the remote station.

local The initialization was as a result of the enable command.

maximum retry The number of times a frame has been sent has exceeded the value of the hdlc link entity's retry maximum characteristic.

physical There was a failure in the Physical layer.

unsolicited ua An unsolicited UA frame was received from the remote station.

user The initialization was as a result of local user action.

window error The initialization occurred as part of the recovery from a windowing error.

xid An XID frame was received from the remote station.

station inoperative

Generated each time the status attribute protocol state becomes inoperative.

station maintenance

Generated each time the status attribute protocol state becomes maintenance.

station resetting

Generated each time the status attribute protocol state becomes resetting.

Argument:

station resetting reason Reason for the logical station to perform a reset operation.

fbit error A frame was received from the remote station with an error in the F-bit.

frmr An FRMR frame was received from the remote station.

maximum retry The number of times a frame has been sent has exceeded the value of the entity's retry maximum characteristic.

sabm A SABM frame was received from the remote station.

unsolicited ua An unsolicited UA frame was received from the remote station.

window error The initialization occurred as part of the recovery from a windowing error.

station running

Generated each time the logical station's protocol has been initialized successfully. In addition, the status attribute protocol state changes to running.

station setup failed

Generated each time the logical station's protocol fails to be initialized following either:

The expiration of the entity's maximum retry characteristic when in the initializing state
A forced disconnection from the remote station

unknown ui pdu received

Generated each time an unsequenced frame is received specifying a protocol ID to which a port has not been opened on this station.

Argument:

received pdu Received UI frame which caused this event to be generated.

12.4 hdlc port

The hdlc port entity represents one end of an HDLC connection. The entity maintains information about that link. Ports are created and deleted automatically when a client of HDLC uses the link. The port-name refers to the port managed by this command.
show [node node-id] hdlc port port-name [all [attributes] | all identifiers | all status ]

12.4.1 Identifier Attributes

name
Simple name assigned to the port when it is created.

12.4.2 Status Attributes

client
Name of the client using the port.
logical station
hdlc link logical station entity that the port is operating over.
protocol id
Protocol ID that the port is using. For sequenced ports, this value is decided during negotiation. For unsequenced ports, the value is sent in every UI-frame.
state
State of the port.

open The port is assigned to a client. If the communications line is unswitched, data transfer can begin. For switched lines, an association must be made with the line before data transfer can begin.

open disabled The port is associated with a client, but the link or logical station associated with it is disabled.

type
Type of port.

sequenced The port can send and receive sequenced and unsequenced data.

unsequenced The port can send and receive unsequenced data only.

Chapter 13
LAPB Module

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

Note
For Digital UNIX, the Digital WAN Device Drivers product is provided as an installable subset within the product X.25 for Digital UNIX systems. You must install this subset before you can refer to the LAPB module entities in an NCL command.

Figure 13-1 shows the hierarchical relationship of the entities that constitute the LAPB module.

Figure 13-1 Hierarchy of LAPB Module Entities

13.1 lapb

The lapb entity is the top-level entity in the LAPB module hierarchy of entities. The LAPB module implements the LAPB link level protocol which is a variation of the High-level Data Link Control (HDLC) link level protocol.
create [node node-id] lapb
delete [node node-id] lapb
show [node node-id] lapb [all [attributes] | all characteristics ]

13.1.1 Characteristic Attributes

version

Default: None Version: Current version number

Version number of the DNA HDLC architecture to which this implementation conforms. You cannot modify this characteristic.

13.2 lapb link

A lapb link entity is associated with a port of the supporting Physical layer, and contains attributes that describe local LAPB operation. The simple-name refers to the link managed by this command.
create [node node-id] lapb link simple-name profile string
delete [node node-id] lapb link simple-name
disable [node node-id] lapb link simple-name
enable [node node-id] lapb link simple-name
set [node node-id] lapb link simple-name {acknowledge timer milliseconds | holdback timer milliseconds | interface type [DTE or DCE] | maximum data size integer | physical line line-name | poll timer seconds | receive buffers integer (OpenVMS) | retry maximum integer | sequence modulus [8- or 128-modulus] | window size integer }
show [node node-id] lapb link simple-name [all [attributes] | all characteristics | all counters | all identifiers | all status ]

13.2.1 Arguments

profile
Name of the X.25 Level 2 Profile that defines subscription details associated with the PSDN to which this DTE is connected. This argument is mandatory and is used to set the profile characteristic.

13.2.2 Characteristic Attributes

acknowledge timer

Default: Supplied by profile Value: 1--60000

Time, in milliseconds, to wait for an acknowledgment before initiating recovery action. This attribute corresponds to the LAPB parameter T1. You can modify this characteristic only when the entity is disabled.
holdback timer

Default: Implementation specific Value: 0--60000

Delay, in milliseconds, before an acknowledgment must be sent. This characteristic corresponds to the LAPB parameter T2. You can modify this characteristic only when the entity is disabled.
interface type

Default: DTE Value: DCE or DTE

Address mode for this link.

dce Use DCE address mode.

dte Use DTE address mode.

You can modify this characteristic only when the entity is disabled.
maximum data size

Default: Supplied by profile Value: 1--65532

Maximum frame size, in octets, of an information field in an I-frame.
physical line

Default: No default Value: Local-entity-name

Name of the Physical layer and line entity over which the LAPB protocol is to operate. You must give this characteristic a value before you enable the link.
poll timer

Default: Implementation specific Value: Supplied by profile

Maximum period, in seconds, that may elapse without frames being exchanged on the data link. On expiration, an RR(P) is sent to elicit a response from the other end.
profile

Default: No default Value: String

Name of the X.25 Level 2 Profile that defines subscription details associated with the PSDN to which this DTE is connected. You cannot modify this characteristic. This characteristic is set by means of an argument to the create command.
receive buffers (OpenVMS)

Default: Implementation specific Value: 1--128

Specifies the number of receive data buffers.
retry maximum

Default: Supplied by profile Value: 1--255

Maximum number of times a frame will be retransmitted before assuming a fatal error, at which point more drastic error recovery action will be attempted. This characteristic corresponds to the LAPB parameter N2.
sequence modulus

Default: Supplied by profile Value: 8 or 128

Type of sequence numbering.

8 Use normal sequence numbering.

128 Use extended sequence numbering.

window size

Default: Supplied by profile Value: 1--127

Window size for transmitting and receiving I-frames. This characteristic corresponds to the LAPB parameter K.

13.2.3 Counter Attributes

buffer unavailable errors (OpenVMS)
Number of times the underlying framing level has indicated system buffer unavailability to the Data Link layer.
crc errors received
Number of frames received with a bad CRC.
creation time
Time at which the entity was created.
data octets received
Number of data octets received from the remote station. This value does not include retransmissions.
data octets sent
Number of data octets sent to the remote station. This value does not include retransmissions.
data pdus received
Number of I-frames received from the remote station. This value does not include retransmissions.
data pdus sent
Number of I-frames sent to the remote station. This value does not include retransmissions.
frmrs received
Number of FRMR frames received.
frmrs sent
Number of FRMR 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 frames received.
rejs sent
Number of REJ frames transmitted.
rnrs received
Number of RNR frames received.
rnrs sent
Number of RNR frames transmitted.
times acknowledge timer expired
Number of times the local acknowledge timer has expired.
times link halted
Number of times the link halt event has been generated.
times link initializing
Number of times the link initializing event has been generated.
times link inoperative
Number of times the link inoperative event has been generated.
times link maintenance
Number of times the link maintenance event has been generated.
times link resetting
Number of times the link reset event has been generated.
times link running
Number of times the link running event has been generated.
times link setup failed
Number of times the link setup failure event has been generated.
times link state changed
Number of times a link state transition has occurred.
times pdu receive overrun
Number of times a physical line indicated an overrun condition to the Data Link layer.
times pdu transmit failed
Number of times an attempt to transmit a frame has failed.

13.2.4 Identifier Attributes

name
Simple name assigned to the link when it is created.

13.2.5 Status Attributes

line type
Type of line over which this link operates.

nonswitched The line is a nonswitched line.

switched The line is a switched line.

maximum pdu size
Maximum frame size, in octets, that this station will receive and transmit. This value includes the frame header.
physical port
Name of the Physical layer port with which the link is associated.
protocol state
State of the LAPB 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 without connectivity to the remote station.

maintenance The link is in maintenance mode.

resetting The protocol is undergoing a reset operation.

running The protocol is running normally.

state
Status of the lapb 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.

13.2.6 Event Messages

buffer unavailable error (OpenVMS)
Generated when a frame is discarded because there is no buffer available.
frmr received
Generated when an FRMR (frame reject) frame is received from the remote station.
Arguments:

frmr Contents of the header of the FRMR frame.

frmr reason Reason why the FRMR frame was generated. See possible reasons described under the frame reject generated event.

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

received pdu Header of the frame that caused the event to be generated.

frmr Contents of the generated FRMR frame.

frmr reason Reason why the FRMR frame was generated.

control A received control field is either undefined or is not implemented.

format The received control field is invalid either because the frame contained an unallowed information field, or because the frame is a supervisory or unnumbered frame of incorrect length.

length The received information field is longer than the maximum established capacity.

nonspecific The received frame has an unspecified number or types of errors.

nr The received control field contains an invalid N(R).

link halted
Generated when the status attribute protocol state is set to halted.

Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]
  NCL_PROFILE_011.HTML
  OSSG Documentation
   2-DEC-1996 12:48:00.60
Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal

frmr	Contents of the frame reject frame that is returned to the remote station.
frmr reason	Reason for rejecting the frame.
	control	One of the control fields is undefined or not implemented by the local station.
	format	The frame's control field is invalid because the frame contained information that is not allowed, the frame is supervisory, or the frame is unnumbered and has the wrong length.
	length	The information field of the frame exceeds the maximum capacity.
	nonspecific	The received frame contains an unspecified number or type of error.
	nr	The frame's control field contains an invalid N(R).
received pdu	Header of the frame that caused the generation of the event.

local xid	The XID that the local station used during the failed negotiation.
negotiation failure reason	Reason that negotiation with the remote station failed.
	address id not unique	The preferred addresses and the address-negotiation unique IDs were identical.
	incompatible address modes	The remote station wanted to use HDLC's extended addressing which the Digital Network Architecture's implementation does not support.
	incompatible crc types	Incompatible CRC types were specified by the two stations.
	incompatible sequence moduli	Incompatible sequence moduli were specified by the two stations.
	link type mismatch	There has been an attempt to initialize using classes of procedures that are not appropriate for the specified link type.
	maximum pdu size too small	The negotiated maximum frame size is less than the value of the hdlc link entity's minimum data size characteristic.
	negotiation error	The remote station performed an illegal negotiation operation.
	no response	There has been no valid response from the remote station to the generated XID within the number of times specified by the hdlc link entity's retry maximum characteristic.
	parameter id not unique	The parameter IDs that should be unique are not so.
	protocol id mismatch	An attempt has been made to initialize sequenced data ports with different protocol IDs.
	transmission type mismatch	Mismatch in the sync/async bit in the XID.
	ui not supported	An attempt has been made to initialize without the UI optional function, which is required when running MOP over an HDLC link.
remote xid	The XID that the remote station used (if any) during the failed negotiation.

station halted reason	Reason for the logical station to halt its protocol.
	disc	A DISC frame was received from the remote station.
	dm	A DM frame was received from the remote station.
	fbit error	A frame was received from the remote station with an error in the F-bit.
	frmr	An FRMR frame was received from the remote station.
	local	The initialization was as a result of the enable command.
	maximum retry	The number of times a frame has been sent has exceeded the value of the hdlc link entity's retry maximum characteristic.
	physical	There was a failure in the Physical layer.
	unsolicited ua	An unsolicited UA frame was received from the remote station.
	user	The initialization was as a result of local user action.
	window error	The initialization occurred as part of the recovery from a windowing error.

station initializing reason	Reason for the logical station to initialize its protocol.
	disc	A DISC frame was received from the remote station.
	dm	A DM frame was received from the remote station.
	fbit error	A frame was received from the remote station with an error in the F-bit.
	frmr	An FRMR frame was received from the remote station.
	local	The initialization was as a result of the enable command.
	maximum retry	The number of times a frame has been sent has exceeded the value of the hdlc link entity's retry maximum characteristic.
	physical	There was a failure in the Physical layer.
	unsolicited ua	An unsolicited UA frame was received from the remote station.
	user	The initialization was as a result of local user action.
	window error	The initialization occurred as part of the recovery from a windowing error.
	xid	An XID frame was received from the remote station.

station resetting reason	Reason for the logical station to perform a reset operation.
	fbit error	A frame was received from the remote station with an error in the F-bit.
	frmr	An FRMR frame was received from the remote station.
	maximum retry	The number of times a frame has been sent has exceeded the value of the entity's retry maximum characteristic.
	sabm	A SABM frame was received from the remote station.
	unsolicited ua	An unsolicited UA frame was received from the remote station.
	window error	The initialization occurred as part of the recovery from a windowing error.

open	The port is assigned to a client. If the communications line is unswitched, data transfer can begin. For switched lines, an association must be made with the line before data transfer can begin.
open disabled	The port is associated with a client, but the link or logical station associated with it is disabled.

sequenced	The port can send and receive sequenced and unsequenced data.
unsequenced	The port can send and receive unsequenced data only.

8	Use normal sequence numbering.
128	Use extended sequence numbering.

nonswitched	The line is a nonswitched line.
switched	The line is a switched line.

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 without connectivity to the remote station.
maintenance	The link is in maintenance mode.
resetting	The protocol is undergoing a reset operation.
running	The protocol is running normally.

frmr	Contents of the header of the FRMR frame.
frmr reason	Reason why the FRMR frame was generated. See possible reasons described under the frame reject generated event.

received pdu	Header of the frame that caused the event to be generated.
frmr	Contents of the generated FRMR frame.
frmr reason	Reason why the FRMR frame was generated.
	control	A received control field is either undefined or is not implemented.
	format	The received control field is invalid either because the frame contained an unallowed information field, or because the frame is a supervisory or unnumbered frame of incorrect length.
	length	The received information field is longer than the maximum established capacity.
	nonspecific	The received frame has an unspecified number or types of errors.
	nr	The received control field contains an invalid N(R).

DECnet-PlusNetwork Control Language Reference

frmr received

negotiation failed

station halted

station initializing

station inoperative

station maintenance

station resetting

station running

station setup failed

unknown ui pdu received

12.4 hdlc port

12.4.1 Identifier Attributes

name

12.4.2 Status Attributes

client

logical station

protocol id

state

type

Chapter 13LAPB Module

13.1 lapb

13.1.1 Characteristic Attributes

version

13.2 lapb link

13.2.1 Arguments

profile

13.2.2 Characteristic Attributes

acknowledge timer

holdback timer

interface type

maximum data size

physical line

poll timer

profile

receive buffers (OpenVMS)

retry maximum

sequence modulus

window size

13.2.3 Counter Attributes

buffer unavailable errors (OpenVMS)

crc errors received

creation time

data octets received

data octets sent

data pdus received

data pdus sent

frmrs received

frmrs sent

polls received

rejs received

rejs sent

rnrs received

rnrs sent

times acknowledge timer expired

times link halted

times link initializing

times link inoperative

times link maintenance

times link resetting

times link running

times link setup failed

times link state changed

times pdu receive overrun

times pdu transmit failed

13.2.4 Identifier Attributes

name

13.2.5 Status Attributes

line type

maximum pdu size

physical port

protocol state

state

uid

13.2.6 Event Messages

buffer unavailable error (OpenVMS)

frmr received

frmr sent

link halted

DECnet-Plus
Network Control Language Reference

Chapter 13
LAPB Module