Restrictions for using long variables


BMC recommends that you carefully consider and plan when you use long variables.

Related topic

Processing long variables requires additional storage and, a number of 

BMC AMI Ops Automation

 functions do not support the use of long variables. The restrictions are as follows:

  • Long variables cannot be used in Rules processing.

    None of the Rule event types, including the VAR event type, support the use of long variables and the Rule Processor panels do not support long variables in any field.

  • The BBI .Display Variable command does not display the value of a long variable.

    When this command is used for a long variable, the returned value is <LONG>.

  • The IMFEXEC command VDCL and AOEXEC command VDCL cannot be used with long variables.

  • Long variables can be managed only with the commands VGETL, VPUTL, VLSTL, and VDELL.

    Long variables with the same variable name as a regular variable can co-exist with each other. If you attempt to access a regular variable with the VGETL command, it fails. If you attempt to access a long variable with the VGET command, it will also fail. When you use the VPUTL command to write a variable, you must use the VGETL command to access it and use the VDELL command to delete it.

    For example, if you use the VPUT command to create a SHARED variable named ABC and set the value to 123, there is no restriction against using the VPUTL command to create another SHARED variable named ABC with its value set to 123. You will have two SHARED variables named ABC. Using the BBI command to display variable ABC produces the following result:

.D V ABC                                              
IM9100I  COMMAND ACCEPTED                             
IM9207I  SHARED VARIABLE POOL DISPLAY                 
IM9211I  SELECTED: ABC                                
IM9212I  ABC                              123         
IM9212I  ABC                              <long>
  • Long variable commands IMFEXEC VDELL, VGETL, VLSTL, and VPUTL do not support the same parameters IMFEXEC VDEL, VGET, VLST, and VPUT.

    For example, the use of the parameters ENCRYPT, USING, FROM, INTO, and TARGET which are supported with IMFEXEC VDEL, VGET, VLST, and VPUT are not allowed on IMFEXEC VDELL, VGETL, VLSTL, and VPUTL. Refer to the documentation for each command for complete information about what parameters each command supports.

 

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