[Digital logo]
[HR]

DECnet-Plus
Network Control Language Reference

Previous | Contents

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:

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]

[HR] 

  NCL_PROFILE_011.HTML
  OSSG Documentation
   2-DEC-1996 12:48:00.60

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal