NCLHELP.HLB  —  show  session_control, 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

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.

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.

3  –  Identifier

 o  name

    Simple name assigned to the application when it is created.

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.
Close Help