Note: If one or more TRIGGERn parameters is specified (that is, ACIF will
index the file), at least one INDEXn parameter must be specified, and
that index must be comprised of at least one FIELDn parameter value
that is not a literal. ACIF reports an error condition and terminates
processing if this rule is not satisfied.
‘attribute name’
Specifies a user-defined attribute name to be associated with the actual
index value. For example, assume INDEX1 is a person's bank account
number. The string 'account number' would be a meaningful attribute
name. The value of INDEX1 would be the account number (for example,
1234567). Think of the attribute name as a label for the actual index value.
The attribute name is an EBCDIC character string from 1–250 bytes in
length. ACIF does not perform any validity checking on the contents of the
attribute name.
FIELD
n
[,FIELDn...]
Specifies one or more FIELDn parameters that compose the index value. A
maximum of 16 FIELDn parameters can be specified. If more than one
FIELDn parameter is specified, ACIF concatenates them into one physical
string of data. No delimiters are used between the concatenated fields.
Because an index value has a maximum length of 250 bytes, the total of all
specified FIELDn parameters for a single index cannot exceed this length.
ACIF reports an error condition and terminates processing if this occurs.
EXAMPLE
FIELD1='1234567'
FIELD2=ð,1ð,2ð
FIELD3=ð,25,2ð
INDEX1='Patent Number',FIELD1
INDEX2='Employee Name',FIELD2,FIELD3
This example specifies that the first index tag is made up of the literal
character string ‘1234567’, while the other two index tags are made up of
fields within the file records.
FIELD1='123456'
FIELD2='444556677'
INDEX1='Account Number',FIELD1
INDEX2='Social Security Number',FIELD2
This example specifies both index tags as literal values. The entire file will
be indexed using these two values. The resulting index object file contains
only one record.
INDEXDD=INDEX |
ddname
(OS/390, MVS, and VM)
Specifies the DDname for the index object file. The DDname is a 1–8 byte
character string containing only those alphanumeric characters supported in the
operating environment. When ACIF is indexing the file, it writes indexing
information to this DDname. If INDEXDD is not specified, ACIF uses INDEX as
the default DDname. The following are suggested DCB characteristics for the
file:
A block size of 32760
A maximum record length of 32 756
If a record length other than 32756 is specified, it is possible that ACIF will
produce a record of length greater than that which is allowed by the INDEX
98 ACIF User’s Guide