Run
Description
Runs a Process Scheduler process.
Parameters
| Parameter | Description |
|---|---|
|
prcname=value; |
The process name. |
|
prctype=value: |
The process type. |
|
wait=value; |
True - the test waits for the process to finish. False - the test does not wait for the process to finish. The default is False. |
|
distribution_expected=value |
The status of the file to be posted. Values are:
If the distribution final status equals the distribution expected status, then a Pass is logged; if not, a Fail is logged. |
|
distribution_ret=&variable |
True or False value which captures the distribution status of the file in Process Monitor. |
|
click_refresh=value |
On or Off value determines if PTF refreshes process monitor status in fixed intervals or the status gets auto-refreshed. The default value is On. On - PTF refreshes the Process Monitor page every six seconds to verify the process and distribution status. Off - PTF does not refresh the Process Monitor page. Instead, the Process Monitor page auto-refreshes to display the updated process status. No value- takes the default value. Note: If the PIA does not support auto-refresh of process monitor, then the value must be set to Off. See Process Scheduler: Viewing the Status of Processes See Process Scheduler: Monitoring Jobs and JobSets |
|
outtype=value; |
The process output type. |
|
outformat=value; |
The process output format. |
|
outfile=value; |
The process output file. |
|
expected=value; |
Defines the expected status for the process when it completes. Expected status is based on status values returned in the Run Status column in Process Monitor. For example:
If the final status equals the expected status, then a Pass is logged; if not, a Fail is logged. |
|
ret=&variable |
The return value. True - the process completed successfully. False - the process did not complete successfully. |
Example
This example shows use of the Run action, followed by a conditional If_Then to verify that the process ran to success.
| Type | Action | Recognition | Parameters | Value |
|---|---|---|---|---|
|
Browser |
Start_Login |
|
|
|
|
Browser |
FrameSet |
TargetContent |
|
|
|
Page |
Prompt |
APPMSGMONITOR.RUN_APPMSGARCH.GBL |
|
add update |
|
Text |
Set_Value |
Name=PRCSRUNCNTL__RUN_CNTL_ID |
|
archive |
|
Page |
PromptOK |
|
|
|
|
CheckBox |
Set_Value |
Name=IB_ARCH_RUNCNTL_IB_STATUS_CANCEL |
|
Y |
|
Process |
Run |
prcname=APPMSGARCH |
prctype=Application Engine;outtype=Web;outformat=TXT;expected=Success;ret=&Statusdistribution_expected=Posted; distribution_ret=&ProcessDistributionOK; click_refresh=on |
|
|
Log |
Message |
status is &status |
|
|
|
Conditional |
If_Then |
&status=True |
|
|
|
Log |
Message |
Worked |
|
|
|
Conditional |
End_If |
|
|
|