pdopen (Open RDAREAs)

Function

The pdopen command opens specified RDAREAs.

Executor

HiRDB administrator

Format

pdopen -r {RDAREA-name[,RDAREA-name]...|ALL} [-q generation-number]

Options

-r RDAREA-name[Figure]<identifier> ((1-30))
Specifies the name of an RDAREA that is to be opened. You can also use batch specification of RDAREA names. For details about batch specification of RDAREA names, see 1.5.2 Batch specification of RDAREA names in operation commands.
ALL
Specifies that all RDAREAs are to be opened, except for the master directory RDAREA. When the -q option is specified, the command opens the RDAREAs of the same generation.
Rules
  1. An already open RDAREA cannot be opened again.
  2. The same RDAREA name should not be specified more than once; if specified, a duplicate RDAREA name is ignored.
  3. A maximum of 128 RDAREA names can be specified. If more than 128 RDAREA names are specified, the excess names are ignored.
  4. If an RDAREA name is enclosed in double quotation marks ("), the system treats it as being case sensitive; otherwise, the system treats it as all uppercase letters. If an RDAREA name contains a space, enclose the entire name in double quotation marks ("). If the Bourne shell (sh), C shell (csh), or Korn shell (ksh) is used, it is also necessary to enclose the entire set of RDAREA names in single quotation marks (').
  5. When a user RDAREA or user LOB RDAREA is specified, the corresponding data dictionary RDAREA must be in one of the following statuses:
    • Open and shutdown release status
    • Open and shutdown status placed by the pdhold command
  6. If you specify data dictionary RDAREAs, user RDAREAs, and user LOB RDAREAs at the same time, make sure that the data dictionary RDAREA names are specified last.
  7. If you are using the inner replica facility, you can also specify original and replica RDAREA names. In this case, you can specify only user RDAREAs and user LOB RDAREAs.

Specifies the generation number of a replica RDAREA.

If you specify this option, make sure that the original RDAREA name is specified in the -r option. An error results if you specify an original RDAREA whose replicas have all been deleted or a normal RDAREA (one without a replica RDAREA).

Rules

  1. The pdopen command can be executed only while HiRDB is active.
  2. The pdopen command must be executed at the server machine containing the single server or the server machine where the system manager is located.
  3. The pdopen command locks each specified RDAREA in the EX mode. If another transaction is accessing a specified RDAREA, the pdopen command goes onto wait status until the other transaction terminates.
  4. If the pdopen 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 pdopen command.

Notes

  1. The result of the pdopen command can be checked by the pddbls command.
  2. The following shows the pdopen 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 syslogfile 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 syslogfile, contact the customer engineer.