⎕SVO Shared Variable Offer

This system function allows the user to establish a shared variable for use with a nominated Auxiliary Processor, or to interrogate about the degree of coupling established. An Auxiliary Processor is an external shared library which extends the facilities of the APLX language. The Shared Variable is the route by which the user communicates with this subroutine. Further details about APLX's Auxiliary Processor system are given in a separate section.

One-argument form

The right argument is a character matrix of names, or a single name. The result is the 'degree of coupling' of each of the names. The values for the 'degree of coupling' are:

     0       No coupling - no offer to share has been made, or the name is
             ill-formed.
     1       An offer to share has been made but not accepted
     2       An offer to share has been made and accepted.

Two-argument form

The right argument is a character matrix of names to be shared. Each row of the matrix may contain one or two names. The second in each pair is known as the 'surrogate' name. The 'surrogate' name is used to match a name offered by the other processor. If only one variable is to be shared the right argument may be a vector. The left argument is the number (or numbers) of the processor numbers with which the share offers are being made. The result is again the 'degree of coupling' produced.

             1 ⎕SVO 'NAME SURROGATE' (Shares NAME with processor 1, using
       2                              SURROGATE as the surrogate name).