Previous Topic: OverviewNext Topic: Resources Tab


Instance Settings Property Sheet Attributes Tab

This tab contains the instance attributes, starting from the instance name and class name, through start order to a number of advanced settings.

General attributes

These attributes are defined on all instances:

Name

Instance name of the appliance. This name typically reflects the role of the appliance in the application (more precisely, in its containing assembly). The name is a single word, case sensitive, consisting of alphanumeric characters and underscore ([A-Za-z0-9_]); the name must be unique within the containing assembly.
The instance name is shown in the center of the appliance shape on the editor canvas.
A lock icon may be shown to the right of the instance name designating that the appliance is locked. When an appliance is locked, it may not be edited nor its interior viewed within the Editor. See Application and Class Locking Reference for more information.

Class Name

Class name of the appliance. This name is read-only and indicates the name of the appliance class to which this instance belongs. Typically, this field also shows the catalog where the class comes from (catalog:class), uniquely identifying the class.
The class name is shown in the bottom left of each appliance shape on the editor canvas.

Standby

If the standby option is selected, the appliance will not start automatically when the application starts (the appliance can be started manually later). The standby option may be convenient for appliances that are used in development/diagnostics, or for appliances that are planned "in reserve". This attribute is valid only for simple appliances; it is ignored on assemblies. The Standby attribute can be redirected by selecting the standby button.

Start Order

Defines the order of starting this instance, relative to the other instances in the containing assembly. Lower numbers are started first. Appliances with a higher number are not started until all those with lower numbers have started successfully. Appliances with the same start order number can be started in any order and may have their startups overlap in time. The start order is local to the containing assembly and the same start order numbers can be reused in different assemblies. The relative order of starting subordinates in different assemblies depends on the start order numbers assigned to those assemblies. Appliance instances with the start order attribute not set are started last.

Ignore Failed Start

If the ignore failed start option is selected and the appliance fails to start, this will not result in the application failing to start as a whole. This option may be convenient for appliances that are under development and have not been fully tested.

Migrateable

If you select migrateable attribute, you allow the appliance to be moved from one server to another at runtime. When not selected, the appliance will run only on the server where it was initially started. By default, all appliances are migrateable. Disabling the migration for an appliance is particularly useful to "pin" an appliance to a particular server. This attribute is valid only for simple appliances; it is ignored on assemblies. This attribute can be redirected by selecting the redirect button.

Advanced attributes

This is an advanced capabilities section -- all fields here have reasonable defaults. Unless you need to do something special, help ensure all advanced attributes are unchecked and you can skip this section completely.
The following attributes modify the scheduling and other behavior of CA AppLogic® for System z with respect to this appliance.

Boot Timeout Override

Time, in seconds, given to the appliance to complete its startup. If not set, CA AppLogic® for System z uses a default value specified in CA AppLogic® for System z's configuration files (usually 2-5 minutes). One use of this attribute is to help diagnose why an appliance is not starting (see Debugging Appliance Start on how to do that).
The time specified here is how long the appliance has from start of OS boot to running the VM agent (vmad) that tells CA AppLogic® for System z that the appliance has started successfully. For more details, see the Appliance Creation Guide.

Shutdown Timeout Override

Time, in seconds, given to the appliance to complete its shutdown. If not set, CA AppLogic® for System z uses a default value specified in CA AppLogic® for System z's configuration files (usually 2-5 minutes).

Field Engineering Options

This is a numeric value that enables diagnostic or other special features of CA AppLogic® for System z for this appliance instance. For a list of available codes and precautions when using them, see Field Engineering Codes in the Class Editor Property Sheet Quick Reference. In short, do not enable this option unless directed by a support engineer.