Home

 

PutApplName (MQCHAR28)

This is the name of application that put the message, 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 of the PutApplName depends on the value of PutApplType.

When the queue manager sets this field (that is, for all options except MQPMO_SET_ALL_CONTEXT), it sets the field to a value that is determined by the environment:

• On z/OS, the queue manager uses:

  • For z/OS batch, the 8-character job name from the JES JOB card

  • For TSO, the 7-character TSO user identifier

  • For CICS, the 8-character applid, followed by the 4-character tranid

  • For IMS, the 8-character IMS system identifier, followed by the 8-character PSB name

  • For XCF, the 8-character XCF group name, followed by the 16-character XCF member name

  • For a message generated by a queue manager, the first 28 characters of the queue manager name

  • For distributed queuing without CICS, the 8-character jobname of the channel initiator followed by the 8-character name of the module putting to the dead-letter queue followed by an 8-character task identifier.

  The name or names are each padded to the right with blanks, as is any space in the remainder of the field. Where there is more than one name, there is no separator between them.

• On Windows systems, the queue manager uses:

  • For a CICS application, the CICS transaction name

  • For a non-CICS application, the rightmost 28 characters of the fully-qualified name of the executable

• On i5/OS, the queue manager uses the fully-qualified job name.

• On UNIX systems, the queue manager uses:

  • For a CICS application, the CICS transaction name

  • For a non-CICS application, at least the rightmost 14 characters of the fully-qualified name of the executable, if this is available to the queue manager, and blanks otherwise.

For the MQPUT and MQPUT1 calls, this is an input/output field if MQPMO_SET_ALL_CONTEXT is specified in the PutMsgOpts parameter. Any information following a null character within the field is discarded. The null character and any following characters are converted to blanks by the queue manager. 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 PutApplName 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_APPL_NAME_LENGTH. The initial value of this field is the null string in C, and 28 blank characters in other programming languages.

 

Home