Verbs and Built-in Functions › &VARTABLE

&VARTABLE

&VARTABLE statements add, maintain, monitor, or delete tables of variables (vartables), and vartable entries.

&VARTABLE    ADD
             ID=tablename
             KEY=fieldname
             [ SCOPE={ PROCESS | REGION | SYSTEM | AOM } ]
             [ ADJUST=n | COUNTER=n ]
             [ FIELDS=fieldlist { VARS=(var1, var2, ..., varn) |
                       VARS=prefix* [ RANGE=( start, end ) ] |
                       ARGS [ RANGE=( start, end ) ] |
                       MDO=mdoname } ]

&VARTABLE    ALLOC
             ID=tablename
             [ SCOPE={ PROCESS | REGION |
                       SYSTEM | AOM } ]
             [ AGE={ NO | NEW | ALL | UPDATE | GET } ]
             [ DATA={ 1 | n | MAPPED } ]
             [ DELOLD={ YES | NO } ]
             [ KEYFMT={ CHAR | UCHAR | NUM } ]
             [ KEYLEN=keylen ]
             [ LIMIT={ 0 | n } ]
             [ USERCORR={ NO | YES } ]

&VARTABLE    DELETE
             ID=tablename
             [ SCOPE={ PROCESS | REGION | SYSTEM | AOM } ]
             [ KEY=fieldname ]
             [ FIELDS=fieldlist VARS=varlist ]

&VARTABLE    FREE
             ID=tablename
             [ SCOPE={ PROCESS | REGION | SYSTEM | AOM } ]

&VARTABLE    GET
             ID=tablename
             KEY=fieldname
             [ SCOPE={ PROCESS | REGION | SYSTEM | AOM } ]
             [ AGE={ YES | NO } ]
             [ DELETE={ YES | NO } ]
             [ FIELDS=fieldlist { VARS=(var1, var2, ..., varn) |
                       VARS=prefix* [ RANGE=( start, end ) ] |
                       ARGS [ RANGE=( start, end ) ] |
                       MDO=mdoname } ]
             [ OPT={ KEQ | KGE | KLE | KGT | KLT | FIRST |
                       LAST | GEN | IGEN | OLDEST | NEWEST } ]

&VARTABLE    PUT | UPDATE
             ID=tablename
             KEY=fieldname
             [ SCOPE={ PROCESS | REGION | SYSTEM | AOM } ]
             [ ADJUST=n | COUNTER=n ]
             [ FIELDS=fieldlist { VARS=(var1, var2, ..., varn)
                       VARS=prefix* [ RANGE=( start, end ) ] |
                       ARGS [ RANGE=( start, end ) ] |
                       MDO=mdoname } ]

&VARTABLE    QUERY
             ID=tablename
             [ SCOPE={ PROCESS | REGION | SYSTEM | AOM } ]
             [ FIELDS=fieldlist VARS=varlist ]

&VARTABLE    RESET
             ID=tablename
             [ SCOPE={ PROCESS | REGION | SYSTEM | AOM } ]
             [ OLDEST=n | NEWEST=n ]