tmipcrm(1)

Name

tmipcrm—Removes IPC resources allocated by a BEA Tuxedo ATMI application on a local machine.

Synopsis

tmipcrm [-y] [-n] [TUXCONFIG_file]

Description

tmipcrm cleans up the IPC resources allocated by a BEA Tuxedo ATMI application such as shared memory, message queues, and semaphores. The command is normally run after an unusual error situation such as a failed shutdown. Under normal conditions, the BEA Tuxedo ATMI system cleans up all allocated IPC resources when it is shut down. The IPC resources that are removed include those used by the core BEA Tuxedo ATMI system and the Workstation component.

tmipcrm works only on the local server machine; it does not clean up IPC resources on the remote machines in a BEA Tuxedo configuration. The name of the TUXCONFIG file must be specified, either as the value of the TUXCONFIG environment variable or on the command line. The TUXCONFIG file must exist and it must be readable.

Only an administrator or someone with the proper permissions can run this command successfully. The command assumes that it can attach to the shared memory segments that store the bulletin board (BB), and attempts to remove the IPC resources stored in the bulletin board and referenced from it. Such removal attempts may fail due to other conditions on the system. If detected, such failures are reported.

The following options are supported:

Diagnostics

If the TUXCONFIG file cannot be found, a fatal error occurs and the following message is displayed:

Cannot open tuxconfig file

If the TUXCONFIG file cannot be read, a fatal error occurs and the following message is displayed:

Execute permission denied, not application administrator

If an attempt to attach to the bulletin board shared memory fails, a fatal error occurs and the following message is displayed:

Cannot attach to BB!

Examples

The command generally runs in an interactive mode, and prompts the user for responses to questions when necessary. If the -y option is specified, tmipcrm does not prompt the user, but assumes the answer to every question is yes. If the -n option is specified, tpipcrm simply displays a list of IPC resources (on stdout) and exits; no IPC resources are removed.

The following example demonstrates how this command is typically used:

$ tmipcrm /home/user/apps/tuxconfig
Looking for IPC resources in TUXCONFIG file /home/user/apps/tuxconfig 
The following IPC resources were found:

Message Queues:
0x2345
0x3456

Semaphores:
0x34567
0x45678

Shared Memory:
0x45678
0x56789

Remove these IPC resources (y/n)?: y
Removing IPC resources  done!

The following example code prints a list of the IPC resources for a BEA Tuxedo ATMI application on a local machine in a file called ipclist:

tmipcrm -n /home/user/apps/tuxconfig >ipclist