Previous Topic Next topic Print topic


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#"
    >
       <UserServer CCSID="37" />
    </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 will use a different port. These ports must be in the same range that the associated holder address space has defined.

Note that 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, for instance.

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 will use this scheduler have access to. The accounting number used must be defined in general resource class ACCTNUM. All TSO users that will 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 will 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 as applying to CEA schedulers.

Previous Topic Next topic Print topic