VMS Help CMS, MODIFY, ELEMENT, Qualifiers *Conan The Librarian (sorry for the slow response - running on an old VAX) |
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.
|