Skip to Content
Information
Newer version of documentation BMC provides a newer version of the documentation for this version of the product. As a result, BMC no longer accepts comments in this space.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see bao8301.

VDEL

This command deletes one or more variables from one of the 

BMC AMI Ops Automation

 variable pools.

Warning

Note

This command supports the use of sysplex variables; see Using-sysplex-variables for more information about restrictions with sysplex variables (such as with wildcard characters and abbreviations) and other important information.

command

Parameters

VDEL

Variable name |pattern|(v1 ... vn)

[LOCAL|SHARED|PROFILE] TARGET(ssid)

The following table describes the parameters:

Parameter

Function

Notes

Variable name |pattern|(v1 ... vn)

Name of one or more variables

If more than one variable is specified, the variable names must be enclosed in parentheses.

The maximum length of this parameter is 252 bytes. All variables in a pool can be deleted by using the identifier ALL instead of naming all variables individually. A variable cannot begin with a numeric nor can it contain special characters.

An example of using a pattern is

IMFEXEC VDEL CICS*

If you use an asterisk within a variable name, you will receive a return code for invalid syntax usage. For example, the following command returns a return code of IMFCC=16 (for invalid syntax usage).

IMFEXEC VDEL CSM*MSG12

Pool identifier

Pool in which the designated variables reside

One of the following pools:

TARGET

Specify the BBI-SS PAS ID of another BBI-SS PAS

Can be used with IMFEXEC commands VDEL, VGET, and VPUT

When a TARGET is specified with this keyword, you can use IMFEXEC VDEL to delete variables from another BBI-SS PAS that communicates with the BBI-SS PAS where the EXEC is scheduled.

Warning

Note

This command does not affect variables that have already been retrieved from one of the pools.

Condition codes are listed in the following table:

Value

Description

0

Command was executed successfully.

8

One of the following conditions is true:

  • Variable does not exist.
  • Node was not found in BBPARM member BBINOD00 (when TARGET is used).

12

TARGET was not found in BBPARM member BBIJNT00.

16

Syntax error occurred; TARGET was not found in BBPARM member BBIJNT00.

16

Sysplex variable name is too long (exceeds 15 characters)

20

One of the following conditions is true:

  • Severe error (internal) occurred and pool was not found.
  • Variable overflow occurred.

When using the TARGET keyword to VPUT a variable to another target, there is a limit of (approximately) 7000 bytes of data that can be sent to another target.

Example

This example deletes all variables ending in the characters TEST from the shared variable pool. It uses the VLST command to retrieve all variable names.

/* REXX */
"IMFEXEC VLST * SHARED"

DO I = 1 TO IMFNOL
  "IMFEXEC VGET LINE'N 'LOCAL"
  "IMFEXEC VGET' LINE||N' INTO(DUMMY1) SHARED"
  LEN = LENGTH(VALUE('LINE'I))
  IF LEN > 3 THEN
    IF SUBSTR(VALUE('LINE'I),LEN-3,LEN) = 'TEST' THEN
    "IMFEXEC VDEL' VALUE('LINE'I) 'SHARED"
END

CLIST example:

IMFEXEC VLST * SHARED
SET I=1
DO WHILE &I LE &IMFNOL
  IMFEXEC VGET LINE&I LOCAL
  SET LEN=&LENGTH(&SYSNSUB(2,&LINEI))
  IF &LEN LT 4 THEN GOTO SKIP
  IF STR(&SUBSTR(&LEN-3:&LEN,&SYSNSUB(2,&&LINEI))) +
    NE TEST THEN GOTO SKIP
  IMFEXEC VDEL &SYSNSUB(2,&&LINE&I) SHARED
  SKIP: +
  SET I=&I+1
END

Related topic

Using-the-IMFEXEC-statements

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Ops Automation 8.3