Configuring a *LAN IPDS Device Description to Use Infoprint® Server to Convert a SPLF to PDF and Store it in the IFS

There is some preparation that needs to be done prior to configuring the device description and PSF configuration object. A general checklist follows; it is recommended to follow the User's Guide for complete instructions on some of these steps.

o

Install the Infoprint Server product. This is a licensed product though licensing for the product has been removed.   To avoid license related error messages, ensure the necessary PTF is applied from this document:  Products are no longer listed in WRKLICINF but show in DSPLICKEY or CALL QSFWINV:  https://www.ibm.com/support/pages/node/7066410  After IBM Infoprint Server for iSeries, product 5722IP1, has been installed it is recommended that the latest recommended fixes for both Print and Infoprint Server be downloaded and applied before attempting to configure a PSF Configuration (PSFCFG) object and *LAN IPDS device description to use Infoprint Server. For a list of the recommended fixes for both Print and Infoprint Server, refer to the IBM i Support: Recommended Fixes document.

o

A data queue can be created to use for logging the IPDS to PDF conversion messages. The size of the data queue is recommended to be 752. This data queue must be created before creating the PSF configuration object and device description, if this will be used. Using this parameter is optional, though it can be a helpful debugging tool. For each spooled file that is processed by InfoPrint Server, a data queue entry is created to track if the conversion was successful. It can be created with the Create Data Queue (CRTDTAQ) command. Then, specify the name of the data queue in the PDF Data Queue (PDFDTAQ) parameter of the PSF configuration object. More information on this field layout for the data queue can be found in Appendix E of the Printing VI Redbook.

To configure a PSF Configuration (PSFCFG) object, use the Create PSF Configuration (CRTPSFCFG) command, and press F4. Parameters not mentioned here can be left to the defaults because they are used when printing to an actual printer. Additional parameters are shown when pressing the Enter key or F10. For more information on those parameters, refer to the following document:

N1010169: Configuring a *LAN IPDS Device Description

The following parameters must be specified when using Infoprint Server to generate a PDF stream file in the IFS:

PSF configuration (PSFCFG)
This is the name of the PSF Configuration (PSFCFG) object to be created.

Generate PDF output (PDFGEN)
This parameter should be set to *STMF to have PDF output that is generated in a stream file in the Integrated File System (IFS).

PDF device emulation type (PDFDEVTYPE)
Specifies what type of device the virtual printer will emulate for the IPDS to PDF transform. The options are:

o	*IP40240 - Emulates an IP40 printer device configured at 240 pel resolution.
o	*IP40300 - Emulates an IP40 printer device configured at 300 pel resolution.
o	*4028 - Emulates a 4028 printer device.
o	*3812 - Emulates a 3812 printer device.

PDF paper size drawer 1 (PDFPPRDWR1) and PDF paper size drawer 2 (PDFPPRDWR2)
The values in these parameters are used as the page size in the PDF output file to determine the printable area. This is valid only if PDFGEN is set to a value other than *NONE. The options are:

o	*LETTER (8.5 x 11 inches)
o	*LEGAL (8.5 x 14 inches)
o	*STATEMENT
o	*EXECUTIVE (7.25 x 10.5 inches)
o	*LEDGER (11 x 17 inches)
o	*A5 (148 x 210mm)
o	*A4 (210 x 297mm)
o	*A3 (297 x 420mm)
o	*B5 (182 x 257mm)
o	*B4 (257 x 364mm)

Multiple PDF files (PDFMULT)
Specifies if PSF should tell the IPDS to PDF transform to split the PDF output into multiple PDF files. The value *NO will create one PDF file, which is the default for this parameter. The value *YES will create multiple PDF files, when applicable, based on what is specified in the spooled file using the DDS keyword STRPAGGRP/ENDPAGGRP boundaries.

PDF data queue (PDFDTAQ) and Library
Specifies the name of the data queue and library where PSF/400 will log the IPDS to PDF transformation completion notifications. This parameter is optional; however, if a data queue is specified, it must exist before the PSF configuration object is created. The default is *NONE.

Sender of electronic mail (PDFSENDER)
Specifies from whom the electronic mail is coming. The sender must have a valid user profile and be entered in the system distribution directory. The default is *SPLFOWN where the owner of the spooled file sends the e-mail. The other options are QSPLJOB, where QSPLJOB sends the e-mail, or to specify the name or user profile that is the e-mail sender. Use the DSPPSFCFG command to check this field to ensure it is not blank. When changing the *PSFCFG object between PDFGEN(*STMF) and PDFGEN(*MAIL), this parameter can get blanked out. When this happens, the error messages in the joblogs tell you what the problem is.

