Space announcement We are no longer updating this space, and you cannot comment on this space. The RECOVERY PLUS for IMS component is now documented in BMC AMI Backup and Recovery for IMS.

TYPERUN keyword


You can use the TYPERUN keyword to perform the following tasks:

  • Request a simulated recovery
  • Verify control statements and other elements of the recovery
  • Estimate how long a recovery job step will take to run
  • Specify that the utility should create Archive Image copies

Related topics

When the Recovery utility performs a simulated recovery, it reads all input data sets (logs, change accumulations, and image copies), but it does not write the output databases, indexes, and indirect list data sets (ILDSs); they are treated as DD DUMMY).

In a simulated recovery, the Recovery utility always uses AUTH(N). It does not access registered databases for authorization. You can request simulation for the full recovery, single-phase method. The two-phase method, which is specified with the RESTORE(Y) keyword, and the roll-forward method are not supported.

The BLDINDEX(Y) keyword is not ignored; although the index rebuild process is not performed, the rebuild process is simulated. However, if the index build process is required to perform a hierarchical scan of the target database, the rebuild process cannot be simulated. For example, a hierarchical scan is required if the index was built with a concatenated key or if a single partition of a HALDB is being recovered.

The BLDILDS(Y) or BLDILDS(R) keyword is not ignored; although the ILDS rebuild process is not performed, the rebuild process is simulated.

Uses

Optional on the GLBL control statement.

Related keywords

None

Syntax

TYPERUN(value)

Values

Specify one of the following values:

  • SCAN
    Validate control statements, and validate and report the data set name generated by the Data Set Name user exit.
  • PULLLIST
    Validate control statements, validate and report the data set name generated by the Data Set Name user exit, and create a tape and cartridge pull list. This value provides the same results as specifying the SCAN(Y) keyword.
  • SIMULATE
    Simulate the recovery: validate control statements, create a tape and cartridge pull list, validate and report the data set name generated by the Data Set Name user exit, read all input data sets, but do not write the output databases, indexes, and ILDSs.
  • ESTIMATE
    Estimate the recovery time. This option provides a quick time estimate of how long a recovery job step will run. The estimated time is based on various inputs, such as:

    • Image copy data set size
    • Change accumulation data set size
    • Log data set size
    • Real-time data set allocation/deallocation speed
    • Real-time I/O speeds
    • Access speeds for RECON data sets

    However, this process neither allocates nor reads actual input data sets.

    Important

    You must select DBRC(Y) to use this option.

  • ARCHIVIC
    For the utility to create Archive Image copies.

Default

No default value. If the TYPERUN keyword is omitted, the recovery is performed.

 

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