|
|
|
|
This indication is generated when a session is activated or deactivated. When a session is deactivated, the verb returns statistics on the usage of the session.
typedef struct session_indication
{
AP_UINT16 opcode; /* verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* primary return code */
AP_UINT32 secondary_rc; /* secondary return code */
unsigned char data_lost; /* previous indication lost */
unsigned char deactivated; /* has session been deactivated? */
unsigned char lu_name[8]; /* LU name */
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 session_id[8]; /* session ID */
FQPCID fqpcid; /* fully qualified procedure */
/* correlator ID */
AP_UINT32 sense_data; /* sense data */
unsigned char reserv1; /* reserved */
SESSION_STATS sess_stats; /* session statistics */
unsigned char sscp_id[6]; /* SSCP ID */
unsigned char plu_slu_comp_lvl; /* reserved */
unsigned char slu_plu_comp_lvl; /* reserved */
unsigned char comp_in_series; /* reserved */
unsigned char reserva[11]; /* reserved */
} SESSION_INDICATION;
typedef struct fqpcid
{
unsigned char pcid[8]; /* procedure correlator identifier */
unsigned char fqcp_name[17]; /* originator's network qualified */
/* CP name */
unsigned char reserve3[3]; /* reserved */
} FQPCID;
typedef struct session_stats
{
AP_UINT16 rcv_ru_size; /* session receive RU size */
AP_UINT16 send_ru_size; /* session send RU size */
AP_UINT16 max_send_btu_size; /* maximum send BTU size */
AP_UINT16 max_rcv_btu_size; /* maximum rcv BTU size */
AP_UINT16 max_send_pac_win; /* maximum send pacing window size */
AP_UINT16 cur_send_pac_win; /* current send pacing window size */
AP_UINT16 max_rcv_pac_win; /* maximum receive pacing window */
/* size */
AP_UINT16 cur_rcv_pac_win; /* current receive pacing window */
/* size */
AP_UINT32 send_data_frames; /* number of data frames sent */
AP_UINT32 send_fmd_data_frames; /* num fmd data frames sent */
AP_UINT32 send_data_bytes; /* number of data bytes sent */
AP_UINT32 rcv_data_frames; /* number of data frames received */
AP_UINT32 rcv_fmd_data_frames; /* num fmd data frames received */
AP_UINT32 rcv_data_bytes; /* number of data bytes received */
unsigned char sidh; /* session ID high byte */
/* (from LFSID) */
unsigned char sidl; /* session ID low byte (from LFSID)*/
unsigned char odai; /* ODAI bit set */
unsigned char ls_name[8]; /* Link station name */
unsigned char pacing_type; /* Pacing type */
} SESSION_STATS;
AP_SESSION_INDICATION
AP_OK
Specifies whether any previous session indications have been lost. If SNAP-IX detects a condition that prevents it from sending an indication (for example an internal resource shortage), it indicates this by setting the data_lost parameter on the next indication after the condition has cleared. Possible values are:
One or more previous session indications were lost. Later fields in this VCB may be set to zeros.
No previous session indications were lost.
Specifies whether the session has been deactivated or activated. Possible values are:
The session has been deactivated.
The session has been activated.
LU name of the local LU, as defined to SNAP-IX. This is an 8-byte type-A EBCDIC string, padded on the right with spaces if the name is shorter than 8 bytes.
LU alias of the local LU, as defined to SNAP-IX. This is an 8-byte ASCII string, using any locally displayable characters, padded on the right with spaces if the name is shorter than 8 bytes.
LU alias of the partner LU. This is an 8-byte ASCII string, using any locally displayable characters, padded on the right with spaces if the name is shorter than 8 bytes.
Fully qualified LU name for the partner LU, as defined to SNAP-IX. This name is a 17-byte EBCDIC string, padded on the right with EBCDIC spaces. It consists of a network ID of 1-8 A-string characters, an EBCDIC dot (period) character, and an LU name of 1-8 A-string characters.
Name of the mode used by the LUs. This is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded on the right with EBCDIC spaces if the name is shorter than 8 bytes.
8-byte identifier of the session.
Procedure Correlator ID. This is an 8-byte hexadecimal string.
Fully qualified CP name. The name is a 17-byte EBCDIC string, padded on the right with EBCDIC spaces. It consists of a network ID of up to 8 A-string characters, an EBCDIC dot (period) character, and a network name of up to 8 A-string characters.
The following parameters are used only if deactivated is set to AP_YES:
The sense data sent or received on the UNBIND message that ended the session.
The conversation duplex support as negotiated on the BIND. Possible values are:
Only half-duplex conversations are supported.
Both half-duplex and full-duplex conversations are supported. Expedited data is also supported.
Duplex support is not known because the session has deactivated.
Maximum receive RU size.
Maximum send RU size.
Maximum BTU size that can be sent.
Maximum BTU size that can be received.
Maximum size of the send pacing window on this session.
Current size of the send pacing window on this session.
Maximum size of the receive pacing window on this session.
Current size of the receive pacing window on this session.
Number of normal flow data frames sent.
Number of normal flow FMD data frames sent.
Number of normal flow data bytes sent.
Number of normal flow data frames received.
Number of normal flow FMD data frames received.
Number of normal flow data bytes received.
Session ID high byte.
Session ID low byte.
Origin Destination Assignor 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, and sets it to one if the BIND sender is the node containing the secondary link station.
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.
The type of receive pacing in use on this session.
For dependent LU sessions, the identifier of the SSCP as received in the ACTPU for the PU used by this LU. This parameter is 6 bytes and is used only by dependent LUs. This parameter is set to all zeros for independent LUs.
|
|
|
 |
|