stsfills -f physical-file-name [-cx]

The stsfills command outputs the contents of a status file to the standard output in the offline mode.

-f physical-file-name~<path name>

Specifies the name of a physical file, expressed as the full path name.

-c

Specifies that the status file is to be checked. The following types of information are checked:

• Record (beginning or ending) integrity check number for record damage;
• File management information during stsinit command execution for the record length and number of records
• Status management information for completion of file update processing
• Status file management information for the number of records and the record type

If the check reveals an inconsistency, the contents of the specified status file are displayed, and an error message is output.

When this option is omitted, the status file is not checked.

-x

Specifies that the status file is to be opened in the lock mode. If the stsfills command is lock at the time the status service is started, OpenTP1 may terminate abnormally with a lock error.

When this option is omitted, the status file is not opened in the lock mode. If the specified status file is being used by OpenTP1, the correct status may not be displayed.

aa...aa

Name of the physical file (up to 63 characters)

bb...bb

Initialization date and time (in the format year/month/day hour: minutes: seconds). The last two digits of the year are displayed for the year.

cc...cc

Current file selection time (in the format year/month/day hour: minutes: seconds). The last two digits of the year are displayed for the year.

ddddd

Record length (decimal)

ee...ee

Number of records (decimal)

fff

Record utilization factor for the file

gg...gg

Number of consecutive records available in the file (decimal)

hh...hh

Number of management records in the file (decimal)

Note

If an error occurs in the file or the file has been damaged, the displayed information may not be correct.

Message ID	Description	Output destination
KFCA01040-E	Error occurred in physical file.	Standard error output
KFCA01070-E	Error occurred during stsfills command processing.	Standard error output
KFCA01088-I	Help message	Standard output, standard error output
KFCA01091-E	Memory is inadequate.	Standard error output
KFCA01099-E	Error occurred during OpenTP1 function call.	Standard error output