Administration Commands
define_focal_point
The application is the main focal point.
2.29.2 Returned Parameters
If the command executes successfully, SNAplus2 returns the following parameter:
primary_rc
OK
The focal point was defined as requested.
2.29.3 Error Return Codes
If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
Parameter Check
If the command does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
PARAMETER_CHECK
secondary_rc
Possible values are:
INVALID_CATEGORY_NAME
The ms_category parameter contained a character that was not valid.
INVALID_FP_NAME
The fp_fqcp_name or ms_appl_name parameter value was not valid.
State Check
No specific state errors, other than those listed in Appendix A, Common Return Codes from snapadmin Commands, occur for this command.
Function Not Supported
If the command does not execute because the node’s configuration does not support it, SNAplus2 returns the following parameters:
primary_rc
FUNCTION_NOT_SUPPORTED
The local node does not support MS network management functions; support is defined by the mds_supported parameter on the define_node command.
secondary_rc
NO_SECONDARY_RC
Other Conditions
If the command does not execute because other conditions exist, SNAplus2 returns the following parameters:
primary_rc
REPLACED
Another define_focal_point command was issued to the same node while this command was outstanding, specifying a different focal point for the same MS category. This command was ignored; the node will attempt to contact the focal point specified by the second command.
95