PLU_INDICATION

This indication is generated when a local LU first connects to a partner LU. This will happen when the first ALLOCATE to this PLU is processed or when the first BIND is received from this PLU. This indication is also generated if the partner control point name changes.

VCB Structure

typedef struct plu_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;            /* has previous indication    */
                                         /* been lost?                 */
   unsigned char   removed;              /* is entry being removed?    */
   unsigned char   lu_alias[8];          /* LU alias                   */
   unsigned char   plu_alias[8];         /* partner LU alias           */
   unsigned char   fqplu_name[17];       /* fully qualified partner    */
                                         /* LU name                    */
   unsigned char   description[RD_LEN];  /* resource description       */
   unsigned char   partner_cp_name[17];  /* partner CP name            */
   unsigned char   partner_lu_located;   /* partner CP name resolved?  */
   unsigned char   reserva[20];          /* reserved                   */
} PLU_INDICATION;

Parameters

opcode
AP_PLU_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 one or more indications have been lost (AP_YES or AP_NO). It is set when an internal component was unable to send a previous indication. 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.
removed
Specifies whether an entry is being removed (AP_YES or AP_NO). It is set when entry is being removed rather than added.
lu_alias
Locally defined LU alias. This is an 8-byte string in a locally displayable character set. All 8 bytes are significant.
plu_alias
Partner LU alias. This is an 8-byte string in a locally displayable character set. All 8 bytes are significant.
fqplu_name
17-byte fully qualified network name for the partner LU. This name is composed of two type-A EBCDIC character strings concatenated by an EBCDIC dot, and is right-padded with EBCDIC spaces. (Each name can have a maximum length of 8 bytes with no embedded spaces.)
description
Resource description (as specified on DEFINE_PARTNER_LU). This is a 16-byte string in a locally displayable character set. All 16 bytes are significant.
partner_cp_name
17-byte fully qualified network name for the control point of the partner LU. This name is composed of two type-A EBCDIC character strings concatenated by an EBCDIC dot, and is right-padded with EBCDIC spaces. (Each name can have a maximum length of 8 bytes with no embedded spaces.)
partner_lu_located
Specifies whether the partner control point name has been resolved (AP_YES or AP_NO), and thus whether the partner_cp_name field contains the control point name.