IBM Version 4 manual Journal and Commit APIs, Message Handling APIs, Journal APIs

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 jou 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
	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 use
and	between	users	and	programs occurs	through messages. The message ha
dling	APIs allow your application to work				with these messages. The APIs
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
occur		or	one	that		has	been completed. You can also	ask a	question
for	a	response			to	it.
Ÿ Receive a message from							a message queue
This	would		be		done	to	determine what action occurred, for example,
mine	whether			a	function		completed successfully (your	program	can	cont

failed.

ŸHandle errors that occur

This is done to allow your application to tolerate errors that occu

example, you can move and resend messages to another program for ap priate action. Or perhaps you expected the error, and you can ju message and continue.

ŸReturn message or message queue information

This is done to	find	attributes (for	example, current	delivery mod
a message queue	or	to return one or	more messages on	a message q

ŸReturn message description or message file information

This is done to find attributes of a message file or to return t description of a message in a message file.

Detailed information about these concepts and functions canCL be found i

Programming book, SC41-5721.

8-8System API Programming V4R1