CA-GSS Statements and Commands › GSS Extended Functions › IO Functions › Number, String, and Variable Functions › System Information Functions › OPSVALUE()

OPSVALUE()

This function interrogates and sets the values of CA OPS/MVS Event Management and Automation global variables. These values are maintained in the CA OPS/MVS Event Management and Automation address space.

Syntax

OPSVALUE(name,[actioncode],[newvalue],[oldvalue])

Parameters

name

Name of the CA OPS/MVS Event Management and Automation global variable to be referenced. This value can be a literal string or any expression that evaluates to the name of a global variable.

actioncode

Action code defining the operation to be performed. For a list of valid action codes and descriptions of each, see your CA OPS/MVS Event Management and Automation guide set.

newvalue

New value for the CA OPS/MVS Event Management and Automation variable.

Oldvalue

Previous value of the CA OPS/MVS Event Management and Automation variable. This value is compared with the current contents of the variable before assigning the value specified by newvalue. If the content of the current variable does not match the content specified by oldvalue, the operation is suppressed and an error condition returned.

Usage Notes

• OPSVALUE() is valid only if CA OPS/MVS Event Management and Automation is installed and operational on your system.
• If you reference a CA OPS/MVS Event Management and Automation variable several times (perhaps in a loop), consider using the OPSVALUE() function to assign the value to a local variable.
• Several copies of CA OPS/MVS Event Management and Automation can execute simultaneously on your system. The subsystem ID that is assigned to each copy identifies it. By default, OPSVALUE() communicates with the CA OPS/MVS Event Management and Automation specified in the ISERVE initialization parameters. You can override this value by using the SETADDR() function.
• OPSVALUE() has the same syntax and follows the same conventions as the OPSVALUE() available to CA OPS/MVS Event Management and Automation users. For complete information about using OPSVALUE(), see the CA OPS/MVS Event Management and Automation guide set.

Return Codes

101 - 104

ARG n MISSING OR INVALID

Example

x = setaddr('ops','OPS5')   /* Set target CA-OPS/MVS */
x = opsvalue(...            /* Fetch or store value */