FOCAL_POINT_INDICATION

This indication is generated whenever a focal point is acquired, changed or revoked.

VCB Structure

typedef struct focal_point_indication
{
   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   data_lost;          /* previous indication lost     */
   unsigned char   ms_category[8];     /* Focal point category         */
   unsigned char   fp_fqcp_name[17];   /* Fully qualified focal        */
                                       /* point CP name                */
   unsigned char   ms_appl_name[8];    /* Focal point application name */
   unsigned char   fp_type;            /* type of current focal point  */
   unsigned char   fp_status;          /* status of focal point        */
   unsigned char   fp_routing;         /* type of MDS routing to       */
                                       /* reach FP                     */
   unsigned char   reserva[20];        /* reserved                     */
} FOCAL_POINT_INDICATION;

Parameters

opcode
AP_FOCAL_POINT_INDICATION
format
Identifies the format of the VCB. This field is set to zero to specify the version of the VCB listed above.
primary_rc
AP_OK
secondary_rc
Equals zero.
data_lost
Specifies whether data has been lost (AP_YES or AP_NO). It is set when an internal component detects a failure that has caused a previous indication to be lost. If the data_lost flag is set to AP_YES then subsequent data fields can be set to null. The application should issue a QUERY verb to update the information that has been lost.
ms_category
Category of focal point where the focal point has been acquired, changed or revoked. This can 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.
fp_fqcp_name
The fully qualified control point name of the current focal point. This name is 17 bytes long and is right-padded with EBCDIC spaces. It is composed of two type-A EBCDIC character strings concatenated by an EBCDIC dot. (Each name can have a maximum length of 8 bytes with no embedded spaces.) This name will be all zeros if the focal point has been revoked and not replaced (so that there is no currently active focal point).
ms_appl_name
Name of the current focal point application. This can either be one of the 4-byte architecturally defined values (right-padded with EBCDIC spaces) for management services applications as described in SNA Management Services , or an 8-byte type-1134 EBCDIC installation defined name. This will be all zeros if the focal point has been revoked and not replaced (so that there is no currently active focal point).
fp_type
Type of focal point. Refer to SNA Management Services for further details.

AP_EXPLICIT_PRIMARY_FP
AP_BACKUP_FP
AP_DEFAULT_PRIMARY_FP
AP_DOMAIN_FP
AP_HOST_FP
AP_NO_FP

fp_status
Status of the focal point:
AP_NOT_ACTIVE
The focal point has gone from active to inactive.
AP_ACTIVE
The focal point has gone from inactive or pending active to active.
fp_routing
Type of routing that applications should specify when using MDS transport to send data to the focal point (only significant if the focal point status is AP_ACTIVE):
AP_DEFAULT
Default routing is used to deliver the MDS_MU to the focal point.
AP_DIRECT
The MDS_MU will be routed on a session directly to the focal point.