Skip to Content
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.

OUTPUT syntax options for tape data sets

This topic describes the options that apply only to copies written to tape.


Related topic

OUTPUT-syntax-options-common-to-disk-and-tape-data-sets 

OUTPUT options for tape data sets syntax

image2023-2-17_10-10-55.png

1 BMC AMI Utilities provide these default values at installation time.


ID

The ID keyword uniquely identifies each tape DD statement that is dynamically allocated based on an OUTPUT command.

If you do not specify an ID keyword, the BMC AMI Utilities automatically generates internal ID values. The XCPYINIT and XSVRJCL automation control points must be used or merged with your customized members. XCPYINIT is shipped as disabled. You must enable it by removing Exit 0 from the beginning.

If you specify the ID keyword, one of the following values is required:

Value

Description

Ox

x can be any number between 1 and 9

Ux

x can be any alphanumeric character (A–Z, 0–9). If you are directing more than nine OUTPUT commands to a tape device, you must use Ux.

RETPD integer

Specify RETPD integer in the descriptor named after the OUTPUT keyword to set a new retention period (in days) for the current copy data set.

The value of integer must be in the range 1 through 9999.

Warning

Important

When EXPDT is specified on the OUTPUT statement, it takes precedence over RETPD. However, if EXPDT is not specified on the OUTPUT statement and RETPD is specified on the OUTPUT statement, RETPD overrides EXPDT in the installation options module.

EXPDT date

Specify EXPDT date in the descriptor named after the OUTPUT keyword to set a new expiration date for the current copy data set. The default value of the EXPDT installation option is 99000.

Warning

Important

When it is specified on the OUTPUT statement, EXPDT takes precedence over RETPD. However, if EXPDT is not specified on the OUTPUT statement and RETPD is specified on the OUTPUT statement, RETPD overrides EXPDT in the installation options module.

The value of date must be in the format YYDDD, YYYYDDD, or YYYY/DDD where YYYY is the 4-digit year, YY is the last two digits of the year, and DDD is the 3-digit Julian day (001 through 366).

Success

Tip

A date with a two-digit year is passed as is to dynamic allocation. For years beyond 1999, depending on your environment, this might not produce the appropriate result. We recommend using a four-digit year.

DDNCOUNT integer

Specify the number of tape devices from 1 to 10. The default value is 1. 

If you use a DDNCOUNT of two or more, then the OUTPUT statement name cannot exceed 6 characters. 

USER1(string), USER2(string), USER3(string)

Specify additional attributes for an image copy data set (such as DCB information or management class).

Information
Example

The following syntax creates an COPYLP DD in the form: //COPYLP DD UNIT=(CART,,DEFER),VOL=(,,,255),DSN=SMS.ACS

OUTPUT COPYLP DSNAME &USER..LP.&DB..&TS..P&PART4(+1)                                  
    UNIT CART  GDGLIMIT 4                           
    USER1(DSN=SMS.ACS)                     
REORG TABLESPACE DB.TS COPYDDN(COPYLP)                                         

You can also specify multiple JCL options in each user keyword.

Information
Examples

The following sample creates a TAPE DD in the form: //TAPE DD UNIT=(CART,,DEFER),VOL=(,,,255),EXPDT=99000, // BLKSIZE=61400

OUTPUT TAPE DSNAME &USER..LP.&DB..&TS..P&PART4(+1)
UNIT CART GDGLIMIT 4 USER1(BLKSIZE=61400)

The following sample unloads individual statements to a specific tape DD:

OUTPUT TAPE1 UNIT CART ID O1   DSNAME NGT.UNLD.&DB..&TS..P&PART
OUTPUT TAPE2 UNIT CART ID O2   DSNAME NGT.UNLD.&DB..&TS..P&PART
                                                             
UNLOAD UNLOADDN TAPE1 PART 1 SELECT * FROM customer.table
UNLOAD UNLOADDN TAPE2 PART 2 SELECT * FROM customer.table

If you are specifying multiple and OUTPUT statements, use the ID. BMC AMI Utilities match the OUTPUT statement with the utility statement.

Information
Example
OUTPUT TAPE1 UNIT CART ID O1
    DSNAME NGT.T&OBID..P&PART..D&DATE..&UNIQ
OUTPUT TAPE2 UNIT CART ID O2     
    DSNAME NGT.T&OBID..P&PART..D&DATE..&UNIQ    

UNLOAD UNLOADDN TAPE1 PART 1 SELECT * FROM customer.table
UNLOAD UNLOADDN TAPE2 PART 2 SELECT * FROM customer.table

STACK

Specifies if you can contiguously stack the output data sets on the same tape volumes.

Value

Description

YES

Specifies if you can stack similar output data sets as successive files on one logical tape volume, where a logical tape volume can consist of a multi-volume aggregate. Within one utility execution, output data sets are stacked on a logical tape volume of the same usage type. The default value of the STACK option is YES.

NO

Specifies if you cannot contiguously stack the output data sets on tape.

Warning

Important

The following OUTPUT tape options are supported only by BMC AMI Copy and BMC AMI Recover, and are ignored if they appear in an OUTPUT statement for all other BMC AMI Utilities:

  • REALDD
  • STACK CABINET
  • TRTCH

STACK option is ignored if UNIT type is DASD.


 

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

BMC AMI Reorg for Db2 13.1