Step 4. Creating and customizing the work directory

About this task

To activate the support of the fault-tolerant end-to-end scheduling, allocate the HFS or zFS files that this environment uses and, before you run the EQQISMKD job, mount them. To mount the files at system restart, you might consider to modify the BPXPRMxxx member of the PARMLIB accordingly.

To create the HFS or zFS directories and files, on every IBM Z Workload Scheduler controller that uses the fault-tolerant end-to-end environment run the EQQPCS05 sample job. To run the EQQPCS05 sample job, ensure you have one of the following authorities:
  • A UNIX™ System Service user ID (USS UID) of 0.
  • A BPX.SUPERUSER FACILITY class profile in RACF®.
  • The user ID specified in the eqqUID field in the EQQPCS05 sample job. (Ensure that this user belongs to the group you set in eqqGID.)

For the EQQPCS05 sample, if the GID or the UID were not specified in EQQJOBS, you can specify them in the STDENV DD before running sample (for details, see Defining users and default groups assigned to server and controller). Make sure that you use a unique UID with a nonzero value; for additional information about this requirement, refer to INFO APAR II1423.

The user must also have the /bin/sh login shell defined in his OMVS section of the RACF® profile. Make sure that the login shell is set as a system default or use the following TSO command to define it: 
ALTUSER username OMVS(PROGRAM('/bin/sh'))
To check the current settings:
  1. Run the following TSO command: 
    LISTUSER username OMVS
  2. Look in the PROGRAM line of the OMVS section.
After running EQQPCS05, you find the following files in the work directory:
localopts
Defines the attributes of the local workstation (OPCMASTER) for batchman, mailman, netman, and writer processes and for SSL. For information about customizing this file, see Customizing.

Local options that have no effect in an end-to-end with fault tolerance capabilities environment are indicated and commented out in EQQPCS05.

mozart/globalopts
Defines the attributes of the IBM Workload Scheduler network (OPCMASTER ignores them).
Netconf
Netman configuration files.
TWSCCLog.properties
Defines attributes for the logging function.
You also find the following sub-directories in the work directory:
  • mozart
  • pobox
  • stdlist
  • stdlist/logs contains the log files of the USS processes