![[Digital logo]](../../IMAGES/DIGITAL-LOGO.GIF)
![[HR]](../../IMAGES/REDBAR.GIF)
DECnet-Plus
Network Control Language Reference
Previous
| Contents
block check error
Frame with FCS error was received.
directed beacon received
A directed beacon was received.
duplicate address test failure
Duplicate address algorithm detected a duplicate.
duplicate token detected
Duplicate token is detected.
fci strip error
Frame content independent strip was terminated by a token.
frame status error
Frame with good FCS, but E indicator set was received.
link buffer unavailable
No buffer was available to to receive a frame.
pdu length error
Frame of invalid length or odd number of symbols was received.
receive data overrun
A receive overrun hardware error was detected.
ring beacon initiated
Link started the beacon process.
ring initialization initiated
Ring is reinitialized by this link.
ring initialization received
Ring is reinitialized by some other link.
ring purge error
Ring purger received a token while purging.
trace initiated
PC-trace was initiated by this link.
transmit failure
Failure to transmit operation other than underrun.
transmit underrun
Transmit failed due to underrun.
unrecognized individual pdu destination
Frame with unrecognized DSAP or port-id.
unrecognized multicast pdu destination
Frame with unrecognized DSAP or port-id.
user buffer unavailable
Data link user did not supply a receive buffer.
10.3.8 Exception Messages
For GetSIF, GetNIF, and echo (Digital UNIX):
reject
Request was rejected by the target station.
timeout
No response was received.
An fddi station phy port entity provides the management view
of the fddi station phy port and the fddi pmd. Each
station has at least one physical port and a concentrator is a device
that has at least one physical port of type M. A dual-attached station
or dual-attached concentrator has a phy port type A and type
B. A single-attached station has a phy port of type B. The
port-id is an integer that represents the physical port to be
managed by the command.
disable [node node-id] fddi station
station-name phy port port-id
enable [node node-id] fddi station
station-name phy port port-id mode {normal | internal
loopback }
show [node node-id] fddi station
station-name phy port port-id {all [attributes] | all
characteristics | all counters | all identifiers | all status }
10.4.1 Characteristic Attributes
lem threshold
|
Default: None
|
Value: For
n, 10^
-n
|
Link error monitor threshold. This characteristic cannot be set.
phy type
Type of physical port (A, B, S, or M). This characteristic cannot be
set.
pmd type
Type of PMD (transceiver) for this physical port. This characteristic
cannot be set.
|
ANSI multimode
|
Low power
|
|
ANSI multimode type 1
|
ThinWire
|
|
ANSI single mode type 2
|
Shielded twisted-pair
|
|
ANSI SONET
|
Unshielded twisted-pair
|
10.4.2 Counter Attributes
creation time
Time at which the port was created.
connections completed
Number of times the physical port entered the in use state,
having completed the initialization process.
elasticity buffer errors
Number of times the elasticity buffer function had an overflow or
underflow.
lct rejects
Number of times a connection was rejected due to failure of the link
confidence test at either end of the physical connection.
lem rejects
Number of times an active connection was disconnected due to rejection
by the link error monitor at this end of the physical connection, or by
expiration of the Noise timer.
link errors
Total number of raw link error input events seen by the link
error monitor.
10.4.3 Identifier Attributes
index
An integer that uniquely identifies this physical port to the parent
station entity.
10.4.4 Status Attributes
broken reason
Reason phy port is in broken state, or if in
broken state, none.
estimated link error rate
|
Default: None
|
Value: 1--256
|
Link error monitor current estimate of error rate.
neighbor phy type
Status may be A, B, S, M or unknown.
reject reason
Reason the phy port is in a failed or watch
state. This is not meaningful when phy port is in some other
state.
|
LCT both sides
|
link confidence test failed on both sides of the physical connection.
|
|
LCT protocol error
|
Neighboring physical port has been detected to have prematurely exited
the link confidence test (LCT).
|
|
LEM reject
|
Link error monitor disconnected this connection due to the error rate
exceeding the LEM threshold.
|
|
local LCT
|
Link confidence test failed on this end of the physical connection.
|
|
noise reject
|
Noise timer expired because a single noise event lasted for more than
1.31072 ms.
|
|
none
|
No reason.
|
|
remote LCT
|
Link confidence test failed on the other end of the physical connection.
|
|
remote reject
|
Neighboring physical port broke the connection for an unknown reason.
|
|
standby
|
Physical port and its neighboring physical port form a redundant
physical connection (dual-homing feature). In a dual-homed
configuration, the B to M connection is the higher priority physical
connection, and the A to M connection is the standby physical
connection. The standby connection will become active if the B to M
connection is lost.
|
|
topology reason
|
Neighboring physical port's physical port type is an illegal match for
this physical port's physical port type.
|
|
trace in progress
|
Physical port was initializing when a pc-trace occurred. When a
pc-trace occurs, any physical ports that have not yet established a
physical connection are shut down to prevent the topology from changing.
|
|
trace received-disabled
|
Physical port was momentarily disabled because it received a pc-trace
when its own pc-trace function was disabled. The pc-trace function is
enabled by default. The trace disable switch is not remotely manageable.
|
state
Operational state of the phy port entity (nonsettable).
|
broken
|
The physical port has failed initialization tests and is not available
for use.
|
|
failed
|
Same as
waiting, except the physical port has failed to complete the
last connection attempt. Refer to the physical port's status parameter
reject reason, for the reason for connection failure.
Connection attempts will continue until successful.
|
|
internal loopback
|
The physical port has been configured to internally present all
transmitted symbols to the receive interface. The network connector is
inactive. This allows internally generated test frames to be looped
back for test purposes.
|
|
in use
|
The physical port has established a connection and is fully
operational. Communications services are now available.
|
|
off-ready
|
The physical port is waiting to be enabled or has been disabled by
management request.
|
|
starting
|
The physical port has received a response from the neighboring physical
port and is exchanging information and performing the link confidence
test (LCT) prior to completing the connection.
|
|
waiting
|
The physical port is beginning to establish a connection and is waiting
for a response from the neighboring physical port.
|
|
watch
|
Same as
starting, except the physical port has failed to complete the
last connection attempt. Refer to the physical port's status parameter,
reject reason, for the reason for connection failure.
Connection attempts will continue until successful.
|
uid
Entity's unique identifier, which is generated when the entity is
created.
10.4.5 Event Messages
link confidence test reject
Counted as LCT rejects.
link elasticity buffer error
Counted as elasticity buffer errors.
link error monitor reject
Counted as LEM rejects.
10.4.6 Exception Messages
For enable:
invalid mode
Specified mode conflicts with station mode.
An fddi port entity represents an access point to the service
offered by the FDDI module. A client transmits and receives data
through a port. Ports are created and deleted by client use of open and
close service interface procedures. The port-name refers to
the port managed by this command.
show [node node-id] fddi port
port-name [all [attributes] | all counters | all identifiers |
all status ]
10.5.1 Counter Attributes
creation time
Time at which the port was created.
multicast octets received
Number of multicast user data octets received successfully and
available to the data link user.
multicast octets sent
Number of multicast user data octets transmitted successfully using the
port.
multicast pdus received
Number of multicast frames received successfully and available to the
data link user.
multicast pdus sent
Number of multicast frames transmitted successfully using the port.
octets received
Number of user data octets received successfully and available to the
data link user.
octets sent
Number of user data octets transmitted successfully using the port.
pdus received
Number of frames received successfully and available to the data link
user.
pdus sent
Number of frames transmitted successfully using the port.
unavailable user buffers
Number of times no user buffer was available at the port for an
incoming frame.
10.5.2 Identifier Attributes
name
Simple name assigned to the port when it is created.
10.5.3 Status Attributes
client
Name specified by the data link when the port is opened.
ethernet protocol types
Set of Ethernet protocol types that are recognized for this port.
Protocol types for a port may be enabled and disabled by the user at
any time during the port's existence.
length present
|
Default: None
|
Value: True or false
|
Indicates whether or not the data link adds a length field on transmit,
assumes the presence of the length field, and removes the length field
on receive for Ethernet frames. This attribute is irrelevant for ISO
8802-3 formatted frames because the length field is always present.
This is specified by the user when the port is opened. The value
true means length fields are added and removed by the data
link.
link
Name of the link subentity associated with this port,
specified by the user when the port is opened.
llc sap addresses
Set of SNAP protocol identifiers that are recognized for this port. LLC
SAP addresses for a port may be enabled and disabled by the user at any
time during the port's existence.
llc service
|
Default: None
|
Value: Class 1 or user supplied
|
LLC PDU processing the data link user requires from the port, specified
by the user when the port is opened. This is either LLC Class 1, where
the entire LLC protocol is handled by the data link, or user-supplied
LLC, where the user is responsible for operating part of the LLC
protocol.
mac addresses
Set of individual and multicast MAC addresses that are recognized for
this port. MAC addresses for a port may be enabled and disabled by the
user at any time during the port's existence.
receive mode
|
Default: None
|
Value: Normal or promiscuous
|
Indicates if the port is to receive all frames regardless of format,
Ethernet protocol type, SNAP protocol identifier, LLC SAP address, or
MAC address. Promiscuous receipt is enabled and disabled by the user.
Support of promiscuous mode is optional.
snap protocol identifiers
Set of SNAP protocol identifiers that are recognized for this port.
Protocol identifiers for a port may be enabled and disabled by the user
at any time during the port's existence.
type
Type of port (LLC or SMT).
uid
Entity's unique identifier, which is generated when the entity is
created.
Chapter 11
Frame Module (OpenVMS)
This chapter describes all the commands you can use to manage the
entities that constitute the Frame module. The Frame module provides
framing functions for a communications link. It enables those who
implement their own level 2 protocols to manage the links that use
those protocols.
Figure 11-1 shows the hierarchical relationship of the entities that
constitute the Frame module.
Figure 11-1 Hierarchy of Frame Module Entities
The frame entity is the top-level entity in the hierarchy
belonging to the Frame module. The entity provides framing functions
for a communications link. The entity does not provide any data link
protocol capabilities, and is used by those who want or need to operate
their own level 2 protocols.
create [node node-id] frame
delete [node node-id] frame
disable [node node-id] frame
enable [node node-id] frame
show [node node-id] frame [all [attributes] |
all characteristics | all status ]
11.1.1 Characteristic Attributes
version
Version of the frame architecture to which the implementation conforms.
You cannot modify this characteristic.
11.1.2 Status Attributes
state
State of the frame entity.
|
off
|
The
frame entity is disabled.
|
|
on
|
The
frame entity is enabled.
|
A frame link entity is associated with a physical line, and
controls the framing protocol used on that line. There is one frame
link entity for each physical line.
create [node node-id] frame link
frame-link-id {control mode mode | protocol
protocol-type }
delete [node node-id] frame link
frame-link-id
disable [node node-id] frame link
frame-link-id
enable [node node-id] frame link
frame-link-id
set [node node-id] frame link
frame-link-id {bisync code character-code | bits per
character number-of-bits | buffer size integer | crc
type crc type | framing timer milliseconds | initial
state one state-info | initial state two state-info |
local station address address | match station address
boolean | number of buffers integer | sync character
hexadecimal | sync count integer }
show [node node-id] frame link
frame-link-id [all [attributes] | all characteristics | all
counters | all identifiers | all status ]
11.2.1 Arguments
control mode
Control mode in which the link operates. This argument determines the
value of the control mode characteristic. The default is point-to-point.
|
multipoint master
|
|
|
multipoint tributary
|
|
|
point-to-point
|
|
protocol
Framing protocol to be used over the link. This argument determines the
value of the protocol characteristic.
|
bisync
|
hdlc
|
|
chips
|
sdlc
|
|
ddcmp
|
swift
|
|
genbyte
|
|
11.2.2 Characteristic Attributes
bisync code
|
Default: EBCDIC
|
Value: ASCII or EBCDIC
|
Character code to be used on the link. This characteristic is supported
only when the characteristic protocol is set to one of the
following: bisync, chips, genbyte, or swift. You can
modify this characteristic only when the entity is disabled.
bits per character
Number of bits in each character. This characteristic is supported only
when the characteristic protocol is set to genbyte.
You can modify this characteristic only when the entity is disabled.
buffer size
|
Default: 512
|
Value: 0--65535
|
Size, in octets, of each receive buffer for the link. You can modify
this characteristic only when the entity is disabled. Also, you can
only increase the characteristic value.
control mode
|
Default: Point-to-point
|
Value: See description
|
Control mode in which the link is to operate. The value of this
characteristic derives from the point to point argument to the
create command. You cannot modify this characteristic.
|
multipoint master
|
|
|
multipoint tributary
|
|
|
point-to-point
|
|
crc type
|
Default: See description
|
Value: See description
|
CRC type used on the link.
|
AUTO_DIN
|
|
|
CRC_16
|
|
|
CRC_CCITT
|
|
|
CRC_CCITT0
|
|
|
LRC_EVEN
|
|
|
LRC_ODD
|
|
|
LRC_VRC_EVEN
|
|
|
LRC_VRC_ODD
|
|
|
NONE
|
|
The default value depends on the protocol.
|
BISYNC
|
CRC_16
|
|
CHIPS
|
LRC_EVEN
|
|
DDCMP
|
CRC_16
|
|
GENBYTE
|
NONE
|
|
HDLC
|
CRC_CCITT
|
|
SDLC
|
CRC_CCITT
|
|
SWIFT
|
CRC_16
|
genbyte crc checking is done in the genbyte framing
routine.
framing timer
|
Default: 25
|
Value: 10--1000
|
Maximum length of time, in milliseconds, to wait for the next character
to arrive. This characteristic is supported only when the
characteristic protocol is set to genbyte.
initial state one
|
Default: 0
|
Value: See description
|
First 32 bits of state information. This characteristic is supported
only when the characteristic protocol is set to
genbyte. You can modify this characteristic only when the
entity is disabled.
initial state two
|
Default: 0
|
Value: See description
|
Last 32 bits of state information. This characteristic is supported
only when the characteristic protocol is set to
genbyte. You can modify this characteristic only when the
entity is disabled.
local station address
|
Default: 255
|
Value: 0--255
|
Address of the local station. The default value means that only
broadcast messages are accepted. The interpretation of this
characteristic is controlled by the value of the characteristic
match station address.
This attribute is supported only if the characteristic
protocol is set to sdlc. You can modify this
characteristic only when the entity is disabled.
match station address
|
Default: False
|
Value: True or false
|
Specifies whether the value of the characteristic local station
address is to be interpreted as a valid address. This attribute is
supported only if the characteristic protocol is set to
sdlc. You can modify this characteristic only when the entity
is disabled.
number of buffers
Number of receive buffers reserved for the link. You can modify this
characteristic only when the entity is disabled. Also, you can only
increase the characteristic value.
physical line
|
Default: None
|
Value: Local-entity-name
|
Name of the Physical layer line entity on which the link operates. You
must provide a value for this characteristic before you enable the
link. You can modify this characteristic only when the entity is
disabled.
protocol
Framing protocol used on the line. The value of this characteristic
derives from the protocol argument to the create
command. You cannot modify this characteristic.
|
bisync
|
hdlc
|
|
chips
|
sdlc
|
|
ddcmp
|
swift
|
|
genbyte
|
|
sync character
|
Default: See description
|
Value: 0--FF
|
Hexadecimal code of the sync character to be used on the link.
The default value depends on the value of the characteristic
protocol, as follows:
|
bisync
|
32
|
|
chips
|
32
|
|
ddcmp
|
96
|
|
genbyte
|
32
|
|
swift
|
32
|
This attribute is supported only if the characteristic
protocol is set to bisync, chips, ddcmp, genbyte, or
swift. You can modify this characteristic only when the entity
is disabled.
sync count
Number of sync characters that precedes each message. This
attribute is supported only if the characteristic protocol is
set to bisync, chips, ddcmp, genbyte, or swift. You
can modify this characteristic only when the entity is disabled.
11.2.3 Counter Attributes
abort characters received
Number of times the link was prematurely terminated by the remote
station. This counter is supported only if the characteristic
protocol is set to either hdlc or sdlc.
creation time
Time at which this entity was created.
data block check errors
Number of messages received with an error in the data field block check.
header block check errors
Number of messages received with an error in the header block check.
This counter is supported only if the characteristic protocol
is set to ddcmp.
invalid characters received
Number of times an invalid character was received from the remote
station. This counter is supported only if the characteristic
protocol is set to either bisync or ddcmp.
receive buffer overflows with good crc
Number of times the local station received a message too large for the
receive buffer and the message had a valid CRC.
receive overruns
Number of times the host memory was not able to handle all the data
received from the communications channel.
sdus received
Number of data messages received from the remote station.
sdus sent
Number of data messages sent to the remote station.
service octets received
Number of data octets received from the remote station.
service octets sent
Number of data octets sent to the remote station.
transmit underruns
Number of times the host memory could not supply data fast enough to
satisfy the communications channel.
11.2.4 Identifier Attributes
name
Simple name assigned to the link when it is created.
11.2.5 Status Attributes
physical port name
Name of the Physical layer port returned when the port is opened. If
this value is missing, the port has yet to be opened.
state
State of the frame 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.
11.2.6 Exception Messages
For create:
parent is disabled
The frame entity was disabled when you issued this
create command. Enable the frame entity and then
reissue this command.
Previous
| Next
| Contents
| [Home]
| [Comments]
| [Ordering info]
| [Help]
NCL_PROFILE_009.HTML
OSSG Documentation
2-DEC-1996 12:47:55.27
Copyright © Digital Equipment Corporation 1996. All Rights Reserved.
Legal