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. OPSDELV then returns the number of variables that it deletes. This function 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 you write new code, use OPSVALUE instead.

OPSDELV has the following format:

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

namemask

Specifies the global variables that OPSDELV deletes. 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 examples use the + and * wildcard characters.

• The + wildcard character can be specified anywhere after the first period in a variable name. For example:
  • This example shows a valid namemask using the + wildcard character: globalx.+
  • This example shows 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 example shows a valid namemask using the * wildcard character: global.x*
  • This example shows 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.

Note: For more information about 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 because 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 that have the indicated mask. Variables GLOBAL.XYZ1 and GLOBAL.XYZ.1 both match this example. OPSRC is set to 0 and count is set to the number of variables that are deleted on the local system.

  count = OPSDELV('GLOBAL.XYZ*')
  

• This statement removes global variables that have 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 that are deleted on the local system.

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

Note: For more examples of the use of OPSDELV, see OPSDELV Command Processor in the chapter “POI Command Processors.”