Reference: |
The WebFOCUS Administration Console is used to invoke the ReportCaster API to configure ReportCaster, create the ReportCaster repository, restart the Distribution Server, configure ReportCaster environment parameters, and turn ReportCaster traces on and off. The WebFOCUS Administration Console authenticates to ReportCaster with the value of the user ID IBIMR_RC_SVCUSER. If authentication fails, users are prompted for their credentials.
ReportCaster functionality is grouped into the Repository, Configuration, Utilities, and Traces categories in the ReportCaster menu of the WebFOCUS Administration Console and is described in the following topics.
The WebFOCUS Administration Console settings available in the Repository area of the ReportCaster menu are described in this topic. For more information, see the ReportCaster Development and Administration manual.
Selecting Connection in the Repository area of the ReportCaster menu provides access to a panel with the following settings:
Selecting Test Repository in the Repository area of the ReportCaster menu provides access to a panel with the following information:
Selecting Create All Tables in the Repository area of the ReportCaster menu generates a confirmation dialog box.
Note: Before creating all tables, make sure you have defined the Repository connection settings in the Connection area and tested the connection in the Test Repository area.
Selecting Drop/Create All Tables in the Repository area of the ReportCaster menu generates a confirmation dialog box.
Note: Before dropping and creating all tables, make sure you have defined the Repository connection settings in the Connection area and tested the connection in the Test Repository area.
The WebFOCUS Administration Console settings available in the Configuration area of the ReportCaster menu are described in this topic. For more information, see the ReportCaster Server Configuration chapter in the ReportCaster Development and Administration manual.
The following settings are accessed by selecting Configuration in the ReportCaster menu.
Never - This is the default value. ReportCaster does not send notification of the schedule status under any circumstance.
Always - The specified user is always notified when the schedule runs.
On Error - The specified users are notified when errors are encountered while running the schedule. We recommend using the On Error notification option.
You can also specify a port for the Mail Host using hostname[:port]. If you do not specify a port or the port you specify is not present, the default port is used.
You can also specify a port for the Notify Mail Host using hostname[:port]. If you do not specify a port or the port you specify is not present, the default port is used.
Tip: We recommend using different mail servers for notification and e-mail distribution in case there is a problem with the default mail server (notification e-mails are still sent). Having separate mail servers ensures you are informed if the default mail server falters.
In the WFTransInOut field, type the fully qualified name of the package and class that implements the WFTransInOut interface.
To configure the exit jar file and classpath:
Note: For more information about WFTRANSINOUT, see Developing Your Own WebFOCUS Plug-in.
ON - During startup, the ReportCaster Distribution Server recovers scheduled jobs that were processed but not completed.
OFF - This is the default value. During startup, the ReportCaster Distribution Server does not recover any scheduled jobs.
The Scan Back value is an integer value that represents the number of 24 hour periods, beginning when the Distribution Server is restarted, that the Distribution Server scans back to look for, and run, jobs that have not yet run. The maximum integer value for Scan Back is 365. The default value is 15 (periods of 24 hours).
ON - This is the default value. Turns on Scan Back functionality. The Distribution Server searches for all jobs with a next run time that is less than the current time, runs only those jobs found within the time period set in the Scan Back setting, and resets the next run time of all of the jobs initially found.
OFF - Turns off Scan Back functionality, which results in the Distribution Server following its default behavior to locate, run, and reset all jobs with a next run time that is less than the current time.
RESET_NEXTRUNTIME - Searches for all jobs with a next run time less than the current time and resets the next run time to the next scheduled run time of the job. A Scan Back value of zero defaults to this Scan Back Type.
The WebFOCUS Administration Console settings available in the Utilities area of the ReportCaster menu are described in this topic. For more information, see the ReportCaster Development and Administration manual.
Selecting ReportCaster Status in the Utilities area of the ReportCaster menu provides access to a panel with the following information:
Not Started - Distribution Server has not been started.
Started in Console Mode - Distribution Server requires additional configuration.
Full Function Mode - Distribution Server is up and ready for use.
Selecting Restart ReportCaster in the Utilities area of the ReportCaster menu provides access to a panel with the following information:
Administrators can configure the type of ReportCaster user interface and scheduling tool interface that displays for all users.
The WebFOCUS Administration Console settings available in the Traces area of the ReportCaster menu are described in this topic. For more information, see the ReportCaster Tracing chapter in the ReportCaster Development and Administration manual.
The following settings are accessed by selecting Traces in the ReportCaster menu.
ON - Enables tracing for all servlets executed by ReportCaster, including the ReportCaster API. Servlet tracing provides information about queries to, and maintenance of, the ReportCaster Repository. This includes events that occur during the scheduling of a job.
OFF - This is the default value. Disables servlet tracing and ignores the Servlet Trace File value.
OFF - This is the default value. Disables schedule tracing. When set to OFF, the files and folders in the ReportCaster Distribution Server /temp directory, and the Schedule trace files J*.* in the /trc directory, are deleted when the ReportCaster Distribution Server is started up. Therefore, if you want to keep any of these files you must either back them up or make sure that Schedule Trace is set to either SCHEDULE or SCHEDULE_REPORT.
SCHEDULE - Enables schedule tracing.
SCHEDULE_REPORT - Enables schedule tracing and report tracing.
When Schedule Trace is set to SCHEDULE or SCHEDULE_REPORT, ReportCaster produces trace files containing ReportCaster Distribution Server information related to the specific jobs being run. Each job creates the following trace files in the /ibi/WebFOCUS/ReportCaster/trc/ directory, each with a unique Job Process ID (Jobid):
Additionally, when schedule tracing is enabled, the following core ReportCaster Distribution Server trace files are created in the /ibi/WebFOCUS/ReportCaster/trc/ directory. When a new instance of the ReportCaster Distribution Server starts, these trace files replace the previous trace files:
WebFOCUS |