DELETE_FOCAL_POINT

The DELETE_FOCAL_POINT verb can be used to delete focal points of a specified type and category. For more information about focal point types, see DEFINE_FOCAL_POINT. If an active focal point is deleted it will be revoked. To revoke the active focal point (of any type) specify a type of AP_ACTIVE. If a backup or implicit focal point is deleted (by specifying AP_BACKUP or AP_IMPLICIT) when it is not currently active, any information stored about it will simply be removed.

Note that the DEFINE_FOCAL_POINT verb can also be used to revoke currently active focal points. This duplicated function is retained for back compatibility.

VCB Structure

typedef struct delete_focal_point
{
        unsigned short  opcode;         /* verb operation code          */
        unsigned char   reserv2;        /* reserved                     */
        unsigned char   format;         /* format                       */
        unsigned short  primary_rc;     /* primary return code          */
        unsigned long   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;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_DELETE_FOCAL_POINT
format
Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
ms_category
Management services category. This cab either be one of the 4-byte architecturally defined values (right-padded with EBCDIC spaces) for management services categories as described in SNA management services, or an 8-byte type 1134 EBCDIC installation-defined name.
type
Specifies the type of the focal point that is being deleted. Possible types are:
AP_ACTIVE
The currently active focal point (which can be of any type) is revoked.
AP_IMPLICIT
The implicit definition is removed. If the currently active focal point is an implicit focal point, then it is revoked.
AP_BACKUP
The backup definition is removed. If the currently active focal point is a backup focal point, then it is revoked.

Returned Parameters

If the verb executes successfully, the Program returns the following parameter:
primary_rc
AP_OK
If the verb does not execute because of a parameter error, the Program returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
AP_INVALID_TYPE

AP_INVALID_CATEGORY_NAME

If the verb does not execute because the node has not yet been started, the Program returns the following parameter:
primary_rc
AP_NODE_NOT_STARTED
If the verb does not execute because the node is stopping, the Program returns the following parameter:
primary_rc
AP_NODE_STOPPING
If the verb does not execute because of a system error, the Program returns the following parameter:
primary_rc
AP_UNEXPECTED_SYSTEM_ERROR