---

DcppTask Class Reference

#include <dcpptask.h>

Inheritance diagram for DcppTask:

List of all members.

---

Detailed Description

A Class which provides access to DRAMA's message sending facilities.

This class was the original attempt at providing a C++ interface to DRAMA's message sending functions. The idea is that you maintain an object of this type for each task you want to send messages to. You can then use the various methods to send messages. The Action/UFACE routine which processes replies to these messages can use DcppDisptach() to dispatch the messages such that the callback functions which are specified when the message is sent, are invoked.

In addition, when invoked with an action, the used of DcppTask can be combined with a DcppHandler object to handle action rescheduling transparently. This is optional.

See also:

DcppMonitor

DcppHandler

Arg

SdsId

DitsInitiateMessage()

DitsInitMessBulk()

DRAMA C++ interface

DRAMA DITS Specification

Remarks:

The approach used here is wrong, instead of using call back functions and client data, we should be using an object which the user can override to provide the functionality. This may be added later.

Public Member Functions
	DcppTask (const char *const name, const char *const location=0, const char *const file=0)
	Normal constructor.
	DcppTask (bool self)
	Path to self constructor.
virtual	~DcppTask ()
	Destructor.
void	TaskLoggingOn ()
	Turn logging on for this object.
void	TaskLoggingOff ()
	Turn logging off for this object.
void	Report (StatusType *status) const
	Dump details using.
bool	GetPathLoaded () const
	Indicate if a the task was loaded.
const char *	TaskName () const
	Fetch the task name.
const char *	Location () const
	Fetch the task location.
const char *	GetArgument () const
	Fetch the load argument.
virtual void	SetName (const char *const TaskName)
	Set the task name.
virtual void	SetLocation (const char *const Location)
	Set the task location.
virtual void	SetFile (const char *const File)
	Set the executable file name.
virtual void	SetBuffers (const DcppBuffers &Buffers)
	Set the DRAMA path buffers.
virtual void	SetFlowControl ()
	Set the FLOW control flag.
virtual void	SetProcess (const char *const ProcessName)
	Set the process names.
virtual void	SetStackSize (unsigned bytes)
	Set the stack size for the load.
virtual void	SetArgument (const char *const LoadArg, bool const Append=false)
	Set the load time argument string.
virtual void	SetPriority (const int Priority, const bool Absolute=false)
	Set the load time priority for a task when loaded.
virtual void	SetNames (const bool Flag=true)
	Insist that symbols known to IMP_Master be known to the task.
virtual void	SetSymbols (const bool Flag=true)
	Interpert file name as a symbol (VMS Target only).
virtual void	SetProg (const bool Flag=true)
	Interpert file name as a program name.
virtual void	LogLoad (const bool Flag=true)
	Load use.
virtual void	ClearState ()
	Clear the task state.
virtual bool	Active ()
	Indicate if a task is active.
virtual bool	IsDead ()
	Return true if a previously active task has disconnected.
virtual bool	Initial ()
	Return true if a GetPath operation is required.
virtual bool	Busy ()
	Returns true if we can't send a message because path is busy.
virtual DcppHandlerRet	GetPath (StatusType *const status, const DcppHandlerRoutine SuccessHandler=0, const DcppHandlerRoutine ErrorHandler=0, const DcppVoidPnt ClientData=0)
	Get a path to/load a the task.
virtual void	Died ()
	Note that a task has died.
virtual void	LosePath (StatusType *const status)
	Lose the path and then set as if the task has died.
virtual void	Delete (int force, StatusType *status)
	Delete the task.
virtual DcppHandlerRet	Obey (const char *const name, StatusType *const status, const SdsId &arg=SdsNull, const DcppHandlerRoutine SuccessHandler=0, const DcppHandlerRoutine ErrorHandler=0, const DcppHandlerRoutine TriggerHandler=0, const DcppVoidPnt ClientData=0, const DcppHandlerRoutine ErsHandler=0, const DcppHandlerRoutine MsgHandler=0, DitsTransIdType *const transid=0)
	Send a DRAMA Obey message to the task.
virtual DcppHandlerRet	Obey (const char *const name, StatusType *const status, const SdsId &arg, const DcppHandlerRoutine SuccessHandler, const DcppHandlerRoutine ErrorHandler, const DcppHandlerRoutine TriggerHandler, const DcppVoidPnt ClientData, const DcppHandlerRoutine ErsHandler, const DcppHandlerRoutine MsgHandler, SdsId *const tidArg)
	Send a DRAMA Obey message to the task.
