TCMAN is a command-line utility for administering and managing PAS for OpenEdge. It extends the functionality that is provided by the core Apache Tomcat administrative scripts found in the instance-name/bin folder.

For more information, see the TCMAN reference.

Syntax

{$CATALINA_HOME|$CATALINA_BASE}/bin/tcman{.sh|.bat} action  [general_options] [action_options ]
Note: When using an HTTPS port for a PASOE instance, manager actions require that the Java Trust Store contains the appropriate root certificates. Unlike other administration tools, these actions do not use the %DLC%/certs store.
If the HTTP port is disabled, the manager actions of the tcman command fail with the following error message:
the manager application network port 8810 is not open

For more information about this, see Known issues in OpenEdge 12.8.8.

Parameters

$CATALINA_HOME|$CATALINA_BASE

$CATALINA_HOME is the path of the installation directory of PAS for OpenEdge, typically OpenEdge-Install-Dir/servers/pasoe. Always run TCMAN from $CATALINA_HOME/bin when you create new instances or worker configuration files. You can add the -I instance_alias_name option to specify an instance on which to apply the TCMAN action.

$CATALINA_BASE is the path of the directory of an instance.

Note:

TCMAN automatically determines the value of CATALINA_BASE based on the directory where you start the utility. When you run the utility from the instance-name/bin directory, the value of CATALINA_BASE is the root directory of the instance.

If you run TCMAN from the the PAS for OpenEdge installation directory (OpenEdge-Install-Dir/servers/pasoe/bin), then the value of CATALINA_BASE and CATALINA_HOME are the same.

action
The TCMAN action to invoke.
general_options
One or more of the TCMAN common options that can apply to most actions.

Type tcman.sh help action for a list of general options that are applicable to a particular action.

action_options
An option that applies to the selected action. These options are explained in the topics that describe each action.