OpenTP1 Version 7 Operation
jnlunlfg (Unload journal files)
Format
jnlunlfg -j sys|jar [[-f]|[-t[start-time][,end-time]]] [-r resource-group-name] [-R run-ID] [-g file-group-name] [-o output-destination-file-name] [-d service-definition-name] [-n] |
Function
The jnlunlfg command unloads a specified file group into a specified output destination file or the standard output and places the file group on unloaded status.
When the KFCA01222-I message is output, the user must execute the jnlunlfg command to unload the file group.
The current file group or an unloaded file group cannot be unloaded unless the -f option is specified.
When unloading the archive journal, the unload information is output after the unloading is completed.
Options
-j sys|jar
Unloads a file group.
-f
Unloads a file group without checking its status. Accordingly, the current file group or an unloaded file group can be unloaded, however, its status does not change.
When a file group on swappable status (that is, the file has been unloaded and is on overwritable status) is unloaded with the -f option specified, it may become the current file group during unloading. If it is unloaded before collecting journals in the online mode, an error is detected and a command error occurs. The user must close an unloaded file group with the jnlclsfg command before unloading it with the -f option specified.
The journal file unloaded in the running OpenTP1 system is not inherited by the standby OpenTP1 system. The standby system can unload the journal file by executing the jnlunlfg command with its -f option specified. Note that the jnlunlfg command must be executed only when the unloaded journal is not used by another OpenTP1.
-t[start-time][,end-time]
Specifies the period of time for which the journal block is to be unloaded.
For start-time, specify a time and date to start unloading the target journal block. For end-time, specify a time and date to end unloading the target journal block.
For start-time and end-time, you can specify a time and date after 00:00:00 on January 1, 1970.
You must specify either start-time or end-time, or both. If you omit start-time, unloading is performed from the beginning of the file until the specified end time. If you omit end-time, unloading is performed starting from the specified start time until the end of the journal file.
Specify start-time and end-time in the hhmmss[MMDD[YYYY]] format.
-r resource-group-name~<1-8 character identifier>
Specifies the name of a resource group of the file to be unloaded.
If sys is specified in the -j option, the definition file name in the system journal service definition must be specified. If jar is specified, the name of the definition file in the archive journal service definition to be unloaded must be specified.
When this option is omitted, the system assumes the resource group name specified in the journal service definition of $DCCONFPATH/jnl if sys is specified in the -j option. With jar specified in the -j option, the system assumes the file name defined at the beginning of the definition command jnldfsv -a of the global archive journal service definition of $DCCONFPATH/jar.
-R run-ID
Specifies the run-ID of the journal file group to be unloaded. When this option is omitted, the specification of the -g option predominates.
-g file-group-name~<identifier, 1-8 characters>
Specifies the file group name of the journal files to be unloaded.
When this option is omitted, the oldest generation of the file groups waiting to be unloaded will be unloaded. The -f option cannot be specified.
The following shows the specification combinations with the -R option and the journal file group that will be unloaded.
Option | -R | ||
---|---|---|---|
Specified | Not specified | ||
-g | Specified | The file group specified by -g is unloaded. A command error occurs if the run ID specified by -R does not match that specified by -g. |
The file group specified by -g is unloaded. |
Not specified | Of the file groups with the run ID specified by -R, the file group of the oldest generation is unloaded. | Of the file groups with the latest run ID, the file group of the oldest generation is unloaded. |
-o output-destination-file-name~<path name>
Specifies the name of the output destination file.
When this option is omitted, output to the standard output is assumed.
-d service-definition-name~<path name> or <file name>
Specifies the name of the system journal service definition file that defines the file group to be unloaded, in one of the following formats:
If only the definition file name is specified, the directory containing the definition file must be set in $DCCONFPATH.
When this option is omitted, the specification of the -r option predominates.
-n
Specifies that unload wait status is to be maintained after unloading without changing the status of the file group.
This option enables the same generation to be unloaded repeatedly, thereby creating multiple unload files.
When the standby OpenTP1 system is operating under the system switchover facility, a file group can be unloaded with the jnlunlfg command with its -n option specified. The status of the unloaded file group remains unchanged. This requires the running OpenTP1 system to set the file group to unloaded status by executing the jnlchgfg command. Thus, the load of unloading on the running OpenTP1 system can be dispersed onto the standby OpenTP1 system.
Output format
The output format is as follows when the archive journal file is unloaded:
This information is displayed for each run ID in the file group.
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 |
Notes
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.