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.

Any user (with or without privileges)

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

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

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.

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

The items are separated by at least one single-byte space.

(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

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

pp...p:

ID of the process that is locking the file. In AIX and HP-UX (IPF), this process ID is up to 10 right-aligned decimal digits. In all other OSs, this process ID is up to 5 right-aligned decimal digits if the value is 99999 or less, and up to 10 left-aligned decimal digits if the value is 100000 or more.

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 a hyphen (-).

In any OS other than AIX or HP-UX (IPF), if the value is 100000 or more, the items that follow L (lock status identification flag) are shifted to the right.

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

Output example

For UNIX editions other than AIX and HP-UX (IPF), this example includes process IDs that are 100000 or more:

MODE UID GID PID L TIME FILE rwrw-- USERID GRPID ----- - 19:32 Dec 26 2013 h001 rwrw-- USERID GRPID 38095 S 19:32 Dec 26 2013 h002 ... Process ID is 99999 or less rwrw-- USERID GRPID 108221 - 19:44 Dec 26 2013 h003 ... Process ID is 100000 or more rwrw-- USERID GRPID 8101 S 19:44 Dec 26 2013 h004 ... Process ID is 99999 or less

(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

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.