ADDRESS TNG Commands › ADDRESS TNG Environment Commands › GET Command

GET Command

The GET command reads one or more PROPERTY names from a specified object. The PROPERTY parameter retrieves the value of the requested property. The VAR parameter retrieves the value of the properties contained in the stem variable passed as the argument to the VAR parameter.

This command has the following format:

ADDRESS TNG 'GET OBJECT(class.object) {PROPERTY(propertyname) | VAR(varlist)}
              [PREFIX(newvarname)]'

OBJECT

WorldView commands require the OBJECT parameter. The argument to the OBJECT parameter consists of the following two parts:

class

The 1- to 31- character name of the CA NSM class to which the created object belongs.

object

The 1- to 31-character name of the object. The object name can contain alphanumeric characters and any of these special characters: ! @ # $ _

Periods (.) should not be used in object names.

PROPERTY

Specifies the name of an object property (propertyname) as listed in the CA NSM class browser.

VAR

Specifies the name of a REXX stem variable (varlist) that contains the PROPERTY names of an object. For example, suppose the command contains the following:

... VAR(propname.)

The ADDRESS TNG environment will examine the value of the variable propname.0 to determine the number of entries to process. Each of the variables propname.1 to propname.n, where n is the value of propname.0, should contain a quoted string consisting of a property name. For example:

propname.1 = "name"
propname.2 = "label"

PREFIX

(Optional) Directs return information to a stem variable name (newvarname) other than the default. For more information, see ADDRESS TNG Return Information in this chapter.

Note: The PREFIX operand is only valid if REXX is the destination of the return information.

Default: TNG.GET