virtual DcppHandlerRet	Obey (const char *const name, StatusType *const status, const SdsId &arg, const DcppHandlerRoutine SuccessHandler, const DcppHandlerRoutine ErrorHandler, const DcppHandlerRoutine TriggerHandler, const DcppVoidPnt ClientData, const DcppHandlerRoutine ErsHandler, const DcppHandlerRoutine MsgHandler, const SdsId *const tidArg)
	Send a DRAMA Obey message to the task.
virtual DcppHandlerRet	Kick (const char *const name, StatusType *const status, const SdsId &arg=SdsNull, const DcppHandlerRoutine SuccessHandler=0, const DcppHandlerRoutine ErrorHandler=0, const DcppVoidPnt ClientData=0, const DcppHandlerRoutine ErsHandler=0, const DcppHandlerRoutine MsgHandler=0)
	Send a DRAMA Kick message to the task.
virtual DcppHandlerRet	Obey (const char *const name, const DcppShared &SharedMem, const bool sds, const int NotifyBytes, StatusType *const status, const DcppHandlerRoutine SuccessHandler=0, const DcppHandlerRoutine ErrorHandler=0, const DcppBulkTransRoutine BulkTransHandler=0, const DcppHandlerRoutine BulkDoneHandler=0, const DcppHandlerRoutine TriggerHandler=0, const DcppVoidPnt ClientData=0, const DcppHandlerRoutine ErsHandler=0, const DcppHandlerRoutine MsgHandler=0, DitsTransIdType *const transid=0)
	Send a DRAMA Obey bulk data message to the task.
virtual DcppHandlerRet	Obey (const char *const name, const DcppShared &SharedMem, const bool sds, const int NotifyBytes, StatusType *const status, const DcppHandlerRoutine SuccessHandler, const DcppHandlerRoutine ErrorHandler, const DcppBulkTransRoutine BulkTransHandler, const DcppHandlerRoutine BulkDoneHandler, const DcppHandlerRoutine TriggerHandler, const DcppVoidPnt ClientData, const DcppHandlerRoutine ErsHandler, const DcppHandlerRoutine MsgHandler, SdsId *const tidArg)
	Send a DRAMA Obey bulk data message to the task.
virtual DcppHandlerRet	Obey (const char *const name, const DcppShared &SharedMem, const bool sds, const int NotifyBytes, StatusType *const status, const DcppHandlerRoutine SuccessHandler, const DcppHandlerRoutine ErrorHandler, const DcppBulkTransRoutine BulkTransHandler, const DcppHandlerRoutine BulkDoneHandler, const DcppHandlerRoutine TriggerHandler, const DcppVoidPnt ClientData, const DcppHandlerRoutine ErsHandler, const DcppHandlerRoutine MsgHandler, const SdsId *const tidArg)
	Send a DRAMA Obey bulk data message to the task.
virtual DcppHandlerRet	Kick (const char *const name, const DcppShared &SharedMem, const bool sds, const int NotifyBytes, StatusType *const status, const DcppHandlerRoutine SuccessHandler=0, const DcppHandlerRoutine ErrorHandler=0, const DcppBulkTransRoutine BulkTransHandler=0, const DcppHandlerRoutine BulkDoneHandler=0, const DcppVoidPnt ClientData=0, const DcppHandlerRoutine ErsHandler=0, const DcppHandlerRoutine MsgHandler=0)
	Send a DRAMA bulk data Kick message to the task.
virtual DcppHandlerRet	Get (const char *const name, StatusType *const status, const DcppHandlerRoutine SuccessHandler=0, const DcppHandlerRoutine ErrorHandler=0, const DcppVoidPnt ClientData=0, const DcppHandlerRoutine ErsHandler=0)
	Send a DRAMA message to the task to get the value of a parameter.
virtual DcppHandlerRet	MGet (const DcppHandlerRoutine SuccessHandler, const DcppHandlerRoutine ErrorHandler, const DcppVoidPnt ClientData, unsigned count, StatusType *status,...)
	Send a DRAMA message to the task to get the value of multiple parameters.
virtual DcppHandlerRet	MGet (const DcppHandlerRoutine SuccessHandler, const DcppHandlerRoutine ErrorHandler, const DcppHandlerRoutine ErsHandler, const DcppVoidPnt ClientData, unsigned count, StatusType *status,...)
	Send a DRAMA message to the task to get the value of multiple parameters.
virtual DcppHandlerRet	Set (const char *const name, StatusType *const status, const SdsId &arg=SdsNull, const DcppHandlerRoutine SuccessHandler=0, const DcppHandlerRoutine ErrorHandler=0, const DcppVoidPnt ClientData=0, const DcppHandlerRoutine ErsHandler=0)
	Send a DRAMA set message to the task.
