DECnet-Plus
Network Control Language Reference

Arguments:

blocked by	Where the blocking occurred.
	gateway security	At the gateway system
	local security	At the accessing system
client	Name of the entity that attempted to use the PVC.
pvc	Name of the PVC.
source	Name of the entity that attempted to use the PVC. This identifies the client of X.25 Access module at the accessing system when the call is blocked by security on a gateway system. This argument is mandatory only when the client of the X.25 Access module is the X.25 Server module.

24.2 x25 access application

• X.25
• X.29
• X.29 Login

account (Digital UNIX)

Default: No service/account data

Value: String

Default service or account identifier to be used when starting the applications process.

activation data (Digital UNIX)

Default: None

Value: String

Data required to start the application process. This characteristic is optional. This attribute is not valid for an application of type X29 login.

file

Default: None

Value: Filename

Indicates the file name or command that is associated with starting a process for the represented application. This attribute is not valid for an application of type X29 login.

filters

Default: None

Value: Set of names

Set of filters that are associated with filtering calls for either X.25 or X.29 applications represented by this entity.

maximum activations (Digital UNIX)

Default: 1

Value: 1--65535

Maximum number of concurrent activations of the represented application that are possible. This characteristic is optional.

template (Digital UNIX)

Default: No template

Value: String

Template used by the application process to accept the incoming call. Attempting to set this attribute for an application of type X25 is not valid, and will generate a constraint error.

type

Default: X25(0)

Value: Enumerated (see description)

Specifies the type of application.

X25(0)	This application operates in X.25 mode
X29(1)	This application operates in character mode.
X29 login(2)	This is an application of X.29 type devoted specifically to login sessions.

user

Default: No user ID

Value: String

Default user identification to be used to start the application process. This attribute is not valid for an application of type X29 login.

name

Simple name assigned to the application when it is created.

state

Default: None

Value: On(0), Off(1)

State of the application. This state can be changed by invoking the enable and disable directives.

For enable:

filter in error

One or more of the filters named in the filters characteristic does not exist, or is in use.

insufficient information

One or more characteristics have not been specified.

non null file value

If type is X29 login, the file characteristic must have a null value.

non null user value

If type is X29 login, the user characteristic must have a null value.

no resource available (Digital UNIX)

The X.25 application daemon is not running.

24.3 x25 access dte class

• A group of local DTEs.
• A group of DTEs on a remote gateway system.

profile profile-name

Profile used to supply default values for the X.121 mapping attribute in this entity.

type string

Type of DTE class. Can be specified as either local or remote.

account (OpenVMS)

Default: No service/account data

Value: String

Default service or account data to be used when connecting to the X.25 server on the gateway system specified by the node characteristic or service node characteristic. This attribute is supported only for DTE classes with characteristic type remote.

DNIC

Default: Supplied by profile

Value: DTE address of 3 or 4 digits length

The first part of the network user address (NUA). This takes one of two forms: Either it is in the form of the data network identification code (DNIC) and is specified by four digits, or it is in the form of a data country code (DCC) and is specified by three digits. If no profile is specified, the default is null.

international prefix

Default: Supplied by profile

Value: DTE address of 1 digit only.

First digit of an X.121 address to indicate an international or internetwork call. If no profile is specified, the default is a null DTE address.

local dtes

Default: No names

Value: Set of names

Names of the local x25 protocol dte entities that belong to this DTE class. Note that these DTE entities need not exist when their names are entered in this set; DTEs that do not exist when the DTE class is used are not considered when the DTE class is used for an outgoing call.

If an x25 protocol dte entity has status attribute state set to running when its name is added to local dtes, you must disable the DTE entity and reenable it (see the disable x25 protocol dte and enable x25 protocol dte commands) in order for the DTE to be considered when this DTE class is used for an outgoing call.

You can specify this characteristic only for DTE classes with characteristic type local.

local prefix

Default: Supplied by profile

Value: DTE address of 1 digit only.

First digit of a DTE address to indicate a local call. If no profile is specified, the default is a null DTE address.

node (OpenVMS)

Default: No name

Value: Fullname

Node name of the remote gateway system on which the DTEs in this DTE class reside. Note that this characteristic is supported only if the service nodes characteristic is not supported.

This characteristic is supported only for DTE classes with type characteristic set to remote.

outgoing session template (OpenVMS)

Default: Default or no name (see description)

Value: String

Name of the OSI transport template to be used by the X.25 client to connect to the X.25 server on the gateway system. The default value default is valid only if OSI Session Control is being used. This attribute is supported only for DTE classes with characteristic type remote.

profile

Default: No profile

Value: String

Name of the profile that supplies the information required to perform X.121 mapping to or from a simple DTE address. The profile supplies the default values for the International prefix, Local prefix, DNIC and strip DNIC characteristics. This characteristic is specified by the profile argument in the create command. This argument is optional.

security dte class

Default: Default

Value: Name

Name of the x25 access security dte class entity that controls inbound and outbound access using this DTE class.

service nodes (OpenVMS Alpha)

Default: No records

Value: Set of records

Names of the nodes that may be used as candidate X.25 gateway systems and their associated ratings. Each record consists of a full name that describes the candidate node and an integer that indicates its ratings. The records are listed in order of descending rating. Values are entered as [node=nodename, rating=integer]. The rating represents the maximum number of Session Control connections to the node pair.

strip DNIC

Default: False

Value: True or false

Defines whether the first part of the NUA (the DNIC or DCC specified by the DNIC characteristic) should be stripped for outgoing calls, and whether the network strips the first portion of the NUA from addresses it presents to the DTE.

type

Type of DTE class.

local	The DTE class consists of local DTEs.
remote	The DTE class consists of DTEs on a remote gateway system.

The value of this characteristic is specified by the type argument in the create command.

user (OpenVMS)

Default: No user ID

Value: String

Default user identification to be used when connecting to the gateway system specified by the service nodes characteristic.

name

Simple name assigned to the DTE class when it is created.

usable dtes

Set of DTEs that are enabled and belong to this DTE class. For outgoing calls, a DTE is picked from this set if it is eligible (that is, if its status attribute state is set to running). If there is more than one eligible DTE, a round-robin algorithm is used to select one of the eligible DTEs. A DTE is added to the set when it is enabled, and is removed from the set when it is disabled (see the enable x25 protocol dte and disable x25 protocol dte commands).

For delete:

inbound DTE class

The DTE class is referenced by an enabled DTE.

24.4 x25 access filter

call data mask

Default: No mask

Value: Hex-string

Mask to be applied to call user data in an incoming call. The result is compared, octet by octet, with the call data value characteristic.

call data value

Default: No call user data

Value: Hex-string

Call user data value to be matched by this filter. This value is compared, octet by octet, with the masked call user data in the call request. This string must have the same length as the string specified for the call data mask characteristic.

called address extension mask

Default: No called address extension mask

Value: Hex-string

Mask to be applied to the called address extension in an incoming call. The result is compared, octet by octet, with the called address extension value characteristic.

called address extension value

Default: No called address extension value

Value: Hex-string

Called address extension value to be matched by this filter. This value is compared, octet by octet, with the masked called address extension value. This string must have the same length as the string specified in the called address extension mask characteristic.

called nsap

Default: No NSAP address

Value: NSAP address

Value to be matched against the called address extension field of an incoming call packet when the field contents are encoded in ISO format.

group

Default: No group name

Value: Group name

Name of the x25 protocol group entity to be matched by this filter. The DTE must belong to this group for the filter to match. Wildcards can be used in the group name.

inbound dte class

Default: No DTE class

Value: Class name

Name of the DTE class to be matched by this filter. The DTE must belong to this DTE class for the filter to match. This is the DECnet-Plus mechanism for specifying a local receiving DTE; see also the description of the receiving dte address characteristic. Wildcards can be used in the class name.

incoming dte address

Default: No DTE address

Value: DTE address

Value to be matched with the "called address" field of an incoming call packet. Wildcards can be used in the incoming DTE address.

originally called address

Default: No address

Value: DTE address

Value to be matched with the "originally called address" field of an incoming call that has been redirected. Wildcards can be used in the originally called DTE address.

priority

Default: 1

Value: 0--65535

Filter's position in an ordered set of filters used for matching incoming calls.

receiving dte address

Default: No DTE address

Value: DTE address

Address that is used to match the DTE address of the local receiving DTE. This characteristic is included for backward compatibility with Phase IV; the DECnet-Plus mechanism uses the dte class characteristic. Wildcards can be used in the receiving DTE address.

redirect reason

Default: Not specified

Value: See description

Reason for matching a call that has been redirected.

busy	The original destination was busy.
not specified	Redirection was not checked.
out of order	The original destination was not operational.
systematic	Calls to the original destination are systematically redirected.

This value must be the same as the redirect reason in the call request for the filter to match.

security filter

Default: Default

Value: Security filter

Name of the x25 access security filter entity that controls access to this filter. Wildcards can be used in the security filter name.

sending dte address

Default: No DTE address

Value: DTE address

Value to be compared with the "calling address" field of an incoming call packet. These values must be the same for the filter to match. Wildcards can be used in the sending DTE address.

subaddress range (OpenVMS VAX)

Default: No range

Value: Set of one range

Subaddress range value to be matched by this filter. Format the values to specify this subaddress range. This set must either be empty or contain exactly one value. This attribute has been retired; it has been included to allow the value of the attribute to be seen, but it cannot be modified.

creation time

Time at which this entity was created.

incoming calls blocked

Number of times an incoming call that matched this filter has been cleared by security.

name

Simple name assigned to the filter when it is created.

listener

When the status attribute state is set to in use, this specifies the name of the entity that is the listener with which this filter is associated. When the status attribute state is set to free, this status is undefined.

state

Status of the x25 access filter entity.

free	The filter is not associated with a listener, and is, therefore, not currently used in matching incoming calls.
in use	The filter is associated with a listener, and is currently being used to match incoming calls.

uid

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

24.5 x25 access port

data octets received

Number of data octets received at the port.

data octets sent

Number of data octets sent by the port.

pdus received

Number of PDUs received at the port.

pdus sent

Number of PDUs sent by the port.

reference time

Time at which the port was created (if the circuit is a PVC), or the time at which the port was first used to send or receive a call at the X.25 user interface (if the circuit is an SVC).

segments sent

Number of segments of data sent by this port.

segments received

Number of segments of data received by this port.

name

Simple name assigned to the port when it is created.

call association

Name of the x25 access filter entity that matched an incoming call, or the name of the x25 access template entity used in making an outgoing call. This attribute is supported only if the status attribute port type is set to switched and the status attribute state is not set to open.

call direction

Direction of the call on an SVC.

incoming	The call is an incoming call.
outgoing	The call is an outgoing call.

This attribute is supported only if the status attribute port type is set to switched and the status attribute state is not set to open.

calling address extension

Calling NSAP address that is carried transparently in an incoming or outgoing call packet. This attribute is supported only if the status attribute port type is set to switched and the status attribute state is not set to open.

calling dte address

Calling DTE address in a call request or incoming call packet (depending on the value of the status attribute call direction). This attribute is supported only if the status attribute port type is set to switched and the status attribute state is not set to open.

channel

Channel number of the underlying virtual circuit. This status is valid only if the port is at a gateway system and the status attribute state is not open.

client

Name of the entity that opened the port.

dte class

Name of the DTE class to which the DTE of the underlying virtual circuit belongs. This attribute is supported only if the status attribute state is not set to open.

fast select

Specifies whether fast select is in operation for the call.

fast select	Fast select in operation.
no fast select	Fast select not in operation.
not specified	Facility not requested.
with response	Fast select with response in operation.

---

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

---

  NCL_PROFILE_030.HTML
  OSSG Documentation
   2-DEC-1996 12:48:48.58

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal