Limited supportBMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see BMC AMI Copy for Db2 13.1.

OUTPUT syntax options common to disk and tape data sets

This section describes options you can use for copy data sets written to either disk or tape.

Warning

Any SMS DATACLAS, STORCLAS, and MGMTCLAS values existing in the current default output descriptor are used for both disk and tape data set allocations unless overridden in an associated OUTPUT statement (you can use DATACLAS NONE, STORCLAS NONE, and MGMTCLAS NONE respectively for this purpose). You should check the options settings in the current default output descriptor. In previous releases, these settings were ignored for tape allocations and were used only for disk allocations.

Syntax diagram of common options

OUTPUT_syntax_common_options.png

OUTPUT options common to disk and tape data sets


Option

Description

BUFNO integer

When you make copies using the IBM Db2 COPY utility, specify BUFNO for the named descriptor when you want to set a new value for the number of Db2 BSAM buffers. If you do not provide a new value, BUFNO defaults to the value of the BUFNO installation option. The BMC AMI Copy installation option default is 10. Valid values for BUFNO are in the range 0 through 99.

CATLG

Specify CATLG and either YES or NO (as appropriate) to redefine the MVS catalog directive for the named descriptor. If you do not specify CATLG for the named descriptor, BMC AMI Copy uses the installation option value. If you are using the BMC AMI Copy installation option defaults, this is CATLG YES.

If any SMS option (STORCLAS, DATACLAS, or MGMTCLAS) is used, BMC AMI Copy forces CATLG YES.

DATACLAS name

Specify DATACLAS name when you want to provide a new SMS data class name for the named descriptor. The value of name must be a valid SMS data class name, not exceeding eight characters.

If you do not specify DATACLAS for the named descriptor, BMC AMI Copy uses the installation option value (if any). If you do not want to use a value for DATACLAS and a value exists in the current default output descriptor, specify DATACLAS NONE in the OUTPUT statement.

BMC AMI Copy forces CATLG=YES when you specify DATACLAS.

When you are running z/OS Version 1.7 and later, you can copy table spaces and index spaces to large format sequential data sets (which can have more than 64 KB tracks) with BMC AMI Copy by specifying a DATACLAS in the OUTPUT statement that supports large format data sets or by coding DSNTYPE=LARGE in your JCL. (You can also use the COPY IMAGECOPY command (COPY-IMAGECOPY-command) to copy large format data sets.)

DSNAME dataSetName

Specify DSNAME and a data set name ( dataSetName) to set a new default data set name. If you do not specify this option in the OUTPUT statement, BMC AMI Copy uses the installation option value of the data set name. However, you can use DSNAME, COPYDSN, or RECOVERYDSN, as appropriate, in COPY (or COPY IMAGECOPY) syntax to override previously set data set names. Refer to DSNAME= for information about setting the installation option default.

Important

For Instant Snapshot copies, DSNAME is the VSAM cluster name. The data component is named by the hardware implementation. The maximum length of DSNAME for Instant Snapshots is 39 characters.

For cabinet copies, because there is only one data set name for the entire cabinet file, use generic values for DSNAME. Avoid use of the &DB or &TS substitution variables, although &DB might be appropriate if all copies are for the same database name. If you are multitasking with cabinet copies, you must include &SEQ or &TASK to make the data set name unique across tasks.

You can construct dataSetName using the symbolic variables described in Using-symbolic-variables.

ENCIPHER

Use the ENCIPHER option to indicate whether you want to make encrypted copies.

Important

Encryption is a feature of the Recovery Management for Db2 solution and requires a valid Recovery Management for Db2 solution password.

For more information, see Making-encrypted-copies.

Values of ENCIPHER

Value

Description

ENCIPHER NO

(Default) ENCIPHER NO specifies that BMC AMI Copy will not make encrypted copies.

ENCIPHER YES

ENCIPHER YES indicates that you want to create encrypted copies. ENCIPHER YES in the OUTPUT command works with the COPY and COPY IMAGECOPY commands to encrypt all image copies sent to the device specified in the OUTPUT command.

EXPOUT

Specify EXPOUT YES or NO to tell BMC AMI Copy to create a migration file for data migration. The default value is NO.

Important

Use of this feature requires one of the following valid passwords:

  • A Recovery Management for Db2 solution password
  • A BMC Database Administration for DB2 solution password

EXPOUT YES on the OUTPUT command used with an EXPORT command (EXPORT-command) creates a migration file in BMC AMI Copy. The migration file is then used by the BMC AMI Recover MIGRATE and IMPORT commands for data movement. (For more information about MIGRATE and IMPORT, see the BMC AMI Recover for Db2 documentation.)

