NAME
Oorb::CommandMgrTask - Command-manager task for the oorb library
SYNOPSIS
-loorb $(ORBLIBS)
#include "oorb.h"
namespace Oorb
class CommandMgrTask
DESCRIPTION
The
CommandMgrTask class is used internally by the
Oorb(3)
library. The
Oorb::Master(3) class within an
Oorb(3)-library
based program automatically instantiates and calls the
run method
on an object of the
CommandMgrTask class.
The
CommandMgrTask's main job is to monitor an
orbserver(1)
for command packets as issued by the
dlcmd(1) program, directing
the received commands to the appropriate internal tasks and managing
responses to those commands.
CONSTRUCTORS
-
CommandMgrTask( void )
The CommandMgrTask constructor is invoked automatically from
within the Oorb::Master(3) run method and should not
need to be called by application programmers.
METHODS
-
void run( void );
The CommandMgrTask's run method is invoked automatically from
within the Oorb::Master(3) run method and should not
need to be called by application programmers.
-
Pf* executeAndRespond( const Pf* pf_command );
The executeAndRespond method takes input command parameter-file
packets pf_command in the style of dlcmd(1), processes
them, and returns the result parameter-file structure, if any, to be
sent back to the initiating dlcmd(1) instance. See the
dlcmd(1) man-page for for further details.
OBJECT CONFIGURATION PARAMETERS
The
CommandMgrTask object contains a public member
struct of name
m_commandParams which is defined below. If
orbtag is defined,
commands are read and written from the given
orbtag. If
orbname is
defined, commands are read and written from that
orbname. If neither
is defined, the
CommandMgrTask ignores all commands.
typedef struct commandParamsStruct {
char* orbtag;
char* orbname;
} commandParamsStruct;
-
orbtag
The char* orbtag parameter contains the tag name of
the orbserver(1) on which to read and write commands. If specified,
orbtag takes precedence over orbname.
-
orbname
The char* orbname parameter contains the name of
the orbserver(1) on which to read and write commands. If orbtag
is specified, orbname is ignored.
LIBRARY
-loorb $(ORBLIBS)
ATTRIBUTES
MT-Safe
SEE ALSO
Oorb(3), Oorb::Task(3), Oorb::Master(3)
BUGS AND CAVEATS
In principle the
executeAndRespond method can be overridden by
derived programs. In practice this would be somewhat involved with
the current version of the
Oorb(3) library.
AUTHOR
Kent Lindquist