Purpose

Show the names and locations of the instances created from the PAS installed in $CATALINA_HOME by displaying the contents of the file where instances are registered for tracking.

By default, instances are registered for tracking $CATALINA_HOME/conf/instances.{windows|.unix}. The file name extension indicates the OS platform where the PAS server is installed.

Syntax

tcman.sh instances [general_options]

Parameters

general_options
Specify one or more of the general TCMAN options. Run tcman.sh help instances to see which general options are appropriate.

Output format

The following is the format of the output from a TCMAN instances action:

alias-name | full-file-path | type | state
alias-name
The user-defined name for the instance.
full-file-path
The location, in the OS file system, of the instance's root directory.
type
The designation of the server instance type (for example: instance, service, . . .).
state
An indication of the instance's validity. OK is returned for a valid server and invalid is returned for a corrupted or non-existant server.

Example

Display the instances of the core server installed in /psc/pashome:

/psc/pashome/bin/tcman.sh instances
acme1 | /psc/wrk/acme1 | instance | ok
acme2 | /psc/wrk/acme2 | instance | ok

Notes

  • By default, instances are registered when you execute a $CATALINA_HOME/bin/tcman{.sh|.bat} create action, which automatically adds instance entries to an instances file. TCMAN removes instance entries from the file when you execute a delete action.

    You can manually add or remove instance entries from instances by using the register or unregister actions.

  • By default, the name and location of the file where instances are registered is $CATALINA_HOME/conf/instances.{windows|.unix}.

    You can change the location of the instance registration file by adding and setting the psc.as.instdir property in the appserver.properties file. Use the TCMAN config action as in the following example:

    tcman.sh config '+psc.as.instdir=PATH'

    where PATH is a path name or an environment variable.

    You can also change the location and/or name of instance registration files by setting the environment variables, PAS_AS_INSTANCE_DIR, and PAS_AS_INSTANCE_FILE.