Skip to Content
Information

This site will undergo a brief period of maintenance on Friday, 18 December at 12:30 AM Central/12:00 PM IST. During a 30 minute window, site availability may be intermittent.

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.

VDELL

This command deletes one or more long 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.

This variable operation only supports a subset of the functions available for the short variables. It only affects and searches for long variables. If a short variable (created with VPUT instead of VPUTL) with the specified name exists, it is ignored.

Command

Parameters

VDELL

[LOCAL|SHARED|PROFILE)]

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

The following table describes the parameters:

Parameter

Function

Notes

Pool identifier

Pool in which the designated variables reside

One of the following pools:

SHARED is the default.

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

Name of one or more variables or a pattern.

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 VDELL CICS*

The variable names can be generically expressed by using an asterisk. However, the VDEL command statement assumes the presence of an asterisk means the end of the string.

IMFEXEC VDELL ABC*D

is treated as if you coded:

IMFEXEC VDELL ABC*

In addition, if you try to use an asterisk within a string of text, you will receive a return code for invalid syntax usage. For example, if you try to issue the following pattern, you will receive a return code of IMFCC=16 (for invalid syntax usage):

IMFEXEC VDELL CSM*MSG12
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

The variable existed in the target pool and has been deleted.

8

No long variable with this name has been found in the target pool.

12

Attempt was made to delete a read-only variable (for example, Q-type variable was specified which cannot be deleted with VDELL).

16

Syntax error occurred.

16

Sysplex variable name is too long (exceeds 13 characters, the limit for long sysplex variable names)

20

Variable pool was not found (BBIVARS not allocated).

Example

The PROFILE pool is searched for a long variable with the name of X. If found, it is deleted.

REXX EXEC example:

"IMFEXEC VDELL X PROFILE"

CLIST example:

IMFEXEC VDELL X PROFILE

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