Prev
Next
Forums Integration / Customization S3 Customization/Development

How does the BEGRNG - NXTRNG work?

 2 Replies
 0 Subscribed to this topic
 17 Subscribed to this forum
Sort:
Author
Messages
Demi
Veteran Member
Posts: 67
Veteran Member
7/20/2010 6:10 PM
    I'm trouble-shooting an existing program that uses the BEGRNG and NXTRNG commands. Can anyone explain to me how this works? When using these, is the table read sequetially; or is the table read in the sequence of the index key? Also, Lawson's data documentation often has key fields listed with '*'. Does anyone know what the '*' means?
    John Henley
    Posts: 3353
    7/20/2010 6:46 PM
      The BEGRNG/NXTRNG commands read records in the order of the index that is part of the API.

      So, for example, if using 850-FIND-BEGRNG-APPSET3, it is using index APPSET3 to return the records.

      The way it works:

      You fill as many of the DB- fields in the index as possible, starting from the "top" of the list of fields, and then specify the last field you are filling by moving XXXSETY-FIELD-NAME (e.g. APPSET3-REC-STATUS) to WS-DB-BEG-RNG.

      So using APPSET3 as the example, you might more a value "XYZ" to DB-PAY-GROUP, 3 to DB-REC-STATUS, and APPSET3-REC-STATUS to WS-DB-BEG-RNG. The 850-FIND-BEGRNG-APPSET3 will return the first APPAYMENT record matching APP-PAY-GROUP = "XYZ" and APP-REC-STATUS = 3. Then calling 860-FIND-NXTRNG-APPSET3 until APPAYMENT-NOTFOUND will return all other APPAYMENT records matching APP-PAY-GROUP = "XYZ" and APP-REC-STATUS = 3. The records are returned in the order of the index APPSET3.

      The asterisk means that the field is stored in descending order.
      Thanks for using the LawsonGuru.com forums!
      John
      Marc Burnes
      Basic Member
      Posts: 14
      Basic Member
      7/21/2010 2:08 PM
        If you have not done so already, you should download the API documentation

        -Login to mylawson.com
        -Get Support --> Knowledge Base
        -Click Product Documentation to the right of the search box
        -Click Doc Libraries at the top of the page
        -Click Lawson System Foundation (Technology)
        -Select your LSF release
        -Assuming you are on unix, click Developer (Unix)
        -Doc for Developers: Lawson 4GL Application Program Interfaces

        Quick Link: http://support.lawson.com.../09000000/eapi-u.pdf