GENJCL option descriptions
RECOVER
Specify that the JCL is for recovery. Specify XUNCHANGED to exclude unchanged objects from the recover JCL. Also, specify the type of recovery you want.
Option | Description |
|---|---|
XUNCHANGED | For local point-in-time recoveries, this option instructs ARMBGEN to analyze SYSLGRNX information and identify those objects that have not been changed between the recovery time and the current time. For full subsystem recoveries (local point-in-time recoveries via a conditional restart), ARMBGEN analyzes the BMC AMI Recovery Manager log range file (ARMLGRNX DD) to identify unchanged objects. The objects that are marked as UNCHANGED are excluded from the recovery JCL. Objects in WRITE PENDING status are included in the recovery even if they are still marked as UNCHANGED. This option can significantly reduce the time required for recovery by eliminating unnecessary processing. Updates are not logged for indexes unless they were created with the COPY YES attribute. XUNCHANGED processing does not occur for indexes unless they have the COPY YES attribute. This option is ignored if you select a recovery to the current time or if you specify SITETYPE=RECOVERY. |
TOCURRENT | This type of recovery is the default. When you specify a recovery to the current time, the most recent full and incremental copies are used to recover the spaces. Then, the Db2 log records are used to make the space's current. The RECOVER syntax defaults to TOCURRENT. |
TOLOGPOINT | Specify this type of recovery when you want to recover to a log point (RBA or LRSN). You must supply the value (a 12-digit hexadecimal number). |
TORESTARTRBA | Specify this type of recovery when making preparations at the local site to recover applications at a recovery site. When you specify this type of recovery, ARMBGEN retrieves the RBA stored by ARMBSRR. This action ensures that the recovery JCL will be ready for use at a recovery site after the system-resource recovery jobs generated by ARMBSRR are run. This option is for local site use only and should not be used at a recovery site as part of disaster recovery. |
TOCOPY | Specify this type of recovery to recover to a specific full image copy or an incremental image copy registered in SYSIBM.SYSCOPY. You identify the copy by specifying a number from 0 through 99, where 0 represents the most recent copy made and 99 represents the 100th previous copy. For the purpose of identifying the copy, a DFSMS concurrent copy is registered in SYSIBM.SYSCOPY is counted as an image copy. When you specify OBJECTSET syntax for BMC AMI Recover with TOCOPY syntax, BMC AMI Recovery Manager generates the following syntax: RECOVER OBJECTSET creator.name TOCOPY LASTCOPY(-1) |
TOFULLCOPY | Specify this type of recovery to recover only to a specific full image copy registered in SYSIBM.SYSCOPY. You identify the copy by specifying a number from 0 through 99, where 0 represents the most recent copy made and 99 represents the 100th previous copy. BMC AMI Recovery Manager ignores any existing incremental image copies when searching for the specified previous copy. For the purpose of identifying the copy, a DFSMS concurrent copy is registered in SYSIBM.SYSCOPY is counted as an image copy. |
TOQUIESCE | Specify this type of recovery when you want to recover each object to a specified quiesce point registered in SYSIBM.SYSCOPY by the Db2 QUIESCE command. Specify the quiesce point by using the keyword MINUS n, where n is a number from 0 through 99. The default is MINUS 0, the most recent quiesce point. When you specify OBJECTSET syntax for BMC AMI Recover with TOQUIESCE syntax, BMC AMI Recovery Manager generates the following syntax: RECOVER OBJECTSET creator.name TOLOGPOINT LASTQUIESCE(0) |
TOCOMMONRECPT | Specify this type of recovery when you want to recover all objects to the same point. Similar to recover to quiesce, you identify the common point by specifying a number from 0 through 99, where 0 is the most recent common point. This option considers only recovery points that are common to all table spaces in the object set. |
TOTIMESTAMP | This option requires the Recovery Management for Db2 solution password and the recovery utility is BMC AMI Recover. The option is valid on both data-sharing systems and non-data-sharing systems. The timestamp recovery feature of Recovery Management for Db2 solution uses inflight resolution technology to perform a consistent point-in-time recovery to any user-specified timestamp. The Recovery Management solution translates the timestamp to a log point, recovers the objects, then resolves all inflight units of work for both data-sharing and non-data-sharing systems.
For more information about timestamp recovery, see the Recovery Management for Db2 documentation. |
TOLOGMARK | Specify this type of recovery to recover to a BMC AMI Log Master for Db2 log mark, which is registered in the BMC AMI Log Master ALPMARK table. You identify the log mark by specifying the log mark name and a version number from 0 through 99, where 0 represents the most recent log mark made and 99 represents the 100th previous log mark. The generated JCL will recover to the log point represented by the log mark. This option requires the use of a Recovery Management for Db2 solution password and use of BMC AMI Recover as the recovery utility. |
BACKUP
Use the command GENJCL BACKUP to create backup JCL for the specified object set. The copy utility, type of copy, and all options for the object set are retrieved from the repository.
You can have multiple GENJCL BACKUP statements in the ARMIN data set.
Option | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
XUNCHANGED | When you use this option, ARMBGEN analyzes SYSCOPY and SYSLGRNX information to exclude spaces that have not changed since the last backup. This option can significantly reduce the time required for backing up by eliminating unnecessary processing. You must decide the frequency of full system backups versus backups that exclude unchanged spaces. For example, you could make backups that exclude unchanged objects on a daily basis, while performing a full system backup once per week. | ||||||||||
COPY _ IMAGECOPY_SLB | Use this option to generate BMC AMI Copy COPY IMAGECOPY system-level backup job. Specify Copy All Indexes Yes from General backup options to include all indexes for the table spaces that are included in the object set. This is the INDEXES YES option of BMC AMI Copy. | ||||||||||
REGISTEROCC | Use this option to specify whether online consistent copies should be registered in SYSCOPY or BMCXCOPY.
| ||||||||||
COPYTOCOPY | The COPYTOCOPY utility makes image copies from an image copy that was taken by the COPY utility.
|
OBJECTSET
You must provide an object set name in the form creator.name . You can use a wildcard pattern to specify multiple object sets in a single GENJCL statement. If BMC AMI Recovery Manager finds an explicit object set name for an object set created by the ARMBGPS program, BMC AMI Recovery Manager processes the entire set of object sets.
Option | Description |
|---|---|
ALTLOAD | This option enables you to specify a load library that contains BMC AMI Recovery Manager. This load library is generated in steplibs. |
UPDATE | Update object set backup and recovery option settings for the specified object set or object sets. This is the OBJECTSET UPDATE feature of the ARMBGRP program and all options are described in detail in ARMBGRP—Object set creation and maintenance. |
RECOVER_OPTIONS | Specifies the recovery options to be updated. For a syntax diagram of the recover options, see Syntax-for-updating-object-set-options. For descriptions of all options that you can update, see Copy-and-recover-utility-options. |
COPY_OPTIONS | Specifies the copy options to be updated. For a syntax diagram of the copy options, see Syntax-for-updating-object-set-options. For descriptions of all options that you can update, see Copy-and-recover-utility-options. |