IBM SC33-1683-02 User Manual

Page 421

Advertising
background image

WRITE_JOURNAL DATA

DFHJCJCX [CALL,]

[CLEAR,]

[IN,

FUNCTION(WRITE_JOURNAL_DATA),

FROM(block-descriptor),

JOURNALNAME(name8 | string | 'string' ) |

JOURNAL_RECORD_ID(name2 | string | 'string'),

WAIT(YES|NO),

[RECORD_PREFIX(block-descriptor),]]

[OUT,

RESPONSE(name1 | *),

REASON(name1 | *)]

Important

There is a restriction in using the XPI early during initialization. Do not start
exit programs that use the XPI functions TRANSACTION_DUMP,
WRITE_JOURNAL_DATA, MONITOR, and INQUIRE_MONITOR_DATA until
the second phase of the PLTPI. For further information about the PLTPI, refer
to “Chapter 4. Writing initialization and shutdown programs” on page 393.

FROM(block-descriptor)

specifies the address and the length of the journal record.

JOURNALNAME(name8 | string | "string")

specifies the name of the CICS journal or log to which the FROM data is to be
written.

JOURNAL_RECORD_ID(name2 | string | "string")

specifies a 2-character value to be written to the journal record to identify its
origin.

name2

The name of a 2-byte location

string A character string that is limited to a length of 2 in the generated code

"string"

A character string enclosed in quotation marks, limited to a length of 2
in the generated code.

RECORD_PREFIX(block-descriptor)

specifies the optional user prefix.

WAIT(YES|NO)

specifies whether CICS is to wait until the record is written to the journal or log
before returning control to the exit program.

user journaling function

Chapter 3. The user exit programming interface (XPI)

389

Advertising