*THREADRDY (GETMODE)

PLBWIN or PLBCON Automation Server Only

*THREADRDY={state}

The *THREADRDY control reports the current thread state of a PL/B program object running under the automation server.

{state} is a previously defined Numeric Variable that receives the thread state. The {state} indicates if the automation program object is ready for connection to a new client. When the *THREADRDY state is set to zero (OFF), the program object is not ready for connection to another client. When the *THREADRDY state is set to one (ON), the program object is ready for connection.

The *THREADRDY is used with objects in the Running Objects Table. When a program object is started during the automation server startup process, the *THREADRDY state is set to ON by default. When a program object is connected to a client, the *THREADRDY state is set to OFF. The program object must set the *THREADRDY state to ON when the object has completed its operation and is available for connection to another client.

Note: A program object that was not one of the initially created objects is terminated when the *THREADRDY state is set to ON.

See Also: List Controls (GETMODE), GETMODE