CEA scheduler configuration (optional)

If you want to configure a CEA scheduler address space you need to add a new CEAScheduler section to your XML file. This section should be added inside the <Configuration /> XML tags. For example:

<Configuration SVC_NO="238" DSP_TOKEN="TAURSERV">
    <STCScheduler
        SCHEDULER_NAME="TAURISPF" LISTENER_PORT="1200" FIRST_PORT="1201"
        LAST_PORT="1249" USER_SERVER_JOBNAME="IVPUSRT" CCSID="037"
    >
       <UserServer CCSID="037" />
    </STCScheduler>
    <CEAScheduler
        SCHEDULER_NAME="CEASCHED" LISTENER_PORT="1250" FIRST_PORT="1251" 
        LAST_PORT="1299" CEA_LOGONPROC="CEAPROC" CEA_ACCOUNT="ACCT#"
        CCSID="037"
    >
       <UserServer CCSID="037" />
    </CEAScheduler>
</Configuration>

Use the following parameters to configure a CEA scheduler:

LISTENER_PORT	Names the IP port that the scheduler listens on for incoming work requests.
FIRST_PORT and LAST_PORT	The port range to be used for user servers. In the sample in Configuring z/Server, 48 TSO address spaces can be started simultaneously, each address space uses a different port. These ports must be in the same range that the associated holder address space has defined. Note: IBM imposes a technical limit: up to ten CEA-launched TSO user address spaces can be started for the same TSO user and up to 50 CEA-launched TSO user address spaces can be started in any z/OS lpar. This limit includes TSO address spaces used by z/OSMF.
CEA_LOGONPROC	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	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 access services of this scheduler must share this accounting number.

The ports defined for the CEA scheduler LISTENER_PORT and range defined by FIRST_PORT:LAST_PORT need to be opened in the firewall protecting the z/OS host system.

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:

<CEAScheduler
        SCHEDULER_NAME="CEASCHED" LISTENER_PORT="1250" FIRST_PORT="1251" 
        LAST_PORT="1299" CEA_LOGONPROC="CEAPROCD" CEA_ACCOUNT="ACCT#" 
        MAIL_NOTIFY="1"
    >
       <UserServer CCSID="37" />
    </CEAScheduler>

For a complete overview of all possible parameters for a scheduler address space, see Scheduler and user server configuration.

For a complete overview of all parameters for a CEA scheduler address space see the parameters listed in Configuration reference that applies to CEA schedulers.

Note:

If you change the name of the CEA Scheduler JCL procedure (CEASCHED) in the PROCLIB you must change SCHEDULER_NAME value to match.
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.