HP 3000 Manuals HP 3000 Manuals
VAR
Defines a user-defined variable.
Syntax
VAR var_name [:var_type] [=] var_value
The entire set of currently defined variables can be saved into a binary
file for later restoration. (Refer to the STORE and RESTORE commands.)
Parameters
var_name The name of the variable that is being defined. Names
must begin with an alphabetic character and are
restricted to thirty-two (32) characters, (characters
must be alphanumeric, "_", "'", or "$"). Longer names
are truncated with a warning. Names are case
insensitive.
var_type The type of the variable. The following types are
supported:
STR String
BOOL Unsigned 16-bit
U16 Unsigned 16-bit
S16 Signed 16-bit
U32 Unsigned 32-bit
S32 Signed 32-bit
S64 Signed 64-bit
SPTR Short pointer
LPTR Long pointer
PROG Program logical address
GRP Group library logical address
PUB Account library logical address
LGRP Logon group library logical address
LPUB Logon account library logical address
SYS System library logical address
USER User library logical address
TRANS Translated CM code virtual address
If the type specification is omitted, the type is
assigned automatically, based on var_value.
The optional var_type allows the user to explicitly
specify the desired internal representation for
var_value (that is, signed or unsigned, 16 bit or 32
bit) for this particular assignment only. It does not
establish a fixed type for the lifetime of this
variable. A new value of a different type can be
assigned to the same variable (name) by a subsequent VAR
command.
var_value The new value for the variable, which can be an
expression. An optional equal sign "=" can be inserted
before the variable value.
Examples
%cmdebug > var save 302.120
Define variable save to be the address 302.120. By default, this
variable is of type LPTR (long pointer) based on the value 302.120.
$nmdebug > var count=1c
Define variable count to be the value 1c.
$nmdebug > var s1:str="this is a string"
Define variable s1 to be of type STR (string) and assign the value "this
is a string".
$nmdebug > varlist
var save:lptr %302.120
var count:u32 $1c
var s1:str this is a string
Display all currently defined user variables.
Limitations, Restrictions
Refer to ENV VARS, ENV VARS_LOC, and ENV VARS_LIMIT. These environment
variables determine the maximum number of variables that can be defined.
CAUTION The output format of all System Debug commands is subject to
change without notice. Programs that are developed to
postprocess System Debug output should not depend on the exact
format (spacing, alignment, number of lines, uppercase or
lowercase, or spelling) of any System Debug command output.