Output descriptor options common to disk and tape data sets
The following options apply to both disk and tape data sets.
For more information about these options, see OUTPUT-syntax-options-common-to-disk-and-tape-data-sets.
UNIT=SYSALLDA
The UNIT parameter is used by the product to establish the device type (tape or disk) to be used for syntax checking and dynamic disk allocation. The parameter value is compared to a list of tape devices retrieved from MVS. If it does not match, it is assumed to be a disk device. If the unit is not determined to be tape, it will be treated as disk even if it is used with REALDD. The BMC AMI Copy default name is SYSALLDA. However, if you are making Instant Snapshot copies and use the default UNIT=SYSALLDA, BMC AMI Copy passes no value to XBM or SUF for Instant Snapshot processing. This allows XBM or SUF to determine the value of UNIT and processing is more efficient.
If you do not provide a value for UNITLB, UNITRP, or UNITRB during installation, those options default to the value of UNIT. However, if you do provide values for those options, the value of UNIT is the default only for the local site primary copies.
The default for this option can be overridden at runtime by using the UNIT syntax option in an appropriate OUTPUT statement.
UNITLB=
Use UNITLB to specify a name for the default tape or disk unit to be used for local site backup copies. If it is not specified during installation, this option defaults to the value of UNIT.
Any value you provide for UNITLB cannot be overridden at run-time.
UNITRP=
Use UNITRP to specify a name for the default tape or disk unit to be used for recovery site primary copies. If it is not specified during installation, this option defaults to the value of UNIT.
Any value you provide for UNITRP cannot be overridden at run-time.
UNITRB=
Use UNITRB to specify a name for the default tape or disk unit to be used for recovery site backup copies. If it is not specified during installation, this option defaults to the value of UNIT.
Any value you provide for UNITRB cannot be overridden at run-time.
DSNAME=
Use DSNAME to specify the default disk or tape data set name for the LPNAME, LBNAME, RPNAME, RBNAME, COPYDSN, and RECOVERYDSN installation options. This name can be overridden at run-time by using the DSNAME, COPYDSN, or RECOVERYDSN syntax option in a COPY or COPY IMAGECOPY statement.
You can construct the default name using the symbolic variables shown in the following table to generate unique data set names. You can specify any or all nodes of a data set name using symbolic variables (see Using-symbolic-variables).
When LPNAME, LBNAME, RPNAME, or RBNAME are not provided with values during installation, those without values default to the value of DSNAME. Also, if you use symbolic variables to provide default values for the installation options and for the installation panels, you must use double ampersands. An example for DSNAME is:
When you use a symbolic variable, you can prefix it with an alphabetic character. However, you cannot append characters. If you append any characters or numbers after the symbolic variable, BMC AMI Copy ignores and does not use those characters. For example, XX&TS is valid but &TSXX is invalid. &TS.XX is also valid.
Symbolic variables for specifying data set names
Symbolic variable | Definition | |
|---|---|---|
&ATTACH 3 | Db2 group attachment name or subsystem ID | 4 bytes |
Current date (in the form YYMMDD) | 6 bytes | |
Current day (in the form DD) | 2 bytes | |
&DB | Database containing the space being copied | 8 bytes maximum |
&DSNUM or &PART 5 | Data set or partition being copied | 2 bytes (0-99)3 bytes (100-999)4 bytes (1000-4096) |
Current hour (in the form HH) | 2 bytes | |
&ICTYPE | Type of image copy
| 1 byte |
&INST | Instance number, with valid values of 01 or 02 | 2 bytes |
Current Julian date (in the form YYDDD) | 5 bytes | |
Current Julian day (in the form DDD) | 3 bytes | |
&JOBNAME | JOB name used in the JCL | 8 bytes maximum |
&LDSNUM, &LPART 5 | Data set or partition being copied (long format) | 3 bytes (000-999)4 bytes (1000-4096) |
Current minute (in the form MM) | 2 bytes | |
Current minute (in the form MM) | 2 bytes | |
Current month (in the form MM) | 2 bytes | |
&OBNOD | Object node (databaseName. spaceName, where spaceName is either a table space name or an index space name) | 17 bytes |
&PART or &DSNUM 5 | Data set or partition being copied | 2 bytes (0-99)3 bytes (100-999)4 bytes (1000-4096) |
Current second (in the form SS) | 2 bytes | |
Current second (in the form SS) | 2 bytes | |
&SEQ 7 | Sequence number that increments with each reference. It can be used to provide unique output data set names. The sequence number restarts at 1 for each job step. | 2 bytes |
&SSID | Db2 subsystem ID | 4 bytes |
&STEPNAME 8 | STEP name used in the JCL | 8 bytes maximum |
&TASK 7 | 1- to 2-digit number corresponding to the subtask in which a copy is made. If the copy is made in the main task, the value is 0. | 2 bytes |
Current time (in the form HHMMSS) | 6 bytes | |
&TS 9 | Table space or index space being copied | 8 bytes maximum |
&TYPE | Type of output being produced:
| 2 bytes |
&UID or &USERID | Job or TSO user ID | 7 bytes maximum |
&UNIQ or &UQ | 1- to 8-character value, based on the system clock, that is used to generate unique copy data set names The first character is always an uppercase letter. Each remaining character is either an uppercase letter or a numeral from 0 through 9. | 8 bytes maximum |
&UTIL 10 | Utility ID | 8 bytes maximum |
&VCAT | VCATNAME specified in the Db2 catalog for the space that you are copying; or, if the space is partitioned and the copy is DSNUM ALL, the VCAT name from the first partition that you are copying | 8 bytes |
Step e Current year (in the form YY) | 2 bytes |
1 BMC AMI Copy removes any trailing blanks in the result.
2 The maximum total length allowed for a data set name is 44 bytes, except for Instant Snapshot copies, where the maximum is 39.
3 This is the group attachment name if BMC AMI Copy uses one as a parameter; otherwise, BMC AMI Copy uses the subsystem ID.
4 BMC AMI Copy assigns the values for these variables when the output copy data set is allocated.
5 You must prefix symbols with a numeric result by one or more alpha characters.
6 You can override this by using the installation options ICAUTOI and ICAUTOF.
7 For information on using this symbolic variable with cabinet copies, see Considerations-for-cabinet-copies.
8 BMC AMI Copy ignores PROC names.
9 &TS for an index copy is the index space name. Using &TS is supported so that a single data set name can be specified for a group containing both table spaces and indexes.
10 BMC AMI Copy truncates longer utility IDs to 8 characters.
LPNAME=
Use LPNAME to specify the default name for the local site primary copy data set. If no value is specified during installation, this option defaults to the value of DSNAME. Any value you provide for this option can be overridden at run-time. You can construct this name using symbolic variables.
LBNAME=
Use LBNAME to specify the default name for the local site backup copy data set. If no value is specified during installation, this option defaults to the value of DSNAME. Any value you provide for this option can be overridden at run-time.
You can construct this name using symbolic variables.
RPNAME=
Use RPNAME to specify the default name for the recovery site primary copy data set. If no value is specified during installation, this option defaults to the value of DSNAME. Any value you provide for this option can be overridden at run-time.
You can construct this name using symbolic variables.
RBNAME=
Use RBNAME to specify the default name for the recovery site backup copy data set. If no value is specified during installation, this option defaults to the value of DSNAME. Any value you provide for this option can be overridden at run-time.
You can construct this name using symbolic variables.
MODELDCB=
Use MODELDCB to specify the name of a cataloged data set to define the default model DCB. The data set must be on a mounted direct access volume; the DCB information is copied from the data set label. The data set name can be overridden at runtime by using the MODELDCB syntax option in an OUTPUT statement. To specify that no model DCB be used, set MODELDCB=NONE.
You can construct this name using symbolic variables.
CATLG=YES
Use CATLG to specify the default MVS catalog directive for the disk or tape data sets. CATLG=YES causes the data sets to be cataloged in the MVS catalog. If you specify CATLG=NO, the data sets are not to be cataloged. The value specified during installation can be overridden at runtime by using the CATLG syntax option in an OUTPUT statement.
If any SMS option (STORCLAS, DATACLAS, or MGMTCLAS) is used, CATLG=YES is forced by BMC AMI Copy.
TAPES=
Use TAPES to specify a list of tape units that allows BMC AMI Copy to distinguish between tapes and disks. BMC AMI Copy has the ability to dynamically determine whether a unit is a tape unit. If BMC AMI Copy determines it is not a tape unit, it assumes the device type is disk unless the unit name is in this list. You should not need to specify the tape units unless BMC AMI Copy is unable to identify your units automatically.
Specify the list in the form (tape1,tape2,.......tapen).
VOLCNT=25
Use VOLCNT to specify the default for the largest number of volumes expected to be processed when copying any tape data set. The valid range of values for VOLCNT is 1 through 255 and the BMC AMI Copy default is 25. The number must be large enough to accommodate the number of volumes produced for the single largest copy, whether or not you use stacked output.
For disk data set allocations, VOLCNT is ignored. UNITCNT should be used to request a multi-volume disk data set. Valid values for UNITCNT are 0 (zero) through 59. The default value is UNITCNT=0, which means the unit count will not be specified for the allocation.
The value of VOLCNT can be overridden at runtime by using the VOLCNT syntax option in an OUTPUT statement.
BUFNO=10
When you make copies using the IBM Db2 COPY utility, use BUFNO to specify the default for the number of IBM Db2 BSAM buffers. Valid values for BUFNO are in the range 0-99.
The value of BUFNO can be overridden at runtime by using the BUFNO syntax option in an OUTPUT statement.
STORCLAS=
Use STORCLAS to specify an SMS storage class name for output copy data sets. The name must be a valid SMS storage class name not exceeding eight characters. A value specified during installation can be overridden at runtime by using the STORCLAS syntax option in an OUTPUT statement. If you do not specify a value, either during BMC AMI Copy installation or by syntax option, the SMS installation value is used.
BMC AMI Copy forces CATLG=YES when STORCLAS is specified.
DATACLAS=
Use DATACLAS to specify an SMS data class name for output copy data sets. The name must be a valid SMS data class name not exceeding eight characters. A value specified during installation can be overridden at runtime by using the DATACLAS syntax option in an OUTPUT statement. If you do not specify a value, either during BMC AMI Copy installation or by syntax option, the SMS installation value is used.
BMC AMI Copy forces CATLG=YES when DATACLAS is specified.
MGMTCLAS=
Use MGMTCLAS to specify an SMS management class name for output copy data sets. The name must be a valid SMS management class name not exceeding eight characters. A value specified during installation can be overridden at runtime by using the MGMTCLAS syntax option in an OUTPUT statement. If you do not specify a value, either during BMC AMI Copy installation or by syntax option, the SMS installation value is used.
BMC AMI Copy forces CATLG=YES when MGMTCLAS is specified.
UNITCNT=0
Use UNITCNT to specify the unit count used for dynamic allocation. Valid values are 0 (zero) through 59. The default value is 0 and means the unit count will not be specified for the allocation.
Related topics