Catapult Support

Installation Instructions

These instructions are for new installs of Catapult 8.0 (and higher) only. If you are upgrading Catapult from an earlier release, please log into to view the Upgrader's Guide. For additional product information, please visit the Catapult home page.

Step 6: Configure the Catapult Poller.

This step is only required on the PC where you have installed the Catapult Poller

?The Catapult Poller is the PC-based application you use to control the distribution of your downloaded IBM i spool files. You need to configure and start the Poller before Catapult can distribute any spool files. Below are instructions for configuring the basic options, but you can refer to the Catapult User Guide for more detailed instructions on all the options available.

1. Launch the Poller Configuration:

  • To launch the Poller configuration go to the Start menu and navigate to Programs > Catapult 7 > Poller> Poller Configuration. If you have the Catapult Launchpad running, you can also right-click the icon and select Configuration > Poller.
  • When prompted, log in to your IBM i. Then confirm or set the options shown below.

2. General Polling Options:

When you first install it, the Catapult Poller is configured as follows:

  • To be started and ended manually. You may later elect to have the poller launched on PC startup, or automatically start and end at specific times each day.
  • To poll periodically, every 10 minutes. You may adjust your polling cycle intervals according to your PC and IBM i resource usage.

If you are installing Catapult for the first time, and have only a few simple rules, you can set it to poll every minute or two. If you have many, complex rules processing hundreds or thousands of reports, you may want to poll less frequently.

For most applications, the default options here should work for you.

3. Network Acquisition Default Profile

You will need to fill out the Network Acquisition Default Profile options if you plan to create grab rules to retrieve network files from a location that the main Windows profile running the poller doesn't have access to. For example, the main profile might not have access to financial information on a network share, but a superuser who has created rules to grab that file may enter their login information either here or in an individual grab rule.

4. Configuring the Queues to Poll:

The setting that most affects Catapult's performance is the queues to poll. There will be no out queues selected when you first install the software, which means that Catapult will poll every queue on your system. To make the software run most efficiently you should specify a subset of queues to poll:

Select and move (using the arrows between the lists) to the Select Out Queues list any queues containing spool files that you will process and distribute with Catapult.

When you are first getting started make double sure you are polling all the necessary queues. In our experience in Technical Support, over-enthusiastic queue culling is one of the main reasons for otherwise correct grab rules not producing any results. But if you do have queues with thousands of old, archived spool files, you can leave those in the list of omitted queues.

5. Configure the Email Server Information:

? One of Catapult's primary functions is to distribute spool files by email. To do this you must provide Catapult with the IP address for your organization's email server. You also need to specify the email server information so you can be notified of any errors encountered when processing your spool files.

To configure the email server information, click on the Server menu entry and type a valid Name and From Address. Note that most email servers will not accept mail from an invalid address within your domain. Then type your email server's port and IP address:

6. Set the Administrator Email Options:

At the Administration category set the Poller to notify on any error, and enter your name and email address:

You should keep this setting until you have overcome any initial distribution difficulties.

7. Translation Options for Non-English Language Systems:

If your IBM i is configured for any language other than English, you should set up the translation options accordingly, in the Advanced Configuration options:

You can find the necessary CCSID values on your IBM i using the command DSPSYSVAL (QCHRID).

The Catapult Poller has many other configuration options, but these should get you up and running. Once you have used Catapult to successfully send yourself at least one IBM i spool file, you can come back to the Poller Configuration screens and use the Help Text or Catapult User Guide to assist you in fine-tuning the Poller's performance.