OpenTP1 Version 7 Programming Reference C Language

[Contents][Index][Back][Next]

dc_mcf_rollback - Enable MHP rollback

Format

ANSI C, C++

#include <dcmcf.h>
int  dc_mcf_rollback(DCLONG action)

K&R C

#include <dcmcf.h>
int  dc_mcf_rollback (action)
DCLONG      action;

Description

The function dc_mcf_rollback() cancels processing between when the MHP service program that defines the transaction attribute is started and when the function dc_mcf_rollback() is called. If DCMCFRTRY is specified for action, processing between when the MHP is started and when the function dc_mcf_rollback() is called is canceled, and the canceled MHP processing is rescheduled.

Arguments whose values are set in the UAP

action

Specify DCMCFRTRY, DCMCFRRTN, or DCMCFNRTN for the type of rollback.

DCMCFRTRY
Processing between the MHP is started and when the function dc_mcf_rollback() is called is canceled, and the canceled MHP processing is rescheduled (any received messages are stored at the end of the relevant input queue and the MHP is rescheduled). Control does not return from the function dc_mcf_rollback(), and the process is terminated.

DCMCFRRTN
Processing between the MHP is started and when the function dc_mcf_rollback() is called is canceled, and control returns. Processing after the normal termination of the function dc_mcf_rollback() with DCMCFRRTN specified is treated as another transaction.

DCMCFNRTN
Processing between the MHP is started and when the function dc_mcf_rollback() is called is canceled. Control does not return from the function dc_mcf_rollback(), and the process is terminated.

Return values

Return value Return value (numeric) Explanation
DCMCFRTN_00000 0 Normal termination.
DCMCFRTN_72000 -13000

Return at MHP execution
The function dc_mcf_rollback() was called out of sequence. The function dc_mcf_rollback() with DCMCFRRTN specified for action was called before the function dc_mcf_receive() (for receiving the first segment) was called from the MHP.The function dc_mcf_rollback() was called by an MHP with the nontransaction attribute.

Return at SPP execution
The function dc_mcf_rollback() cannot be called from an SPP.
DCMCFRTN_72027 -13027 The value specified for action is invalid.
Other than the above An unprecedented error (e.g., program damage) occurred.