CLEAR SEMAPHORE Command

Description:

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.

Format:

 CLEAR {scope} SEMAPHORE semaphore-name {&}
 	 {,ON ERROR GOTO err_label}

Parameters:

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 "SERVER-RUNNING"

See also:

Synchronization Commands