Activating transform directives

Several methods exist for activating Infoprint XT transform directives. Infoprint XT checks for an environment variable first and for a directives file second. If you enter the pdxtx2afp command directly, Infoprint XT then checks for the -t command option.

PDXTX2AFP_DIRECTIVES environment variable

You can set the PDXTX2AFP_DIRECTIVES environment variable through the various methods. For example, you can add it to the /etc/profile file or to the /var/pdxt/pdxt.cfg file. Where you add the environment variable can affect which Infoprint XT functions can access it. If you specify the environment variable in the /var/pdxt/pdxt.cfg file, the transform directives are only available to the AIOZ2AFP utility program. However, the transform directives that you specify are available to any user ID that runs the utility programs. If you use Infoprint Server, you must specify the environment variable when you define the Infoprint XT x2afpd transform daemon. For Infoprint Server, these environment variables are specified in x2afp transform entries in /etc/Printsrv/aopxfd.conf. These examples show the format that you use to specify directives through the environment variable:

PDXTX2AFP_DIRECTIVES='-x xztrace=all1:all2'

PDXTX2AFP_DIRECTIVES='-t x2afp.out -k1'

/var/pdxt/pdxtx2afp.directives file

This is a plain, z/OS UNIX text file that contains the transform directives. You can include comments and blank lines in the file. Delimit comments with a pound sign, #. You must include a destination name, followed by a colon, for each directive in the file. You can also use *: as a destination, which indicates that the directive applies to all job destinations. When you submit the job by using JCL, Infoprint XT uses the value of the DEST parameter for the destination.

These examples show the types of entries that you can make in the transform directives file:

#-----------------------------------------------#
# For all destinations, pass an argument to the #
# transform input application exit.             #
#-----------------------------------------------#
*: -e 'aioxlxoe OFFSET_ALTBIN'

#------------------------------------------------#
# Capture and keep the AFP output for all jobs   #
# with a destination of PRT01.                   #
#------------------------------------------------#
PRT01: -t x2afp.out -k1

After you create the pdxtx2afp.directives file in the directory, make sure that the group for the file is AIOUSER and that it has 640 permissions. For example:

-rw-r-----  1 XTUSER AIOUSER  94 Apr 01 16:47 pdxtx2afp.directives

You can use the z/OS UNIX chgrp and chmod commands, as necessary, to set the group and the permissions.

-t parameter of the AIOZ2AFP utility program

You can include transform directives when you submit JCL to batch process a Xerox job. See AIOZ2AFP parameters.

-t filter option in a combined Infoprint XT and Infoprint Server installation

You can include transform directives when you define the x2afpd daemon in the aopxfd.conf transform daemon configuration file. You can also specify it in a transform parameter mapping file, the %filter-options attribute of a printer definition, or the filter-options job attribute in JCL. See: