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.
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}
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.
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.
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.
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
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
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.
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.
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
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.
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.
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
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
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
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
16 – programming interface (Tru64 UNIX)
Default: Phase IV Value: Phase IV or Phase V
Programming interface used by the DECnet application (socket
interface).
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"