acms_delete_tpsystem(1) — Commands
Digital
NAME
acms_delete_tpsystem − Deletes an ACMSxp TPsystem
SYNOPSIS
acms_delete_tpsystem [ tpsystem-simple-name ]
DESCRIPTION
The acms_delete_tpsystem script deletes a TPsystem.
The script allows you to do one of the following operations:
•Specify a simple name of a TPsystem to delete
•Show a list of TPsystems, one of which you can select to delete
Steps to Follow
To delete a TPsystem, follow these steps:
1.Ensure that the TPsystem is in the not_started processing state. Use the acmsadmin utility and the stop directive. For example:
% acmsadmin
acmsadmin> stop tpsystem avertz_hq
.
.
.
acmsadmin>
When the TPsystem enters the not_started processing state, you can delete it.
2.The SFS server associated with the TPsystem must be running. Do not stop the SFS server when you stop the TPsystem. If there are any application servers, the software deletes them when the TPsystem is deleted.
3.Log in to the node on which the TPsystem runs.
4.Ensure that the ACMSxp software environment is set up.
Log in to DCE under a principal that has permissions to delete a TPsystem.
Run the acms_set_version script to define environment variables and point to the correct executables.
Check that Encina, DCE, and other dependent software are installed and configured correctly.
5.Ensure that you have access to the TPsystem registry file on the node.
You need file system write permission to delete a TPsystem.
6.Run the acms_delete_tpsystem script.
Invoke the script directly. Do not use source or . to invoke it because the script might exit the shell.
Invoking a Script for a Specific TPsystem
To delete a specific TPsystem, specify the simple name on the same line as the script invocation. For example:
% acms_delete_tpsystem avertz_hq
ACMSxp V3.1 for Digital UNIX
Deleting TPsystem /.:/acmsxp/avertz_hq ...
TPsystem /.:/acmsxp/avertz_hq deleted
The script locks the ACMSxp TPsystem registry file on the node and checks to see whether the default profile is used by other TPsystems.
Invoking the Script for a List of TPsystems
If you do not know the name of the TPsystem to delete, request a list of TPsystem names. To obtain the list, specify only the script name on the invocation line. For example:
% acms_delete_tpsystem
ACMSxp V3.1 for Digital UNIX
Delete which TPsystem?
1 /.:/acmsxp/usr/employee
2 /.:/acmsxp/usr/users/avertz
Please enter a number:
Type a number from the column on the left-hand side of the list and <Return> to delete the related TPsystem and confirm the deletion. The script displays another query requiring you to confirm the deletion of the TPsystem. For example:
Enter Number or return to continue, q[uit] : 2
Do you really want to delete the TPsystem avertz [Y|N] (N)?
Type the letter y and <Return> to delete the TPsystem. For example:
Do you really want to delete the TPsystem avertz [Y|N] (N)? y
Deleting TPsystem /.:/acmsxp/avertz_hq ...
The deleting message indicates that the script is attempting to delete the TPsystem. Type <Return> to omit deletion and exit the script.
The deleted message indicates that the TPsystem is deleted from the ACMSxp TPsystem registry. For example:
Deleting TPsystem /.:/acmsxp/avertz_hq ...
Tpsystem avertz_hq deleted
The script exits. If the default TPsystem profile is being used elsewhere, you see another message as follows:
The profile name will not be deleted because it is used elsewhere
Because a TPsystem default profile can be shared among multiple TPsystems, the script ensures that no other TPsystem needs that profile. See the ACMSxp Developing and Managing Applications for further details.
RELATED INFORMATION
Commands: acms(1), acmsadmin(1), acmslog(1), gwlog(1), stdl(1)
Scripts: acms_create_tpsystem(1), acms_set_version(1), acms_start_tpsystem(1)