Sessions

A session is group of tasks that share common characteristics, such as data.

Session properties are static and dynamic details about your session.

Properties


Property

Description

Session ID

System-assigned session ID.

State

Session state: Open, Closed, Suspended, or Aborted.

Priority

Priority of the session between 1 and 10,000 where 10,000 is the highest priority.

Task Summary

A color summary of your tasks by state.
  • Green: Running

  • Beige: Pending

  • Blue: Done

  • Red: Error

  • Grey: Canceled

Running

Number of running tasks.

Pending

Number of pending tasks.

Done

Number of completed tasks.

Error

Number of tasks in Error state.

Canceled

Number of canceled tasks.

User

Name of the user account the client application used to connect to the system to create the session. (Applicable to Symphony grid version only.)

Number of Instances

Number of running service instances for the session.

Total

The total number of service instances that have run for this session.

Binding Failures

Host and process IDs for service instances that failed to bind to a session (that is, experienced a failure in the SessionEnter method). This applies only to sessions that have common data.

Common Data Updates

Total number of common data updates received for this session.

Session Name

The name of your session as specified at the session creation. You can filter or operate on sessions with the name tag. If you do not set a session tag when you create your session, no session tag is applied.

Session Tag

A string associated with a session at session creation. You can filter or operate on sessions with the same tag. If you do not set a session tag when you create your session, no session tag is applied.

Created

Date and time when the client application created the session.

Ended

Date and time the session entered a Closed or Aborted state. Blank if the session is in the Open or Suspended state.

Service

Name of the service for this session. All tasks submitted to this session are executed on this service.

Type

The name of this session’s session type. When you define a session type in the application profile, you set the behavior and configuration parameters for sessions that are created with this type.

Comment

An optional comment field available when you suspend, kill, or resume sessions.

Consumer

Consumer name as it appears in the consumer ID parameter of the application profile’s Consumer section. (Applicable to Symphony grid version only.)

Task Retry Limit

Number of times to retry all tasks in this session if it does not complete successfully. After a task has reached this number of retries and still does not complete successfully, the task is put into the Error state.

Fail If Task Fails

True or False. If true, the session is aborted if any task enters the Error state.

Recoverable

True or False. If true, this session and its workload can be recovered if the session manager is relocated due to failover or abnormal termination.

Session History

Displays whether none, all, or only error session history is retained. If session history is retained, you have a detailed record of sessions that have completed in the Closed or Aborted state.

Task History

Displays whether none, all, or only error task history is retained. If task history is retained, you have a detailed record of tasks that have completed in the Done, Error, or Canceled state.

Last Task Error

Time when last error task became Error.

Application Name

Application name.

Session Retry Limit

The number of times to retry binding service instances to this session, after which the session is aborted.

Common Data Size

The size of the common data. This data size may differ from the raw common data size depending on which feature set is being used by the application; for example, the data size may be smaller when compared to the raw data size if the application enables the data compression feature.

Session update failures

Host names and process IDs for the last five service instances that experienced service-side session update failures.

Updates Sent Over Network

Total size of all common data updates sent over the network for this session.

Raw Common Data Size

The initial size of the common data when it was passed from the client to Symphony. This is the data size before the data is acted upon by any feature set that is being used by the application.

Compression

Enabled or disabled. If enabled, input/output data, common data, and common data updates are compressed for the session, if data size is greater than threshold setting.

CompressionThreshold

Specifies the data size (in kilobytes) at which compression is triggered, i.e., if data size is greater than threshold setting, the data will be compressed.

Common Data Compressed

Indicates whether the common data was actually compressed by the system. If compression is enabled, only data larger than the threshold will be compressed.

Direct Data Transfer

Enabled or disabled. If enabled, application data is transmitted directly between the client and service.

Preemptive

Indicates whether the session preempts sessions with lower priority when it has workload to run.

Client Host Name

The local host name of the host running the client. In a multi-homed host, it is the name of the host that connects to the session.

Client OS User Name

The name of the OS user running the client.

Client Version

The version of Symphony library in use by the client at run time (not the version of Symphony used to compile the client).

Client IP Address

The IP address of the host running the client. In a multi-homed host, it is the IP address used to connect to the session.

Service to Slot Ratio

The number of slots required to run a service instance, represented by a service-to-slot ratio. A task from a session cannot run on a resource unless the slot usage requirement is met.

Resource Group Filter

A list of resource groups from which the session can use resources. Tasks from a session can only run on resources that belong to one of the resource groups listed in the filter.

Demanded Slots

The number of slots the session requires to run all tasks (or, if MinimumServices policy is being used, the required minServices specified in the application profile, whichever is larger).

Deserved Slots

The number of slots a consumer is entitled to based on the share ratio of the resource plan.

Assigned Slots

The number of occupied slots assigned to the session to run the service. Occupied slots that are not assigned to a session (e.g. idle pre-started service instances) are referred to as "unassigned slots".

Reclaim Rank

Reclaim rank is only used with proportional or minimum services scheduling policy. When the system needs to reclaim a resource, reclaim rank is used to determine the relative importance of different sessions, so the system can reclaim a resource from the least important session.

Preference

The resource preference expression associated with the session. (Applicable to Symphony grid version only.)

Default Attribute Value

The default value for any attribute in the resource preference expression, if the attribute has no known value at the time the expression is evaluated by the system. (Applicable to Symphony grid version only.)


Related concepts
Session states
Related tasks
Control sessions