s_rename



NAME

      system rename - rename a system, configuration or subsystem


SYNOPSIS

      system rename  [-F] system_path new_name


DESCRIPTION

      The command system rename renames the latest part of a system_path to
      new_name.

      Rename system
           The system is renamed, the link pointing to the system in
           /ipa/systems is changed. Symbolic links including the old system
           name are changed to include the new system name. The overview
           file of the system is changed.
           Note, that projects connected to the system must change the the
           link in /ipa/projects/*/systems pointing to the old system name.
           These must be changed manually.
           The user directories in a project connected to the system must
           also be renamed. Both the directories including system name and
           symbolic links pointing to the system needs to be renamed. For
           this purpose the command rentree may be used.
           Check also references in product definition files, Makefiles etc.
           and rename them manually.

      Rename configuration
           The configuration is renamed, symbolic links in "later"
           configuration pointing to the renamed configuration are changed.
           Note, that projects connected to the system configuration must
           change the the link in /ipa/projects/*/systems pointing to the
           old system name. These must be changed manually.
           The user directories in a project connected to the system must
           also be renamed. Both the directories including
           system/configuration name and symbolic links pointing to the
           system configuration needs to be renamed. For this purpose the
           command rentree may be used.
           Check also references in product definition files, Makefiles etc.
           and rename them manually.

      Rename subsystem
           Normally, it is only possible to rename a subsystem, if it is
           located in "latest" configuration. To rename subsystem in a
           configuration with existing children, use the option -F. Its RCS
           library must not be a symbolic link pointing to another RCS
           library.
           The user directories in a project connected to the system must
           also be renamed. Both the directories including
           system/configuration/subsystem name and symbolic links pointing
           to the subsystem in the system configuration needs to be renamed.
           For this purpose the command rentree may be used.
           Check also references in product definition files, Makefiles etc.
           and rename them manually.

    OPTIONS
      -F   If a system configuration has a child configuration, by default,
           you are not allowed to change it (like add or remove a
           subsystem). The -F option allows you to rename a subsystem, even
           if child configurations exist.


EXAMPLES

      system rename systemA systemB

      renames systemA to systemB

      system rename systemB/2.0-0 2.1-0

      renames configuration 2.0-0 in systemB to 2.1-0

      system rename systemB/2.1-0/sub1 subA

      renames subsystem sub1 in systemB/2.1-0 to subA


SEE ALSO

      system(1), rentree(1)


AUTHOR

      Elisabet de Waal