VMS Help CMS, MODIFY, CLASS  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Changes the characteristics of a specified class or classes.

       Format:

          MODIFY CLASS  class-expression /qualifier "remark"

1 - Restrictions

    o  You cannot modify a class that has read-only access. If a
       class has read-only access, you must change it to NOREAD_
       ONLY access to change the contents of the class or any other
       characteristics.

    o  You must specify one or more of the following qualifiers:
       /NAME, /[NO]READ_ONLY, /REMARK.

2 - Command Parameters

 class-expression

    Specifies the class being modified. A class expression can be a
    class name, a wildcard expression, or a list of these separated by
    commas.

 remark

    Specifies a character string to be logged in the history file with
    this command, usually used to explain why the command was entered.
    The remark is enclosed in quotation marks. If no remark was
    entered, a null remark ("") is logged. Note that this parameter
    and the string on the /REMARK qualifier are unrelated.

3 - Description

    The MODIFY CLASS command changes the characteristics of one or
    more classes. You can alter the following characteristics:

    o  The name of the class.

    o  The access to the class (READ_ONLY or NOREAD_ONLY). You cannot
       change the contents, the name, or the remark of a class that
       has been set to READ_ONLY.

    o  The creation remark that is associated with the class.

    Use the SHOW CLASS command to display class characteristics.

4 - Qualifiers

 4.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.

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

 4.3 - /NAME=class-name

    Specifies the new name for the class. The new class name cannot
    be the same as an existing class or group name. If a previously
    used class or group name has been removed with the DELETE CLASS or
    DELETE GROUP command, you can reuse that name. Wildcards and comma
    lists are not allowed.

    If you specify the /NAME qualifier, you cannot use wildcards or a
    comma list in the class-name parameter, nor can you use a wildcard
    for the /NAME qualifier. You cannot change the name of a class
    that has read-only access.

 4.4 - /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 CLASS
       CLASS (D)
       NOCLASS
       NONE--equivalent to NOCLASS

    You can specify either ALL, NONE, or the [NO]CLASS keyword.

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

 4.5 - /READ_ONLY

 4.6 - /NOREAD_ONLY

    Establishes or alters the read-only attribute of a class. To
    change the characteristics of a read-only class, you must set
    the class to NOREAD_ONLY. NOREAD_ONLY is the default attribute of
    a class when it is created with the CREATE CLASS command.

 4.7 - /REMARK="string"

    Specifies a new remark to be substituted for the creation remark
    that is associated with the class. You cannot change the remark of
    a class that has been set to READ_ONLY.

5 - Examples

    (1) CMS> MODIFY CLASS PRE_RELEASE/READ_ONLY "freeze internal version"
        %CMS-S-MODIFIED, class DISKX:[PROJECT.CMSLIB]PRE_RELEASE modified

      This command sets the class named PRE_RELEASE to READ_ONLY.

    (2) CMS> MODIFY CLASS PRE_RELEASE/NOREAD_ONLY/NAME=PRE_RELEASE_V3
        _Remark: include additional functions
        %CMS-S-MODIFIED, class DISKX:[PROJECT.CMSLIB]PRE_RELEASE modified

      This example renames class PRE_RELEASE to PRE_RELEASE_V3.
      Because PRE_RELEASE had been set to READ_ONLY, it is necessary
      to use the /NOREAD_ONLY qualifier to modify the class.