Open System Testing Architecture

TOC PREV NEXT INDEX



SET SEMAPHORE Command

Description:

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.

Format:
 SET {scope} SEMAPHORE semaphore-name {&}
 	 {,ON ERROR GOTO err_label}
Parameters:
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 "SERVER-RUNNING"

See also:

Synchronization Commands


CYRANO
Customer Support: France +33 (0) 1 56 33 40 00
USA +1 (978) 462-0737; Toll free 800-714-4900
UK +44 (0) 1274 761024
support-fr@cyrano.com
support-us@cyrano.com
support-uk@cyrano.com
TOC PREV NEXT INDEX