DECnet-Plus
Network Control Language Reference

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 of the virtual circuit associated with the event.
direction	Direction of the call.
	incoming	The call was incoming.
	outgoing	The call was outgoing.
remote dte	Address of the DTE that is the source of an incoming call or the destination of an outgoing call.

retry failed

Arguments:

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.
remote dte	Address of the DTE that is the source of an incoming call or the destination of an outgoing call.
retry	Specifies which retry counter has generated the event by reaching its maximum value.
	clear	The maximum clear attempts counter.
	reset	The maximum reset attempts counter.
	restart	The maximum restart attempts counter.

switched virtual circuit failed

Arguments:

call time	Time at which the call request was made.
cause	Cause code provided by the DCE on reset.
channel	Concatenated logical channel group and logical channel number for 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.
failure reason	Reason why the circuit failed.
	call cleared	The call was cleared by an invocation of the interface function.
	call collision	Call collision occurred.
	call timeout	The call timer expired for an outgoing call attempt.
	dte disabled	The local DTE was disabled by network management.
	level 2 failure	A failure occurred at the Frame level link or below.
	local reject	The X.25 Access module rejected an incoming call attempt.
	network clear	A Clear packet with a network cause code was received.
	no resources	Insufficient resources to handle call.
	no taker	Incoming call attempt rejected on timeout with no response from X.25 Access module.
	remote reject	Disconnect initiated by network or remote DTE.
	restart received	A Restart packet was sent by the DCE.
	security	An implementation-specific access criterion was violated.
remote dte	Address of the DTE that is the source of an incoming call or the destination of an outgoing call.

26.2.7 Exception Messages

For enable:

incompatible data sizes

The level 2 link service provider has not been configured for a sufficiently large data size. The level 2 link service data size must be at least 260 and at least the DTE maximum packet size +4.

incompatible profiles

There is a mismatch between the x.25 Protocol DTE profile and the link service provider profile.

insufficient information

inbound dte class, link service provider or x25 address characteristics necessary for the successful completion of the operation has not been set.

link service provider error

Level 2 link service provider has flagged an error.

link service provider in use

Another Network layer entity is already using the specified link service provider.

no such link service provider

The link service provider specified in the DTE does not exist.

26.3 x25 protocol dte pvc

channel integer

Concatenated logical channel group and logical channel number for the PVC. It should be a unique value among PVCs on this DTE. This channel number must not be present in the incoming list or outgoing list of the parent DTE. This argument determines the value of the channel characteristic.

packet size integer

Packet size, in octets, for the PVC. This argument determines the value of the packet size characteristic. This value should be within the maximum and minimum packet size specified for the parent DTE.

window size integer

Window size for the PVC. This argument determines the value of the window size characteristic. This value should be within the maximum and minimum window size specified for the parent DTE.

acl

Default: No access control list

Value: Access-control-list

Access control list that controls access to this PVC.

channel

Default: No default

Value: 0--4095

Concatenated logical channel group and logical channel number for the PVC. The value of this characteristic derives from an argument to the create command.

packet size

Default: No default

Value: 16--4096

Packet size for the PVC, in octets. The value must be a power of 2 in the range 16 to 4096. The value of this characteristic derives from an argument to the create command.

window size

Default: No default

Value: 1--127

Window size for the PVC. The value of this characteristic derives from an argument to the create command.

These counters record values over the lifetime of a PVC. For counters that refer to use of the PVC by individual clients, see the x25 access port entity.

accesses blocked

Number of times an attempt to open a PVC has failed because of security.

creation time

Time at which this entity was created.

data octets received

Number of octets received by the PVC since it was created.

data octets sent

Number of octets sent by the PVC since it was created.

data pdus received

Number of data PDUs received by the PVC since it was created.

data pdus sent

Number of data PDUs sent by the PVC since it was created.

pvc failures

Number of times the PVC has failed while the entity has been allocated.

name

Simple name assigned to the PVC when it is created.

allocated

True if the PVC is allocated to a user. False if otherwise.

port

X.25 Access port with which the PVC is associated.

uid

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

pvc failed

Generated when an allocated PVC fails during the data phase.

Arguments:

cause	Cause code provided by some DCEs on some failures.
diagnostic	Diagnostic code provided by some DCEs on some failures.
failure reason	Why the PVC failed.
	DTE disabled	The local DTE was disabled by network management.
	level 2 failure	A failure occurred at the Frame level link or below.
	PVC deleted	The x25 protocol dte pvc entity has been deleted by network management.
	restart	Restart initiated by network or remote DTE, or sent by this DTE.

For create:

name not unique

The PVC entity is not unique at the gateway system. PVCs with the same name cannot exist under separate DTEs on a gateway system.

26.4 x25 protocol group

members

Default: No DTEs

Value: Set of records

DTEs on the local system that are members of the group. Format the values to specify a set of records. Each record consists of a name that identifies an X25 protocol dte entity and an integer (in the range 0 to 9999) that identifies the CUG number assigned by the network. If a DTE is already created and enabled and is then added to the set of members, it must be disabled and re-enabled to service the specified CUG number or bilateral closed user group (BCUG).

