EnvData (MQCHAR128)

This is a character string that contains environment-related information pertaining to the application to be started. This information is for use by a trigger-monitor application that processes messages on the initiation queue; the information is sent to the initiation queue as part of the trigger message.

The meaning of EnvData is determined by the trigger-monitor application. The trigger monitor provided by IBM MQ appends EnvData to the parameter list passed to the started application. The parameter list consists of the MQTMC2 structure, followed by one blank, followed by EnvData with trailing blanks removed. The following notes apply to the environments indicated:

  • On z/OS :

    • EnvData is not used by the trigger-monitor applications provided by IBM MQ.
    • If ApplType is MQAT_WLM, we can supply default values in EnvData for the ServiceName and ServiceStep fields in the work information header (MQWIH).

  • On UNIX, EnvData can be set to the & character to run the started application in the background.

The character string cannot contain any nulls. It is padded to the right with blanks if necessary.

To determine the value of this attribute, use the MQCA_ENV_DATA selector with the MQINQ call. The length of this attribute is given by MQ_PROCESS_ENV_DATA_LENGTH.