DSGROUPCONTROL

Syntax

DSGROUPCONTROL DEFAULTTYPE=<default rule keyword>

Syntax explanations

For DSGROUPCONTROL command, you can use the following keywords:

• STORGRP—All data sets with the same Storage Group name are aggregated together into the Data Set Group with the name equal to the Storage Group name.
• STORCLS—All data sets with the same Storage Class name are aggregated together into the Data Set Group with the name equal to the Storage Class name.
• DATACLS—All data sets with the same Data Class name are aggregated together into the Data Set Group with the name equal to the Data Class name.
• MGMTCLS—All data sets with the same Management Class name are aggregated together into the Data Set Group with the name equal to the Management Class name.
• Q1—All data sets with the same first qualifier are aggregated together into the Data Set Group with the name equal to the first qualifier.
• Q2—All data sets with the same second qualifier are aggregated together into the Data Set Group with the name equal to the second qualifier.
• Q1C1—All data sets with the same first character of the first qualifier are aggregated together into the Data Set Group with the name equal to the first character.
• Q1C2—All data sets with the same first two characters of the first qualifier are aggregated together into the Data Set Group with the name equal to the first two characters.
• Q1C3—All data sets with the same first three characters of the first qualifier are aggregated together into the Data Set Group with the name equal to the first three characters.
• Q1C4—All data sets with the same first four characters of the first qualifier are aggregated together into the Data Set Group with the name equal to the first four characters.
• Q1C5—All data sets with the same first five characters of the first qualifier are aggregated together into the Data Set Group with the name equal to the first five characters.
• Q1C6—All data sets with the same first six characters of the first qualifier are aggregated together into the Data Set Group with the name equal to the first six characters.
• Q1C7—All data sets with the same first seven characters of the first qualifier are aggregated together into the Data Set Group with the name equal to the first seven characters.

Rules

• If you do not specify the DSGROUPCONTROL command, UIE uses the default rule Q1C3, that is, aggregate the data sets together with identical first three characters of the high order qualifier.
• The DCOLLECT VSAM (A type) record contains only the data set name. If you want to process the A type records to obtain VSAM information, your DSGROUPCONTROL commands can use only the Q1, Q2, and Q1C1 - Q2C7 parameters. If your DSGROUPCONTROL commands use the STORGRP, STORCLS, DATACLS, or MGMTCLS parameters, UIE will skip the A type records.

• If you want to request the default rule

  DSGROUPCONTROL DEFAULTTYPE=Q1

  be aware that using this default can create a large number of Data Set Groups. Please note that UIE has an internal limit of 5000 different Data Set Groups.

• With any default rule, UIE aggregates temporary data sets into a special group called _TEMP_. UIE assumes that the Temporary data set is the data set with the name

  SYSnnnnn.Tnnnnnn.*

Examples

In this example, all data sets that are not assigned to a DSGROUP by existing DSGROUP commands will be assigned to a DSGROUP by the first two characters of the first qualifier.