/// <summary>
/// The GetCreateTID() static function is used to create a new TID based on the most recent
/// known TID version and return an ITID interface to the TID object for the new TID.
/// GetCreateTID() should be called by external logic when a new TID needs to be created for a logical message transaction.
/// GetCreateTID() calls CreateTID() on the newly created TID object to set the TID fields.
/// Update/override any TID fields by specifying those field/values within the passed Hashtable argument.
/// GetCreateTID() sets the SUCCESS key in the passed Hashtable to the return value of CreateTID (true or false).
/// </summary>
/// <param name="mapPropsIn"></param>
/// <returns>ITID</returns>
public static ITID GetCreateTID(Hashtable mapPropsIn)
{
// Create a new TID
TIDBase tid = new TID();
// Call CreateTID() to set fields for creation and store success status in map for caller
mapPropsIn[TIDField.SUCCESS] = tid.CreateTID(mapPropsIn);
// Return interface to new TID object
return(tid);
}
/// <summary>
/// The TID() copy constructor is used to initialize a new TID object based on fields set in an existing TID object upon object creation.
/// The TID() copy constructor will set the appropriate property and Hashtable entries.
/// </summary>
/// <param name="tidIn"></param>
/// <returns></returns>
public TID(TID tidIn)
: base(tidIn)
{
mapProps[TIDField.CORRELATIONID] = correlationId = tidIn.correlationId;
mapProps[TIDField.DESTINATION] = destination = tidIn.destination;
mapProps[TIDField.EXPIREDT] = expireDT = tidIn.expireDT;
mapProps[TIDField.MESSAGEID] = messageId = tidIn.messageId;
mapProps[TIDField.MESSAGEVERSION] = messageVersion = tidIn.messageVersion;
mapProps[TIDField.OPERATIONNAME] = operationName = tidIn.operationName;
mapProps[TIDField.ORIGINATIONDT] = originationDT = tidIn.originationDT;
mapProps[TIDField.PARAMLIST] = paramList = (tidIn.paramList != null) ? new Dictionary <string, string>(tidIn.paramList) : new Dictionary <string, string>();
mapProps[TIDField.SERVICENAME] = serviceName = tidIn.serviceName;
mapProps[TIDField.SOURCE] = source = tidIn.source;
mapProps[TIDField.USERNAME] = userName = tidIn.userName;
mapProps[TIDField.MESSAGESEQNUMBER] = messageSeqNumber = tidIn.messageSeqNumber;
mapProps[TIDField.RECEIVEDDT] = receivedDT = tidIn.receivedDT;
mapProps[TIDField.REPLY] = reply = tidIn.reply;
mapProps[TIDField.SENTDT] = sentDT = tidIn.sentDT;
mapProps[TIDField.SYNCH] = synch = tidIn.synch;
mapProps[TIDField.TIDVERSION] = tidVersion;
}