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:

  • N/A

  • None

  • Generated

  • Posting

  • Not Posted

  • Posted

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:

expected=Success;
expected=No Success;

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