set [node node-id] session control ...
Modifies the attributes of the session control entity. The
modifiable attributes and their data types [in brackets] are:
address update interval [integer]
backtranslation search path [ordered list of directory, template]
decnet-internet gateway enabled [boolean] (Tru64 UNIX)
decnet-internet gateway user [username] (Tru64 UNIX)
incoming proxy [boolean]
incoming timer [integer]
maintain backward soft links [boolean]
modify acs [boolean]
naming cache timeout [binreltime] (OpenVMS)
naming cache checkpoint interval [binreltime] (OpenVMS)
naming search path [ordered list of directory, template]
network priority [integer] (OpenVMS)
node synonym directory [full-name]
non privileged user [username] (OpenVMS)
outgoing proxy [boolean]
outgoing timer [integer]
soft link timer [binary-relative-time] (Tru64 UNIX)
transport precedence [set of OSI or NSP]
update retry interval [integer]
For specific command examples, refer to the attribute
descriptions below.
Select application to view the modifiable attributes a session
control application.
Select proxy to view the modifiable attributes of a session
control proxy on Tru64 UNIX.
1 – 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.
Example:
set session control address update interval 10
2 – backtranslation_search_path
Default: {} Value: Ordered list of directory, template
An ordered list used by the common directory interface to determine
the order of the naming services used for lookup in
address-to-nodename translation.
On OpenVMS the recommended method of modifying this attribute is to
run NET$CONFIGURE and use Option 2. The result of the configuration
is saved in the SYS$MANAGER:NET$SEARCHPATH_STARTUP.NCL script so the
session control backtranslation search path attribute will be re-set
on startup. However, if a NET$SEARCHPATH_LOCAL.NCL script is found
during startup, that local procedure will be executed in lieu of
the NET$SEARCHPATH_STARTUP.NCL script.
Example:
set node 0 session control back search path -
([directory service = local, template = ""], -
[directory service = domain, template = ""])
3 – decnet-internet gateway enabled (Tru64 UNIX)
Default: False Value: True or false
If true, the DECnet-Internet Gateway is enabled.
4 – decnet-internet gateway user (Tru64 UNIX)
Name of a user under whose account to run gateway applications.
5 – 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.
Example:
set session control incoming proxy true
6 – 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.
Example:
set session control incoming timer 45
7 – maintain_backward_soft_links
Default: False Value: True or false
Specifies whether Session Control should attempt to update
the backward translation soft links when it detects an address
change. If this attribute is set to false, Session Control will
add no new backward translation soft links and it may delete any
that it has created.
On OpenVMS, even though the default NCL value for this attribute
is False, the sys$manager:net$session_startup.ncl script resets
this attribute to True.
Examples:
set session control maintain backward soft links true
set session control - ! Resets the attribute to
maintain backward soft links ! the default, which is
! False.
8 – 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.
Example:
set session control modify acs true
9 – 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 only be used by
intermediate systems to assign the packets to queues of appropriate
priority.
10 – node_synonym_directory
Default: None Value: Full-name
Full name of a DECdns directory that contains node synonyms.
Example:
set session control node synonym directory DEC:.DNA_NodeSynonym
11 – non privileged user (OpenVMS)
Default: None Value: username
Specifies a non-privileged user account. This default account
allows users to perform certain network operations, such as the
exchange of electronic mail between users on different nodes,
without having to supply a user name and password. The default
DECnet user name is also used for file operations when access control
information is not supplied. For example, it permits remote users to
access local files on which the file protection has been set to allow
world access.
You may use NET$CONFIGURE.COM to request a nonprivileged
DECnet account. Refer to the Network Management manual for more
information before adding a default nonprivileged DECnet account.
Example:
set session control non privileged user "netnonpriv"
12 – 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.
Example:
set session control outgoing proxy false
13 – 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.
Example:
set session control outgoing timer 60
14 – 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.
15 – transport_precedence
Default: {} 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.
Examples:
set session control -
transport precedence {} ! By default OSI is preferred over NSP.
set session control -
transport precedence {nsp,osi} ! Prefers NSP over OSI.
16 – update_retry_interval
Default: 60 Values: 1-4294967296
Time to wait before Session Control retries a failed attempt to
update information in the namespace.
Example:
set session control update retry interval 60
17 – naming cache timeout (OpenVMS)
Default: 30 Value: binary relative 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.
Example:
set session control naming cache timeout 30-00:00:00
18 – naming cache checkpoint interval (OpenVMS)
Default: 8 Value: binary relative time
The amount of time, in hours, between times when the address and
node name information is checkpointed (flushed) to disk from the
in-memory, local naming cache. The minimum is 15 minutes.
Examples:
set session control -
naming cache checkpoint interval 08:00:00
set session control -
naming cache checkpoint interval 00:15:00
19 – naming_search_path
Default: {} Value: Ordered list of directory, template
An ordered list used by the common directory interface to determine
the order of the naming services used for lookup in
nodename-to-address translation.
On OpenVMS the recommended method of modifying this attribute is to
run NET$CONFIGURE and use Option 2. The result of the configuration
is saved in the SYS$MANAGER:NET$SEARCHPATH_STARTUP.NCL script so the
session control naming search path attribute will be re-set on
startup. However, if a NET$SEARCHPATH_LOCAL.NCL script is found
during startup, that local script will be executed in lieu of the
NET$SEARCHPATH_STARTUP.NCL script.
Example:
set node 0 session control naming search path -
([directory service = local, template = "*"], -
[directory service = local, template = "LOCAL:*"], -
[directory service = local, template = "lOCAL:.*"], -
[directory service = domain, template = "*"], -
[directory service = domain, template = "*.SCH.DEC.COM"])
20 – application
set [node node-id] session control -
application object-name-or-object-number ...
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 Tru64. Specific network services
are identified by nonzero object numbers; for example, 27
represents the mail utility.
This Set command modifies attributes of a session control application
entity, which 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 modifiable session control application attributes and their
data types [in brackets] are:
accept mode [immediate or deferred] (Tru64 UNIX)
addresses [set of end-user specifications]
allow decnet-internet gateway access [boolean] (Tru64 UNIX)
client [client-id]
data abstraction [message or stream] (Tru64 UNIX)
image name [file-spec]
incoming alias [boolean] (Tru64 UNIX)
incoming osi tsel [hex-string] (OpenVMS)
incoming proxy [boolean]
maximum instances [integer] (Tru64 UNIX)
network priority [integer] (OpenVMS)
node synonym [boolean]
outgoing alias [boolean] (OpenVMS)
outgoingalias name [fullname] (OpenVMS)
outgoing proxy [boolean] (OpenVMS)
programming interface [Phase IV or Phase V] (Tru64 UNIX)
user name [username]
On OpenVMS, the recommended method of modifying session control
application attributes is to run NET$CONFIGURE and choose Option 7.
The configuration information for the applications is then written
to the SYS$MANAGER:NET$APPLICATION_STARTUP.NCL script so the
applications can be re-set on reboot.
If you wish to modify these attributes manually, you may refer
specific command examples in the attribute descriptions.
20.1 – 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.
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:
set session control application mail addresses {number=27}
set session control application task addresses {name=task}
20.2 – 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.
20.3 – 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.
20.4 – 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.
20.5 – 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
for OpenVMS default applications
abstraction
Not available on Available on TCP/IP
TCP/IP
Supported by XTI Supported by XTI
20.6 – 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.
Example:
set session control application mirror -
image name sys$system:net$mirror.exe
20.7 – 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.
20.8 – incoming osi tsel (OpenVMS)
Default: None Value: hex-string
The TSEL for which this image will accept connections. 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.
20.9 – 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.
Example:
set session control application mail incoming proxy false
20.10 – 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.
20.11 – 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.
20.12 – 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.
Example:
set session control application mail node synonym true
20.13 – outgoing alias (OpenVMS)
Default: False 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.
Example:
set session control application mail outgoing alias true
20.14 – outgoingalias name (OpenVMS)
Default: None Value: fullname of alias
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.
Example:
set session control application mail -
outgoingalias name DEC:.lkg.MyAlias
20.15 – outgoing proxy (OpenVMS)
Default: False Value: True or false
Default action to execute when user does not explicitly
specify whether or not to invoke a proxy.
Example:
set session control application 36 outgoing proxy true
20.16 – programming interface (Tru64 UNIX)
Default: Phase IV Value: Phase IV or Phase V
Programming interface used by the DECnet application (socket
interface).
20.17 – 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. The username must be specified in quotes on OpenVMS.
Example:
set session control application cml user name "cml$server"
21 – proxy (Tru64 UNIX)
set [node node-id] session control proxy proxy-name ...
Modifies the attributes of a session control proxy entity which
stores the information that grants remote users proxy access to
given application subentity instances. The modifiable
attributes and their data types [in brackets] are:
applications [set of simplenames]
source end users [set of records]
target user [latin1string]
type [explicit or default]
21.1 – applications
Default: None Value: Set of simplenames
Set of application identifiers, one of which must match the
application requested. If this attribute value is null, any
requested application will match.
21.2 – source_end_users
Default: None Value: Set of records
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.
21.3 – target_user
Default: None Value: Latin1string
Local user name under which access is granted.
21.4 – 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.