HCL Workload Automation, Version 9.4

Task string parameters for PeopleSoft jobs

This section describes the task string parameters that control the operation of PeopleSoft jobs. You must specify them in the following places when you define their associated HCL Workload Automation jobs:
  • In the Task string field of the Task page of the Properties - Job Definition panel, if you use the Dynamic Workload Console
  • As arguments of the scriptname keyword in the job definition statement, if you use the HCL Workload Automation command line.
  • As arguments of the JOBCMD keyword in the JOBREC statement in the SCRIPTLIB of IBM Workload Scheduler for z/OS, if you are scheduling in an end-to-end environment. In this case the entire string following the JOBCMD keyword must be enclosed within quotation marks (").
    The following is an example of a JOBREC statement:
    JOBREC
      JOBCMD("/-process process_name -type 'process_type' -runcontrol runcontrol_ID")
      JOBUSR(TWS_user_name) 
    where:
    process_name
    The process name for the PeopleSoft job.
    process_type
    The process type for the PeopleSoft job. This entry must be enclosed within single quotes.
    runcontrol_ID
    The runcontrol ID for the PeopleSoft job.
    TWS_user_name
    The IBM Workload Scheduler for z/OS user who runs the psagent access method from the end-to-end scheduling environment.
Table 1 describes the parameters to define PeopleSoft jobs.
Table 1. Task string parameters for PeopleSoft jobs
Parameter Description
-process The process name for the PeopleSoft job.
-type The process type for the PeopleSoft job. This entry must be enclosed within single quotes.
-runcontrol The runcontrol ID for the PeopleSoft job.
-outputdest The destination of the PeopleSoft job output.
-outputtype The output type of the PeopleSoft job. Possible values are:
  • Any
  • Email
  • File
  • None
  • Printer
  • Web
  • Window
If you do not specify any value, HCL Workload Automation uses the value associated to the PeopleSoft job you are submitting.
Note: Depending on the PeopleSoft configuration, some combinations of the value of this option with the value of the outputformat option are not supported. In this case the PeopleSoft default value is used.
-outputformat The output format of the PeopleSoft job. Valid values are:
None
PDF
CSV
PS
DOC
RPT
Default
RTF
HP
SPF
HTM
TXT
LP
WKS
OTHER
XLS
Note: Depending on the PeopleSoft configuration, some combinations of the value of this option with the value of the outputtype option are not supported. In this case the PeopleSoft default value is used.
-runlocationdescr The PeopleSoft process scheduler responsible for processing the PeopleSoft job.
-foldername The name of the report folder used for this job. The folder must have been already created using PeopleSoft Report Manager.
tracelvl Specify the trace setting for the job. Possible values are:
1
Only error messages are written in the trace file. This is the default.
2
Informational messages and warnings are also written in the trace file.
3
A most verbose debug output is written in the trace file.
Refer to Configuring the tracing utility for detailed information.
Note: No syntax checking is performed on the output control values (outputdest, outputtype, outputformat, and foldername). If the values are not recognized, defaults are used.
The following is an example of a task string specification for a PeopleSoft 8.44 job:
-process XRFWIN -type 'SQR Report' -runcontrol 1 -runlocationdescr PSNT