Utility Change parent

Utility chparent.exe / chparent_ora.exe is used for the offline change of parent.

"Offline" means that it makes the changes directly into database without interaction with D2000 server. The parent change will show after restarting the D2000 server.

Note: The parent can be changed also online, via XML Import (only for the objects of I/O tag, Event, Database or Table type).

Syntax (it runs from command line)

 
 - Sybase/PostgreSQL/MsSql: chparent <app_name> <new_parent_name> <obj_name_mask1> [, <obj_name_mask2> [, ...] ]]
 
 - Oracle: chparent_ora <app_name> <new_parent_name> <obj_name_mask1> [, <obj_name_mask2> [, ...] ]
 

Functionality

Utility changes the parents to all object, which match to mask <obj_name_mask1>, <obj_name_mask2>, etc., on value <new_parent_name> in configuration of the application (directly in database).

Parent change does not run if the parent is not valid at least for one object. It means, it is checked if selected parent can be assigned to object of given type.

The user must confirm this change (y = yes, other keys = no). In case of acceptance, the parent will be changed in configuration of the application (directly in database).

Potential errors

• incorrect syntax for the utility chparent / chparent_exe
• database cannot be opened
• database error is notified
• new parent does not exist in configuration
• none of the objects match to masks
• parent of given type cannot be set to any of the objects

Behavior in redundancy

The chparent utility does not change the object configuration change time (Modify Time). Therefore, the cfgsynchro utility does not synchronize such changes in the redundant system and it is necessary to modify all configuration databases in the redundant system, not just one (or use export/import of the configuration database). A possible scenario for an outage-free change of a parent in a redundant system is as follows:

1. shut down the standby (SBS) server
2. change the parent object in the SBS server configuration database
3. start the SBS server
4. connect to the SBS server using the CNF tool and check the correctness of the parent changes
5. redundancy switching - SBS server with modified configuration will become a new HOT server
6. change of the parent object in the configuration database of the former HOT server