Deletes one or more groups from a CMS library.

       Format:

          DELETE GROUP  group-expression "remark"

1  –  Restrictions

    o  You cannot delete a group that contains any elements or groups
       unless you specify the /REMOVE_CONTENTS qualifier.
    o  You cannot delete a group that belongs to another group.
    o  You cannot delete a group that has read-only access. (Use the
       MODIFY GROUP/NOREAD_ONLY command to change the access to the
       group.)

2  –  Command Parameters

 group-expression

    Specifies the group or groups to be deleted. A group expression
    can be one or more group names, a wildcard expression, or a list
    of these separated by commas.

 remark

    Specifies a character string to be logged in the history file
    with this command, usually used to explain why the command was
    entered. The remark is enclosed in quotation marks. If no remark
    was entered, a null remark ("") is logged.

3  –  Description

    The DELETE GROUP command deletes a group from a CMS library. If
    the group is not empty and the /REMOVE_CONTENTS qualifier is
    not specified, or if the group belongs to another group, CMS
    returns an error and does not delete the group.

    Even though a group is deleted, records of transactions that
    created and used the group are retained in the library history.
    You can reuse the deleted group name to create a new group.
    However, there is no distinction between the two groups in the
    library history, except that their transactions are separated by
    entries for DELETE GROUP and CREATE GROUP commands.

    To determine which elements and groups belong to a group, use the
    SHOW GROUP command with the /CONTENTS qualifier.

4  –  Qualifiers

4.1    /CONFIRM

    Controls whether CMS prompts you for confirmation before each
    transaction.

    When you specify /CONFIRM and run CMS in interactive mode, CMS
    prompts you for confirmation. If you type YES, ALL, TRUE, or 1,
    CMS executes the transaction.  If you type NO, QUIT, FALSE, 0,
    or press RETURN or CTRL/Z, no action is performed. If you type
    any other character, CMS continues to prompt until you type an
    acceptable response.

    CMS does not prompt for confirmation in batch mode.

4.2    /LOG (D)

    Controls whether CMS displays success and informational messages
    on the default output device. By default, if the command executes
    successfully, CMS displays a success message. If you specify
    /NOLOG, success and informational messages are suppressed. Any
    warning, error, or fatal error messages are displayed regardless
    of whether /LOG or /NOLOG is specified.

4.3    /OCCLUDE[=option,...]

    Controls whether CMS selects the first instance of the specified
    object, or all instances of the specified object in the library
    search list. The options field contains one or more keywords
    associated with the name of the object. The options field can
    contain the following keywords:

       ALL--equivalent to GROUP
       GROUP (D)
       NOGROUP
       NONE--equivalent to NOGROUP

    You can specify either ALL, NONE, or the [NO]GROUP keyword.

    By default, CMS performs occlusion for all objects; that is, CMS
    selects only the first occurrence of a specified object.

4.4    /REMOVE_CONTENTS

    Controls whether CMS removes elements and groups from the specified
    group prior to deleting the group. When /REMOVE_CONTENTS is
    specified CMS displays an informational message for each element or
    group that is removed from the group.

5  –  Example

    CMS> DELETE GROUP TIME_TST "superseded by comparison tests"
    %CMS-S-DELETED, group DISKX:[PROJECT.CMSLIB]TIME_TST deleted

      This command deletes the group named TIME_TST.