stsls [{-n logical-file-name|-f physical-file-name|-a|-l|-p}]

The stsls command outputs the status of status files to the standard output in the online mode.

The command is effective only when the status service is running.

-n logical-file-name~<identifier, 1-8 characters>

Specifies the name of the logical file whose status is to be displayed.

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

Specifies the name of the physical file whose status is to be displayed, expressed as the full path name.

-a

Specifies that the status of all status files in use by the status service is to be displayed in summary format.

-l

Specifies that the status of all logical files being used by the status service is to be displayed.

-p

Specifies that the status of all physical files being used by the status service is to be displayed.

When all options are omitted, the status of all status files being used by the status service is displayed.

The following shows the output format when all options are omitted:

1. Physical file status display.

2. Logical file status display.

aaaaaaaa

Logical file name (up to 8 characters)

bbbbbbbb

Logical file status

ACTIVE: Current file

BLOCKADE: Error shutdown file

CLOSE: Invalid file

NONE: Status in which there is no file entity

STANDBY: Spare file

ccc

Record utilization factor for the file (percent, 3 digits)

dddddddd

Number of consecutive records available in the file (decimal)

eeeeeeee

Number of management records in the file (decimal)

f

Whether physical file is for system A or B:

A: A system

B: B system

gggggggg

Physical file status:

a: Current file

b: Error shutdown file

c: Closed file

i: Initialized status

l: Logical error

n: Status in which there is no file entity

o: Open file

p: Physical error

r: File status recovery by error information

s: Spare file

u: Used file

The display position of the letter indicating the status depends on the physical file's status.

hhhhhhhh

Record length (decimal)

iiiiiiii

Number of records (decimal)

jj...jj

Physical file name (up to 63 characters)

Message ID	Description	Output destination
KFCA01040-E	Error occurred in physical file.	Standard error output
KFCA01050-E	Error occurred during process-to-process communication.	Standard output
KFCA01070-E	Error occurred during stsls command processing.	Standard error output
KFCA01085-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

The status of a status file is managed only while the status service is running. If the stsinit or stsrm command is executed for any of the following closed files during status service operation, the file status to be displayed by the stsls command will not change:

• CLOSE
• NONE
• BLOCKADE

If the stsinit or stsrm command, the stsopen command, and the stsls command are executed in this order, the current file status is displayed.