C-LANG Statements › RUNCONTROLID Statement—Specify PeopleSoft Run Parameters

RUNCONTROLID Statement—Specify PeopleSoft Run Parameters

The RUNCONTROLID statement specifies a set of PeopleSoft run parameters for a PeopleSoft process.

Supported Job Type

This statement is optional for the PeopleSoft job type.

Syntax

This statement has the following format:

RUNCONTROLID control_id

control_id

Specifies the value assigned to the run control identifier. This value corresponds to the Run Control ID field in PeopleSoft.

Limits: Up to 30 characters; case-sensitive

Example: FLOOR8_COLOR

Note: In PeopleSoft, some processes spawn children using the CreateProcessRequest PeopleCode function. PeopleSoft may mark the parent process as a successful completion even if one or more of its children fail. If you want the agent to check the status of children when determining the completion status of the parent, add ".*" to the end of the Run Control ID, for example, PS_ALL.*.

Notes:

• Enclose values that contain delimiters (such as spaces) in double quotation marks.
• If you do not specify this statement in the job definition, a default run control ID must be defined in the ps.default.runCntlId parameter in the agent's agentparm.txt file. Otherwise, the job fails.
• The RUNCONTROLID statement overrides the default run control ID specified in the agent's agentparm.txt file.

Example: Specify a Run Control ID

This example runs the process named AEMINTEST. The process has the Application Engine type and PS_ALL run control ID.

AGENT PS_TOR
PROCESSNAME AEMINTEST
PROCESSTYPE 'Application Engine'
RUNCONTROLID PS_ALL

Example: Check Children Status

This example runs the AEMINITEST process on the agent named PS_AGENT. The job completes successfully if the AEMINITEST process and all of its children complete successfully.

AGENT PS_AGENT
PROCESSNAME AEMINITEST
PROCESSTYPE 'Application Engine'
PSOPRID VP1
RUNCONTROLID HDL8010.*