ISR_INDICATION
![]() |
This verb applies only to Communications Server. |
VCB Structure
typedef struct isr_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 deactivated; /* has ISR session been */
/* deactivated? */
FQPCID fqpcid; /* fully qualified procedure */
/* correlator ID */
unsigned char fqplu_name[17]; /* fully qualified primary */
/* LU name */
unsigned char fqslu_name[17]; /* fully qualified secondary */
/* LU name */
unsigned char mode_name[8]; /* mode name */
unsigned char cos_name[8]; /* COS name */
unsigned char transmission_priority;
/* transmission priority */
unsigned long sense_data; /* sense data */
unsigned char reserv2a[2]; /* reserved */
SESSION_STATS pri_sess_stats; /* primary hop session stats */
SESSION_STATS sec_sess_stats; /* secondary hop session */
/* statistics */
unsigned char reserva[20]; /* reserved */
} ISR_INDICATION;typedef struct fqpcid
{
unsigned char pcid[8]; /* pro correlator identifier */
unsigned char fqcp_name[17]; /* orig's network qualified */
/* CP name */
unsigned char reserve3[3]; /* reserved */
} FQPCID;typedef struct session_stats
{
unsigned short rcv_ru_size; /* session receive RU size */
unsigned short send_ru_size; /* session send RU size */
unsigned short max_send_btu_size; /* Maximum send BTU size */
unsigned short max_rcv_btu_size; /* Maximum rcv BTU size */
unsigned short max_send_pac_win; /* Max send pacing window size */
unsigned short cur_send_pac_win; /* Curr send pacing window size */
unsigned short max_rcv_pac_win; /* Max receive pacing win size */
unsigned short cur_rcv_pac_win; /* Curr rec pacing window size */
unsigned long send_data_frames; /* Number of data frames sent */
unsigned long send_fmd_data_frames;
/* num of FMD data frames sent */
unsigned long send_data_bytes; /* Number of data bytes sent */
unsigned long rcv_data_frames; /* Num data frames received */
unsigned long rcv_fmd_data_frames;
/* num of FMD data frames recvd */
unsigned long rcv_data_bytes; /* Num data bytes received */
unsigned char sidh; /* Session ID high byte */
unsigned char sidl; /* Session ID low byte */
unsigned char odai; /* ODAI bit set */
unsigned char ls_name[8]; /* Link station name */
unsigned char pacing_type; /* type of pacing in use */
} SESSION_STATS;Parameters
The application supplies the following parameters:
- opcode
- AP_ISR_INDICATION
- format
- Identifies the format of the VCB. Set this field 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 which has caused a previous indication to be lost. If the data_lost flag is set to AP_YES then subsequent data fields may be set to null. The application should issue a QUERY verb to update the information which has been lost.
- deactivated
- Set to AP_YES when the ISR session is deactivated. Set to AP_NO when the session is activated.
- fqpcid.pcid
- Procedure Correlator ID. This is an 8-byte hexadecimal string.
- fqpcid.fqcp_name
- Fully qualified Control Point name. 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.)
- fqplu_name
- Fully qualified primary LU name (as specified on the BIND request). 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 deactivated is AP_YES.
- fqslu_name
- Fully qualified secondary LU name (as specified on the BIND request). 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 deactivated is AP_YES.
- mode_name
- Mode name which designates the network properties for a group of sessions (as specified on the BIND request). This is an 8–byte alphanumeric type A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces. This name will be all zeros if deactivated is AP_YES.
- cos_name
- Class of Service name. This is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces. This name will be all zeros if deactivated is AP_YES.
- transmission_priority
- The transmission priority associated with the session. This field is reserved if deactivated is AP_YES.
- sense_data
- The sense data sent or received on the UNBIND request. This field is reserved if deactivated is AP_YES.
- pri_sess_stats.rcv_ru_size
- Maximum receive RU size.
- pri_sess_stats.send_ru_size
- Maximum send RU size.
- pri_sess_stats.max_send_btu_size
- Maximum BTU size that can be sent.
- pri_sess_stats.max_rcv_btu_size
- Maximum BTU size that can be received.
- pri_sess_stats.max_send_pac_win
- Maximum size of the send pacing window on this session.
- pri_sess_stats.cur_send_pac_win
- Current size of the send pacing window on this session.
- pri_sess_stats.max_rcv_pac_win
- Maximum size of the receive pacing window on this session.
- pri_sess_stats.cur_rcv_pac_win
- Current size of the receive pacing window on this session.
- pri_sess_stats.send_data_frames
- Number of normal flow data frames sent.
- pri_sess_stats.send_fmd_data_frames
- Number of normal flow FMD data frames sent.
- pri_sess_stats.send_data_bytes
- Number of normal flow data bytes sent.
- pri_sess_stats.rcv_data_frames
- Number of normal flow data frames received.
- pri_sess_stats.rcv_fmd_data_frames
- Number of normal flow FMD data frames received.
- pri_sess_stats.rcv_data_bytes
- Number of normal flow data bytes received.
- pri_sess_stats.sidh
- Session ID high byte.
- pri_sess_stats.sidl
- Session ID low byte.
- pri_sess_stats.odai
- Origin destination address indicator. When bringing up a session, the sender of the BIND sets this field to zero if the local node contains the primary link station. It sets it to one if the BIND sender is the node containing the secondary link station.
- pri_sess_stats.ls_name
- Link station name associated with statistics. This is an 8-byte string in a locally displayable character set. All 8 bytes are significant. This field can be used to correlate the session statistics with the link over which session traffic flows.
- pri_sess_stats.pacing_type
- Receive pacing type in use on the primary session. This can take the values AP_NONE, AP_PACING_FIXED, or AP_PACING_ADAPTIVE.
- sec_sess_stats.rcv_ru_size
- Maximum receive RU size.
- sec_sess_stats.send_ru_size
- Maximum send RU size.
- sec_sess_stats.max_send_btu_size
- Maximum BTU size that can be sent.
- sec_sess_stats.max_rcv_btu_size
- Maximum BTU size that can be received.
- sec_sess_stats.max_send_pac_win
- Maximum size of the send pacing window on this session.
- sec_sess_stats.cur_send_pac_win
- Current size of the send pacing window on this session.
- sec_sess_stats.max_rcv_pac_win
- Maximum size of the receive pacing window on this session.
- sec_sess_stats.cur_rcv_pac_win
- Current size of the receive pacing window on this session.
- sec_sess_stats.send_data_frames
- Number of normal flow data frames sent.
- sec_sess_stats.send_fmd_data_frames
- Number of normal flow FMD data frames sent.
- sec_sess_stats.send_data_bytes
- Number of normal flow data bytes sent.
- sec_sess_stats.rcv_data_frames
- Number of normal flow data frames received.
- sec_sess_stats.rcv_fmd_data_frames
- Number of normal flow FMD data frames received.
- sec_sess_stats.rcv_data_bytes
- Number of normal flow data bytes received.
- sec_sess_stats.sidh
- Session ID high byte.
- sec_sess_stats.sidl
- Session ID low byte.
- sec_sess_stats.odai
- Origin destination address indicator. When bringing up a session, the sender of the BIND sets this field to zero if the local node contains the primary link station. It sets it to one if the BIND sender is the node containing the secondary link station.
- sec_sess_stats.ls_name
- Link station name associated with statistics. This is an 8-byte string in a locally displayable character set. All 8 bytes are significant. This field can be used to correlate the session statistics with the link over which session traffic flows.
- sec_sess_stats.pacing_type
- Receive pacing type in use on the secondary session. This can take the values AP_NONE, AP_PACING_FIXED, or AP_PACING_ADAPTIVE.
