stsopen (Open a status file)

Format

stsopen {-n logical-file-name|-f physical-file-name}

Function

The stsopen command opens a status file initialized by the stsinit command or a status file closed by the stsclose command.

This command can open only a status file specified in the status service definition, and the command is effective only when the status service is running.

If the current status file is a one-system operation file, executing the stsinit command to initialize the physical file in the shutdown-state system and then executing the stsopen command make it possible to recover the file as a current status file.

Options

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

Specifies the name of a logical file to be opened. The files in both the A and the B systems constituting the specified logical file are opened simultaneously.

This command argument can be specified in the following cases:

When a logical file name is specified, the user need not know the path name for the status file entity.

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

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

This command argument is specified to open a status file that was placed on shutdown status due to a status file error or to open a physical file that has been initialized by the stsinit command in order to increase its size.

Entering both stsopen -f A-system-physical-file-name and stsopen -f B-system-physical-file-name is the same as entering stsopen -n logical-file-name.

Output messages

Message IDDescriptionOutput destination
KFCA01008-EError occurred in status file.Standard error output
KFCA01040-EError occurred in physical file.Standard error output
KFCA01050-EError occurred during process-to-process communication.Standard error output
KFCA01070-EError occurred during stsopen command processing.Standard error output
KFCA01083-IHelp messageStandard output,
standard error output
KFCA01091-EMemory is inadequate.Standard error output
KFCA01099-EError occurred during OpenTP1 function call.Standard error output