*EXITAFTERSUSPEND (GETMODE)

9.3A, PLBCMP GUI Only

*EXITAFTERSUSPEND={value}

The *EXITAFTERSUSPEND control reports the runtime behavior for Windows CE Clients configured to suspend.

{value} is a previously defined Numeric Variable that receives the control value mode.

The {value} returned is one of the following:

Note the following:

1. There is an issue on Windows CE PLBCLIENT clients where a Windows CE device can be configured to go into a 'suspend' state after a period of time with no UI activity. When the Windows CE device goes into a 'suspend' state, all processes running on this device are suspended until the device wakes up. When the Windows CE Plbclient process is suspended, the socket communications channel to the PLBSERVE server stops sending keep-alive messages. After a period of time with no communications, the PLBSERVE child process/thread will terminate. When the Windows CE device is activated, the Plbclient process does not get an error until it tries to communicate with the PLBSERVE child process/thread. This scenario of actions was causing confusion for the end-users.

2. To address the issue described in item (1.), a change was requested to have the Windows CE Plbclient detect that a Windows CE suspend state has occurred. When the suspend state is detected, the Windows CE Plbclient process is to terminate immediately to avoid any confusion for an end-user that was executing a PLB program.

3. A keyword named 'PLBCS_EXITAFTERSUSPEND={on|off}' can be added to the Plbclient INI configuration. The existence of this keyword in the Plbclient INI file enables the Plbclient to detect the Windows CE suspend state. The initial {on|off} for this keyword specifies the default action to be taken when a suspend state is detected. If this keyword is set to 'on', the default action is to have the Plbclient process terminate when a suspend state is detected. If this keyword is set to 'off', the default action is to ignore a suspend state changes.

4. The SETMODE/GETMODE *EXITAFTERSUSPEND={nvar} control sets or gets the current action to be taken for the PLBCS_EXITAFTERSUSPEND keyword at the Plbclient. This control allows a PLB program to set the desired actions when a Plbclient detects a Windows CE Suspend state. The *EXITAFTERSUSPEND control ONLY takes affects when the Plbclient has the PLBCS_EXITAFTERSUSPEND keyword declared. Otherwise, the *EXITAFTERSUSPEND control does nothing. Assuming that the PLBCS_EXITAFTERSUSPEND keyword is declared for a Plbclient INI configuration, a {nvar} value that is non-zero (same as PLBCS_EXITAFTERSUSPEND=ON) causes the Plbclient to terminate when a Windows CE Suspend state is detected. If the {nvar} value is zero (same as PLBCS_EXITAFTERSUSPEND=OFF), this causes the Plblcient to ignore a Windows CE Suspend state change.

See Also: List Controls (GETMODE), GETMODE