You can control how Infoprint XT processes jobs that have specific characteristics by using a custom parameter mapping file. Create a file with the name pdxtx2afp.map and then add entries that support the requirements of the installation. After you complete the entries, store the file in the /var/pdxt directory. Make sure that the group for the file is AIOUSER and that the file has 640 permissions. Table 1 shows the format of an entry in a mapping file.

The /usr/lpp/pdxt/V3R1M0/testjob/pdxtx2afp.map file is an example of a transform parameter mapping file. Do not modify the sample file in the testjob subdirectory. Table 1 shows the format of each entry in the file.

parameter
parameter

Use one of these as the keyword: class, dest, forms, jobid, or jobname. You can also use a special keyword and value pair, *=*, to apply parameters to every job. *=* specifies that any keyword and value pair is a match; Infoprint XT applies the associated parameters to every job that it processes.

You can assign the -g, -r, -t, and -x options. These options correspond to a subset of the processing parameters that you can specify with the AIOZ2AFP utility program, or that you specify through Infoprint Server filter options. See AIOZ2AFP parameters, and Options for the DLL transform filter for more information.

These rules apply to the parameter mapping file:

• You must use lowercase keyword names in the mapping file: class, dest, forms, jobid, or jobname.
• The values for the keywords are case-sensitive. For example, prt1 and PRT1 are two distinct values.
• You can use asterisks and question marks as wildcard characters for keyword values. You can also use brackets to specify ranges of characters:
  • To specify all jobs whose names begin with ORB:

    jobname=ORB*

  • To specify all jobs with a destination of PRT, followed by any three characters:

    dest=PRT???

  • To specify all jobs with a class value of any single character from A through M:

    class=[A-M]

• You cannot use wildcard characters or regular expressions to define the keyword to match. For example, job* is not valid for matching both the jobid and jobname keywords.
• Infoprint XT ignores blank lines and comment lines. Lines that begin with a number sign, #, are comments.
• All keyword=value pairs must start in column one. The expression must include the equal sign, =, and the expression cannot contain spaces.
• Parameter lines cannot start in column one; use at least one space before the parameter.
• When a keyword match occurs, Infoprint XT applies all the parameter lines that follow, up to the next keyword line or the end of the file.
• You cannot include comments on keyword lines or parameter lines.
• Two or more keywords on a single line represent an and condition. Jobs must match all keywords to use the associated parameters.
• Two or more keywords on separate lines represent an or condition. Jobs can match any one of the keywords to use the associated parameters.
• Infoprint XT checks each keyword group in the file. If a job matches more than one keyword group, the job can use parameters from each group it matches.

  For the -g, -r, and -t options, if the job matches several keywords groups that specify the same parameter, Infoprint XT uses the value from the last group.

  For the -x option, Infoprint XT merges the conversion parameters from all matched keyword groups into the final pdxtx2afp command. For example, if one matched keyword group specifies -x xcopies=5 and another specifies -x xclb=pay1, Infoprint XT includes both xcopies and xclb in the final command. If more than one matched keyword group specifies the same parameter, for example -x xjdl=strton and -x xjdl=dpljdl, Infoprint XT uses the last value.

Figure 1 is an example of a completed parameter mapping file.

#-----------------------------------------------------#
#  Set the default for all jobs that do not match any #
#  other criteria                                     #
#-----------------------------------------------------#
*=*
  -x'xjde=base xjdl=base1'

#-----------------------------------------------------#
#  Set parameters for FORMS=STD and CLASS=K jobs      #
#-----------------------------------------------------#
forms=STD class=K
  -x'xjde=std xjdl=dpljdl'

#-----------------------------------------------------#
#  Set parameters for FORMS=RED or CLASS=J jobs       #
#-----------------------------------------------------#
forms=RED
class=J
  -x'xjde=pay1 xjdl=bills'

#-----------------------------------------------------#
#  Set parameters for DEST=PRT17                      #
#-----------------------------------------------------#
dest=PRT17
  -x'xjde=strt xjdl=prt17'

#-----------------------------------------------------#
#  Set parameters for payroll jobs                    #
#-----------------------------------------------------#
jobname=PAYROLL
  -x'xjde=strt xjdl=prt17'

#---------------------------------------------------#
# Class D jobs, class E jobs, or any jobs whose     #
# names starts with INV use resources from          #
# /var/pdxt/resources/inventory.                    #
#---------------------------------------------------#
class=D
class=E
jobname=INV*
   -g inventory 

#---------------------------------------------------#
# Jobs whose names start with PAY* use AFP          #
# resources in the /pay/secure/monthly directory    #
#---------------------------------------------------#
jobname=PAY*
   -r /pay/secure/monthly

Infoprint XT merges transform parameters from the transform parameter mapping file with parameters specified with the submitted job. If both the mapping file and the parameters specified with the job specify the same transform parameter, Infoprint XT uses the value from the parameters specified with the job.