NAME

       stAbortThis, stThisTransaction - simple transaction handling

SYNOPSIS

       #include <config.h>
       #include <sttk.h>

       void         stAbortThis (int domsg);

       struct stTransactionstThisTransaction;

DESCRIPTION

       stAbortThis  is  part  of  a  simple  transaction  mechanism  on the basis of setjmp(3) and longjmp(3). A
       transacion is started by setting a  return  point  calling  setjmp(3)  and  may  be  aborted  by  calling
       stAbortThis.  This  outputs a short abort message, cleans up the temporary files (stRmRegisteredFiles(3))
       and performs a longjmp(3) operation, returning to the transaction start point.

       The structure variable stThisTransaction carries information about the current transaction.  It  has  the
       following fields:
       struct stTransaction {
         char tr_fname[MAXPATHLEN+1];
         int tr_done;
         int tr_seqno;
         int tr_rc;
         jmp_buf tr_env;
       };

       When  setting the transaction return point by calling setjmp(3) the tr_env field must be used as argument
       to setjmp. The name of the concerned file should be stored in tr_fname field and the tr_done flag  should
       be  cleared.   tr_seqno  is  the  serial  number  of the current transaction and must be increased at the
       beginning of each new transaction. The tr_rc return code can be set to an appropriate  return  code  when
       something went wrong and the transaction was aborted.  When not set by the application, tr_rc will be set
       nun null by stAbortThis on abortion of the transaction. On successful completion, tr_done should  be  set
       TRUE.

SEE ALSO

       stRmRegisteredFiles(3), setjmp(3), longjmp(3).