OPS/REXX Built-in Functions › OPSDELV Function

OPSDELV Function

The OPSDELV function deletes only OPS/REXX global variables beginning with a valid global stem prefix (GLOBAL, GLOBALx, GLVTEMPx, or GLVJOBID) and Automate-format variables, and then returns the number of variables that it deleted. It has no effect on other variables. Automate-format variables are defined in the ATMLOCALSCOPEnn and ATMSHAREDSCOPEnn parameters.

Note: The OPSDELV function can be used in OPS/REXX, AOF rules, TSO/E REXX, or CLIST. This function is supplied for compatibility with Automate code. When writing new code, use OPSVALUE instead.

This function has the following format:

var = OPSDELV(“namemask” [optional keywords])

namemask

Specify an exact global variable name for the namemask argument, or use the following wildcard characters to select a range of names:

+

Matches any single character in a variable name.

*

Matches any number of trailing characters in a variable name.

The following are valid examples of using the + and * wildcard characters.

• The + wildcard character can be specified anywhere after the first period in a variable name. For example:
  • This is a valid namemask using the + wildcard character: globalx.+
  • This is an invalid namemask using the + wildcard character: global+.x
• The * wildcard character can be specified only at the end of a variable name. For example:
  • This is a valid namemask using the * wildcard character: global.x*
  • This is an invalid namemask using the * wildcard character: Glo+al.*x

keywords

(Optional) Keywords, if present, are separated from the namemask and from each other by a space.

For explanations of the keywords you can use with OPSDELV, see OPSDELV Command Processor in the chapter “POI Command Processors.”

Examples: OPSDELV

• This statement does not delete any variables since the variable name is not a global variable name. OPSRC is set to 4 and count is set to 0.

  count = OPSDELV('MYVARS.*')
  

• This statement removes global variables having the indicated mask. Variables GLOBAL.XYZ1 and GLOBAL.XYZ.1 would both match this example. OPSRC is set to 0 and count is set to the number of variables deleted on the local system.

  count = OPSDELV('GLOBAL.XYZ*')
  

• This statement removes global variables having the indicated mask. The command is transmitted to all MSF- or CCI-connected systems for execution. Variables GLOBAL.XYZ1 and GLOBAL.XYZ.1 would both match this example. OPSRC is set to 0 and count is set to the number of variables deleted on the local system.

  count = OPSDELV('GLOBAL.XYZ* SYSTEM(ALL)')
  

For more examples that illustrate how you can use OPSDELV, see OPSDELV Command Processor in the chapter “POI Command Processors.”