Displays information about applications, sessions, and tasks, and displays the application profile.
Use soamview to view information about applications, sessions, and tasks, and to view the application profile.
Symphony DE does not verify the optional user name and password. Symphony DE users can control all sessions and applications in their environment.
In Symphony, the information soamview displays depends on your user ID authorization, as follows:
The consumer administrator can view information for all applications associated with that consumer. To specify an absolute consumer name that contains spaces, enclose the name in double quotes (" ").
Users can view information for only those applications their user privileges allow, the applications they submitted.
To view large amounts of information (when output exceeds one screen), pipe or redirect the command output to a file.
The application totals displayed by soamview reflect the values of counters that start when the application is enabled or when a new session manager starts for this application (in a failover event). These counters are reset when the application is disabled or the session manager exits. The session and task totals soamview displays reflect counters in session and task runtime and historical data.
Displays brief and summary information for a specific application.
Specifies the name of the application. The application name is the same as it appears in the application profile. Enclose the application name in double quotes (" ") if it contains spaces. Precede the application name with two dashes (--) if it starts with a dash.
Specifies the name of the user to connect to Platform Symphony for this command. If you are already logged on to Platform Symphony using soamlogon, for this command only the user name specified here overrides the user name entered in soamlogon.
Specifies the user password to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only, the password specified here overrides the password entered in soamlogon.
Displays information about all enabled and disabled applications the user manages.
In Symphony DE, users have access to information on all applications and do not need to supply the application name, consumer ID, user name, or password.
In Platform Symphony, users without cluster or consumer privileges must provide an application name. Users can view information only for applications, sessions, and tasks they submitted.
Specifies the consumer ID. The consumer ID is the same as it appears in the application profile. Enclose the consumer ID in double quotes (" ") if it contains spaces. The consumer ID starts with a forward slash.
Displays information for all enabled and disabled applications. Enclose the states in double quotes (" ") and use | as a separator. For example, -s "enabled|disabled".
Specifies the name of the user to connect to Platform Symphony for this command. If you are already logged on to Platform Symphony using soamlogon, for this command only the user name specified here overrides the user name entered in soamlogon.
Specifies the user password to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the password specified here overrides the password entered in soamlogon.
Displays service package download details.
Specifies the name of the application. The application name is the same as it appears in the application profile. Enclose the application name in double quotes (" ") if it contains spaces. Precede the application name with two dashes (--) if it starts with a dash.
Displays the package download details of the specified host(s).
Displays the details for packages that are in the process of being downloaded.
Displays the details for package downloads that have finished.
Displays the details for package downloads that have received error messages.
Displays package download details for the specified application in all states.
Specifies a duration, in seconds, to query package downloads which are either finished or still in progress within the time_length until now.
Specifies the name of the user to connect to Platform Symphony for this command. If you are already logged on to Platform Symphony using soamlogon, for this command only the user name specified here overrides the user name entered in soamlogon.
Specifies the user password to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the password specified here overrides the password entered in soamlogon.
Displays information about host slots and allocation status of an application.
If the display shows slots in the occupied state without an associated session, this means that the slots are allocated to the SSM but are not bound to any session.
Slots in the standby state are always displayed without an associated session since these slots are not allocated to the application.
Specifies the name of the application. The application name is the same as it appears in the application profile. Enclose the application name in double quotes (" ") if it contains spaces. Precede the application name with two dashes (--) if it starts with a dash.
Displays the hosts and slots allocation information at the session level.
Specifies that information for slots in the given state is required.
Specifies that information for slots in all states is required.
Specifies the name of the user to connect to Platform Symphony for this command. If you are already logged on to Platform Symphony using soamlogon, for this command only the user name specified here overrides the user name entered in soamlogon.
Specifies the user password to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the password specified here overrides the password entered in soamlogon.
When no options are specified, the command displays slot use and demand information of each resource group specified in the resource group filter for an application.
When options are specified, the command displays slot use and demand information for each session including the resource group filter, assigned slots, and unmet demand. For slots that cannot be used by any session when the SSM holds them due to "exclusive allocation", the command also displays unassigned slots.
Specifies the name of the application. The application name is the same as it appears in the application profile. Enclose the application name in double quotes (" ") if it contains spaces. Precede the application name with two dashes (--) if it starts with a dash.
Displays the resource group filter, assigned and unassigned slots, and unmet demand at the session level.
Specifies that you want to filter the result for slots that are not allocated to any sessions.
Specifies the name of the user to connect to Platform Symphony for this command. If you are already logged on to Platform Symphony using soamlogon, for this command only the user name specified here overrides the user name entered in soamlogon.
Specifies the user password to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the password specified here overrides the password entered in soamlogon.
Displays information for sessions in various states. By default, sessions are displayed from newest to oldest. When used without the -s option, displays only information for open sessions.
Specifies the name of the application. The application name is the same as it appears in the application profile. Enclose the application name in double quotes (" ") if it contains spaces. Precede the application name with two dashes (--) if it starts with a dash.
Specifies the interval for the session creation time. If you specify the session creation time interval without an end time, the interval end time is considered the time at which you entered the command.
Specify the time in the format "[[yyyy/][mm/][dd/]hh:mm], [[yyyy/][mm/][dd/]hh:mm]". Do not specify spaces in the time interval string. For more specific syntax and examples of time formats, refer to Time interval format.
Specifies the interval for the session end time. If you specify the session end time interval without a session creation time interval, the system retrieves all relevant records prior to the session end time.
Specify the time interval in the format "[[yyyy/][mm/][dd/]hh:mm], [[yyyy/][mm/][dd/]hh:mm]". Do not specify spaces in the time interval string. For more specific syntax and examples of time formats, refer to Time interval format.
Specifies the reverse order for record retrieval starting with the oldest records being displayed first.
Specifies that information for sessions in all states is required.
Specifies that information for all sessions in one or more of the specified states is required. To specify multiple states, enclose the states in double quotes (" ") and use | as a separator. For example, -s "open|suspended".
Only the first three letters of the state need to be specified.
Specifies the string that is used for identification purposes to query the session.
The session tag supports the use of wildcard characters to represent specific string patterns, as follows:
The session tag also supports the use of reserved character "!" to indicate no session tag. For example, to display all sessions in the open state that do not have tags, enter:
Displays information for sessions submitted by the user specified.
Displays information for sessions with the specified session name.
Specifies the name of the user to connect to Platform Symphony for this command. If you are already logged on to Platform Symphony using soamlogon, for this command only the user name specified here overrides the user name entered in soamlogon.
Specifies the user password to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the password specified here overrides the password entered in soamlogon.
Display information for 40 open or suspended sessions for the sampleApp application that were submitted by userabc.
Display information for open or closed sessions for the sampleApp application that match the "myTag" session tag.
Display information for sessions with the "mySession" session name.
Display information for sessions that were running during the specified interval. In this example, the system will return all sessions that were open or suspended between 10:00am January 21, 2009 and 2:00pm January 22, 2009.
soamview session sampleApp -s "all" -c ,2009/01/22/14:00 -e 2009/01/21/10:00,-
Displays brief and summary information for a specific session of an application.
Specifies the name of the application. The application name is the same as it appears in the application profile. Enclose the application name in double quotes (" ") if it contains spaces. Precede the application name with two dashes (--) if it starts with a dash.
Specifies the Platform Symphony-assigned ID of the session as reported by soamview session.
Specifies the name of the user to connect to Platform Symphony for this command. If you are already logged on to Platform Symphony using soamlogon, for this command only the user name specified here overrides the user name entered in soamlogon.
Specifies the user password to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the password specified here overrides the password entered in soamlogon.
Displays brief and summary task information for tasks of an application. By default, tasks are displayed from newest to oldest.
Specifies the name of the application. The application name is the same as it appears in the application profile. Enclose the application name in double quotes (" ") if it contains spaces. Precede the application name with two dashes (--) if it starts with a dash.
Specifies the Platform Symphony-assigned ID of the session as reported by soamview session.
Specifies the interval for when the task started to run.
Specify the time interval in the format "[[yyyy/][mm/][dd/]hh:mm], [[yyyy/][mm/][dd/]hh:mm]". Do not specify spaces in the time interval string. For more specific syntax and examples of time formats, refer to Time interval format.
Specifies the interval for the task submit time. If you specify the task submit time interval without an interval end time, the interval end time is considered the time at which you entered the command.
Specify the time interval in the format "[[yyyy/][mm/][dd/]hh:mm], [[yyyy/][mm/][dd/]hh:mm]". Do not specify spaces in the time interval string. For more specific syntax and examples of time formats, refer to Time interval format.
Specifies the reverse order for record retrieval starting with the oldest records being displayed first.
Specifies the interval for the task end time. If you specify the task end time without a task submit time, the system retrieves all relevant records prior to the task end time.
Specify the time interval in the format "[[yyyy/][mm/][dd/]hh:mm], [[yyyy/][mm/][dd/]hh:mm]". Do not specify spaces in the time interval string. For more specific syntax and examples of time formats, refer to Time interval format.
Specifies the name of a specific compute host that the tasks were running on.
Displays information for all tasks in the state specified.
’You can specify the full task state name or the first three letters of the task state:
Displays information for all tasks that match the task tag.
The task tag supports the use of wildcard characters to represent specific string patterns, as follows:
The task tag also supports the use of reserved character "!" to indicate no task tag. For example, to display all tasks in the done state that do not have tags, enter:
Specifies the name of the user to connect to Platform Symphony for this command. If you are already logged on to Platform Symphony using soamlogon, for this command only the user name specified here overrides the user name entered in soamlogon.
Specifies the user password to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the password specified here overrides the password entered in soamlogon.
Display summary and brief task information for running tasks tagged as myTask.
Display summary and brief task information for currently running tasks that were submitted during the specified interval.
soamview task sampleApp:101 -s running -c 2009/01/21/10:00, 2009/01/21/11:00
Display summary and brief task information for tasks that were running during the specified interval. In this example, the system will return all tasks that were running between 10:00am January 21, 2009 and 2:00pm January 22, 2009 for session 101.
soamview task sampleApp:101 -s running -c ,2009/01/22/14:00 -e 2009/01/21/10:00,-
Displays brief and summary information for a specific task.
Specifies the name of the application. The application name is the same as it appears in the application profile. Enclose the application name in double quotes (" ") if it contains spaces. Precede the application name with two dashes (--) if it starts with a dash.
Specifies the Platform Symphony-assigned ID of the session as reported by soamview session.
Specifies the Platform Symphony-assigned ID of the task as reported by soamview task.
Specifies the name of the user to connect to Platform Symphony for this command. If you are already logged on to Platform Symphony using soamlogon, for this command only the user name specified here overrides the user name entered in soamlogon.
Specifies the user password to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the password specified here overrides the password entered in soamlogon.
You use the time interval to define a start and end time for collecting the data to be retrieved and displayed. While you can specify both a start and an end time, you can also let one of the values default. You can specify either of the times as an absolute time, by specifying the date or time, or you can specify them relative to the current time.
Specify the time interval as follows:
start_time,end_time|start_time,-|-,end_time|start_time
Specify start_time or end_time in the following format:
[[year/][month/][day]/hour:minute]
Specifies a start time, and lets the end time default to now.
Specifies to start with the first logged occurrence, and end at the time specified.
Starts at the beginning of the most specific time period specified, and ends at the maximum value of the time period specified. For example, 2/ specifies the month of February—start February 1 at 00:00 a.m. and end at the last possible minute in February: February 28th at midnight.
Assume the current time is May 9 17:06 2008:
2008/5/8/13: = May 8 13:00 to May 8 13:59
2008/5/8/13:, = May 8 13:00 to the current time
2008/5/8/13:30 = May 8 13:00:00 to May 8 13:30:59
2008/5/8/13:30, = May 8 13:00:00 to the current time
1,8 = May 1 00:00 2008 to May 8 23:59 2008
,4 = the time of the first occurrence to May 4 23:59 2008
6 = May 6 00:00 2008 to May 6 23:59 2008
2/ = Feb 1 00:00 2008 to Feb 28 23:59 2008
/12: = May 9 12:00 2008 to May 9 12:59 2008
2/1 = Feb 1 00:00 2008 to Feb 1 23:59 2008
2/1, = Feb 1 00:00 to the current time
,2/10: = the time of the first occurrence to May 2 10:59 2008
2001/12/31,2008/5/1 = from Dec 31, 2001 00:00:00 to May 1st 2008 23:59:59
.-9, = April 30 17:06 2008 to the current time
,.-2/ = the time of the first occurrence to Mar 7 17:06 2008
.-9,.-2 = nine days ago to two days ago (April 30, 2008 17:06 to May 7, 2008 17:06)