Initialise()

virtual void drama::git::Path::Initialise ( thread::TMessHandler *  action, bool  ignoreInitParam = false  )

virtual

Perform the complete initialisation sequence for a GIT task.

Send the sequence of operations required to Initialise/Reset a DRAMA task obeying the GIT spec. The sequence is as follows

• The task is loaded if it not is already running. (DoGetPath())
• The path to the task is obtained. (DoGetPath())
• The simulation level is set. (SendSimLevel())
• The task version numbers etc. are fetched. (GetVerInfo())
• The INITIALISE or RESET action is sent to the task. (SendInitialise() or SendReset()).

The method will block until INITIALISE is complete (standard DRAMA 2 approach).

INITIALISE is sent if the task was loaded, or it not loaded but its INITIALISED parameter value is zero, otherwise, the task will be RESET unless the reset mode is RECOVER and the task has not previously been set to failed.

Parameters

action	A pointer to the threaded action which is executing this operation.
ignoreInitParam	GIT tasks will have an INITIALISED parameter. But some older tasks don't set this correctly, and at the same time, don't accept an INITIALISE if they have already been initialised, they need a RESET. This argument tells SendInitialise() to send RESET to any task we have not just loaded, rather then to consider the INITIALISED parameter.