Oce XDL, Reference Manual

Page: 174 / 255

RSUSPEND and RRESUME Commands Using Logical Processing
166
A29247-X4-X-8-7672
Points to note
Note the following when using the RSUSPEND and RRESUME commands:
• RSUSPEND
• Make sure that if an RSUSPEND command is coded, an RRESUME command
must also be present for the job. A warning is issued by the XDL compiler if one
command, but not both, is invoked for a job. However, the JDE is compiled as pro-
grammed.
• The RSUSPEND command is intended to suspend records within a report.
• RSTACK
• A record satisfying the RSTACK test can still be found and terminates the report,
even if the printing of records is suspended at the time. Also, DJDE records are not
processed even if record printing has been suspended. Refer to chapter "Dynamic
Job Descriptor Entries (DJDEs)" on page 169 for further information.
• If the criteria for RSTACK and RSUSPEND are satisfied on the same record, that
record delimits the report, and the record is suspended.
If a data record satisfying the test expression in the RSUSPEND is encountered, printing is
suspended. If no record satisfying the test expression in the RRESUME command is en-
countered (or no RRESUME command is present for the job), there is no output generated
for records that occur after the point of suspension.
Record selection or deletion is performed before suspend/ resume processing. If a record
satisfying either the suspend or resume test criteria was not selected for or deleted from
printing previously, it does not cause either the suspend or resume function.
The records just before print suspension and after resumption should have compatible
printer carriage control (PCC) characters. No additional carriage control characters are in-
serted by the system during the print suppression.
Use of the LINENUM parameter in the CRITERIA command is not recommended when us-
ing RRESUME. Since the carriage control characters are not processed during the print
suppression, the line number used by the system is that which existed when the suppres-
sion started. This could result in the test criteria being either unexpectedly satisfied or never
satisfied as a function of the line number where the print suppression started.
DJDE records are processed, not ignored, even when detected after an RSUSPEND record
and before the corresponding RRESUME record.