pstat_test

NOTE: When running on a case sensitive operating system (e.g. UNIX), you must supply values that match the case of the OSF blackboard (typically lowercase).

Usage: pstat_test [-i pid] [-o process] [-s status] [-x start_time]
                  [-p path] [-n node] [-c command] [--count] [--help]

No arguments are required. By itself, the command will print all PSTATs on the current blackboard (all processes running, absent, suspended, etc.). Any PSTAT selection options given will reduce the set of returned matches. Any PSTAT selection options omitted will be replaced with default search characters that will match all PSTATs.

Inputs

Command line parameters.

PSTATs written to the standard output (terminal), or the total number found.

Returned status value is: '0' on success, '1' on general failure.

-i

OPUS process id (the PID part of the PSTAT), e.g. 000001fc.

OPUS process name (the PROCESS part of the PSTAT), e.g. listhd.

OPUS process status (the PROC_STAT part of the PSTAT), e.g. idle.

OPUS process start-time (the START_TIME part of the PSTAT), e.g. 4151da2b.

OPUS process path (the PATH part of the PSTAT), e.g. g2f.

OPUS process node, or machine name (the NODE part of the PSTAT), e.g. tufnel.

OPUS process command being worked (the PROC_CMD part of the PSTAT), e.g. susp. Legal values are: halt,susp,resu,init.

If this argument is provided, the output will be the total number found, instead of the default listing of the PSTATs.

Prints out the usage statement.

% pstat_test -p g2f -s idle

Finds all idle processes running in the g2f path. Prints each entire PSTAT to the terminal.

000001fc-g2f______-idle___________.4151da2b-g2f______-tufnel______________-____
00000c55-comprs___-idle___________.4151e1c0-g2f______-tufnel______________-____
00000c8c-listhd___-idle___________.4151e1cd-g2f______-tufnel______________-____

% pstat_test -p g2f -s idle --count

Finds the number of all idle processes running in the g2f path. Prints '3' to the terminal (given above example). To catch this value in a UNIX shell script variable, you could use:

set numIdle = `pstat_test -p g2f -s idle --count`