OpenTP1 Version 7 Programming Reference C Language
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. |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.