Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- CA-Clipper 5.2 . Technical Reference - <b>ordercreate()</b> http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 orderCreate()
 Create new Order
------------------------------------------------------------------------------
 Prototype

     ERRCODE orderCreate(
                           WORKAREAP wa,
                           DBORDERCREATEINFOP dbCreateOrderInfo
                        )

 Arguments

     wa is a pointer to self.

     dbCreateOrderInfo is a pointer to a structure containing information
     for Order creation.

 Description

     Creates a new Order in wa.

 Default Behavior

     You must implement the default behavior of this method through a
     subclass.

 Implementation Notes

     .  Before you create and attach a new Order to the workarea, call
        goCold().

     .  orderCreate() provides the functionality of the CA-Clipper
        INDEX ON command.  In most implementations, orderCreate() should
        close any currently open Orders before creating the new Order.  After
        Order creation, the closed Orders may then be reopened or left
        closed, as dictated by the RDD implementation.

     .  The base ordering procedure requires key evaluation on an
        empty phantom row.  To reposition to a phantom row, perform a
        SELFGOTO().  See goTo() for more information.

     Warning!  If you choose to allow Orders to remain open during Order
     creation, and your implementation provides for scoped or conditional
     Orders, keep in mind that future Order creations may be affected by such
     Orders.

 Files:  Header file is Rdd.api.


See Also: DBORDERCREATEINFO WORKAREA orderListRebuild()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson