replace

Replaces scheduling object definitions in the database.

Authorization

You must have add access if you add a new scheduling object. If the object already exists in the database you must have:
  • modify access to the object if the object is not locked.
  • modify and unlock accesses to the object if you want to use the ;unlock option against objects locked by other users.

To replace security objects, you must have permission for the modify action on the object type file with attribute name=security.

Syntax

{replace | rep} filename [;unlock]

Arguments

filename
Specifies the name of a file containing the object definitions to replace. The file can contain all types of scheduling objects definition.
unlock
Updates existing objects previously locked and unlocks them. An error is displayed if the objects are not previously locked. For all new objects inserted, this option, if specified, is ignored.

Comments

The replace command is similar to the add command, except that there is no confirmation prompt to replace existing objects. For more information, refer to add.

The replace command checks for loop dependencies inside job streams. For example, if job1 follows job2, and job2 follows job1 there is a loop dependency. When a loop dependency inside a job stream is found, an error is displayed. To resolve the error, run the replace command again.

Examples

To replace the jobs from the file myjobs, run the following command: 
replace myjobs
To replace all resources with those contained in the file myres, run the following command: 
rep myres
You want to change some existing event rule definitions in the database. You also want to add some new ones as well. You use this command in the following way:
  1. You write the entire definitions in an XML file you name 2Q07rules.xml.
  2. You run: 
    rep 2Q07rules.xml