Installing or upgrading the IBM® Z Workload Scheduler agent automatically

You can automatically install or upgrade an IBM® Z Workload Scheduler agent (z-centric) or an agent with dynamic capabilities by customizing and running the following applications provided with the product. The applications are provided in both batch loader and Workload Automation Programming Language formats.
IWSZZCENINSTALL
To upgrade an IBM® Z Workload Scheduler agent. Run this application on a workstation where an IBM® Z Workload Scheduler agent instance exists, to automatically upgrade it.

Use the EQQZCEBL sample to import the batch loader format or the EQQZCEWA sample to import the Workload Automation Programming Language format.

IWSZZREMINSTALL
To install an IBM® Z Workload Scheduler agent by running a Remote Command job defined on the Dynamic Workload Console. Run this application on a workstation where an IBM® Z Workload Scheduler agent instance exists, to automatically install as many IBM® Z Workload Scheduler agents on as many workstations as you want.

Use the EQQZREBL sample to import the batch loader format or the EQQZREWA sample to import the Workload Automation Programming Language format.

IWSZZDYNINSTALL
To upgrade a dynamic agent. Run this application on a workstation where a dynamic agent instance exists, to automatically upgrade it.

Use the EQQZDYBL sample to import the batch loader format or the EQQZDYWA sample to import the Workload Automation Programming Language format.

Before importing the IWSZZCENINSTALL, IWSZZREMINSTALL, or IWSZZDYNINSTALL application to the AD database, complete the following customization steps:
  1. The applications apply to the Linux operating system. To use them in a Windows environment, modify the paths and commands within each sample job as required.
  2. The workstation names associated with the operations within the samples are A130 and Z130. Ensure that you either create these workstations in your environment or modify the samples with your actual workstation names, as follows:
    A130
    The agent running the command (driving agent).
    Z130
    The agent that is to be installed (target agent).
  3. All the jobs that are run by the IWSZZCENINSTALL or IWSZZDYNINSTALL application are defined in the EQQZCJCL sample. Create the corresponding jobs in the controller JOBLIB and customize them according to your environment, as follows:
    /opt/IBM/TWA_twszc
    Installation path of the target agent.
    Buildzcen
    Directory of the target agent where the agent will be installed.
    /mnt/build
    Source directory on the target agent from which the new agent code will be copied.
    -uname twszc
    Name of the user for which the IBM® Z Workload Scheduler agent is installed.
    /JDBC_drivers
    Installation path of the JDBC drivers on the target agent.
    The IWSZZCENINSTALL, IWSZZREMINSTALL, and IWSZZDYNINSTALL applications comprise the following jobs, connected by internal dependencies:
    Operation 001, workstation A130, job name JOBSTOP
    Stops the target agent.
    Operation 002, workstation A130, job name JOBUNINS
    Uninstalls the target agent by running the twsinst command.
    Operation 003, workstation A130, job name JOBDLBLD
    Deletes the source directory containing the old compressed file for the target agent.
    Operation 004, workstation A130, job name JOBDLINS
    Deletes the target agent installation path.
    Operation 005, workstation A130, job name JOBCOPY
    Copies the compressed file to install the agent from the driving agent to the target agent installation path.
    Operation 006, workstation A130, job name JOBUNTAR
    Runs the uncompress command of the agent code.
    Operation 007, workstation A130, job name JOBINSZC (in IWSZZCENINSTALL) or JOBINSDY (in IWSZZDYNINSTALL)
    Installs the target agent by running the twsinst command.
    Operation 008, workstation A130, job name JOBJDBC (automatic)
    Copies the JDBC drivers to the target agent.
    Operation 009, workstation WAIT
    This operation waits for a few minutes, to ensure that the target agent is started.
    Operation 010, workstation Z130, job name
    Runs a sample job on the target agent to verify that the installation was successful.

Choose which application you want to run and use the appropriate sample to load it into your AD database.