virtual DcppHandlerRet	Control (const char *const name, StatusType *const status, const SdsId &arg=SdsNull, const DcppHandlerRoutine SuccessHandler=0, const DcppHandlerRoutine ErrorHandler=0, const DcppHandlerRoutine TriggerHandler=0, const DcppVoidPnt ClientData=0, const DcppHandlerRoutine ErsHandler=0)
	Send a DRAMA Control message to the task.
virtual DcppHandlerRet	Monitor (const char *name, StatusType *const status, const SdsId &arg=SdsNull, const DcppHandlerRoutine SuccessHandler=0, const DcppHandlerRoutine ErrorHandler=0, const DcppHandlerRoutine TriggerHandler=0, const DcppVoidPnt ClientData=0, const bool SendCurrent=false, const DcppHandlerRoutine ErsHandler=0)
	Send a DRAMA Monitor message to the task.
virtual void	ObeyForget (const char *const name, StatusType *const status, const SdsId &arg=SdsNull, const DcppHandlerRoutine SuccessHandler=0, const DcppHandlerRoutine ErrorHandler=0, const DcppHandlerRoutine TriggerHandler=0, const DcppVoidPnt ClientData=0, const DcppHandlerRoutine ErsHandler=0, const DcppHandlerRoutine MsgHandler=0, DitsTransIdType *const transid=0)
	Send a DRAMA Obey message to the task, forgetting the transaction.
virtual void	ObeyForget (const char *const name, StatusType *const status, const SdsId &arg, const DcppHandlerRoutine SuccessHandler, const DcppHandlerRoutine ErrorHandler, const DcppHandlerRoutine TriggerHandler, const DcppVoidPnt ClientData, const DcppHandlerRoutine ErsHandler, const DcppHandlerRoutine MsgHandler, SdsId *const tidArg)
	Send a DRAMA Obey message to the task, forgetting the transaction.
virtual void	ObeyForget (const char *const name, StatusType *const status, const SdsId &arg, const DcppHandlerRoutine SuccessHandler, const DcppHandlerRoutine ErrorHandler, const DcppHandlerRoutine TriggerHandler, const DcppVoidPnt ClientData, const DcppHandlerRoutine ErsHandler, const DcppHandlerRoutine MsgHandler, const SdsId *const tidArg)
	Send a DRAMA Obey message to the task, forgetting the transaction.
virtual void	KickForget (const char *const name, StatusType *const status, const SdsId &arg=SdsNull, const DcppHandlerRoutine SuccessHandler=0, const DcppHandlerRoutine ErrorHandler=0, const DcppVoidPnt ClientData=0, const DcppHandlerRoutine ErsHandler=0, const DcppHandlerRoutine MsgHandler=0)
	Send a DRAMA OKick message to the task, forgetting the transaction.
virtual void	MonitorForget (const char *name, StatusType *const status, const SdsId &arg=SdsNull, const DcppHandlerRoutine SuccessHandler=0, const DcppHandlerRoutine ErrorHandler=0, const DcppHandlerRoutine TriggerHandler=0, const DcppVoidPnt ClientData=0, const bool SendCurrent=false, const DcppHandlerRoutine ErsHandler=0)
	Send a DRAMA Monitor message to the task, forgetting the transaction.
virtual DisconHandler *	PutDisconnectHandler (DisconHandler *p)
	Add a new disconnect handler for this task.
DcppHandlerRet	HandleMessage (DcppTransaction *transaction, StatusType *status)
	Function used by DcppDispatch in dispatching to handlers.
virtual void	GetDitsPath (DitsPathType *path, StatusType *status)
	Return the underlying DITS path object.
Static Public Member Functions
void	LoggingOn ()
	Enable logging for all DcppTask objects.
void	LoggingOff ()
	Disable logging for all tasks.
DcppHandlerRet	DiscardResponse (DcppVoidPnt ClientData, StatusType *status)
	Flag argument success handler indicating reponses are to be ignored.
void	HandleDisconnected (const char *task, DitsPathType path, StatusType *status)
	Handle task disconnection.

---

Constructor & Destructor Documentation

DcppTask::DcppTask (  const char *const  name, const char *const  location = 0, const char *const  file = 0 )

Normal constructor. Allows the the task name, location and file to be set Parameters: name  The name the task will be known as (unless loaded, when the name the task registers as will be used) location  The node name on which the task is running or is to be loaded. Only used if not already running locally or known locally. file  The file of the task, as required by DitsLoad(). Normally a file name, but may be different depending on the location, e.g. on a VxWorks machine.

DcppTask::DcppTask (  bool  self  )

