HELPLIB.HLB  —  CMS  MODIFY  ELEMENT  Qualifiers

1    /CONCURRENT

2    /NOCONCURRENT

    Specifies whether this element can have multiple reservations. If
    you do not specify this qualifier, the existing concurrent access
    is not changed.

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

4    /HISTORY="string"

    Establishes the history attribute for the element. If an element
    has a history attribute, its history (which is similar to that
    produced by the ANNOTATE command) is included in the file when you
    retrieve it with the FETCH or RESERVE command.

    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
    (##).

5    /NOHISTORY

    Deletes any existing history attribute. If both /HISTORY and
    /NOHISTORY are omitted, any existing history attribute remains
    unchanged.

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

7    /NAME=element-name

    Specifies the new name for the element. The new element name
    cannot be the same as an existing element name. Do not use the
    file name 00CMS because this name is reserved for CMS. If you
    specify the /NAME qualifier, you cannot use wildcards or a comma
    list in the element-name parameter, nor can you use a wildcard for
    the /NAME qualifier.

    If an element is set to /REFERENCE_COPY, CMS creates a new
    reference copy of the element in the reference copy directory.

8    /NOTES="string"

    Establishes the notes attribute for the element. If an element
    has a notes attribute, 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.

9    /NONOTES

    Cancels any current notes attribute and the corresponding position
    attribute.

    If both /NOTES and /NONOTES are omitted, any existing notes
    attribute remains unchanged.

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

11    /POSITION=n

    Establishes the position attribute; that is, the character
    position at which the note generated by the /NOTES qualifier is to
    begin on the line. A file that has a position attribute must have
    a notes attribute. Thus, the /POSITION qualifier can be used only
    if the element already has an established notes attribute, or the
    /NOTES qualifier is used on the same MODIFY ELEMENT command.

    The value n is required and must be an integer in the range 1 to
    511. If the length of the line is less than n, the note appears
    at position n. If the length of the line is greater than or equal
    to n, 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.)

    If you omit /POSITION, any current position attribute remains
    unchanged.

12    /REFERENCE_COPY

13    /NOREFERENCE_COPY

    Controls whether a new reference copy of an element is created or
    deleted.  If you specify /REFERENCE_COPY, CMS creates a new
    reference copy of the element in the reference copy directory and
    updates the current reference copy directory whenever you create a
    new main line generation of the element.  If you specify
    /NOREFERENCE_COPY, CMS deletes the existing reference copy of the
    element.  The reference copy directory must be established before
    you issue the MODIFY ELEMENT/REFERENCE_COPY command. Use the MODIFY
    LIBRARY/REFERENCE_COPY command to establish the reference copy
    directory.

    Controls whether CMS creates a new reference copy of an element
    whenever you create a new main line generation of the element. If
    you specify /NOREFERENCE_COPY, CMS deletes the existing reference
    copy.

    To establish the reference copy directory, use the MODIFY
    LIBRARY/REFERENCE_COPY command.

14    /REMARK="string"

    Specifies a new remark to be substituted for the creation remark
    that is associated with the element.

15    /REVIEW

16    /NOREVIEW

    Controls whether new generations of the element are marked for
    review. If you specify /REVIEW, new generations of the element are
    marked for review. If you specify /NOREVIEW, new generations are
    marked only if the reserved generation is either rejected or has a
    review pending. If you do not specify this qualifier, the existing
    review attribute is not changed.

    To determine whether an element has the review attribute enabled,
    use the SHOW ELEMENT/FULL command.
Close Help