Note: If one or more TRIGGERn parameters is specified (that is, ACIF wi index the file), atINDEXnleast parameterone must be specified, and

that index must be comprised ofFIELDnat leastparameterone value

that is not a literal. ACIF reports an error condition and ter processing if this rule is not satisfied.

‘attribute

name’

 

 

 

 

 

 

 

 

 

Specifies a user-defined attribute name to

be

associated

with

index value. For example, INDEX1assume is a person's bank

account

 

number. The string 'account number' would be

a meaningful

attribute

name. The

value

INDEX1of

would be

the

account

number

(for example,

1234567). Think of the

attribute

name

as a

label

 

for

the

actual

The attribute

name is

an EBCDIC

character

string

from

1–250

bytes

length. ACIF does not perform any validity checking on the contents

attribute

name.

 

 

 

 

 

 

 

FIELD n [,FIELDn...]

 

 

 

 

 

 

 

Specifies

one orFIELDnmore parameters that compose the index

value.

 

maximum

of

16FIELDn

parameters can

be

specified.

If

more

than

o

FIELDn

parameter

is specified,

ACIF

concatenates

them

into

one

p

string of data. No delimiters are used between the concatenated Because an index value has a maximum length of 250 bytes, the t

specifiedFIELDn parameters for a single index cannot exceed this ACIF reports an error condition and terminates processing if this

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 character string ‘1234567’, while the other two index tags are m 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 en

be

indexed

using

these

two

values. The

resulting index object f

only

one

record.

 

 

 

 

 

INDEXDD=INDEX

 

 

ddname

(OS/390,

MVS,

and

VM)

 

Specifies

the

DDname

for the index

object

file. The DDname is a

character string containing only those alphanumeric characters supporte operating environment. When ACIF is indexing the file, it writes inde

information

to

this

DDnameINDEXDD. If

is not

specified,

ACIF

uses

INDEX as

the

default

DDname.

The

following

are

suggested

DCB

characteristics

file:

 

 

 

 

 

 

 

 

 

 

 

Ÿ

A

block

size of

32 760

 

 

 

 

 

 

 

Ÿ

A

maximum

record

length

of

32 756

 

 

 

 

 

If a record length other than 32756 is specified, it

is possib

 

produce

a

record of

length

greater than that which is

allowed

98 ACIF User’s Guide

Page 118
Image 118
IBM S544-5285-01 manual Field n ,FIELDn, Ddname, 16FIELDn