XSUTDYNM (sequential data set allocation) 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 |
| |
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 |
| |
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. |