Download The CORDET Framework C2 Implementation - USER MANUAL -

PP-UM-COR-00002
12
Revision 0.6.0
The OutLoader Component
After a user application has obtained an OutComponent component from an
OutFactory, it loads it into the OutLoader. This component is responsible for
selecting the appropriate OutManager to process the out-going command or
report.
For this purpose, the OutLoader maintains a list of OutManagers (the List of
OutManagers or LOM). The LOM holds all the OutManagers which have been
instantiated in an application.
The OutLoader component offers one operation – the Load operation – to load
an OutComponent into an OutManager. When this operation is called, the
OutLoader decides to which OutManager in the LOM to load an OutComponent. The policy for selecting the OutManager in the LOM is an adaptation
point. After the OutComponent is loaded into the selected OutManager, the
procedure may activate the selected OutManager (i.e. it may release the thread
which is controlling the execution of the selected OutManager). This is useful
where there is a need to process the out-going command or report as soon as it
is loaded into the OutLoader (normally, the command or report would only be
processed when the OutManager is executed).
The Load operation is modelled by the procedure shown in figure 12.1. A
call to operation Load causes this procedure to be started and executed. The
procedure executes in one single cycle and therefore terminates as part of the
call to operation Load.
No facilities are defined for dynamically changing the set of OutManagers in the
LOM. Changes in the list of OutManagers can only be done by reconfiguring
and then resetting the OutLoader component.
Fig. 12.1: The OutLoader Load Procedure
The C2 Implementation implements the OutLoader component in module CrFwOutLoader.
Its adaptation points are defined in CrFwOutLoaderUserPar.h. In most cases,
the only adaptation point for which a non-default implementation is required
is the one covering the definition of the function which selects the OutManager
where an out-going command or report should be loaded.
By default, the initialization, reset and shutdown operations of the OutLoader
are the same as on the Base Component but these operations are implemented as
adaptation points so that the user has a chance to use them to initialize or reset
the data structures which are used to control the selection of the OutManager
where an out-going command or report is loaded.
c
2013
P&P Software GmbH. All Rights Reserved.
This document is provided with the GPL version of the
C2 Implementation of the CORDET Framework.
75