HELPLIB.HLB  —  CMS  CREATE  GROUP
    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.
Close Help