acms_start_tpsystem(1) — Commands
Digital
NAME
acms_start_tpsystem − Starts an ACMSxp TPsystem
SYNOPSIS
acms_start_tpsystem [tpsystem-simplename]
DESCRIPTION
You must start a TPsystem on each system on which TP applications servers run. The acms_start_tpsystem script starts a TPsystem and subordinate entities. The script allows you to do one of the following operations:
•Specify a simple name of a TPsystem to start
•Show a list of TPsystems, one of which you can select to start
Steps to Follow
To run ACMSxp applications or manage ACMSxp objects, the parent TPsystem that supports the entities must be running. To start a TPsystem, follow these steps:
1.Log in to the system on which the TPsystem and its application servers are to run.
oYou must be logged in to the system on which you created the TPsystem.
oEnsure that the operating system account has access to the TPsystem registry.
oIf you are starting a TPsystem that runs under root, log in to the system under the root account, because the TPsystem must run as the DCE machine principal.
2.Ensure that the ACMSxp software environment is set up.
oIf you are logged in as root, do not do a DCE login, because you are already running as the DCE machine principal.
oThe principal under which you are running must meet the security requirements. For example, the principal must be authorized to start TPsystems.
oRun the acms_set_version script to define environment variables and point to the correct executables. For example, the script defines the ACMS_SYS_DIR environment variable that is required to run the acms_start_tpsystem script.
oCheck that Encina, DCE, and other dependent software are installed and configured correctly. See the ACMSxp Developing and Managing Applications for further details.
oEnsure that you have access to the TPsystem registry file on the node.
3.Run the acms_start_tpsystem script found in the ACMSxp system directory to which the environment variable ACMS_SYS_DIR points.
Two formats are supported: .sh and .csh. Invoke the script directly from either the C shell or Bourne shell. Do not use source or . to invoke the it because the script might exit the shell.
Invoking a Script for a Specific TPsystem
To start a specific TPsystem, supply the simple name on the same line as the script invocation. For example:
% acms_start_tpsystem avertz_hq
ACMSxp V3.0 for Digital UNIX
Starting the tpsystem /.:/acmsxp/avertz_hq
The script accesses the ACMSxp TPsystem registry file to verify that the TPsystem avertz_hq exists, obtain information for setting environment variables, and start the TPsystem.
Invoking the Script for a List of TPsystems
If you do not know the name of the TPsystem to start, request a list of TPsystem names. To obtain the list, specify only the script name on the invocation line. For example:
% acms_start_tpsystem
ACMSxp V3.0 for Digital UNIX
Press return to have a list of TPsystems
TPsystem name []:
Respond to the query for a TPsystem name in one of the following ways:
•Type <Return> to list the available TPsystems.
•Type help and <Return> to obtain explanatory help text.
•Type a TPsystem simple name and <Return> to start a specific TPsystem.
If you list available TPsystems, the script displays as many as twenty at a time from the registry file. For example:
------------------------------------------------------------------------
No. TPsystem Version Namespace Directory Config.db
------------------------------------------------------------------------
1 employee 3.0 /.:/acmsxp /usr/employee
2 avertz_hq 3.0 /.:/acmsxp /usr/users/avertz
Enter Number or return to continue, q[uit] :
Respond to the query for a number in one of the following ways:
•Type a number from the No. column on the left-hand side of the list and <Return> to start the related TPsystem.
•Type <Return> to continue listing the available TPsystems. The listing of TPsystems wraps until you type a number or the letter q.
•Type the letter q and <Return> to exit the script.
If you type the number corresponding to the TPsystem to be started, the script sets up environment variables and starts the TPsystem. For example:
Enter Number or return to continue, q[uit] : 2
The SFS server is up.
Starting the tpsystem /.:/acmsxp/avertz_hq
The message concerning SFS means that the server is running and is responding to incoming RPC calls. For a TPsystem to run, its related SFS server must be running. If you created the SFS server when you created the TPsystem, ACMSxp software automatically starts the related SFS server if it is not already running.
The starting message indicates that the software is attempting to start the TPsystem avertz_hq. During this attempt, the TPsystem is in the starting processing state.
Determining When a TPsystem Starts
The ready message indicates that the TPsystem is in the started processing state. For example:
Starting the tpsystem /.:/acmsxp/avertz_hq ...
TPcontroller Ready
With the TPsystem in the started processing state, you can perform operations on the TPsystem and entities subordinate to that TPsystem. For more information, see the help information in the acmsadmin utility.
RELATED INFORMATION
Commands: acms(1), acmsadmin(1), acmsdbx(1), acmslog(1), stdl(1)
Scripts: acms_create_tpsystem(1), acms_delete_tpsystem(1), acms_set_version(1)