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.