Function

The hdeshmclean command deletes shared resources (processes, shared memory, semaphores) that remain when the source Datareplicator terminates abnormally. This command is only applicable to the UNIX edition. The Datareplicator administrator executes this command.

Format

hdeshmclean [ -x host-name ]
  [ -l clean[ -q{resp|noresp}][ -w ][ -t{mst|nmt|both}]]

Options

-x host-name ~ <identifier of 1-32 characters>

Specify the name of the host that contains the shared resources to be deleted. This option must be specified in the following cases:

Condition	Value to be specified in this option
true is specified in the errfile_unique operand in the extraction system definition	Specify the name of the host that contains the shared resources to be deleted (specify the name that matches the xxxxx part of the file errfile1_xxxxx that has been created under $HDEPATH on the corresponding server). Note that there is no need to specify this option when the command is executed with the -t mst option specified on the server where only the extraction master process is running.
server is specified in the nodecontrol operand in the extraction system definition	Specify the name of the back-end server that contains the shared resources to be deleted (specify the name that matches the xxxxx part of the file errfile1_xxxxx that has been created under $HDEPATH on the corresponding back-end server).

-l clean

Specify this option to delete shared resources. If this option is omitted, the command only displays the remaining shared resources.

-q{resp|noresp}

Specify whether the KFRB04331-Q message is to be displayed for confirmation before the shared resources are deleted.

resp

Outputs the KFRB04331-Q message. The command deletes the shared resources only when y is entered.

noresp

Deletes the shared resources without displaying the KFRB04331-Q message.

-w

Specify this option to delay termination of this command until deletion of the shared resources has been completed. If this option is omitted, whether deletion of the shared resources has been completed when the command terminates cannot be guaranteed.

-t{mst|nmt|both}

Specify the resources that are to be deleted when this command is executed on the server where both types of resources exist.

mst

Deletes resources managed by the extraction master process.

nmt

Deletes resources managed by the extraction node master process.

both

Deletes resources managed by both the extraction master process and the extraction node master process.

Output format

nodemst specified in the sendcontrol operand in the extraction system definition

sendmst specified in the sendcontrol operand in the extraction system definition

Explanation of the output information

No.	Output information	Remarks
1	Header for the resources managed by the extraction master process	If there are no resources managed by the extraction master process, Nos. 1 through 5 are not displayed.
2	Shared memory ID for command communication	--
3	Semaphore IDs for locking status commands	--
4	Process ID of extraction master process	--
5	Process ID for activity trace collection process	--
6	Header for the resources managed by the extraction node master process	If there are no resources managed by the extraction node master process, items beginning with No. 6 are not displayed.
7	Shared memory ID for process-to-process communication	--
8	Shared memory ID for storing extraction definition	--
9	Shared memory ID for storing message text	--
10	Shared memory ID for command communication	If server is not specified in the nodecontrol operand in the extraction system definition, 0 is output.
11	Semaphore for locking nodes	--
12	Semaphore IDs for locking commands	If server is not specified in the nodecontrol operand in the extraction system definition, 0 is output.
13	Process ID of extraction node master process	--
14	Process ID of activity trace collection process	--
15	Resource header for each server	--
16	Shared memory ID for managing transaction information	If server is not specified in the nodecontrol operand in the extraction system definition, 0 is output.
17	Shared memory ID for managing update information in transaction
18	Shared memory ID for managing branch information in transaction
19	Shared memory ID for managing transmission process
20	Semaphores for locking servers
21	Process ID of extraction process	--
22	Process ID of transmission process	The transmission process name is displayed as follows: When nodemst is specified in the sendcontrol operand in the extraction system definition: hdesender (target-ID) When sendmst is specified in the sendcontrol operand in the extraction system definition: hdesendmst
23	Process ID of transmission process (hdesndprc)	This information is output when sendmst is specified in the sendcontrol operand in the extraction system definition. As many process IDs as there are active processes are displayed. If no transmission process (hdesndprc) is running, this information is not displayed.

Legend:

--: Not applicable

Rules

If the source Datareplicator cannot be started because there are shared resources remaining, execute the hdestop command to delete the shared resources. Use this command if the shared resources cannot be deleted by executing the hdestop command.