Rsuspend And Rresume Commands - Oce XDL Reference Manual

Using Logical Processing

4.13 RSUSPEND and RRESUME Commands

The print suppression logical processing function permits the user to delete from printing
groups of records that are distinguishable at the start and end, but whose intermediate
records may not be unique or distinguishable. (Print suppression or resumption is invoked
by the use of two separate commands—RSUSPEND and RRESUME.) The tests for each
command are independent and must be described separately. Each of the commands can
specify the full range of tests as described previously for the other logical processing com-
mands.
When specifying either the RSUSPEND or RRESUME command, the user can also specify
whether suspension or resumption of printing occurs on the current or next record. This is
controlled by the BEGIN parameter. This additional control provides the necessary flexibility
to cope with the variability of requirements for print suppression. The BEGIN parameter is
independently specifiable in both RSUSPEND and RRESUME commands.
Upon encountering a record which satisfies the test criteria specified on the RSUSPEND
command, printing is suspended. If BEGIN=CURRENT is coded on the RSUSPEND com-
mand, this record is not printed. If BEGIN=NEXT is coded, the record satisfying the test cri-
teria is printed, and records are discarded beginning with the following record.
Printing is resumed when a record satisfying the TEST in the RRESUME command is en-
countered. If BEGIN=CURRENT is coded in the RRESUME command, the record satisfy-
ing the TEST is printed. If BEGIN=NEXT is coded, printing resumes with the next record.
The following section describes the syntax of the command parameters and explanations
of the parameter options.
Parameter
BEGIN=
CURRENT
BEGIN=
NEXT
TEST=
test-exp
A29247-X4-X-8-7672
Definition(s)
CURRENT
Specifies whether printing stops or resumes on the current or next record for
offline jobs. For RSUSPEND, if CURRENT is coded, the record satisfying test-
exp does not print.
For RRESUME, if CURRENT is coded, the record is printed.
NEXT
If NEXT is coded, the record satisfying test-exp is not printed, and printing be-
gins with the next record.
If NEXT is coded, the record satisfying test-exp is printed, and printing is sup-
pressed beginning with the next record.
The default is NEXT.
test-exp
The format and syntax of a test-exp are defined in the "Test expression defini-
tion" section.
Defines test expression for the suspension (RSUSPEND) or resumption
(RRESUME) of printing.
There is no default.
RSUSPEND and RRESUME Commands
165