PS_MODIFY_RUNCONTROL

Use the PS_MODIFY_RUNCONTROL script element to assign new values to PeopleSoft records fields, thereby directly changing Run Control parameters. For more information, see Changes in Run Controls. Ensure that the new values you assign are plausible because the PeopleCodes defined in the record and the fields are not processed. Incorrect value assignments can cause inconsistencies in date specifications, for example, if a new value is assigned to the "From" part but not to the corresponding "To" part.

Important!

• The modification process aborts, and the job ends abnormally if no key is specified or if the specification contains errors.
• PeopleSoft Run Control tables always include the following two keys: OPRID and RUN_CNTL_ID. Ensure you do not define these parameters when you use the PS_MODIFY_RUNCONTROL script element as they are generated automatically. Otherwise, no modifications are made to the table.
• To avoid conflicts, create and use separate Run Control IDs for batch processing with the AE.

Interface: PROCESSREQUEST_SBB
PeopleSoft Version: 8+

Syntax

PS_MODIFY_RUNCONTROL

RUNCONTROLID=...
,RECORDNAME=...
,FIELDNAME=...
,FIELDVALUE=...
[,KEYNAME(1)=...
,KEYVALUE(1)=...]
[,KEYNAME(2)=...
,KEYVALUE(2)=...]
[,KEYNAME(3)=...
,KEYVALUE(3)=...]

Parameters

• PS_MODIFY_RUNCONTROL
  Changes individual parameters in Run Controls
• RUNCONTROLID=
  Run Control ID of the PeopleSoft job
  Format: script literal
• RECORDNAME=
  Name of a PeopleSoft record that is a part of a Run Control
  Format: script literal
• FIELDNAME=
  Name of a field of the PeopleSoft record
  Format: script literal
• FIELDVALUE=
  Value that should be assigned to the field
  Format: script literal
• KEYNAME(n)=
  (Optional) Key in the Run Control table where n indicates the level. You can use values between 1 and 3.
  Format: script literal
• KEYVALUE(n)=
  Value for the key field where n indicates the level. You can use values between 1 and 3.
  Format: script literal

Examples

The following example assigns a new date to the ASOFDATE field name of the RUN_CTRL_HR PeopleSoft record.

PS_MODIFY_RUNCONTROL RUNCONTROLID='sbb',RECORDNAME='RUN_CNTL_HR',FIELDNAME='ASOFDATE',FIELDVALUE='20020117'

The second example shows the modification of a Run Control for currency conversion.

PS_MODIFY_RUNCONTROL RUNCONTROLID='myRunControl',RECORDNAME='RUN_CNTL_CC2_EO',FIELDNAME='RATE_MULT',FIELDVALUE='100',KEYNAME(1)='CURRENCY_CD',KEYVALUE(1)='AUT'

See also: