IBM Support

IT35407: INCORRECT ANT EXAMPLE IN DOCS FOR MQSIPACKAGEBAR

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as documentation error.

Error description

  • In Knowledge Center Topic bc31720_ the following example is
    given for running mqsipackagebar from an ant script:
    
    <target
    name="run_mqsipackagebar" description="--> runs mqsipackagebar
    from an ant task">
     <java
    classname="com.ibm.broker.config.appdev.FlowRendererBAR"
    
    failonerror="true"
     fork="true">
     <arg line="-a MyBAR.bar"/>
    
    <arg line="-k MyApplication"/>
     <classpath>
     <fileset
    dir="${MQSI_JARPATH}">
     <include name="*.jar"/>
     </fileset>
    
    </classpath>
     </java>
    </target>
    
    Running this produces an error
    because the dir property of the fileset element must contain
    exactly one path but MQSI_JARPATH is a list of paths. Instead
    something like the following should be
    used:
    
    <classpath>
    &#09;<fileset
    dir="${env.MQSI_BASE_FILEPATH}/common/classes"
    includes="IntegrationAPI.jar" />
    &#09;<fileset
    dir="${env.MQSI_BASE_FILEPATH}/server/classes"
    includes="javacompute.jar,jplugin2.jar" />
    </classpath>
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    All users of IBM Integration Bus version 10 and App Connect
    Enterprise version 11 using mqsipackagebar called from an ant
    script.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    <span style="background-color:rgb(255, 255, 255)">     In
    Knowledge Center Topic bc31720_ the following incorrect example
    is given for runningmqsipackagebar from an ant script:
                                                           </span>
    <span style="background-color:rgb(255, 255, 255)"><target
                                                           </span>
    <span style="background-color:rgb(255, 255,
    255)">name="run_mqsipackagebar" description="--> runs
    mqsipackagebar </span>
    <span style="background-color:rgb(255, 255, 255)">from an ant
    task">                                             </span>
    <span style="background-color:rgb(255, 255, 255)"><java
                                                            </span>
    <span style="background-color:rgb(255, 255,
    255)">classname="com.ibm.broker.config.appdev.FlowRendererBAR"
         </span>
    <span style="background-color:rgb(255, 255, 255)">
    
    </span>
    <span style="background-color:rgb(255, 255,
    255)">failonerror="true"
         </span>
    <span style="background-color:rgb(255, 255, 255)">fork="true">
                                                     </span>
    <span style="background-color:rgb(255, 255, 255)"><arg line="-a
    MyBAR.bar"/>                                    </span>
    <span style="background-color:rgb(255, 255, 255)">
    
    </span>
    <span style="background-color:rgb(255, 255, 255)"><arg line="-k
    MyApplication"/>                                 </span>
    <span style="background-color:rgb(255, 255, 255)"><classpath>
                                                      </span>
    <span style="background-color:rgb(255, 255, 255)"><fileset
                                                         </span>
    <span style="background-color:rgb(255, 255,
    255)">dir="${MQSI_JARPATH}">
         </span>
    <span style="background-color:rgb(255, 255, 255)"><include
    name="*.jar"/>                                       </span>
    <span style="background-color:rgb(255, 255, 255)"></fileset>
                                                       </span>
    <span style="background-color:rgb(255, 255, 255)">
    
    </span>
    <span style="background-color:rgb(255, 255, 255)"></classpath>
                                                      </span>
    <span style="background-color:rgb(255, 255, 255)"></java>
                                                          </span>
    <span style="background-color:rgb(255, 255, 255)"></target>
                                                         </span>
    <span style="background-color:rgb(255, 255, 255)">
    
    </span>
    <span style="background-color:rgb(255, 255, 255)">Running this
    produces an error because the dir property of the fileset
    element
    must contain exactly one path but MQSI_JARPATH is a list of
    paths.
    
    Instead something like the following should be used:</span>
    <span style="background-color:rgb(255, 255, 255)">
    
    </span><span style="background-color:rgb(255, 255, 255)">
    
    </span>
    <span style="background-color:rgb(255, 255, 255)"><classpath>
                                                       </span>
    <span style="background-color:rgb(255, 255, 255)"><fileset
                                                         </span>
    <span style="background-color:rgb(255, 255,
    255)">dir="${env.MQSI_BASE_FILEPATH}/common/classes"
         </span>
    <span style="background-color:rgb(255, 255,
    255)">includes="IntegrationAPI.jar" />
                                  </span>
    <span style="background-color:rgb(255, 255, 255)"><fileset
                                                         </span>
    <span style="background-color:rgb(255, 255,
    255)">dir="${env.MQSI_BASE_FILEPATH}/server/classes"
         </span>
    <span style="background-color:rgb(255, 255,
    255)">includes="javacompute.jar,jplugin2.jar" />
                        </span>
    <span style="background-color:rgb(255, 255, 255)"></classpath>
                                                      </span>
    

Problem conclusion

  • <span style="background-color:rgb(255, 255, 255)">Knowledge
    Center Topic bc31720_ has been updated to include the correct
    example of running mqsipackagebar in an ant script:</span>
    
    <span style="background-color:rgb(255, 255, 255)"><classpath>
                                                       </span>
    <span style="background-color:rgb(255, 255, 255)"><fileset
                                                         </span>
    <span style="background-color:rgb(255, 255,
    255)">dir="${env.MQSI_BASE_FILEPATH}/common/classes"
         </span>
    <span style="background-color:rgb(255, 255,
    255)">includes="IntegrationAPI.jar" />
                                  </span>
    <span style="background-color:rgb(255, 255, 255)"><fileset
                                                         </span>
    <span style="background-color:rgb(255, 255,
    255)">dir="${env.MQSI_BASE_FILEPATH}/server/classes"
         </span>
    <span style="background-color:rgb(255, 255,
    255)">includes="javacompute.jar,jplugin2.jar" />
                        </span>
    <span style="background-color:rgb(255, 255, 255)"></classpath>
                          </span>
    

Temporary fix

Comments

APAR Information

  • APAR number

    IT35407

  • Reported component name

    INTEGRATION BUS

  • Reported component ID

    5724J0540

  • Reported release

    A00

  • Status

    CLOSED DOC

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-01-05

  • Closed date

    2021-04-09

  • Last modified date

    2021-04-14

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels

[{"Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSNQK6","label":"IBM Integration Bus"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"10.0"}]

Document Information

Modified date:
15 April 2021