Click a Save button. The record is added to the database, and all buttons and tabs in the Application Details are enabled.
 
When you save a new Application resource record, the Controller also automatically creates three related Application Control Tasks, one each for starting, stopping, and querying the application.

If appropriate, repeat these steps for any additional Application resource records that you want to add.

This section contains general information about the application.

Name

Name used within the Controller to identify this resource. Up to 40 alphanumerics. It is the responsibility of the user to develop a workable naming scheme for resources.

Version

Version number of the current record, which is incremented by the Controller every time a user updates a record. Click on the Versions tab to view previous versions. For details, see Record Versioning.

Description

Member of Business Services

User-defined; allows you to select one or more Business Services that this Application resource belongs to. Click on the lock icon to unlock the field and select a Business Service.

This section contains assorted detailed information about the application.

User-defined; Type of application.
 
Options:

• Windows Service
• Linux/Unix Daemon
• z/OS Started Task

Credentials

Windows Agent

If Application Resources#Application Type = Windows Service; Name of the Windows agent where the application will run.

Linux/Unix Agent

If Application Resources#Application Type = Linux/Unix Daemon; Name of the Linux/Unix agent where the application will run.

z/OS Agent

If Application Resources#Application Type = z/OS Started Task; Name of the z/OS agent where the application will run.

Environment Variables

If Application Resources#Application Type = Windows Service or Linux/Unix Daemon; Allows you to enter environment variables needed by the program to run.
 
To add a variable, click the + icon and enter a Name and Value. To delete a variable, select in the list of variables and click the - icon.
 
You can add a maximum of 4,000 characters for the combined Names and Values of all variables. The variable is listed in the space underneath.

Run as sudo

If Application Resources#Application Type = Linux/Unix Daemon; Instruction to run the command as Sudo (superuser do).

Runtime Directory

Directory where the application executes. Variables supported.

Command used to start the application. This can be any process or command that starts the application. If you try to start an application monitor that is already started, you will see the message: Application already monitored with <status> status.

Command used to stop the application. This can be any process or command that stops the application.

Command used to query the application. This can be any process or command that queries the application. You must first start the application monitor from the Controller before you can query the application.

Specifies how the Controller should determine whether or not the application is running.
 
Options:

• Success Exitcode Range - Application goes to or remains in Active status if its exit code falls within the range specified in the Query Exit Codes field (see below). Otherwise it has Impaired status.
• Failure Exitcode Range - Application goes to or remains in Impaired status if its exit code falls within the range specified in the Exit Codes field (see below). Otherwise it has Active status.
• Success Output Contains - Application goes to or remains in Active status if its output contains the text specified in the Scan Output For field (see below). Otherwise it has Impaired status.
• Failure Output Contains - Application goes to or remains in Impaired status if its output contains the text specified in the Scan Output For field (see below). Otherwise it has Active status.

Query Exit Code

System-supplied if Application Resources#Query Query Exit Code Processing = Success Exitcode Range or Failure Exitcode Range; the most recent exit code returned by the application in response to a query.

If Application Resources#Query Query Exit Code Processing = Success Output Contains or Failure Output Contains; type of output.
 
Options:

• Standard Output (STDOUT)
• Standard Error (STDERR)
• File

Scan Output For

If Application Resources#Query Query Exit Code Processing = Success Output Contains or Failure Output Contains; string that the Controller should scan for in the output.

Output File

If Application Resources#Output Output Type = File; path and name of the file.

Maximum number of Query attempts to be made on the specified application.

This section contains information about the current status of the task application.

Status

System-supplied; indicates the current status of the application.
 
Options:

• Inactive - Application is not being monitored by the Controller.
• Start Failure - Application failed to start. This may occur, for example, if you have problems with credentials or the start command itself is incorrect. When this occurs, the Controller is not monitoring the application. You should troubleshoot the problem and restart the application from the Controller.
• Starting - Start command has been executed.
• Active - Application has successfully started and is running, based on the parameters specified in the Exit Code processing fields.
• Impaired - An application that is being monitored returned a response that, based on the specified exit code parameters, indicates it is not running. If this occurs, you should troubleshoot the problem and restart the application from outside the Controller. Unless you issue a stop command, the Controller continues monitoring during this process. When the application comes back up, the query process will recognize this and return the application to Active status.

Status Description

System-supplied; a more detailed status message describing why a status change occurred, in the format: "Query exit code <in-not in> <success-failure> exit code range. Query <success-failure> output not found."

System-supplied; Date and time that the application was last started by the Controller.

Last Query

System-supplied; date and time of the last query response received from the application.

System-supplied; Number of queries that were executed before the Application went into Active or Impaired status.

Required if Application Resources#Query Query Exit Code Processing = Success Exitcode Range or Failure Exitcode Range; range of exit codes. Format is numeric.
 
Use commas to list a series of discontinuous exit codes; use hyphens to specify a series of continuous exit codes. For example: 1,5,11, 22-30.

This section contains Metadata information about this record.

UUID

Universally Unique Identifier of this record.

Updated By

Name of the user that last updated this record.

Updated

Date and time that this record was last updated.

Created By

Name of the user that created this record.

Created

Date and time that this record was created.

This section identifies the buttons displayed above and below the Application Details that let you perform various actions.

Save

Saves a new record in the Controller database.

Save & New

Saves a new record in the Controller database and redisplays empty Details so that you can create another new record.

Save & View

Saves a new record in the Controller database and continues to display that record.

New

Displays empty (except for default values) Details for creating a new record.

Update

Executes the Start command associated with this Application resource and begins querying.

Executes the Stop command associated with this Application resource. the Controller stops the application and stops querying (monitoring).

Executes the Query command associated with this Application resource. This allows you to get immediate status of the application instead of waiting for the next automated query.

Delete

Refresh

Refreshes any dynamic data displayed in the Details.

Close

For pop-up view only; closes the pop-up view of the Details.

This section identifies the tabs across the top of the Application Details that provide access to additional information about this Application resource.

Application Control Tasks

Lists all Application Control tasks associated with this Application resource.

Application Control Task Instances

Lists all Application Control task instances associated with this Application resource.

Application Monitor Triggers

Lists all Application Monitor triggers associated with this Application resource.