---

GLAST / LAT > DAQ and FSW > FSW > Doxygen Index> LCI / V6-0-0 > lci / mv2304

---

         

---

consign.c File Reference

Routines that act upon the consignment structure. More...

#include "LCI/LCI_msgs.h"
#include "consign_p.h"
#include "configure.h"
#include "PBS/MBA.h"
#include "MSG/MSG_pubdefs.h"
#include "PBS/BSWP.h"
#include "MON/MON_pubdefs.h"
#include "PBS/WCT.h"
#include "ITC/ITC_pubdefs.h"
#include "LSEC/LSEC_ctx.h"
#include "EDS/EBF_cid.h"
#include "EDS/EBF_dir.h"
#include "EDS/EBF_tkr.h"
#include "EDS/EBF_tem.h"
#include "EDS/EBF_gemLocate.h"
#include <string.h>

Functions
unsigned	LCI_consComplete (LCI_consignment *cns)
	Complete a consignment.
unsigned	LCI_consign (LCI_consignment *cns, LCI_compLevel comp)
	Perform a consignment.
LCI_consignment *	LCI_consCreate (unsigned cpuid, unsigned srcid, LCI_configuration *cnf, LCI_collection *cll, LSEC_compaction *cpc)
	Allocate memory for an LCI_consigment structure and initialise (clear).
void	LCI_consDelete (LCI_consignment *cns)
	Free the previously allocated consignment structure.
WCT_time_sat	LCI_consPrepare (LCI_consignment *cns, unsigned runid)
	Set the runid and start time for the first datagram of the new calibration.
void	LCI_consReason (LCI_consignment *cns, int reason)
	Set the current datagram close reason.
void	LCI_consTimes (LCI_consignment *cns, int clear, long long *raw_time, long long *tot_time)
	Return accumulated consignment time.

---

Detailed Description

Routines that act upon the consignment structure.

Author:

James Swain & Owen Saxton

Id

---

Function Documentation

unsigned LCI_consComplete

(

LCI_consignment *

cns

)

Complete a consignment.

Parameters:

cns

pointer to the consignment

Return values:

LCI_SUCCESS

If all goes well

LCI_consignment* LCI_consCreate	(	unsigned	cpuid,
		unsigned	srcid,
		LCI_configuration *	cnf,
		LCI_collection *	cll,
		LSEC_compaction *	cpc
	)

Allocate memory for an LCI_consigment structure and initialise (clear).

Parameters:

	srcid	ID of the data source
	cpuid	ID of the CPU LCI is being run on
	cll	Pointer to the collection of events to consign
	cpc	Pointer to the compaction state information
	cnf	Pointer to the configuration data

Returns:

Pointer to an allocated, initialised consignment (NULL if there is an error allocating memory)

void LCI_consDelete

(

LCI_consignment *

cns

)

Free the previously allocated consignment structure.

Parameters:

cns

Pointer to allocated, intialised consignment structure (from LCI_consCreate)

unsigned LCI_consign	(	LCI_consignment *	cns,
		LCI_compLevel	comp
	)

Perform a consignment.

Parameters:

	cns	Pointer to a consignment structure
	comp	The compression level to use.

Return values:

LCI_SUCCESS

If all goes well

WCT_time_sat LCI_consPrepare	(	LCI_consignment *	cns,
		unsigned	runid
	)

Set the runid and start time for the first datagram of the new calibration.

Parameters:

	cns	Pointer to allocated, intialised consignment structure (from LCI_consCreate)
	runid	32-bit number identifying the calibration run

Returns:

The run start time (as a 64-bit Spectrum Astro time)

void LCI_consReason	(	LCI_consignment *	cns,
		int	reason
	)

Set the current datagram close reason.

Parameters:

	cns	Pointer to the consignment structure
	reason	The reason code to be set

void LCI_consTimes	(	LCI_consignment *	cns,
		int	clear,
		long long *	raw_time,
		long long *	tot_time
	)

Return accumulated consignment time.

Parameters:

	cns	Pointer to a consignment structure.
	clear	If TRUE, clear the time after copying it.
	raw_time	Address of a variable to receive the accumulated time taken to process raw consignments, or NULL if no time wanted.
	tot_time	Address of a variable to receive the accumulated time taken to do total consignments, or NULL if no time wanted.

---