Setting the Status of a Job Using the DSTACTIVE Servlet

In this section:

Reference:

The DSTACTIVE servlet is a direct HTML call that sets the status of a job. With this servlet, you can set the status of:

When you set a status, the IBIB_active flag in the BOTSCHED table changes to reflect that status.


Top of page

x
Reference: DSTACTIVE Requirements

If there are multiple schedules for a report request (job), you must supply the parameter IBIB_scheduleid. A ReportCaster Administrator can determine a schedule ID for a job by running the report from the ReportCaster Console. Both administrators and users can determine a schedule ID from the Log File icon on the ReportCaster toolbar.

If there is one schedule for a job, supply either IBIB_scheduleid or IBIB_jobdesc.



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

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
DSTACTIVE Parameters

In this section:

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



x
IBIB_active Parameter

Description

Flag that reflects the status of a job.

Required?

Yes

Size in bytes

1

Valid Values

Y = Job is active and runs at next scheduled interval. N = Job is inactive and will not run at next scheduled interval.

Default

Y



x
IBIB_jobdesc Parameter

Description

Unique, user-supplied description that identifies a job that was scheduled for execution and distribution.

Required?

Yes, if you scheduled a job to run once and IBIB_scheduleid is not supplied.

Size in bytes

90

Valid Values

  • Entering ALL updates the status of all jobs in BOTSCHED (requires ReportCaster Administrator user ID).

    or

  • An existing description used for the schedule created by the ReportCaster API.

Default

None



x
IBIB_scheduleid Parameter

Description

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

Required?

Yes, if there are multiple schedules for a job. If you scheduled a job to run once, either this parameter or IBIB_jobdesc is required.

Size in bytes

12

Valid Values

  • Entering ALL updates the status of all jobs in BOTSCHED (requires a ReportCaster Administrator user ID).

    or

  • An existing schedule ID generated by the ReportCaster API.

Default

None



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


WebFOCUS