trans()
 Copy one or more rows (records) from one work area to another
------------------------------------------------------------------------------
 Prototype

     ERRCODE trans(
                       AREAP wa,
                       LPDBTRANSINFO lpdbTransInfo
                    )

 Arguments

     wa is a pointer to self.

     lpdbTransInfo is a pointer to a structure containing information
     about the transfer of data.

 Description

     trans() copies one or more rows between two tables in two different work
     areas.

 Default Behavior

     Copies multiple rows by passing each wa record to transRec() while the
     following conditions are met (these are the same conditions as
     dbEval()):

     .  If lpdbTransInfo->dbsci.itmRecID is set to a number,
        evalBlock() is called once with that physical row (record) number

     .  If lpdbTransInfo->dbsci.lNext is set to a number, n: n
        iterations occur.

        Otherwise, evalBlock() is called for each record while wa->fEof is
        not true and the lpdbTransInfo->dbsci.itmCobWhile block evaluates to
        TRUE.

 Implementation Notes

     .  If you perform multiple iterations of this method, be careful
        to completely emulate the behavior of Xbase scoping.  This will offer
        the CA-Clipper developer maximum compatibility with the Xbase DML.
        Note especially that several of the scoping conditions exclude each
        other, so there are many opportunities for optimization.  The default
        behavior of this method provides a very high level of optimization
        with the default Xbase scoping.

 Files  Header file is Rdd.api.