Command rp

NAME

SYNOPSIS

DESCRIPTION

The three parameters are optionnal. If the command is called without arguments, it creates an exploitation day for each referential where the `autoPlanned' property is set to true.

The first parameter is the name of the referential which is used to create the new exploitation day. The tasks of this referential are selected to create the new day.

The second parameter is the start time of the exploitation day. This parameter is optionnal. If it's not specified, the start time is fixed to the next day at midnight. If this parameter is specified, it must have one of the following formats : `YYYY-MM-DD', `YYYY-MM-DD HH', `YYYY-MM-DD HH:MM' or `YYYY-MM-DD HH:MM:SS' (where YYYY is the year, MM is the month, DD is the day, HH is the hour, MM is the minutes and SS is the seconds). If the hour, the minutes or the seconds are not specified, there are considered to be equal to zero.

The last parameter is the name of the day to create. If this parameter is not specified, the name of the new day is composed of the referentiel name, followed by the start time with the format `YYYY-MM-DD'.

The `-d' option disables the day which will be created. It's usefull if you create a day with a start time which is less or equal to the current time : you will be able to desactivate or to cancel tasks before the day starts. To enable the day, you will use the xdse command.

The `-b' option is used to make the day creation process assynchron : The command returns as soon as the day creation process starts. You must use the el command to follow the creation process.

While the day creation process is not terminated, the referential is locked to avoid modification.

The creation process will be suspended if the engine of the `dio87d' daemon is disabled. It starts again when the engine is enabled (see section Command ese).

ACCESS CONTROL

EXAMPLE

$ dio87d -d
$ dio87d -d
$ dio87c ese false 

A referential named `myref' is created. You can see that the referential isn't locked (`Locked:False') and that no referentials are in progress (`Ref to plan: None') :

$ dio87c ra myref
$ dio87c ri myref
Ref's Name:  myref
Locked:      False

$ dio87c ei
Enabled:     True
Ref to plan: None

The rp command is used to create a new day named `anewday' from `myref'. The start date of this day is `2004-02-19'. ri command shows that the referential is locked (`Locked:True') and ei shows that `myref' is selected (`Ref to plan: myref').

$ dio87c rp myref "2004-02-19" anewday 

$ dio87c ri myref
Ref's Name:  myref
Locked:      True

$ dio87c ei
Enabled:     False
Ref to plan: myref

The day creation proccess is stopped because `dio87d' engine is disabled. We enable it with ese command. After a second, creation process is terminated : ei shows that no plan are in progress and ri shows that `myref' is not yet locked.

$ dio87c ese true
$ dio87c ei
Enabled:     True
Ref to plan: None
$ dio87c ri myref
Ref's Name:  myref
Locked:      False

The xdl command is used to verify that the day `anewday' is created in `dio87d' daemon.

$ dio87c xdl
anewday
$

You can see a trace of the day creation process with the el command :

$ dio87c el
* Prepare
Day plan : anewday
Date : 2004-02-19 00:00:00
* Connection
* Create day
Identification
* Create day
Create day 'anewday' at '2004-02-19 00:00:00'
* Copy task
* Copy task dependencies
Termination

SEE ALSO

• ra (see section Command ra)
• rc (see section Command rc)
• rd (see section Command rd)
• ri (see section Command ri)
• rk (see section Command rk)
• rl (see section Command rl)
• rs (see section Command rs)