PS_MODIFY_RUNCONTROL
Use the PS_MODIFY_RUNCONTROL script element to assign new values to PeopleSoft record fields, directly changing Run Control parameters. Ensure that the new values you assign are plausible, because the PeopleCode defined in the record and its fields is 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. For more information, see Changes in Run Controls.
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 two keys: OPRID and RUN_CNTL_ID. Do not define these parameters when you use the PS_MODIFY_RUNCONTROL script element, because 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
| Parameter | Description | Format |
|---|---|---|
| RUNCONTROLID= | Run Control ID of the PeopleSoft job | Script literal |
| RECORDNAME= | Name of a PeopleSoft record that is part of a Run Control | Script literal |
| FIELDNAME= | Name of a field of the PeopleSoft record | Script literal |
| FIELDVALUE= | Value to assign to the field | Script literal |
| KEYNAME(n)=
(Optional) |
Key in the Run Control table, where n indicates the level. You can use values between 1 and 3. | Script literal |
| KEYVALUE(n)=
(Optional) |
Value for the key field, where n indicates the level. You can use values between 1 and 3. | Script literal |
Examples
The following example assigns a new date to the ASOFDATE field of the RUN_CNTL_HR PeopleSoft record.
PS_MODIFY_RUNCONTROL RUNCONTROLID='sbb',RECORDNAME='RUN_CNTL_HR',FIELDNAME='ASOFDATE',FIELDVALUE='20020117'
The second example modifies 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: