B_SetServiceTimeout

Note: For backward compatibility with products earlier than extend 10, use the B$ prefix to call the function, instead of B_. From extend 10 onwards, B$ is deprecated.

This function allows the service program to control the length of time that the service program is permitted to run without interacting with BIS.

The service timer is reset when:

If the timer elapses, the service program is terminated. The default service timeout interval is 30 seconds.

The syntax of this function call is:

Call "B_SetServiceTimeout" using TimeoutInSeconds giving BIS-Status.

where TimeoutInSeconds may be:

The BIS-Status result field and the result codes are defined in BISDEF.CPY. Here are the most common return codes:

BIS-Status Code Event Description
BIS-Success The call was successful.
BIS-Fail-SessionAbandoned Service termination is already being requested because the BIS session inactivity time has elapsed without a request. This function call had no effect.
BIS-Fail-SessionComplete Service termination is already being requested because a SessionComplete tag was rendered. This function call had no effect.
BIS-Fail-ServiceComplete Service termination is already being requested because a StopService tag was rendered. This function call had no effect.