VMS Help CMS, MODIFY, GROUP  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Changes the characteristics of the specified group or groups.

       Format:

          MODIFY GROUP  group-expression /qualifier "remark"

1 - Restrictions

    o  You cannot change the attributes of a group that has been set
       to READ_ONLY. If a group has read-only access, you must change
       it to NOREAD_ONLY to change any other characteristics.

    o  You must specify one or more of the following qualifiers:
       /NAME, /[NO]READ_ONLY, or /REMARK.

2 - Command Parameters

 group-expression

    Specifies the group to be modified. A group expression can be a
    group name, 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. Note that this parameter
    and the string on the /REMARK qualifier are unrelated.

3 - Description

    The MODIFY GROUP command changes the characteristics of one or
    more groups. You can alter the following characteristics:

    o  The name of the group.
    o  The access to the group (READ_ONLY or NOREAD_ONLY). You cannot
       change the contents of a group that has been set READ_ONLY.
    o  The creation remark that is associated with the group.

    Use the SHOW GROUP command to display group characteristics.

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 - /NAME=group-name

    Specifies the new name for the group. You cannot change the
    name of a group that has been set to READ_ONLY. The new group
    name cannot be the same as an existing group or class name.
    Wildcards and comma lists are not allowed. If you specify the
    /NAME qualifier, you cannot use wildcards or a comma list in the
    group name parameter, nor can you use a wildcard for the /NAME
    qualifier.

 4.4 - /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.5 - /READ_ONLY

 4.6 - /NOREAD_ONLY

    Establishes or alters the read-only attribute of a group. To
    change the characteristics of a READ_ONLY group, you must set
    the class to NOREAD_ONLY. NOREAD_ONLY is the default attribute of
    a group when it is created with the CREATE GROUP command.

 4.7 - /REMARK="string"

    Specifies a new remark to be substituted for the creation remark
    that is associated with the group.

5 - Example

    CMS> MODIFY GROUP TESTS/READ_ONLY "coordinate before changing
    contents"
    %CMS-S-MODIFIED, group DISKX:[PROJECT.CMSLIB]TESTS modified

      This command sets the group TESTS to READ_ONLY. Once the group
      is set to READ_ONLY, the contents cannot be changed.