2.35 pdfstatfs (Display status of HiRDB file system area)

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 pdfstatfs command displays the status of a specified HiRDB file system area.

(2) Executor

Any user (with or without privileges)

(3) Format

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

(4) Options

(a) -{c|d}
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, UTL, and NUTL.
d
Specifies that the maximum available area for allocation in the HiRDB file system area is to be displayed.
(b) -S

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

(c) -x

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

(d) -y

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

(e) -b

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

(5) Command arguments

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

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

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

(7) 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, UTL, and NUTL. 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 accumulated from the time the pdfmkfs or pdfzeroinit command was executed.
  4. If you are using the HDP facility, do not specify the -c option. If the -c option is specified, used areas can no longer be initialized by the pdfzeroinit command.
  5. To use the OS's no-cache access method with the HiRDB file system area, you need to specify the pd_ntfs_cache_disable operand in the system definitions.

(8) Output format

(a) When the -x and -y options are omitted

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
area auto expand           rr...r

[***** 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 right-aligned decimal digits).
bb...b
Size (in KB) in the user area of the unused space (space not allocated to HiRDB files) (up to 10 right-aligned decimal digits).
cc...c
Maximum size (in KB) of one HiRDB file that can be allocated in a single extent (up to 10 right-aligned 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 right-aligned decimal digits).
ee...e
Number of HiRDB files that have already been created (up to 4 right-aligned decimal digits).
ff...f
Number of HiRDB files that can still be created (maximum number of creatable files less the number of files created already) (up to 4 right-aligned decimal digits).
gg...g
Total number of noncontiguous free areas (up to 5 right-aligned decimal digits).
hh...h
Maximum number of secondary allocations available to the HiRDB file system area, as specified with the -e option of the pdfmkfs command (up to 5 right-aligned decimal digits).
ii...i
Total number of secondary allocations that have been executed for the HiRDB file system area (up to 5 right-aligned 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 DB, availability of OS no-cache access is also displayed as follows:
DB: Usage purpose is DB and no-cache access is not available.
DB(NOLOB): Usage purpose is DB and no-cache access is available.
kk...k
Login name of the user who initialized the HiRDB file system area.
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's maximum available space at the current time (up to 10 right-aligned 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 (right-aligned). 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 (right-aligned). 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 (up to 4 right-aligned decimal digits).
This is the sector length specified in the -s option of the pdfmkfs command (1,024 when the option is omitted).
rr...r:
Whether the facility for automatic extension of the HiRDB file system area is applied:
Indicates whether the size of the HiRDB file system area is to be automatically expanded if there is no more free space in the HiRDB file system area when an RDAREA is automatically extended.
USE: Applied
NOUSE: Not applied
When USE is displayed, the values of user area capacity, remain user area capacity, peak capacity, and available file size change.
(b) DAT output format (when the -x and -y options are specified)

"USER_AREA_CAPACITY","REMAIN_USER_AREA_CAPACITY","PEAK_CAPACITY",
"AVAILABLE_FILE_SIZE","AVAILABLE_FILE_COUNT","CURRENT_FILE_COUNT",
"REMAIN_FILE_COUNT","FREE_AREA_COUNT","AVAILABLE_EXPAND_COUNT",
"CURRENT_EXPAND_COUNT","SECTOR_SIZE","INITIALIZE_AREA_KIND",
"INITIALIZE_USER_ID","INITILIZE_TIME","AREA_AUTO_EXPAND"[CR]
aa...a,bb...b,mm...m,
cc...c,dd...d,ee...e,
ff...f,gg...g,hh...h,
ii...i,qq...q,"jj...j",
"kk...kk","ll...ll","rr...rr"[CR]

Note
[CR] indicates a linefeed.
Rules for output in DAT format
  1. For the rules for output in DAT format, see 1.5.3 Rules for output of command execution results in DAT format.
  2. 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 null element without displaying the corresponding item.