Renaming a Control-M/Server component

This procedure describes how to rename a Control-M/Server component in the Control-M Configuration Manager, which automatically updates all associated definition tables in the database (not the active jobs).

Before you begin

• Back up Control-M/Server, as described in Control-M/Server database backup and restore.
• Do not run any utilities that update job or calendar definitions during the rename.
• Save and close any open workspaces.

To rename a Control-M/Server component:

1. Shut down the following components, as described in Shutting down a component:
   • GCS
   • GUI Server
   • BIM
   • Forecast Server
   • Self Service Server
   • Gateway (associated to the Control-M/Server)
2. Right-click a Control-M/Server that you want to rename and select Rename.

   The Rename Control-M dialog box appears.

3. In the New Name field, type the new name of the Control-M/Server and click OK.

   If there are database fields that contain regular expressions, such as Global Condition Prefixes, warnings might appear if one of the following is identified:

   • The pattern used to match the old Control-M/Server name does not match the new name.
   • The pattern used to exclude the old Control-M/Server name now matches the new name.
4. Do one of the following:
   • Fix the definitions found in each warning.
   • Click Ignore and Continue and fix the definitions after the rename.

   The renamed Control-M/Server appears in the CCM component list and the list of warnings are saved in the following directory:

   <Control-M/EM_Home_Dir>\Log\<original_name>_to_<new_name>_<timestamp>.log