Upgrading WebSphere MQ Workflow to use XML APIs

To upgrade to WebSphere MQ Workflow to make use of the XML APIs (for more information on XML APIs, see XML API verb processing): you must perform the following tasks:

  1. Install WebSphere MQ Workflow 3.3.2.
  2. Create collaborations to support verbs Delete and Restart as well as Suspend, Terminate, and Resume. The XML APIs support use of all of these verbs.
  3. Add connector-specific property JavaCorbaApi and set its value to false.
  4. Add the following attributes to the MO_MQWorkflow_ProcessInstance business object:

    Table 3.

    Connector-specific configuration properties
    Name Type Application-specific information
    ProcTemplValidFromDate String
    ProcTemplValidFromDate;
    type=pcdata;
    
    ProcInstSuspensionTime String
    ProcInstSuspensionTime;
    type=pcdata;
    
    ProcInstSuspension
    ExpirationsTime
    String
    ProcInstSuspension
    ExpirationsTime;
    type=pcdata;
    
    ExternalProcessContext String
    ExternalProcessContext;
    type=pcdata
    


    Note: If you are using flow
    monitoring with the
    InterChange server,
    leave this attribute
    undefined (see 7. below).

    Or:

    repos_copy WebSphereMQWorkflow_MetaObjects.jar from the repository and repos_copy Sample_MQWF_Order_Connectors.jar from the samples folder.

  5. To process Suspend and Resume verbs, add the following application-specific information to MO_MQWorkflow_ProcessInstance:
    Suspend      deep=true;
    

    Resume       deep=true;
    

    When deep=true, all non-autonomous subprocesses are also suspended or resumed; when deep=false, these same subprocesses are ignored. The default for deep is false.

  6. To control or monitor the status of a workflow process, use the ProcInstName (instead of ProcInstID) of the MQ_MQWorkflow_ProcessInstance object.
  7. When ExternalProcessContext is left undefined in the object, the InterChange server passes flow monitoring information to the adapter through the ObjectEvent ID.

Copyright IBM Corp. 1997, 2004