pdls [-d sts] (Display status file status)

Function

Displays the status of status files.

Format

HiRDB/Single Server
HiRDB/Parallel Server

Options

For unit status file status display, specifies the identifier of the unit or the name of the host corresponding to the unit status file. This option can be omitted for a HiRDB/Single Server because the host and unit are fixed.

-x host-name[Figure]<identifier> ((1-32))
Specifies the name of the host corresponding to the unit status file.
-u unit-identifier[Figure]<identifier> ((4 characters))
Specifies the identifier of the unit corresponding to the unit status file.

Specifies the name of the server corresponding to the status files for the server whose status is to be displayed.

Specifies how the status of the status files is to be displayed. When this option is omitted, the command displays the status of all status files being used by the specified unit or server.

-n logical-filename[Figure]<identifier> ((1-8))
If the status of the status files for a specific logical file is to be displayed, specifies the name of the logical file.
-f physical-filename[Figure]<path name> ((up to 167 characters))
If the status of the status files for a specific physical file is to be displayed, specifies the absolute path name of the physical file. The physical file name must be specified in the format HiRDB-file-system-area-name/HiRDB-filename.
-a
Specifies that a summary of the status of all status files being used by the unit or server is to be displayed.
-l
Specifies that the status of each logical file being used by the unit or server is to be displayed.
-p
Specifies that the status of each physical file being used by the unit or server is to be displayed.

Notes

  1. Return code 0 for the pdls -d sts command indicates normal termination, and return code 8 indicates abnormal termination.
  2. Executing the pdstsinit or pdstsrm command for a status file whose logical file status is CLOSE, NONE, or BLOCKADE during HiRDB operation does not change the status information displayed by the pdls command. In this case, the current status of the status file can be displayed by executing the pdstsopen command prior to the pdls command.
  3. If you use Real Time SAN Replication based on the log-only synchronous method, the status file to be displayed depends on the site where the command is executed.
    • At the transaction execution site
      The status file for transaction processing is displayed.
    • At the log application site
      The status file for log application processing is displayed.

Output format

HOSTNAME : aa...a(bbccdd)
 Logical file L_Status Factor Available Manage   ...........2
 ee...e         ff...f      ggg    hh...h    ii...i      ...........2
Sy  P_status R_length R_count P_name   .....................1,2
 j   kk...k    ll...l      mm...m  nn...n    .....................1,2
 j   kk...k    ll...l      mm...m  nn...n    .....................1,2

Explanation

1 displays the status of physical files, and 2 displays the status of a logical file.

aa...a
Host name (up to 32 characters).
bbccdd
Time of pdls command execution (hour:minute:second).
ee...e
Name of logical file (up to 8 characters).
ff...f
Status of logical file (up to 8 characters):
ACTIVE
Current file
BLOCKADE
Error shutdown file
CLOSE
Reservation file
NONE
No physical file corresponds to the logical file
STANDBY
Reserve file
ggg
Record utilization in the file (%).
hh...h
Number of available consecutive records in the file (8 decimal digits).
ii...i
Number of management records in the file (8 decimal digits).
j
Whether the physical file is A or B:
A
A
B
B
kk...k
Displays a maximum of 11 characters denoting physical file status information; if fewer than 11 characters are displayed, the displayed characters are right-justified (up to 11 characters):
a
Current file
b
Error shutdown file
c
Closed file
i
Initialized status
l
Logical error
n
No physical file corresponds to the logical file
o
Open file
p
Physical error
r
Recovered from an error
s
Reserve file
u
Used file
ll...l
Record length (8 decimal digits).
mm...m
Number of records (8 decimal digits).
nn...n
Name of physical file (up to 63 characters).