MGMTCLAS name

Specify MGMTCLAS name when you want to provide a new SMS management class name for the named descriptor. The value of name must be a valid SMS management class name, not exceeding eight characters.

If you do not specify MGMTCLAS for the named descriptor, BMC AMI Copy uses the installation option value (if any). If you do not want to use a value for MGMTCLAS and a value exists in the current default output descriptor, specify MGMTCLAS NONE in the OUTPUT statement.

BMC AMI Copy forces CATLG=YES when you specify MGMTCLAS.

MODELDCB dataSetName

Specify MODELDCB and a cataloged data set name (dataSetName) to redefine the model DCB for the named descriptor. If you do not specify MODELDCB for the named descriptor, BMC AMI Copy uses the installation option value (if any).

To specify that no model DCB be used, use MODELDCB NONE.

The specified model data set must be allocated on a mounted direct access volume; BMC AMI Copy copies the DCB information from the data set label.

You can construct dataSetName using symbolic variables. Refer to DSNAME= for a list of the symbolic variables you can use.

STORCLAS name

Specify STORCLAS name when you want to provide a new SMS storage class name for the named descriptor. The value of name must be a valid SMS storage class name, not exceeding eight characters.

If you do not specify STORCLAS for the named descriptor, BMC AMI Copy uses the installation option value (if any). If you do not want to use a value for STORCLAS and a value exists in the current default output descriptor, specify STORCLAS NONE in the OUTPUT statement.

BMC AMI Copy forces CATLG=YES when you specify STORCLAS.

UNIT name

Specify UNIT and a new tape or disk unit name when you want to override the default unit named in the installation options module. The BMC AMI Copy installation default is SYSALLDA. If you specify a new name, BMC AMI Copy uses it for UNIT and for any of the installation options UNITLB, UNITRP, and UNITRB that are not specified in the installation options module. Refer to UNITRB=, UNITRP=, and UNITRB=.

BMC AMI Copy detects whether or not a unit name refers to a tape unit. If BMC AMI Copy determines that a specified unit is not a tape unit, it assumes that the device type is disk, unless the unit name appears in the list of tape units (TAPES) in the installation options module currently in use.

Important

When you use BMC AMI Copy to make Instant Snapshots by using the DSSNAP option, consider the following information about the UNIT option in the OUTPUT command:

  • If you specify any value for the UNIT option in the OUTPUT command, BMC AMI Copy passes that value to XBM or SUF as the esoteric unit.
  • If you do not specify the UNIT option in the OUTPUT command (thus accepting the default UNIT=SYSALLDA), BMC AMI Copy does not pass a UNIT value to XBM or SUF.

We recommend that you not specify a value for UNIT when you are making Instant Snapshots. When you do not specify a value for UNIT, XBM or SUF determine the UNIT value and processing is more efficient.

UNITCNT integer

Use UNITCNT to specify the unit count used for dynamic allocation. Valid values are 0 (zero) to 59. The value 0 means the unit count will not be specified for the allocation.

If you do not specify UNITCNT for the named descriptor, BMC AMI Copy uses the installation option value. If you are using the BMC AMI Copy installation option default, the default is 0. If you do not want to use a value for UNITCNT and a value exists in the current default output descriptor, specify UNITCNT 0 in the OUTPUT statement.

Specifying UNITCNT 2 for tape output will allocate two tape drives. When a tape volume is at the end of tape, BMC AMI Copy begins writing on the second drive immediately. This allows you to eliminate time spent waiting for tape rewind.

Specifying UNITCNT 11 for disk output will allow BMC AMI Copy to allocate a primary and 15 secondary extents on up to 11 volumes, which reduces the risk of getting B37 abends.

VOLCNT integer

To set VOLCNT integer for the named descriptor, specify the largest number of volumes you expect BMC AMI Copy to process when copying a single data set. For disk data sets, this option limits the values of the VOLUME, LPVOLS, LBVOLS, RPVOLS, and RBVOLS options. For both tape and disk data sets, integer must be equal to or greater than the number of volumes produced for the single largest output copy, whether or not you use stacked output.

Important

For a nonspecific disk data set allocation, 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.

If you do not specify VOLCNT for the named descriptor, BMC AMI Copy uses the installation option value. If you are using the BMC AMI Copy installation option default, the default is 25. If the VOLUMES option is defined for disk data sets, the default is the number of volumes in the list. To use the MVS default, set VOLCNT to 0.

Important

If you are using SMS in your system, we recommend you use VOLCNT 0.

Related topics

Installation-options

OUTPUT-command-and-dynamic-allocation-of-copy-data-sets

Output-descriptor-options-common-to-disk-and-tape-data-sets


 

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