HCL Workload Automation, Version 9.4

Limitations, problems, and workarounds

Table 1 lists the known problems and limitations, together with their solution or workaround.
Table 1. Limitations, problems, and workarounds
Limitation or problem Workaround
The DLTLICPGM command, which deletes the IBM i agent, fails if you added any new objects, except the JOBMANRC program, in the QTWS library. If the DLTLICPGM command fails, proceed as follows:
  1. Delete the /maestro directory: 
    WRKLINK OBJ('maestro')

    Use option 4.

  2. Delete the /usr/unison directory: 
    WRKLINK OBJ('/usr/unison')
  3. Delete the HCL Workload Automation commands in the QSYS directory: 
    DLTCMD QSYS/CUSTOMIZE
DLTCMD QSYS/STRNETMAN
DLTCMD QSYS/STARTTWS
DLTCMD QSYS/STOPTWS
DLTCMD QSYS/ENDTWS
  4. Delete the QTWS library: 
    DLTLIB QTWS
  5. Delete the QMAESTRO user: 
    DLTUSRPRF USRPRF (QMAESTRO) OWNOBJOPT(*DLT)
Problem with how HCL Workload Automation sets the state of run jobs. HCL Workload Automation usually sets the state of a run job based on the invoked user program return code. If the user program return code is 0, the run job status is set to SUCC, otherwise it is set to ABEND. Note that the HCL Workload Automation IBM i agent receives the user program return code only for C language-based programs. For other types of program (for example, RPG-based and COBOL-based), use the extended mode, as described in Controlling jobs in extended mode.

If the HCL Workload Automation IBM i agent is installed with primary language different from 2924, you might encounter problems during the installation and running procedures.

When this happens, use the following procedure as a workaround:
  1. Install only the program part (not the language part) using: 
    RSTLICPGM LICPGM(5G97WKB) DEV(*SAVF) RSTOBJ(*PGM) 
LNG(2924) SAVF((*1)LIBRARY_NAME/QFTASAVF)
    (*1) The library where the product save file was placed.
  2. Install only the language in a different library (for example, the library QTWS_2924) 
    RSTLICPGM LICPGM(5G97WKB) DEV(*SAVF) RSTOBJ(*LNG) 
LNG(2924) SAVF((*1)LIBRARY_NAME/QFTASAVF) LNGLIB(QTWS_2924)
    (*1) The library where the product save file was placed.
  3. Copy the following two objects from the QTWS_2924 (or the other langlib you chose) into the QTWS library: 
    QFTALANG	*PRDLOD
QMAESTRO	*MSGF
  4. Set the authority for the above objects in the QTWS library: 
    QMAESTRO	*ALL
*PUBLIC	*EXCLUDE
  5. In the QMAESTRO user profile, set CCSID 37 and LANGID ENU.
  6. Run CUSTOMIZE.
  7. Check the installation either using the command DSPSFWRSC, you see:
    5G97WKB *BASE 5001 HCL Workload Automation for IBM i 
5G97WKB *BASE 2924 HCL Workload Automation for IBM i
    or using option 10 of the (GOLICPGM) command, you see: 
    5G97WKB *NOPRIMARY HCL Workload Automation for IBM i
  8. Using an editor, for example, Edtf, open the (path) /maestro/NetConf to see its content: 
    # Netman configuration file for IBM i fault tolerant agent
#
#@(#) $Id: NetConf.400,v 1.1 1999/08/11 18:27:10 mjuarez Exp $
#
# each entry consists of 4 parts,
# service request, service type, program, and options
#
# service type is client (can be multiple and get TCP circuit)
#                 son    (only one at a time and not TCP circuit)
#
    2001  client /QSYS.LIB/QTWS.LIB/WRITER.PGM

2002  son    /QSYS.LIB/QTWS.LIB/MAILMAN.PGM -parm 32000

2003  client /QSYS.LIB/QTWS.lib/QSTOPSRV.PGM

2004  client /QSYS.LIB/QTWS.lib/SCRIBNER.PGM
    Delete all commented lines starting with the '#' character at the beginning of the file leaving only the line containing the service specification.
  9. Perform all the operations described in Starting Netman.
When IBM i agent *.msg stream files are created, at installation time, their size is 1MB and there is no documented procedure or provided utility to increase the size. To increase the size of *.msg stream files, add an environment variable, EVSIZE, in the IBM i system by issuing: 
> ADDENVVAR ENVVAR(EVSIZE) VALUE(10000000) LEVEL(*SYS)

To do this, sign on to the IBM i system with a user that has *JOBCTL special authority, for example, the QSECOFR user. The IBM i agent interprets the EVSIZE variable which, in the previous sample, was set to 10MB.

The workaround works only if no job is active on the IBM i agent and if the *.msg stream files are not already in the /maestro and /maestro/pobox directories. If the *.msg stream files to be resized already exist, they must be deleted before resizing.

To check, change, or remove the EVSIZE variable, enter the following command as an QSECOFR user: 
WRKENVVAR LEVEL(*SYS)
A conman stop for the IBM i agent issued from the master domain manager also causes the writer to stop running on the IBM i agent and to lose the link. This does not affect linking at Jnextday/Jnextplan. This is a known limitation. If conman stop LFTA is issued from the master domain manager, use conman link LFTA to reestablish the link.
Only one instance of the IBM i agent can be installed. The QMAESTRO is hardcoded. None.
When running a job containing the following command: 
CHGJOB CCSID (65535)
The Job log is not returned when asked from the master.		 Modify CCSID back to 37 before ending the job and carry out the following steps:
  1. Start Program
  2. Execute CHGJOB CCSID (65535)
  3. Program BODY
  4. Execute CHGJOB CCSID(37)
  5. End Program