remote dte address

Default: No DTE address

Value: DTE-address

DTE address to be associated with this entity for matching x25 access security dte class remote dte entities for both incoming and outgoing calls. This characteristic is only supported if the characteristic type is bcug.

type

Default: BCUG

Value: CUG, BCUG, or CUGOA

Type of the closed user group (CUG).

cug	Normal CUG.
bcug	Bilateral CUG (BCUG).
cugoa	CUG outgoing access.

creation time

Time at which this entity was created.

incoming calls blocked

Number of times an incoming call to a BCUG has been blocked by security from accessing a filter.

outgoing calls blocked

Number of times a call has been blocked by security from accessing this BCUG.

name

Simple name assigned to the group when it is created.

uid

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

For delete:

referenced dte enabled

One or more of the DTEs referenced by this group is still enabled.

This chapter describes all the commands you can use to manage the entities that constitute the X.25 Relay module. The X.25 Relay module resides in the application layer of the Digital Network Architecture (DNA). It interfaces with the X.25 Access module to receive an incoming switched virtual call and then makes an outgoing call through the X.25 Access module. Facilities also exist for relaying permanent virtual circuits (PVCs).

Figure 27-1 shows the hierarchical relationship of the entities that constitute the X.25 Relay module.

Figure 27-1 Hierarchy of X.25 Relay Module Entities

27.1 x25 relay

maximum active connections

Maximum number of active connections supported.

maximum active connections

Maximum number of active connections supported by this module. This characteristic is an optional argument on the create command. You cannot modify this characteristic.

version

Version number of the X.25 Relay architecture to which this implementation conforms. You cannot modify this attribute.

27.2 x25 relay client

dte class

Default: No dte class

Value: Simple-name

Name of the x25 access dte class entity to use when making the outgoing call.

filters

Default: No filters

Value: Set of simple-names

Set of filters that are listened to by this client. Each name is the name of an x25 access filter entity. For the add and set commands, the x25 relay client entity must be in the Off state before the filters attribute can be modified.

rights identifiers

Default: No rights identifiers

Value: Set of simple-names

Set of rights identifiers that this client possesses. It is used when placing the outgoing call.

template

Default: No template

Value: Simple-name

Name of the x25 access template entity to be used for the outgoing call.

connections failed

Number of times a connection setup has failed.

connections lost

Number of times a successfully established connection has been abnormally terminated.

connections made

Number of connections that have been made successfully.

creation time

Time at which this entity was created.

name

Simple name assigned to the client when it is created.

active connections

Number of connections that are currently active on this client. A connection is a pair of incoming/outgoing calls. This value does not include connections that are still waiting to be established.

state

State of the x25 relay client entity.

off	The entity is disabled.
on	The entity is enabled.

uid

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

connection failed

Generated when a connection cannot be established.

Arguments:

call accept reason	Error returned when attempting to accept the incoming call. Only present if the reason argument is call accept failure.
	cleared by directive
	invalid parameter
	no such port
	service not available
destination dte	DTE address of the called DTE.
destination nsap	Called address extension supplied in the Call packet.
outgoing failure reason	Error returned when attempting to make the outgoing call. Only present if the reason argument is outgoing call failure.
	called address not reachable
	cleared by directive
	destination not known
	dte class members not active
	dte class not known
	dte class not specified
	incompatible reserved lcn
	invalid parameter
	no such port
	no such template
	security failure
	service not available
	transit not allowed

reason	Whether the connection failed at the incoming or outgoing stage.
	call accept failure	The client could not accept the incoming call.
	outgoing call failure	The client could not make the outgoing call.
sending dte	DTE address of the calling DTE.
sending nsap	Calling address extension supplied in the Call packet.

connection lost

Generated when a connection that has been successfully established is abnormally terminated.

Arguments:

cause	X.25 cause code provided by the clearing DTE. Only present if the reason argument is calling dte clear or called dte clear.
destination dte	DTE address of the called DTE.
destination nsap	Called address extension supplied in the Call packet.
diagnostic	X.25 diagnostic code provided by the clearing DTE. Only present if the reason argument is calling dte clear or called dte clear.
network error reason	Reason why the connection was lost. This argument is present only if reason is network error.
reason	Reason for the loss of the connection.
	called dte clear	The remote call was abnormally terminated.
	calling dte clear	The local call was abnormally terminated.
	network error	The cause of the connection loss is given by network error reason.
sending dte	DTE address of the calling DTE.
sending nsap	Called address extension supplied in the Call packet.

For enable:

filter in error

The filters specified in the filters characteristic cannot be used for one of the following reasons:

filters in use	The named filters are already in use.
no such filters	The named filters do not exist.

insufficient information

One or more characteristics have not been specified.

---

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

---

  NCL_PROFILE_033.HTML
  OSSG Documentation
   2-DEC-1996 12:48:56.16

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal