IBM Support

Configuring an Infoprint Server *IPDS Device Description

Troubleshooting


Problem

This document is meant to serve as a quick guide to help configure an *IPDS device description and *PSFCFG object to implement a PDF transform.

Resolving The Problem


The PDF transform function of IBM Infoprint Server allows users to transform spooled files into Adobe PDF format and do one of the following things with the resulting file:
  • Place the file on an output queue.
  • Place the file in a folder in the Integrated File System.
  • Send the file as an email attachment.

Step 1: Configure the PSFCFG object.

To configure a PSFCFG object to place PDF files on an output queue, in an Integrated File System directory, or to email as a PDF attachment, do one of the following:
*
Configure a PSFCFG object to place PDF files on an output queue.

To set up a PSFCFG object to place PDF files on an output queue, on the operating system command-line type CRTPSFCFG and press F4. Complete the following parameters:

PSF configuration . . . . . . . > MYPSFCFG Name
Library . . . . . . . . . . . > MYLIB Name, *CURLIB
APPC and TCP/IP retry count . . > *NOMAX 1-99, *NOMAX
Generate PDF output . . . . . . > *SPLF *NONE, *SPLF, *STMF, *MAIL
PDF device emulation type . . . > *IP40300 *IP40240, *IP40300, *P4028...
PDF paper size drawer 1 . . . . *LETTER *LETTER, *LEGAL...
PDF output queue . . . . . . . . >MYPDFOUTQ Name
Library . . . . . . . . . . . > MYOUTQLIB Name
Text 'description' . . . . . . . > 'Place PDF file on outq MYOUTQLIB/MYPDFOUTQ'
*
Configure a PSFCFG object to place PDF files in an Integrated File System directory.

To set up a PSFCFG object to place PDF files in an Integrated File System directory, on the operating system command-line type CRTPSFCFG and press F4. Complete the following parameters:

PSF configuration . . . . . . . > MYPSFCFG Name
Library . . . . . . . . . . . > MYLIB Name, *CURLIB
APPC and TCP/IP retry count . . > *NOMAX 1-99, *NOMAX
Generate PDF output . . . . . . > *STMF *NONE, *SPLF, *STMF, *MAIL
PDF device emulation type . . . > *IP40300 *IP40240, *IP40300, *P4028...
PDF paper size drawer 1 . . . . *LETTER *LETTER, *LEGAL...
PDF directory . . . . . . . . > __________ Name (for example: /home/clarkd)
Text 'description' . . . . . . . > 'Place PDF file in IFS directory'


Notes:
1. To place PDF files in an Integrated File System directory, the root directory should be shared.

2. QSPLJOB should have *RWX access to each directory in the file path. ('/' is considered the root directory.) You can access these by doing WRKLNK /. Select Option 9 on the directory to work with the authorities. Add QSPLJOB with *RWX authority if it is not there. Display subdirectories of / by selecting Option 5 on it.
* Configure a PSFCFG object to email spooled files as PDF attachments.

To set up a PSFCFG object to email spooled files as PDF attachments, on the operating system command-line type
CRTPSFCFG and press F4. Complete the following parameters:

PSF configuration . . . . . . . > MYPSFCFG Name
Library . . . . . . . . . . . > MYLIB Name, *CURLIB
APPC and TCP/IP retry count . . > *NOMAX 1-99, *NOMAX
Generate PDF output . . . . . . > *MAIL *NONE, *SPLF, *STMF, *MAIL
PDF device emulation type . . . > *IP40300 *IP40240, *IP40300, *P4028...
PDF paper size drawer 1 . . . . *LETTER *LETTER, *LEGAL...
PDF mail server name . . . . . > *SNDDST Name, *SNDDST
Sender of electronic mail . . . > *SPLFOWN Name, *SPLFOWN, QSPLJOB
Text 'description' . . . . . . . > 'Email file as a PDF attachment'


Notes:
1. For this to work, the spooled file sender must have a directory entry. If the PDF mail server is an SMTP server (the PDF mail server name is something other than *SNDDST), then the spooled file sender's directory entry must also contain SMTP information. You can determine if there is a directory entry by typing WRKDIRE and looking through the resulting list for the spooled file owner's name. You can verify the SMTP information by selecting Option 5 on the name and then pressing F19 (shift + F7). To add a directory entry, refer to the section Adding a Directory Entry at the end of this document.

2. If using QSPLJOB as the sender of electronic mail, there must be a directory entry for QSPLJOB, and QSPLJOB must have authority to the root and /PSF400 directories. To verify these, type WRKLNK / and select Option 9. Add QSPLJOB with *RWX authority, if necessary. Then F12 back, select Option 5 on /, and look through the subdirectory list for PSF400. Verify it by selecting Option 9. Again, add QSPLJOB with *RWX authority, if necessary.

Step 2: Configure the device description.

To configure the device description, on the operating system command-line type CRTDEVPRT and press F4. Complete the following parameters:
Device description . . . . . . . > MYPDF Name
Device class . . . . . . . . . . > *LAN *LCL, *RMT, *VRT, *SNPT, *LAN
Device type . . . . . . . . . . > *IPDS 3287, 3812, 4019, 4201...
Device model . . . . . . . . . . > 0 0, 1, 2, 3, 4, 10, 13, 301...
LAN attachment . . . . . . . . . > *IP *LEXLINK, *IP, *USRDFN
Advanced function printing . . . > *YES *NO, *YES
Port number . . . . . . . . . . > _________ 0-65535 (for example, 19220)
Online at IPL . . . . . . . . . *YES *YES, *NO
Font:
Identifier . . . . . . . . . . > 11 3, 5, 11, 12, 13, 18, 19...
Point size . . . . . . . . . . *NONE 000.1-999.9, *NONE
Form feed . . . . . . . . . . . > *AUTOCUT *TYPE, *CONT, *CONT2, *CUT...
Remote location:
Name or address . . . . . . . > '127.0.0.1'
User-defined object:
Object . . . . . . . . . . . . > MYPSFCFG Name, *NONE
Library . . . . . . . . . . > MYLIB Name, *LIBL, *CURLIB
Object type . . . . . . . . . > *PSFCFG *DTAARA, *DTAQ, *FILE...
Text 'description' . . . . . . . > 'Device using PDF transform'

Notes:
1. The Port Number should be a port that is unused on the system. To determine which ports are being used, type NETSTAT, press the Enter key, and select Option 3. Press F14, and then look through the list to ensure your potential port number is not being used. The Local Port column should be used to determine if the port number is in use.
2. The Remote location parameter uses the Loopback address of the system: 127.0.0.1.
3. The User-defined object is the name and library of the PSFCFG object created in Step 1.

Step 3: Test the configuration.

To test the configuration, do the following:
a Vary on the device description. On the operating system command line type the following:

VRYCFG device_name *DEV *ON

where device_name is the name of the device description created in Step 2. Press the Enter key.
b Start the writer. On the operating system command line type the following:

STRPRTWTR device_name

where device_name is the name of the device description created in Step 2. Press the Enter key.
c Test by doing one of the following:

o Place a spooled file in the printer device's output queue and release it.

o Use System i Navigator to find the file, then right-click on it and choose "Convert to PDF." A window will open. Select what you want to do with the spooled file. Complete the corresponding information in this subsection (for example, if you want to email the file, then specify the email address in the text box.) Choose the printer and output queue to be used.

Adding a Directory Entry

The following is an example of how to add a directory entry for QSPLJOB for a system called RCHAS4PR.

On the operating system command line type ADDDIRE and press F4. Complete the following parameters:

User identifier:
User ID . . . . . . . . . . . > QSPLJOB Character value
Address . . . . . . . . . . . > RCHAS4PR Character value
User description . . . . . . . . > QSPLJOB
User profile . . . . . . . . . . > QSPLJOB Name, *NONE
System name:
System name . . . . . . . . . > RCHAS4PR Character value, *LCL, *PC...


Press the Enter key.

Adding SMTP Information to a Directory Entry

The following is an example of adding SMTP information to a directory entry called MYTEST, whose email address is [email protected].

On the operating system command line type WRKDIRE and find the correct entry in the list. For this example, it is MYTEST. Select Option 2. Press F19 (or shift + F7). Complete the following parameters:


SMTP user ID . . . . . . > mytest (This is the user part of the email address.)
SMTP domain . . . . . . . > US.IBM.COM (This is the domain part of the email address.)


Press the Enter key.


This video shows how to configure Infoprint Server to convert spooled files to PDFs and store them in the IFS.

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"6.1.0"}]

Historical Number

399896086

Document Information

Modified date:
03 November 2021

UID

nas8N1015196