Skip to Content

Rule list parameters for SPACSQTY used with Allocation


Related topic

SPACSQTY—set primary and secondary space for data set (used with Allocation)

The following table lists the parameters that you can specify in a SET statement (in member SMRLSTxx).

SPACSQTY rule list parameters

Parameter

Purpose

Syntax

Default

ALCTYPE

This parameter specifies the unit of space allocation.

This parameter applies to both primary and secondary space quantities.

Valid allocation types are:

  • KB—block allocation where PQTY and SQTY are assumed to be kilobytes
  • MB—block allocation where PQTY and SQTY are assumed to be megabytes
  • TRK—tracks
  • CYL—cylinders
  • KAV—AVGREC=K
  • MAV—AVGREC=M
  • UAV—AVGREC=U
  • BLK—blocks
  • JCL—Indicates that SPACSQTY should allocate using the requested type specified in the JCL. Example: If space=(CYL,(554,554)) is coded in the JCL then CYL will be used to allocate the data set.
Warning

Important

KAV, MAV, and UAV are not valid parameters for VSAM allocations.

ALCTYPE=xxx

xxx is a valid allocation type.

ALCTYPE=KB

AVL

This parameter specifies the average block size for BLK allocations and record length for KAV, MAV, and UAV allocations.

AVL=nnnnn

nnnnn is a number between 1 and 32767.

AVL=9000

CONTIG

This parameter specifies whether a data set is allocated with contiguous space required.

CONTIG=YES|NO

None

DIR

This parameter specifies the number of directory blocks for partitioned data sets.

Warning

Important

This parameter can only be used to change the directory blocks. You must request DSORG=PO or specify directory blocks in the original allocation.

DIR=nnnn

nnnn is a number between 1 and 4096.

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.

Warning

Important

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

PQTY

This parameter specifies the primary space allocation quantity in the unit specification ALCTYPE for a new data set.

PQTY=nnnnn

nnnnn is a number between 1 and 99999.

None

PQTYPCT 

This parameter reduces the primary allocation amount by the percentage that you specify.

Warning

Important

This parameter is ignored if PQTY is specified.

Using the example PQTYPCT=80:                                                 

An allocation of (CYL,(100,100)) would become (CYL,(20,100)).                 

The primary allocation is reduced by 80%, the resulting value is 20.

   

PQTYPCT=nnn

nnn is a number between 1 and 100       

None

REPLACE

This parameter specifies whether to override the space allocations that are already specified for the data set (in JCL, for example).

Warning

Important

  • REPLACE only applies to PQTY, SQTY, PQTYPCT, and SQTYPCT parameters.
  • For dataset allocations using a model dataset ( specifying LIKE parameter in JCL), REPLACE=YES should be coded in the SET statement of the defined rule.
REPLACE=YES|NO
REPLACE=YES

ROUND

This parameter specifies that the space allocation be rounded to the nearest cylinder for new data sets.

Warning

Important

This rounding process is performed by z/OS; BMC AMI Storage merely switches on the appropriate bit to allow z/OS to perform this service.

Both the SPACCONV function and SPACSQTY function allow the ROUND parameter to be specified. If both functions are specified for the same data set, the value in SPACCONV is assigned to the data set, because SPACCONV receives control after SPACSQTY.

ROUND=YES|NO

None

SQTY

This parameter specifies the secondary space allocation quantity in the units specified in ALCTYPE for a new data set.

SQTY=nnnnn

nnnnn is a number between 1 and 99999.

None

SQTYPCT

This parameter takes the original secondary allocation value and reduces it by the percentage specified in this parameter.                                   

Using the example SQTYPCT=80:                                                 

An allocation of (CYL,(100,100)) would become (CYL,(100,20)).                 

The secondary allocation is reduced by 80%, the resulting value is 20.   

Warning

Important

This parameter is ignored if SQTY is specified.   

                             

SQTYPCT=nnn 

nnn is a number between 1 and 100.

None

SQTYPCTP

This parameter indicates that the primary allocation value is to be reduced by the percentage coded in SQYTPCT and that calculated value should be used as  the secondary allocation value if it is greater than the original secondary allocation.                                                                   

The primary allocation value will be reduced by the percentage defined in SQTYPCT. That value will be compared to the original secondary allocation value. The greater of the two values will be used for the secondary allocation.  This parameter is used in conjunction with SQTYPCT. If SQTYPCT is not coded then this parameter is ignored.                                  

Using the example SQTYPCTP=Y SQTYPCT=80:                                     

An allocation of (CYL,(1000,1)) would become (CYL,(1000,200)).               

The primary value is reduced by 80% (result 200), and then compared to the original secondary allocation value (1). Since 200 is greater than 1, the calculated value will be used for the secondary allocation value.            

An allocation of (CYL,(1000,500)) would stay (CYL,(1000,500)).               

Again, the primary value is reduced by 80% (result 200), and then compared to the original secondary allocation value (500).  Since 500 is greater than 200, the original secondary allocation value is used.                         


SQTYPCTP=YES|NO|Y|N                                                              

SQTYPCTP=N   

UPDTINDEX

The UPDTINDEX parameter picks the space allocation of the VSAM INDEX file from Rule list of SPACSQTY. The default value for UPDTINDEX is NO, so it takes the space allocation from DEFINE INDEX mentioned in the JCL.

When the UPDTINDEX value is changed to Y with the Global parameter VINDEX set to Y in SMMSYSXX, the allocation space for the VSAM INDEX file is taken from the Rule list parameters PQTY and SQTY with unit mentioned in ALCTYPE.

UPDTINDEX=Y|N|YES|NO

Allowed in Rule SET parameter for function SPACSQTY.

Warning

Important

In SMMSYSXX, set the global parameter VINDEX=Y.

UPDTINDEX = NO


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Storage Allocation 8.2