OpenTP1 Version 7 Operation
Format
jnlopnfg -j sys|cpd|jar [-s server-name] [-r resource-group-name] -g file-group-name [-e element-file-name] [-a] [-b] |
Function
The jnlopnfg command opens a closed physical file that is a constituent of a specified file group so that the files can be used in the online mode.
The jnlopnfg can be entered only when OpenTP1 and the journal service are both operating.
Options
-j sys|cpd|jar
Specifies the type of journal files to be opened:
sys: System journal files
cpd: Checkpoint dump files
jar: Archive journal file
-s server-name~<identifier, 1-8 characters>
Specifies the name of a server that is to be subject to this processing when checkpoint dump files are to be opened.
When this option is omitted, the first (among all servers) checkpoint dump files with the matching file group name are opened.
If sys is specified for -j option, specification of the -s option is ignored.
-r resource-group-name~<1-8 character identifier>
Specifies the name of the target resource group. If jar is specified in the -j option, the name of the resource group in the file to be opened must be specified. It must be the definition file name specified in the archive journal service definition specified in the definition command jnldfsv -a of the global archive journal service definition.
When this option is omitted, the name of an online archive journal file defined at the beginning of the definition command jnldfsv -a of the archive journal service definition is assumed.
If other than jar is specified in the -j option, the specification of the -r option is discarded.
-g file-group-name~<identifier, 1-8 characters>
Specifies the file group name of the journal files to be opened.
-e element-file-name
Specifies the name of an element file in the journal file group to be opened.
-a
Specifies that physical files in system A are to be opened.
-b
Specifies that physical files in system B are to be opened.
If this option is specified when dual files are not being used, a command error occurs.
When the -a and -b options are both omitted, or when cpd is specified in the -j option, the command performs processing as follows:
If all physical files subject to open processing are already open, a warning message (KFCA01283-W or KFCA02167-W) is issued, although no command error occurs (command termination code: 0).
Output messages
Message ID | Description | Output destination |
---|---|---|
KFCA01141-E | The command cannot be executed because OpenTP1 is running in journal fileless mode. | Standard error output |
KFCA01215-I | File group has been opened successfully. | Message log file |
KFCA01280-E | jnlopnfg command processing failed. | Standard error output |
KFCA01281-E | jnlopnfg command input format is invalid. | Standard error output |
KFCA01283-W | Insignificant error occurred during jnlopnfg command execution. | Standard error output |
KFCA01285-E | Swap processing is underway. | Standard error output |
KFCA01294-I | Help message | Standard output, standard error output |
KFCA02128-E | Specified server name is invalid. | Standard error output |
KFCA02129-E | Specified file group name is invalid. | Standard error output |
KFCA02130-E | -s option specification is invalid. | Standard error output |
KFCA02131-E | -g option specification is invalid. | Standard error output |
KFCA02132-E | jnlopnfg command processing was cancelled due to an error. | Standard error output |
KFCA02167-W | Specified file group is already open. | Standard error output |
KFCA02169-E | File open processing failed. | Standard error output |
Notes
The jnlopnfg command may result in an error if it is entered during swap processing or during the processing of another operation command.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.