DSGROUP

Use the DSGROUP command to combine several data sets into a data set group.

You can use DSN patterns, storage groups, storage classes, management classes, and data classes as selection values for assigning data sets to data set groups. The DSGROUP command works in a manner similar to the SUITE, APPL, and other grouping commands. Each data set name is compared sequentially to all DSGROUP commands. If a match is found, the data set is assigned to the DSGROUP. If no match is found, the data set is assigned to a DSGROUP based on the default data set grouping rules. For more information, see DSGROUPCONTROL.

Related topic

Command-and-syntax-reference

Syntax

DSGROUP grp_name  Q1=<pattern>  Q2=<pattern>  Q3=<pattern>
                                DSN=<pattern>
                                STORGRP=<storgrp_list>
                                STORCLS=<storcls_list>
                                DATACLS=<datacls_list>
                                MGMTCLS=<mgmtcls_list>

Syntax exceptions

  • Q1, Q2, and Q3 are used to specify patterns for the first (high level), second, and third qualifiers of a Data Set Name respectively. When these parameters are used, the pattern is compared with the corresponding Data Set Name qualifier. The period (.) characters delimiting the qualifier are not considered to be part of the pattern.
  • DSN is used to specify a pattern for the Data Set Name as a complete character string. In this case, all period (.) delimiters are considered part of the string and should match the pattern.
  • STORGRP is used to specify a list of storage groups. Storage group is a list of volumes managed by SMS according to specified rules.
  • STORCLS is used to specify a list of storage classes. Storage class is a list of data sets managed by SMS according to some performance and availability requirements.
  • DATACLS is used to specify a list of data classes. Data class is used by SMS to manage data set allocation parameters.
  • MGMTCLS is used to specify a list of management classes. Management class is used by SMS to control data set migration, backup, and retention.

Rules

  • All parameters except grp_name are optional.
  • grp_name can be up to 12 characters long.
  • All temporary data sets are combined into special group called _TEMP_.
  • All lists are comma separated.
  • 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 DSGROUP commands can use only the DSN, Q1, Q2, or Q3 parameters. If your DSGROUP commands use the STORGRP, STORCLS, DATACLS, or MGMTCLS parameters, UIE will skip the A type records.
  • All patterns are strings with any number of question marks (?), replacing one character, and one or two asterisks ( *), replacing any number of characters.
  • If two asterisks ( *) are in the pattern, they must be at the beginning or at the end of the pattern. For example, *ABC* or A*BC* is correct, but A*BC*DE is not correct.

  • You can use the following patterns:

    *pattern*
    pattern*
    *pattern

    In all three cases, patterns can have any number of question marks (?) with the following exception:

    A question mark (?) cannot follow an asterisk (*). This syntax is not treated as an error, but is processed as if the question mark (?) were not present. The correct syntax for specifying one or more characters is a question mark followed by an asterisk (?*). To specify two or more characters, use two question marks followed by an asterisk (??*) and so on.

    For example,

    • ?*ABC* or ABC?* or ?*ABC is correct.

    • *?ABC* or ABC*? or *?ABC is incorrect.

      Important

      For debugging purposes, you can produce a Data Set Grouping Report in the DEBUG file by using the command

      SETDEBUG DCDS

      This report contains all data sets found in the DCOLLECT file and shows to which DSGROUP they were assigned.

Examples

  • DSGROUP SYSTEM Q1=SYS*

    In this example, the data set group SYSTEM will be assigned all data sets that have a high level qualifier starting with SYS.

  • DSGROUP DB2IND Q1=DB2* Q2=INDEX

    In this example, the data set group DB2IND will be assigned all data sets that have a high level qualifier that starts with DB2 and a second qualifier of INDEX, such as the following data set names:

    DB2.INDEX
    DB2A.INDEX.BACKUP
    DB2V80.INDEX
  • DSGROUP DB2IND DSN=DB2*.INDEX

    In this example, the data set group DB2IND will be assigned all data sets that have a high level qualifier that starts with DB2 and an ending qualifier of INDEX, such as the following data set names:

    DB2.ABCD.INDEX
    DB2A.ABCD.XYZ.INDEX
    DB2V80.ABC.DEF.XYZ.INDEX
  • DSGROUP SYSPROCS Q1=SYS* DSN=*PROCLIB*

    In this example, the data set group SYSPROCS will be assigned all data sets that have a high level qualifier that starts with SYS and any other qualifier that contains the value PROCLIB, such as the following data set names:

    SYS1.PROCLIB
    SYS2.PROCLIB
    SYS1.SYSPROG.PROCLIB
    SYS1.USER.PROCLIB.BACKUP
    SYS1.PROCLIB2
  • DSGROUP OTHER

    In this command no parameters are specified, which means that any data set can satisfy this command. All data sets that were not assigned to a DSGROUP by any previous commands are assigned by this command to the group OTHER. This command can only be the last DSGROUP command in command file.

 

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