Applying service to an integration node that starts under the control of a WebSphere MQ queue manager

If an integration node starts under the control of a WebSphere® MQ queue manager, you must manually update the MQ Service definition on the queue manager that is associated with the integration node so that the integration node uses the new code.

Before you begin

To check that your integration node is configured to start as a WebSphere MQ service, run the mqsireportbroker command. If Start as WebSphere MQ Service is set to defined, your integration node is configured to start as a WebSphere MQ service.

Procedure

To update the MQ Service definition on the queue manager, complete the following steps:

  1. At a command prompt, type runmqsc qmgr where qmgr is the name of the queue manager that is associated with the integration node.
  2. To display the current settings for the integration node type display service('serviceName'), where serviceName is the name of your WebSphere MQ service.

    The output details the current settings, for example, if your integration node is running the IBM® Integration Bus Version 10.0.0.0 code, you might see the following output:

    AMQ8629: Display service information details. 
    SERVICE(MQSI_integrationNodeName) CONTROL(QMGR) SERVTYPE(COMMAND) 
    STARTCMD(C:\PROGRA~1\IBM\IIB\1000~1.0\server\bin\runMQService.bat) 
    STARTARG(C:\PROGRA~1\IBM\IIB\1000~1.0\server\bin integrationNodeName) 
    STOPCMD(C:\PROGRA~1\IBM\IIB\1000~1.0\server\bin\endMQService.bat) 
    STOPARG(C:\PROGRA~1\IBM\IIB\1000~1.0\server\bin integrationNodeName) 
    STDOUT(C:\PROGRA~3\IBM\MQSI\common\log\integrationNodeName.mqservice.log) 
    STDERR(C:\PROGRA~3\IBM\MQSI\common\log\integrationNodeName.mqservice.log) 
    DESCR( ) ALTDATE(2015-05-26) ALTTIME(16.13.39)
  3. Provide new fully qualified values for the following parameters: STARTCMD, STARTARG, STOPCMD, and STOPARG, but preserve the existing command names.
    For example, you might type the following command (on a single line) at the runmsc command prompt to change the integration node to use the IBM Integration Bus Version 10.0.0.1 code:
    Note: You must use short names if you are on Windows.
    alter service('MQSI_integrationNodeName') 
    startcmd('C:\PROGRA~1\IBM\IIB\1000~1.1\server\bin\runMQService.bat') 
    startarg('C:\PROGRA~1\IBM\IIB\1000~1.1\server\bin integrationNodeName') 
    stopcmd('C:\PROGRA~1\IBM\IIB\1000~1.1\server\bin\endMQService.bat') 
    stoparg('C:\PROGRA~1\IBM\IIB\1000~1.1\server\bin integrationNodeName')
    where C:\PROGRA~1\IBM\IIB\1000~1.1 is the short name for C:\Program Files\IBM\IIB\10.0.0.1
    The message AMQ8624: WebSphere MQ service changed. is displayed if the MQ service definition is updated.