PDF user program (PDFMAPPGM) and Library
Specifies the name and library of a mapping program that PSF/400 will call to resolve a mail tag to one or more electronic mail addresses. The options are:

o

*NONE. If a mapping program is not specified, PSF/400 assumes that the mail tag is a valid electronic mail address and will attempt to send the file using the information in the User-Defined Data (USRDFNDTA) parameter of the printer file or in the DDS STRPAGGRP parameter. A sample printer file override that could be used to test this function is: OVRPRTF FILE(QSYSPRT) USRDFNDTA('MAILTAG(user@domain.com)'). MAILTAG should be in uppercase letters. With this override in effect, a print screen can be done to generate a spooled file with this mail tag value.

o

User-mapping-program name. Specify the name of a valid user mapping program that will be used. When using a mapping program, the e-mail addresses returned must have single quotes around each address.

For the Library parameter, the valid options are:

o	*CURLIB. The current library is used to locate the user mapping program. If no library is specified as the current library for the job, the QGPL library is used.
o	library-name. Specify the name of the library where the user mapping program is located.

Refer to Chapter 6 of the User's Guide, for additional information on these parameters. Also refer to Appendices B and C for the parameters and examples of an e-mail mapping program. An RPG version of an e-mail mapping program can be found in Appendix E of the Printing VI redbook.

This example is not a complete view of the Create PSF Configuration (CRTPSFCFG) command and additional functions may be added with subsequent releases. When upgrading the OS/400 release level, use the Change PSF Configuration (CHGPSFCFG) command to review the new function to see if it may pertain to your environment.

Type the CRTPSFCFG command on the OS/400 command line, and press the F4 key to prompt the command. The screens will expand as you fill in the requested fields. Then, press the Enter key or F10. The completed Create PSF Configuration (CRTPSFCFG) screens will resemble the entries in the example below:

                      Create PSF Configuration (CRTPSFCFG)

PSF configuration  . . . . . . . > PDF2STMF      Name
  Library  . . . . . . . . . . . >   QGPL        Name, *CURLIB
User resource library list . . .   *JOBLIBL      *JOBLIBL, *CURLIB, *NONE
Device resource library list . .   *DFT          Name, *DFT
               + for more values
IPDS pass through  . . . . . . .   *NO           *NO, *YES
Activate release timer . . . . .   *NORDYF       *NORDYF, *IMMED...
Release timer  . . . . . . . . .   *NOMAX        1-1440, *NOMAX, *SEC15...
Restart timer  . . . . . . . . .   *IMMED        1-1440, *IMMED
APPC and TCP/IP retry count  . .   *NOMAX        1-99, *NOMAX
Delay between APPC retries . . .   90            0-999
Acknowledgment frequency . . . .   100           1-32767
Printer response timer . . . . .   *NOMAX        5-3600, *NOMAX
Generate PDF output  . . . . . . > *STMF         *NONE, *SPLF, *STMF, *MAIL
               + for more values
PDF device emulation type  . . . > *IP40240      *IP40240, *IP40300, *P4028...
PDF paper size drawer 1  . . . . > *LETTER       *LETTER, *LEGAL...
PDF paper size drawer 2  . . . . > *LETTER       *LETTER, *LEGAL...
Multiple PDF files:
  Acknowledge multiple groups  . > *NO           *NO, *YES
  Process option . . . . . . . .                 *SPLIT, *INDEX
PDF fonts inline . . . . . . . .   *YES          *YES, *NO
PDF data queue . . . . . . . . . > *NONE         Name, *NONE
  Library  . . . . . . . . . . .                 Name
PDF mail server name . . . . . .   *SNDDST
Sender of electronic mail  . . .   *SPLFOWN      Name, *SPLFOWN, QSPLJOB
PDF administrator  . . . . . . .
PDF user program . . . . . . . .   *NONE         Name, *NONE, *IBMPGM
  Library  . . . . . . . . . . .                 Name
PDF mapping object . . . . . . .   *NONE         Name, *NONE
  Library  . . . . . . . . . . .                 Name
PDF output queue . . . . . . . .                 Name
  Library  . . . . . . . . . . .                 Name
PDF directory  . . . . . . . . . > '/home/PDF'
Save AFP data  . . . . . . . . .   *NO           *NO, *YES
Text 'description' . . . . . . . > 'InfoPrint Server for PDF stream files'

The completed Create PSF Configuration (CRTPSFCFG) command is similar to the following:

CRTPSFCFG PSFCFG(QGPL/PDF2STMF) PDFGEN(*STMF) PDFDEVTYPE(*IP40240)
          PDFPPRDWR1(*LETTER) PDFPPRDWR2(*LETTER) PDFMULT(*NO)
          PDFDTAQ(*NONE) PDFDIR('/home/PDF')
          TEXT('InfoPrint Server for PDF stream files')

Create the device description with the Create Device Description (Printer) (CRTDEVPRT) command. Parameters not mentioned here can be left to the defaults, because they are used when printing to an actual printer. For more information on those parameters, refer to the following document:

N1010169: Configuring a *LAN IPDS Device Description

The following parameters must be specified when configuring a *LAN IPDS printer device description for use with InfoPrint Server:

Device description (DEVD)
This is the name of the printer device description to be created.

Device Class (DEVCLS)
This must be set to *LAN.

Device Type (TYPE)
This must be set to *IPDS.

Device Model (MODEL)
This must be set to 0.

LAN Attachment (LANATTACH)
This must be set to *IP.

Advanced Function Printing (AFP)
This must be set to *YES.

Port number (PORT)
This specifies the port number that the InfoPrint Server will use. The value to be specified is for a port number that is not in use by anything else. To determine a free port number, do: NETSTAT and select Option 3. Look for a port number that is not in the list.

Font (FONT) = 011
This is typically set to 011, which is the default 10 CPI font. A font ID is required to create the device description. Unless special requirements in your operation dictates something different, this should suffice.

Form Feed (FORMFEED)
This defaults to *TYPE, but should be set to *AUTOCUT to indicate cut sheet paper. Leaving this set at *TYPE, or setting it to *CONT or *CUT, can cause problems with paper size.

Remote Location (RMTLOCNAME)
This should be set to the Loopback address, and entered without leading zeros:
127.0.0.1.

User-Defined Object (USRDFNOBJ)
This defaults to *NONE, but should be set to the name of the PSF Configuration (PSFCFG) object that has been created for the InfoPrint Server. The Object type portion of this parameter needs to be set to *PSFCFG.

Type CRTDEVPRT (Create Device Description (Printer)) at the command line, and press the F4 key to prompt the command. The screens expand as you fill in the requested fields. Then, press the Enter key or F10. The completed Create Device Description (Printer) (CRTDEVPRT) screen is similar to the entries in the example below:

                      Display Device Description

Device class . . . . . . . . >   *LAN
Device type  . . . . . . . . >   *IPDS
Device model . . . . . . . . >   0
LAN attachment . . . . . . . >   *IP
Advanced function printing . >   *YES
Port number   .  . . . . . . >   5055  < - specify a port # that is not being used
Online at IPL  . . . . . . . :   *YES
Font:
  Identifier . . . . . . . . >   011
  Point size . . . . . . . . :   *NONE
Form feed  . . . . . . . . . >   *AUTOCUT
Separator drawer   . . . . . :   *FILE
 Separator program . . . . . :   *NONE
Printer error message  . . . :   *INFO
Message queue  . . . . . . . :   *CTLD
Current message queue  . . . :   QSYSOPR
  Library  . . . . . . . . . :     QSYS
Activation timer   . . . . . :   170
Image configuration  . . . . :   *NONE
Maximum pending requests . . :   6
Print while converting . . . :   *NO
Form definition  . . . . . . :   F1C10110
  Library    . . . . . . . . :     *LIBL
Character identifier . . . . :   *SYSVAL
Remote location:
   Name or address   . . . . >   127.0.0.1  < - use the Loopback TCP/IP address
User-defined object  . . . . >   PDF2STMF
   Library   . . . . . . . . :     QGPL
   Object type   . . . . . . :     *PSFCFG
Data transform program . . . :   *NONE
User-defined driver program  :   *NONE
Dependent location name  . . :   *NONE
Text 'description' . . . . . :   'InfoPrint Server for PDF stream files'

The completed Create Device Description (Printer) (CRTDEVPRT) command is similar to the following:

CRTDEVPRT DEVD(PDF2STMF)  DEVCLS(*LAN) TYPE(*IPDS) MODEL(0)
          LANATTACH(*IP) AFP(*YES) PORT(5055) FONT(11)
          FORMFEED(*AUTOCUT) PRTERRMSG(*INFO)
          RMTLOCNAME('127.0.0.1') USRDFNOBJ(QGPL/PDF2STMF *PSFCFG)
          TEXT('InfoPrint Server for PDF stream files')

This video shows an example of configuring a LAN IPDS Printer using Infoprint Server: