ReportCaster Configuration

Primary Distribution Server section

Host

Required.

Host name of the primary Distribution Server.

Port

Required.

Port number of the primary Distribution Server.

Secondary Distribution Server

Displays the host name and port number of the secondary failover server. Select the icon to the right of the Secondary Distribution Server field to access the following settings.

Enabled

Required for Failover.

Default is not enabled.

Enables or disables the Distribution Server failover function.

Host

Required if Failover is enabled.

Host name of the failover Distribution Server.

Port

Required if Failover is enabled.

Port number to access the failover Distribution Server.

Failover Interval

Required if Failover is enabled.

Default value is 1.

Frequency (in minutes) at which the failover Distribution Server checks the primary Distribution Server to verify it is running.

Default is not selected.

Selected. The Primary and Secondary servers monitor the status of each other by reading and updating a server status record in the WebFOCUS repository.

Not Selected. The Primary and Secondary servers communicate to each other through the network. If network communication between the servers is disrupted, the Secondary server may promote itself to Full Function status if does not receive a response from the Primary server even if the Primary server is in Full Function mode.

Workload Distribution

Displays whether Workload Distribution is in effect. Select the icon to the right of the Workload Distribution field to access the following failover settings.

Add

Required to add new entry.

Enables you to add another server for Workload Distribution.

Delete

Optional.

Enables you to delete a Workload Distribution Server.

Enabled

Required for Workload Distribution.

Default is not enabled.

Enables or disables the distribution of ReportCaster jobs among Distribution Servers.

Worker Name

Required if Workload Distribution is enabled.

Name to identify the worker Distribution Server.

Worker Distribution Server Host

Required if Workload Distribution is enabled.

Host name of the worker Distribution Server.

Worker Distribution Server Port

Required if Workload Distribution is enabled.

The default value is 8200.

Port number of the worker Distribution Server.

Restrict to IP Address

Optional.

Restricts Distribution Server Console access to one or more IP Addresses. For more information, see Restricting Distribution Server Console Access to an IP Address List.

Maximum Threads

Controls how many simultaneous connections (threads) the ReportCaster Distribution Server can utilize to process scheduled jobs. The default value is 3. This setting is also available in the Administration Console.

Server Name

Required if one or more servers are listed.

Displays the name of the server.

Threads (Connections)

Required. The Default Value is 3.

Displays the simultaneous connections (threads) for each server.

Other Task

Non server-based tasks.

Reader Interval, Recovery, Processing for No Report to Distribute, Processing for Blackout Period Job Termination, and Max Messages per Task from Data Server options:

Reader Interval

Required.

Default value is 1 minute.

Polling interval (in minutes) for the ReportCaster Distribution Server to check for scheduled jobs.

An acceptable value is any positive integer from 1 to 999999. Negative numbers and zero are not allowed.

Note: This setting is also available in the Administration Console.

Recovery

Default value is Off.

On. During startup, the ReportCaster Distribution Server recovers scheduled jobs that were processed but not completed.

Off (Default). During startup, the ReportCaster Distribution Server does not recover any scheduled jobs.

Note: This setting is also available in the Administration Console.

Processing for No Report to Distribute

Required.

Default value is Error.

Specifies whether the No Report to Distribute message from the Reporting Server is categorized as an error or a warning. This is a global setting, relevant to all schedules. Possible values are:

• Error. The No Report to Distribute message is categorized as an error and the message is written to the ReportCaster log report in red. When the schedule has the Notification option set to Error, the Notification is sent.
• Warning. The No Report to Distribute message is categorized as a warning and the message is written to the log report (in orange) as an informational message. When the schedule has the Notification option set to Warning, no error notification is sent.

These settings also apply to burst reports when there is a No Report to Distribute message for an individual burst value.

If a schedule contains multiple tasks, the No Report to Distribute processing only applies if all tasks that are part of the schedule produce the No Report to Distribute message. If one task in the schedule produces a report, then the value of this setting does not affect log messaging or notification.

Processing for Blackout Period Job Termination

Required.

Default value is Error.

If a scheduled report distribution is terminated due to a previously set blackout period, this option specifies whether or not an error notification will be sent via email.

• Error. An error notification will be sent to the designated email recipient.
• Warning. An error notification will not be sent to the designated email recipient.

For more information, see Using Blackout Periods.

Max Messages per Task from Data Server

Required.

Default value is 1000.

Controls the number of messages for each task from the Data Server written to the ReportCaster log file.

Scan-back section

Scan-back Type

Required.

Default value is On.

Possible values are:

• On
• Off
• Reset Next Run Time

Scan-back Interval

Default value is 15, 24 hour periods.

If the Distribution Server is unavailable for a period of time, this is the number of 24 hour periods (beginning with the Distribution Server restart time) that you want the Distribution Server to scan for jobs not yet run and run them.

Note: This setting is also available in the Administration Console.

Settings for the Additional Settings folder:

The Console Requires Secure SSL Connection

Optional.

Select this check box to encrypt the communication between the ReportCaster application and the ReportCaster Distribution Server. After enabling secure communication and saving the changes, you must manually restart the ReportCaster application and the ReportCaster Distribution Server.

SSL Certificate

Required if The Console Requires Secure SSL Connection check box is selected.

A default SSL Certificate is supplied by the installation procedure. You can optionally replace the default certificate with your own certificate to activate secure communication.

To do this, you must import your signed server certificate from a CA or self-signed certificate to the distribution server keystore, and then export an SSL certificate from the keystore.

Once you have exported the SSL certificate, you must paste this certificate to the SSL Certificate setting, save the configuration changes, and manually restart the ReportCaster application and the ReportCaster Distribution Server.

Days Until Traces are Deleted

Optional. The default value is 10.

Files and folders in the trc, log, and temp directories that are older than the specified number of days are automatically deleted by the Distribution Server. They are deleted at the same time as the daily Job Log purge and deletion of expired Library versions.

Schedule Job Traces

Optional. The default value is Off.

Enables Distribution Server Traces.

• Off. Trace is disabled.
• Schedule. Schedule job processing information.
• Schedule and Report. Scheduled job processing information and report output is returned to the Distribution Server to be distributed.

Job Status Notification Plug-in

Optional.

Name of a custom written Java class that implements the ReportCaster Job Status Notification interface and instructs the Distribution Server to perform some action (such as notifying a Web Service or other listener) that a scheduled job has started and ended. For more information, see How to Configure the Job Status Notification Plug-in.

Provide Metrics Information from Resource Analyzer

Optional.

This functionality enables the collection of RA DBMS statistics from the Reporting Server for display in the schedule log.

Note: If you do not have Resource Analyzer on the Reporting Server, this functionality will not work.

When the check box is selected, the RC log displays messages containing RA DBMS information. When the check box is not selected, messages are not displayed.

Hold Repository Connection

Required.

By default, this option is selected.

Selected. The database connection is kept open throughout the execution of the schedule, including obtaining Address Book information, and writing information to the log files.

Not selected. The database connection is dropped before executing the schedule. A new connection is made after the schedule is executed to obtain Address Book information and write information to the log files.

Allow Group Blackout Periods

Required.

By default, this option is selected.

Specifies whether or not schedule blackout periods can be defined at the group level, in addition to being globally defined for all users. This option must be selected to view group blackout periods that have been defined.

Set Next Run Time to Day After Blackout Period End

Optional. By default, this option is not selected.

When selected, if a recurring scheduled distribution is cancelled due to the schedule being run on a blackout period date, the schedule will run at the same time the following day. For more information, see Controlling When Schedules Run After Blackout Periods.

Allow PDF Distribution Directly to a Printer

Required.

By default, this option is selected.

When selected, PDF is a selectable format for the Printer distribution method. This enables a PDF file to be distributed directly to a printer. The printer must have the appropriate driver to print PDF files.

Use Legacy Behavior for Parameterized Schedule Settings

Optional.

By default, this option is not selected.

Restores the legacy behavior for the use of amper variables in schedule settings. When selected, amper variables can only be used in the Email Subject. The value of an amper variable is set to the value stored with the schedule in the ReportCaster parameters table. Runtime values are not available.

Schedule Tasks

Optional.

All Task Types are enabled, by default.

Specifies what Task Types are available to users. The default Schedule task for all Advanced Schedules is WebFOCUS Report. When you are creating a task in the Advanced Scheduling tool, clicking the New button displays the dialog box for the selected default task. For more information, see Specifying Schedule Task Settings.

Distribution Formats

Optional.

All formats are enabled, by default.

Specifies what report and graph formats are available to users.

Distribution Methods

Optional.

All distribution methods are enabled, by default.

Specifies what distribution methods are available to users.

Inline Report Distribution

Required.

The default value is Allowed.

Specifies whether the Schedule tool will enable the email distribution option to send a report in the body of the email (inline).

Note: If this option is cleared after a schedule using this option has been created, the schedule will fail when it is run. A message in the log will indicate how to fix the problem.

Packet Email

Required.

The default value is Yes.

Controls how task output and burst content are distributed through email.

Valid values are:

• No. Each burst value or task output is distributed in a separate email.
• Yes. People receiving burst values or output from tasks will receive a single email with multiple attachments.
• Burst. Each burst value in a distribution list will generate a separate email for a given email address. There may be one or more attachments in the email, depending on the number of tasks in the schedule.

Allowed Email Domains and Addresses

The default value is off.

Contains the email domains and addresses that are authorized to be used in a distribution.

Select the Restrict user input with this list check box to restrict user input of email addresses and domains to the allowed addresses saved in your list. For more information, see Validating Allowed Email Domains and Addresses.

Note:

• If this list has changed before you attempt to edit email addresses for a previously saved Basic Schedule, Advanced Schedule, Distribution List, Distribution File, or Dynamic Distribution List, the system checks if your new email addresses and domains are still valid. If you enter an invalid email address or domain, you will be prompted to change the email address or domain before saving.
• Files containing email addresses intended for distribution are also verified for valid domains at schedule execution time. If it contains a restricted address, then no delivery is made to that address and an error message is written to the log file.

Restrict Email Distribution to the Email Address of the Schedule Owner

Optional.

Check this box if you want to restrict email distribution to the email address of the schedule owner.

Note: If no email address is specified for the schedule owner in the Security Center, the schedule cannot be saved.

Always Compress and Password Protect Distributed Report

Optional.

Select this box to have any distributed reports converted into a password-protected Zip file. Passwords can be provided in a distribution file, a dynamic distribution list, or by way of the zip encryption plug-in. If no password is created, the report will not be distributed. The distribution server will enforce this rule on all schedules, including schedules created prior to selecting the check box.

Note: When this check box is selected, Inline Report Distribution will be disabled. If Inline Email is enabled, the Always Compress and Password Protect Distributed Report check box will be cleared.

Also, if the Always Compress and Password Protect Distributed Report check box is selected, then the Add Report to Zip File check box in the Distribution tabs of schedules created from both the Basic and Advanced scheduling tools is selected, by default.

Customize Attachment Message

Optional.

Provides the ability to specify a custom message.

Default Attachment Message

Required.

Defines the default message used in your Email Distribution. The message that you define here displays in the Basic Scheduling Tool.

Note: If you customize the default message, this new message will be the default message for new schedules.

Mail Server Defaults section

Mail Server

Required.

Name of the default mail server used to distribute an email schedule.

You can also specify a port for 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.

This Server Requires a Secure SSL Connection

Optional.

Select this check box if the specified mail server uses SSL.

This Server Requires a Secure TLS Connection

Optional.

Select this check box if the specified mail server uses TLS.

This Server Requires Authentication

Optional.

Select this check box if the specified mail server requires authentication with a user ID and password.

SMTP User Id/Password

Required if the mailhost is using SMTP Authorization.

No default value.

User ID and password used to connect to the mailhost.

SMTP Security Plug-in

Optional.

Name of a custom written Java class that implements the ReportCaster SMTP security interface to dynamically retrieve the user ID and password needed to connect to an SMTP server. For more information, see How to Configure Email Distribution.

Email Reply Defaults section

Mail From

Optional.

Default value for the email From field. This can be any value.

Mail Reply Address

Optional.

Default email reply address when creating an email schedule.

Note: If you do not provide a Mail Reply Address, the default Reply Address used in the Basic and Advanced Scheduling tools will be the email address of the user that is signed in to WebFOCUS. ReportCaster obtains the email address of the user from the WebFOCUS security system.

Email Retries section

Email Retries

The default value is 1.

Number of times the Distribution Server will try to connect to the email server to deliver report output.

If the Distribution Server is unable to connect to the email server on the first try, it will attempt to connect again after the specified Email Retry Interval has passed. A message for each attempt is written to the log file.

Valid values are 0 through 9.

Email Retry Interval (seconds)

The default value is 60 seconds.

Amount of time that the Distribution Server will wait between retries.

Valid values are 1 through 999.

Notification Defaults section

Notify Mail Server

Optional.

Name of the mail server that distributes the notification email. If blank, ReportCaster uses the Mailhost setting as the notification mail server.

Tip: Information Builders recommends using different mail servers for notification and email distribution. This way, if there is a problem with your Mailhost, notification will still be sent. Having separate mail servers ensures that you will be informed when the default mail server falters.

You can also specify a port for the Notify Mailhost using hostname:port. If you do not specify a port or the port you specify is not present, the default port is used.

Default Notify Type

The default value is Never.

Specifies whether to send notification of the schedule status to a specified email address. Possible values are:

• Never. This is the default value. ReportCaster does not send notification of the schedule status under any circumstance.
• On Error. The specified users are notified when errors are encountered while running the schedule. Information Builders recommends using the On Error notification option.
• Always. The specified user is always notified when the schedule runs.

Note: This setting is also available in the Administration Console.

Enable Brief Notification Only

Optional.

Controls whether Full Notification is available as a scheduling option. When this check box is selected, you can only select the Brief Notification option when you schedule a report. Full Notification is not available.

Note: Messages are displayed in the log when Full Notification is disabled. If a schedule is created before Full Notification is disabled, when the schedule executes, a Brief Notification will be sent, and a warning will be displayed in the schedule log.

Enable system notifications

Optional.

Controls whether a notification is sent to a designated administrator when a Failover event occurs, when a Distribution Server changes from Failover Mode to Full Function mode, or when a Distribution Server is stopped.

When this option is selected, the fields within the System Notifications section must be filled out before this configuration can be saved.

When a Distribution Server changes from Failover to Full Function mode, the body of the email will display as follows:

The Distribution Server at <Host>:<Port> has changed from Failover to Full Function mode.

When a Distribution Server has stopped, the body of the email will display as follows:

The Distribution Server at <Host>:<Port> is going to stop.

System Notifications section

Administrative Email Address

Required.

Enter the default Administrative Email Address to which you want the system notification to be sent. This value is required.

From

Optional.

Enter the default address from which you want the system notification to be sent. This value is not required.

Reply Email Address

Required.

Enter the default Reply Email Address to which you want the user receiving the email address to reply. This value is required.

Email Subject

Optional.

Enter the default Email Subject line. This value is not required.

Default FTP Host

Optional.

Name of the default FTP server when creating an FTP schedule.

If you want to designate a port number other than the default port number, then use the following format: hostname:port

Default FTP Location

Optional.

Name of the default FTP location (directory) when creating an FTP schedule.

Default User

Optional.

Default user ID and password to perform FTP file transfers.

To access the Default User settings, click the icon to the right of the Default User field. The User dialog box opens, where you can type the user name and password.

SFTP Security Plug-in

Optional.

Name of a custom written Java class that implements the ReportCaster SFTP security interface to dynamically retrieve the value of a public key needed to connect to a secure FTP server. For configuration information, see How to Configure FTP Settings.

Create Index File with Burst Distribution

Required.

By default, this option is selected.

For an FTP distribution of burst reports, this option determines whether or not to create an index file when the schedule runs.

FTP Server Information

This server requires a File Transfer Protocol (FTP).

Optional

By default, this option is selected.

This option specifies that the default setting in the schedule tool is to use FTP.

This server requires a secure File Transfer Protocol over TLS/SSL (FTPS).

Optional

This option specifies that the default setting in the schedule tool is to use FTPS. This functionality enables you to select this option once in the configuration tool, eliminating the need to select the button each time you use the scheduling tool. You can clear the option in the scheduling tool.

If this button is not selected, you can optionally select the button in the scheduling tool at schedule creation time.

This server requires a secure SSH File Transfer Protocol (SFTP)

Optional.

This option specifies that the default setting in the schedule tool is to use SFTP. This functionality enables you to select this option once in the configuration tool, eliminating the need to select the button each time you use the scheduling tool. You can clear the button in the scheduling tool.

If this button is not selected, you can optionally select the button in the scheduling tool at schedule creation time.

Add Zip Extension to Filename if Not Specified

Required.

By default, this option is selected.

Controls whether or not the .zip file extension will be automatically appended to the Zip file name entered by the user in a schedule distributed by email or FTP.

Select this option if you want to automatically append .zip to the entered file name.

Do not select this option if you want to use the file name as entered by the user and not have .zip automatically appended to the file name.

Zip Minimum with Email Distribution

Required.

The default size is in KB and set to 0.

Select either MB or KB and customize the size of your file using the up and down arrows.

Zip Encryption Password Plug-in

Required.

Default value is None.

Global setting that enables you to password protect and encrypt scheduled output distributed in a Zip file. This setting controls how passwords are obtained by the Distribution Server. The zip encryption is AES 256. For more information, see How to Configure the Default Zip Encryption Password Plug-in.

Possible values are:

• None. Do not use a plug-in to return the password for Zip protection.

  When set to None, you have the option to use the Zip encryption password feature by embedding the password in either a Dynamic Distribution List or a Distribution File rather than using a plug-in.

• Default. Use the provided default plug-in to return a password for the Zip encryption password feature.
• Custom. Use the provided custom plug-in named in the Zip Encryption Pwd Plug-in Name setting.

Zip Encryption Password Plug-in Name

Required when Zip Encryption Password Plug-in setting is Custom.

Type the name of a custom written plug-in that will return passwords. This plug-in must be available to the Distribution Server.

Zip Encoding

Optional.

Specifies an encoding other than the default encoding of the ReportCaster Distribution Server platform. The encoding specified must match the encoding used by WinZip or any other Zip utility installed on the Distribution Server.

Note: This setting is also available in the Administration Console.

Maximum Concurrent Compressions

Optional

The default value is zero (0).

The total number of compression operations that the Distribution Server will perform simultaneously. If many running jobs include a compression operation (for example, zipping the output before sending), the compression operations could consume all of the available resources on the Distribution Server. You can lower this number to prevent this from occurring.

Use Distributed Filename for FTP Archive Filename if Archive Filename not Specified in Schedule

Optional.

If this box is checked, then when a schedule is created that uses FTP as the distribution method and the archive file name is left blank, the Distribution Server will use the name found in the FTP Distribution List as the name of the archive file to be distributed.

Schedule End Date

Required.

Clicking the drop-down menu displays a calendar where you can select the schedule end date.

Schedule End Time

Required.

Manually, you can enter an end time for the schedule. Alternatively, use the arrows to assign a schedule end time.

Purge Log at Distribution Server Start

Optional.

By default, the check box is unchecked.

When selected, log reports are automatically purged each time the Distribution Server starts. This is in addition to the scheduled log purging that is set using the Log Purge Period and Log Purge Time options.

Daily Scheduled Log Purge and Library Expiration section:

Log Purge Period (Days)

Optional.

Automatically purges individual log reports when they are older than a set number of days. To disable daily scheduled log purges, set the Log Purge Period (Days) value to 0.

Note: This setting is also available in the Administration Console.

Log Purge Time

Optional.

Time at which log purging occurs.

Note: This setting is also available in the Administration Console.

General Setting section

Active Directory

By default, this option is not selected.

Select if you are using the Active Directory technology for LDAP.

Do not select if you are using any other technology for LDAP.

Secure Connection (SSL)

By default, this option is not selected.

Indicates whether or not SSL (Secure Sockets Layer) is used to communicate with the LDAP server.

LDAP Host

There is no default value.

Host name or IP address of your LDAP directory server.

LDAP Port

Default value is 389.

Port on which the directory server listens.

LDAP Search Base

There is no default value.

Filter for LDAP searches. Only the subtree below the search base is available for LDAP queries. For example, dc=ibi, dc=com.

Search Time Out

Default value is 120.

Time, in seconds, that ReportCaster can search an LDAP data source before timing out.

Security Principal

No default value.

Service account of the user performing authentication. The user must have sufficient access rights to locate user entries in the directory.

Select the icon to the right of this option to open the User dialog box, where you can type a user name and password.

LDAP Email Setting section

Email LDAP Enabled

By default, this option is not selected.

Indicates whether ReportCaster is enabled to retrieve email address information from an LDAP data source.

Email Map

Default value is mail.

Attribute type for email entries.

Email User Filter

Default value provided is dependent on the LDAP Type selected.

Filter for email entries to be retrieved. For example:

(& (mailnickname=*)
(|(&(objectCategory=person)
(objectClass=user)(!(homeMDB=*))
(!(msExchHomeServerName=*)))
(&(objectCategory=person)
(objectClass=user)(|(homeMDB=*)
(msExchHomeServerName=*)))
(&(objectCategory=person)
(objectClass=contact))
(objectCategory=group)
(objectCategory=publicFolder)))

First Name Map

Default value is givenName.

Attribute for first name entries.

Last Name Map

Default value is sn.

Attribute for last name entries.

Settings for the Data Servers folder:

Graph Agents

The default value is 1.

Optimizes the processing of graphs. Due to performance considerations, Information Builders generally recommends configuring this setting to 1 Graph Agent for each concurrent graph report. However, your own internal testing should determine the Graph Agent value that best suits the business needs of your organization.

Graph Servlet URL

Optional.

There is no default.

Overrides the default graph server setting and configures graph image files to be created on the Application Server.

Type the following value

http://hostname/context_root/IBIGraphServlet

where:

hostname

Is the host name of the Application Server where the WebFOCUS Client is installed.

context_root

Is the site-customized context root for the WebFOCUS web application deployed on your Application Server. The default is ibi_apps.

This setting is available for Reporting Server and WebFOCUS procedures.

This setting should not be used when web server security is enabled. This includes Basic authentication, IWA, SSL, and third-party security products (such as SiteMinder). In these cases, the web server security settings can prevent WebFOCUS from creating the graph.

Excel Servlet URL

Optional.

Specifies the application server to be used to zip the file components that comprise an EXCEL® 2007 file (.xlsx) as follows:

&URL_PROTOCOL://servername/alias/IBIEXCELSERVURL

where:

URL_Protocol

Is HTTP.

servername

Is the name of the application server where the WebFOCUS Client is installed.

alias

Is the context root of the WebFOCUS application. The default is ibi_apps.

This setting is available for the Reporting Server and WebFOCUS procedures. This setting should not be used when web server security is enabled. This includes Basic authentication, IWA, SSL, and third-party security products (such as SiteMinder). In these cases, the web server security settings can prevent WebFOCUS from creating the Excel 2007/2010 file.

FOCEXURL/FOCHTMLURL

Default value is

http://localhost:8080

Specifies the host name and port of the FOCEXURL/FOCHTMLURL.

Settings for an individual Data Server:

Name

Required.

Name of the selected Data Server.

Note: Data Server names are case-sensitive. Data Servers are defined in the WebFOCUS Client as uppercase so you should also define Data Servers as uppercase in ReportCaster.

Default

Required.

This option is selected by default.

Set FOCEXURL/ FOCHTMLURL in the scheduled procedure

Required.

This setting is selected, by default. If this setting is not selected, the Distribution Server will not set the value of FOCEXURL or FOCHTMLURL for a scheduled procedure. Therefore, when cleared, if FOCEXURL or FOCHTMLURL is already set in the edasprof.prf file, this setting remains in effect, unless it is overridden in the scheduled procedure.

Security section

Security Type

By default, this option is set to User.

Static. A valid Execution Id and password is supplied in the User setting. When creating a schedule, you cannot specify an Execution Id and password.

User. A valid Execution Id and password must be specified when creating a schedule.

Shared. When creating a schedule, the user ID and password is internally assigned as the Execution Id and password.

Note: Since the actual password is not stored in the WebFOCUS repository, the Shared configuration can only be used when a password is not required to connect to the Reporting Server.

Trusted. The Execution Id is the schedule owner and no password is sent to the Reporting Server when schedules run.

Note: The Reporting Server must be a configured to accept a Trusted connection when the Trusted option is selected.

User

Required if Security Type is set to Static.

Default Execution Id and password.

To access the ID and password, select the icon to the right of the User field. The User dialog box opens, where you can type the user name and password.

Graph section

Graph Engine

Required. The value is GRAPH53.

Controls which graph engine to use for server-side graphics. By default, this specifies the GRAPH53 setting.

Headless

By default, this option is not selected.

Determines whether a graphics card exists on the Reporting Server. When not selected (the default), a graphics card exists on the server. When selected, no graphics card exists on the server.

Maximum Connection/Threads

Required.

The default connection is 3.

Maximum number of connections available to the Reporting Server. You can specify a maximum of 20 connections.

This setting works in conjunction with the optional Weight setting, enabling you to prioritize the alternate servers in a cluster queue.

Settings for the Report Library Folder:

Library Distribution Options

Required.

Provide the ability to restrict the Access Options or Email for Library option that appear in WebFOCUS when distributing scheduled output to the Report Library.

Default Library URL for Email Notification

Required.

Configured during the Distribution Server installation.

Default value is http://hostname:port/ibi_apps/ library/libreport.jsp (where hostname is the host name of the ReportCaster web application. Specify the port only if it is not the default value of 8080).

URL included in the email notification that enables you to access specific content in the Report Library.

This is the Library URL value in the Distribution tab of the Basic Scheduling Tool and the Advanced Scheduling Tool when the distribution method is Library and the Send an Email after Report saved to Library option is selected.

Note: If this field is blank, then no report ID or burst values are sent with the email notification.

Use Default Library URL for Email Notification

Required.

Selected. The Distribution Server will always use the URL in the WebFOCUS configuration file when sending notifications.

Not selected. The Distribution Server will not automatically use the URL in the WebFOCUS configuration file when sending notifications. The URL value that is specified in the schedule is used.

Note: Javascript in the output of a URL task distributed to the Report Library may cause a script error when the report is opened from a Library notification email.

Send Report Id And Version With Notification Email

Required.

Selected. Report ID and burst values are sent with the email notification of the distribution.

Not selected. Report ID and burst values are not sent with the email notification of the distribution.

Select Compression Option in Schedule by Default

By default, this option is not selected.

Selected. WebFOCUS will compress files stored in the Report Library.

Not selected. WebFOCUS will not compress files stored in the Report Library.

Settings For The Additional Library Settings folder:

Library Expiration section

Version

Selected by default.

The Report Library stores the output for the most recent number of versions specified. You can indicate a numeric value up to 9999.

Use the up and down arrows to select the number of versions.

Day

Optional.

Version is the default Library Expiration option.

The Report Library stores the report for the number of day(s) specified. You can indicate a numeric value up to 9999.

Use the up and down arrows to select the number of days.

Week

Optional.

Version is the default Library Expiration option.

The Report Library stores the report for the number of week(s) specified. A numeric value up to 9999.

Use the up and down arrows to select the number of weeks.

Month

Optional.

Version is the default Library Expiration option.

The Report Library stores the report for the number of month(s) specified. A numeric value up to 9999.

Use the up and down arrows to select the number of months.

Year

Optional.

Version is the default Library Expiration option.

The Report Library stores the report for the number of year(s) specified. A numeric value up to 9999.

Use the up and down arrows to select the number of years.

Never Expire

Optional.

The Never Expire option is enabled by default. Click the Enabled checkbox to disable this option.

This option controls the option to select Never Expire when scheduling a report to run using the Report Library option.

Library Access Option section

Private (Accessible only to the owner)

Optional.

Only the Owner of the schedule is authorized to access the Library report. This is the default value.

Published (Accessible according to ReportCaster security policy)

Optional.

All users that are authorized to view the Library report in the folder location it is stored in can access the report. The destination folder of the Library report must be a published folder and the schedule owner must be authorized to publish content in this folder.

Shared (Appears under Shared Content Folder)

Optional.

All users that are authorized to view the Library report in the folder location it is stored in can access the report. The report appears under a Shared Content folder.

Shared with (Appears under Shared Content folder according to Library Access List)

Optional.

Only the groups or users defined in the Access List, and the owner of the schedule, are authorized to access the report. The report appears under a Shared Content folder.

InfoSearch section

Index Library Output

Optional.

By default, this check box is not selected.

Select this check box if you want future Report Library distributions to be added to a searchable index. If this option is enabled, all future Report Library distributions will be searchable using InfoSearch. When a schedule distributes a report to a Report Library while this option is selected, the log report of the schedule will indicate that the Library output was fed to Magnify, a WebFOCUS search software. For more information, see the Understanding InfoSearch technical content.

Settings for the Watch List Settings folder:

Enable Library Watch List

This check box is selected by default.

Enabled. When the user right-clicks a Library Report in the Repository, the Subscribe option is made available, allowing a user to subscribe to the Library Report.

Not Enabled. When the a user right-clicks a Library Report in the Repository, the Subscribe option is hidden.

Email From

Optional.

Name of either the person, department, group, and so on, that is sending the Watch List email notification. This notification informs the recipient that a new version of a report procedure (FEX) on the Watch List has been sent to the library. The notification includes the report job description and a link to the report procedure (FEX).

Email Message

Optional.

Message in the body of the Watch List notification email.

Email Reply Address

Optional.

Email address that will receive any reply responses from the Watch List notification email.

Email Subject

Optional.

Text that will appear in the Watch List notification email subject line.

Notify Mode

Optional.

The default value is Watch List Notification Only.

If the report schedule is set to send an email notification when the report procedure (FEX) is saved to the library and the report procedure (FEX) is subscribed to the Watch List, then:

• Watch List Notification Only. You will only receive the Watch List notification email.
• Watch List and Schedule Notification. You will receive both the schedule library notification email and the Watch List notification email.
• No Watch List Email Notification. You will receive no Watch List email notifications.