RF Command - Route/Requeue File

Use the RF command to change the file name and the destination name for one or more spool files, or requeue a file for printing.
casp14
Use the RF command to change the file name and the destination name for one or more spool files, or requeue a file for printing.
The syntax is as follows:
RF{file_sequence_number | seq1-seq2 | ALL} [,O=][,D=][,F=][,NO=][,ND=][,NT=]
The RF command requires the
file sequence number
, the
seq1-seq2
, or the keyword ALL (route only).
  • file_sequence_number
    Defines the sequence number of the requested file to be routed/requeued.
  • seq1-seq2
    Defines the sequence range of the files to be routed/requeued.
    Note:
    seq1
    and
    seq2
    are the specified file sequence range, where,
    seq1
    must not be greater than
    seq2
    .
  • ALL
    Defines all files to be routed.
For the RF command to be interpreted as a requeue command, no operands except the sequence number (or sequence number range) can be specified.
The following operands apply to the RF command as a route command only.
  • O=
    Defines the old name of the file.
  • D=
    Defines the old destination name of the file.
  • F=
    Defines the old form name of the file.
  • NO=
    Defines the new filename to be assigned to the file.
  • ND=
    Defines the new destination name to be assigned to the file. If the new destination name is a valid JES destination (or INTRDR), the file is queued for transfer to that destination.
  • NT= A2PDS
    Initiates AFP-to-PDF transformation and stores the resulting PDF output in the HFS or ZFS specified by the D2E_WEB_SWAP= environment variable in CA0CPARM(CAIQENVA).
All operand values are alphanumeric strings with 1 to 8 characters.
A re-queue command (no old or new operands) to a file which has been printed once causes the removal of the flag which indicates that the file has been printed; this makes the file again eligible for output selection. If the keyword ALL is specified, both one or more old operands and one or more new operands are required. In other cases (RF
nnn
or RF
nnn-mmm
) only one or more new operands are required. This also implies that a re-queue command in the format RFALL is invalid. If a file which has been marked as printed is routed to the same or another destination, or is re-queued (no operands on command), the printed status is removed, and the file is eligible for selection at the new destination.
Examples
This example routes file 2176 from filename RTEST002 to filename RTEST003, and alter the destination name to DEPTPRT1.
RF2176,O=RTEST002,NO=RTEST003,ND=DEPTPRT1
-or-
RF2176,NO=RTEST003,ND=DEPTPRT1
This example routes all files from destination DEPTPRT1 to destination DEPTPRT2.
RFALL,D=DEPTPRT1,ND=DEPTPRT2
This example re-queues all files in the range from 14 to 62.
RF14-62
This example re-queues all files.
RF1-65535