ddlPick() - specified records into collection

ddlPick() - specified records into collection ddlPick() - specified records into collection

Prototype:

   void ddlPick(
      CONTROL *ctl,
      char *OptnStr,
      char *ArgList);

Permitted values in OptnStr:

   /D - delete specified record(s) from collection
   /R - OR specified record(s) into collection

Form of ArgList:
       <cx> [<table-name>] <range>
             where <range> is either:
                   <recno>
                   <recno-1> [{, | -}] <recno-2>
                   <recno-1> [{, | -}] 0

Description:

If neither the /R option or the /D option is present, ddlPick():
       1) Clears the target collection
       2) Stores the indicated records into the collection
       3) ANDs the resulting collection with the deleted record collection

If the /R option is present, ddlPick():
       1) ORs the indicated records into the collection
       2) ANDs the resulting collection with the deleted record collection

If the /D option is present, ddlPick():
       1) Performs AND NOT of indicated records with the collection

A table-specific ddlPick() (a call that contains a specific <table-name>) clears existing sorted collections for
       . the sorted collection for <cx> <table-name>
       . the global sorted collection for <cx>

A global ddlPick() (a call that does not contain a specific <table-name>) clears existing sorted collections for
       . all table-specific sorted collection for <cx>
       . the global sorted collection for <cx>

Values returned in Control Structure:

Control.Ans1 Total number of records placed into target collection (32 bit).
In the case of the /D option, this is the net number of records that were unselected.
In the case of the /R option, this is the net number of records that were added.

Control.Ans1L Total number of records placed into target collection (64 bit).
In the case of the /D option, this is the net number of records that were unselected.
In the case of the /R option, this is the net number of records that were added.

Control.Ans1	Total number of records placed into target collection (32 bit). In the case of the /D option, this is the net number of records that were unselected. In the case of the /R option, this is the net number of records that were added.
Control.Ans1L	Total number of records placed into target collection (64 bit). In the case of the /D option, this is the net number of records that were unselected. In the case of the /R option, this is the net number of records that were added.