[Digital logo]
[HR]

DECnet-Plus
Network Control Language Reference


Previous | Contents

Sets the order in which transports are selected when establishing a connection. The default order is to try OSI, then NSP. The command takes a set as input. Valid items in the set are session control transport service entity names.

version

Default: Current version number
Session Control Protocol version number. You cannot modify this characteristic.

22.1.3 Counter Attributes

access control violations

Number of times Session Control has detected an access control violation event.

backtranslation deletions

Number of times Session Control has detected a backtranslation deletion event.

bad backtranslation links

Number of times Session Control has generated a bad backtranslation link event.

creation time

Time this entity was created and all counters are zero.

dangling link

Number of times Session Control has detected a dangling link event.

deleted maintained objects

Number of times Session Control has detected a deleted maintained object event.

verification failures

Number of times Session Control has detected a verification failure event.

22.1.4 Status Attributes

backtranslation directory

Name of the root directory of the backtranslation tree.

state

Status of the session control entity.
off The entity is disabled.
on The entity is enabled.
restricted The entity is enabled and supports existing transport connections; it initiates outgoing transport connections, but it refuses incoming connections unless the request meets system privilege requirements. This function is only supported on Digital UNIX.
shut The entity is enabled and supports existing transport connections, but it refuses any new connection requests. After all transport connections disappear, the state will automatically change to off. This function is only supported on Digital UNIX.

uid

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

22.1.5 Event Messages

access control violation

Generated each time Session Control detects an access control violation. The arguments provide information about the source and destination.

Arguments:
destination End-user specification of the destination account.
destination account Destination account information.
destination user Destination user name.
node name Name of the source node.
nsap address Network address of the source node.
source End-user specification at the source node.

backtranslation deletion

Generated each time a backward translation name is discarded because of an irrecoverable error.

Arguments:
name Deleted name.
reason DECdns error that caused the deletion.

bad backtranslation link

Generated when an attempt to access a backward translation soft link results in a clerk exception indicating that some attribute in the soft link chain was improperly configured.

Arguments:
name Name improperly configured.
reason Reason for the exception.

dangling link

Generated each time an attempt to access an attribute of a backward translation soft link results in a clerk. Dangling exception.

Argument:
name Full name of the soft link.

deleted maintained object

Generated each time a tower maintenance entity is discarded because of an irrecoverable error.

Arguments:
client Network management name of the user who issued the keepmehere call that resulted in the creation of this entity.
creation time Time this entity was created.
higher towers Set of higher towers that was passed in the keepmehere that created this entity.
last failure reason A DECdns error code that indicates the reason for the last update failure.
last successful update Time of the last successful update to the DNA$Towers attribute.
last update completed Time that the last attempt to update the DNA$Towers attribute completed.
last update started Time that the last attempt to update the DNA$Towers attribute was initiated.
name Full name of the deleted entity.
reason DECdns error that caused the deletion.
uid Entity's unique identifier, generated when the entity is created.
update failures Generated each time an attempt to update a DNA$Towers attribute fails.
update successes Generated each time an attempt to update a DNA$Towers attribute succeeds.

verification failure

Generated each time Session Control is unable to verify that the addresses and protocols of an incoming connection request are consistent with the DNA$Towers attribute of the source node name.

Arguments:
address Unverified protocol address sequence.
node Full name of the source node.

22.1.6 Exception Messages

For create:

already exists

A session control entity already exists.

For delete (Digital UNIX):

wrong state

Disable the session control entity before trying to delete it.

22.2 session control application

A session control 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.
add [node node-id] session control application application-name addresses [set of end-user specifications]
create [node node-id] session control application application-name
delete [node node-id] session control application application-name
remove [node node-id] session control application application-name addresses [set of end-user specifications]
set [node node-id] session control application name {accept mode (Digital UNIX) | address [set] | allow decnet-internet gateway access (Digital UNIX) | client client-id | data abstraction (Digital UNIX) | image name file-spec | incoming alias boolean (OpenVMS) | incoming osi tsel boolean (OpenVMS) | incoming proxy boolean | maximum instances (Digital UNIX) | network priority (OpenVMS) | node synonym boolean | outgoing alias boolean (OpenVMS) | outgoing proxy boolean (OpenVMS) | programming interface (Digital UNIX) | user name username }
show [node node-id] session control application application-name [all [attributes] | all characteristics | all counters | all identifiers | all status ]

22.2.1 Characteristic Attributes

accept mode (Digital UNIX)

Default: Immediate Value: Immediate or deferred
If accept mode is immediate, then Session Control will automatically accept the connection before activating the end user. If accept mode is deferred, then it is up to the program to accept or reject the connection.

