Output record exit

Using the output record exit, you can modify or ignore the records ACIF writes into the output document file. The program that is run by this exit is defined by the OUTEXIT parameter.

The exit receives control before a record (structured field) is written to the output document file. The exit can request that the record is ignored or processed. If the record is ignored, ACIF does not write it to the output document file. The largest record that the exit can process is 32752 bytes, not including the record descriptor word. The exit is not called when ACIF is processing resources.

AIX or Windows sample output record exit C language header contains a sample C language header that describes the control block that is passed to the AIX or Windows exit program.

typedef struct _OUTEXIT_PARMS/*Parameters for the output record exit      */
{
   char           *work;     /*Address of 16-byte static work area        */
   PFATTR         *pfattr;   /*Address of print file attribute information*/
   char           *record;   /*Address of the record to be written        */
   unsigned short recordln;  /*Length of the output record                */
   char           request;   /*Delete or process the record               */
   char           eof;       /*Last call indicator                        */
} OUTEXIT_PARMS;

The address of the control block that contains the following parameters is passed to the output record exit. For AIX and Windows, the address is passed by the first parameter.

work(Bytes 1–4)

A pointer to a static, 16-byte memory block. The exit program can use this parameter to save information across calls (for example, pointers to work areas). The 16-byte work area is aligned on a fullword bound