Working with VSAM name models

You use a VSAM name model to tell RUV how to build the data set name for an Instant Snapshot copy. A VSAM name model is a defined record in the RUV repository. You can use the RUVZSM0 utility to work with VSAM name models as follows:

• Create a VSAM name model with the ADD VSAM_NAME_MODEL command.
• Modify an existing VSAM name model with the UPDATE VSAM_NAME_MODEL command.
• Delete one or more VSAM name models with the DELETE VSAM_NAME_MODEL command.
• Obtain a report about the information that is stored in one or more VSAM name models with the REPORT VSAM_NAME_MODEL command.

This topic contains the following information:

• • ADD VSAM_NAME_MODEL command
  • UPDATE VSAM_NAME_MODEL command
  • DELETE VSAM_NAME_MODEL command
  • REPORT VSAM_NAME_MODEL command
  • VSAM_NAME_MODEL keyword
  • VSAM_FILE_MASK keyword
  • REPLACE keyword
  • VSAM name model examples

ADD VSAM_NAME_MODEL command

Use the ADD VSAM_NAME_MODEL command to create a VSAM name model for RUV to use when it creates an Instant Snapshot copy. Use the following syntax:

UPDATE VSAM_NAME_MODEL command

Use the UPDATE VSAM_NAME_MODEL command to change an existing VSAM name model. Use the following syntax:

DELETE VSAM_NAME_MODEL command

Use the DELETE VSAM_NAME_MODEL command to delete one or more existing VSAM name models. Use the following syntax:

REPORT VSAM_NAME_MODEL command

Use the REPORT VSAM_NAME_MODEL command to obtain information about one or more existing VSAM name models. Use the following syntax:

VSAM_NAME_MODEL keyword

The VSAM_NAME_MODEL keyword defines a unique identifier for a VSAM name model. You can use the VSAM_NAME_MODEL keyword on the ADD, UPDATE, DELETE, and REPORT commands to identify the model that you want to work with.

On the ADD or UPDATE command, specify a single specific user-defined name (1–32 characters) as the value of the VSAM_NAME_MODEL keyword value. On the DELETE or REPORT command, you can specify multiple values, each of which can be a specific name or a mask (using the * and ? wildcard characters).

VSAM_FILE_MASK keyword

The VSAM_FILE_MASK keyword defines the mask for RUV to use when it constructs the data set name of the Instant Snapshot copy for both a VSAM file or a sequential file.

You can code multiple instances of the VSAM_FILE_MASK keyword on the ADD or UPDATE VSAM_NAME_MODEL command. Each instance identifies one or more input VSAM files or sequential files for which the mask should apply when RUV constructs output copies of those files. The order in which you code the VSAM_FILE_MASK keywords is important because RUV uses the first mask that matches the input data set name.

The VSAM_FILE_MASK keyword has two values:

• The first value (dsn_mask44) identifies the input VSAM or sequential file or files for which the mask should apply. Specify a specific name (using all literal values) or a generic name (using any combination of literal values and wildcard characters * and ?). If the name of the data set to be copied matches the first value, RUV selects this mask for constructing the data set name of the output copy.
• The second value (dsn.variables) specifies the output data set name mask. You can specify any combination of literal values, substitution variables (user-defined, RUV-defined, and system-defined variables), and node separators that results in a valid data set name. For more information, see Creating User Variables and Using-variables.

When you are using multiple VSAM_FILE_MASK keywords, be sure to code them in the order of the most specific to the least specific. RUV processes them in the order that you code them.

REPLACE keyword

Use the REPLACE keyword on the ADD or UPDATE VSAM_NAME_MODEL command to specify whether RUV should replace an existing data set with the new copy. Specify one of the following values. The default value is NO.

• NO
  If a data set with the constructed data set name already exists in the catalog, do not replace it with the new copy.
• YES
  If a data set with the constructed data set name already exists in the catalog, replace it with the new copy.

VSAM name model examples

The following example of a VSAM name model specifies two VSAM file masks. The first mask applies to all input VSAM data sets that have the high-level qualifiers PAYROLL.TAXWTHLD. The second mask applies to all input VSAM data sets that have the high-level qualifier PAYROLL.

This VSAM name model is used in an RUV job that produces copies of the following VSAM data sets:

RUV constructs output data set names for each of these data sets as follows: