[Digital logo]
[HR]

DECnet-Plus
Network Control Language Reference

Previous | Contents

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

An X25 access application entity defines an application to be executed for an incoming call. The application-name refers to the application managed by this command. An application type may be one of the following:
add [node node-id] x25 access application application-name filters [set]
create [node node-id] x25 access application application-name
delete [node node-id] x25 access application application-name
disable [node node-id] x25 access application application-name
enable [node node-id] x25 access application application-name
remove [node node-id] x25 access application application-name filters [set]
set [node node-id] x25 access application application-name {account string (Digital UNIX) | activation data string (Digital UNIX) | file string | filters [set] | maximum activations integer (Digital UNIX) | template simple-name (Digital UNIX) | type enumerated | user string }
show [node node-id] x25 access application application-name [all [attributes] | all characteristics | all identifiers | all status ]

24.2.1 Characteristic Attributes

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.

24.2.2 Identifier Attributes

name

Simple name assigned to the application when it is created.

24.2.3 Status Attributes

state

Default: None Value: On(0), Off(1)
State of the application. This state can be changed by invoking the enable and disable directives.

24.2.4 Exception Messages

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

An x25 access dte class entity defines a named class of DTEs. The class-name refers to the class managed by this command. A DTE class may refer to either of the following:
add [node node-id] x25 access dte class class-name local dtes [set]
create [node node-id] x25 access dte class class-name, type string profile profile-name
delete [node node-id] x25 access dte class class-name
remove [node node-id] x25 access dte class class-name local dtes [set]
set [node node-id] x25 access dte class class-name {account string (OpenVMS) | DNIC DTE address | international prefix DTE address | local dtes [set] | local prefix DTE address | node full-name (OpenVMS VAX) | outgoing session template string (OpenVMS) | profile string | security dte class name | service nodes [set] (OpenVMS Alpha) | strip DNIC boolean | type | user string (OpenVMS) }
show [node node-id] x25 access dte class class-name [all [attributes] | all characteristics | all identifiers | all status ]

24.3.1 Arguments

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.

24.3.2 Characteristic Attributes

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.

24.3.3 Identifier Attributes

name

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

24.3.4 Status Attributes

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).

24.3.5 Exception Messages

For delete:

inbound DTE class

The DTE class is referenced by an enabled DTE.

24.4 x25 access filter

An x25 access filter entity defines the criteria by which the destination of an incoming call is determined. The filter-name refers to the filter managed by this command.
create [node node-id] x25 access filter filter-name
delete [node node-id] x25 access filter filter-name
set [node node-id] x25 access filter filter-name {call data mask hex-string | call data value hex-string | called address extension mask hex-string | called address extension value hex-string | called nsap nsap-address (Digital UNIX) | group group-name | inbound dte class class-name | incoming dte address dte-address | originally called address dte-address | priority integer | receiving dte address dte-address | redirect reason string | security filter filter-name | sending dte address dte-address | subaddress range one-range-set (OpenVMS VAX) }
show [node node-id] x25 access filter filter-name [all [attributes] | all characteristics | all counters | all identifiers | all status ]

24.4.1 Characteristic Attributes

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.

24.4.2 Counter Attributes

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.

24.4.3 Identifier Attributes

name

Simple name assigned to the filter when it is created.

24.4.4 Status Attributes

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

An x25 access port entity represents an X.25 virtual circuit. Ports are created and deleted automatically as circuits are established and cleared. The port-name refers to the port managed by this command
clear [node node-id] x25 access port port-name
show [node node-id] x25 access port port-name [all [attributes] | all counters | all identifiers | all status ]

24.5.1 Counter Attributes

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.

24.5.2 Identifier Attributes

name

Simple name assigned to the port when it is created.

24.5.3 Status Attributes

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]

[HR] 

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

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal