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]

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.

-j sys|jar

Unloads a file group.

sys: System journal file

jar: Archive journal file

-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.

hh: Hour (00 hh 23)

You cannot omit the specification.

mm: Minutes (00 mm 59)

You cannot omit the specification.

ss: Seconds (00 ss 59)

You cannot omit the specification.

MM: Month (01 MM 12)

You can omit the specification.^#

DD: Day (01 DD 31)

You can omit the specification.^#

YYYY: Year (4-digit year from 1970)

You can omit the specification.^#

#: The specifiable period depends on the time zone set for the system. For example, when JST-9 is set for the TZ environment variable, the earliest time you can specify starts at 9:00:00 on January 1, 1970. If the year is omitted from the begin or end time, the specified month, day, and time of the current year are assumed. If the year, month, and day are omitted, the current year, month, and day, and the specified time are assumed. You cannot omit only the month and day, or the month or the day. Doing so causes an option error. If you want to omit the month or the day, then omit the year, the month, and the day (all three).

If you omit the -t option, all the information in the specified file is unloaded.

When you specify the -t option, you cannot specify the -f option. Note that the status of the file group does not change when you specify the -t option for unloading.

When you specify the -t option and the -R option, and omit the -g option, the range for unloading is the one specified by using the -t option in the file group of the oldest generation among the file groups of the run ID specified by using the -R option.

When you specify the -t option, and omit the -R and the -g options, the range for unloading is the one specified by using the -t option in the file group of the oldest generation among the file groups of the latest run ID.

-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:

• Full path name beginning with / (root)
• Definition file name only

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.

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.

aa...a

Node identifier (4 characters)

bbb

File type

sys: System journal file

cccccccc

Resource group name

dddddddd

Run ID (0x + 6-digit hexadecimal number).

eeeeeeee

Generation number (0x + 6-digit hexadecimal number).

ffffffff

Block number (0x + 6-digit hexadecimal number).

gg...gg

Journal block collection time (displayed in the format year-month-day hh:mm:dd)

Message ID	Description	Output destination
KFCA01141-E	The command cannot be executed because OpenTP1 is running in journal fileless mode.	Standard error output

• The jnlunlfg command must not be executed during journal service startup processing, which is from the time the KFCA01100-I message is issued until the time the KFCA01102-I message is issued in the case of normal start, or from the time of KFCA01101-I message issuance until the time of KFCA01102-I message issuance in the case of restart. If the command is executed while such startup processing is underway, the status of the system journal files may not be incorporated in OpenTP1. When this happens, the status of the system journal files can be incorporated into OpenTP1 by closing the corresponding file group with the jnlclsfg command after completion of restart processing and then opening the file group with the jnlopnfg command.
• The jnlunlfg command is executed with referencing the definition file. It cannot be correctly unloaded unless the definition file at journal collection in the online mode coincides with the definition file at execution of the jnlunlfg command. If they mismatch, specify the -d option if the backup target directory is not $DCCONFPATH, and the -r option if the file name is changed. In this case, however, the definition at journal collection in the online mode must be backed up in the system journal service definition or the archive journal service definition.
• Do not use the following commands for the unloaded files that are output by specifying the -t option:
  
  • damfrc
  • tamfrc
  • jnlcolc
  • jnlrput (unavailable only when the -e option is specified)