CLEAR SEMAPHORE Command

This command resets a named semaphore to its Clear state. The semaphore is identified by its name and scope (which must be either LOCAL or TEST-WIDE). A test-wide semaphore is one that is shared by all Scripts running as part of a distributed test; a local semaphore is only shared between Scripts running on the local node.

The ON ERROR GOTO err-label clause can be specified to define a label to which control should be transferred in the event of an error.

Command Definition:

CLEAR {scope} SEMAPHORE semaphore-name
	{,ON ERROR GOTO err-label}

scope

The scope of the semaphore to clear. This must be either LOCAL or TEST-WIDE, and defaults to LOCAL.

semaphore-name

A character variable, or quoted character string, containing the name of the semaphore to clear.

err-label

A label defined within the current scope of the Script to which control branches if an error occurs.

Example:

CLEAR LOCAL SEMAPHORE "USERSEM"