Creates one or more empty groups. Format: CREATE GROUP group-name[,...] "remark"
1 – Command Parameters
group-name Specifies a name for the group. CMS reports an error if you specify an existing group or class name. (Group and class names must be unique.) However, if a previously used group or class name has been removed with the DELETE GROUP or DELETE CLASS command, you can reuse that name with CREATE GROUP. A group name can also be a list of group names separated by commas. Wildcards are not allowed. remark Specifies a character string for the creation remark of the group to be logged in the history file with this command. The remark is enclosed in quotation marks. If no remark was entered, a null remark ("") is logged.
2 – Description
The CREATE GROUP command establishes a group. After a group is created, you can place any related set of elements or groups in that group by using the INSERT ELEMENT or INSERT GROUP command. The CREATE GROUP command does not automatically place any elements or groups in the created group.
3 – Qualifiers
3.1 /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.
3.2 /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. If you specify /OCCLUDE=NOGROUP, CMS creates a group in every library in the search list.
4 – Example
CMS> CREATE GROUP TIME_TST "files for time tests" %CMS-S-CREATED, group DISKX:[PROJECT.CMSLIB]TIME_TST created This command creates a group named TIME_TST. Once the group name is established, elements can be placed in the group with the INSERT ELEMENT command.