How can PSF 3800 Line-Mode Conversion be enabled

The conversion function is activated through PSF Exit 4 in deferred-printing mode or through PSF Exit 14 in direct-printing mode. Exit 4 is the PSF record processing exit, which typically gains control each time PSF accesses a print record from the JES spool. Exit 14 is the PSF direct-printing 3800 Line-Mode Conversion exit, which gains control for the first record of the transmission. To enable the conversion function, set flag XTP4CONV on for the first record of the transmission for either exit. For any other records of the transmission in Exit 4, PSF ignores XTP4CONV, although no error message is issued. As a default, PSF sets this flag to OFF before it calls Exit 4/14 for the first record of the transmission.

If you use Exit 4 for any other modification of the records, they are processed normally, as though the 3800 Line-Mode Conversion function did not exist.

Note: For more information about PSF exit processing, see Using installation exits.

You can set XTP4NCAL flag ON in Exit 4/14 to indicate that this exit is not called again for the rest of the current transmission. Because the JCL is analyzed and inline resources are built only when the first record is processed, you experience better overall performance if you set XTP4NCAL on. However, if you require Exit 4/14 functions on any record later in the current transmission, you must wait until you no longer want PSF to call Exit 4/14 for the current transmission before you set XTP4NCAL on.

When you program the logic for Exit 4/14, you identify the 3800 jobs you want converted. Because the exit has access to all the JCL parameters for the job, you might choose to identify jobs by any of these parameters—for example, Job Name or Job Class. To intermix AFP jobs and 3800 line-mode jobs, Exit 4/14 must identify each job as one kind or the other, and set the XTP4CONV flag off for AFP jobs and on for 3800 line-mode jobs.

You can set up a table in Exit 4/14 that allows the user, by specifying any of the parameters available to the exit, to select special print offsets, XTP4XOFF and XTP4YOFF, for different 3800 line-mode jobs. This enables the conversion function to emulate the print offsets that a 3800 operator might enter to match print to special forms. Exit 4/14 can set the horizontal offset value XTP7XOFF and the vertical offset value XTP4YOFF. Using these fields, you can make adjustments that correspond to the adjustments allowed on the 3800 line-mode printer. The adjustments are based on 240 pels per inch; an adjustment of 2 inches is coded as 480. The defaults are set for a vertical adjustment of 1/2 inch and a horizontal adjustment of 0 inches. These bits are valid only when the XTP4CONV flag is on.

You can set the XTP4LMRG flag in Exit 4/14 to indicate to PSF that line merge is activated. This line merge duplicates the line merge function of a 3800 while in line mode. To enable line merge, you set flag XTP4LMRG on for the first record of the transmission. For any other records of the transmission, XTP4LMRG is ignored, although no error message is issued. As a default, PSF sets this flag to off before Exit 4/14 is called for the first record of the transmission. The flag XTP4LMRG is only valid when XTP4CONV is set on.

You can set the XTP4DPLX flag in Exit 4/14 to indicate to PSF whether duplexing is enabled and if so, what type is enabled. To enable duplexing, you set field XTP4DPLX for the first record of the transmission. For any other records of the transmission, XTP4DPLX is ignored, although no error message is issued. As a default, PSF sets this field to zero before Exit 4/14 is called for the first record of the transmission. The field XTP4DPLX is only valid when XTP4CONV is set on.

The conversion function provides line-mode processing only for jobs selected by Exit 4/14. However, not all jobs that are selected by Exit 4/14 are converted. Any job that has a PAGEDEF or FORMDEF parameter coded in its JCL is ignored for line-mode processing. PSF assumes that the job already is designed for AFP printing, and processes it as a normal AFP job.

If you are using Cut-Sheet Emulation mode, you can set the XTP4WINA flag on in Exit 4/14 to indicate to PSF whether your 3800 line-mode job was designed for wide or narrow paper. If this flag is set OFF, PSF generates portrait pages to emulate narrow paper. If this flag is set ON, PSF generates landscape pages to emulate wide paper. To enable landscape pages, you set flag XTP4WINA ON for the first record of the transmission. For any other records of the transmission, XTP4WINA is ignored, although no error message is issued. As a default, PSF sets this flag to OFF before Exit 4 is called for the first record of the transmission. The flag XTP4WINA is valid only when XTP4CONV is set ON and the printer is in Cut-Sheet Emulation mode.