show [node node-id] session control attribute [,attribute...]
all [attributes]
all characteristics
all counters
all status
Examples:
show session control naming search path
show session control all
1 – Characteristics
o address update interval
Default: 10 Values: 1-4294967296
Specifies the minimum time (in seconds) allowed between updates
of address information. More frequent modification to the set of
local towers is prohibited.
o backtranslation search path
Default: None Values: Search-path-information
Describes the order in which name services will be searched for
address-to-node-name translation requests (when more than one
name service is in use on a node) and any associated naming
templates for each directory service.
o decnet-internet gateway enabled (Tru64 UNIX)
Default: False Value: True or false
If true, the DECnet-Internet Gateway is enabled.
o decnet-internet gateway user (Tru64 UNIX)
Name of a user under whose account to run gateway applications.
o 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.
o incoming timer
Default: 45 Values: 0-65535
Time (in seconds) to wait for a user module to issue an
accept/reject call after a port enters a state indicating that
a connection request was received. If the timer expires, Session
Control aborts the transport connection with a timed out error.
For OpenVMS, a zero (0) value directs Session Control to wait
indefinitely without aborting the connection.
o maintain backward soft links
Default: True Value: True or false
Specifies whether Session Control should attempt to update
the backward translation soft links in the DECdns namespace
when it detects an address change. In other words, when
session control maintain backward soft links is true,
session control will automatically attempt to ensure that
the backtranslation softlinks in the DECdns namespace are
consistent with those in the session control database on the
local node.
If this attribute is set to false, Session Control will not
add any new backward translation soft links to the DECdns
namespace, nor will it delete any that previously exist, in
response to an address change.
o modify acs
Default: True Value: True or false
Specifies whether Session Control should attempt to update the
ACS (access control set) of the node object whenever it attempts
to update the towers attribute for the node in the namespace.
o naming cache checkpoint interval (OpenVMS)
Default: 8 Value: Time
Amount of time, in hours, between times when the address and
node-name information is checkpointed to disk from the in-memory,
local naming cache.
o naming cache entry (OpenVMS)
Default: None Value: Name
Address and node-name information for a node that has been
retrieved from a name service and is currently stored in the
in-memory, local naming cache.
o naming cache timeout (OpenVMS)
Default: 7 Value: Time
Amount of time, in days, after which the address and node-name
information for a node is deleted from the in-memory, local
naming cache.
o naming search path
Default: None Value: Search-path-information
Describes the order in which name services will be searched for
node-name-to-address translation requests (when more than one
name service is in use on a node), and any associated naming
templates for each name service.
DNS Server nodes are required to specify DECdns as the first
name service in this naming search path only when the server is
initially configured.
o node synonym directory (Tru64 UNIX)
Default: .DNA_NodeSynonym Value: Full-name
Full name of a DECdns directory that contains node synonyms.
o non privileged user (OpenVMS)
Specifies the Session Control on a non-privileged user account.
o outgoing proxy
Default: True Value: True or false
Specifies whether to invoke a proxy on outgoing connection
requests when the user does not explicitly specify to do so.
If this attribute is set to false, no proxy is invoked.
o outgoing timer
Default: 60 Values: 0-65535
Time (in seconds) to wait for an outgoing transport connection
to be accepted before Session Control aborts the connection with
a timed out error. For OpenVMS, a zero (0) value directs Session
Control to wait indefinitely without aborting the connection.
o soft link timer (Tru64 UNIX)
Default: 30 days Value: Binary relative time
Interval of time (in days) DECdns checks that an object pointed
to by a backward translation soft link still exists.
o update retry interval
Default: 60 Values: 1-4294967296
Time to wait before Session Control retries a failed attempt to
update information in the namespace. The default is 60 minutes.
o transport precedence
Default: osi Values: Set of osi or nsp
Note: On the DECnet/OSI for Digital UNIX V1.0
products the default was tp4 rather than osi.
This command 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.
o version
Default: Current version number
Session control protocol version number. You cannot modify this
characteristic.
2 – Counters
o access control violations
Number of times Session Control has detected an access control
violation event.
o backtranslation deletions
Number of times Session Control has detected a backtranslation
deletion event.
o bad backtranslation links
Number of times Session Control has generated a bad
backtranslation link event.
o creation time
Time this entity was created and all counters are zero.
o dangling link
Number of times Session Control has detected a dangling link
event.
o deleted maintained objects
Number of times Session Control has detected a deleted maintained
object event.
o verification failures
Number of times Session Control has detected a verification
failure event.
3 – Status
o backtranslation directory
Name of the root directory of the backtranslation tree.
o 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 Tru64 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 Tru64 UNIX.
o uid
Entity's unique identifier, generated when the entity is created.
4 – application
show [node node-id] session control -
application object-name-or-object-number attribute [,attribute...]
all [attributes]
all characteristics
all counters
all identifiers
all status
You can identify an application with an object name or an object
number. Usually, applications are identified by network object
number 0, but you can optionally assign it a nonzero object number,
in the range from 128 to 255. A nonzero object number can be
specified without an application name. Object numbers 1 through
127 are reserved for use by HP. Specific network services
are identified by nonzero object numbers; for example, 27
represents the mail utility.
Examples:
show session control application * name, addresses
show session control application 26 all
4.1 – Characteristics
o 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.
An end-user specification can be either a name or a number.
Usually, applications are identified by network object
number 0, but you can optionally assign it a nonzero object number,
in the range from 128 to 255. A nonzero object number can be
specified without an application name. Object numbers 1 through
127 are reserved for use by HP. Specific network services
are identified by nonzero object numbers; for example, 27
represents the mail utility.
For example, the task application uses the address set {name=task},
and the mail application uses the address set {number=27}.
o accept mode (Tru64 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.
o allow decnet-internet gateway access (Tru64 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.
o client
Data type: 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.
o data abstraction (Tru64 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 Data Abstraction Type Comparison compares Message and
Stream data abstractions.
Table 1-1 Data Abstraction Type Comparison
Message Type Stream Type
Preserves message Does not preserve message boundaries
boundaries
HP DECnet-Plus Commonly used for Tru64 UNIX applications
for OpenVMS default
abstraction
Not available on Available on TCP/IP
TCP/IP
Supported by XTI Supported by XTI
o 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.
o incoming alias (Tru64 UNIX)
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.
o incoming osi tsel (OpenVMS)
Default: none Value: hex-string
A TSEL is a string of hex digits, 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.
o 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.
o maximum instances (Tru64 UNIX)
Default: 0
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.
o network priority (OpenVMS)
Default: 0 Value: 0-255
When operating over CLNS, indicates network priority encoded in
NPDU header for all transmitted packets. It may be used by
intermediate systems to assign the packets to queues of appropriate
priority.
o 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.
o 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.
o outgoingalias name (OpenVMS)
Default: None Value: fullname
Specifies which alias name a particular object uses in its
outgoing connect requests when multiple aliases are in use.
If you do not set an application outgoingalias name and the
application has the outgoing alias set to true, the alias
name for which you set the alias port outgoing default true
is used for outgoing connect requests.
If you define application outgoingalias name, this supersedes
the setting of alias port outgoing default. So if the
application outgoing alias attribute is then set to false to
disable the application outgoingalias name, the local node
name is used.
If neither alias port going default nor application
outgoingalias name is set, the first alias created is used as
the default for the system. If this alias is not enabled,
the local node name is used.
o 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.
o programming interface (Tru64 UNIX)
Default: Phase IV Value: Phase IV or Phase V
Programming interface used by the DECnet application (socket
interface).
o user name
Default: None Data type: 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.
4.2 – Counters
o access control violations (Tru64 UNIX)
Number of connect requests for this application entity for which
access could not be granted.
o creation time
Time the entity was created.
o resource failures (Tru64 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.
o total invocations (Tru64 UNIX)
Number of instances of this application entity that have been
invoked.
4.3 – Identifier
o name
Simple name assigned to the application when it is created.
4.4 – Status
o active instances (Tru64 UNIX)
Number of active instances of this application that are currently
running.
o last request (Tru64 UNIX)
Time the last connect request for this application was received.
o process identifiers (Tru64 UNIX)
Specifies a set of processes that are active instances of the
specified application.
o uid
UID allocated upon creation of this application subentity
instance.
5 – backtranslation_softlink
show [node node-id] session control -
backtranslation softlink softlinkname attribute [,attribute...]
all [attributes]
all counters
all identifiers
all status
Shows the backtranslation softlink subentities in the session control
database on the specified node. If the node is using the DECdns
directory service, then such one softlink subentity should exist for
each DECnet address held by the node. (Softlinks are NOT created for
cluster alias addresses.) If an OpenVMS node is configured to run
DECnet over IP and is using the DECdns namespace, then one softlink
subentity should exist for each non-zero IP address as well.
Softlinks in the DECdns namespace are used by all nodes in the
namespace to associate a particular address with a nodename
(DNS$LinkTarget). Therefore, if a node's backtranslation softlinks
are not properly configured within a DECdns namespace, then other
nodes using that namespace will not be able to associate that address
with correct nodename.
NCL can be used to show what softlinks the node can be configured
to maintain in the specified DECdns namespace. If the session control
attribute maintain backward softlinks is true, then the node will
periodically attempt to update its softlinks in the DECdns namespace.
If the NCL SHOW command indicates a high Update Failure rate, the
Last Failure Reason may suggest the reason for the failure. You may
then use the DNS$CONTROL and DECNET_REGISTER tools to troubleshoot.
These tools can be used to confirm that a DECdns server is accessible
and that the DECdns namespace contains the proper object and
softlinks for this node.
Examples:
show node WINTER:.XPR.CASE session control backtrans softlink * all
! Shows all softlinks contained in the session control
! database of node WINTER:.XPR.CASE.
show session control backtranslation softlink -
WINTER:.DNA_BACKTRANSLATION.%X49.%X0018.%XAA0004002A60 all
! Shows a softlink contained in the session control database
! for the local node. It indicates that the node is the
! holder of DECnet address 24.42 within the WINTER namespace.
show session control backtranslation softlink -
WINTER:.DNA_BACKTRANSLATION.%XA1725E45 all
! This softlink indicates that the local node is configured
! as the holder of the IP address 161.114.94.69 in the
! WINTER namespace. (IP softlinks are on OpenVMS only)
5.1 – Identifier
o name
Simplename assigned when it was created.
5.2 – status
o uid
Entity's unique identifier, generated when it was created.
o target
Target (or nodename) associated with this softlink.
o network entity title
Network entity title for this softlink. Since the concept of
a NET makes no sense for IP softlinks, the hexadecimal
representation of the IP address is displayed instead.
o state
Status of this entity instance. Values include create,
delete, exist and retarget.
o last successful update
Most recent time an update for this subentity succeeded.
o last update completed
Most recent time an update for this subentity completed.
o last update started
Most recent time an update for this subentity was initiated.
o last failure reason
Reason for the most recent update failure.
5.3 – Counters
o creation time
Time when the subentity was created.
o update failures
Number of times an update for this subentity failed.
o update successes
Number of times an update for this subentity succeeded.
6 – port
show [node node id] session control -
port port-name attribute [,attribute...]
all [attributes]
all counters
all identifiers
all status
Examples:
show session control port * name, remote end user address
show session control port SCL$PORT$12040008 all
6.1 – Counters
o creation time
Time the entity was created.
6.2 – Identifier
o 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.
6.3 – Status
o accept mode (Tru64 UNIX)
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.
o auto disconnect (Tru64 UNIX)
Value: True or false
True if Session Control will abort the transport connection for
this port if Transport determines the network is partitioned.
o client
Value: Local-entity-name
Network management name specified by the user of the port when it
was opened.
o data abstraction (Tru64 UNIX)
Value: Message or stream
Type of data transfer interface the application uses.
o 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.
o incoming network priority (OpenVMS)
Default: None Value: 0-255
Incoming network priority value received with incoming
connect events.
o listening parent port (Tru64 UNIX)
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.
o 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.
o node name sent
Node name that was received or sent in the connect request.
o outgoing network priority (OpenVMS)
Default: None Value: 0-255
Outgoing network priority value passed to transport.
o process identifier (OpenVMS)
Default: None Value: Hex string
The Process Id of the process that owns the session port.
o programming interface (Tru64 UNIX)
Value: Phase IV or DECnet-Plus
Programming interface the DECnet application uses. HP
DECnet for Tru64 UNIX uses this socket interface.
o proxy requested (Tru64 UNIX)
Value: True or false
True if the request proxy bit was turned on in the
connect request that was received or sent.
o queued connects (Tru64 UNIX)
Value: Integer
Number of connect requests pending that PollIncoming has not
dequeued yet.
o receive queue (Tru64 UNIX)
Value: Integer
Number of octets of unread data queued.
o 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 was 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.
o send queue (Tru64 UNIX)
Value: Integer
Number of octets of unsent data queued.
o transport port
Value: Local-entity-name
Network management name of the transport port being used by this
session control port.
o version sent
Version that was received or sent in the connect request.
7 – proxy (Tru64 UNIX)
show [node node-id] session control -
proxy name attribute [,attribute...]
all [attributes]
all counters
all identifiers
all status
7.1 – Identifier
o name
Simple name assigned to a particular entity instance. The name
is the management identifier for the proxy database entry and
is kept unique among the entries in this database maintained by
Session Control.
7.2 – Characteristics
o applications
Value: Set of simple-name
Set of application identifiers, one of which must match the
application requested. If this attribute value is null, any
requested application will match.
o source end users
Value: Set of record
Set of remote end users for whom this proxy entry applies. An
unspecified end user implies all end users on the node specified
in the same record. The record format has two fields: node which
has a data type of fullname, and end user which has a data type
of enduserspecification.
o target user
Default: None Value: Latin1String
Local user name under which access is granted.
o type
Default: Explicit Value: Explicit or default
Type of proxy entry. explicit means that the destination the
user requested in the connect request must match the target user
for this entry. default means if no explicit entry matches, this
entry will be tried. An explicit proxy entry matches before a
default one.
7.3 – Counters
o creation time
Time the entity was created and associated counter attributes
were zero.
o used
Number of times this proxy entry was used to gain access to one
of the applications.
7.4 – Status
o last time used
Last time this proxy entry was used to gain access to one of the
applications.
8 – tower_maintenance
show [node node-id] session control -
tower maintenance fullname attribute [,attribute...]
all [attributes]
all counters
all identifiers
all status
Examples:
show session control tower maintenance * all
show session control tower maintenance DEC:.lkg.wzbang all
8.1 – Identifier
o name
Fullname assigned to the tower maintenance entity when it is
created.
8.2 – Counters
o creation time
Time this entity was created.
o update failures
Number of times this entity detected an update failure event.
o update successes
Number of times that the DNA$Towers attribute of the DECdns
object name associated with this entity has been successfully
updated.
8.3 – Status
o client
Network management name of the user who issued the keepmehere
call that resulted in the creation of this entity.
o higher towers
Set of higher towers that was passed in the keepmehere call that
created this entity.
o last failure exception (Tru64 UNIX)
Reason for the most recent update failure. If no update for this
subentity ever failed, then it is zero.
o last failure reason
DECdns error code that indicates the reason for the last update
failure.
o last successful update
Time of the last successful update to the DNA$Towers attribute
for the specified entity. On OpenVMS, if no update for this
subentity ever failed, then it is zero.
o last update completed
Time that the last attempt to update the DNA$Towers attribute
completed (successfully or not).
o last update started
Time that the last attempt to update the DNA$Towers attribute for
the specified entity was initiated.
o uid
Entity's unique identifier, which is generated when the entity is
created.
o user (Tru64 UNIX)
User name of the user who created this tower maintenance
subentity with the keepmehere procedure call. This is different
from client, which refers to a local entity name.
9 – transport_service
show [node node-id] session control -
transport service transport-name attribute [,attribute...]
all [attributes]
all counters
all identifiers
all status
Examples:
show session control transport service NSP all
show session control transport service OSI all
9.1 – Counter
o creation time
Time the entity was created.
9.2 – Identifier
o name
Simple name assigned to the transport service when it is created.
9.3 – Status
o protocol
Transport protocol used by this transport service, as specified
by the user when this service was created. (See the create
command description for a list of possible values.)
o tsel
Transport selector used by the OSI Transport Module to bind
incoming connection requests to session control.
With Tru64 UNIX, the TSEL value is specified in a create command.
This attribute is not applicable for NSP transport.