VMS Help  —  CMS  FETCH  Qualifiers

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.

2    /GENERATION[=generation-expression]

    Specifies a particular generation of the element that is to be
    retrieved. If you omit /GENERATION, CMS fetches the most recent
    generation on the main line of descent.

3    /HISTORY="string"

    Specifies that history is to be included in the retrieved file.
    The quoted string specifies the format of the history. The quoted
    string must contain the characters #H or #B (lowercase is allowed)
    and can contain other printing characters. To include a quotation
    mark in the output history string, type it twice (""). To include
    a number sign (#) in the output history string, type it twice
    (##).

4    /NOHISTORY

    Prevents CMS from appending the element history to the file. If
    you omit /NOHISTORY, and the retrieved element has the history
    attribute, the element history is included in the file when it is
    delivered to your current default directory. An element has the
    history attribute if you specified the /HISTORY qualifier on the
    CREATE ELEMENT or MODIFY ELEMENT command.

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

6    /MERGE=generation-expression

    Controls whether another generation of the element (called the
    merge generation) is to be merged with the generation that is
    being fetched (called the retrieved generation).

    When you specify the /MERGE qualifier, CMS merges the lines of
    the two generations and delivers a single copy to your default
    directory. The file that is placed in your directory has the
    current creation and revision times. The merge generation cannot
    be on the same line of descent as the retrieved generation. When
    there is a conflict between blocks of one or more lines, CMS
    includes the conflicting lines and flags the conflict.

7    /NOTES="string"

    Temporarily establishes the notes attribute for the element,
    regardless of whether the element previously had the notes
    attribute enabled. If neither the /NOTES or /NONOTES qualifier is
    specified for an element, but the element has the notes attribute
    enabled, notes are appended to the lines of the file when it is
    retrieved by the FETCH or RESERVE command.

    The quoted string specifies the format of the note. The quoted
    string can contain text or the characters #G (or #g), or both.
    If you specify /NOTES for an element that does not have the notes
    attribute enabled, then you must also specify /POSITION.

8    /NONOTES

    Specifies that notes are not to be embedded in the output file.
    If you omit /NONOTES, and the retrieved element has the notes
    attribute, CMS embeds notes in the output file. An element has
    the notes attribute if you specified the /NOTES qualifier on the
    CREATE ELEMENT or MODIFY ELEMENT command.

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

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

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

10    /OUTPUT[=file-specification]

    Directs CMS to write output to the specified file. If you omit the
    /OUTPUT qualifier (or if you specify /OUTPUT but do not provide a
    file specification), CMS creates a file with the same name as the
    element.

    If you fetch more than one element (by specifying wildcards or a
    group name for the element expression parameter), and you do not
    specify wildcards in the output file specification, CMS creates
    successive versions of the file indicated by /OUTPUT.

11    /NOOUTPUT

    Specifies that the fetch operation is to be performed along with
    any history processing and error checking, but that no output file
    is to be created. By default, an output file with the same name as
    the element is created.

12    /POSITION=column-number

    Specifies the column in which the note is to be placed. The column
    number is required and must be an integer in the range 1 to 511.
    The notes attribute or the /NOTES qualifier is required with the
    /POSITION qualifier.

    If the length of the line is less than the specified column
    number, the note appears at the column number. If the length of
    the line is greater than or equal to the column number, the note
    is placed at the next tab stop after the end of the line. (Tab
    stops are at position 9 and every 8 characters thereafter.)
Close Help