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

    Displays information about one or more groups in a CMS library.

       Format:

          SHOW GROUP  [group-expression]

1 - Command Parameters

 group-expression

    Specifies the group to be listed. If you do not supply a
    group expression, CMS lists all groups in the library. A group
    expression can be a group name, a wildcard expression, or a list
    of these separated by commas.

2 - Description

    The SHOW GROUP command lists the names of all established groups
    in alphabetical order, along with the remark logged at the time
    each group was created or modified.

3 - Qualifiers

 3.1 - /APPEND

    Controls whether CMS appends the command output to an existing
    file, or creates a new file. If you specify /APPEND and the output
    file does not exist, CMS creates a new file. If you do not provide
    an output file specification (see the description for /OUTPUT),
    the output is appended to SYS$OUTPUT.

 3.2 - /BRIEF

    The /BRIEF qualifier displays only group names.

 3.3 - /CONTENTS[=n]

    Lists the group name and creation remark, along with the names of
    any elements or groups contained within the specified group.

    You can specify an integer value (n) that directs CMS to display
    nested groups up or down to and including the level indicated by
    n. When you specify /CONTENTS without a value, CMS displays one
    level of contents. You can also specify /CONTENTS=ALL to display
    all levels of contained groups.

 3.4 - /FULL

    The /FULL qualifier displays the group name, creation remark, and
    read-only attribute (if established) for each group.

 3.5 - /INTERMEDIATE

    The /INTERMEDIATE qualifier displays the name and creation remark
    associated with each group.

 3.6 - /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.

 3.7 - /OUTPUT[=file-specification]

    Directs CMS to write output to the specified file, except for any
    warning and error messages, which are written to SYS$OUTPUT and
    SYS$ERROR. CMS creates a new file if you do not specify /APPEND.
    If you omit the /OUTPUT qualifier (or if you specify /OUTPUT
    but do not provide a file specification), CMS directs output to
    the default output device (SYS$OUTPUT). If you omit either the
    file name or the file type component, CMS supplies the missing
    component from the default specification.

4 - Examples

    (1) CMS> SHOW GROUP

        Groups in CMS Library DISKX:[PROJECT.CMSLIB]

        ARTWORK   "graph display"
        OUT_DEFS  "output definition files"
        TEST_ART  "tests for graphs"

      This command displays the group name and the creation remark
      associated with the group, by default. Because no group name
      is specified on the command line, CMS lists all groups in the
      library.

    (2) CMS> SHOW GROUP ARTWORK/CONTENTS

        Groups in CMS Library DISKX:[WORK.CMSV3.CALL.TEST.CMSLIB]

        ARTWORK   "graph display"
                5666.ARTWRK
                CHAP_ART.TXT
                FIG3.FIG
                MODPARAM5.SDML
                TEST_ART

      This command produces a list of elements and groups that are
      members of group ARTWORK. The group TEST_ART was inserted into
      ARTWORK with the INSERT GROUP command; thus, as the contents of
      TEST_ART change, the elements accessible in the group ARTWORK
      change.