DECnet-Plus
Network Control Language Reference

Arguments:

application	Address of the X.25 application that has rejected a connect request.
node	Address of a node that has rejected a connect request.
server	Address of the X.25 server that has rejected a connect request.

session control unavailable

Arguments:

module extant	Whether the Session Control module is unavailable or merely disabled. If false, the Session Control module is unavailable; if true, it is disabled. If false, the Session Control Port State argument is null.
Session Control port state	State of the Session Control port.
	null	The Session Control module is unavailable.
	off	The Session Control port is in the Off state.
	restricted	The Session Control port is in the Restricted state.
	shut	The Session Control port is in the Shut state.

25.1.6 Exception Messages

For enable:

session control no resources

The Session Control module does not have sufficient resources to handle the call.

session control unavailable

The Session Control module either does not exist or is disabled.

This chapter describes all the commands you can use to manage the entities that constitute the X.25 Protocol module. The X.25 Protocol module resides in the Network layer of the Digital Network Architecture (DNA). It provides the X.25 packet level interface into the packet switching data network (PSDN).

Figure 26-1 shows the hierarchical relationship of the entities that constitute the X.25 Protocol module.

Figure 26-1 Hierarchy of X.25 Protocol Module Entities

26.1 x25 protocol

version

Default: Current version number

Version of DNA X.25 architecture to which this implementation conforms. You cannot modify this characteristic.

26.2 x25 protocol dte

The x25 protocol dte enable command starts the operation of the specified DTE. When the procedure completes, the status attribute state may be running, synchronizing, or unsychronized.

The enable command will fail if the inbound dte class, link service provider, or x25 address characteristics are not set. The command will also fail if:

• There is a mismatch between the protocol profile and the link service provider profile.
• The link service provider either does not exist or is in use by someone else.
• The link service provider does not provide a maximum data size of the greater of 260, DTE maximum packet size +4.

profile profile-name

Name of the profile that supplies subscription details of the PSDN to which the DTE is connected. This argument is mandatory, and is used to set the profile characteristic.

maximum active circuits integer

Maximum number of virtual circuits that can be active at any time on the DTE for SVCs and PVCs . This argument determines the value of the maximum active circuits characteristic. This argument is optional.

call timer

Default: Supplied by profile

Value: Bounded by profile

Elapsed time, in seconds, before which a clear packet is sent for outgoing calls from the DTE that have received no response. A zero value indicates that no clear is sent.

ccitt version

Default: 1984

Value: 1--9999

Version of the CCITT X.25 recommendations to which the DTE conforms.

clear timer

Default: Supplied by profile

Value: Bounded by profile

Value of the retransmit timer for outgoing clear packets from the DTE. The default value is profile dependent.

default packet size

Default: 128

Value: 16--4096 ^²

Default packet size, in octets, for all virtual circuits on the DTE. The value must not be less than the value of the minimum packet size characteristic.

default window size

Default: 2

Value: 1--127

Default window size for all virtual circuits on the DTE; that is, the default number of unacknowledged packets. This value must not be greater than the value of the maximum window size characteristic, and must not be less than the value of the minimum window size characteristic.

description

Manufacturer, product name, and version of the hardware platform of the DTE.

extended packet sequencing

Default: False

Value: True or false

Specifies whether the extended packet sequencing facility is subscribed to, in which modulo 128 packet numbering is used. If false, extended packet sequencing is not used. The profile may provide overriding default or legal values.

inbound dte class

Default: No DTE class name

Value: Simple-name

Name of the DTE class to be associated with all incoming calls to the DTE. You must specify this characteristic before you enable the DTE. The x25 access dte class entity to which the name refers must exist when you enable the DTE.

incoming list

Default: (0--4095) ranges

Value: Set of range (0--4095)

Channel number ranges that define the logical channel numbers (LCNs) that are available for calls on incoming or bothway channels. Format the values to specify a set of channel number ranges. Each channel number is the concatenation of the logical channel group number and logical channel number of an SVC on the DTE.

interface type

Default: DTE

Value: See description

Interface mode in which the packet protocol for the DTE will operate. You can modify this characteristic only when the entity is disabled.

dce	DCE mode.
dte	DTE mode.
negotiated	The interface mode is negotiated with the other end to be either DTE or DCE. This value applies only to point-to-point links.

interrupt timer

Default: Supplied by profile

Value: Bounded by profile

Value of the interrupt timer. This timer is started when an interrupt packet is sent. If no interrupt confirmation packet is received before the timer expires, a reset is caused. A zero value indicates that there is no timer.