Path to self constructor. Constructor a DcppTask object which can be used to send messages to the invoking task itself. Parameters: self  Distingishes this constructor from the other constructor. Value is ignored

virtual DcppTask::~DcppTask (   )  [virtual]

Destructor.

---

Member Function Documentation

virtual bool DcppTask::Active (   )  [inline, virtual]

Indicate if a task is active. Returns: true if it is safe to send a message along a path. That is, a DcppTask::GetPath operation is not needed and is not underway.

virtual bool DcppTask::Busy (   )  [inline, virtual]

Returns true if we can't send a message because path is busy. You can't send a message along a path whilst the getting a path on it or whilst a Notify operation is current. Returns: true if you cannot currently send a message on a path.

virtual void DcppTask::ClearState (   )  [inline, virtual]

Clear the task state. This function clears the state of the DcppTask object, such that it will will presume is has just been constructed.

virtual DcppHandlerRet DcppTask::Control (  const char *const  name, StatusType *const  status, const SdsId &  arg = SdsNull, const DcppHandlerRoutine  SuccessHandler = 0, const DcppHandlerRoutine  ErrorHandler = 0, const DcppHandlerRoutine  TriggerHandler = 0, const DcppVoidPnt  ClientData = 0, const DcppHandlerRoutine  ErsHandler = 0 )  [inline, virtual]

Send a DRAMA Control message to the task. This sends a DRAMA control message to the task referred to by this object. We must already have path to the task. If this function returns DcppReschedule, then messages are expected and should be dispatched using DcppDispatch() when they arrive. This will ensure that future processing occurs correctly and the the appropriate handler is invoked when the operation completes. Returns: DcppReschedule if a message was started. Otherwise DcppFinished and status will be set bad. Parameters: name  The name of the control message to send. status  Inherited Status arg  The argument to the message. Defaults to SdsNull, a null argument. SuccessHandler  DcppDispatch() will invoke this if the operation completes successfully. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ErrorHandler  DcppDispatch() will invoke this if the operation fails after a message has been sent. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. TriggerHandler  DcppDispatch() will invoke this if a trigger message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. ClientData  Passed directly to the handler functions. ErsHandler  DcppDispatch() will invoke this if a Ers message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. This would normally only happen if the message was sent in UFACE context DitsInterested()was used to indicate an interest in ERS messages.

virtual void DcppTask::Delete (  int  force, StatusType *  status )  [inline, virtual]

Delete the task. Tell IMP to delete the task. Parameters: force  If true, force the task to be deleted, rather then asking it nicely to delete itself. status  Inherited Status

virtual void DcppTask::Died (   )  [inline, virtual]

Note that a task has died.

DcppHandlerRet DcppTask::DiscardResponse (  DcppVoidPnt  ClientData, StatusType *  status )  [static]

Flag argument success handler indicating reponses are to be ignored. If this function is specified as a SuccessHandler to any of the functions which send messages to tasks (other then DcppTask::GetPath) then the target task is told not to return any reponses to that message. Parameters: ClientData  Ignored. status  Inherited status

virtual DcppHandlerRet DcppTask::Get (  const char *const  name, StatusType *const  status, const DcppHandlerRoutine  SuccessHandler = 0, const DcppHandlerRoutine  ErrorHandler = 0, const DcppVoidPnt  ClientData = 0, const DcppHandlerRoutine  ErsHandler = 0 )  [inline, virtual]

Send a DRAMA message to the task to get the value of a parameter. This is the basic method for sending an GET message to the task referred to by this object - to return the value of a single parameter. We must already have path to the task. If this function returns DcppReschedule, then messages are expected and should be dispatched using DcppDispatch() when they arrive. This will ensure that future processing occurs correctly and the the appropriate handler is invoked when the operation completes. See also: DcppTask::MGet Returns: DcppReschedule if a message was started. Otherwise DcppFinished and status will be set bad. Parameters: name  The name of the parameter the value of which should be fetched. status  Inherited Status SuccessHandler  DcppDispatch() will invoke this if the operation completes successfully. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ErrorHandler  DcppDispatch() will invoke this if the operation fails after a message has been sent. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ClientData  Passed directly to the handler functions. ErsHandler  DcppDispatch() will invoke this if a Ers message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. This would normally only happen if the message was sent in UFACE context DitsInterested()was used to indicate an interest in ERS messages.

const char* DcppTask::GetArgument (   )  const [inline]

Fetch the load argument. returns A const pointer to the load argument previously specified.

virtual void DcppTask::GetDitsPath (  DitsPathType *  path, StatusType *  status )  [virtual]

Return the underlying DITS path object. This method returns the underlying DITS path object being used by the DcppTask object. If it is not yet active then status will be set to DCPP__INVSTATE Parameters: path  The path is returned here. status  Inherited status

