PORT_INDICATION

This indication is generated when the port goes from active to inactive (or vice versa).

VCB Structure

typedef struct port_indication
{
   unsigned short  opcode;                /* verb operation code           */
   unsigned char   reserv2;               /* reserved                      */
   unsigned char   attributes;            /* verb attributes               */
   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   deactivated;           /* has session been deactivated? */
   unsigned char   port_name[8];          /* link station name             */
   unsigned char   description[RD_LEN];   /* resource description          */
   unsigned char   reserva[20];           /* reserved                      */
} PORT_INDICATION;

Parameters

opcode
AP_PORT_INDICATION
attributes
The attributes of the verb. This field is a bit field. The first bit contains the visibility of the resource to be defined and corresponds to one of the following:

AP_EXTERNALLY_VISIBLE
AP_INTERNALLY_VISIBLE

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.
deactivated
Set to AP_YES when the port becomes inactive. Set to AP_NO when the port becomes active.
port_name
Name of port. This is an 8-byte string in a locally displayable character set. All 8 bytes are significant.
description
Resource description (as specified on DEFINE_PORT). This is a 16-byte string in a locally displayable character set. All 16 bytes are significant.