List process ids (plist)

Purpose

List the process ids for all the processes that are running under an instance.

Syntax

tcman.sh plist [general_options] [-f]

Parameters

general_options

Specify one or more of the options that can be used with any TCMAN action. Run tcman.sh help plist to see which general options are appropriate.

-f

Display verbose output. The output is indented and uses the plus (+) character to indicate parent-child relationships.

Examples

Display process id's for the running instance, acme1 using the -v and -f options:

/psc/acme1/bin/tcman.sh plist -v
info: showing process ids for server 5942
5942 5963 5975 5988 6001 6015

/psc/acme1/bin/tcman.sh plist -f
5942
+5963
+5975
+5988
+6001
+6015

Notes

The plist action is useful for administrative tasks such as:

Checking to see if processes persist after an instance is stopped.

Checking if an multi-session agent process has started and is available

Checking if an instance is running. Output is 0 if it is not running.

Using the output (which is easily parseable) in administrative scripts.