Using Results Information

Messages placed on the user queue should be handled by user written programs. The messages will indicate the results of the function requested by the API. There are three classes of completion results:

• Successful - The request completed successfully on all nodes that performed the function.
• Partially Successful - The request did not complete successfully on all of the nodes that performed the function. In some instances, partial success is caused by one or more nodes in an inactive state. The user program needs to determine if a partially successful operation is considered successful or unsuccessful.
• Unsuccessful - The request failed on all nodes that performed the function.

Results that are partially successful or unsuccessful will have diagnostic or informational messages describing the causes of failure and the node that failed to process the request. See the description of each API for the possible messages returned to the user queue.

General Information Applicable to Cluster APIs

The following parameters on Cluster APIs must be valid object names and uppercase only:

• Node ID
• Cluster name
• Cluster resource group name
• Job name specified for an application cluster resource group
• Device domain name
• Site name

To qualify as a valid object name, the first character must be alphabetic (A-Z) or one of the special characters, $, @, or #. The remaining characters are the same as the first character, but can also include 0 through 9, underscores and periods.