Printing PCL/PDF/PS through AFP Transform to an IPDS Printer

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. Therefore, you will also have to add your license key you received with the product. If you are converting PDF or PostScript data, you need a license for option 5722IP1 5101 as well as a license for the base product. It is recommended to apply all the latest PTFs for Advanced Function Printing (AFP) and Infoprint Server. Refer to the following Rochester Support Center knowledgebase documents: V5Rx PTF Listing for AFP Printing (PSF/400): N1019035, V5Rx PTF Listing for Infoprint Server:
o	Verify that the QIPSJOB User Profile exists. This should be created when you install Infoprint Server, but in some situations, you may need to manually create it. If it does not exist, make sure that you have all the latest Infoprint Server PTFs applied. If it still does not exist, then run the following command: CRTUSRPRF USRPRF(QIPSJOB) PASSWORD(*none) PWDEXP(*NO) STATUS(*ENABLED) USRCLS(*USER) + ASTLVL(*SYSVAL) CURLIB(*CRTDFT) INLPGM(*NONE) INLMNU(*LIBL/MAIN) LMTCPB(*NO) + TEXT('Infoprint Server User Profile') SPCAUT(*NONE) SPCENV(*NONE) DSPSGNINF(*SYSVAL) + PWDEXPITV(*SYSVAL) LMTDEVSSN(*SYSVAL) KBDBUF(*SYSVAL) MAXSTG(*NOMAX) PTYLMT(0) + JOBD(*LIBL/QDFTJOBD) GRPPRF(*NONE) OWNER(*USRPRF) GRPAUT(*NONE) GRPAUTTYP(*PRIVATE) + SUPGRPPRF(*NONE) DOCPWD(*NONE) MSGQ(*USRPRF) DLVRY(*NOTIFY) SEV(0) PRTDEV(*WRKSTN) + OUTQ(*WRKSTN) ATNPGM(*SYSVAL) SRTSEQ(*SYSVAL) LANGID(*SYSVAL) CNTRYID(*SYSVAL) + CCSID(*SYSVAL) CHRIDCTL(*SYSVAL) SETJOBATR(*SYSVAL) LOCALE(*SYSVAL) USROPT(*NONE) + UID(*GEN) GID(*NONE) HOMEDIR(*USRPRF) AUT(*EXCLUDE) Then call the following program to properly set QIPSJOB ownerships. CALL PGM(QIPS/QIPSCHGOWN)
o	Create the Work Directory. You must create the work directory with the proper authorities for Transform Manager to work properly. Create this path on your system with the specified owner and permissions: /QOpenSys/QIBM/UserData/InfoprintServer/Transforms/work Directory         Owner     Permissions InfoprintServer   QIPSJOB   755 Transforms        QIPSJOB   755 work              QIPSJOB   700 Make sure the work directory is empty.
o	Configure the Transform Manager. Complete instructions on this step are provided in User's Guide.
o	Start the Transform Manager with the command STRTFMMGR. (To end the Transform Manager, you can run ENDTFMMGR.)

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. 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 the PS/PDF/PCL to AFP Transform function of Infoprint Server:

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

Release timer (RLSTMR)
This parameter is actually optional, but if your printer is network attached, you will probably want to use it. RLSTMR shows the amount of time to wait after the last page of the last ready spooled file has printed. PSF/400 does not terminate, but releases the connection with the printer so that the printer can be shared by other computers on the network. It is recommended to set this parameter to *SEC15.

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

Type the CRTPSFCFG command on the operating system 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  . . . . . . . > PDF2AFP       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  . . . . . . . . . > *SEC15        1-1440, *NOMAX, *SEC15...
Restart timer  . . . . . . . . .   *IMMED        1-1440, *IMMED            
APPC and TCP/IP retry count  . .   15            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  . . . . . .   *NONE         *NONE, *SPLF, *STMF, *MAIL

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

CRTPSFCFG PSFCFG(QGPL/PDF2AFP) RLSTMR(*SEC15)

To configure an *IPDS device description, use the Create Device Desc (Printer) (CRTDEVPRT) command. Most IPDS printers are connected to a network, so this example is for a DEVCLS(*LAN) device:

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

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

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

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

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

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

Port number (PORT)
This specifies the port number that the LAN-attached printer or LAN print server is expecting for PJL (or Reverse TELNET) data. The port number is hardware specific, but is typically set to one of the following:

Note: If this document does not list an IPDS port number value for your printer hardware, consult the manufacturer of your printer and/or print server to determine if they have a dedicated port for IPDS commands. If they provide you with a IPDS port number value that works, please contact the Rochester Support Center at 1-800-IBM-SERV and select the appropriate option so this information can be added to document New.

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 requirement in your operation dictate something different, this should suffice.

Form Feed (FORMFEED)
This defaults to *TYPE, but should be set to *AUTOCUT to indicate that the printer automatically feeds cut sheet paper. Leaving this set at *TYPE or setting it to *CONT or *CUT can cause problems with both drawer selection and paper size.

Message queue (MSGQ)
This defaults to *CTLD, which indicates the message queue defined in the attached controller. There is no attached controller for *LAN printer device descriptions, so leaving the Message queue (MSGQ) parameter set to *CTLD will in affect set it to the QSYSOPR message queue in library QSYS. If another message queue is to be used for this particular printer device, verify that the message queue exists before entering the message queue and library in the MSGQ parameter. Otherwise, the CRTDEVPRT command will fail with message CPF2799 - Message queue &1 in library &2 not found.

Activation Timer (ACTTMR)
This defaults to 170 (seconds), but can be set to any value from 1 to 2550 seconds (or 42.5 minutes). The activation timer refers to the amount of time to wait for the LAN-attached printer device to respond. The printer device is considered not available, and an error message is posted if there is no connection before this timer expires.

Image configuration (IMGCFG)
This defaults to *NONE, and needs to be changed to enable the PCL/PDF/PS to AFP Transform. Set it to match your printer type. While there are many options, you must use one that begins with *IMGC, which are the AFP type printers:

*IMGC02     IPDS 300-dpi printer                    
*IMGC03     IPDS 600-dpi printer                    
*IMGC06     IPDS 300-dpi printer w/no-print border  
*IMGC07     IPDS 600-dpi printer w/no-print border  

Remote Location (RMTLOCNAME)
This should be set to the printer's TCP/IP address, host name, or DNS name. If a TCP/IP address is used, it should be entered without leading zeros (for example, use 192.186.10.2 rather than 192.186.010.002). If a TCP/IP address is used, verify that the operating system can reach the printer by using either the PING or Verify TCP/IP Connection (VFYTCPCNN) command with that TCP/IP address. If a host name or DNS name is used, verify that the operating system can reach the printer by using either the PING or Verify TCP/IP Connection (VFYTCPCNN) command with that host name or DNS name.

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 this printer. The Object type portion of this parameter must be set to *PSFCFG.

All other parameters should be specified like any other printer.

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: