PS_MODIFY_RUNCONTROL

Changes individual parameters in Run Controls. For more information, see Changes in Run Controls.

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)
    =...]

Syntax

Description/Format

RUNCONTROLID=

Run Control ID of the PeopleSoft job.
Format: script literal

RECORDNAME=

Name of a PeopleSoft record which is a part of a Run Control.
Format: script literal

FIELDNAME=

Name of a field of the PeopleSoft record.
Format: script literal

FIELDVALUE=

Value which should be assigned to the field.
Format: script literal

KEYNAME(n)=

Key in the Run Control table
Format: script literal

n indicates the level. Values between 1 and 3 are allowed.

KEYVALUE(n)=

Value for the key field
Format: script literal

n indicates the level. Values between 1 and 3 are allowed.

You can use this script element to assign new values to fields of PeopleSoft records and change Run Control parameters directly. Ensure the plausibility of new values because the PeopleCodes which are defined in the record and the fields are not passed through in this case. An incorrect value assignment can cause "inconsistencies" in date specifications, for example (e.g. a new value is assigned to the "From" part but no to the corresponding "To" part).

Tip: Use separate Run Control IDs for batch processing with AE in order to avoid any conflicts.

Warning! The modification process aborts and the job ends abnormally if no key has been specified or if the specification contains errors.

Note: Two keys are always included in PeopleSoft Run Control tables: OPRID and RUN_CNTL_ID. Makes sure not to specify these parameters when you use the script element PS_MODIFY_RUNCONTROL. Otherwise, no modifications will be made in the table.

Example

In the following example a new date is assigned to the field ASOFDATE of the PeopleSoft record "RUN_CTRL_HR".

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: