Displaying Log Information Using the DSTLOG Servlet

In this section:

The DSTLOG servlet displays information about the events that occurred during the execution and distribution of a report. It enables you to confirm that a report job ran as scheduled and was distributed successfully. If it did not run or was not distributed successfully, the log information states the reason why.

DSTLOG extracts information from the WebFOCUS repository tables and displays it in your browser in HTML format. You can select specific information for display by supplying any combination of job description, schedule ID, last job execution, and date/time.

If you do not supply any selection criteria, all log information is retrieved and displayed.

Note: You can only view log reports for schedules created with the ReportCaster API when using the DSTLOG servlet. Otherwise, the following message appears:

No Log information exists for this request.

Top of page

Example: Specifying a Relative Address Using DSTLOG
<FORM ACTION="/context_root/servlet/DSTLOG">

where:

context_root

Is the configurable context root for the ReportCaster web application in your Application Server configuration. By default, this is /ibi_apps.


Top of page

x
DSTLOG Parameters

In this section:

The following parameters may be used in an HTML calling form to generate the query string passed to the DSTLOG servlet.



x
IBIB_enddate Parameter

Description

Ending date for collection of log information, in the format YYYYMMDD, where YYYY is the 4-digit year, MM is the month, and DD is the day of the month.

If you supply a value, log information up to that date is displayed.

Required?

No

Size in bytes

8

Valid Values

A date specified as YYYYMMDD.

Default

None



x
IBIB_endtime Parameter

Description

Ending time for collection of log information, in the format HHMM, where HH is the hour and MM is the minute.

If you supply a value, log information up to that time is displayed.

Required?

No

Size in bytes

4

Valid Values

A time specified as HHMM.

Default

2300



x
IBIB_jobdesc Parameter

Description

Unique, user-supplied description for a scheduled job.

If you supply a value, log information for every execution of that job is displayed.

Required?

No

Size in bytes

90

Valid Values

Existing description used for the schedule created by the ReportCaster API.

Default

None



x
IBIB_lastexec Parameter

Description

Flag that controls which job executions will display. This parameter applies to jobs that were executed more than once.

Required?

No

Size in bytes

1

Valid Values

Y = Display last execution of specified job. N = Display all instances that meet other specified criteria.

Default

None



x
IBIB_scheduleid Parameter

Description

Unique, API-generated key that identifies a scheduled job.

If you supply a value, log information for that schedule ID is displayed.

Required?

No

Size in bytes

12

Valid Values

Existing schedule ID generated by the ReportCaster API.

Default

None



x
IBIB_startdate Parameter

Description

Starting date for collection of log information, in the format YYYYMMDD, where YYYY is the 4-digit year, MM is the month, and DD is the day of the month.

If you supply a value, log information starting on that date is displayed.

Required?

No

Size in bytes

8

Valid Values

A date specified as YYYYMMDD.

Default

None



x
IBIB_starttime Parameter

Description

Starting time for collection of log information, in the format HHMM, where HH is the hour and MM is the minute.

If you supply a value, log information starting at that time is displayed.

Required?

No

Size in bytes

4

Valid Values

A time specified as HHMM.

Default

0000



x
IBIB_tcpiplevel Parameter

Description

Method ReportCaster uses for securing sockets from TCP/IP, based on a specific SAS/C library.

Required?

Yes, if the WebFOCUS Reporting Server runs on OS/390.

Size in bytes

1

Valid Values

1 = Resolves special connectivity problems. 0 = Specifies no special connectivity problems.

Default

0



Example: Reading a Log Report

The Job Process Log Report displays information according to your specifications in a separate browser window. One log record is produced for each scheduled job run in the specified time frame.

The following image shows a typical Job Process Log Report.

Job Process Log Report

A Job Process Log Report includes the following information:


WebFOCUS