Triggering channels
An overview of triggering is given in Triggering channels, while it is described in depth in the WebSphere MQ Application Programming Guide. This section provides you with information specific to WebSphere MQ for iSeries.
Triggering in WebSphere MQ for iSeries is implemented with the channel initiator process, which is started with the STRMQMCHLI command that specifies the name of the initiation queue. For example:
STRMQMCHLI QNAME(MYINITQ)You need to set up the transmission queue for the channel specifying TRIGGER and specifying the channel name in the TRIGDATA field: For example:
CRTMQMQ QNAME(MYXMITQ) QTYPE(*LCL) MQMNAME(MYQMGR) + PRCNAME(MYPROCESS) TRGENBL(*YES) INITQNAME(MYINITQ) + USAGE(*TMQ)Then define an initiation queue.
CRTMQMQ QNAME(MYINITQ) MQMNAME(MYQMGR)Next you define a process in WebSphere MQ for iSeries naming the MCA sender program, as the program to be triggered when messages arrive on the transmission queue. Type CRTMQMPRC on the command line to display the Create Process panel. Alternatively, select F6 (Create) from the Work with MQM Process panel. See Figure 115 for the first page of the Create Process panel. The WebSphere MQ for iSeries System Administration contains details of defining processes to be triggered.
Figure 115. Create process (1)
+--------------------------------------------------------------------------------+ | Create MQM Process (CRTMQMPRC) | | | | Type choices, press Enter. | | | | Process Name . . . . . . . . . . _______________________________________ | | | | Message Queue Manager name . . . *DFT___________________________________ | | | | Replace . . . . . . . . . . . . *NO *NO, *YES | | Text 'description' . . . . . . . > 'Triggers hursley.to.hursley.normal ' | | Application type . . . . . . . . *OS400 | | Application identifier . . . . . > 'AMQRMCLA | | | | | | | | | | | | | | User data . . . . . . . . . . . > *SYSDFTPRC | | | | | | | | More... | | F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display | | F24=More keys | | | +--------------------------------------------------------------------------------+
- Type the name of the process definition in the field provided.
- Enter a description in the Text 'description' field.
- Set Application type to *OS400.
- Set Application identifier to AMQRMCLA.
- Set User data to the channel name so as to associate this definition with the transmission queue belonging to the channel.
- Page down to show the second page (see Figure 116) and insert any environment data.
Figure 116. Create process (2)
+--------------------------------------------------------------------------------+ | Create MQM Process (CRTMQMPRC) | | | | Type choices, press Enter. | | | | Environment data . . . . . . . . *SYSDFTPRC___________________________ | | ________________________________________________________________________ | | ______________ | | | | | | | | | | | | | | | | | | | | | | | | | | | | Bottom | | F3=Exit F4=Prompt F5=Refresh F12=Cancel F13=How to use this display | | F24=More keys | | | +--------------------------------------------------------------------------------+WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.
IBM is a trademark of the IBM Corporation in the United States, other countries, or both.