Connect-Wait method
Use the Connect-Wait method
- to join the current requestor session with a parallel connector requestor session created previously. Any of the four RDB- methods or eight Connect- methods can operate in parallel.
- with the Load-DataPage method. Load-DataPage uses the PoolID property to group requestors loading data as part of the same activity. Connect-Wait lets processing wait for the stated timeout interval, or until all requestors with the same PoolID have finished loading data.
Parameters
This method accepts two parameters:
Parameter | Description |
---|---|
WaitSeconds | Enter a positive number of seconds as a timeout interval, or enter -1 to cause an indefinite wait. |
PoolID | PoolID is an arbitrary identifier used in the activity methods Load-DataPage
and Call-Async-Activity to help manage asynchronous data loading. Provide a value
when using Connect-Wait in an activity of type Asynchronous. PoolID can be any valid
String, a property reference, or a parameter. PoolID exists in the context of the activity using it, so you can have identical PoolID values in different activities without causing a problem. |
Results
- WaitSeconds has a value and PoolID has a value: Wait for child requestors to finish (if any) and then wait for data pages which belong to PoolID to finish loading. The entire operation has a timeout of the specified WaitSeconds.
- WaitSeconds has no value and PoolID has a value: Wait for child requestors to finish (if any) and then wait for data pages which belong to PoolID to finish loading. The entire operation has a timeout of indefinite.
- WaitSeconds has a value and PoolID has no value: Wait for child requestors to finish (if any). The entire operation has a timeout of specified WaitSeconds.
- WaitSeconds has no value and PoolID has no value: Wait for child requestors to finish (if any). The entire operation has a timeout of indefinite.
When awakened, if the method status is Good
, the activity can examine the
results pages of the connector methods. If the method status is Fail
, this
may indicate that one or more of the parallel child requestors has not completed.
The Connect-Wait method sets the method status to Good
or
Fail
even if you simulate the connector rule through a Connector
Simulation data instance.
Checking the method status
This method updates the pxMethodStatus property. See How to test method results using a transition.