MDPAN (28-byte character string)

Name of application that put the message.

This 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 MDPAN depends on the value of MDPAT.

When this field is set by the queue manager (that is, for all options except PMSETA), it is set to value which 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.

  • For MQSeries Java language bindings processing with WebSphere MQ for OS/390, the 8-character jobname of the address space created for the OpenEdition environment. Typically, this will be a TSO user identifier with a single numeric character appended.

  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 OS/2, PC DOS, and 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 HP OpenVMS and Compaq NonStop Kernel, the queue manager uses: the rightmost 28 characters of the fully-qualified name of the executable, if this is available to the queue manager, and blanks otherwise

• On UNIX systems, the queue manager uses:

  • For a CICS application, the CICS transaction name

  • For a non-CICS application, the rightmost 14 characters of the fully-qualified name of the executable if this is available to the queue manager, and blanks otherwise (for example, on AIX)

• On VSE/ESA, the queue manager uses the 8-character applid, followed by the 4-character tranid.

For the MQPUT and MQPUT1 calls, this is an input/output field if PMSETA is specified in the PMO 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 PMSETA 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 MDPAN 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 LNPAN. The initial value of this field is 28 blank characters.