HCL Workload Automation, Version 9.4

Installing on IBM i systems where the primary language is set to 2924 using RSTLICPGM

If the system has the primary language is set to 2924, use the following procedure to install the IBM i agent using the RSTLICPGM command.

  1. Insert the IBM i HCL Workload Automation Version 9.4 DVD into your UNIX or Windows system. On UNIX, mount the DVD using the appropriate operating system command.
  2. Optionally, open a shell CLI for UNIX or a DOS command prompt on Windows.
  3. Optionally, create a temporary directory to copy the product file. For example:
    mkdir twslftatmp
  4. Go to the temporary directory. For example:
    cd twslftatmp
  5. Copy and rename the IBM i agent product file into the temporary directory. For example:
    • On UNIX
      cp /MOUNT_DIR/As400/QTWS.V1R9M0.SAVF
      mv QTWS.V1R9M0.SAVF QFTASAVF
      where MOUNT_DIR is the directory under which the DVD was mounted.
    • On Windows
      copy X:\As400\QTWS.V1R9M0.SAVF
      ren mv QTWS.V1R9M0.SAVF QFTASAVF
      where X is the DVD letter identifier.
  6. On IBM i, create a save file. For example:
    CRTSAVF QGPL/QFTASAVF

    where QGPL/QFTASAVF is the name of the save file.

  7. On UNIX, use ftp to copy the save file to the IBM i save file. For example:
    ftp 124.56.34.130
    User: QSECOFR
    Password: xxxxx
    ftp> bin
    ftp> put QFTASAVF QGPL/QFTASAVF
    ftp> quit
  8. On IBM i, run the RSTLICPGM command as follows:
    RSTLICPGM LICPGM(5G97WKB) DEV(*SAVF) SAVF(QGPL/QFTASAVF)
  9. On IBM i, run the CUSTOMIZE command.
    1. For a new installation, use the following syntax:

      CUSTOMIZE TYPE(*NEW) THISCPU(name) MASTER(name) GROUP(name) COMPANY(name)

      where:
      TYPE(*NEW)
      Required for new installations. Specifies that this is a new installation of the IBM i agent.
      THISCPU(name)
      Required. Specifies the HCL Workload Automation name of the IBM i fault-tolerant agent. This name must be used later to formally define the workstation in HCL Workload Automation.
      MASTER(name)
      Required. Specifies the HCL Workload Automation name of the master workstation.
      GROUP(name)
      Required. Specifies the name of the product group in which to install the IBM i fault-tolerant agent. For example, a test version of the product can be installed in a group named TEST and a production version can be installed in a group named PROD.
      COMPANY(name)
      Required. Specifies the name of your company.
      For example:
      CUSTOMIZE TYPE(*NEW) THISCPU(‘AS400-2') MASTER(CENTRAL) GROUP(PRODUCTION)
       COMPANY(‘AJAX FOODS')
      Note: The CUSTOMIZE command with TYPE(*NEW) installs and customizes the IBM i HCL Workload Automation stream files. The files are installed in the new IBM i stream directories /maestro and /usr/unison. The stream directories are retrieved from template stream files stored in the QFTAFILES save file, that is an object of the QTWS library, the agent product library. You can run the CUSTOMIZE command with TYPE(*NEW) only once after the agent installation.
    2. To update an existing customization, use the following syntax:

      CUSTOMIZE TYPE(*UPDATE) THISCPU(name ) MASTER(name) GROUP(name)COMPANY(name)

      where:
      TYPE(*UPDATE)
      Specifies that this is an update of one or more of the four customization values entered the first time with TYPE(*NEW). This parameter is required for updating the customization of the IBM i agent.
      THISCPU(name)
      Optional. Specifies a new name for the IBM i agent workstation to be updated.
      MASTER(name)
      Optional. Specifies a new name for the master workstation to be updated.
      GROUP(name)
      Optional. Specifies a new name for the product group to be updated.
      COMPANY(name)
      Optional. Specifies a new name for the company name to be updated.
      For example:
      CUSTOMIZE TYPE(*UPDATE) THISCPU(TWA4) MASTER(TWMT) GROUP(TEST) 
      COMPANY(MY_COMPANY)
      Note: You can run the CUSTOMIZE command with TYPE(*UPDATE) when necessary to update one or more of the values of the command parameters. These parameters are:
      • Local CPU (THISCPU), stored in the /maestro/localopts IBM i stream file.
      • Master CPU (MASTER) and Company name (COMPANY), both stored in the /maestro/mozart/globalopts IBM i stream file.
      • Group name (GROUP), stored in the /usr/unison/components IBM i stream file.
  10. To install the HCL Workload Automation unsupported utilities in the QTWSTOOLS library, enter the following command:
    RSTLIB SAVLIB(QTWSTOOLS) DEV(*SAVF) SAVF(QTWS/QTWSTOOLS) 

    For information about the utilities, see Unsupported utilities.

Note: During the installation process, only the English messages catalogs are installed. All the output messages and reports of the HCL Workload Automation instance are in English.