Process
The Process actions run processes through Process Scheduler.
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. |
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 |
|
|
|
Description
Changes the default behavior of the run process. Insert these steps prior to the Process Run step that they modify. This action only supports one parameter per step. For multiple parameters, you will need multiple steps.
Parameters
Parameter |
Description |
|---|---|
RunButton=value; |
The run button name. |
ProcessMonitorLink=value; |
The Process Monitor link name. |
ProcessInstanceField=value; |
The field where the process instance ID will appear. |
QueuedTimeout=value; |
Overwrites the local option value (in minutes). |
PostingTimeout=value; |
Overwrites the local option value (in minutes). |
ProcessingTimeout=value; |
Overwrites the local option value (in minutes). |
ExceptionTimeout=value; |
General timeout, in minutes, for all the states that are not in the local option. |
QueuedResult=value; |
Overwrites the local option value. Valid values are FAIL and WARN. |
PostingResult=value; |
Overwrites the local option value. Valid values are FAIL and WARN. |