SET SEMAPHORE Command

This command sets a named semaphore to its Set state. The semaphore is identified by 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:

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

scope

The scope of the semaphore to be set. 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 be set.

err-label

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

Example:

SET LOCAL SEMAPHORE "USERSEM"