DECnet-Plus
Network Control Language Reference

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

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.

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.

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.

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

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.

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.

name

Simple name assigned to the application when it is created.

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.

For create:

already exists

A session control application entity already exists.

22.3 session control backtranslation softlink

update

Updates a backtranslation soft link entity.

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.

name

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

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.

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

creation time

Time the entity was created.

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.

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.

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

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal