pdfls (Display HiRDB file system area information)

Function

The pdfls command displays information about HiRDB files in a HiRDB file system area. If only the name of a HiRDB file system area is specified in the command argument, information about all HiRDB files in the specified HiRDB file system area is displayed. If a HiRDB file name is also specified, information about only the specified HiRDB file is displayed.

Executor

Any user (with or without privileges)

Format

pdfls [-[H][-L| -S][-{t|u}]] HiRDB-file-system-area-name
                          [/HiRDB-filename]
     | [-x] HiRDB-file-system-area-name[/HiRDB-filename]}

Options

Specifies that the display is to be with headers in alphabetical order of the HiRDB file names.

Specifies that the HiRDB files are to be displayed in alphabetical order of the HiRDB file names with each file's lock status.

Specifies that the HiRDB file partition storage status (extent status) is to be displayed in alphabetical order of the HiRDB file names.

-t
Specifies that the contents of the HiRDB file system area are to be displayed in the order of the update close date and time, beginning with the most recent one. The update close date and time refer to the most recent date and time the file was written since it was opened. If no write operation has occurred on the HiRDB file, the system treats the file creation date and time as the update close date and time. For a HiRDB file constituting an RDAREA, the actual update close date and time may not be used.
-u
Specifies that the contents of the HiRDB file system area are to be displayed in the order of the close date and time, beginning with the most recent one. The close date and time refer to the most recent date and time the file was read since it was opened. If no read operation has occurred on the file, the system treats the file creation date and time as the close date and time. For a HiRDB file constituting an RDAREA, the actual close date and time may not be used.
If the -H or -L option is specified together with the -t or-u option, the -t or-u option is effective.

Specifies that only the HiRDB file names are to be displayed (listed horizontally in alphabetical order). When this option is omitted, the HiRDB file names are listed vertically.

Command arguments

HiRDB-file-system-area-name[Figure]<pathname> ((up to 165 characters))
Specifies the name of the HiRDB file system area whose files are to be displayed.
HiRDB-filename[Figure]<HiRDB filename>
Specifies the name of the HiRDB file whose information is to be displayed.

Rules

  1. The pdfls command can be executed at any time, whether or not HiRDB is active.
  2. The pdfls command must be executed separately for each server machine containing the HiRDB file system.
  3. If you are executing the command on a HiRDB file system area that is used for shared RDAREAs, execute it from the server machine where the updatable back-end server is located.

Notes

  1. Return code 0 for the pdfls command indicates normal termination, and return code -1 indicates abnormal termination.

Output format

-H option specified

MODE     UID   GID   RSIZE   RNUM   TIME   FILE
aabbcc    dd...d  ee...e  ffff      gg...g   hh...h   ii...i

Explanation
aa
Owner's access privileges:
rw
Read and write
r-
Read
-w
Write
--
None
bb
Group's access privileges:
rw
Read and write
r-
Read
-w
Write
--
None
cc
Other users' access privileges:
rw
Read and write
r-
Read
-w
Write
--
None
dd...d
Owner's name (up to 9 characters).
ee...e
Owner's group name (up to 9 characters).
ffff
Record length (4 decimal digits).
gg...g
Number of records (8 decimal digits).
hh...h
Update close date and time.
This information is displayed in the format hour:minute month date year.
The following output example is for 2005-01-07 (Friday) at 09:05:
09:05 Jan 07 2005
ii...i
HiRDB file name (up to 30 characters).

-H and -L options specified

MODE   UID    GID    PID  L TIME   FILE
aabbcc  dd...d   ee...e   pppp q hh...h   ii...i

Explanation
aa
Owner's access privileges:
rw
Read and write
r-
Read
-w
Write
--
None
bb
Group's access privileges:
rw
Read and write
r-
Read
-w
Write
--
None
cc
Other users' access privileges:
rw
Read and write
r-
Read
-w
Write
--
None
dd...d
Owner's name (up to 9 characters).
ee...e
Owner's group name (up to 9 characters).
pppp
ID of process locking the file (up to 10 decimal digits in AIX 5L and up to 5 decimal digits in other OSs).
If the ID of the process locking the file is unknown, the command displays *. If there is no process locking the file, the command displays -.
q
Lock status identification flag:
E
Exclusive lock
S
Shared lock
*
Lock status unknown
-
Not locked
hh...h
Update close date and time.
This information is displayed in the format hour:minute month date year.
The following output example is for 2005-01-07 (Friday) at 09:05:
09:05 Jan 07 2005
ii...i
HiRDB file name (up to 30 characters).

-H and -S options specified

MODE    UID     GID     RSIZE  RNUM    TIME    FILE
aabbcc   dd...d    ee...e    ffff     gg...g    hh...h    ii...i
               extent size    jj...j

Explanation
aa
Owner's access privileges:
r
Read
w
Write
-
Neither read nor write
bb
Group's access privileges:
r
Read
w
Write
-
Neither read nor write
cc
Other users' access privileges:
r
Read
w
Write
-
Neither read nor write
dd...d
Owner's name (up to 9 characters)
ee...e
Owner's group name (up to 9 characters)
ffff
Record length (4 decimal digits)
gg...g
Number of records (8 decimal digits)
hh...h
Update close date and time
This information is displayed in the format hour:minute month date year.
The following output example is for 2005-01-07 (Friday) at 09:05:
09:05 Jan 07 2005
ii...i
HiRDB file name
jj...j
Number of records per HiRDB file extension. If there is more than one HiRDB file extent, this information is displayed for each extension.