Enabling tracing in the file transfer step of an Antz build

If you have problems with the file agent step in your Antz build, you can enable tracing to help debug your problems.
Complete the following steps to enable tracing:
  1. Create a log4j.properties on your computer. For example:
    log4j.rootLogger=DEBUG, stdout
    log4j.appender.stdout=org.apache.log4j.ConsoleAppender
    log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
    log4j.appender.stdout.layout.ConversionPattern=%-4r %-5p [%t] %c %3x - %m%n
    Note: If log4j.rootLogger=DEBUG generates too many messages, change the content of the log4j.properties file to:
    log4j.rootLogger=INFO, stdout
    log4j.appender.stdout=org.apache.log4j.ConsoleAppender
    log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
    log4j.appender.stdout.layout.ConversionPattern=%-4r %-5p [%t] %c %3x - %m%n
    log4j.logger.com.ibm.teamz.fileagent=DEBUG
    (To limit the number of messages, comment out the last line.)
  2. Upload the log4j.properties file that was created in the previous step to the z/OS® USS directory.
  3. Edit startbfa.sh and specify the location of this log4j.properties file. This is done by setting the system property log4j.configuration. In the following example the configuration file is fully specified by the URL: file:/u/user1/log4j.properties.
    FA_JAVA_OPTIONS="-Djava.ext.dirs=${JAVA_HOME}/lib/ext"
    FA_JAVA_OPTIONS="${FA_JAVA_OPTIONS}:${BLD_TOOLKIT}"
    FA_JAVA_OPTIONS="${FA_JAVA_OPTIONS} -Dlog4j.configuration=file:/u/user1/log4j.properties"  
  4. Restart the Rational® Build Agent using the modified startbfa.sh and request your Antz build. You will see additional tracing in the build log file.
    Note: With tracing enabled, you will see error lines from com.ibm.team.repository.common.util.ExtensionRegistryReader on the component elements with ID attributes that are not unique. An example of such an error is shown below. You can ignore those messages.
    9467 ERROR [main] com.ibm.team.repository.common.util.ExtensionRegistryReader 
    - The com.ibm.team.repository.common bundle's plugin.xml file contains a <component>element 
    with the id attribute value com.ibm.team.repository that is not unique.

Feedback