addresses

Default: Empty set Value: Set of end-user specifications
A set of end-user specifications, any one of which, when specified in the destination name field of an incoming connection request, causes applications defined by this entity to be invoked.

allow decnet-internet gateway access (Digital UNIX)

Default: False Value: True or false
If true, this application supports gateway access. If the user name supplied by the incoming connect request contains a @ or !, the application spawner starts up the application under the session control DECnet-Internet Gateway user.

client

Default: None Value: Entity name
Identifies the name of the local user that will be activated upon receipt of a connect request containing a destination name matching one of the values in the destination names attribute.

data abstraction (Digital UNIX)

Default: Message Value: Message or stream
Type of data transfer interface the application will be using: message type or stream type. The message data abstraction is identical to the sequenced-packet socket concept of the Phase IV session control. When writing applications, you should use the same data abstraction as that used by the program to which you connect.

Table 22-1 compares message and stream data abstractions.

Table 22-1 Data Abstraction Type Comparison
Message Type Stream Type
Preserves message boundaries Does not preserve message boundaries
OpenVMS default abstraction Commonly used for Digital UNIX applications
Not available on TCP/IP Available on TCP/IP
Supported by XTI Supported by XTI

image name

Default: No image name Value: File specification
File name of a program to be invoked upon receipt of a connection request containing an address that matches one of the values contained in the set described by the addresses characteristic.

incoming alias (OpenVMS)

Specifies how a particular application responds to incoming connect requests directed to the alias node address. If false, the application does not allow a specified application to receive incoming connect requests that have been directed to the alias node address.

incoming osi tsel (OpenVMS)

A TSEL is a string of hexadecimal digits, and the length of that string should be an even number between 2 and 64, inclusive.

The TSEL this image will accept connections for. This is similar to the destination names attribute. However, applications using this access point for in-connection matching do not use DNA Session Control Protocol.

incoming proxy

Default: True Value: True or false
Specifies whether to honor incoming proxy requests. If this attribute is set to false, requests to invoke proxies on incoming requests are ignored. The setting of this characteristic overrides the setting of the session control incoming proxy characteristic for the specified application.

maximum instances (Digital UNIX)

Default: 0 Value: None
Maximum number of simultaneous instances of this application allowed. If a connect request comes in for this application while the maximum number of instances exist, the connect request will be rejected with ObjectTooBusy. A value of 0 indicates no maximum.

network priority (OpenVMS)

Default: 0 Value: 0--225
When operating over Connectionless Network Service (CLNS), indicates network priority encoded in the NPDU (network protocol data unit) header for all transmitted packets. It can be used by intermediate systems to assign the packets to queues of appropriate priority.

node synonym

Default: False Value: True or false
Default form in which the remote node name is passed to the application.
false The full node name is used.
true The node synonym is used; if no synonym is available, the full name is used.

outgoing alias (OpenVMS)

Default: True Value: True or false
Specifies whether a particular object uses the alias node identifier in its outgoing connect requests. If false, the specified object is not allowed to use the alias node address in its outgoing connect requests.

outgoing proxy (OpenVMS)

Default: True Value: True or false
Default action to execute when user does not explicitly specify whether or not to invoke a proxy.

programming interface (Digital UNIX)

Default: Phase IV Value: Phase IV or Phase V
Programming interface used by the DECnet application (socket interface).

user name

Default: None Value: Latin1String
Identifies the default account under which the application is to run. For OpenVMS, if null then system defaults are used to select the user.

22.2.2 Counter Attributes

access control violations (Digital UNIX)

Number of connect requests for this application entity for which access could not be granted.

creation time

Time the entity was created.

resource failures (Digital UNIX)

Number of times a connect request for this application was rejected due to a resource failure. Resource failures include ObjectTooBusy (for example, due to Maximum Instances reached) and File is nonexistent or not executable.

total invocations (Digital UNIX)

Number of instances of this application entity that have been invoked.

22.2.3 Identifier Attributes

name

Simple name assigned to the application when it is created.

22.2.4 Status Attributes

active instances (Digital UNIX)

Number of active instances of this application that are currently running.

last request (Digital UNIX)

Time the last connect request for this application was received.

process identifiers (Digital UNIX)

Specifies a set of processes that are active instances of the specified application.

uid

UID allocated upon creation of this application subentity instance.

22.2.5 Exception Messages

For create:

already exists

A session control application entity already exists.

22.3 session control backtranslation softlink