virtual DcppHandlerRet DcppTask::GetPath (  StatusType *const  status, const DcppHandlerRoutine  SuccessHandler = 0, const DcppHandlerRoutine  ErrorHandler = 0, const DcppVoidPnt  ClientData = 0 )  [virtual]

Get a path to/load a the task. This call initiates getting a path to the task. If the task is not running, it will be loaded if a sufficent information has been specified. If this function returns DcppReschedule, then messages are expected and should be dispatched using DcppDispatch() when they arrive. This will ensure that future processing occurs correctly and the the appropaite handler is invoked when the operation completes. Parameters: status  Inherited Status SuccessHandler  DcppDispatch() will invoke this if the operation completes successfully. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ErrorHandler  DcppDispatch() will invoke this if the operation fails after a message has been sent. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ClientData  Passed directly to the handler functions.

bool DcppTask::GetPathLoaded (   )  const [inline]

Indicate if a the task was loaded. returns True if the task we are talking too was loaded.

void DcppTask::HandleDisconnected (  const char *  task, DitsPathType  path, StatusType *  status )  [static]

Handle task disconnection. Used internally only.

DcppHandlerRet DcppTask::HandleMessage (  DcppTransaction *  transaction, StatusType *  status )

Function used by DcppDispatch in dispatching to handlers.

virtual bool DcppTask::Initial (   )  [inline, virtual]

Return true if a GetPath operation is required. Returns: true if a DcppTask::GetPath operation is needed.

virtual bool DcppTask::IsDead (   )  [inline, virtual]

Return true if a previously active task has disconnected. Returns: true if the task has disconnected.

virtual DcppHandlerRet DcppTask::Kick (  const char *const  name, const DcppShared &  SharedMem, const bool  sds, const int  NotifyBytes, StatusType *const  status, const DcppHandlerRoutine  SuccessHandler = 0, const DcppHandlerRoutine  ErrorHandler = 0, const DcppBulkTransRoutine  BulkTransHandler = 0, const DcppHandlerRoutine  BulkDoneHandler = 0, const DcppVoidPnt  ClientData = 0, const DcppHandlerRoutine  ErsHandler = 0, const DcppHandlerRoutine  MsgHandler = 0 )  [inline, virtual]

Send a DRAMA bulk data Kick message to the task. This method is used for sending an KICK message with a bulk data argument to the task referred to by this object. We must already have path to the task. If this function returns DcppReschedule, then messages are expected and should be dispatched using DcppDispatch() when they arrive. This will ensure that future processing occurs correctly and the the appropriate handler is invoked when the operation completes. Returns: DcppReschedule if a message was started. Otherwise DcppFinished and status will be set bad. Parameters: name  The name of the action to obey. SharedMem  Shared memory details. sds  Set true if sending an SDS structure in the bulk data. NotifyBytes  The bulk data update notification rate in bytes. status  Inherited Status SuccessHandler  DcppDispatch() will invoke this if the operation completes successfully. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ErrorHandler  DcppDispatch() will invoke this if the operation fails after a message has been sent. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. BulkTransHandler  DcppDispatch() will invoke this if a message indicating a bulk data transfer update is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. BulkDoneHandler  DcppDispatch() will invoke this if a message indicating a bulk data transfer complete is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. ClientData  Passed directly to the handler functions. ErsHandler  DcppDispatch() will invoke this if a Ers message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. This would normally only happen if the message was sent in UFACE context DitsInterested()was used to indicate an interest in ERS messages. MsgHandler  DcppDispatch() will invoke this if a MsgOut()message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. This would normally only happen if the message was sent in UFACE context DitsInterested()was used to indicate an interest in MsgOut()messages.

virtual DcppHandlerRet DcppTask::Kick (  const char *const  name, StatusType *const  status, const SdsId &  arg = SdsNull, const DcppHandlerRoutine  SuccessHandler = 0, const DcppHandlerRoutine  ErrorHandler = 0, const DcppVoidPnt  ClientData = 0, const DcppHandlerRoutine  ErsHandler = 0, const DcppHandlerRoutine  MsgHandler = 0 )  [inline, virtual]

Send a DRAMA Kick message to the task. This is the basic method for sending a KICK message to the task referred to by this object. We must already have path to the task. If this function returns DcppReschedule, then messages are expected and should be dispatched using DcppDispatch() when they arrive. This will ensure that future processing occurs correctly and the the appropriate handler is invoked when the operation completes. Returns: DcppReschedule if a message was started. Otherwise DcppFinished and status will be set bad. Parameters: name  The name of the action to obey. status  Inherited Status arg  The argument to the action. Defaults to SdsNull, a null argument. SuccessHandler  DcppDispatch() will invoke this if the operation completes successfully. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ErrorHandler  DcppDispatch() will invoke this if the operation fails after a message has been sent. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ClientData  Passed directly to the handler functions. ErsHandler  DcppDispatch() will invoke this if a Ers message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. This would normally only happen if the message was sent in UFACE context DitsInterested()was used to indicate an interest in ERS messages. MsgHandler  DcppDispatch() will invoke this if a MsgOut()message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. This would normally only happen if the message was sent in UFACE context DitsInterested()was used to indicate an interest in MsgOut()messages.

virtual void DcppTask::KickForget (  const char *const  name, StatusType *const  status, const SdsId &  arg = SdsNull, const DcppHandlerRoutine  SuccessHandler = 0, const DcppHandlerRoutine  ErrorHandler = 0, const DcppVoidPnt  ClientData = 0, const DcppHandlerRoutine  ErsHandler = 0, const DcppHandlerRoutine  MsgHandler = 0 )  [inline, virtual]

Send a DRAMA OKick message to the task, forgetting the transaction. This a method for sending an KICK message to the task referred to by this object, but immediately orphaning the resulting transaction. We must already have path to the task. If all handlers are null (0) then the transaction is completely orphaned and will not be handled by DcppDispatch(). If the success handler is set to "DcppTask::DiscardResponse" then the other handlers are ignored and reponses are not even sent back to this task at all. Otherwise, the various handlers will be invoked if DcppDispatch() is invoked by an orphan handler in response to reply message from this message. Parameters: name  The name of the action to obey. status  Inherited Status arg  The argument to the action. Defaults to SdsNull, a null argument. SuccessHandler  DcppDispatch() will invoke this if the operation completes successfully. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ErrorHandler  DcppDispatch() will invoke this if the operation fails after a message has been sent. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ClientData  Passed directly to the handler functions. ErsHandler  DcppDispatch() will invoke this if a Ers message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. This would normally only happen if the message was sent in UFACE context DitsInterested()was used to indicate an interest in ERS messages. MsgHandler  DcppDispatch() will invoke this if a MsgOut()message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. This would normally only happen if the message was sent in UFACE context DitsInterested()was used to indicate an interest in MsgOut()messages.

const char* DcppTask::Location (   )  const [inline]

