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.
Previous topic Connect-SOAP method Next topic Commit method