ISR_INDICATION


The Communications Server icon lets you know that there is a change in the way things operate.
This verb applies only to Communications Server.
This indication is generated when an ISR session is activated or deactivated. When the session is deactivated, final session statistics are returned. When the session is activated the pri_sess_stats and sec_sess_stats fields are reserved.

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.