Automation Engine Script Guide > AE JCL for Applications > PeopleSoft > PS_MODIFY_RUNCONTROL

PS_MODIFY_RUNCONTROL

Changes individual parameters in Run Controls.

Interface: PROCESSREQUEST_SBB
PeopleSoft Version: 8+

Syntax

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.

Comments

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

Automic recommends creating and using separate Run Control IDs for batch processing with AE in order to avoid any conflicts.

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

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'