RECORD@

(Bytes 9–12)

 

A

pointer to the first byte of the index record, including the c

character.

The record resides in a 32KB buffer (where KB equals

The

buffer

resides

in storage allocated by ACIF, but the exit pr

to

modify

the index

record.

RECORDLN (Bytes 13–14)

Specifies the length, in bytes, of the index record. If the ind modified, this parameter must also be updated to reflect the act record.

REQUEST (Byte 15)

Specifies how the record is to be processed by ACIF. On entry t program, this parameter'00 '.is WhenX the exit program returns control to ACIF, this parameter must have the'00 ' valueor'01X',X where:

X '00 ' Specifies that the record be processed by ACIF.

X '01' Specifies that the record not be processed by ACIF.

A value of'00 'X on entry to the exit program specifies that the rec

processed. If you want to ignore the record,REQUEST changebyte valuthe to 'X01'. Any value greater'01than' is Xinterpreted'00 ',asandX the exit processes the record.

Note: Only one record can reside in the buffer at any time.

EOF (Byte 16)

Specifies an end-of-file (EOF) indicator. This indicator is a 1-byte code that signals when ACIF has finished processing the index objec

When EOF is signalled (EOF value = “Y”), the last record has alread presented to the index exit. The pointer RECORD@ is no longer valid. Records cannot be inserted when EOF is signalled. The following are valid values for this parameter:

Y Specifies that the last record has been written.

NSpecifies that the last record has not been written.

This end-of-file flag, used as a last call indicator, allows the exi return control to ACIF. The exit program cannot change this parameter

Output Record Exit

Using the

output record

exit,

you can modify

or ignore

the

records

the

output

document

file.

The

program

invoked

at

this exit is

defined

OUTEXIT

parameter.

 

 

 

 

 

 

 

 

The

exit

receives

control

before a

record

(structured

field)

is wri

document file. The exit program can request that the record be ignor processed. The largest record that the exit can process is 32 752 b including the record descriptor word. The exit is not called when ACI resources.

Figure 32 on page 127 contains a sample DSECT that describes the control passed to the exit program.

126 ACIF User’s Guide

Page 146
Image 146
IBM S544-5285-01 manual Output Record Exit