The pddbls command displays the status of RDAREAs.

HiRDB administrator

HiRDB/Single Server

pddbls {-r RDAREA-name [, RDAREA-name]... | -r ALL}
          [-{l | a}] [-b][-x[-y]]

HiRDB/Parallel Server

pddbls {-r RDAREA-name [, RDAREA-name]... | -r ALL
          | -s server-name [, server-name]...}
          [-{l | a}] [-b][-m][-x[-y]]

• -r RDAREA-name <identifier> ((1-30))

Specifies the name of an RDAREA whose status is to be displayed. 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.

The same RDAREA name should not be specified more than once; if specified, a duplicate RDAREA name is ignored. A maximum of 128 RDAREA names can be specified. If more than 128 RDAREA names are specified, the excess names are ignored.

If an RDAREA name is enclosed in \", it is treated as being case sensitive; otherwise, it is treated as all uppercase letters. If an RDAREA name contains a blank, the entire name must be enclosed in \".

• -r ALL

Specifies that information about all RDAREAs is to be displayed.

• -s server-name <identifier> ((1-8))

Specifies the name of a server when the status of all of that server's RDAREAs is to be displayed. The command displays information about all RDAREAs for the specified server.

A maximum of 128 server names can be specified. If more than 128 server names are specified, the excess names are ignored.

• -{l | a}

-l

Specifies that only the RDAREA status is to be displayed.

-a

Specifies that all information about RDAREAs other than shared RDAREAs is to be displayed.

When the -m option is specified, the command displays shared RDAREA information for all servers. Note that the segment usage information in a shared RDAREA is displayed only for an updatable back-end server.

• -b

Specifies that information is to be displayed only for RDAREAs in shutdown status. When a server name is specified, the command displays information about the RDAREAs in shutdown status for the specified server only. When this option is omitted, the command displays information about all specified RDAREAs.

• -x

Specifies that the information is to be displayed in DAT format.

• -y

When the -x option is specified, specifies that a header is to be displayed.

• -m

Specifies that shared RDAREA information is to be displayed.

When a shared RDAREA is specified in the -r option and the -m option is also specified, the command displays the applicable RDAREA and shared RDAREA information for all back-end servers.

1. The pddbls command can be executed only while HiRDB is active.
2. The pddbls command must be executed at the server machine containing the single server or the server machine where the system manager is located.
3. When a user RDAREA or a 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

1. The following shows the pddbls command's return codes:
   0: Normal termination
   4: Warning termination
   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.
   

 
 STATE OF RDAREA
 RDAREA ID     STATUS  [SERVER] TYPE
               OPNMODE [SHARED]
 aa...a bb...b cc...c  dd...d  eeee
               jj...j  kkk
  [SEGMENT   ff...f/gg...g]
  [UNABLE TO DISPLAY CODE=hh]
     :    :   :
  [NOT FOUND ii...i=aa...a]
  [RDAREA NOT FOUND]
 

Explanation

aa...a

RDAREA name (up to 30 characters).

bb...b

RDAREA number (11 decimal digits).

cc...c

Status of RDAREA (up to 17 characters). The following statuses are displayed for RDAREAs:

RDAREA status	Explanation	Segment information
CLOSE	Closed	DS
CLOSE HOLD	Closed, error shutdown
CLOSE HOLD (INQ)	Closed, reference-possible command shutdown
CLOSE HOLD (CMD)	Closed, command shutdown
CLOSE HOLD (BU)	Closed, updatable backup-hold	D
CLOSE HOLD (BU I)	Closed, reference-possible backup-hold	D
CLOSE HOLD (BU W)	Closed, updatable backup-hold (WAIT mode)	D
CLOSE HOLD (BU IW)	Closed, reference-possible backup-hold (update WAIT mode)	D
CLOSE ACCEPT-HOLD	Closed, pdhold command-accepted
HOLD	Error shutdown
HOLD(INQ)	Reference-possible command shutdown	D1
HOLD(CMD)	Command shutdown	D1
HOLD (BU)	Updatable backup-hold	D
HOLD (BU I)	Reference-possible backup-hold	D
HOLD (BU W)	Updatable backup-hold (WAIT mode)	D
HOLD (BU IW)	Reference-possible backup-hold (update WAIT mode)	D
ACCEPT-HOLD	pdhold command-accepted	D1
OPEN	Open	D

