Parameter | Specify . . . | Possible Values | Default |
---|---|---|---|
PREFICMD | the commands to include in prefetch processing. | L1-L9 | none |
PREFIFIL | the files to include in prefetch processing. | 1-5000 | none |
Together, PREFIFIL and PREFICMD specify one or more files to be included in prefetch/multifetch processing. PREFIFIL specifies one or more files by file number; PREFICMD specifies a command for each file number.
You can either "include" list of files using PREFIFIL/PREFICMD or "exclude" lists of files using the parameters PREFXFIL/PREFXCMD ), depending on which list is shorter. You cannot both include and exclude files at the same time.
If prefetching/multifetching has been specified and
files/commands have been neither included nor excluded, the prefetching/multifetching applies to all files by default.
files/commands have been included using the ADARUN parameters PREFIFIL/PREFICMD, the prefetching/multifetching applies only to the files on the "inclusion" list.
both PREFIFIL/PREFICMD and PREFXFIL/PREFXCMD are specified, Adabas recognizes the exclusion parameters PREFXFIL/PREFXCMD and ignores the inclusion parameters PREFIFIL/PREFICMD.
Include the L3 command for file 8 in prefetch processing.
ADARUN PREFIFIL=8,PREFICMD=L3
Specify multiple file numbers in multiple PREFIFIL statements or in a list, separated by commas. Specify multiple commands in multiple PREFICMD statements or in a list, separated by slashes (/). The maximum number of entries for each is 50.
If you use lists, they must have the same number of entries. There is a one-to-one correspondence, by position, between a file number in the PREFIFIL list and a command in the PREFICMD list.
Include the L3 command for file 8 and the L3 and L9 commands for file 12 in prefetch/multifetch processing.
ADARUN PREFIFIL=8,12,12,PREFICMD=L3/L3/L9
or
ADARUN PREFIFIL=8,PREFICMD=L3 ADARUN PREFIFIL=12,PREFICMD=L3 ADARUN PREFIFIL=12,PREFICMD=L9
As the preceding example shows, you can specify the same file number several times, with a different command each time. Likewise, you can specify the same command code several times, with a different file number each time.
The following commands can be included in prefetch/multifetch processing for a file:
L1/L4
L2/L5
L3/L6
L9
If either command in one of the pairs above is specified in a PREFICMD statement, both commands are included. For example, if PREFICMD=L1 is specified, both L1 and L4 are included.
Execute a user program with multifetch and allocate 20,000 bytes for the total prefetch buffer area. Include the L3 and L6 commands for files 8 and 12 in multifetch processing. Include all commands for file 7.
ADARUN PROG=USER,PREFETCH=YES,PREFTBL=20000 ADARUN PREFIFIL=8,12,PREFICMD=L3/L3 ADARUN PREFIFIL=7,7,7,7,PREFICMD=L1/L2/L3/L9
No PREFSBL value is specified, so the buffer length for a single prefetch sequence defaults to 3,000 bytes; up to 6 prefetch sequences can be handled.