Modifying Action Diagrams › Understanding Contexts › System Contexts › *Record Selected

*Record Selected

The *Record Selected field specifies that a record read from the database is to be processed. In CA 2E standard functions that read multiple records from the database, for instance to load a subfile, you can add user-defined processing to specify which records are to be included. The record selected field allows you to indicate whether a record is to be included or omitted.

For example, if you want to add your own selection criteria to the loading of the subfile in a Display File or Edit File function, you should insert it into the USER: Initialize Subfile Record from DBF Record part of the Load Next Subfile Page routine in the action diagram for the function. For instance, if you want to specify that records with a zero date field are to be omitted:

> Load next subfile page

       REPEAT WHILE
     -Subfile page not full
     PGM. *Record selected = CND. *YES
     Move DBF record fields to subfile record
     > User: Initialize a subfile record from DBF record
      .
      .—
      : .-CASE
      . | -DB1.Date of birth is *ZERO
      : | PGM. *Record Selected = CND. *NO
      : .-ENDCASE
      ‘—
        .-CASE
        | PGM. *Record Selected is YES
        | Write subfile record
        ‘-ENDCASE
      Read next DBF record
      ENDWHILE