Scheduler configuration

The scheduler combines the functionality of for STC and CEA into one started task.

For example:

<Scheduler
        SCHEDULER_NAME="TAURISPF" LISTENER_PORT="1200" FIRST_PORT="1201"
        LAST_PORT="1249" USER_SERVER_JOBNAME="IVPUSRT" CCSID="037"
        DEFAULT="1"
>
       <UserServer CCSID="037" />
</Scheduler>

Note: If you have change the name of the STC scheduler JCL procedure (TAURISPF) in the PROCLIB you must change the SCHEDULER_NAME value to match.

If you have change the name of the STC user server JCL procedure (IVPUSRT) in the PROCLIB you must change the USER_SERVER_JOBNAME value to match.

Default Scheduler

By specifying DEFAULT="1" in a scheduler you are instructing the MFA Server that this is the Scheduler to use when the AWM client has entered the value of "DEFAULT" in the Scheduler Name field of the New Connection dialog box. Only one scheduler should be marked as the default.

You can have multiple Schedulers defined and you can specify their names in the Scheduler Name field of the New Connection dialog box.

If you type DEFAULT in the Scheduler Name field of the New Connection dialog box, and there is no default defined you will get the following message saying there is no default scheduler defined:

No default z/Server Scheduler configured.

If you specify a Scheduler Name that does not exist you get an error message saying that a matching scheduler could not be found:

Unable to find matching server details for z/Server Scheduler named Scheduler Name.

Legacy Clients

For clients supplied with versions of Enterprise Developer earlier than 3.0 the scheduler is unable to determine what type of user server the client requires. By default, the scheduler attempts to start an STC user server. You can specify the default user server to be started by the scheduler by adding the DEF_USRSRV_MODE parameter with the value of STC or CEA.

For CEA

To configure the scheduler for CEA, you need to add the following to the configuration:

CEA_LOGONPROC: This points to the logon procedure to be used when a CEA-launched TSO user address space is started. See Optional: Customizing a CEA-launched TSO user address space (CEAPROC) for information on how to configure this logon procedure.
CEA_ACCOUNT: This must be set to a valid accounting number that all TSO users that use this scheduler have access to. The accounting number used must be defined in general resource class ACCTNUM. All TSO users that use the CEA Scheduler.

For example:

<Scheduler
        SCHEDULER_NAME="TAURISPF" LISTENER_PORT="1200" FIRST_PORT="1201"
        LAST_PORT="1249" USER_SERVER_JOBNAME="IVPUSRT" CCSID="037"
	CEA_LOGONPROC=”CEAPROC” CEA_ACCOUNT=”ACCT#”
>
       <UserServer CCSID="037" />
</Scheduler>

Note: If you change the name of the CEA user server JCL procedure (CEAPROC) in the PROCLIB you must change the CEA_LOGONPROC value to match.

Optionally, if you have uncommented MAILHDR in the scheduler procedure, you need to add the MAIL_NOTIFY="1" attribute to the scheduler section.

For example:

<Scheduler
        SCHEDULER_NAME="TAURISPF" LISTENER_PORT="1200" FIRST_PORT="1201"
        LAST_PORT="1249" USER_SERVER_JOBNAME="IVPUSRT" CCSID="037"
	MAIL_NOTIFY=”1”
>
       <UserServer CCSID="037" />
</Scheduler>

See Configuration parameters reference for more information on the available parameters for a scheduler address space.

See Configuration reference for more information on the parameters applicable to a CEA scheduler.