MSG_RTCREATE_STRUCT

Hi jeroen,

here you will get a c-script taht I use as a function in my project.
this function I normally call upon when a user presses the start or stop button in my application (start of a plant section).

This way I can log the user that presses the button.

Please note that in this script I also retrieve the username.
the username in my application is stored in a picture that is referenced by pAFP variable.
For your application you could retrieve the username from a tag or something similar.
For you to use this script, you should terfore change that section.

have fun with it.

With regards,
Ikkezelf

[code]#pragma code ("Kernel32.DLL");
BOOL GetComputerNameA(LPSTR Computername, LPDWORD size);
BOOL GetLocalTime(SYSTEMTIME* stTime);
#pragma code();
#include "M_GLOBAL.H"
#include "msrtapi.h"

// Description:
// Function to create user specific operator messages
// Call e.g. released by a button: OperatorEventMessage(CommentText,W_old,W_new,pAFP);
// W_old value is used to see if it should create a Session settings entry or a Control Command entry
// W_new value is not used at this point, but can be used for displaying a process value in the operator message.
// pAFP is used for reference to retrieve the logged in user from an I/O field.
//------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
void OperatorEventMessage( char* CommentText,double doValueOld, double doValueNew, char* pAFP, char* ItemIdentifier, char* TaskGroup, char* OperationalArea)
{
// Declaration
CMN_ERROR g_sErr;
LPCMN_ERROR pError = &g_sErr; /* Global Error Block */
BOOL fRet = TRUE;
DWORD dwBufSize;
static DWORD l_svID = 0; //Connection ID to Alarmlogging
int SwitchValue;

DWORD dwVarID=0; // Tag-ID set to 0
MSG_RTCREATE_STRUCT MsgCreate;
MSG_COMMENT_STRUCT MsgComment;
SYSTEMTIME stTime;
GetLocalTime( &stTime ); // Get time/date

// Retrieve, Set and Process Values
SwitchValue = (short)doValueOld;
MsgCreate.dwMsgNr = MSG_SINGLE_OPERATION;
MsgComment.dwMsgNr = MSG_SINGLE_OPERATION;
MsgCreate.stMsgTime = stTime;
MsgComment.stTime = stTime;
MsgCreate.wPValueUsed = 6; // 3 Process Tags( 0..2 )
////MsgCreate.dPValue[0] = dwVarID; // Tag-ID
MsgCreate.dPValue[1] = 0; //doValueOld; // previous value
MsgCreate.dPValue[2] = 0; //doValueNew; // current value
MsgCreate.wTextValueUsed = 57;

strcpy(MsgCreate.mtTextValue[0].szText,"Screen Settings Changed");// Description
strcpy(MsgCreate.mtTextValue[3].szText,ItemIdentifier); // Item Identifier
strcpy(MsgCreate.mtTextValue[4].szText,TaskGroup); // Task Group
strcpy(MsgCreate.mtTextValue[5].szText,OperationalArea); // Operational Area

MsgCreate.dwMsgState = MSG_STATE_COME; // state "COME"
strcpy( MsgComment.szText, CommentText );

// Include the currently logged on user.
if (strlen(GetOutputValueChar(pAFP,"CurrentUser")) >=1)
strcpy( MsgComment.szUser, GetOutputValueChar(pAFP,"CurrentUser"));
else // probably it will never reach this state, cause until now the log out of an user will not log all CD changes, but if CurrentUser field on AFP is empty then "Auto-System" is assigned as user.
strcpy( MsgComment.szUser,"Auto-System");

// Retrieve Computername
dwBufSize = sizeof( MsgComment.szComputerName );
GetComputerNameA( MsgComment.szComputerName, &dwBufSize );
do
{
if ( l_svID==0)
{
fRet= MSRTStartMsgService( &l_svID, NULL, NULL, 0, NULL, pError ); // activate service
if (!fRet) break;
// printf( "Alarm Connected %d \r\n", l_svID );
}
fRet = MSRTCreateMsg( l_svID, &MsgCreate, pError ) ; // create message

// Create comment
if (fRet == FALSE )
{
printf("MSRTCreateMsg_Error %s \r\n",pError->szErrorText);
}
else
{
MSRTSetComment( l_svID, &MsgComment, pError );
}
break;
} while(TRUE);

fRet=MSRTStopMsgService(l_svID,pError); // cancel service
// printf("StopMsgService %d %s \r\n",fRet,pError->szErrorText);
if (fRet==TRUE)
l_svID=0;
}[/code]

strcpy(MsgCreate.mtTextValue[0].szText,"ScreenSettingsChanged");//Description
strcpy(MsgCreate.mtTextValue[3].szText,ItemIdentifier);//ItemIdentifier
strcpy(MsgCreate.mtTextValue[4].szText,TaskGroup);//TaskGroup
strcpy(MsgCreate.mtTextValue[5].szText,OperationalArea);//Operational[/code]

For this to work you need to create a few process value blocks within the alarm logging.
- Create 6 in total. Process value block 1 till 6.
- Process value block 1 will represent the "Description"
- Process value block2 will represent the "doValueOld"
- Process value block3 will represent the "doValueNew"
- Process value block4 will represent the "ItemIdentifier"
- Process value block5 will represent the "TaskGroup"
- Process value block6 will represent the "Operational"

Process value block1 equals mtTextValue[0]
Process value block2 equals dPValue[1]
Process value block3 equals dPValue[2]
Process value block4 equals mtTextValue[3]
Process value block5 equals mtTextValue[4]
Process value block6 equals mtTextValue[5]

mtTextValue[0] (first "bit") equals 1
mtTextValue[5] (sixt "bit") equals 32

wTextValueUsed=57 equals mtTextValue[0] + mtTextValue[3] + mtTextValue[4] + mtTextValue[5] => ( 1+8+16+32).

wPValueUsed=6 equals dPValue[1] + dPValue[2] => (2+4).


I hope it's a bit more clear now.

with regards,
ikkezelf