VAR

Syntax

   VAR  var_name [:var_type] [=] var_value

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

EADDR

Extended address

SADDR

Secondary 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

   $nmdebug > var count=1c

   $nmdebug > var s1:str="this is a string"

   $nmdebug > varlist
   var save:lptr    %302.120
   var count:u32    $1c
   var s1:str       this is a string

Limitations, Restrictions