[next] [previous] [contents]

  DEVTOOLS CMS RENAME ELEMENT

  Renames a CMS library element.

  Format

  DEVTOOLS CMS RENAME ELEMENT old-element-name
                                                            new-element-name
                                                            "remark"

  Parameters
  old-element-name

  new-element-name
remark

  Specifies a CMS remark. See CMS HELP COPY ELEMENT
  for more details.

  Qualifiers
  /CLASS=class-name

  Specifies that the generation of the original element in speci-
  fied class will be replaced by the same genaration of the new
  element.
  If you omit /CLASS and /PATH and there is no appl _CMS_
  PATH logical name defined, DEVTOOLS CMS RENAME
  doesn't replace any generation of the element into any class.

  This qualifier overrides the action of the appl _CMS_PATH
  logical name.

  This qualifier is incompatible with the /PATH qualifier.

  /CONTEXT=(keyword=value,,,)

  Specifies the context in which the command should execute.

  By default the current context is assumed.
See the UTLTOOLS FETCH SUBCONTEXT command for
  more details about the keywords and their values.

  /PATH[=(generation-expression[,...])]
  Specifies that the first generation of the original element
  found in the generation expression search list will be replaced
  by the same generation of the new element.

  If you omit /CLASS and /PATH and there is no appl _CMS_
  PATH logical name defined, DEVTOOLS CMS RENAME
  doesn't replace any generation of the element into any class.

  This qualifier overrides the action of the appl _CMS_PATH
  logical name.

  This qualifier is incompatible with the /CLASS qualifier.

  /SUBCONTEXT=(keyword=value,,,)

  Specifies the various directories and libraries which will be
  checked for intermediate files to be deleted and the libraries
  which will be checked for modules to be deleted when an ele-
  ment is renamed in the CMS library and the /TIDY qualifier
  (which must also be specified) is used.

  For an element with a name and type of the form
  NAME.TYPE
, the intermediate files and modules which
  will be deleted will include:

  .
        NAME
.
                  *

                    ;
                    *

                      in the documentation directory;
  .
        NAME

                  *

                  .
                    *

                    ;
                      *

                        in the library directory;
  .
        NAME
.
                  *

                    ;
                    *

                      in the software directory;
  .
        NAME.TYPE
;
                          *

                              in the work directory.
  .
        NAME
in the image library.
  .
        NAME
in the MMS library.
  .
        NAME
in the object library.
  .
        NAME
in the text library.

  By default the directories and libraries are those associated
  with the application.

  See the UTLTOOLS FETCH SUBCONTEXT command for
  more details about the keywords and their values.

  /TIDY
  /NOTIDY (default)

  Specifies that intermediate files and library modules associ-
  ated when an element is renamed in the CMS library should
  be deleted.

  See the /SUBCONTEXT qualifier for details about how to
  specify which directories will be searched for intermediate
  files.