PS_RUN_PROCESS

Use the PS_RUN_PROCESS script element to create a process request for a PeopleSoft process and monitor its execution. The end of the PeopleSoft process is recognized based on its run status, which is stored in the PeopleSoft database. Some parameters of this script element depend on the PeopleSoft version you use, as indicated in the syntax.

Interface: PROCESSREQUEST and PROCESSREQUEST_SBB

PeopleSoft Version: 8+

Syntax

PS_RUN_PROCESS PROCESSNAME=...,PROCESSTYPE=...,RUNLOCATION=...,RUNCONTROLID=...[,OUTPUTDEST=...][,OUTDESTTYPE=...][,OUTDESTFORMAT=...][,OUTREGISTER=...][,REPLICATE=...]

Parameters

Parameter	Description	Format	Allowed Values	Default Value
PROCESSNAME=	Name of the PeopleSoft process to initialize and monitor. Note: The name refers to the definition in the PeopleSoft Process Scheduler. If you use the RUNLOCATION parameter, the name of the assigned Process Scheduler Batch Server must also comply with that definition.	Script literal	n.a.	n.a.
PROCESSTYPE=	Process type of the PeopleSoft process	Script literal	n.a.	n.a.
RUNLOCATION=	Name of an assigned PeopleSoft Process Scheduler Batch Server, such as PSUNX or PSNT. Note: The name of the assigned Process Scheduler Batch Server must comply with the definition in the PeopleSoft Process Scheduler that the process name refers to.	Script literal	n.a.	n.a.
RUNCONTROLID=	Run Control ID of the PeopleSoft process	Script literal	n.a.	n.a.
OUTPUTDEST= (Optional)	Directory to which the PeopleSoft process writes its output	Script literal	n.a.	n.a.
OUTDESTTYPE= (Optional)	Output type of the PeopleSoft process, such as file, printer, or email. To see all valid values, run the following query: select XLATSHORTNAME from XLATTABLE where FIELDNAME = 'OUTDESTTYPE';	Script literal	n.a.	n.a.
OUTDESTFORMAT= (Optional)	Output format of the PeopleSoft process, such as TXT, HTM, or PDF. To see all valid values, run the following query: select XLATSHORTNAME from XLATTABLE where FIELDNAME = 'OUTDESTFORMAT';	Script literal	n.a.	n.a.
OUTREGISTER= (Optional)	Indicates whether the output file generated by the PeopleSoft command is registered in the Automation Engine. Note the following about the generated output file: The output file name is composed of the OUTDESTTYPE, OUTDESTFORMAT, and OUTPUTDEST parameters plus the instance number, in the format <path><job/process name>_<Instance Number>.<output type>, for example, c:\temp\DDDAUDIT_31126.PDF. Ensure that the PS agent can access the generated output file so that it can retrieve it to the Automation Engine. The PS agent must be installed on the same machine as the PS system, or at least have access to its file share. Ensure that the distribution agent of the PS system is configured properly so that the generated output files can be delivered to the directory specified in the job definition. This is a prerequisite for the PS agent to transfer the files to the Automation Engine. The output format depends on the process type. For example, TXT is not available for all process types; in that case the PS system falls back to a default value. The PS agent has no influence on this behavior, so the report output file may not be available in the selected output format.	n.a.	NO — The output file is not registered. YES — The output file is available for download from the Reports window in the AWI. For more information, see External (Directory) Reports.	NO
REPLICATE= (Optional)	Indicates whether child jobs/processes are registered as JOBDs in the Automation Engine. If set to YES, they are displayed in the Tasks list of the Process Monitoring perspective.	n.a.	n.a.	n.a.

Examples

The first example runs the THR200 PeopleSoft process of process type SQR Report.

PS_RUN_PROCESS PROCESSNAME='THR200',PROCESSTYPE='SQR Report',RUNLOCATION='PSUNX',RUNCONTROLID='mlc',OUTPUTDEST='/tmp/'

The second example uses optional parameters to store the output of the PeopleSoft process in a temporary directory as a PDF file.

PS_RUN_PROCESS PROCESSNAME='DDDAUDIT',PROCESSTYPE='SQR Report',RUNLOCATION='PSNT',RUNCONTROLID='sbb',OUTDESTTYPE='FILE',OUTDESTFORMAT='PDF',OUTPUTDEST='c:\temp'