Defining VSAM groups

You define VSAM groups by using the ADD VSAM_GROUP_DEFINITION command of the RUVZSM0 utility.

Using the ADD VSAM_GROUP_DEFINITION command

Use the ADD VSAM_GROUP_DEFINITION command to create a VSAM group record in the repository.

This group can have a name of up to 32 characters. It may have a comment, but must have at least one VSAM file or DSN mask defining which file(s) with which to work. Each DSN mask may be fully qualified or have wildcards. The mask(s) will resolve to individual VSAM files at each run time using only files registered in the repository.

Coding the ADD VSAM_GROUP_DEFINITION command

To code an ADD VSAM_GROUP_DEFINITION statement, use the following syntax:

ADD VSAM_GROUP_DEFINITION(name32)
{ COMMENT(comment_fields) }
VSAM_FILE(dsn44,
{ INCLUDE | EXCLUDE }
)
VSAM_FILE( ... )
;

COMMENT keyword

The COMMENT keyword is available for use with RUV VSAM group commands and keywords that describe RUV VSAM groups. You can use it for documentation or other purposes to help you control recovery information.

Code the COMMENT keyword as shown in the following example. For the comment value, you can code a maximum of 200 bytes in four 50-byte fields. Enclose each field in quotes if the field contains any spaces. Enclose all fields in parentheses.

COMMENT('this is a comment'
        'this is more information'
        'this is a third line of information'
        'this is the last line of the comment')

VSAM_FILE keyword

Use the required VSAM_FILE keyword to identify the VSAM data set names to be selected or excluded as members of VSAM_GROUP_DEFINITION. The VSAM_FILE can have masking or be fully qualified data set names. You can select the same VSAM file for more than one VSAM group. Each VSAM_GROUP is completely independent of all other VSAM_GROUP.

EXCLUDE
Use the optional EXCLUDE value to prevent a particular VSAM data set from being selected into a VSAM group. For example, if you have a list of VSAM data sets that were selected by using a wildcard, you may want to specify one or more data sets in that list for exclusion from the group.
INCLUDE
Use the optional INCLUDE value to select one or more particular VSAM data sets in a group.

Note

EXCLUDE and INCLUDE are mutually exclusive values. During RUV processing of groups, the EXCLUDE value has precedence over the INCLUDE value.