Home

 

PutTime (MQCHAR8)

This is the time when the message was put, and is part of the origin context of the message. For more information about message context, see Overview; also see the WebSphere MQ Application Programming Guide.

The format used for the time when this field is generated by the queue manager is:

where the characters represent (in order):

HH

hours (00 through 23)

MM

minutes (00 through 59)

SS

seconds (00 through 59; see note below)

T

tenths of a second (0 through 9)

H

hundredths of a second (0 through 9)
Note:
If the system clock is synchronized to a very accurate time standard, it is possible on rare occasions for 60 or 61 to be returned for the seconds in PutTime. This happens when leap seconds are inserted into the global time standard.

Greenwich Mean Time (GMT) is used for the PutDate and PutTime fields, subject to the system clock being set accurately to GMT.

If the message was put as part of a unit of work, the time is that when the message was put, and not the time when the unit of work was committed.

For the MQPUT and MQPUT1 calls, this is an input/output field if MQPMO_SET_ALL_CONTEXT is specified in the PutMsgOpts parameter. The queue manager does not check the contents of the field, except that any information following a null character within the field is discarded. The queue manger converts the null character and any following characters to blanks. If MQPMO_SET_ALL_CONTEXT is not specified, this field is ignored on input and is an output-only field.

After the successful completion of an MQPUT or MQPUT1 call, this field contains the PutTime that was transmitted with the message. If the message has no context, the field is entirely blank.

This is an output field for the MQGET call. The length of this field is given by MQ_PUT_TIME_LENGTH. The initial value of this field is the null string in C, and 8 blank characters in other programming languages.




 

Home