MODE_INDICATION

This indication is sent when a local LU and partner LU combination start to use a particular mode, and when the current session count for the local LU, partner LU, and mode combination changes.

VCB Structure

typedef struct mode_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   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   mode_name[8];          /* mode name                 */
   unsigned char   description[RD_LEN];   /* resource description      */
   unsigned short  curr_sess_count;       /* current session count     */
   unsigned char   reserva[20];           /* reserved                  */
} MODE_INDICATION;

Parameters

opcode
AP_MODE_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.
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.)
mode_name
Mode name, which designates the network properties for a group of sessions. This is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces.
description
Resource description (as specified on DEFINE_MODE). This is a 16-byte string in a locally displayable character set. All 16 bytes are significant.
curr_sess_count
Current count of sessions for this local LU, partner LU, and mode combination.