1 Session The Session layer is responsible for connection negotiation and establishment. The Session Control module performs the following functions: o Manages transport connections on behalf of Session Control users. o Enforces access control policies to restrict communication between users and between Session Control modules. o Maps from a DNA Naming Service object name to protocols and addresses. o Selects from the set of protocols supporting Session Control to attempt connection establishment. o Maintains in the namespace the protocol and address information corresponding to objects that reside in the same node as the local Session Control module. The hierarchy of Session Control Module Entities is shown with indentation as follows: Session Control Applications Ports Tower Maintenance Transport service Backtranslation softlink The Session Control entity is the top-level entity in the hierarchy of entities belonging to the Session Control module. 2 character =title Characteristic Attributes ADDRESS UPDATE INTERVAL Default: 10 Value: 1-4294967296 Minimum time, in seconds, allowed between updates of address information. More frequent modification to the set of local towers is prohibited. BACKTRANSLATION SEARCH PATH 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. INCOMING PROXY Default: True Value: Boolean Specifies whether to honor incoming proxy requests. If this attribute is set to false, requests to invoke proxies on incoming requests are ignored. INCOMING TIMER Default: 45 Value: 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. MAINTAIN BACKWARD SOFT LINKS Default: False Value: Boolean 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. MODIFY ACS CONTROL SET Default: True Value: Boolean 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. NAMING CACHE CHECKPOINT INTERVAL 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. ! NAMING CACHE ENTRY ! ! 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. ! ! NAMING CACHE TIMEOUT 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. NAMING SEARCH PATH 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. NON PRIVILEGED USER Specifies the Session Control on a non-privileged user account. SOFTLINK TIMER 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. OUTGOING PROXY Default: True Value: Boolean 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. OUTGOING TIMER Default: 60 Value: 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. UPDATE RETRY INTERVAL Default: 60 Value: 1-4294967296 Time to wait before Session Control retries a failed attempt to update information in the namespace. The default is 60 minutes. ! TRANSPORT PRECEDENCE ! Default: OSI Value: Set of OSI or NSP ! ! 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 Session Control protocol version number. You cannot modify this characteristic. 2 Counter =title Counter Attributes 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. 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. 2 status =title Status Attributes BACKTRANSLATION DIRECTORY Name of the root directory of the backtranslation tree. STATE Status of the Session Control entity. Status: 200 OK Content-Type: text/plain; charset=ISO-8859-1 Last-Modified: Fri, 29 Dec 2000 22:02:17 GMT Script-Control: X-stream-mode=1 1 session_app =title Session Control Application A Session Control application entity 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. 2 character =title Characteristics Attributes 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. CLIENT NAME 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. 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 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 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: Boolean 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. NODE SYNONYM Default: False Value: Boolean 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 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 Default action to execute when user does not explicitly specify whether or not to invoke a proxy. 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. 2 status =title Status Attributes PROCESS IDENTIFIERS Specifies a set of processes that are active instances of the specific application. Status: 200 OK Content-Type: text/plain; charset=ISO-8859-1 Last-Modified: Fri, 29 Dec 2000 22:02:17 GMT Script-Control: X-stream-mode=1 1 session_back =title Session Control Backtranslation Softlinks A Session Control backtranslation softlink entity stores information about entries in the backtranslation soft link database. The name is the unique name among the set of backtranslation soft-link subentities maintained by Session Control. 2 counters =title Counter Attributes UPDATE FAILURES Number of times an update for this subentity failed. UPDATE SUCCESSES Number of times an update for this subentity succeeded. 2 Status =title Status Attributes 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 softlink. Status: 200 OK Content-Type: text/plain; charset=ISO-8859-1 Last-Modified: Fri, 29 Dec 2000 22:02:17 GMT Script-Control: X-stream-mode=1 1 session_port =title Session Port A Session Control port entity stores Session Control information about the transport connection. 2 status =title Status Attributes CLIENT Network management name specified by the user of the port when it was opened. DIRECTION Specifies whether the port is open to initiate an outgoing transport connection or to receive an incoming one. UNKNOWN - Port status is unknown at this time. INCOMING - Port was opened to handle an incoming transport connection. OUTGOING - Port is open to initiate an outgoing transport connection. LISTENING - Port is open to receive incoming transport connections. 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. 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. TRANSPORT PORT 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. Status: 200 OK Content-Type: text/plain; charset=ISO-8859-1 Last-Modified: Fri, 29 Dec 2000 22:02:17 GMT Script-Control: X-stream-mode=1 1 session_tower =title Session Control Tower Maintenance A Session Control Tower Maintenance entity stores information about entries in the Tower Maintenance data base. A Tower Maintenance entity is automatically created when a client issues a dnaKeepMeHere call, using the programming interface. 2 counters =title Counter Attributes UPDATE FAILURES Number of times this entity detected an update failure event. UPDATE SUCCESSES Number of times that the DNA$Towers attribute of the DECdns object name associated with this entity has been successfully updated. 2 status =title Status Attributes MANAGING CLIENT Network management name of the user who issued the keepmehere call that resulted in the creation of this entity. HIGHER TOWERS Set of higher towers that was passed in the keepmehere call that created this entity. LAST FAILURE REASON 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 for the specified entity. On OpenVMS, if no update for this subentity ever failed, then it is zero. LAST UPDATE COMPLETED Time that the last attempt to update the DNA$Towers attribute completed successfully or not. LAST UPDATE STARTED Time that the last attempt to update the DNA$Towers attribute for the specified entity was initiated. Status: 200 OK Content-Type: text/plain; charset=ISO-8859-1 Last-Modified: Fri, 29 Dec 2000 22:02:17 GMT Script-Control: X-stream-mode=1 1 session_trans =title Session Control Transport Service A Session Control transport service entity stores information about modules in the Transport layer that support Session Control. 2 status =title Status Attributes 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. TSEL Transport selector used by the OSI Transport Module to bind incoming connection requests to Session Control. This attribute is not applicable for NSP transport.