Integrated auxiliary utility parameters for the Build Index function of FPA

The integrated auxiliary utility parameters for the Build Index function of FPA are described here.

Syntax diagram

This syntax diagram shows the parameters which are associated with the Build Index function of FPA.

Integrated auxiliary utility parameters for the Build Index function of FPA

Read syntax diagramSkip visual syntax diagramBLD_SECONDARY (ALL |  secixdbname1,secixdbname2,secixdbname3...), FSNUM(99nn),FSPREF(FDRFcc ccccccccc),ICINCOMP(NOYES),ITASKCTL(AREAnnnn),OTASKCTL(nnnn),SITE_DSNAME('dsname'),SITE_MEMBER(member),

Parameter reference

BLD_SECONDARY(ALL | secixdbname1,secixdbname2,secixdbname3...)
Use this parameter to rebuild the secondary index databases of the dbname/areaname specified on the ADD DB() command.
Important: When BLD_SECONDARY(ALL) is specified, all secondary indexes are rebuilt. It is not necessary to specify BLD_SECONDARY(secixdbname1,secixdbname2,secixdbname3).
Note: Only BLD_SECONDARY(ALL) is supported when this parameter is specified on the UTILGBL() environmental statement.
FSNUM(nn |99)
A 1- to 2-digit integer value that you use to specify the maximum number of address spaces for the Build Index function of FPA that are started in parallel.

The actual number of FS-UAS address spaces depends on the work required, so the number of utility address spaces might be less than the value you specified.

If nn is sufficient, then one FS-UAS is started per DEDB for which index rebuild was requested.

Start of changeFSPREF(cc | cccc | ccccc | FDRF)End of change
Use this parameter to set the prefix of the utility address space for the job name for the Build Index function of FPA.
cc
A 2-character alphanumeric prefix used to construct the FS started task name.
When a 2-character prefix is specified, the job name is constructed by using the format ccjjjj## where:
cc
The specified prefix.
jjjj
The JES job number associated with the master address space.
##
A number from 01 - 99, incremented with each new address space.
cccc
A 4-character alphanumeric prefix used to construct the FS started task name.
When a 4-character prefix is specified, the job name is constructed by using the format cccc####, where:
cccc
The specified prefix.
####
A number from 0001 - 0099, incremented with each new address space.
Start of changecccccEnd of change
Start of changeA 5-character alphanumeric prefix used to construct the FS started task name.
When a 5-character prefix is specified, the job name is constructed by using the format ccccchhh, where:
ccccc
The specified prefix.
hhh
A number from 001 – FFF (hexadecimal), incremented with each new address space.
End of change
FDRF
If FSPREF() is not specified, the job name is constructed by using the format FDRF####, where #### is a number from 0001 - 0099, incremented with each new address space.
ICINCOMP (No | Yes)

Use this parameter to specify, when an image copy is used as an input data set, whether the image copy records are to be compressed by using the CSRCESRV MVS macro when they are stored into a data space storage.

IMS Fast Path Advanced Tool IMS Fast Path Advanced Tool stores all image copy records into a data space storage when an image copy is used as an input data set. Because the maximum size of one data space is 2 GB, if the total size of the records exceeds the limit, IMS Fast Path Advanced Tool ends with an error.

Try to reduce the total size of the records to under 2 GB by specifying ICINCOMP=YES. FPA compresses the image copy records by using the CSRCESRV macro before storing them into a data space and expands them when they are processed.

The data compression and expansion process increases the amount of CPU time.

No
The image copy records are stored into a data space storage without compression.
Yes
The image copy records are stored into a data space storage after compression.
ITASKCTL(AREA | nnnn)

Use this parameter to specify the maximum number of input areas to be processed concurrently.

AREA
The number of input areas.
nnnn
Specify a value from 1 to 2048. Specify a value less than or equal to the number of input areas.

If you specify a value that is greater than the number of input areas, it will be replaced by the number of input areas.

In case of the CHANGE command in the REORG mode, the following value is set: (ITASKCTL + OTASKCTL)/2 (the value is rounded off)

OTASKCTL(nnnn)

Use this parameter to specify the maximum number of output areas to be processed concurrently.

nnnn
Specify a value from 1 to 2048. Specify a value less than or equal to the number of output areas.

If you specify a value that is greater than the number of output areas, it will be replaced by the number of output areas.

In case of the CHANGE command in the REORG mode, the following value is set: (ITASKCTL + OTASKCTL)/2 (the value is rounded off)

SITE_DSNAME ('dsname')
Use this parameter to specify the name of the data set that has the members of the site default tables.
'dsname'
Specify a data set name that is 1- to 44-characters and enclosed in single quotation marks.

The data set name identifies the data set containing the HFPCSITE global site default member.

SITE_MEMBER (member)
Use this parameter to specify the name of the data set that has the members of the site default tables.
'dsname'

Use the SITE_MEMBER parameter to specify the member name of the site default table.