Schedule and Report Tracing

In this section:

The Distribution Server schedule tracing is enabled by setting Schedule Trace to SCHEDULE (or to SCHEDULE & REPORT if you also want to enable report tracing) in the General tab of the Console Configuration tab.

ReportCaster also provides the ability to enable SCHEDULE or SCHEDULE & REPORT tracing on a per schedule basis when dynamically running the schedule on demand. When you run a schedule, the Schedule Trace setting specified in the ReportCaster Configuration tool appears along with options that enable you to change the setting for this particular schedule.


Top of page

x
Trace Files Related to Specific Jobs

When the Schedule Trace parameter is set to SCHEDULE, ReportCaster produces trace files containing ReportCaster Distribution Server information related to the specific job or jobs being run. Each job creates the following trace files in the /ibi/WebFOCUS80/ReportCaster/trc/ directory, each with a unique Job Process ID (Jobid):

Note: You can identify the Job Process ID of the target job by running a log report. For more information about log reports, see Tracking Schedules or Job Logs. A Job Process ID begins with a J and is followed by a series of random digits and lowercase letters.


Top of page

x
Distribution Server Startup Trace Files

Reference:

When you enable schedule tracing, the following core Distribution Server trace files are created in the /ibi/WebFOCUS80/ReportCaster/trc/ directory. When a new instance of the Distribution Server starts, these trace files replace the previous trace files:

Note: If the Distribution Server is started as a service, a service.log file is created containing initialization information about the service.



Example: Using the Schedule Trace File

The following excerpt of a schedule trace file is for job ID reportcaster.log_2011-12-20.log. The reportcaster.log_2011-12-20.log file shows the date and time that the worker thread began, the parameters associated with the scheduled job, and the connection information for the Repository.



x
Reference: Job Procedure (FEX) File

The following Schedule trace file shows the procedure associated with the Job Procedure (FEX) file:


Top of page

x
Trace Error Files

When ReportCaster encounters an unexpected error or abend, the following trace error files are created:


Top of page

x
Schedule Trace File Clean Up

When the Schedule Trace setting is turned OFF, the files and folders in the Distribution Server /temp directory, and the Schedule trace files J*.* in the /trc directory, are deleted when you start the Distribution Server. Therefore, if you want to keep any of these files you must either back them up or make sure that schedule tracing is enabled (meaning that Schedule Trace is set to either SCHEDULE or SCHEDULE & REPORT in the ReportCaster Server Configuration tool).


Top of page

x
Resource Analyzer Support

ReportCaster supports Resource Analyzer. When ReportCaster runs Server Procedures or a WebFOCUS Report (Managed Reporting), it sends commands to the Reporting Server. Resource Analyzer then retrieves these commands for the purpose of monitoring the resources used to create the output to be distributed by ReportCaster. If you are not using Resource Analyzer, the commands are ignored by the Reporting Server.

You can view these commands in the Schedule Trace file for the specific job (provided that Schedule tracing is enabled in ReportCaster). For more information about the commands catalogued by Resource Analyzer, see the Resource Analyzer Administrator's and User's Manual.


WebFOCUS