1        Introduction to xsys system                                       1
2        Putting xsys to work.                                             1
3        Performing transaction.                                           1
4        Controlling transaction.                                          2


1        Introduction to xsys system                                 

    Xsys is a dummy system to present the documentation tools 
    provided in the Solucorp Programmer Toolkit. Please read 
    document.exm before reading further. For now on, we are 
    describing xsys as a real system. Xsys automated the 
    processing of asynchronous transaction between two hosts.

2        Putting xsys to work.                                       


    FUNCTION xsys_init:

    Initialise subsystem XSYS. This function is called once. bla 
    bla bla.

    Return -1 if not successfull

    int xsys_init(
    	int memsize)	/* Amount of memory allocated to xsys */
    

    FUNCTION xsys_end:

    Terminate use of subsystem XSYS.

    This function frees all buffers and completes any pending 
    operation. After it has been called, xsys_init may be call 
    again.

    void xsys_end(
    	void)


3        Performing transaction.                                     


    FUNCTION xsys_transact:

    Perform one transaction interactivly.

    The function returns only when transaction is secure.

    int xsys_transact(
    	void)
    

    FUNCTION xsys_batch:

    Perform one transaction without prompting the user. This 
    function assumed a yes to each questions.

    The function returns immediatly without waiting for the 
    background process to fully complete the transaction. See 
    function xsys_flush().

    int xsys_batch(
    	void)


                                                              1


    


4        Controlling transaction.                                    


    FUNCTION xsys_undo:

    Undo the last transaction.

    This function must be called only in this and this and this 
    situation.

    Return -1 if transaction can't be undone.

    int xsys_undo(
    	void)

    FUNCTION xsys_flush:

    Complete any pending transactions.

    This function must be called only in this and this and this 
    situation.

    Return the number of transactions that has been completed.

    int xsys_flush(
    	void)