Configuring IWSz Schedulers

AAI supports adding IWSz schedulers on the System Monitoring page.

AAI supports the following IBM Workload Schedulers:

• IWSz, IBM's mainframe version of their Workload Scheduler
• IWSd, IBM's distributed version of their Workload Scheduler

You can add IWS schedulers before installing the IWS Connector. However, you will not be able to use them until the IWS Connector is up and running. For more information, see Installing the IWS Connector for AAI.

Adding an IWSz Scheduler

Configuring a scheduler involves defining the following:

• Scheduler-specific parameters: Name, type, connector and time zone.

• Connection data to the corresponding workload automation engine.

• Intervals, periods and times that AAI will apply to retrieve data.

To Add an IWSz Scheduler

1. In the Navigation pane, select System and then System Monitoring.

2. Click the Add Scheduler button.

3. Add the scheduler.

   1. Enter a descriptive Name for the scheduler.

      Note that the name must be unique in your AAI instance. Also it should be a name that people who will work with the data from this scheduler can easily recognize.

   2. In Scheduler Type, select IWSd.

   3. Click Save.

4. Specify the following parameters:

   • Definition Path

     The complete path to the target directory on the IWS Connector server where the IWSz Server for AAI system delivers the two Definition Data files (defs and baseobjs). This must match the value specified in the Defn Data Path field of the IWSz Server for AAI Configuration Settings for the AAI Server. For information, see Configuring an Instance of the IWSz Server for AAI

   • Event Path

     The complete path to the target directory on the IWS Connector server where the IWSz Server for AAI system is delivering the Event Data file (event) and the two Current Plan Data files (cpop and tracklog). This must match the value specified the Event Data Path field of the IWSz Server for AAI Configuration Settings for the AAI Server. For information, see Configuring an Instance of the IWSz Server for AAI

   • IWS Connector API URL

     The URL of the Tomcat web server that the IWS Connector runs on, in the following format

     http://host:port/IBMWorkflowSchedulerConnector

     This starts with http:// or https://, followed by the connector host (the IP address or DNS name of the IWS Connector server), a colon (:), the port number for the Tomcat web server for the connector, slash (/): and then the name of the connector (IBMWorkflowSchedulerConnector). For more information, see Installing the IWS Connector for AAI.

   • Default Calendar Name

     The name of an IWSz defined Default Calendar that will be used by AAI whenever an Application definition is found that does not have a Calendar associated with it.

   • Plan Extend Time(24:00)

     The daily time (using a 24 hour clock) when the Current Plan Extend job will normally be executed by IWSz to create a new Current Plan for the following 24 hour period.

   • Plan Extend From Time(24:00)

     The actual time that the Current Plan is specified to start from when the Extend process is executed. For example, the Current Plan Extend job may be set to execute at 17:00 to create a Current Plan that starts at 18:00. In this case the Plan Extend Time would be set to 17:00 and the Plan Extend From Time set to 18:00.

   • Date/Time Format

     The date and time format used as a suffix to the data files being delivered by the IWSz Server for AAI. This value must be left as Default which specifies a suffix of yyMMdd.HHmmss which is what the IWSz Server for AAI always uses.

   • TimeZone

     The time zone where the LPAR running the IWSz Subsystem is operating under. This ensures that times shown in AAI for Applications and Jobs run by this Scheduler represent the actual times for that IWSz Subsystem and the LPAR it is executing on.

     Note:

     The TimeZone drop down lists only the most common time zones. If the time zone that you need is not in this list, then select Show all time zones below the Time Zone field to open a list of all time zones worldwide and select your time zone from there.

5. Click Test Connection. AAI checks the connection to the database and lets you know the result.

6. Click Save Changes. The new scheduler is added to the list of already connected systems. Initially, its status is In Progress until the scheduler is completely connected to AAI.

Viewing a Scheduler

Click a scheduler on the list. A dialog with the following two tabs of scheduler properties appears:

• Monitoring Details

  This tab shows current scheduler update status. To immediately refresh job definitions from the scheduler, rather than wait for the daily update, click the Update Now button.

• Connection Configuration

  This tab shows the currently defined configuration properties for the scheduler.

On this dialog, if you have the required rights, you can also Edit or Delete the scheduler using the related buttons in the top of the dialog.

Editing a Scheduler

1. In the Schedulers list click the name of the scheduler.

   A dialog appears showing the current scheduler configuration data on two tabs:

   • Monitoring Details

     This tab shows current scheduler update status. To immediately refresh job definitions from the scheduler, rather than wait for the daily update, click the Update Now button.

   • Connection Configuration

     This tab shows the currently defined configuration properties for the scheduler.

2. Click the Edit button to make the fields on the Connection Configuration tab editable.

3. Make your changes, then click Save. For details about each field, see Adding a Scheduler.

   Note:

   It can take up to five minutes for the edits that you make to your scheduler connection definition to take effect. This is time between each connector check for changes to scheduler definitions.