Unsupported utilities
The QTWSTOOLS library contains the following unsupported utilities:
- CAT.PGM
- The CAT program can be used
to display HCL Workload Automation standard
list (stdlist) files. Usage:
CALL QTWSTOOLS/CAT PARM(’filename’)
where filename is the name of the stdlist file. For example, to display the HCL Workload Automation production stdlist file for August 30,1999, run the program as follows:CALL QTWSTOOLS/CAT PARM(’/maestro/stdlist/1999.08.30/QMAESTRO’) - CONMAN
- Conman is available on the IBM i machine. It is qualified as unsupported because there are some limitations to its use. Conman is located in the QTWSTOOLS library. For more information about the limitations of the local conman on the IBM i agent, see Managing the IBM i agent
- JAPJOB1.PGM
- The JAPJOB1 job can be used
to demonstrate and test HCL Workload Automation.
It runs for a specified period and then returns successful or abended
status. Usage:
CALL QTWSTOOLS/JAPJOB1 PARM(’status’ ’secs’)
where:- status
- Specifies the type of status you want the job to return. The values
are:
- 0
- Return successful status.
- <>0
- Return abend status.
- secs
- Specifies the number of seconds the job idles before ending.
For example, to return successful status after 30 seconds, run the job as follows:CALL QTWSTOOLS/JAPJOB1 PARM(’0’ ’30’) - MORESTDL
- The MORESTDL program is used to display the stdlist for
the current production date. Usage:
MORESTDL
This command is equivalent to the following:
CALL QTWSTOOLS/QDSPF PARM(’/maestro/stdlist/YYYY.MM.DD/QMAESTRO’)
For example, to display the stdlist for the current production file:MORESTDL - QDSPF.PGM
- The QDSPF program can be used to display the HCL Workload Automation standard
list file (stdlist) using the Source Entry Utility (SEU) of
the IBM i.
You can use this program to display any IFS streamed file. Usage:
CALL QTWSTOOLS/QDSPF PARM(’filename’)
For example, to display the stdlist named job_file:
CALL QTWSTOOLS/QDSPF PARM(’job_file’) - TERMINAL.PGM
- The TERMINAL program can
be used to display stdout and stderr generated messages.
Usage:
CALL QTWSTOOLS/TERMINAL
For example, to display the messages logged on stdout and stderr of the user’s session, run the program as follows:CALL QTWSTOOLS/TERMINAL - TOUCH.PGM
- The TOUCH program can be used
to create the IFS files needed to demonstrate file dependencies. Usage:
CALL QTWSTOOLS/TOUCH PARM(’filename’)
where filename is the name of the created file. For example, to create /tmp/testfile with RW permissions, run the program as follows:CALL QTWSTOOLS/TOUCH PARM(’/tmp/testfile’) - RMDIR.PGM
- The RMDIR program can be used
to recursively delete UNIX directories on IBM i.
Usage:
CALL PGM(QTWSTOOLS/RMDIR) PARM('/maestro/mydir’)
where mydir is the directory to be deleted.
The following job sample, to be submitted by the IBM i agent in extended mode, uses RMDIR to delete /maestro/stdlist or any of its subdirectories:TWAS#RMDIR DOCOMMAND "submit: cmd(CALL PGM(QTWSTOOLS/RMDIR) PARM('/maestro/stdlist/2007.03.16')) USER(QMAESTRO)" STREAMLOGON "QMAESTRO" DESCRIPTION "Test RMDIR" RECOVERY STOP