|
|
|
|
|
|
tmipcrm(1)
Name
tmipcrm - remove IPC resources allocated by a BEA Tuxedo application on a local machine
Synopsis
tmipcrm [-y] [-n] [TUXCONFIG_file]
Description
tmipcrm cleans up the IPC resources allocated by a BEA Tuxedo 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 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 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 used typically.
$ 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 application on a local machine in a file called ipclist.
tmipcrm -n /home/user/apps/tuxconfig >ipclist
|
|
|
|
|
|
Copyright © 2000 BEA Systems, Inc. All rights reserved.
|