Library /sys$common/syshlp/helplib.hlb  —  DTM  CREATE  VARIABLE
   Defines a variable in the Digital Test Manager library.

   Format

     CREATE VARIABLE  variable-name variable-value [/qualifier...]

          "remark"

1  –  Command Qualifiers

1.1    /GLOBAL

   Defines the variable as being accessible to all tests in all
   collections. You cannot specify both /LOCAL and /GLOBAL with the
   same CREATE VARIABLE command. The default is /LOCAL.

1.2    /LOCAL

   Defines the variable as being accessible only to an individual
   test that references it in its test description. The default is
   /LOCAL. You cannot specify both /LOCAL and /GLOBAL with the same
   CREATE VARIABLE command.

1.3    /LOG

   /LOG (D)
   /NOLOG

   Controls whether Digital Test Manager displays informational and
   success messages on your screen.

1.4    /LOGICAL

   Defines the variable as a OpenVMS logical name. You cannot specify
   both /LOGICAL and /SYMBOL with the same CREATE VARIABLE command.
   The default is /SYMBOL.

1.5    /NUMERIC

   Used only with the /SYMBOL qualifier, the /NUMERIC qualifier
   defines the symbol type as a numeric value. Use this qualifier
   to define a quoted symbol value as numeric. You cannot specify
   both /NUMERIC and /STRING with the same CREATE VARIABLE command.
   If the variable value is not enclosed in quotation marks (" "),
   the variable type is defined as a numeric value.

1.6    /STRING

   Used with the /SYMBOL qualifier, the /STRING qualifier defines
   a symbol type as a text string. Use this qualifier to define an
   unquoted symbol value as a text string. You cannot specify both
   /NUMERIC and /STRING with the same CREATE VARIABLE command. If the
   variable value is enclosed in quotation marks (" "),  the variable
   type is defined as a text string.

1.7    /SYMBOL

   Defines the variable to be a OpenVMS symbol. When you specify a
   variable as a symbol with the /SYMBOL qualifier, you must further
   define it as either a numeric value (with the /NUMERIC qualifier)
   or a text string (with the /STRING qualifier). You cannot specify
   both /LOGICAL and /SYMBOL with the same CREATE VARIABLE command.
   The default is /SYMBOL.

2  –  Example

   DTM> CREATE VARIABLE/SYMBOL/LOCAL INPUT_FILE "emptyfil"
   _Remark: Name of input file, with an empty file as the default
   %DTM-S-CREATED, symbol variable INPUT_FILE created.
   DTM>

   This example creates the variable INPUT_FILE. It is defined as
   a local symbol, with a default value of emptyfil. The quotation
   marks indicate that the value is a string.
Close Help