Journal and Commit APIs
This section includes the journal and commitment control APIs.
Journal APIs
The journal APIs allow you to:
Obtain information about some of the journal’s attributes or the journal
receiver’s attributes
Obtain journal information based on the journal identifier
Send an entry to specified journal
Commitment Control APIs
The commitment control APIs allow you to:
Add and remove your own resources to be used during AS/400 system commit
or rollback processing
Retrieve information about the commitment control environment
Change commitment control options
Put a commitment definition into rollback-required state
Message Handling APIs
On the AS/400, communications between programs, between jobs, between users,
and between users and programs occurs through messages. The message han-
dling APIs allow your application to work with these messages. The APIs consist of
the following groups of functions:
Send different types of messages to users and programs
This would be done to communicate the status of an action that is about to
occur or one that has been completed. You can also ask a question and wait
for a response to it.
Receive a message from a message queue
This would be done to determine what action occurred, for example, to deter-
mine whether a function completed successfully (your program can continue) or
failed.
Handle errors that occur
This is done to allow your application to tolerate errors that occur. For
example, you can move and resend messages to another program for appro-
priate action. Or perhaps you expected the error, and you can just remove the
message and continue.
Return message or message queue information
This is done to find attributes (for example, current delivery mode or severity) of
a message queue or to return one or more messages on a message queue.
Return message description or message file information
This is done to find attributes of a message file or to return the actual
description of a message in a message file.
Detailed information about these concepts and functions can be found in the
CL
Programming
book, SC41-5721.
8-8 System API Programming V4R1