# comments
transform x2afp[_transformclass ]
    start-command = /path/command
    environment  = {
      EnvironmentVariable ->       value
      [EnvironmentVariable ->       value ]...
      }
    [ maximum-active = number ]
    [ maximum-idle-time = seconds ]
    [ minimum-active = number ]
;

You can edit or create entries with these attributes:

# comments

You can specify one or more lines of comments that describe the transform entry. You can also add comments in the middle of a line. Begin each comment with a pound sign, #.

transform x2afp[_transformclass]

This specifies the Infoprint XT transform name and, optionally, the transform class. You must include this required attribute, and it must be the first attribute in the transform definition.

The value for transformclass can contain from one to 63 characters. You can use letters, numbers, and special characters in the value. Transform entry examples show examples of specifying a transformclass.

start-command = /path/command

For detailed information about how to specify the required start-command attribute, see x2afpd daemon command syntax.

environment = { EnvironmentVariable -> 'value'}

This attribute specifies both operating system environment variables, and Infoprint XT environment variables that define the transform environment. Infoprint Server does not invoke Infoprint XT with the environment settings that the z/OS /etc/profile file specifies, or that other system locations specify. Therefore, you must include the operating system environment variables with the environment attribute, or unpredictable errors can occur.

You must specify these operating system environment variables enclosed in braces:

PATH

Specify all necessary paths so that your environment variable resembles this: /usr/lpp/pdxt/V3R1M0/local:/usr/lpp/pdxt/V3R1M0/bin:/usr/lpp/Printsrv/bin:/bin.

TZ

This environment variable specifies the standard time zone for your locale, which is the number of hours offset from Coordinated Universal Time (UTC). The value might also include the daylight savings time zone.

Notes:

1. Enclose the paths in quotation marks.
2. For more details about transform entries, see "Steps for creating the transform configuration file" in z/OS Infoprint Server Customization.
3. If you update the NLSPATH specification in the aopstart command to include the Infoprint XT message catalog paths, you do not need to also specify NLSPATH in x2afp transform entries.

The Infoprint XT environment variables that you can specify include:

PDXTWORKDIR

See Controlling the working directory that Infoprint XT uses for variable data (PDXTWORKDIR).

PDXTX2AFP_ARGS

See Controlling the default arguments when you process jobs (PDXTX2AFP_ARGS).

PDXT_INTMSGIDS

See Controlling the content of error messages (PDXT_INTMSGIDS).

PDXTX2AFP_DIRECTIVES

See Controlling access to the pdxtx2afp transform directives (PDXTX2AFP_DIRECTIVES).

_BPX_JOBNAME

See Controlling the job name to each class of transform daemon (_BPX_JOBNAME).

maximum-active = number

The maximum number of transform daemons that the Transform Manager activates concurrently. Specify a number greater than 0 and greater than or equal to the number specified in the minimum-active attribute. For more information, see "Format of a transform entry" in z/OS Infoprint Server Customization.

Default: No maximum number. Transform daemons are started when needed.

maximum-idle-time = seconds

The number of seconds before the Transform Manager shuts down an idle transform daemon and system resources are freed. Specify a number greater than 0. For more information, see "Format of a transform entry" in z/OS Infoprint Server Customization.

Default: Transform Manager does not shut down idle transform daemons.

minimum-active = number

The minimum number of transform daemons that the Transform Manager activates concurrently. Specify a number less than or equal to the number specified in the maximum-active attribute. For more information, see "Format of a transform entry" in z/OS Infoprint Server Customization.

Default: minimum-active = 0