Enabling API logging for Developer Studio


You can enable client-side logging to resolve issues in Developer Studio. Developer Studio uses Java API when connecting to AR System server.

To enable client-side API logging

  1. Close Developer Studio.
  2. Find the arsys_sample.xml in ...\DeveloperStudio\plugins\com.bmc.arsys.studio.api_<versionstring>.
    See the following table to know about the version and location:

    Version

    Location

    8.1, 8.1.01, and 8.1.02

    ...\DeveloperStudio\plugins\com.bmc.arsys.studio.api_8.1.0.build001

    9.0

    ...\DeveloperStudio\plugins\com.bmc.arsys.studio.api_9.0.0.build001

    9.1

    ...\DeveloperStudio\plugins\com.bmc.arsys.studio.api_9.1.0.build001

    9.1.02

    ...\DeveloperStudio\plugins\com.bmc.arsys.studio.api_9.1.2.build001

    9.1.03

    ...\DeveloperStudio\plugins\com.bmc.arsys.studio.api_9.1.3.build002

    9.1.04

    ...\DeveloperStudio\plugins\com.bmc.arsys.studio.api_9.1.4.build003

    9.1.05 (18.05)

    ...\DeveloperStudio\plugins\com.bmc.arsys.studio.api_9.1.5.build004

    9.1.06 (18.08)

    ...\DeveloperStudio\plugins\com.bmc.arsys.studio.api_9.1.6.build005

  3. Copy the arsys_sample.xml file and arsys_api.xml in the same folder.
  4. Open the arsys_api.xml file, find the <javaapi_config> </javaapi_config> section and make sure that it is uncommented.
  5. Enable API logging by adding or modifying the <apiRecording>0</apiRecording> text to <apiRecording>31</apiRecording>.
    For example:

    Before
    .......
    ...etc...
       <timeLagBetweenRetriesMillSec>100</timeLagBetweenRetriesMillSec>
       <toStringStyle>com.bmc.arsys.api.NoPrefixToStringStyle.NO_PREFIX_STYLE</toStringStyle>
       <stringizeFieldAssignments>false</stringizeFieldAssignments>
       <stringizeSetIfQualification>false</stringizeSetIfQualification>
       <apiRecording>0</apiRecording>
       <jniLoadMode>1</jniLoadMode>
    ...etc...
    .......
    After
    .......
    ...etc...
       <timeLagBetweenRetriesMillSec>100</timeLagBetweenRetriesMillSec>
       <toStringStyle>com.bmc.arsys.api.NoPrefixToStringStyle.NO_PREFIX_STYLE</toStringStyle>
       <stringizeFieldAssignments>false</stringizeFieldAssignments>
       <stringizeSetIfQualification>false</stringizeSetIfQualification>
       <apiRecording>31</apiRecording>
       <jniLoadMode>1</jniLoadMode>
    ...etc...
    .......
  6. Save the arsys_api.xml file.
  7. Restart Developer Studio and then reproduce the problem.
  8. Provide the time when you reproduce the error in the BMC support case that you create so that it can be found in the logs.
  9. Forward the API log file named <username><ARServer name>*_arapires.log from the ...\DeveloperStudio folder to BMC Support.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*