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 if an instance is stopped or running. If it is running, it returns the process id of the instance. If it is stopped, 0 is returned.
  • Using the output (which is easily parsable) in administrative scripts.
  • If the instance's applications have started sub-processes, multiple process ids will be returned.
  • If multiple process ids are listed, the instance is always listed first.