HP-UX SNAplus2 R7 NOF Programmer's Guide

NOF API Verbs
DELETE_FOCAL_POINT
3.60.4 Returned Parameters: Parameter Check
If the verb does not execute because of a parameter error, SNAplus2 returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
Possible values are:
AP_INVALID_EMULATOR_USER
The specified user name was not defined as an emulation program user name.
AP_INVALID_USER_SESSION
The specified session name did not match the name of a session defined for this user.
Appendix B,
Common Return Codes lists further secondary return codes associated with
AP_PARAMETER_CHECK
,
which are common to all NOF verbs.
3.60.5 Returned Parameters: Other Conditions
Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are
common to all NOF verbs.
3.61 DELETE_FOCAL_POINT
The DELETE_FOCAL_POINT verb removes the definition of a focal point for a specified MS category (either the
main focal point for that category or a backup focal point). If the defined focal point application is active and acting
as the current focal point for that category, SNAplus2 sends an MS_CAPABILITIES message to the focal point to
revoke it so that it no longer acts as the focal point.
3.61.1 VCB Structure
typedef struct delete_focal_point
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
unsigned char reserved; /* reserved */
unsigned char ms_category[8]; /* management services category */
unsigned char type; /* type of focal point */
} DELETE_FOCAL_POINT;
3.61.2 Supplied Parameters
The application supplies the following parameters:
opcode
AP_DELETE_FOCAL_POINT
ms_category
289