length of the record, ACIF considers the comparison “false” and processing.

EXAMPLE

 

The

following example illustrates the use of a carriage control

a

trigger.

 

TRIGGER1=\,1,X'F1'

/\ Look for Skip-to-Channel 1

TRIGGER2=ð,5ð,'ACCOUNT:'

/\ Find account number

TRIGGER3=3,75,'PAGE 1'

/\ Find page 1

In this example, TRIGGER1 instructs ACIF to scan every record, lookin the occurrence'F1of' inX the first byte. After ACIF locates a re

containing

the'F1 'X, it looks

in

the

same

record,

starting

at

byte

the occurrence of 'ACCOUNT:'. If

 

'ACCOUNT:'

is

found,

ACIF

looks

at

third record down for a value

of 'PAGE 1', starting at byte 7

found, ACIF defines the record

 

containing1 as TRIGGERtheindexing

 

 

 

anchor record, and all indexing

information

is

specified

as

rela

from

this

point.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

If ACIF finds either 'ACCOUNT:' or 'PAGE

1',

it

begins

scanning

th

record

after the farthest

field

specified.

If

either

'ACCOU

not found at its specified location relative1, ACIF

tobeginsTRIGGER

 

 

looking for TRIGGER1 again, starting

 

with the next record (that i

current record containing TRIGGER1+ 1).

 

 

 

 

 

 

 

 

 

 

 

 

Notes:

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

1. ACIF requires

that

at

least

n oneorFIELDnTRIGGERvalue

appear

 

 

 

within

the

page

range

specifiedINDEXSTARTBYby

the parameter. If

 

 

no

TRIGGERn

orFIELDn

 

parameter

 

is

satisfied

within

the

 

 

INDEXSTARTBY

 

 

page

range,

ACIF

stops

processing.

 

 

 

 

 

2. At

least

one

TRIGGERFIELDn

or

must

 

exist on the first page of

unique group. ACIF cannot detect

an

error

conditionor

if

TRIGG

FIELDn

 

is

missing,

but

the output

may

be

incorrectly indexe

3. TRIGGER1 must

be

specified

when

ACIF

is

requested

to

inde

4. An

 

error

condition

occurs

if

 

you

specify

any

TRIGGER

param

the input file contains indexing tags.

 

 

 

 

 

 

 

 

 

UNIQUEBNGS={YES

 

 

 

NO}

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Specifies

whether

ACIF

creates

a

unique

group

name by

generat

8-character numeric string

and

appending

the

string

to

the

group

The group name defined in the

Begin

Named

Page

Group

 

(BNG)

str

field

 

is

comprised

of

an

index

 

value

and

a

sequence

number.

YES Specifies that ACIF generate an 8-character numeric string append the string to the group name.

NO ACIF does not generate the string. No is the default if

DCFPAGENAMES=YES. SpecifyNO if you use the AFP API to generate your own group names.

USERLIB= data set name1[,data set name2][,file name] ...(OS/390, MVS)

Specifies the name of 1 to 8 catalogued data sets containing AFP processing the input data set. ACIF dynamically allocates these da searches for resources in them in the orderUSERLIB specified in the parameter. If a resource is not found, ACIF searches the approp

Chapter 7. Using ACIF Parameters in OS/390, MVS, VM,111and VSE

Page 131
Image 131
IBM S544-5285-01 manual Trigg, Bng