{
{   This request retrieves the value for an SCL variable or variable component.
{ Any variable reference may be used to specify the variable.
{
{   The VALUE parameter returned by this requests points to a copy of the
{ variable's value.  The space occupied by that copy is released when the
{ requesting command processor terminates.  Therefore if a variable's value is
{ to be retreived repeatedly during the execution of a command processor it may
{ be better to use the CLP$GET_VARIABLE request which provides a WORK_AREA
{ parameter, thereby allowing the space to be reused on each call.
{
{       CLP$GET_VARIABLE_VALUE (REFERENCE, VALUE, STATUS)
{
{ REFERENCE: (input)  This parameter specifies the variable to be interrogated.
{
{ VALUE: (output)  This parameter specifies (a copy of) the value of the
{       variable or variable component.  If the variable has never been
{       assigned a value and the reference is to the entire variable (as
{       opposed to a component of the variable), NIL is returned.
{
{ STATUS: (output)  This parameter specifies the request status.
{