A session control backtranslation softlink entity stores information about entries in the backtranslation soft link database. The name is the unique name among the set of backtranslation soft link subentities maintained by Session Control.
delete [node node-id] session control backtranslation softlink name
show [node node-id] session control backtranslation softlink name [all [attributes] | all counters | all identifiers | all status ]
update [node node-id] session control backtranslation softlink name

22.3.1 Commands

update

Updates a backtranslation soft link entity.

22.3.2 Counter Attributes

creation time

Time when this subentity was created.

update failures

Number of times an update for this subentity failed.

update successes

Number of times an update for this subentity succeeded.

22.3.3 Identifier Attributes

name

Simple name assigned to the transport service when it is created.

22.3.4 Status Attributes

last failure reason

Failure reason for the most recent update failure.

last successful update

Most recent time an update for this subentity succeeded.

last update completed

Most recent time an update for this subentity completed.

last update started

Most recent time an update for this subentity was initiated.

network entity title

Network entity title for this soft link.

state

Status of this entity instance. Values include create, delete, exist and retarget.

target

Target for soft link.

uid

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

22.3.5 Event Messages

deleted

The given backtranslation softlink subentity instance was deleted.

Argument:
creation time Time this subentity was created.
network entity title Network entity title for this soft link.
state Status of the entity.
target Target for soft link.
update failures Times an update for this subentity failed.
update success Times an update for this subentity succeeded.

update failure

Signals an attempt to create, delete, or retarget a backtranslation has failed.

Argument:
reason Reason for the failure.

22.4 session control port

A session control port entity stores Session Control information about the transport connection. The port-name refers to the port managed by this command.
delete [node node id] session control port port-name
show [node node id] session control port port-name [all [attributes] | all counters | all identifiers | all status ]

22.4.1 Counter Attributes

creation time

Time the entity was created.

22.4.2 Identifier Attributes

name

Simple name assigned to the port when it is created. This name is passed to the Transport layer as the client name in a call to open a port.

22.4.3 Status Attributes

accept mode (Digital UNIX)

Default: None Value: Immediate or deferred
If accept mode is immediate, Session Control automatically accepts the connection before activating the end user. If accept mode is deferred, it is up to the end user to accept or reject the connection.

auto disconnect (Digital UNIX)

Default: None Value: True or false
True if Session Control will abort the transport connection for this port if Transport determines the network is partitioned.

client

Default: None Value: Local-entity-name
Network management name specified by the user of the port when it was opened.

data abstraction (Digital UNIX)

Default: None Value: Message or stream
Type of data transfer interface the application uses.

direction

Specifies whether the port is open to initiate an outgoing transport connection or to receive an incoming one.
incoming Port was opened to handle an incoming transport connection.
outgoing Port is open to initiate an outgoing transport connection.
unknown The port status is unknown at this time.
listening The port is open to receive incoming transport connections.

incoming network priority (OpenVMS)

Default: None Value: 0--255
Incoming network priority value received with incoming connect events.

listening parent port (Digital UNIX)

Default: None Value: Local-entity-name
Name of the Session Control port that this port came from as the result of a PollIncoming on the parent port.

local end user address

Address assigned by the user of the port when it was opened. On outgoing connections this value is sent in the source name field of the connection request; on incoming connections this value is received in the destination name field of the request.

node name sent

Node name that was received or sent in the connect request.

outgoing network priority (OpenVMS)

Default: None Value: 0--255
Outgoing network priority value passed to transport.

process identifier (OpenVMS)

Default: None Value: Hex string
The process ID (PID) of the process that owns the session port.

programming interface (Digital UNIX)

Default: None Value: Phase IV or DECnet-Plus
Programming interface the DECnet application uses. For Digital UNIX, this is the socket interface.

proxy requested (Digital UNIX)

Default: None Value: True or false
True if the request proxy bit was turned on in the connect request that was received or sent.

queued connects (Digital UNIX)

Default: None Value: Integer
Number of connect requests pending that PollIncoming has not dequeued yet.

receive queue (Digital UNIX)

Default: None Value: Integer
Number of octets of unread data queued.

remote end user address

Address of the remote end user of the port. This value was either sent in the destination name field of an outgoing connection request or received in the source name field of an incoming connection request. If the value of the direction attribute is incoming or unknown and no connection request has been received, the value of this attribute is null.

send queue (Digital UNIX)

Default: None Value: Integer
Number of octets of unsent data queued.

transport port

Default: None Value: Local-entity-name
Network management name of the transport port being used by this session control port.

version sent

Version that was received or sent in the connect request.


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

[HR]

  NCL_PROFILE_027.HTML
  OSSG Documentation
   2-DEC-1996 12:48:41.54

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal