Creating the Map Object and Map Entries

1. CRTPDFMAP QGPL/MYMAPOBJ
2. WRKPDFMAPE QGPL/MYMAPOBJ
3. A Work With PDF Map Entries screen will be displayed:



To add an entry, set the Option to 1, the Sequence Number to a number, and Segmented to *NO. (You can have entries that let you handle different segments of a spooled file differently; however, that is not covered in this document.) Press Enter.

4. An Add PDF Map Entry screen will be displayed:



This is where you set the selection criteria. For instance, if you want the system to use this entry to work on spooled files with a name of MYSPLF, you would set Spooled File to MYSPLF. If you want this entry to work for any spooled file, you would leave all of the selection criteria set to *ALL. Once you are done setting the selection criteria, press Enter. (Note: If you set the Output Queue to a specific output queue here, in order for this entry to be used, the writer would have to be started to that specific output queue.)

5. A Define PDF Map Action for Spooled File screen will be displayed:

Sequence number . . . . . :   10  
Segmented entry . . . . . :   *NO
Text  . . . . . . . . . . :      
                                 
Type options, press Enter.        
                                 
PDF map actions:                  
  Mail  . . . . . . . . .   *NO  
  PDF spooled file  . . .   *NO  
  AFP spooled file  . . .   *NO  
  Stream file . . . . . .   *NO  

This is the first screen where you would define what you want to happen to the resulting PDF file. For instance, if you want it to be e-mailed, set Mail to *YES. If you want it to be e-mailed and also to have a copy archived in an IFS directory, you would set Mail to *YES and Stream File to *YES. When done here, press Enter.

6. An Add PDF Map Entry screen will be displayed. It will contain parameters related to the PDF map action you selected on the previous screen. You can use F1 while your cursor is on any of the given parameters in order to get more detail on what valid values would be. The default values of *PSFDFT, *PSFCFG, and *SPLF have the following meanings: *PSFDFT – value is assigned from Infoprint Server, *PSFCFG – value is assigned from the PSFCFG object settings, *SPLF – value is assigned from the spooled file’s attributes.

A. For PDF map action Mail *YES, you get the following parameters:

To e-mail addresses . . .          
Subject . . . . . . . . .   *PSFDFT
Message text  . . . . . .   *PSFDFT
CC e-mail addresses . . .  
BCC e-mail addresses  . .              
ReplyTo e-mail address      *MAILSENDER
Mail sender . . . . . . .   *PSFCFG    
PDF file name . . . . . .   *PSFDFT (limited to 10 characters if using
                            *SNDDST for the PDF Mail Server in the PSFCFG object)
E-mail body:       *NONE
E-mail attachments:  *NONE
Master password . . . . .   *NONE
User password . . . . . .   *NONE
Encryption level  . . . .   *NONE

Some of the parameters (CC e-mail addresses, BCC e-mail addresses, ReplyTo e-mail addresses, E-mail body, and E-mail attachments) are only usable if you are specifying an SMTP mail server for the PDF Mail Server in your PSFCFG object.


B. For PDF map action PDF Spooled File *YES, you get the following parameters:

PDF spooled file:                    
  Output queue . . . . . . .   *PSFCFG
    Library  . . . . . . . .          
  Spooled file . . . . . . .   *SPLF  
  User data  . . . . . . . .   *SPLF  
  Form type  . . . . . . . .   *SPLF  
  User-defined data  . . . .   *SPLF  

C. For PDF map action AFP Spooled File *YES, you get the following parameters:

AFP spooled file:                      
  Output queue . . . . . . .   *PSFCFG  
    Library  . . . . . . . .            
  Spooled file . . . . . . .   *SPLF    
  User data  . . . . . . . .   *SPLF    
  Form type  . . . . . . . .   *SPLF    
  User-defined data  . . . .   *SPLF    

D. For PDF map action Stream File *YES, you get the following parameters:

PDF stream file:                        
  Stream file  . . . . . . .            
  Public authority . . . . .   *EXCLUDE

Press Enter.

7. Repeat Steps 3 through 6 until you have all of the mapping entries you need. The system will go through these entries according to their sequence number. The spooled file will use the first mapping entry it encounters where it fits the selection criteria. (Note: The last mapping entry in the sequence should be a catch-all, meaning it should have all of its selection criteria set to *ALL. The catch-all entry is meant to handle any spooled file that has already filtered through all the previous mapping entries.)

Using the Mapping Object

1. Make sure the writer for the Infoprint Server LAN *IPDS device you want to use is ended. (ENDWTR writer_name) A working Infoprint Server LAN *IPDS device will already have a PSFCFG object created and referenced in the device description as the User Defined Object.

2. CHGPSFCFG psfcfg_object_name
a. Set PDF User Program to *IBMPGM
b. Set PDF Mapping Object to the name of the mapping object you created. You need to specify the library it is in, as well.

3. Press Enter.

The next time you restart the writer to your Infoprint Server LAN *IPDS device, your mapping object will be in use.

Changing the Entries in an Existing Mapping Object

1. End the writer for any Infoprint Server LAN *IPDS device that uses that mapping object.
2. WRKPDFMAPE map_object_name
3. Take option 2 on any map entries you want to change.

This video provides a walkthrough of the PDFMAP creation and usage process.

Useful References

For more detailed information on creating and using Infoprint Server map objects, see the following references:

Infoprint Server for iSeries User's Guide (G544-5775-05) publication:

Additional publications: