dccspool [-i] [-d number-of-days][-k {dump|all}]

The dccspool command deletes the troubleshooting information created in the $DCDIR/spool directory.

-i

When this option is specified, OpenTP1 outputs a confirmation dialog box to the standard output asking whether it is all right to delete the files containing troubleshooting information. When you enter y, the applicable files are deleted.

If you omit this option, the applicable files are deleted without outputting a confirmation dialog box to the standard output. The names of the deleted files are output to the standard output.

-d number-of-days~<unsigned integer>((0-24855))<<1>>

Deletes the files that were created before the calculated time. OpenTP1 first calculates the number of hours equivalent to the number of days specified in this option by multiplying the specified value by 24. It then deletes the files that were created before the time obtained by subtracting the obtained number of hours from the time that the dccspool command was executed. For example, if you specify 10 as the number of days, OpenTP1 deletes all files that were created prior to 240 hours before the time that the command was executed and earlier.

If you omit this option, OpenTP1 deletes all files that were created prior to 24 to hours before the command was executed.

If you specify 0, all the files are deleted regardless of the time that they were created.

-k dump|all~<<dump>>

Specifies the files to be deleted.

dump

The following files are deleted:

• Files in $DCDIR/spool/save
• Shared memory dump file in $DCDIR/spool

all

The following files are deleted:

• Files in $DCDIR/spool/save
• Shared memory dump file in $DCDIR/spool
• Deadlock information file and timeout information file in $DCDIR/spool/dclckinf
• Incomplete-transaction information file in $DCDIR/spool/dctrninf
• Invalid message information file in $DCDIR/spool/dcrapinf

The following table lists the files are deleted by using the dccspool command:

Table 13-4 Files deleted by using the dccspool command

File path	File type	Specification of -k option
		dump	all
Files in $DCDIR/spool/save	Core file, UAP trace, and OpenTP1 debug information	Y	Y
$DCDIR/spool/file-name#1	Shared memory dump file. The file contains the data stored in shared memory by OpenTP1.	Y	Y
$DCDIR/spool/dclckinf/ file-name#2	Deadlock information file and timeout information file. The files contain the resource wait status.	N	Y
$DCDIR/spool/dctrninf/ file-name#3	Incomplete-transaction information file. The file contains the information about incomplete transactions.	N	Y
$DCDIR/spool/dcrapinf/ RAP-processing-listener-name.msg $DCDIR/spool/dcrapinf/ RAP-processing-client-name.msg	Invalid message information file. The file contains the information about invalid messages.	N	Y

Legend:

Y: Deleted.

N: Not deleted.

#1: The files shmdump, shmdump[1-3], shmdump[1-3].Z, shmdump.XXX, shmdump.XXX.Z, shmdump.XXX[1-3], and shmdump.XXX[1-3].Z (where XXX is the resource manager name dam, tam, ist, or ism) are all deleted. Note that in Linux, the files will have the extension .gz instead of .Z.

#2: The file name is determined based on the time and date that a deadlock was detected. The length of the file name differs depending on whether the date is one digit or two digits.

#3: The file name format is rl + time-when-the-transaction-service-is-started (unique 8-digit hexadecimal number).

Message ID	Description	Output destination
KFCA01861-E	An error occurred during command processing.	Standard error output

• If the prc_coresave_path operand is specified in the process service definition and the core file is backed up, the dccspool command does not delete the backup core file.
• If a shared memory dump file is created in a directory other than $DCDIR/spool/save by using the usmdump command, the dccspool command does not delete the file.