length of the record, ACIF considers the comparison “false” and continues
processing.
EXAMPLE
The following example illustrates the use of a carriage control character as
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, looking for
the occurrence of X'F1' in the first byte. After ACIF locates a record
containing the X'F1', it looks in the same record, starting at byte 50, for
the occurrence of 'ACCOUNT:'. If 'ACCOUNT:' is found, ACIF looks at the
third record down for a value of 'PAGE 1', starting at byte 75. If 'PAGE 1' is
found, ACIF defines the record containing TRIGGER1 as the indexing
anchor record, and all indexing information is specified as relative locations
from this point.
If ACIF finds either 'ACCOUNT:' or 'PAGE 1', it begins scanning the first
record after the farthest field specified. If either 'ACCOUNT:' or 'PAGE 1' is
not found at its specified location relative to TRIGGER1, ACIF begins
looking for TRIGGER1 again, starting with the next record (that is, the
current record containing TRIGGER1 + 1).
Notes:
1. ACIF requires that at least one TRIGGERn or FIELDn value appear
within the page range specified by the INDEXSTARTBY parameter. If
no TRIGGERn or FIELDn parameter is satisfied within the
INDEXSTARTBY page range, ACIF stops processing.
2. At least one TRIGGER or FIELDn must exist on the first page of every
unique group. ACIF cannot detect an error condition if TRIGGERn or
FIELDn is missing, but the output may be incorrectly indexed.
3. TRIGGER1 must be specified when ACIF is requested to index the file.
4. An error condition occurs if you specify any TRIGGER parameters, if
the input file contains indexing tags.
UNIQUEBNGS={YES | NO}
Specifies whether ACIF creates a unique group name by generating an
8-character numeric string and appending the string to the group name.
The group name defined in the Begin Named Page Group (BNG) structured
field is comprised of an index value and a sequence number.
YES Specifies that ACIF generate an 8-character numeric string and
append the string to the group name.
NO ACIF does not generate the string. No is the default if you specify
DCFPAGENAMES=YES. Specify NO 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 resources for
processing the input data set. ACIF dynamically allocates these data sets and
searches for resources in them in the order specified in the USERLIB
parameter. If a resource is not found, ACIF searches the appropriate resource
Chapter 7. Using ACIF Parameters in OS/390, MVS, VM, and VSE 111