| 1 | PDF tranform information | Input | Char(*) |
| 2 | Length of PDF transform information | Input | Char(4) |
PSF/400 uses the IPDS to PDF Transform Interface exit program to submit an IPDS to PDF transform when a PDF transform is requested to the QIBM_QPQ_Transform exit point and the PDFGEN parameter on the PSF configuration object has a value other than *NONE.
If the IPDS to PDF Transform exit program encounters an error in starting the transform (TCP/IP is not started or any other start-up error), the transform returns to the program that called it and writes an error message to the PDF transform job log. If no transform is registered to the exit point, PSF/400 will time out when it tries to communicate with the PDF transform and will log its own error.
There are no locks for this exit program.
Subdirectories and files created by the PDF transform are owned by the spooled file owner and have *EXCLUDE public authority. The transform has *USE authority to the QIPS library.
PDF transform information that is input to the IPDS to PDF Transform Interface exit program from the PSF/400 print writer.
The length (in zoned decimal) of the PDF transform information specified in the PDF transform input information to the IPDS to PDF Transform Interface exit program.
The following table shows the structure for the PDF transform input parameter.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | CHAR(10) | Device type |
| 10 | A | CHAR(10) | Paper size for drawer 1 |
| 20 | 14 | CHAR(10) | Paper size for drawer 2 |
| 30 | 1E | CHAR(256) | File directory |
| 286 | 11E | CHAR(5) | TCP/IP port |
| 291 | 123 | CHAR(10) | Print writer's message queue |
| 301 | 12D | CHAR(10) | Print writer's message queue library |
| 311 | 137 | CHAR(8) | Printer font ID |
| 312 | 138 | CHAR(1) | Inline font indicator |
| 313 | 139 | CHAR(1) | Group boundary operation |
The example below is provided to show the interaction between the PSF/400 and PDF transform exit program.
This ties a PSF configuration object to a printer device. The configuration object must have a PDFGEN value other than *NONE and the other appropriate PDF parameters appropriately defined based on the the PDFGEN value chosen.
The PDF Transform exit program uses the input information to intialize itself. PSF/400 saves the job number from the submit job that is associated with the transform.
The PDF transform communicates with PSF/400 as a virtual printer device, but instead of printing the IPDS, the transform converts it to PDF and stores it either in a user specified path (when PDFGEN is *STMF) or in a temporary path location chosen by PSF/400.
When PSF/400 receives an indication from the virtual printer device that all pages have been stacked, it knows that the PDF transform is finished with that spooled file.
At this time, if PDFGEN had a value of *MAIL or *SPLF, PSF/400 will complete the request by either electronically mailing the PDF file or spooling it to the appropriate output queue. When either function is complete, PSF/400 deletes the temporary path name.
PSF/400 does its normal clean up and ends the job that is running the PDF transform.
Device type. The device type that the transform should emulate. It is specified in the PDFDEVTYPE parameter of the PSF configuration object.
File directory. The first two components of the file path names specified in the PDFDIR parameter of the PSF configuration object and assigned to the PDF files created by the PDF transform. The rest of the path name is assigned by the PDF transform.
Group boundary operaion. The value of PDFMULT parameter in the PSF configuration object. Valid values are:
| 1 | Separate the output into multiple PDF files at the DGB commands. |
| 2 | Place an index tag at the DGB Location. |
Inline font indicator Specifies whether fonts should be placed inline with the PDF output. Valid values are:
| 0 | File should not contain the fonts inline. |
| 2 | File should contain the fonts inline. |
Paper size for drawer 1. The paper size specified in the PDFPPRDWR1 value of the PSF configuration object that the transform should report to PSF/400.
Paper size for drawer 2. The paper size specified in the PDFPPRDWR2 value of the PSF configuration object that the transform should report to PSF/400.
Printer font ID. The printer default font ID to use if a font is not specified in the IPDS data. It is composed of the graphic character set ID, code page global ID, font character set global ID, and character width.
Print writer's message queue. The name of the PSF writer's message queue.
Print writer's message queue library. The library in which the PSF writer's message queue can be found.
TCP/IP port. The TCP/IP port of the transform's virtual printer.
| Top | Print APIs | APIs by category |