Rule list parameters for SPACVOLA used with StopX37/II

ALTPOOL

This optional parameter specifies the name of a pool to be used as an alternative to the current pool.

• If USECPOOL=YES is specified, the alternative pool is searched after the current pool is searched.
• If USECPOOL=NO is specified, the alternative pool is the only pool that is searched.

This parameter is ignored for DFSMS data sets.

ALTPOOL=xxxxxxxx

xxxxxxxx is a pool name from those specified in SMPOOLxx. If the pool name is not defined, the refresh or startup fails.

None

EVENTID

This parameter specifies the identifier that is assigned to a user event in SMEVNTxx.

This parameter causes an event to be generated from this function.

Note: If EVENTID is used on an FLST SET statement with MODE=INACT, the event will still be issued. The EVENTID parameter will generate events only if the Automation component is licensed and active.

EVENTID= xxxxx

xxxxx is the 5-character string that is specified on the EVNTID parameter in SMEVNTxx.

None

MNTYPE

This parameter specifies the mount type for additional volumes in secondary space allocation.

Valid values for this parameter are:

• ALL considers all volumes in pool, regardless of mount type
• CURRENT searches only for volumes with the same mount type as the current volume
• PRIVATE considers only private volumes
• PUBLIC considers only public volumes
• STORAGE considers only storage volumes

Note: Regardless of the MNTYPE specification, all volumes in an alternative pool are considered eligible.

MNTYPE=xxxxxxx

NOCHECK

This parameter specifies the checks to be bypassed in space-recovery validation.

Valid values for this parameter are:

• CONTIG—a data set is allocated with contiguous space required.
• DC—a data set resides on a cached device. Under normal conditions, the volume addition occurs only to packs that have the same device characteristics.
• DSNAME—a data set is allocated to another DD statement within the same job step.
• DISP—a permanent data set is accessed without the use of a catalog.
• ENQ—a permanent data set is allocated to a DD statement within another job.
• EXCP—a data set is processed with the EXCP access method (or is otherwise processed at the hardware level).
• NOTE—a data set is processed with the NOTE macro.
• POINT—a data set is processed with the POINT macro.

Note: Remember that the values that you specify represent processes that will be bypassed.

NOCHECK=(xxxxxx,...)

None

OPER

This parameter allows the operator to provide a volume when the system cannot find space for a volume addition during SPACVOLA.

This option is not available for SMS-managed data sets.

PCTI

This parameter specifies the percentage value by which a secondary allocation is increased.

PCTI=nnnnn

nnnnn is a number between 0 and 10000.

None

REORG

This parameter specifies whether SPACVOLA reorganizes a data set that has just been made multivolume by SPACVOLA.

REORG_NSMS

This parameter specifies the SMRORGxx suffix that contains the DFDSS control cards to be used by the DFDSS reorganize Started Task to reorganize a non-SMS multivolume data set.

The SMRORGxx member must reside in the MainView SRM PARMLIB.

This parameter also specifies the MainView SRM pool name of the MainView SRM target pool to which the multivolume data set is to be reorganized.

REORG_NSMS=(xx,poolName)

xx is the SMRORGxx suffix and poolName is the target pool.

None

REORG_PROC

This parameter specifies the name of the procedure library member to be used as the Started Task JCL for the DFDSS reorganize job that is automatically started by SPACVOLA processing if REORG=YES is specified in the SPACVOLA RLST SET statement.

This specification overrides the default reorg procedure that is specified by the DFREORGPRC parameter in the SMMSYSxx member.

REORG_PROC=(procName)

procName is the procedure library member to use as the Started Task JCL for the reorganize job.

REORG_SMS

This parameter specifies the SMRORGxx suffix that contains the DFDSS control cards to be used by the DFDSS reorganize Started Task to reorganize an SMS multivolume data set.

The SMRORGxx member must reside in the MainView SRM PARMLIB.

This parameter also specifies the DFSMS storage class to be used as the target storage class to which the multivolume data set is to be reorganized.

REORG_SMS=(xx, storageClass )

xx is the SMRORGxx suffix and storageClass is the DFSMS target Storage Class for the reorganization.

None

SPACVOLA

This parameter specifies the maximum number of volumes for a single data set.

SPACVOLA does not add a volume if the addition would cause the data set’s total volume count to exceed this value.

Alternatively, you can remove the volume count specification from the job’s JCL.

This parameter is required.

Note: If a volume count is specified in the JCL for a job that uses multiple volumes, the SPACVOLA value should be set higher than the volume count. Otherwise, SPACVOLA processing will not take effect.

SPACVOLA=nn

nn is a number between 1 and 59.

None

UNIT

This parameter specifies the unit generic name (esoteric name, generic name, or pool name) to be used by the data set.

UNIT=xxxxxxxx

xxxxxxxx is a 1 to 8-character valid unit name (esoteric, generic, or pool name).

None

USECPOOL

This parameter specifies whether the current pool or the alternative pool is searched to find an additional volume that is required by a secondary allocation:

• USECPOOL=YES specifies that the current pool is searched, followed by the alternative pool, if any.
• USECPOOL=NO specifies that the current pool is not searched, meaning that the search begins with the alternative pool, if any.

If USECPOOL=NO is specified and no alternative pool is specified, the secondary allocation attempt fails.

Note: This parameter is ignored for DFSMS data sets.

Note: USECPOOL=YES is the default if ALTPOOL and VOLSER are not specified.

VOLSER

This parameter specifies a list of volumes or a special asterisk mask in which leading asterisks require the new volume name to match the existing volume name in the asterisk positions.

Example: VOLSER=(***) adds only volumes for which the first three characters match the existing volume.

Note: The / masking character does not work. Characters must match exactly.

VOLSER=(xxxxxx, xxxxxx,...)

xxxxxx is the 1 to 6-character volume serial ID or 1 to 5 asterisks.

None