Information
Important We are integrating BMC AMI LOBMaster technology into the BMC AMI Reorg product and discontinuing BMC AMI LOBMaster as a separate product. For the latest integrated documentation, see BMC AMI Reorg for Db2 13.1.

XSUTDYNM (sequential data set allocation) automation control point


Use the XSUTDYNM automation control point to control the size, unit, and volumes for the generated data set.

The product invokes this automation control point before allocating sequential data sets.

Variables

The following table describes the variables used in the XSUTDYNM automation control point:


Variable name

Contents

Possible values

Notes

blksize

Size of each block, in bytes

Not applicable


dataclas

SMS data class for this data set

You can change this value. You must change this value if allocation is being performed with SMS DATACLASS.

Blank (default) or SMS data class value


dsname

Data set name of the object to be allocated

Not applicable


dsntype

Data set type

  • LARGE
  • BASIC
  • EXTPREF
  • EXTREQ
  • HFS
  • PIPE
  • PDS
  • PDSE


mgmtclas

SMS management class for this data set

You can change this value. You must change this value if allocation is being performed with SMS MANAGEMENTCLASS.

Blank (default) or SMS management class value


maxvol

Maximum number of different volumes that can be used

0 through 59

If the estimated size for the work data set is greater than 1000 cylinders, the size is divided by 1000 to obtain the number of volumes. This value is added to the number of volumes specified in the+WORKUNIT parameter. If the result of this calculation is greater than 59, then the maxvol variable is set to 59.

retpd

Retention period, in days

Not applicable


primary

Primary space allocation in units, specified by the variable spaceunit

Not applicable


secondary

Secondary space allocation in units, specified by the variable spaceunit

Not applicable

The value for secondary must be greater than 0. A value of 0 will produce unpredictable results.

size

Number of 4 KB blocks that are required for this data set

You can use this value to change the values in the primary and secondary variables to apply to a different spaceunit.

Not applicable

This value is the number of 4 KB blocks required, regardless of whether the value specified for blksize is 4K.

The calculation of size does not include the number of pages to be added for the variables freepage and pctfree.

spaceunit

The allocation unit used for the primary and secondary allocation

  • B (blocks)
  • C (cylinders)
  • T (tracks)


storclas

SMS storage class for this data set

You can change this value. You must change this value if allocation is being performed with SMS STORAGECLASS.

Blank (default) or SMS storage class value


unitname

DASD unit name for this allocation

This value must be a value that is acceptable on your system.

Not applicable


volser

List of available volumes for the data set allocation.

A string of no more than 10 volumes, exactly 6 bytes for each volume, not separated by commas or blanks

For example, to specify volumes PRD238, TST223, DEV283, DEV012, PRD231, TST162, volser would be specified as follows:

volser = 'PRD238TST223DEV283DEV012PRD231TST162'

The automation control point might set this variable to a string of DASD volume serial numbers or not set a value for the variable.

Return codes

The XSUTDYNM automation control point returns the following return codes:


Return code

Description

0

(default value) Signifies normal completion

No action is required.

Any other value

Abnormal termination

Set the rc variable to any non-zero value to cancel the entire job.


 

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

BMC AMI LOBMaster for Db2 13.1