VMS Help CMS, CREATE, ELEMENT, Qualifiers *Conan The Librarian (sorry for the slow response - running on an old VAX) |
1 - /CONCURRENT (D)
Specifies whether this element can have multiple reservations. After you have created the element, you grant or deny concurrent access by using the MODIFY ELEMENT command.
2 - /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.
3 - /HISTORY="string"
Establishes the history attribute for the element. If an element has the history attribute, its history 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 (##).
4 - /INPUT[=file-specification]
Specifies the file to be used to create the element. When you specify an alternative location for the input file, CMS deletes the file from the alternative location (unless you specify /KEEP or /RESERVE). If you do not specify this qualifier, CMS searches your current default directory for a file with the same name as specified with the element expression parameter on the command line. Wildcards are allowed. CMS must be able to create a unique element for each file in the input file list. Thus, if you use wildcards in the /INPUT file specification to specify more than one input file, you must also use wildcards in the element-name parameter.
5 - /KEEP
Controls whether CMS deletes all versions of the file used to create the new element. If you specify /KEEP, CMS does not delete the file.
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 - /NOTES="string"
Establishes the notes attribute for the element. If an element has the 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. If you specify /NOTES, you must also specify /POSITION.
8 - /POSITION=n
Establishes the position attribute; that is, the character position where the note generated by the /NOTES qualifier begins on the line. The value n is required and must be an integer in the range 1 to 511. The /NOTES qualifier is required with the /POSITION qualifier. The note is placed to the right of the text of the line. 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 eight characters thereafter.)
9 - /REFERENCE_COPY
10 - /NOREFERENCE_COPY
Controls whether CMS maintains a reference copy of the element. You must have established a reference copy directory. The presence of the reference copy attribute for an element is inherited from the library, that is, if a reference copy directory is established for the library, by default, the attribute is enabled for the element. You can override the reference copy attribute by specifying /NOREFERENCE_COPY. If a reference copy directory has been established for the CMS library, CMS creates a reference copy of the new element and updates the reference copy directory each time you create a new main line generation of that element. When CMS places a file in the reference copy directory, it also deletes any earlier versions of that file in the reference copy directory.
11 - /RESERVE
Controls whether the new element is to be reserved after it is created. When you specify /RESERVE, CMS does not delete the file used to create the element. Generation 1 of the newly created element is automatically reserved. If you omit both the /RESERVE and the /KEEP qualifiers, CMS deletes all versions of the file used to create the element.
12 - /REVIEW
Specifies that new generations of the element are marked for review. By default, new generations of the element are marked for review only if the reserved generation was either rejected or has a review pending. If you specify CREATE ELEMENT/REVIEW, generation 1 of the element is also marked for review. You can change the review attribute with the MODIFY ELEMENT command.
|