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.