Northern Illinois University

Information Technology Services

6.00 XPAF PRINT

6.01 INTRODUCTION

XPAF (Xerox Printer Access Facility) is a host-resident software product that retrieves data streams from JES and prepares them for printing on a Xerox laser printer (VPS/PC controls the remote printers). XPAF software provides us with hardware flexibility.

6.02 XPAF - GENERAL CONCEPTS

XPAF converts AFP (IBM's Advanced Function Printing) documents into a Xerox-generated data stream that provides all-points addressability on Xerox centralized and decentralized printers.

AFP is a collection of IBM programs that are used to place fonts, forms, graphic images and various other types of data on a printed page. PPFA (Page Printer Formatting Aid/370), an AFP program, enables Enterprise Systems Support (ESS) to create formatting resources, called page definitions and form definitions. The page definitions (PAGEDEF) and form definitions (FORMDEF) are stored in libraries as resources.

PAGEDEF allows the user to control landscape/portrait, oneup/twoup, and number of lines per page. Duplex/simplex and flashing are controlled by the FORMDEF. The PAGEDEF keyword is placed on a //xxx OUTPUT record (see JCL CONSIDERATIONS).

In most cases a default will be used to print the output, the default will not require a PAGEDEF or FORMDEF parameter.

The default font is defined in Appendix C. The fonts are uplow fonts with consistent mapping of special characters.

The first three datasets (joblog, messages and JCL) will print on separate physical pages for non-default jobs.

6.03 XPAF JCL CONSIDERATIONS

A. OUTPUT JCL Statement

Following is an example of an OUTPUT JCL statement using PAGEDEF. (Stmtname may not begin with a numeric character.)

//stmtname OUTPUT PAGEDEF=P1DN,COPIES=2,DEFAULT=YES,JESDS=ALL

Note: As with all MVS JCL, you may not go beyond column 71 and any continuation records must begin in or before column 16.

The DEFAULT=YES parameter applies the OUTPUT statement to all SYSOUT DD statements which do not reference an OUTPUT statement. A refer back is not required with DEFAULT=YES. Only one default is allowed. If a default is not specified, the output will print using the system default (Appendix E).

JESDS=ALL should be used on an OUTPUT statement if the JCL, LOG, and messages are to print the same as defined in the OUTPUT statement. If you do not use JESDS=ALL the JCL, LOG and messages will print separate from the rest of the output, using the default PAGEDEF.

Suggestion: If you use DEFAULT=YES you may want to use DFLT for the code name on the OUTPUT statement.


B. Remote Printing

To route output to a remote printer include DEST=RMT## on the OUTPUT statement.


C. PAGEDEF

PAGEDEF names can be 6 positions long, however we have reserved the 6th position for future use. A list of the PAGEDEFs can be found in Appendix E. The naming scheme follows (W2VOC):

W=pmode - values are "L" for landscape and "P" for portrait
2=2up - values are "1" for oneup and "2" for twoup
V=duplex - values are "D" for duplex and "S" for simplex
O=flash - values are "L" for lines and "N" for no flashing
C=fcb - values are "6" for FCB=6, "8" for FCB=8, "M" for FCB=M, and blank
for the default which will be to use the channel assignments from FCB 8
with a line count of 60. Specifying 8 will get FCB 8 channel assignments
with up to 62 lines per page. This is the only operand that has a default,
all others must be coded.

The FORMDEF keyword should be omitted, but if it is specified its operand must match the PAGEDEF operand or you may get very odd results. (In IBM parlance, 'results may be unpredictable'.)

Example:

//stmtname OUTPUT PAGEDEF=P2DL

will result in portrait, twoup, duplex, lined output printed at 6 lpi, and 60 lines per page using the default font.

//stmtname OUTPUT PAGEDEF=L1DL8,FORMDEF=L1DL8,CHARS=CR15

will result in landscape, oneup, duplex, lined output printed at 6 lpi, 62 lines per page and using the CR15 font. The FORMDEF operand could have been omitted with no change in the resulting output.

Note that a default font will be implied by the PAGEDEF. Users may choose to override the default font with the CHARS or UCS parameters which are documented in the IBM JCL manual, the available fonts are documented in Appendix C.

D. SYSOUT and OUTPUT Parameters on DD Statement

Following is an example of a SYSOUT & OUTPUT parameter referring back to the OUTPUT statement.

The old SYSOUT statement may look like:

//REPORT DD SYSOUT=(A,,stmtname)

The new SYSOUT statement would be:

//REPORT DD SYSOUT=A,OUTPUT=*.stmtname

E. JOBPARM Statement

Following is a list of invalid JOBPARM parameters:

1ACCOUNT PMODE(W)
BANNER (Y) 1PROD
2DISK (D) 1PROJECT
DUPLEX SHIFT (H)
3FCB (Z) 2TAPES (A)
FLASH (O) TWOUP (2)
OFFSET (X) 3UCS (U)

1 - These keywords are obsolete, they were used for the old ADC2 scheduling software.

2 - Obsolete JES2 keywords need to be removed.

3 - UCS and FCB are valid IBM keywords and can be used on an OUTPUT statement in some circumstances. UCS is valid on an OUTPUT statement, and will override the default font (like CHARS). FCB can be used on an OUTPUT statement without a PAGEDEF and FCB will be honored. However, FCB will be ignored if PAGEDEF is specified because the FCB function is incorporated into the PAGEDEF.