FORWARD
Authorization
Privilege Class: D
Purpose
Use FORWARD to reposition current spool output on a real printer or punch.
Operands
- rdev
- identifies the device number of the real printer/punch you want spaced forward.
- 1
- nnnnn
- specifies the number of pages or cards to be spaced forward. The limit is 32,767; the default is 1.
Usage Notes
Pages are counted in FORWARD operations by looking for page ejects. If a file contains no page ejects, 66 output lines (including blanks) are treated as a “page.” The count begins at the end of the current buffer.
Responses
Response 1:
{PRT} rdev FORWARD userid FILE spoolid RECS {nnnn}
{PUN} {nnnK}
{nnnM}
COPY [*]nnn SEQ sss CL c typ
- PRT
- PUN
- identifies the device type.
- rdev
- identifies the real device number.
- userid
- identifies the user whose file was active and spaced forward.
- spoolid
- identifies the system-assigned number of the spool file.
- RECS nnnn
- RECS nnnK
- RECS nnnM
- identifies the number of logical records left in the file. If the number is greater than 9999, the number is shown as nnnK, where K represents the number of lines in thousands rounded to the nearest 1000 records. If the number is greater than 999499, the number is shown as nnnM, where M represents the number of lines in millions rounded to the nearest million.
- COPY [*]nnn
- identifies the remaining number of file copies to be produced, where 001 is the last copy. The asterisk (*) is for the 3800 printer and indicates that the printer copies each page nnn times before going to the next page.
- SEQ sss
- identifies the sequence number of the printer/punch file.
- CL c
- is the spool file class.
- typ
- shows the device type that originally produced the spool file. The type can be RDR, PRT, PUN, CON, DMP, or SYS.
Messages
- HCP003E Invalid option - {option|command contains extra option(s) starting with option}
- HCP021E A real device number was not supplied or it is invalid.
- HCP040E Device {rdev|vdev|ldev} does not exist
- HCP046E type rdev offline
- HCP140E type {rdev|ldev} attached to userid
- HCP141E type rdev not active
- HCP417E {rdev/vdev} is not an output spooling device.
- HCP418E {rdev|vdev} is not a spooled device.