The RA (Register Application) command enables programs to use the REGISTER_APPLICATION procedure, which enables the MCP to monitor the programs and to initiate recovery action if the programs fails to report to the MCP within a specified interval.
Syntax
<application name>
A 1-to-17-character identifier that specifies the name of the application to be monitored.
<user spec>
<code spec>
<restart spec>
Explanation
RA
Reports the following information on the applications being monitored.
|
Response |
Meaning |
|---|---|
|
Running |
The application program is running and being monitored. |
|
Not Running |
The application is not running. |
|
DS on Timeout |
The application has specified the option to discontinue the program if it does not successfully check in within the specified time period. |
|
Halt Load on Failed Recovery |
The application has requested that the system be halt/loaded if the application times out and the recovery code file fails to call the REGISTER_APPLICATION procedure to check-in within a specified time period. (If the automatic recovery fails, the system is to be halt/loaded.) |
|
Recovering |
The application has been restarted but has not checked in yet |
RA <application name>
Reports details of the specified application. This report includes running information if the application is being monitored.
RA − <application name>
Deletes the specified application from the list of programs being monitored.
RA + <application name>
RA + <application name> <user spec>
RA + <application name> <code spec>
RA + <application name> <restart spec>
RA + <application name> <user spec> <code spec> <restart spec>
Adds the specified application to the list of programs being monitored, or adds the automatic restart option to the application. You can optionally add the user specification, code specification, restart specification, or two of them, or all of them. The restart specification specifies whether the program named as the RECOVERY code file for the application is to be automatically restarted after a halt/load of the system if it was running before the halt/load occurred. If the RESTART value is set to TRUE, the system automatically restarts the recovery file when the system reinitializes. The recovery program is given three minutes after being restarted to check in by calling the REGISTER_APPLICATION procedure in the library MCPSUPPORT. If it fails to check in, it is eliminated from the list of monitored programs. The default RESTART value is FALSE.
| Note: | For more information about the restart feature, refer to the REGISTER_APPLICATION procedure in the MCP System Interfaces Programming Reference Manual |
Examples
Example 1
This example adds an application to the list of applications being monitored and shows the system response:
RA + PAYROLL USER = MONEY RECOVERY = (MONEY)OBJECT/BANK
Application PAYROLL has been registered Application Name Usercode Code File PAYROLL MONEY (MONEY)OBJECT/BANK
Example 2
This example shows the command to list the application that was added in Example 1 and the system response:
RA PAYROLL
Application Name Usercode Code File PAYROLL MONEY (MONEY)OBJECT/BANK
Example 3
This example deletes the application PAYROLL from the list of applications being monitored and shows the system response:
RA - PAYROLL
Application PAYROLL has been deleted from registered applications
Example 4
This example restarts the program OBJECT/PROG under the USER1 usercode after a halt/load of the system if it was running when the halt/load occurred:
RA + TEST USER = USER1 RECOVERY = OBJECT/PROG RESTART = TRUE
Considerations for Use
If you do not have a license key present on the system for the product A Series Availability Plus, SETSTATUS refuses to process RA + and RA − commands and returns the following message:
UNABLE TO PERFORM REQUEST
If the entry point REGISTER_APPLICATION is called on a system where the key is not present, the system returns −12, which means “FEATURE NOT INSTALLED.”
