Data Manipulation Language Statements › #PUTJRNL—writes a task-defined record to the journal file › #PUTJRNL Parameters

#PUTJRNL Parameters

RECORD=

Specifies the location of the record to be written to the journal file.

record-location-pointer

Either a register that points to the record area or the symbolic name of the record area.

RECLEN=

Specifies the length, in bytes, of the record to be written to the journal file.

record-length-register

Either a register that contains the length of the record or the symbolic name of a fullword user-defined field that contains the length of the record.

OPTIONS=

Specifies whether the issuing task is to wait for completion of the #PUTJRNL function before resuming task execution and indicates how the system writes the named record to the journal file. Multiple options are enclosed in parentheses and separated by commas.

The following options determine whether the issuing task will wait for completion of the #PUTJRNL function.

NOWAIT

(Default); specifies that the issuing task will not wait for completion of the #PUTJRNL function; the journal record remains in a storage buffer until a future request necessitates writing the buffer to the journal file.

WAIT

Specifies that the issuing task will wait for completion of the #PUTJRNL operation before continuing. This option Requests that the system write a partially filled buffer to the journal file.

When a record is shorter than a journal file block, based on space available in the current journal block, the system either places the record in the block, splits it across multiple blocks (SPAN), or writes it to a new block after the current block is filled (NOSPAN). The following options determine how the system writes the named record to the journal file.

SPAN

(Default); specifies that the DC/UCF system will write the record across several journal blocks, if necessary. In general, the SPAN option provides better space utilization in the journal file because it increases the average fullness of each block.

NOSPAN

Specifies that the system will write the record into a single journal block, assuming that the record fits. If the record is longer than the journal block, it will be split.

The following considerations apply to using an exit routine to retrieve journal file records during recovery:

• If a #PUTJRNL statement issued before a failure specifies the SPAN option, records may have been written across several journal blocks. To retrieve these records, the program must invoke the exit routine once for each segment of each record to be retrieved.
• If a #PUTJRNL statement issued before a failure specified the NOSPAN option, and records written to the journal file are shorter than journal blocks, the exit routine need only be concerned with the complete records.

ERROR=error-label

Specifies the symbolic name of the routine to which control is to be returned in the event of an error condition during the #PUTJRNL operation.