USS Processes attributes

The USS Processes attributes provide detailed information about each process your system is currently executing.

ASID The numeric identifier of the address space containing this process. Valid value is a positive integer in the range 0 through 65535. (This value is generally not useful when defining situations.)

Command The individual command that initiated the process, together with any specified arguments. The column contains the command as entered; path information might not have been specified. The Path column always contains the path to the command, but does not contain any arguments, even if arguments were entered. This attribute can be any valid command.

z/OS UNIX System Services permits the total length of a command and its arguments to be up to 1024 bytes. If the command and its arguments are longer than the width of the column, the information is truncated and a plus sign (+) is displayed in the last position of the column.

If this is a traditional z/OS load module residing in a partitioned data set (PDS) or PDS/E (as opposed to an z/OS UNIX executable residing in an HFS file), this column will contain the 8-character load module name.

Command Name The command name alone, stripped of any parameters, to be used in situations.

Current VNode Tokens The current number of VNode tokens. A VNode token is an internal identifier used to refer to a file or a directory. Valid value is a 4-byte integer.

Effective Group ID The current group ID, but not necessarily the user's own ID. For example, a user logged in under a particular group ID may be able to change to another group ID. The ID to which the user changes becomes the effective group ID. Generally, this attribute contains a copy of the effective group identifier at the time a program is executed. The effective group ID, along with the effective userid, is used to determine file access permissions. Valid value is a positive integer in the range 0 through 2147483647.

Effective User A character representation of the effective userid. If the effective user ID is 0 (superuser), and if more than one user is assigned superuser (or root) authority, then the information in this column is unpredictable. A valid value consists of alphanumeric characters and follows the z/OS rules for user IDs.

Effective Userid The current user ID, but not necessarily the user's login ID. For example, if a user changes to another user's ID (assuming the proper authority), the ID to which the user changes becomes the effective user ID until the user switches back to the original login ID. The effective userid, together with the effective group ID, is used to determine file access permissions. Initially, this value is the same as the numeric userid (UID), but can be changed as the result of issuing an EXEC or SETUID. Valid value is a positive integer in the range 0 through 2147483647.

Execution State The execution state of the process. Valid values are:

Foreground Process Group A process group whose member processes have certain privileges when accessing the controlling terminal. These privileges are denied to processes in background process groups. Valid value is a positive integer in the range 0 through 2147483647.

Jobname The z/OS name of the batch job, started task, or TSO address space containing this process.

Leader Session ID The process ID of the process that created the session to which this process belongs. (A session is a collection of one or more process groups.) Valid value is a positive integer in the range 0 through 2147483647.

Maximum VNode Tokens The maximum number of VNode tokens. A VNode token is an internal identifier used to refer to a file or a directory. Valid value is a 4-byte integer.

MVS Status The status of the z/OS subsystem process. Valid values are Normal, Swapped_Out, or Not_Used.

ORIGINNODE The monitored z/OS operating system on which UNIX System Services is hosted. Valid value is a character string with a maximum length of 32 bytes.

Parent Process ID The process ID of the parent process; that is, the process that created this process. When a process terminates, its children will be adopted by PID 1. This attribute is not useful in defining a situation. Valid value is a positive integer in the range 0 through 2147483647.

Path The full path to the command. This differs from the Command column in that the Command column contains the command as entered (path might not have been specified) and any specified options. The information in this column may be truncated if it contains too many characters. If truncation occurs, a plus sign (+) is displayed in the last column position.

Process Group A collection of processes that permits the signalling of related processes. Each process in the system is a member of a process group that is identified by a process group ID. Valid value is a positive integer in the range 0 through 2147483647.

Process ID Numerical identifier that z/OS UNIX System Services assigns to a process. Valid value is a positive integer in the range 0 through 2147483647.

Process Status The current state of the process. This information is generally meaningful only to persons having knowledge of z/OS UNIX System Services internals. Valid values are:

Real Group ID The group ID of the user who created the process and is defined in the password file. Valid value is a positive integer in the range 0 through 2147483647.

Real User A character representation of the real userid. If the real userid is 0 (superuser), and if more than one user is assigned superuser (or root) authority, then the information in this column is unpredictable. A valid value consists of alphanumeric characters and follows the z/OS rules for userid.

Real Userid The user ID specified in the /etc/password file. The attribute of a process that, at the time of process creation, identifies the user who created the process. Valid value is a positive integer in the range 0 through 2147483647.

Saved-Set Group ID The effective group ID at the time the setgid function was invoked (usually by exec) to change the effective group id; that is, the effective group ID before it was last changed. Valid value is a positive integer in the range 0 through 2147483647.

Saved-Set User A character representation of the saved-set userid. If the saved set userid is 0 (superuser), and if more than one user is assigned superuser (or root) authority, then the information in this column is unpredictable. A valid value consists of alphanumeric characters and follows the z/OS rules for userid.

Saved-Set Userid The effective userid at the time the setuid function was invoked (usually by exec) to change the effective userid; that is, the effective userid before it was last changed. Valid value is a positive integer in the range 0 through 2147483647.

Server Flags Server Flags.

Server Name The name of the server. Valid value is a string of length 32.

Server Type The type of server. Valid values are Not available, File, or Lock.

ServTypeH The Server Type in hexadecimal.

Start Time The time the process started executing. Valid value is a timestamp in the form mm/dd/yy hh:mm:ss.

Starting Time The time the process started executing. Valid value is a 4-byte integer.

System CPU Time The CPU time devoted to executing z/OS UNIX System Services system kernel code. System CPU time includes time spent executing system calls and performing administrative functions. It does not include some trivial calls. The value displayed is in seconds to the nearest hundredth of a second. For example, a displayed value of 1.23 would be 1 23/100 seconds. Valid values are numeric in the range 0 through 2147483647 and include the use of the *AVG, *MAX, *MIN, or *SUM functions.

Terminal Device The name of the terminal device that started the process. A valid value consists of alphanumeric characters and follows the z/OS rules for userid.

Total Size Represents the amount of virtual storage (in bytes) allocated to the process or to all processes running in a given address space. This value applies to extended (above the line) private storage only. It is calculated by subtracting the lowest allocated address in extended private storage from the highest allocated address.

UNIX Run Time CPU time for UNIX work. Valid value is a 4-byte integer.

UNIX Run Time% Percent of CPU execution for UNIX work. Valid value is a 4-byte integer in the range 0 - 100.

User CPU Time The CPU time that has been used by this process (excluding execution of kernel code). User CPU time includes time spent executing both user programs and library functions. It does not include CPU time spent executing system calls. The value displayed is in seconds to the nearest hundredth of a second. For example, a displayed value of 1.23 would be 1 23/100 seconds. Valid values are numeric in the range 0 through 2147483647 and include the use of the *AVG, *MAX, *MIN, or *SUM functions.