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