link service provider

Default: No link service provider name

Value: Full-name

Name of the link service provider entity used by the DTE. You must give this characteristic a value before you enable the DTE.

maximum active circuits

Default: 4096

Value: 1--4096

Maximum number of virtual circuits that can be active at any time on the DTE. This characteristic cannot be set.

maximum clear attempts

Default: Supplied by profile

Value: Bounded by profile

Number of times that sending a clear packet can be attempted on a virtual circuit on the DTE. The value 1 indicates that a clear packet is sent only once; that is, there are no retries.

maximum packet size

Default: 128

Value: 16--4096 ^²

Maximum packet size, in octets, for all virtual circuits on the DTE. This value must be greater than or equal to the value of the minimum packet size and default packet size characteristics.

maximum reset attempts

Default: Supplied by profile

Value: Bounded by profile

Number of times the DTE attempts to send a reset packet. The value 1 indicates that a reset packet is sent only once; that is, there are no retries.

maximum restart attempts

Default: Supplied by profile

Value: Bounded by profile

Number of times that any virtual circuit on the DTE attempts to send a restart packet. The value 1 indicates that a restart packet is sent only once; that is, there are no retries.

maximum throughput class

Default: 4800

Value: See description

Maximum value for the throughput class (65535) of any virtual circuit on the DTE. The value specified must be one of the following: 0, 75, 150, 300, 600, 1200, 2400, 4800, 9600, 48000, or 64000. The value must be greater than or equal to the value of the minimum throughput class characteristic.

maximum window size

Default: 2

Value: 1--127

Maximum number of unacknowledged packets for all virtual circuits on the DTE. This value must be greater than or equal to the value of the minimum window size and default window size characteristics.

minimum packet size

Default: 128

Value: 16--4096 ^²

Minimum packet size, in octets, for all virtual circuits on the DTE. This value must be less than or equal to the value of the maximum packet size and default packet size characteristics.

minimum throughput class

Default: Supplied by profile

Value: Bounded by profile

Minimum throughput class for any virtual circuit on the DTE. The value specified must be one of the following: 0, 75, 150, 300, 600, 1200, 2400, 4800, 9600, 48000, or 64000. The value must be less than or equal to the value of the maximum throughput class characteristic.

minimum window size

Default: 2

Value: 1--127

Minimum window size for all virtual circuits on the DTE. This value must be less than or equal to the value of the maximum window size characteristic.

outgoing list

Default: [1...4095]

Value: Set of range (0--4095)

Channel number ranges that define the LCNs that are available for calls on outgoing or two-way channels. Format the values to specify a set of channel number ranges. Each channel number is the concatenation of the logical channel group number and logical channel number of an SVC on the DTE.

profile

Default: No profile name

Name of the profile that provides subscription details of the PSDN to which the DTE is connected. This characteristic cannot be set; it is specified when the DTE is created.

reset timer

Default: Supplied by profile

Value: Bounded by profile

Value of the retransmit timer for outgoing reset packets from the DTE. The default value is profile-dependent.

restart timer

Default: Supplied by profile

Value: Bounded by profile

Value of the retransmit timer for outgoing restart packets from the DTE. The default value is profile-dependent.

segment size

Segment size specified for data sent at this DTE.

x25 address

Default: No DTE address

Value: DTE-address

Full address of the DTE. You must give this characteristic a value before you enable the DTE.

allocated pvc failures (OpenVMS)

Number of times allocated PVCs have failed.

calls failed

Number of outgoing or incoming calls on the DTE that were either rejected or disconnected during the data phase.

creation time

Time at which this entity was created.

data octets received

Number of data octets received on all virtual circuits on the DTE.

data octets sent

Number of data octets sent on all virtual circuits on the DTE.

data PDUs received

Number of data packets received on all virtual circuits on the DTE.

data PDUs sent

Number of data packets sent on all virtual circuits from the DTE.

diagnostic packets

Number of diagnostic packets received on all virtual circuits on the DTE.

down transitions

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

fast selects received

Number of fast select requests received at the DTE.

fast selects sent

Number of fast select requests sent from the DTE.

illegal packets

Number of illegal packets received at the DTE.

incoming calls connected

Number of successful call requests received at the DTE.

locally initiated resets

Number of times a reset was initiated by the local X.25 Protocol module.

locally initiated restarts

Number of times a restart was initiated by the local X.25 Protocol module.

network initiated resets

Number of times a reset was received.

network initiated restarts

Number of times a restart was received.

outgoing calls connected

