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

Any user (with or without privileges)

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

• -{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.

• -S

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

• -x

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

• -y

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

• -b

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

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

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.

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 that accumulated from the time the pdfmkfs command was executed.
4. 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.

 
 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.

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 (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 the sector length specified in the -s option of the pdfmkfs command (1,024 when the option is omitted).

• DAT output format (when -x -y is 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"[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"[CR]

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.