2.31 pdfls (Display HiRDB file system area information)

Organization of this section
(1) Function
(2) Executor
(3) Format
(4) Options
(5) Command arguments
(6) Rules
(7) Notes
(8) Output format

(1) 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.

(2) Executor

Any user (with or without privileges)

(3) Format

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

(4) Options

(a) -H

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

(b) -L

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

(c) -S

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

(d) -{t|u}
-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.
(e) -x

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.

(5) Command arguments

(a) HiRDB-file-system-area-name ~<pathname> ((up to 165 characters))

Specifies the name of the HiRDB file system area whose files are to be displayed.

(b) HiRDB-filename ~<HiRDB filename>

Specifies the name of the HiRDB file whose information is to be displayed.

(6) 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.

(7) Notes

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

(8) Output format

(a) -H option specified

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

Explanation
aabbcc: Information used by the system (always rwrw--)
dd...d
User name in the OS used in creating the HiRDB file
ee...e
Name in the OS of the group to which the user who created the HiRDB file belongs
Zero (0) always is displayed.
ff...f
Record length (5 decimal digits).
gg...g
Number of records (8 right-aligned 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).
(b) -H and -L options specified

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

Explanation
aabbcc: Information used by the system (always rwrw--)
dd...d
User name in the OS used in creating the HiRDB file
ee...e
Name in the OS of the group to which the user who created the HiRDB file belongs
Zero (0) always is displayed.
pp...p:
If there is a process locking the file, the command displays *; if there is no process locking the file, the command displays -.
q
Lock status identification flag:
E
Locked.
-
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).
(c) -H and -S options specified

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

Explanation
aabbcc: Information used by the system (always rwrw--)
dd...d
User name in the OS used in creating the HiRDB file
ee...e
Name in the OS of the group to which the user who created the HiRDB file belongs
Zero (0) always is displayed.
ff...f
Record length (5 decimal digits)
gg...g
Number of records (8 right-aligned 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.