ADDRESS TNG Commands › ADDRESS TNG Environment Commands › CREATE Command

CREATE Command

The CREATE command creates a new object.

This command has the following format:

ADDRESS TNG 'CREATE OBJECT(class.object)
{{PROPERTY(propertyname)
 VALUE(propertyvalue)} | VAR(varlist.)}'

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.

After you create a new object, you also usually create an Inclusion object to include your new object under another object on the WorldView 2D map. The OBJECT parameter that you specify for a new inclusion object is

Inclusion. <Class of the child object> . <name of the child object>

To specify the UUIDs for the new object and its parent object as attributes to the new inclusion object, use the VAR parameter .

PROPERTY

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

VALUE

Specifies the value of an object property as listed in the CA NSM class browser. The ADDRESS TNG environment automatically performs the conversion from the REXX variable format to the internal format of CA NSM.

VAR

Specifies the name of a REXX stem variable (varlist) that contains PROPERTY/VALUE pairs of data. For example, if the command contains the following:

... VAR(pairlist.)

The ADDRESS TNG environment examines the value of the variable pairlist.0 to determine the number of entries to process. Each of the variables pairlist.1 to pairlist.n (where n is the value of pairlist.0) should contain a quoted string consisting of a property followed by at least one blank space followed by the value to be set for the property. For example:

pairlist.1 = "name  FRED"
pairlist.2 = "label South Dakota"