x

1. From the ReportCaster Development and Administration Interface, select one or more schedules and then click the Log icon, or right-click the selected schedule(s) and select Log. You can also double-click a single schedule to open its log report.

   

   The ReportCaster Log Option dialog box opens with the Selected schedules check box checked.

   

   Note: You cannot uncheck the Selected schedules check box.

2. Select one of the following option buttons:
   • Last Executed. Produces a log report containing the most currently run process for the selected schedule(s). This is the default value.
   • All. Produces a log report containing all run processes for the selected schedule(s).
   • Date. Activates the Start date, Start time, End date, and End time fields.

   If you have selected the Date option, proceed to Step 3. Otherwise, proceed to Step 7.

3. In the Start date field, specify the date on which you want the log report to begin. The report will display all processes for the selected schedule(s) that were run on or after the specified Start date. You can either type the Start date directly in the field or select a Start date from the drop-down calendar. The current date is the default value for the Start date field.
4. In the Start time field, specify a start time for the Start date by entering it directly into the text box, or by using the arrows. The current time is the default value for the Start time field.
5. In the End date field, specify the date on which you want the log report to end. The report will display all processes for the selected schedule(s) that were run before the specified End date. You can either type the End date directly in the field or select an End date from the drop-down calendar. The current date is the default value for the End date field.
6. In the End time field, specify an end time for the End date by entering it directly into the text box, or by clicking the arrows. The current time is the default value for the End time field.
7. Click OK to run the log report.

x

1. From the ReportCaster - Log Management window, select a user (for example, chuck). A list of schedules for the selected owner appears.

   

2. To view a log report for selected schedules:

   Select one or more schedules (for example, Schedule ID Su1jlkjr3 and SU3scSc1f5) and then click the Open Log Report icon. You can also select the schedule(s) and click Open from the Action menu, or right-click the schedules and click Open from the drop-down list.

   Note: To select multiple schedules, use the Shift key and Control (Ctrl) key, as in a standard Windows interface.

   The ReportCaster Log Selection Options dialog box opens with the Selected schedules check box active and checked.

   

   Note: To switch from the item(s) you selected to viewing all schedules for that user, uncheck the Selected schedules check box.

   To view a log report for all schedules:

   Click the Open Log Report icon without selecting a schedule. The ReportCaster Log Selection Options dialog box opens with the Selected schedules check box inactive and unchecked.

   

3. Select one of the following option buttons:
   • Last Executed. Produces a log report containing the most currently run process for the selected schedule(s) or for all schedules (if you did not select a schedule). This is the default value.
   • All. Produces a log report containing all run processes for the selected schedule(s) or for all schedules (if you did not select a schedule).
   • Date. Activates the Start date, Start time, End date, and End time fields.

   If you have selected the Date option, proceed to step 4. Otherwise, proceed to step 8.

4. In the Start date field, specify the date on which you want the log report to begin. The report will display all processes for the selected schedule (or schedules) that were run on or after the specified Start date. You can either type the Start date directly in the field or select a Start date from the drop-down calendar. The current date is the default value for the Start date field.
5. In the Start time field, specify a start time for the Start date by entering it directly into the text box, or by using the arrows. The current time is the default value for the Start time field.
6. In the End date field, specify the date on which you want the log report to end. The report will display all processes for the selected schedule (or schedules) that were run before the specified End date. You can either type the End date directly in the field or select an End date from the drop-down calendar. The current date is the default value for the End date field.
7. In the End time field, specify an end time for the End date by entering it directly into the text box, or by clicking the arrows. The current time is the default value for the End time field.
8. Click OK to run the log report.

x

Values from &ECHO variables and -TYPE commands in WebFOCUS procedures appear in log reports. The &ECHO variable displays command lines as they execute in order to test and debug procedures. The -TYPE command enables you to comment and evaluate your code for informational and debugging purposes. For example, if the following procedure is scheduled using ReportCaster, it may produce a log report similar to the example that follows this procedure:

-SET &ECHO=ALL;
-TYPE Country Sales and Growth 
-TYPE Parameter RATE is passed into report to forecast potential sales growth
TABLE FILE CAR
HEADING
"Sales Growth Forecast using Rate: &RATE "
SUM SALES AS 'Sales' 
COMPUTE GROWTH/D12.2 = (SALES * &RATE) + SALES; AS 'Sales, Forecast' 
BY COUNTRY AS 'Country'
END

The following image shows an example of the log report.

Note: For more information about &ECHO variables, see Testing and Debugging a Dialogue Manager Procedure in the Developing Reporting Applications manual.

x

When viewing a log report, be aware of the following considerations.

Task and Report Names:

The ReportCaster Log references Managed Reporting folders and FEXes by their names and not their descriptions.

E-mail Addresses:

ReportCaster cannot validate e-mail addresses since the mail server performs e-mail validation. The log report will include any e-mail addresses validated by the mail server and returned to ReportCaster.

Burst Reports:

• If a valid burst value is omitted in a Distribution List, Distribution File, or Dynamic Distribution List, ReportCaster treats the blank value as if it is a valid burst value, and no entries indicating a blank burst value appear in the log file. This will significantly reduce the size of the log file, particularly when the database contains many values for the primary field and only a small subset of those values are burst.
• If a burst value is specified in a Distribution List, Distribution File, or Dynamic Distribution List and it is not found in the database, the following message appears in the log file:

  Burst Value: value is not in the database.

• When a report is successfully burst, the log file will include the following message for each burst value:

  FILE filename SUCCESSFULLY DISTRIBUTED TO destination FOR burst value.

Unavailable Options:

When schedules with unavailable Task Types and/or distribution methods are not permitted to run, error notification is triggered and information is included in full and brief notifications and in the log report that your ReportCaster administrator or the owner of the schedule must change the unavailable Task Types and/or distribution methods in the schedule.

When schedules with unavailable Task Types and/or distribution methods are permitted to run, normal job execution occurs and a message appears in the log report indicating that your ReportCaster administrator is enabling existing schedules using the unavailable Task Types and/or distribution methods to run.