D: Displayed

DS: Displayed when RDAREA open timing is set to DEFER or SCHEDULE.

: Not displayed.

¹ Segment information is not displayed during close processing.

dd...d

Server name for HiRDB/Parallel Server (up to 8 characters).

eeee

Type of RDAREA:

MAST

Master directory RDAREA

DDIR

Data directory RDAREA

DDIC

Data dictionary RDAREA

DLOB

Data dictionary LOB RDAREA

USER

User RDAREA

ULOB

User LOB RDAREA

LIST

List RDAREA

RGST

Registry RDAREA

RLOB

Registry LOB RDAREA

ff...f

Number of unused segments in RDAREA (11 decimal digits).

For a LOB RDAREA, the next segment is included in the number of unused segments, but it cannot be reused until the synchronization point is reached. Once the synchronization point is reached, it can be reused.

• Segments that stored data of the BLOB type that has been deleted by a DELETE statement.
• For BLOB-type data updated by the UPDATE statement, the segments that stored the data before the updating was performed.
• Segments that stored BLOB-type dictionary data deleted by a change procedure, such as DROP PROCEDURE or DROP SCHEMA.

gg...g

Total number of segments in RDAREA (11 decimal digits).

hh

Return code. The following return codes are displayed:

Return code	Explanation	Required action
01	RDAREA is in a status such that no information can be displayed (see cc...c for the RDAREA status).	Not applicable.
02	Information on an RDAREA cannot be displayed because the RDAREA is being accessed in the lock mode by another transaction.	Re-execute the command after the transaction that is accessing the RDAREA in the lock mode has terminated.
03	No global buffer was allocated to the RDAREA.	Allocate a global buffer, then re-execute the command.
04	HiRDB file access error occurred.	Take action appropriate to the corresponding error message.
05	Lock error occurred.
101	Invalid RDAREA type was specified.	Check for a specification error; if there was no error, contact maintenance personnel.

ii...i

For an RDAREA, RDAREA is displayed; for a server, SERVER is displayed (six characters).

jj...j

User-specified open timing for the HiRDB file system area. This is the HiRDB file system area's open timing specification (INITIAL, DEFER, or SCHEDULE) that was specified in the system common definition or with the database initialization utility or database structure modification utility.

kkk

Shared RDAREA information (applicable when the -m option is specified):

SUP: Shared RDAREA (updatable back-end server)

SRD: Shared RDAREA (reference-only back-end server)

NON: Non-shared RDAREA

When the -m option is omitted or for a HiRDB/Single Server, neither a header nor shared RDAREA information is displayed.

Notes

• If a specified RDAREA is not found, the message NOT FOUND RDAREA= is displayed.
• If a specified server is not found, the message NOT FOUND SERVER= is displayed.
• When the -b option is specified but there is no RDAREA in shutdown status, or when there are no RDAREAs for a server specified in the -s option, the message RDAREA NOT FOUND is displayed.
• When the -a option is specified but the information cannot be displayed, the message UNABLE TO DISPLAY CODE=hh is displayed.

• DAT output format (when -x and -y options are specified)
  

  "RDAREA","ID","STATUS","UNUSED_SEGMENT","TOTAL_SEGMENT","SERVER","TYPE","OPNMODE","ORIGINAL-RDAREA", "ORIGINAL-ID","GENERATION-NUMBER","REPLICA-STATUS","REPLICA-COUNTER","SHARED"[CR] "aa...a",bb...b,"cc...c",ff...f,gg...g,"dd...d","eeee","jj...j","", ,,"",,"kkk"[CR]

Note

[CR] indicates a linefeed.

Rules for output in DAT format

1. The elements are separated by the comma (,), and information about one RDAREA is displayed on each line.
2. A character element is enclosed in double quotation marks (").
3. If information cannot be acquired for a reason regarding, for example, the options that are specified or the server type, the command displays only a blank or "".
4. If the -a option was specified but segment information cannot be acquired due to its status, the command displays -1 as the number of unused segments in the RDAREA and the return code for the total number of segments in the RDAREA.
5. When information is displayed in DAT format, the following error messages are not output:
   [NOT FOUND ii...i=aa...a]
   [RDAREA NOT FOUND]