Skip to Content
Information
Space announcement This space now contains the documentation for all the following components:
  • CHANGE ACCUMULATION PLUS
  • IMAGE COPY PLUS
  • RECOVERY MANAGER for IMS
  • RECOVERY PLUS for IMS
We are no longer updating the individual documentation spaces for these components. For the latest documentation, see BMC AMI Backup and Recovery for IMS 5.2.

Mask processing

The Recovery utility applies the ALTDBNAM mask as follows:

  • If the DSN mask contains more nodes than the source DSN, the utility adds the extra mask nodes to the end of the output DSN.
  • If the DSN mask contains fewer nodes that the source DSN, the utility discards the extra source DSN nodes (from the end of the source DSN).
  • If a mask node does not contain an asterisk (*), the utility examines each character in the mask:
    • If the utility encounters a question mark (?) or a percent sign (%) in the mask, the utility copies the corresponding character in the source DSN into the same position in the output DSN.
    • If the mask node contains more ? or % characters than the corresponding node of the source DSN, the utility skips the extra ? or % characters.
    • If the utility encounters a normal (alphanumeric) character in the mask, the utility copies that character to the corresponding location in the output DSN.

Related topics

Recovering-to-alternate-data-sets

  • If the mask contains a single asterisk combined with one or more other standard DSN characters, the utility converts the mask internally. The utility replaces the asterisk in the mask with as many ? characters as needed to make the masking node the same length as the source DSN node. The following examples demonstrate this conversion if the source DSN node length is 4:

    Node before conversion

    Node after conversion

    *XX

    ??XX

    XX*

    XX??

    X*X

    X??X

  • For VSAM data sets, the utility saves the right-most suffix for the data and index component DSNs and appends them to the resulting output DSNs after the DSN mask processing is complete. The utility ignores data and index component DSN suffixes during DSN mask processing.

 

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

BMC AMI Backup and Recovery for IMS 5.1