![[Digital logo]](../../IMAGES/DIGITAL-LOGO.GIF)
![[HR]](../../IMAGES/REDBAR.GIF)
DECnet-Plus
Network Control Language Reference
Previous
| Contents
An osi transport application entity stores information about
an end user that is activated for receipt of an incoming connection
request when the request contains that end user's name in its
Destination Name field. The application-name refers to the
application managed by this command.
create [node node-id] osi transport
application application-name
delete [node node-id] osi transport
application application-name
set [node node-id] osi transport application
application-name {called tsels hex-string | file name
filename | username "username" }
show [node node-id] osi transport application
application-name [all [attributes] | all characteristics | all
counters | all identifiers ]
20.2.1 Characteristic Attributes
called tsels
|
Default: No tsap
|
Value: Hex-string
|
A TSEL is a string of hexadecimal digits, the length of that string
should be an even number between 2 and 64, inclusive. This attribute
cannot have more than one member.
Transport service access point (TSAP) for which the image specified by
the image name characteristic accepts connections. This
characteristic, which is similar to the addresses
characteristic, is used by applications that do not use the DNA Session
Control protocol (for example, VOTS applications).
file name
|
Default: No file name
|
Value: File name
|
File name of the program to be invoked upon receipt of a connect
request containing a TSEL matching the "Called TSELS"
attribute of the application entity.
username
|
Default: No user name
|
Value: "User name"
|
User name portion of the access control information that identifies the
account under which the application is to run. If invalid information
or no user name is specified, system defaults are used to select the
user.
20.2.2 Counter Attributes
creation time
Time at which the entity was created.
20.2.3 Identifier Attributes
name
Simple name assigned to the application when it is created.
An OSI transport local NSAP entity is automatically created
for each NSAP address used by the osi transport entity. Local
NSAPs are used primarily to group together remote NSAPs (see the
OSI transport local NSAP remote NSAP entity). The
nsap-address refers to the local NSAP managed by this command.
show [node node-id] osi transport local nsap
address [all [attributes] | all counters | all identifiers |
all status ]
20.3.1 Counter Attributes
creation time
Time this entity was created.
deleted remote nsaps
Number of times a remote NSAP has been deleted in order to reclaim the
resources.
20.3.2 Identifier Attributes
name
Simple name assigned to the local NSAP when it is created.
20.3.3 Status Attributes
DTE address
|
Default: Entity DTE address
|
Value: DTE address
|
Address assigned to the DTE when it is created.
IP address
|
Default: Entity IP address
|
Value: IP address
|
Address assigned to the IP when it is created.
network service
|
Default: CLNS
|
Value: Any, CLNS, CONS, or RFC 1006 (OpenVMS)
|
Type of network service being used.
nsap address
|
Default: Entity NSAP Address
|
Value: NSAP address
|
NSAP address corresponding to entity.
uid
Entity's unique identifier, generated when the entity is created.
deleted remote nsap
This event is generated each time a remote NSAP is deleted.
Arguments: The event message lists all attributes for
the deleted entity.
An osi transport local nsap remote nsap entity maintains the
transport counters and generates events resulting from interactions
between its superior local NSAP and a remote transport service. The
nsap-address refers to the remote NSAP managed by this command.
show [node node-id] osi transport local nsap
address remote nsap address [all [attributes] | all
counters | all identifiers | all status ]
20.4.1 Counter Attributes
connectionless bytes received (Digital UNIX)
Number of bytes received in UD TPDUs from this remote service provider.
connectionless bytes sent (Digital UNIX)
Number of bytes sent in UD TPDUs to this remote service provider.
connects received
Total number of CR (connection request) TPDUs, regardless of their
disposition, that the local NSAP has received from the remote NSAP.
connects sent
Total number of CR (connection request) TPDUs sent by the local NSAP to
the remote NSAP, including retransmissions.
creation time
Time this entity was created.
duplicate pdus received
Total number of all types of detected duplicate TPDUs received from the
remote NSAP.
failed checksums
Number of checksum failure events detected.
local protocol errors
Number of reported local protocol error events. This event is generated
whenever an ER (error) TPDU is received from the remote NSAP.
pdus received
Total number of all types of TPDUs received from the remote NSAP
(excluding detected duplicates).
pdus sent
Total number of all types of TPDUs sent to the remote NSAP (excluding
retransmissions).
rejects received
Number of detected reject received events.
rejects sent
Number of detected reject sent events.
remote protocol errors
Number of reported invalid tpdu received events. This event is
generated whenever the remote NSAP violates the Transport Protocol.
retransmitted pdus
Total number of all types of retransmitted TPDUs sent to the remote
NSAP.
total octets received
Total number of octets of all types of TPDUs received from the remote
NSAP, regardless of their disposition. This count includes detected
duplicates.
total octets sent
Total number of octets of all types of TPDUs sent to the remote NSAP,
including retransmissions.
ud pdus received (Digital UNIX)
Number of UD TPDUs received from this remote service provider.
ud pdus sent (Digital UNIX)
Number of UD TPDUs sent to this remote service provider.
user octets received
Total number of user data octets received from the remote NSAP,
including normal, expedited, connect, accept, and disconnect data. This
count does not include duplicates such as data retransmitted by the
remote NSAP.
user octets sent
Total number of user data octets sent to the remote NSAP, including
normal, expedited, connect, accept, and disconnect data. This count
does not include data retransmitted by the local NSAP.
user pdus discarded
Number of PDUs received from the remote NSAP that were discarded
because of insufficient buffer space.
user pdus received
Total number of TPDUs containing user data received from the remote
NSAP, including normal, expedited, connect, accept, and disconnect
data. This count does not include duplicates such as TPDUs
retransmitted by the remote NSAP.
user pdus sent
Total number of TPDUs containing user data sent to the remote NSAP,
including normal, expedited, connect, accept, and disconnect data. This
count does not include retransmitted TPDUs.
20.4.2 Identifier Attributes
name
Simple name assigned to the remote NSAP when it is created.
20.4.3 Status Attributes
DTE address
Address assigned to the DTE when it is created.
IP address
Address assigned to the IP when it is created.
nsap address
Address assigned to the NSAP when it is created.
uid
Entity's unique identifier, generated when the entity is created.
20.4.4 Event Messages
checksum failure
Generated each time a checksum validation fails on a received TPDU.
er tpdu received
Generated whenever an ER (error) TPDU is received from the remote NSAP.
The local protocol error counter will be incremented.
Arguments:
|
DNA error (OpenVMS)
|
The unique error number used to unambiguously distinguish between
different errors. This number is completely independent of the
reason and
reject cause values defined by the OSI transport protocol, the
set of which is too sparse to provide useful information.
|
|
erroneous transport PDU
|
The portion of the
invalid TPDU received in the
invalid TPDU parameter of the ER TPDU.
|
|
reject cause
|
The value of the
reject cause parameter in the received ER TPDU.
|
invalid tpdu received
Generated when a TPDU received from the remote NSAP is in violation of
the OSI transport protocol. If the error occurred during connection
establishment, a DR (disconnect request) TPDU will be sent in response
to the protocol error. If the error occurred on an established
transport connection, an ER (error) TPDU will be sent in response to
the protocol error. The remote protocol error counter will be
incremented.
Arguments:
|
DNA error
|
The unique error number used to unambiguously distinguish between
different errors. This number is completely independent of the
reason and
reject cause values defined by the OSI transport protocol, the
set of which is too sparse to provide useful information.
|
|
erroneous transport PDU (OpenVMS)
|
The portion of the
invalid TPDU transmitted or received in the
invalid TPDU parameter of the ER or DR TPDU.
|
|
reject cause
|
If an ER TPDU was transmitted or received, this is the value of the
reject cause parameter. If a DR was transmitted, this is the
value of the
reason parameter.
|
local transport disconnection
Generated each time a connection attempt initiated by the remote NSAP
is rejected by the local NSAP. This does not include rejects generated
by the local user of the transport service. Thus, this event is
generated on the transmission of a DR TPDU in which the reason
parameter has a value other than 128. The reject sent counter
will be incremented.
|
DNA error
|
This is the value transmitted in the
additional information parameter of the DR TPDU.
|
remote transport disconnection
Generated each time a connection attempt initiated from the local NSAP
is rejected by the remote NSAP. This does not include rejects requested
by the remote user of the transport service. Thus, this event is
generated on the receipt of a DR TPDU in which the reason parameter has
a value other than 128 (which is a normal disconnect). The reject
received counter will be incremented.
Arguments:
|
reason
|
Reason why the event was generated and it is the value received in the
reason parameter of the DR TPDU.
|
|
additional information
|
The value received in the
additional information parameter of the DR TPDU. If the remote
NSAP is a DNA OSI transport implementation, the
additional information parameter will have one of the
following values:
|
|
|
'01'H
|
Too much user data in CR (connection request) or CC (connection
confirm) TPDU
|
|
|
'02'H
|
Proposed TPDU size invalid
|
|
|
'05'H
|
Invalid protocol class requested
|
|
|
'07'H
|
Illegal negotiation attempted
|
|
|
'08'H
|
Invalid parameter in TPDU
|
|
|
'09'H
|
TPDU header length invalid
|
|
|
'0A'H
|
Parameter length error in TPDU header
|
|
|
'0B'H
|
TPDU longer than negotiated maximum
|
|
|
'0C'H
|
Segmentation of expedited data illegal
|
|
|
'0D'H
|
Invalid parameter value
|
|
|
'10'H
|
Invalid TPDU type
|
|
|
'12'H
|
Expedited data out of sequence
|
|
|
'40'H
|
Unknown transport selector
|
|
|
'41'H
|
Proposed protocol class(es) unavailable
|
|
|
'42'H
|
Insufficient resources
|
|
|
'43'H
|
Maximum connections already active
|
|
|
'80'H
|
Unknown reference
|
|
|
'81'H
|
Connection timed out
|
|
|
'82'H
|
Idle connection timed out
|
|
|
'83'H
|
Unacknowledged ER TPDU
|
An osi transport port entity represents one end of a transport
connection and maintains status information about that connection.
Although the connectionless transport protocol does not create
transport connections, ports are still used to maintain status
information.
On Digital UNIX, a port can also represent a listener, which is a
passive end point awaiting connect requests from the remote transport
service provider. Normally, ports exist only when OSI transport is
enabled. However, the port that represents the Session Control listener
(local transport selector 'DEC'0'H) is a special case. This port can
exist even when OSI transport is disabled.
The port attributes type, and for Digital UNIX
direction, can be used to distinguish the various uses of
ports.
The port-name refers to the name of the port managed by this
command.
delete [node node-id] osi transport port
port-name
show [node node-id] osi transport port
port-name [all [attributes] | all counters | all identifiers |
all status ]
delete
The delete command disconnects the connection if the port
direction is either incoming or outgoing, and deletes the port. A local
transport disconnection event will also be generated.
The port that represents the Session Control listener (local transport
selector 'DEC0'H) is a special case and cannot be deleted. An error is
not returned if an attempt is made to delete the session control
listener.
20.5.2 Counter Attributes
creation time
Time the port was assigned to a transport connection.
duplicate pdus received
Total number of all types of detected duplicate TPDUs received from the
remote NSAP. This attribute applies only to COTS.
failed checksum
Number of checksum failure events detected.
pdus received
Total number of all types of TPDUs received from the remote NSAP
(excluding detected duplicates).
pdus sent
Total number of all types of TPDUs sent to the remote NSAP (excluding
retransmissions).
retransmitted pdus
Total number of all types of retransmitted TPDUs sent to the remote
NSAP. For Digital UNIX, this attribute applies to CLTS only.
total octets received
Total number of octets of all types of TPDUs received from the remote
NSAP, regardless of their disposition. This count includes detected
duplicates.
total octets sent
Total number of octets of all types of TPDUs sent to the remote NSAP,
including retransmissions.
user octets received
Total number of user data octets received from the remote NSAP,
including normal, expedited, connect, accept, and disconnect data. This
count does not include duplicates such as data retransmitted by the
remote NSAP.
user octets sent
Total number of user data octets sent to the remote NSAP, including
normal, expedited, connect, accept, and disconnect data. This count
does not include data retransmitted by the local NSAP.
user pdus received
Total number of PDUs containing user data received from the remote
NSAP, including normal, expedited, connect, accept, and disconnect
data. This count does not include duplicates such as TPDUs
retransmitted by the remote NSAP.
user pdus sent
Total number of TPDUs containing user data sent to the remote NSAP,
including normal, expedited, connect, accept, and disconnect data. This
count does not include retransmitted TPDUs.
20.5.3 Identifier Attributes
name
Simple name assigned to the port when it is created.
20.5.4 Status Attributes
acknowledgment delay time
|
Default: None
|
Value: 0--65
|
Maximum amount of time, in seconds, that an AK TPDU is to be withheld.
This attribute applies to protocol class 4 only.
checksums
|
Default: None
|
Value: True or false
|
Indicates whether checksums are in use on the transport connection.
This attribute is supported only for class 4 protocol.
client
|
Default: None
|
Value: Local-entity-name
|
Name designated by the port user when the port was opened. If DNA
session control is being used, this is the name of the session control
port being used.
CLNS inactive area address (OpenVMS)
Specifies the inactive area address used by the transport template
associated with this port.
CONS template
|
Default: None
|
Value: Simple-name
|
When operating over the CONS, the name of the X.25 Access module's
template specified when establishing the underlying network connection.
cr timeout
|
Default: None
|
Value for Digital UNIX: 1-- (2^
31-1)
|
|
Default: None
|
Value for OpenVMS: 1-- (2^
32-1)
|
Amount of time, in seconds, to wait for a response to a CR TPDU before
assuming that the remote transport service provider will not respond.
This attribute is valid for protocol classes 0 and 2 only.
direction
Indicates whether the port is open to initiate an outgoing connection,
to receive an incoming connection, or is listening for incoming
connection requests.
|
incoming
|
Transport connection initiated by remote transport service.
|
|
listening
|
Listening for incoming connection requests.
|
|
outgoing
|
Transport connection initiated by this transport service.
|
|
unknown
|
Port direction is not known.
|
er timeout
|
Default: None
|
Value for Digital UNIX: 1-- (2^
31-1)
|
|
Default: None
|
Value for OpenVMS: 1-- (2^
32-1)
|
Amount of time, in seconds, to wait for a response to an ER TPDU before
disconnecting the network connection. This attribute is valid for
protocol classes 0 and 2 only.
expedited data
|
Default: None
|
Value: True or false
|
Indicates whether the expedited data option is in use for the transport
connection. This attribute is supported only for class 2 and class 4
protocols.
extended format
|
Default: None
|
Value: True or false
|
Indicates whether the use of extended formats should be negotiated for
a transport connection which operates the class 2 or 4 protocol.
incoming network priority (OpenVMS)
|
Default: None
|
Value: 0--255
|
When operating over CLNS, indicates network priority encoded in NPDU
header for all received packets.
inactivity time
|
Default: None
|
Value: 4--65532
|
Time, in seconds, being used for the inactivity timer. This value is
the product of multiplying the keepalive time by the
inactivity factor (architectural constant = 4). This attribute
is valid for protocol class 4 only.
initial retransmit time
|
Default: None
|
Value for Digital UNIX: 1-- (2^
31-1)
|
|
Default: None
|
Value for OpenVMS: 1-- (2^
32-1)
|
Time, in seconds, used for the retransmission timer when sending the
first TPDU on the transport connection. The value of this attribute is
derived from the template used when the port was initialized. This
attribute applies to COTS only.
keepalive time
|
Default: None
|
Value: 1--16383
|
Time, in seconds, being used for the window timer. The value of this
attribute is derived from the template used when the port was
initialized. This attribute is valid for protocol class 4 only.
local DTE address
|
Default: None
|
Value: DTE address
|
Local DTE address being used for the transport connection. This
attribute applies if network service is CONS.
local nsap
|
Default: None
|
Value: NSAP address
|
Local NSAP address being used for the transport connection. This
attribute applies if network service is CLNS or CONS.
local RFC 1006 IP address (OpenVMS)
|
Default: None
|
Value: IP address
|
Local IP address being used for the transport connection. This
attribute applies if network service is RFC 1006.
local RFC 1006 port number (OpenVMS)
|
Default: None
|
Value: TCP port number
|
Local RFC 1006 port number being used for the transport connection.
This attribute applies if network service is RFC 1006.
local reference
|
Default: None
|
Value: 1--65535
|
Unique reference number assigned to the transport connection by the
local transport service provider. This attribute applies to COTS only.
local transport selector
|
Default: None
|
Value: Hex-string
|
Local transport selector for this port.
maximum nsdu size
|
Default: None
|
Value for Digital UNIX: 128-- (2^
32-1)
|
|
Default: None
|
Value for OpenVMS: 2048
|
When operating over the CONS, the maximum NSDU size for transmitting
and receiving buffers. Expressed as a number of octets. This attribute
is valid for CONS, or RFC 1006 (OpenVMS).
negotiable classes (Digital UNIX)
|
Default: None
|
Value: Bit-set
|
Protocol classes that may be sent in response to an incoming connect
request. This attribute is valid if direction= listening and
applies to COTS only.
negotiated tpdu size
|
Default: None
|
Value: 128-- (2^
32-1)
|
The TPDU size that was negotiated for this transport connection. This
attribute applies to COTS only.
network port
|
Default: None
|
Value: Local-entity-name
|
Name of the network service port being used.
network service
|
Default: None
|
Value: CLNS, CONS, or RFC 1006 (OpenVMS)
|
Type of network service over which the transport connection is
operating. Attribute value derived from the template used when the port
was initialized.
|
CLNS
|
Connectionless Network Service
|
|
CONS
|
Connection-Oriented Network Service
|
|
RFC 1006
|
ISO Transport Service on top of TCP
|
outgoing network priority (OpenVMS)
|
Default: None
|
Value: 0--255
|
When operating over CLNS, indicates network priority encoded in NPDU
header for all transmitted packets.
protocol class
|
Default: None
|
Value: 0, 2, or 4
|
Protocol class operating on the transport connection. This attribute is
not valid for CLTS.
remote DTE address
|
Default: None
|
Value: DTE address
|
Remote DTE address being used for the transport connection. This
attribute applies to COTS and if the network service is CONS.
remote identifier
|
Default: None
|
Value: Hex-string
|
Implementation identity and version of the remote NSAP. When present,
this value is received in the identification of implementation
parameter of the CR or CC TPDU. This attribute applies to COTS only.
remote nsap
|
Default: None
|
Value: NSAP address
|
Remote NSAP address used for the transport connection. This attribute
applies to COTS and if network service is either CONS or CLNS.
remote reference
|
Default: None
|
Value: 0--65535
|
Reference number assigned to the transport connection by the remote
transport service provider. The value is 0 if the transport connection
is operating the class 0 protocol. This attribute applies to COTS only.
remote RFC 1006 port number (OpenVMS)
|
Default: None
|
Value: TCP port number
|
Remote TCP port number used for the transport connection. This
attribute applies to COTS and if the network service is RFC 1006.
remote RFC 1006 IP address (OpenVMS)
|
Default: None
|
Value: IP address
|
Remote IP address used for the transport connection. This attribute
applies to COTS and if the network service is RFC 1006.
remote transport selector
|
Default: None
|
Value: Hex-string
|
Remote transport selector that identifies the remote transport service
user. This attribute applies to COTS only.
request acknowledgment
|
Default: None
|
Value: True or false
|
Indicates whether request acknowledgment was negotiated for this
transport connection. This attribute is valid for class 4 protocol only.
retransmit threshold
|
Default: None
|
Value: 0-- (2^
32-1)
|
Number of times a TPDU requiring acknowledgment is to be retransmitted
without acknowledgment before the transmission completes with an error.
This attribute is valid for class 4 protocol only.
round-trip delay estimate
|
Default: None
|
Value for Digital UNIX: 1-- (2^
32-1)
|
|
Default: None
|
Value for OpenVMS: 0-- (2^
32-1)
|
Current estimate, in milliseconds, of the round-trip delay on the
transport connection. This attribute is valid for protocol class 4 only.
send implementation id
|
Default: None
|
Value: True or false
|
Indicates whether the implementation id will be sent in the CR. It is
always returned in the CC if it is present in the CR.
send preferred maximum TPDU size
|
Default: None
|
Value: True or false
|
Indicates whether the preferred maximum TPDU size parameter was sent in
the CR or CC TPDU.
send request acknowledgment (OpenVMS)
|
Default: None
|
Value: True or false
|
Indicates whether the request acknowledgment parameter was sent in the
CR or CC TPDU.
type
|
Default: None
|
Value: CO or CL
|
Indicates that the port is being used for the connection-oriented (CO)
transport protocol.
|
CL
|
Connectionless Transport Service
|
|
CO
|
Connection-Oriented Transport Service
|
uid
Entity's unique identifier, which is generated when the entity is
created.
use CLNS error reports
|
Default: None
|
Value: True or false
|
When operating over CLNS, indicates whether the network Routing layer's
error reporting facility should be used when performing connection
establishment. This attribute applies to COTS only.
Previous
| Next
| Contents
| [Home]
| [Comments]
| [Ordering info]
| [Help]
NCL_PROFILE_019.HTML
OSSG Documentation
2-DEC-1996 12:48:20.45
Copyright © Digital Equipment Corporation 1996. All Rights Reserved.
Legal