The pdclose command closes specified RDAREAs. RDAREAs that have been shut down by the pdhold command and RDAREAs in error shutdown status can be specified.
(2) Executor
HiRDB administrator
(3) Format
.pdclose -r {RDAREA-name[,RDAREA-name]...|ALL}
(4) Options
(a) -r {RDAREA-name[,RDAREA-name]...|ALL}
-r RDAREA-name ~<identifier> ((1-30))
Specifies the name of an RDAREA to be closed.
ALL
Specifies that all RDAREAs except the master directory RDAREA are to be closed.
You cannot close an RDAREA that is in reference-possible backup hold (update WAIT mode) or updatable backup-hold status, nor can you close a master directory RDAREA.
If you specify a user RDAREA or user LOB RDAREA, make sure that the corresponding data dictionary RDAREA is in one of the following statuses:
Open and shutdown release status
Open and shutdown status placed by the pdhold command
When you specify both data dictionary and user RDAREAs or both data dictionary and user LOB RDAREAs, be sure to specify the data dictionary RDAREAs last.
(5) Rules
The pdclose command can be executed only while HiRDB is active.
The pdclose command must be executed at the server machine containing the single server or the server machine where the system manager is located.
The pdclose command locks the specified RDAREAs in the EX mode. If another transaction is accessing a specified RDAREA, the pdclose command will go onto wait status until the transaction terminates.
If the pdclose command is executed on a shared RDAREA, all back-end servers are locked. If there can be multiple concurrent accesses to the corresponding RDAREA, global deadlock may occur, resulting in a timeout. If global deadlock has occurred, re-execute the pdclose command.
If the pdclose command is executed in database asynchronous status or RDAREA error status, the command writes data from the in-memory data buffer to disk and synchronizes the in-memory data buffer and the RDAREA (resulting in database synchronous status).
(6) Notes
The result of the pdclose command can be checked by the pddbls command.
The following shows the pdclose command's return codes: 0: Normal termination 4: Warning termination (some RDAREA processing terminated with an error) 8: Abnormal termination 12: Abnormal termination (an event occurred that prevented output of an error message) If the error code is 12, check the error message in the event log at the host where the single server or dictionary server is located, eliminate the cause of the error, and then re-execute the command. If no error message has been output to the event log, contact the customer engineer.