PAGRTT (Page Rotation) keyword in printer files

You use this record-level keyword to specify the degree of rotation of the text with respect to the way the page is loaded into the printer.

The PAGRTT keyword is valid only for the 3812, 3816, 3820, 3825, 3827, 3835, and 4028 printers. If you do not specify a PAGRTT keyword for a record, the page rotation is set from the value specified on the Create Printer File (CRTPRTF), Change Printer File (CHGPRTF), or Override Printer File (OVRPRTF) commands.

The format of the keyword is:

PAGRTT(0 | 90 | 180 | 270)

The valid parameter values for the keyword are 0, 90, 180, and 270. Zero indicates no rotation. The other values specify the number of degrees rotation clockwise from the 0 degree rotation column.

Note: For the 3835 Printer using landscape paper, a counterclockwise rotation is used for a DDS file.

The PAGRTT keyword does not cause an implicit page eject. If the paper is not on a page boundary, the keyword is not used, and a diagnostic message is issued.

The PAGRTT, SKIP, and SPACE keywords are processed in the following order:

SKIPB
SPACEB
PAGRTT
SPACEA
SKIPA

The PAGRTT keyword remains in effect for the duration of the record format. If a PAGRTT keyword is not used on the next record format, it reverts back to the PAGRTT value specified at the command level.

Notes:

The PAGRTT keyword remains in effect for the entire page. At the end of a record format that specifies PAGRTT, the file is not changed back to the file-level rotation until the next page is processed. For example, the file does not return to rotation 0 until record E is written if the file-level parameter specifies PAGRTT(0) and you write one of the following record formats:
- Record format A (PAGRTT (90))
- Record format B (same page as record A)
- Record format C (same page as record A)
- Record format D (same page as record A)
- Record format E (next page)
For files created with DEVTYPE(*SCS), if the PAGRTT keyword is specified on a record format that spans several pages, it remains in effect only for the page on which it is specified.

When a page rotates, the page length and page width are exchanged so that the length becomes the width and the width becomes the length. This exchange cannot be done under the following conditions:

PAGRTT on the CRTPRTF, CHGPRTF, or OVRPRTF command is *DEVD or *COR.
The font on the CRT/CHG/OVRPRTF command is *DEVD.

When the length and width cannot be exchanged, a diagnostic message is issued.

Folding and truncation support is not performed when pages rotate. That is, the BLKFOLD DDS keyword and the FOLD parameter on the CRTPRTF, CHGPRTF, or OVRPRTF commands are not used.

Option indicators are valid for this keyword.

Example

The following example shows how to specify the PAGRTT keyword.

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
     A          R RECORD1
     A  02                                  SKIPB(1)
     A  02                                  PAGRTT(270)
     A            FIELD1         3A     2 01
     A          R RECORD2
     A            FIELD1         3A     6 01
     A          R RECORD3
     A            FIELD1         3A     5 01
     A

If indicator 02 is on, RECORD1 is rotated 270 degrees. SKIPB(1) is specified so that the record starts on a new page.

When RECORD2 is printed, it will also be rotated 270 degrees because it is on the same page as RECORD1.

RECORD3 uses the PAGRTT value specified on the CRTPRTF, CHGPRTF, or OVRPRTF commands, because it is on a new page.