Skip to Content

Symbolic variables in post-recovery image copy data set names

With BMC AMI Recovery Manager, you can request that image copies of the table spaces that you recover be made immediately after the recovery completes.

(BMC.DB2.SPE2410) BMC AMI Recovery Manager allows the use of the concatenation operator (||) to append text to symbolic variables. For example, &TS||A1. The concatenation operator is supported wherever data set name patterns are specified.

Related topic

Recovering object sets

If you supply data set names instead of accepting BMC AMI Recovery Manager defaults, you can construct those names using the symbolic variables that are shown in the following table.

Symbol

Result 1

&ATTACH

Data sharing object set name

&DATE

Current date (in yymmdd format) 2

&DAY

Current day (in dd format) 2

&DB

Name of the database containing the space that is being copied

&DSNUM, &PART

Number of the data set or partition being copied 2

&HOUR

Current hour (in hh format) 2

&ICTYPE

Type of image copy

The clone instance value of the object that will be copied

&JDATE

Current date (in yyddd Julian date format) 2

&JDAY

Current day (in ddd Julian format) 2

Job name used in the JCL 

&LDSNUM, &LPART

(BMC.DB2.SPE2510)

Number of the data set or partition being copied (long name support) 2

&MINUTE

Current minute (in mm format) 2

&MONTH

Current month (in mm format) 2

The partition number of the object (always a 4-digit number, with leading zeros)
The partition number of the object (always a 5-digit number, with leading zeros)

&SECOND or &SEC

Current second (in ss format) 2

&SEQ

(BMC.DB2.SPE2510)The sequence number that increments with each reference. The sequence number restarts at 1 for each job step and is used to provide unique output data set names.

(BMC AMI Recover only) Table space or index space

&SSID

ID of this Db2 subsystem

Step name used in the JCL (PROC names are ignored) 

&TIME

Current time (in hhmmss format) 2

&TS

Name of the table space that is being copied

&TYPE

Type of output that is being produced

  • LP—Local site primary copy
  • LB—Local site backup copy
  • RP—Remote site primary copy
  • RB—Remote site backup copy

&UNIQ or &UQ

1- to 8-character value, based on the system clock, that is used to generate unique copy data set names

The first character is always an uppercase letter. Each remaining character is either an uppercase letter or a numeral from 0 through 9.

&USERID, &USER, &UID

TSO user ID

The first 8 characters of the utility ID

&YEAR

Current year (in yy format)

1 The maximum total length that is allowed for a data set name is 44 bytes.

2 Symbols with a numeric result must be prefixed by one or more alphabetic characters.

 

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

BMC AMI Recovery Manager for Db2 13.1