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

       Format:

          SHOW ELEMENT  [element-expression]

1  –  Command Parameters

 element-expression

    Specifies one or more elements to be listed. If you do not supply
    an element expression, CMS lists all the elements in the library.
    An element expression can be an element name, a group name, a
    wildcard expression, or a list of these separated by commas.

2  –  Description

    The SHOW ELEMENT command lists the name of each specified element
    in alphabetical order, along with the remark logged at the
    time the element was created or modified. You can also specify
    qualifiers that provide information about element attributes,
    concurrent access, and the groups to which the element belongs.

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 element names.

3.3    /FORMAT="string"

    Controls whether the output of the SHOW ELEMENT command is
    formatted. You can use the /FORMAT qualifier in combination
    with the /OUTPUT qualifier to set up a command file. With this
    command file, you can execute a CMS command or a DCL command on a
    specified set of elements (such as all elements in a group).

    The format string can contain printing characters; within the
    format string, CMS recognizes #E (and #e) as the element format
    parameter. For each line of output (one line per element), CMS
    displays the format string and replaces each occurrence of #E (or
    #e) with the element name. To include a number sign in the output
    line, type it twice (##). When you specify /FORMAT, CMS does
    not generate the heading normally produced by the SHOW ELEMENT
    command.

    To set up a command file, you specify a format string consisting
    of a command, including the dollar sign ($) prompt and the
    element format parameter (for example, /FORMAT="$ CMS FETCH #E").
    Use the /OUTPUT qualifier to direct the output to a command file.
    When you execute the SHOW ELEMENT command with these qualifiers,
    CMS creates a command file containing a list of FETCH commands
    that use each element in the denoted set as parameters.

3.4    /FULL

    The /FULL qualifier displays the name, creation remark, and the
    attributes in effect for the specified elements.

3.5    /INTERMEDIATE

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

3.6    /MEMBER

    Lists the element name, creation remark, and the names of any
    groups to which the element belongs.

3.7    /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 (ELEMENT, GROUP)
       ELEMENT (D)
       NOELEMENT
       GROUP (D)
       NOGROUP
       NONE--equivalent to (NOELEMENT, NOGROUP)

    You can specify either ALL or NONE, or any combination of the
    [NO]ELEMENT and [NO]GROUP keywords.

    By default, CMS performs occlusion for all objects; that is, CMS
    selects only the first occurrence of a specified object.

3.8    /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 ELEMENT/BRIEF

        Elements in CMS Library DISKX:[PROJECT.CMSLIB]

        CCM.FOR             CCM1.FOR            COPYTEST.FOR

      This command limits the output to element names only.

    (2) CMS> SHOW ELEMENT/FORMAT="$ CMS FETCH #E"/OUTPUT=FETCH.COM

      This command produces a file named FETCH.COM that contains a
      fetch command for each element in the library. The contents of
      a file produced by this command might look like the following:

          $ CMS FETCH INIT.FOR
          $ CMS FETCH INITX.FOR
          $ CMS FETCH MSGDOC.FOR
          $ CMS FETCH OUTPUT.FOR
          $ CMS FETCH SEARCH.FOR