ApplId (MQCHAR256)

This is a character string that identifies the application to be started, and is used by the trigger-monitor application that receives the trigger message. The queue manager initializes this field with the value of the ApplId attribute of the process object identified by the ProcessName field; see Attributes for process definitions for details of this attribute. The content of this data is of no significance to the queue manager.

The meaning of ApplId is determined by the trigger-monitor application. The trigger monitor provided by IBM MQ requires ApplId to be the name of an executable program. The following notes apply to the environments indicated:

  • On z/OS, ApplId is:

    • A CICS transaction identifier, for applications started using the CICS trigger-monitor transaction CKTI
    • An IMS transaction identifier, for applications started using the IMS trigger monitor CSQQTRMN

  • On Windows systems, the program name can be prefixed with a drive and directory path.
  • On IBM i, the program name can be prefixed with a library name and / character.
  • On UNIX, the program name can be prefixed with a directory path.

The length of this field is given by MQ_PROCESS_APPL_ID_LENGTH. The initial value of this field is the null string in C, and 256 blank characters in other programming languages.

Parent topic: Fields for MQTM