Previous Topic: Volumes TabNext Topic: Notes Tab


Properties Tab

The Properties tab defines the properties that will be available on the appliances of this class. Properties are named configuration parameters for the appliance.

The properties of the assembly defined on this tab are known as boundary properties. These are the only properties that are visible on the assembly appliance from outside to those, who use it.

Defining Properties

The set of properties on an appliance class reflects the specific needs of the class. CA AppLogic® for System z passes the property values to the appliance without interpretation. You are free to define whatever properties you like.

Name

Name for the property. The property name uniquely identifies a property within the appliance. The property names are used to set property values in the Instance Settings property sheet.

Default

Default value for the property. This value will be used, if no value is specifically defined for the property in an appliance instance. Most properties should have defaults. You can leave the default value empty, in which case the default is an empty string. You can also disable the default value by making the property mandatory (see below).

Options

Optional property attributes include the following:
The mandatory attribute (denoted by an exclamation point) marks the property as required to be set specifically on each appliance instance, making it so that the property has no defaults. Having a lot of mandatory properties makes it hard to use the appliance, so keep them to a minimum. Mandatory properties should be used only in cases where no default can be defined (for example, the target host name in output gateways).

In addition, pressing the info button info button provides a summary of the property attributes, including the property type, default, constraints and other attributes. This information is available only if the property is redirected inside the assembly.

You can arrange the property order in the list by using the up and down buttons on the right side of the list. We recommend using the property order to make configuration more intuitive: Group the more important properties at the top; arrange the properties in in a way that it will make sense to configure them (for example, IP address, netmask and then gateway).

Assemblies have fewer attributes required on their properties than simple appliances because most of the required information is defined automatically when the property is redirected inside the assembly. This includes the type of the property, and any other constraints on its value.

If you plan to add your assembly to a catalog, you should add in this list all properties that you want to propagate to subordinate appliances, and then redirect the properties of the subordinate appliances to these boundary volumes. This way you will be able to configure different property values on each instance of the assembly. Properties that are not propagated to subordinates are ignored.

Important: If a mandatory property is not set or a property value constraints are not met, the application will not start. This helps ensure that configuration constraints are met and prevents many configuration errors from happening. CA AppLogic® for System z will report the name of the appliance and the property that failed the constraint check, so that you can easily locate and fix it.

If you try to delete a property and you see the error You cannot delete this property because it is parameterized, this means that the property has a value set on the instance of the appliance (or application). Before you can delete the property, you need to clear any explicit value configured into the property. If you are editing the class of an appliance, close the Class Editor property sheet; right-click on the appliance, click Properties, and restore the property's value to its default (see Instance Settings). If you are editing the application class, close the Class Editor property sheet; right-click on the Editor canvas, click Application Configuration, select the Properties tab and restore the property's value to its default (see Application Configuration). After that, go back to the class editor and delete the property.