acp_run.c

   File         : acp_run.c
   Description  : Manipulates the instance of a given ACP
   Category     : ACP Internal
   Author       : Charles Yates

   ACPRUN DLLEXP ACPRUN_Init( ACPENV global, char *script )
 
   Function     : ACPRUN_Init
   Description  : Initialises a new ACP structure
   Input        : ACPENV global - global environment from web server
                  char *script - file containing acp script
   Output       : void
   Returns      : An initialised structure or NULL if an error occurs

   char * DLLEXP ACPRUN_GetFile( ACPRUN run )
 
   Function     : ACPRUN_GetFile
   Description  : Returns the script file of the run object
   Input        : ACPRUN run - the run object to query
   Output       : void
   Returns      : char * - script file in run

   int DLLEXP ACPRUN_Loader( ACPRUN run, ACP acp )
 
   Function     : ACPRUN_Loader
   Description  : Loads the ACP
   Input        : ACPRUN run - acp run object to be used
                  ACP acp - acp structure to use
   Output       : Creates new make, source and shared object if required
   Returns      : int - 0 on success or [undefined] as errors

   int DLLEXP ACPRUN_Execute( ACPRUN run, ACP acp )
 
   Function     : ACPRUN_Execute
   Description  : Executes the loaded ACP
   Input        : ACPRUN run - acp run object to be used
                  ACP acp - ACP structure to use
   Output       : out contains output of execution
   Returns      : int - 0 on success or [undefined] as errors

   int DLLEXP ACPRUN_Finished( ACPRUN run )
 
   Function     : ACPRUN_Finished
   Description  : Used to denote that the allocated run object is not being 
                  used by caller
   Input        : ACPRUN run - acp run object to be used
   Output       : Active count of run is decremented
   Returns      : int - 0 on success or [undefined] as errors

   void DLLEXP ACPRUN_Close( ACPRUN run, ACP acp )
 
   Function     : ACPRUN_Close
   Description  : Initialises a new ACP structure
   Input        : ACPRUN run - acp run object to be used
   Output       : run is destroyed
   Returns      : void