You are here: Job and Form Set Rules Reference > JDT Rules Reference > RULCheckTransaction

RULCheckTransaction

Use this form set level rule to save the files necessary for restarting the GenData program. This rule should be the first base form set rule.

Syntax

;RULCheckTransaction;;;

The rule saves the EXTRFILE offset, TRNFILE offset, NEWTRN offset, NAFILE offset, POLFILE offset, and batch file offsets into a restart (RSTFILE) file. You can set up the GenData program to restart at a particular transaction if it encounters a failure. To accomplish this, the system uses a restart file. Use INI options to set up the restart file.


	Note	This rule does not apply if you are using single-step processing.

The restart file stores checkpoint information at specified intervals. If an error is encountered, the program resets itself and then checks each transaction until it isolates the transaction causing the error.

The restart file is removed at the end of a successful run. If the file exists at the start of a GenData run, the system assumes a restart is necessary and will open and read the file. The checkpoint information lets the system set internal pointers and output files in such a way that it can begin at that transaction. You also use the RestartJob rule to restart the GenData program.

INI options

These offsets are updated in the post process after a specific number of transactions. You specify the number of transactions using the CheckCount option. You define the Restart file and the and check count in the Restart control group:

< Restart >

RstFile =

CheckCount =

Option	Description
RstFile	Enter the name of the restart file. If you omit this option, the system uses RSTFILE.RST (DD:RSTFILE for z/OS) as the file name. The system uses the DataPath option in the Data control group to determine where to create the restart file. The default is the current working directory.
CheckCount	Enter a number to specify the number of transactions to process before updating the offsets. For instance, if you specify two hundred (200), the system processes two hundred transactions, updates the offsets, processes two hundred more transactions, and so on. The default is 100. You can also use the /cnt command line option with the GenData program to override the CheckCount option. Here is an example: gendaw32 /cnt=10

Option

Description

RstFile

Enter the name of the restart file. If you omit this option, the system uses RSTFILE.RST (DD:RSTFILE for z/OS) as the file name.

The system uses the DataPath option in the Data control group to determine where to create the restart file. The default is the current working directory.

CheckCount

Enter a number to specify the number of transactions to process before updating the offsets. For instance, if you specify two hundred (200), the system processes two hundred transactions, updates the offsets, processes two hundred more transactions, and so on. The default is 100.

You can also use the /cnt command line option with the GenData program to override the CheckCount option. Here is an example:

gendaw32 /cnt=10

Example

Here is an example:

;RULCheckTransaction;2;Always the first form set rule;

RULCheckTransaction

Syntax

INI options

Example

See also