OpenTP1 Version 7 Operation

[Contents][Index][Back][Next]

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