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
<pathname> ((up to 165 characters)) - Specifies the name of the HiRDB file system area whose files are to be displayed.
- HiRDB-filename
<HiRDB filename> - Specifies the name of the HiRDB file whose information is to be displayed.
Rules
- The pdfls command can be executed at any time, whether or not HiRDB is active.
- The pdfls command must be executed separately for each server machine containing the HiRDB file system.
- 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
- 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.