![[Digital logo]](../../IMAGES/DIGITAL-LOGO.GIF)
![[HR]](../../IMAGES/REDBAR.GIF)
DECnet-Plus
Network Control Language Reference
Previous
| Contents
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.
group
Name of the x25 protocol group entity (that is, closed user
group (CUG)) associated with an incoming or 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.
incoming packet size
Packet size, in octets, for incoming data on a virtual circuit. This
attribute is supported only if the status attribute state is
not set to open.
incoming throughput class
Throughput class for incoming data on a virtual circuit.
incoming window size
Window size for incoming data on a virtual circuit.
local dte
Name of the DTE entity associated with the call.
originally called address
If a call is redirected, this is the DTE address from which the call
was redirected; otherwise, the address is null. This status is valid
only if the status attribute redirect reason is not not
redirected. 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.
outgoing packet size
Packet size, in octets, for outgoing data on a virtual circuit. This
attribute is supported only if the status attribute state is
not set to open.
outgoing throughput class
Throughput class for outgoing data on a virtual circuit.
outgoing window size
Window size for outgoing data on a virtual circuit. This attribute is
supported only if the status attribute state is not set to
open.
protocol identifier
First four octets of call data in the 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.
pvc
Name of the PVC to which this port belongs. This attribute is present
only if the status attribute port type is set to permanent.
redirect reason
Specifies whether a call has been redirected and, if so, the reason for
the redirection.
|
busy
|
The call has been redirected because the original destination was busy.
|
|
not redirected
|
The call has not been redirected.
|
|
out of order
|
The call has been redirected because the original destination was not
operational.
|
|
systematic
|
The call has been redirected because all calls to the original
destination have been systematically redirected.
|
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.
remote port
Port at the source (that is, accessing) node (when the client is an
X.25 server).
reserved
If the port is associated with a reserved logical channel number (LCN),
this specifies the name of the local DTE entity on which the LCN is
reserved. A null string indicates that the port is not associated with
a reserved LCN. 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.
reverse charging
Specifies whether reverse charging is in operation for the 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.
state
Status of the x25 access port entity.
|
called
|
A call has been received and taken by a user.
|
|
calling
|
A user is making a call.
|
|
cleared
|
A Clear Indication or Clear Confirmation packet has been received, or
the X.25 Protocol module has detected an error.
|
|
cleared by directive
|
The port was cleared by network management.
|
|
clearing
|
A user has requested that the call should be cleared.
|
|
no communication
|
Communications with the PSDN have been lost.
|
|
open
|
The port is open.
|
|
running
|
The associated virtual circuit is available for data transfer.
|
|
synchronizing
|
A user has requested a reset, but the network has not yet responded
with a Reset Confirmation or Reset Indication packet.
|
|
unsynchronized
|
A Reset Indication packet has been received, or the X.25 Protocol
module has detected an error and the user has not yet responded with a
reset request.
|
target address extension
Called NSAP address that is transparently carried 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.
target dte address
Called DTE address in a call request or incoming 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.
type
Specifies that the port represents an SVC.
|
switched
|
The circuit is an SVC.
|
|
permanent
|
The circuit is a PVC.
|
An x25 access reachable address entity maps a destination
network service access point (NSAP) address in an outgoing call to a
DTE class/DTE address pair.
The address-name refers to the address managed by this command.
create [node node-id] x25 access reachable
address address-name address prefix address-prefix
delete [node node-id] x25 access reachable
address address-name
set [node node-id] x25 access reachable
address address-name {address extensions boolean |
address prefix address-prefix | destination
dte-address | dte class class-name | mapping
enumerated-type }
show [node node-id] x25 access reachable
address address-name [all [attributes] | all characteristics |
all identifiers ]
address prefix address-prefix
Leading substring of an NSAP address associated with this reachable
address entity.
24.6.2 Characteristic Attributes
address extensions
|
Default: True
|
Value: True or false
|
Specifies whether the "called address extension" and
"calling address extension" fields are to be included in the
outgoing call packet.
address prefix
Address prefix to trigger the use of DTE class and destination.
Supplied as an argument to the create command. You cannot
modify this characteristic.
destination
|
Default: No DTE address
|
Value: DTE address
|
Manually entered DTE address. This address is used only if the
mapping characteristic has the value manual.
dte class
|
Default: No class name
|
Value: Class name
|
Name of the DTE class to be used in making the outgoing call. If not
specified, any DTE class may be used.
mapping
|
Default: X.121
|
Value: Manual or X.121
|
Mechanism by which the destination DTE address is to be derived.
|
manual
|
The destination DTE address is supplied manually by means of the
destination characteristic.
|
|
X.121
|
The destination DTE address is derived by an algorithm from an NSAP
address in X.121 format. X.121 address mapping may only be specified
with address prefixes of 36, 37, 49, 52 and 53.
|
24.6.3 Identifier Attributes
name
Simple name assigned to the reachable address when it is created.
24.6.4 Exception Messages
For create:
address prefix not unique
A reachable address with the specified prefix already exists.
An x25 access security dte class entity is used to control
inbound and outbound calls. The class-name refers to the class
managed by this command.
create [node node-id] x25 access security dte
class class-name
delete [node node-id] x25 access security dte
class class-name
show [node node-id] x25 access security dte
class class-name [all [attributes] | all identifiers | all
status ]
24.7.1 Identifier Attributes
name
Simple name assigned to the security DTE class when it is created.
24.7.2 Status Attributes
guarded dte classes
Names of the DTE classes that are protected by this security DTE class.
An x25 access security dte class remote dte entity is a
collection of access control attributes that control inbound calls from
and outbound calls to a set of remote DTEs.
add [node node-id] x25 access security dte
class class-name remote dte dte-name rights
identifiers [set]
create [node node-id] x25 access security dte
class class-name remote dte dte-name remote address
prefix dte-address-prefix
delete [node node-id] x25 access security dte
class class-name remote dte dte-name
remove [node node-id] x25 access security dte
class class-name remote dte dte-name rights
identifiers [set]
set [node node-id] x25 access security dte
class class-name remote dte dte-name {acl
access-control-list | rights identifiers [set] }
show [node node-id] x25 access security dte
class class-name remote dte dte-name [all
[attributes] | all characteristics | all counters | all identifiers |
all status ]
24.8.1 Arguments
remote address prefix remote-address-prefix
Leading substring of a DTE address associated with this remote address
entity. Wildcards may be used in the address prefix.
24.8.2 Characteristic Attributes
acl
|
Default: No acl
|
Value: Access control list
|
Access control list (ACL) that is used when checking outbound calls to
the set of DTE addresses that this remote DTE represents. Wildcards may
be used in the identifiers that form part of each access control entry
(ACE) in an access control list.
remote address prefix
DTE address prefix for this remote DTE. The value of this
characteristic is specified by the remote address prefix
argument in the create command. You cannot modify this
characteristic.
rights identifiers
|
Default: No rights identifiers
|
Value: Set of names
|
Rights identifiers possessed by this remote DTE. It is used for
incoming call checking against the ACL attribute of a security
filter entity that is used to guard a filter.
creation time
Time at which the entity was created.
incoming calls blocked
Number of times an incoming call that matched the remote address prefix
for this remote DTE has been blocked by security.
outgoing calls blocked
Number of times an outgoing call that matched the remote address prefix
for this remote DTE has been blocked by security.
24.8.4 Identifier Attributes
name
Simple name assigned to the remote DTE when it is created.
24.8.5 Status Attributes
uid
Entity's unique identifier, which is generated when the entity is
created.
An x25 access security filter entity is a collection of access
control attributes that controls access to one or more filters. The
filter-name refers to the filter managed by this command.
create [node node-id] x25 access security
filter filter-name
delete [node node-id] x25 access security
filter filter-name
set [node node-id] x25 access security filter
filter-name acl access-control-list
show [node node-id] x25 access security
filter filter-name [all [attributes] | all characteristics |
all identifiers | all status ]
24.9.1 Characteristic Attributes
acl
|
Default: No acl
|
Value: Access control list
|
Access control list (ACL) that is used for checking inbound calls for
all filters using this security filter. Wildcards may be used in the
identifiers that form part of each access control entry (ACE) in an
access control list.
24.9.2 Identifier Attributes
name
Simple name assigned to the security filter when it is created.
24.9.3 Status Attributes
guarded filters
Names of the x25 access filters that are protected by this
security filter.
An x25 access template entity is used to supply default values
for call parameters when an outgoing call is made. Values in a template
can be overridden by user-supplied values.
add [node node-id] x25 access template
template-name rpoa sequence [set]
create [node node-id] x25 access template
template-name
delete [node node-id] x25 access template
template-name
remove [node node-id] x25 access template
template-name rpoa sequence [set]
set [node node-id] x25 access template
template-name {call data hex-string | calling address
extension nsap-address | charging information boolean
| destination dte address dte-address | dte class
class-name | end-to-end delay range | expedited data
string | fast select string | local facilities
hex-string | local subaddress dte-address | network
user identity hex-string | nsap mapping boolean |
packet size integer | quality of service hex-string |
reverse charging boolean | rpoa sequence [set] | selected
group group-name | target address extension
nsap-address | throughput class request range |
transit delay selection range | window size integer }
show [node node-id] x25 access template
template-name [all [attributes] | all characteristics | all
identifiers ]
24.10.1 Characteristic Attributes
call data
|
Default: No call user data
|
Value: Hex-string
|
Call user data to be sent in the call.
calling address extension
|
Default: No NSAP address
|
Value: NSAP address
|
Calling network service access point (NSAP) address is to be passed to
a higher-level entity within the called DTE. A null address indicates
that this facility is not included in the outgoing call.
charging information
|
Default: False
|
Value: True or false
|
Specifies whether charging information is requested for this call.
destination dte address
|
Default: No DTE address
|
Value: DTE address
|
Address of the remote DTE, including the remote subaddress (if any), to
which the call is directed.
dte class
|
Default: No DTE class name
|
Value: Class name
|
Name of the DTE class to be used for the call.
end-to-end delay
|
Default: [0..0]
|
Value: Range (see description)
|
Lower and upper bounds of the acceptable end-to-end delay for the call.
A zero value for either bound indicates that no range is included in
the outgoing call.
expedited data
|
Default: Not specified
|
Value: See description
|
Specifies whether expedited data is requested for the call.
|
do not use
|
Expedited data is not in use.
|
|
not specified
|
Expedited data is not requested.
|
|
use
|
Expedited data is in use.
|
fast select
|
Default: Not specified
|
Value: See description
|
Specifies whether fast select is requested for the call.
|
fast select
|
Fast select is in use.
|
|
no fast select
|
Fast select is not in use.
|
|
not specified
|
Fast select is not requested.
|
|
with response
|
Fast select with response is in use.
|
local facilities
|
Default: No facilities
|
Value: Hex-string
|
Non-CCITT facilities that are available from the local PSDN. The string
is placed in the outgoing call request packet without modification. The
contents and interpretation of this string are implementation-dependent.
local subaddress
|
Default: No DTE address
|
Value: DTE address
|
Local subaddress to be appended to the calling DTE address in the call.
network user identity
|
Default: No network user identity
|
Value: Hex-string
|
Network user identity to be included in the call packet. The format of
the network user identity is specified by the PSDN administration.
nsap mapping
|
Default: False
|
Value: True or false
|
Specifies whether an x25 access reachable address entity is
used to map the supplied NSAP address to a destination DTE class/DTE
address pair.
packet size
|
Default: Supplied by profile
|
Value: 0--4096
|
Packet size, in octets, for transmitted and received data packets. The
value must be a power of 2 in the range 0 to 4096. The value zero
indicates that no packet size is included in the outgoing call.
quality of service
|
Default: No data
|
Value: Hex-string
|
Quality of service data. The contents and interpretation of this string
are implementation-dependent.
reverse charging
|
Default: False
|
Value: True or false
|
Specifies whether reverse charging is requested for the call.
rpoa sequence
|
Default: No DTE addresses
|
Value: Set of DTE addresses
|
Private operating agency sequence of transit networks to be used in
setting up the call. Format the values to specify a set of DTE
addresses. Each DTE address is four digits long. An empty set indicates
that no sequence is included in the outgoing call.
selected group
|
Default: No group name
|
Value: Group name
|
Name of the x25 protocol group entity that represents the
closed user group (CUG) selected for the call. The index for group is
included in the facility field of the call request packet.
target address extension
|
Default: No NSAP address
|
Value: NSAP address
|
Called NSAP address to be sent to the called DTE should be supplied by
a higher-level entity in the calling DTE. A null address indicates that
this facility is not required.
throughput class request
|
Default: [0..0]
|
Value: Range (see description)
|
Minimum acceptable throughput class (the lower bound of the range) and
the target throughput class (the upper bound of the range) for a call.
The only legal values within the range are as follows:
|
0
|
2400
|
|
75
|
4800
|
|
150
|
9600
|
|
300
|
19200
|
|
600
|
48000
|
|
1200
|
|
The range 0--0 indicates that no throughput class is included in the
outgoing call.
transit delay selection
|
Default: 0
|
Value: Integer
|
Desired transit delay. A zero value indicates that no value is included
in the outgoing call.
window size
|
Default: Supplied by profile
|
Value: 0--127
|
Window size for transmitted and received data packets. A zero value
indicates that no window size is included in the outgoing call.
24.10.2 Identifier Attributes
name
Name assigned to the template when it is created.
Chapter 25
X.25 Client Module (OpenVMS)
This chapter describes all the commands used to manage the X.25 Client
entity. The X.25 Client module resides in the Application layer of the
Digital Network Architecture (DNA). It interfaces with the X.25 Access
module to establish communications with its X.25 Server system over a
DNA Session Control connection using the Gateway Acess Protocol (GAP).
Figure 25-1 shows the hierarchical relationship of the entities that
constitute the X.25 Client module.
Figure 25-1 Hierarchy of X.25 Client Module Entities
The x25 client entity describes the X.25 client interface in
an accessing system, through which X.25 clients gain access to a PSDN
via an X.25 server in a gateway system.
create [node node-id] x25 client {incoming
session template simple-name | maximum session connections
integer }
delete [node node-id] x25 client
disable [node node-id] x25 client
enable [node node-id] x25 client
show [node node-id] x25 client [all
[attributes] | all characteristics | all counters | all status ]
25.1.1 Arguments
maximum session connections integer
Maximum number of concurrent Session Control connections that can be
supported by the X.25 Client module. This argument determines the value
of the maximum session connections characteristic. If not
specified, the implementation-specific default value of the
characteristic maximum session connections is used.
25.1.2 Characteristic Attributes
incoming session template
The Session Control template specified for an open/incoming connection
at the end-user Session Control interface. This characteristic is an
optional argument on the create command.
maximum session connections
|
Default: None
|
Value: 1--65535
|
Maximum number of Session Control connections supported by this module.
This characteristic is an optional argument on the create
command. You cannot modify this characteristic.
version
|
Default: Current version number
|
|
Version number of the X.25 Gateway Access Protocol (GAP) to which the
implementation conforms. You cannot modify this characteristic.
25.1.3 Counter Attributes
connection attempts failed
Number of Session Control connect requests that have failed prematurely
or that have been rejected by the X.25 server at the gateway system.
creation time
Time at which this entity was created.
times session control unavailable
Number of times Session Control was not found or state of Session
Control was not enabled.
25.1.4 Status Attributes
active inbound session connections
Number of inbound Session Control connections to the X.25 Client module.
active outbound session connections
Number of outbound Session Control connections to the X.25 Client
module.
state
Current state of the entity (on or off).
uid
Entity's unique identifier, which is generated when the entity is
created.
25.1.5 Event Messages
server connect rejected
Generated when a requested connection to an X.25 gateway system is
rejected.
Previous
| Next
| Contents
| [Home]
| [Comments]
| [Ordering info]
| [Help]
NCL_PROFILE_031.HTML
OSSG Documentation
2-DEC-1996 12:48:51.00
Copyright © Digital Equipment Corporation 1996. All Rights Reserved.
Legal