pdfstatfs (Display status of HiRDB file system area)

Function

The pdfstatfs command displays the status of a specified HiRDB file system area.

Executor

Any user (with or without privileges)

Format

pdfstatfs [-{c|d}] [{-S|-x[-y]}] [-b] HiRDB-file-system-area-name

Options

c
Specifies that the maximum available area for allocation in the HiRDB file system area is to be set to 0. This is effective when the usage purpose of the HiRDB file system area is WORK and UTL.
d
Specifies that the maximum available area for allocation in the HiRDB file system area is to be displayed.

Indicates the status of available free areas in the HiRDB file system area.

Specifies that the information is to be displayed in DAT format.

When the -x option is specified, specifies that a header is to be displayed.

Specifies that the sector length of the HiRDB file system area is to be displayed.

Command arguments

Specifies the name of the HiRDB file system area whose status is to be displayed.

Rules

  1. The pdfstatfs can be executed at any time, whether or not HiRDB is active.
  2. The pdfstatfs command must be executed separately for each server machine containing the HiRDB file system area.
  3. If you are executing the command on an 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 pdfstatfs command indicates normal termination, and return code -1 indicates abnormal termination.
  2. When the maximum available area for allocation is to be displayed by specifying the -d option after this value has been set to 0 with the -c option, the maximum available area of the HiRDB file system area used since the -c option was set can be acquired.
  3. Displaying the maximum available area of the HiRDB file system area between the time the -c option is specified and the -d option is specified is possible only when the usage purpose of the HiRDB file system area is WORK and UTL. When the usage purpose is SYS, DB, or SVR, the maximum available area cannot be set to 0 with the -c option; thus, the maximum available area that is displayed is that accumulated from the time the pdfmkfs command was executed.

Output format

user area capacity         aa...a[kB]
remain user area capacity  bb...b[kB]
[peak capacity              mm...m[kB]]
available file size        cc...c[kB]
available file count       dd...d
current file count         ee...e
remain file count          ff...f
free area count            gg...g
available expand count     hh...h
current expand count       ii...i
[sector size                qq...q[Byte]]
initialize area kind       jj...j
initialize user id         kk...k
initialize time            ll...l

[***** HiRDB file system area space information *****]
[offset[kB]     size[kB]  used/unused]
[   nn...n      oo...o    pp...p]

Explanation
aa...a
Size (in KB) in the HiRDB file system area of the user area allocated to the user (up to 10 decimal digits).
bb...b
Size (in KB) in the user area of the unused space (space not allocated to HiRDB files) (up to 10 decimal digits).
cc...c
Size (in KB) of the largest space that can be allocated to a single file (up to 10 decimal digits).
dd...d
Maximum number of files that can be created, as specified with the -l option of the pdfmkfs command (up to 4 decimal digits).
ee...e
Number of HiRDB files that have already been created (up to 4 decimal digits).
ff...f
Number of HiRDB files that can still be created (maximum number of creatable files - number of already created files) (up to 4 decimal digits).
gg...g
Total number of noncontiguous free areas (up to 5 decimal digits).
hh...h
Maximum number of secondary allocations available to the HiRDB file system area (up to 5 decimal digits).
ii...i
Total number of secondary allocations that have been executed for the HiRDB file system area (up to 5 decimal digits).
jj...j
HiRDB file system area's usage purpose, as specified in the -k option of the pdfmkfs command (up to 9 characters).
If the usage purpose is SDB, DB is displayed.
kk...k
Login name of the user who initialized the HiRDB file system area (up to 32 characters).
ll...l
Date and time the HiRDB file system area was initialized (24 characters).
This information is displayed in the format day month date hour:minute:second year.
The following output example is for 2005-01-07 (Friday) at 09:05:08:
initialize time Fri Jan 07 09:05:08 2005
mm...m
User maximum available space at the current time (up to 10 decimal digits); displayed only when the -d option is specified.
nn...n
The leading offset for an area being used or an area not being used in the HiRDB file system area. This is displayed only when the -S option is specified.
oo...o
The size of an area being used or an area not being used in the HiRDB file system area. This is displayed only when the -S option is specified.
pp...p
Indicates whether an area is being used.
used
Being used.
unused
Not being used.
This is displayed only when the -S option is specified.
qq...q
Sector length of the HiRDB file system area (1 to 4 decimal digits).
This is 512 for a regular file and the sector length specified in the -s option of the pdfmkfs command for a character special file (1,024 when the option is omitted).
Note
[CR] indicates a linefeed.
Rules for output in DAT format
  1. The elements are separated by the comma (,), and information is output as a single line of text ending with a carriage return.
  2. A character element is enclosed in double quotation marks (").
  3. The sector length and the current maximum amount of usage by user are displayed only when the appropriate combination of information acquisition options is specified. If an information acquisition option is not specified, the command displays a blank or only "" without displaying the corresponding item.