Database Utilities › General Report Writer Program (SARGRW) › SARGRW Control Statements

SARGRW Control Statements

Control statements have the following general structure:

/name specifications

• Code a slash in column 1, followed by the name and specifications for the control statement to be performed.
• The control statement name and specifications are specified between columns 2 through 72 of the card image.
• A statement that exceeds 72 characters must be continued on additional statements. When continuing a statement, the specifications can be interrupted anywhere within the syntax structure. The continued specifications are specified between column 1 and 72 of the subsequent statement. Do not begin these statements with a slash as slash designates the beginning of a new control statement.
• Quoted fields that flow onto additional statements must be continued in column 1 of the subsequent statement. The continued statement cannot begin with a slash.
• Include a comment within the control statements by coding an asterisk in column 1 of the card image containing the comment.

To execute SARGRW, specify the following control statements:

BREAK

Discontinues processing of a repetitive group of statements (DO control statement) and proceeds with the statement following the repetitive group of statements.

CONTINUE

Performs the next iteration of a repetitive group of statements (DO control statement).

CONTROL

Specifies alternate values for line count, line size, database high-level name, print file DDname, output DDname, and database selection sequence.

DEFINE

Defines the fields to be used to store data or values.

DO

Specifies the beginning of a repetitive group of statements.

ELSE

Specifies the statements to execute when a false condition is determined for an IF control statement.

END

Specifies the end of a repetitive group of statements (DO control statement), the end of a conditional operation (IF control statement), the end of at-end logic (ON control statement), or the end of the control statements.

IF

Specifies the beginning of a conditional operation.

NEXT

Retrieves the next occurrence of a record.

ON

Specifies the statements to execute when no more database records or sort records are available.

OUTPUT

Specifies the writing of data to the output data set.

PRINT

Specifies the writing of data to the print data set.

RELEASE

Specifies to construct and sort a sort record.

SELECT

Specifies a condition or restriction to selection of information from the database.

SET

Specifies the setting of a defined field (DEFINE control statement).

SORT

Specifies a specific sort sequence for use in ordering information that is written to the print and output files.

STOP

Specifies the end of a control statement processing phase.

THEN

Specifies the statements to execute when a true condition is determined for an IF control statement.

TITLE

Specifies the definition of a report title.