Number of successful call requests sent from the DTE.

protocol errors

Number of protocol errors detected at the DTE.

reject packets

Number of reject packets received at the DTE.

retry failures

One of the maximum retry counts has been reached.

up transitions

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

name

Simple name assigned to the DTE when it is created.

available outgoing channels

Number of LCNs enumerated by the outgoing list characteristic that are available for use.

dte class

DTE classes to which the DTE belongs.

groups

Groups to which the DTE belongs.

interface mode

Mode in which the DTE is operating.

last state change

Time at which the last change of state occurred.

state

Status of the x25 protocol dte entity.

off	The DTE is disabled, and all virtual circuits are terminated.
running	The DTE is enabled and synchronized at Protocol layer 3.
synchronizing	A restart operation initiated at the packet level is in progress.
unsynchronized	The line between the DTE and DCE is not synchronized at Protocol layer 2.

uid

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

diagnostic packet received

Generated when the DTE receives a diagnostic packet from the network.

Arguments:

cause	Cause code provided by the DCE on reset.
channel	Concatenated logical channel group and logical channel number of the virtual circuit associated with the event.
diagnostic	Diagnostic code provided by the DCE on reset.

dte down

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

Arguments:

configuration error	Specifies whether or not there has been a configuration error.
lapb link deleted	DTE state has changed due to the deletion of the underlying link service provider entity.

dte up

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

Argument:

configuration	Specifies the DTE configuration.
	dce	The DTE has initialized as a packet-mode DCE.
	dte	The DTE has initialized as a packet-mode DTE.
	negotiated dce	The DTE has negotiated to operate as a packet-mode DCE.
	negotiated dte	The DTE has negotiated to operate as a packet-mode DTE.

illegal packet received

Generated when the DTE receives an illegal packet from the network.

Arguments:

call time	Time at which the call request was made.
ccitt state	CCITT state.
channel	Concatenated logical channel group and logical channel number for the virtual circuit associated with the event.
direction	Direction of the call.
	incoming	The call was incoming.
	outgoing	The call was outgoing.
failure reason	Specifies why the packet was flagged as illegal.
	header error	Error in the received block header.
	invalid gfi	Invalid general format identifier.
	invalid state	The packet is invalid in the current state of the protocol.
	no interrupt sent	No interrupt packet was sent.
	too long	The packet is too long.
	too short	The packet is too short.
	unacknowledged interrupt	There is an outstanding interrupt.
	unrecognized	The packet is unrecognizable to the DTE.
header	Header contents of the packet that caused the event.
packet type	Type of illegal packet.
remote dte	Address of the DTE that is the source of an incoming call or the destination of an outgoing call.

network initiated reset

Generated when the DTE receives a Reset packet from the network.

Arguments:

cause	Cause code provided by the DCE on reset.
ccitt state	CCITT state. See possible reasons described under the illegal packet received event.
channel	Concatenated logical channel group and logical channel number of the virtual circuit associated with the event.
diagnostic	Diagnostic code provided by the DCE on reset.
direction	Direction of the call.
	incoming	The call was incoming.
	outgoing	The call was outgoing.

network initiated restart

Generated when the DTE receives a Restart packet from the network.

Arguments:

cause	Cause code provided by the DCE on reset.
ccitt state	CCITT state. See possible reasons described under the illegal packet received event.
channel	Concatenated logical channel group and logical channel number of the virtual circuit associated with the event.
diagnostic	Diagnostic code provided by the DCE on reset.

protocol error detected

Generated when a protocol error is detected.

Arguments:

call time	Time at which the call request was made.
ccitt state	CCITT state. See possible reasons described under the illegal packet received event.
channel	Concatenated logical channel group and logical channel number for the virtual circuit associated with the event.
failure reason	Reason for the protocol error.
	bad p(r) received	Invalid receive packet sequence number received.
	bad p(s) received	Invalid transmit packet sequence number received.
	invalid lcn	Invalid Logical Channel Number.
	invalid packet size	Error in negotiated or requested packet size.
	invalid throughput class	Error in negotiated or requested throughput class.
	invalid window size	Error in negotiated or requested window size.
	no fast select	Fast select is not supported.
	receiver not ready	Data received while in receiver not ready state.
header	Header contents that caused the event.
remote dte	Address of the DTE that is the source of an incoming call or the destination of an outgoing call.

reject packet received

Generated when the DTE receives a reject packet from the network.

---

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

---

  NCL_PROFILE_032.HTML
  OSSG Documentation
   2-DEC-1996 12:48:53.59

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal