16.20 - MSM_UofW - Teradata Ecosystem Manager

Teradata® Ecosystem Manager API Reference

prodname
Teradata Ecosystem Manager
vrm_release
16.20
created_date
December 2020
category
Programming Reference
featnum
B035-3204-107K

MSM_UofW represents the Unit of Work structure. The following snippet describes its usage in simplest format:

MSM_UofW* pUOW = NULL;
pUOW=MSM_CreateUOW(pCtx);
…………………………………………………………..
…………………………………………………………..
…………………………………………………………..
…………………………………………………………..
MSM_FreeUOW(pCtx,pUOW);

The following table describes MSM_UofW structure members in detail:

MSM_UofW Parameter Data Type Usage Maps to sendevent flag
szUowId wchar_t* Unit of Work referred to by this event. Required in case MSM_UofW is used. -w
szUowClass wchar_t* Unit of Work referred to by this event. Required in case MSM_UofW is used. -wct
szUowSourceSystem wchar_t* System from which Unit of Work originated. -wss
szUowFromTS wchar_t* Timestamp from which the Unit of Work originated. -wft
szUowToT wchar_t* Timestamp of the Unit of Work. -wts

The two utility functions MSM_UpdateUofWFromEnvironment and MSM_UpdateUofWWithUniqueId populate the pointer to MSM_UofW structure. This is a common way of populating MSM_UofW, depending on the way Unit of Work is sourced.

START, STEP, and END events require MSM_UofW. MSM_UofW is updated with unique UOWID for these three events in case szUowId (member of MSM_UofW structure) is not initialized by direct assignment or by using MSM_UpdateUofWFromEnvironment and MSM_UpdateUofWWithUniqueId functions.