Setting up a transform input application exit

Infoprint XT provides a transform input application exit, aioxlxie for modifying the input data stream of the Xerox job before the data stream conversion process. The aioxlxie transform input application exit lets you convert several different input data formats into the format that Infoprint XT expects for online Xerox jobs. The data stream conversion process converts the job to AFP.

The aioxlxie application exit works with the pdxtx2afp command to process UNIX System Services hierarchical file system (HFS) or z/OS® File System (zFS) input files. However, the shipped version of aioxlxie is not designed to work with the AIOZ2AFP utility program or the x2afp.dll transform filter in Infoprint Server to process input files that are received from MVS™ data sets.

Infoprint XT passes these options to the application exit:

-e arguments

Specifies any application exit arguments specified with the -e transform directive. For more information, see Transform directives and syntax.

The syntax for the aioxlxie is:

aioxlxie -e [ NONE ] [ RECFM = V | VB | VI ]
            [ BARR = SPOOL | TBV | S370 | METABAR2 | COMPUSET | METABAR3 |
                     VM | VBM ]
            [ CRLF = [ a | e ] [ c ] [ t ] [ :i = a | e | s ]]

The default value is:

NONE: aioxlxie reads from standard input and writes to standard output with no changes to the data stream.

The remaining parameters describe variable length formats of the input data stream:

RECFM=V

Unblocked, variable-length records; records are delimited by record descriptor words.

RECFM=VB

Blocked, variable length records; blocks are delimited by block descriptor words; records are delimited by record descriptor words.

RECFM=VI

Unblocked, variable length records; records are delimited by 4-byte length fields. The first two bytes of each length field indicate the length, in little-endian format, of the logical record. The length values do not include the 4 bytes of the length field.

BARR=SPOOL

Barr Systems SPOOL format.

BARR=TBV

Barr Systems S370 | METABAR2 | COMPUSET or METABAR3 format; aioxlxie automatically determines which format is used and invokes the appropriate exit function.

BARR=S370

Barr Systems S370 format.

BARR=METABAR2

Same as BARR=S370.

BARR=COMPUSET

Same as BARR=S370.

BARR=METABAR3

Barr Systems METABAR3 format.

BARR=VM

Same as RECFM=V.

BARR=VBM

Same as RECFM=VB.

CRLF=[ a | e ] [ c ] [ t ] [ :i=a | e | s ]

Input records are delimited by ASCII carriage returns (X'0D') and line feeds (X'0A'):

a

Generated ANSI carriage control characters are ASCII.

e

Generated ANSI carriage control characters are EBCDIC; if you specify CRLF=c, this is the default.

c

aioxlxie generates ANSI carriage control characters.

t

aioxlxie translates the output from ASCII to EBCDIC.

:i

Input data type. If specified, this must be the last CRLF flag. Valid values are:

a: ASCII input data; this is the default.
e: EBCDIC input data.
s: iSeries SCS (SNA Character String) input data.

METABAR and METASPUR formats are the same as CRLF.

-j jobname-jobID-n

The -j command option passes the job identifier to the application exit. Infoprint XT automatically derives the jobname and jobID values, and assigns a unique sequence number, n. If Infoprint XT is unable to derive the job name and job ID, it passes UNKNOWN-UNKNOWN-n as the job identifier.

-p passthru_values

Specifies the same values that the -p option for the job specifies, if it is present. See Using the pdxtx2afp command to process jobs.

-s submit_method

Specifies the job-submission method, where submit_method is:

infoprint: Infoprint Server initiated the transform.
pdxtx2afp: The pdxtx2afp command initiated the transform.
AIOZ2AFP: AIOZ2AFP utility program initiated the transform.

-q dest

Specifies the destination for the job.

-x transform_options

Specifies all the conversion parameters that Infoprint XT uses when it converts the Xerox job to AFP. The set of conversion parameters can contain more than one occurrence of a specific parameter. In this case, Infoprint XT uses the value for the last occurrence of the parameter.

Note: The application exit must ignore any command options passed to it that it does not recognize. Infoprint XT can then add command options without impacting a customized application exit.