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

MATRIX keyword


Use the MATRIX keyword to define a series of paired values that determine, based on the size of the input data set or the database type, the model to be used when the Image Copy utility creates an image copy data set.

The MATRIX keyword defines a series of paired values:

  • For a data set-size matrix, each pair consists of a data set size and the name of the dynamic allocation model to use if the input data set is smaller than the defined size.
  • For a database-type matrix, each pair consists of a database type identifier and the name of the dynamic allocation model to use for that database type.

Uses

Required on the MODEL control statement if you do not specify any other keywords except the NAME keyword.

Related keywords

Refer also to the following keywords:

  • NAME
  • MTRXTYPE

Syntax for a data set-size matrix

MATRIX((size1,model1),(size2,model2),...(*,model5))

Syntax for a database-type matrix

MATRIX((dbtype1,model1),(dbtype2,model2,*,model3))

Values for a data set-size matrix

Specify up to five paired values. Each pair consists of two values:

  • The input data set size (1-7 digits) and one of the following literals:
    • K to indicate the size in kilobytes
    • M to indicate the size in megabytes
    • G to indicate the size in gigabytes
    • T to indicate the size in tracks
    • C to indicate the size in cylinders
  • The name of the dynamic allocation model to use if the input data set is smaller than the defined size

    Do not specify the name of another matrix.

    Enclose the pair of values within parentheses, and separate the values with a comma. Enclose all of the pairs of values within another set of parentheses, and separate the pairs from other pairs with a comma.

    The last pair in the series of values must specify an asterisk for the input data set size. The associated model is used for all data sets that are not covered by the other pairs in the series.

Values for a database-type matrix

Specify up to three paired values. Each pair consists of two values:

  • Database type:
    • FF (Full Function)
    • FP (Fast Path)
    • HAL (HALDB)
  • The name of the dynamic allocation model to use if the input data set is for the name database type

    Enclose the pair of values within parentheses, and separate the values with a comma. Enclose all of the pairs of values within another set of parentheses, and separate the pairs from other pairs with a comma.

    The last pair in the series of values must specify an asterisk for the input database type. The associated model is used for all data sets that are not covered by the other pairs in the series.

    Include keyword MTRXTYPE(T) on the MATRIX keyword to identify the matrix as a database type matrix.

Default

None

Related topic

 

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