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

OPSVALUE()

Use the OPSVALUE() function to interrogate and set 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

The OPSVALUE() function has this syntax:

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

Arguments

The OPSVALUE() function takes these arguments:

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 will evaluate 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 manual 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 prior to assigning the value specified by newvalue. If the content of the current variable does not match that 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. Each is identified by the subsystem ID that is assigned to 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 on using OPSVALUE(), see the CA OPS/MVS Event Management and Automation manual set.

Return Codes

The OPSVALUE() function produces these 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 */