Fetch the task location. Returns the name of the node on which the task is running (unless it was already known locally when DcppTask::GetPath was running, in which case we don't know where it is, but the value specified to the constructor is returns) returns A const pointer to the node name.

void DcppTask::LoggingOff (   )  [inline, static]

Disable logging for all tasks. Turn logging for all tasks off. Logging is now determined by the object specific log flag

void DcppTask::LoggingOn (   )  [inline, static]

Enable logging for all DcppTask objects. This static method can be used to enable logging for all DcppTask objects, ignoring the object specific log flag

virtual void DcppTask::LogLoad (  const bool  Flag = true  )  [inline, virtual]

Load use. MsgOut()a lines indicating the load operations If set true, this flag causes MsgOut()messages to be output around the load operations, if they occur. Parameters: Flag  The value for the flag.

virtual void DcppTask::LosePath (  StatusType *const  status  )  [inline, virtual]

Lose the path and then set as if the task has died. This will send a full DRAMA DitsPathGet()operation will be done by the next DcppTask::GetPath operation. After doing this, you can no longer sends messages to the specified task. Parameters: status  Inherited Status

virtual DcppHandlerRet DcppTask::MGet (  const DcppHandlerRoutine  SuccessHandler, const DcppHandlerRoutine  ErrorHandler, const DcppHandlerRoutine  ErsHandler, const DcppVoidPnt  ClientData, unsigned  count, StatusType *  status, ...  )  [virtual]

Send a DRAMA message to the task to get the value of multiple parameters. This is the a method for sending an MGET message to the task referred to by this object - to return the value of a multiple parameters. We must already have path to the task. This version supports explict handling of any Ers messages. If this function returns DcppReschedule, then messages are expected and should be dispatched using DcppDispatch() when they arrive. This will ensure that future processing occurs correctly and the the appropriate handler is invoked when the operation completes. Returns: DcppReschedule if a message was started. Otherwise DcppFinished and status will be set bad. Parameters: SuccessHandler  DcppDispatch() will invoke this if the operation completes successfully. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ErrorHandler  DcppDispatch() will invoke this if the operation fails after a message has been sent. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ClientData  Passed directly to the handler functions. count  The number of parameters. ErsHandler  DcppDispatch() will invoke this if a Ers message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. This would normally only happen if the message was sent in UFACE context DitsInterested()was used to indicate an interest in ERS messages. status  Inherited Status ...  The parameter names, all "const char *".

virtual DcppHandlerRet DcppTask::MGet (  const DcppHandlerRoutine  SuccessHandler, const DcppHandlerRoutine  ErrorHandler, const DcppVoidPnt  ClientData, unsigned  count, StatusType *  status, ...  )  [virtual]

Send a DRAMA message to the task to get the value of multiple parameters. This a method for sending an MGET message to the task referred to by this object - to return the value of a multiple parameters. We must already have path to the task. If this function returns DcppReschedule, then messages are expected and should be dispatched using DcppDispatch() when they arrive. This will ensure that future processing occurs correctly and the the appropriate handler is invoked when the operation completes. See also: DcppTask::Get Returns: DcppReschedule if a message was started. Otherwise DcppFinished and status will be set bad. Parameters: SuccessHandler  DcppDispatch() will invoke this if the operation completes successfully. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ErrorHandler  DcppDispatch() will invoke this if the operation fails after a message has been sent. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ClientData  Passed directly to the handler functions. count  The number of parameters. status  Inherited Status ...  The parameter names, all "const char *".

virtual DcppHandlerRet DcppTask::Monitor (  const char *  name, StatusType *const  status, const SdsId &  arg = SdsNull, const DcppHandlerRoutine  SuccessHandler = 0, const DcppHandlerRoutine  ErrorHandler = 0, const DcppHandlerRoutine  TriggerHandler = 0, const DcppVoidPnt  ClientData = 0, const bool  SendCurrent = false, const DcppHandlerRoutine  ErsHandler = 0 )  [inline, virtual]

Send a DRAMA Monitor message to the task. This methods sendis a DRAMA Monitor message to the task referred to by this object. We must already have path to the task. If this function returns DcppReschedule, then messages are expected and should be dispatched using DcppDispatch() when they arrive. This will ensure that future processing occurs correctly and the the appropriate handler is invoked when the operation completes. You should note that normally the DcppMonitor:: class is used to run monitor transactions. It uses this method to start the monitors. Returns: DcppReschedule if a message was started. Otherwise DcppFinished and status will be set bad. Parameters: name  The name of the monitor message to send, one of MONITOR/FORWARD/ADD/DELETE/CANCEL status  Inherited Status arg  The argument to the message. Defaults to SdsNull, a null argument. SuccessHandler  DcppDispatch() will invoke this if the operation completes successfully. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ErrorHandler  DcppDispatch() will invoke this if the operation fails after a message has been sent. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. TriggerHandler  DcppDispatch() will invoke this if a trigger message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. ClientData  Passed directly to the handler functions. SendCurrent  If true, then a Monitor START/FORWARD message will send the current values of the parameter right away. ErsHandler  DcppDispatch() will invoke this if a Ers message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. This would normally only happen if the message was sent in UFACE context DitsInterested()was used to indicate an interest in ERS messages.

virtual void DcppTask::MonitorForget (  const char *  name, StatusType *const  status, const SdsId &  arg = SdsNull, const DcppHandlerRoutine  SuccessHandler = 0, const DcppHandlerRoutine  ErrorHandler = 0, const DcppHandlerRoutine  TriggerHandler = 0, const DcppVoidPnt  ClientData = 0, const bool  SendCurrent = false, const DcppHandlerRoutine  ErsHandler = 0 )  [inline, virtual]

Send a DRAMA Monitor message to the task, forgetting the transaction. This a method for sending an Monitor message to the task referred to by this object, but immediately orphaning the resulting transaction. We must already have path to the task. If all handlers are null (0) then the transaction is completely orphaned and will not be handled by DcppDispatch(). If the success handler is set to "DcppTask::DiscardResponse" then the other handlers are ignored and reponses are not even sent back to this task at all. Otherwise, the various handlers will be invoked if DcppDispatch() is invoked by an orphan handler in response to reply message from this message. Parameters: name  The name of the monitor message to send, one of MONITOR/FORWARD/ADD/DELETE/CANCEL status  Inherited Status arg  The argument to the action. Defaults to SdsNull, a null argument. SuccessHandler  DcppDispatch() will invoke this if the operation completes successfully. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ErrorHandler  DcppDispatch() will invoke this if the operation fails after a message has been sent. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. TriggerHandler  DcppDispatch() will invoke this if a trigger message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. ClientData  Passed directly to the handler functions. SendCurrent  If true, then a Monitor START/FORWARD message will send the current values of the parameter right away. ErsHandler  DcppDispatch() will invoke this if a Ers message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. This would normally only happen if the message was sent in UFACE context DitsInterested()was used to indicate an interest in ERS messages.

virtual DcppHandlerRet DcppTask::Obey (  const char *const  name, const DcppShared &  SharedMem, const bool  sds, const int  NotifyBytes, StatusType *const  status, const DcppHandlerRoutine  SuccessHandler, const DcppHandlerRoutine  ErrorHandler, const DcppBulkTransRoutine  BulkTransHandler, const DcppHandlerRoutine  BulkDoneHandler, const DcppHandlerRoutine  TriggerHandler, const DcppVoidPnt  ClientData, const DcppHandlerRoutine  ErsHandler, const DcppHandlerRoutine  MsgHandler, const SdsId *const  tidArg )  [inline, virtual]

Send a DRAMA Obey bulk data message to the task. This method is used for sending an OBEY message with a bulk data argument to the task referred to by this object. We must already have path to the task. This version returns the transaction id in a SDS structure set up ready for sending with a Kick message. (It is set up by DcppSpawnKickArgUpdate()). If this function returns DcppReschedule, then messages are expected and should be dispatched using DcppDispatch() when they arrive. This will ensure that future processing occurs correctly and the the appropriate handler is invoked when the operation completes. Returns: DcppReschedule if a message was started. Otherwise DcppFinished and status will be set bad. Parameters: name  The name of the action to obey. SharedMem  Shared memory details. sds  Set true if sending an SDS structure in the bulk data. NotifyBytes  The bulk data update notification rate in bytes. status  Inherited Status SuccessHandler  DcppDispatch() will invoke this if the operation completes successfully. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ErrorHandler  DcppDispatch() will invoke this if the operation fails after a message has been sent. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. BulkTransHandler  DcppDispatch() will invoke this if a message indicating a bulk data transfer update is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. BulkDoneHandler  DcppDispatch() will invoke this if a message indicating a bulk data transfer complete is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. TriggerHandler  DcppDispatch() will invoke this if a trigger message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. ClientData  Passed directly to the handler functions. ErsHandler  DcppDispatch() will invoke this if a Ers message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. This would normally only happen if the message was sent in UFACE context DitsInterested()was used to indicate an interest in ERS messages. MsgHandler  DcppDispatch() will invoke this if a MsgOut()message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. This would normally only happen if the message was sent in UFACE context DitsInterested()was used to indicate an interest in MsgOut()messages. tidArg  Update the DRAMA transaction id in this SDS structure for the started transaction in a form ready for use in a Kick message argument. This is usefull when we might want to kick a spawnable action.

virtual DcppHandlerRet DcppTask::Obey (  const char *const  name, const DcppShared &  SharedMem, const bool  sds, const int  NotifyBytes, StatusType *const  status, const DcppHandlerRoutine  SuccessHandler, const DcppHandlerRoutine  ErrorHandler, const DcppBulkTransRoutine  BulkTransHandler, const DcppHandlerRoutine  BulkDoneHandler, const DcppHandlerRoutine  TriggerHandler, const DcppVoidPnt  ClientData, const DcppHandlerRoutine  ErsHandler, const DcppHandlerRoutine  MsgHandler, SdsId *const  tidArg )  [inline, virtual]

Send a DRAMA Obey bulk data message to the task. This method is used for sending an OBEY message with a bulk data argument to the task referred to by this object. We must already have path to the task. This version returns the transaction id in a SDS structure set up ready for sending with a Kick message. (It is set up by DcppSpawnKickArg()). If this function returns DcppReschedule, then messages are expected and should be dispatched using DcppDispatch() when they arrive. This will ensure that future processing occurs correctly and the the appropriate handler is invoked when the operation completes. Returns: DcppReschedule if a message was started. Otherwise DcppFinished and status will be set bad. Parameters: name  The name of the action to obey. SharedMem  Shared memory details. sds  Set true if sending an SDS structure in the bulk data. NotifyBytes  The bulk data update notification rate in bytes. status  Inherited Status SuccessHandler  DcppDispatch() will invoke this if the operation completes successfully. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. ErrorHandler  DcppDispatch() will invoke this if the operation fails after a message has been sent. This function should return DcppReschedule if it sends another message. Otherwise it should return DcppFinished. The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished. BulkTransHandler  DcppDispatch() will invoke this if a message indicating a bulk data transfer update is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. BulkDoneHandler  DcppDispatch() will invoke this if a message indicating a bulk data transfer complete is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. TriggerHandler  DcppDispatch() will invoke this if a trigger message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. ClientData  Passed directly to the handler functions. ErsHandler  DcppDispatch() will invoke this if a Ers message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. This would normall