Process Parameters › Assignment Operations › Control Operations

Control Operations

Control operations manage the flow of processing in a CA Culprit report. The following control operations are available:

• PERFORM passes processing control to code in another area of procedure logic. A PERFORM instruction is useful when a group of procedure statements may execute any number of times. Fewer statements are required, and procedures that are executed repeatedly can be centralized.
• RETURN returns processing control to the statement that immediately follows PERFORM. The RETURN statement executes only if the procedure code is accessed with a PERFORM statement. Procedure code accessed by a PERFORM instruction can also be accessed inline (that is, by falling through the code) or by coding a branch instruction to the first statement of code.
• CALL calls an external user-coded or CA-supplied procedure module to be executed. The CALL statement is the equivalent of coding individual MOVE ARGn statements that first establish the arguments in the argument list and then coding a B USnn statement to invoke the procedure module. The CALL statement generates appropriate MOVE and branch instructions. These instructions appear on the Input Parameter Listing. Details on coding MOVE and branch instructions are presented earlier in this chapter.
• PICK, UNPICK, TAKE, RELS, and DROP select type 5 edit lines for extracting from a particular input buffer or type 6 edit lines for output from a particular control break. All type 5 and type 6 edit parameters are initially given the same select/deselect status at the start of each report; the status is reset each time a new buffer or control break is processed. All type 5 and type 6 edit parameters are initially set to a status of select unless a PICK, TAKE, or RELS instruction specifies lines for output, in which case they are initially set to a status of deselect.

  Output lines are sorted as follows:

  • Report number
  • Sort keys specified on the SORT parameter
  • Header or detail data indicator (data derived from a branch to HEAD sorts first)
  • Input buffer number
  • Edit line number
  • Release count (a counter maintained by CA Culprit that is set to zero when procedure logic is entered for each report and incremented by 1 for each RELS, TAKE, or DROP executed)

  A special user-defined sort key is required to print lines outside of their numerically defined order; for example, RELS line 5, then RELS line 1. Any type of work field can be coded as a sort key to define the desired sort sequence on the SORT parameter; this key must follow all report-related sort fields. Before a record is extracted by means of a RELS statement, the user can move a print sequence value to this work field. CA Culprit sorts all extracted records on this value; records with the same value sort by edit line number.