LU_0_TO_3_INDICATION
This indication is generated when the state of a local LU (Type 0-3) changes.
VCB Structure
typedef struct lu_0_to_3_indication
{
unsigned short opcode; /* verb operation code */
unsigned char attributes; /* attributes */
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 pu_name[8]; /* PU Name */
unsigned char lu_name[8]; /* LU Name */
unsigned char description[RD_LEN]; /* resource description */
unsigned char nau_address; /* NAU address */
unsigned char lu_sscp_sess_active;
/* Is SSCP session active? */
unsigned char appl_conn_active; /* Is application using LU? */
unsigned char plu_sess_active; /* Is PLU-SLU session active? */
unsigned char host_attachment; /* Host attachment */
SESSION_STATS lu_sscp_stats; /* LU-SSCP session statistics */
SESSION_STATS plu_stats; /* PLU-SLU session statistics */
unsigned char sscp_id[16]; /* SSCP ID */
} LU_0_TO_3_INDICATION;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; /* max send BTU size */
unsigned short max_rcv_btu_size; /* max rcv BTU size */
unsigned short max_send_pac_win; /* max send pacing window size */
unsigned short cur_send_pac_win; /* current send pacing win size */
unsigned short max_rcv_pac_win; /* max receive pacing win size */
unsigned short cur_rcv_pac_win; /* curr receive pacing winsize */
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 of data frames received */
unsigned long rcv_fmd_data_frames;
/* num FMD data frames received */
unsigned long rcv_data_bytes; /* number of 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
- opcode
- AP_LU_0_TO_3_INDICATION
- attributes
- The attributes of the verb. This field is a bit field. The first bit
contains the visibility of the resource to be defined and corresponds to one
of the following:
AP_EXTERNALLY_VISIBLE
AP_INTERNALLY_VISIBLEIf data lost is set to AP_YES, this is set to AP_EXTERNALLY_VISIBLE.
- 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.
- pu_name
- Name of local PU. This is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces.
- lu_name
- Name of the local LU whose state has changed. 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_LU_0_TO_3). This is a 16-byte string in a locally displayable character set. All 16 bytes are significant.
- nau_address
- Network addressable unit address of the LU (which will be in the range 10–2554).
- lu_sscp_sess_active
- Specifies whether the ACTLU has been successfully processed (AP_YES or AP_NO).
- appl_conn_active
- Set if the application is using this LU (AP_YES or AP_NO).
- plu_sess_active
- Specifies whether the PLU-SLU session has been activated (AP_YES or AP_NO).
- host_attachment
- Specifies the LU host attachment type:
- AP_DLUR_ATTACHED
- LU is attached to host system using DLUR.
- AP_DIRECT_ATTACHED
- LU is directly attached to host system. Note the LU-SSCP and PLU-SLU statistics are only valid when the sessions go from active to inactive. In all other cases the fields are reserved.
- lu_sscp_stats.rcv_ru_size
- This field is always reserved.
- lu_sscp_stats.send_ru_size
- This field is always reserved.
- lu_sscp_stats.max_send_btu_size
- Maximum BTU size that can be sent.
- lu_sscp_stats.max_rcv_btu_size
- Maximum BTU size that can be received.
- lu_sscp_stats.max_send_pac_win
- This field will always be set to zero.
- lu_sscp_stats.cur_send_pac_win
- This field will always be set to zero.
- lu_sscp_stats.max_rcv_pac_win
- This field will always be set to zero.
- lu_sscp_stats.cur_rcv_pac_win
- This field will always be set to zero.
- lu_sscp_stats.send_data_frames
- Number of normal flow data frames sent.
- lu_sscp_stats.send_fmd_data_frames
- Number of normal flow FMD data frames sent.
- lu_sscp_stats.send_data_bytes
- Number of normal flow data bytes sent.
- lu_sscp_stats.rcv_data_frames
- Number of normal flow data frames received.
- lu_sscp_stats.rcv_fmd_data_frames
- Number of normal flow FMD data frames received.
- lu_sscp_stats.rcv_data_bytes
- Number of normal flow data bytes received.
- lu_sscp_stats.sidh
- Session ID high byte.
- lu_sscp_stats.sidl
- Session ID low byte.
- lu_sscp_stats.odai
- Origin destination address indicator. When bringing up a session, the sender of the ACTLU sets this field to zero if the local node contains the primary link station, and sets it to 1 if the ACTLU sender is the node containing the secondary link station.
- lu_sscp_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 this session with the link over which the session flows.
- lu_sscp_stats.pacing_type
- Receiving pacing type in use on the LU-SSCP session. This will take the value AP_NONE.
- plu_stats.rcv_ru_size
- Maximum receive RU size.
- plu_stats.send_ru_size
- Maximum send RU size.
- plu_stats.max_send_btu_size
- Maximum BTU size that can be sent.
- plu_stats.max_rcv_btu_size
- Maximum BTU size that can be received.
- plu_stats.max_send_pac_win
- Maximum size of the send pacing window on this session.
- plu_stats.cur_send_pac_win
- Current size of the send pacing window on this session.
- plu_stats.max_rcv_pac_win
- Maximum size of the receive pacing window on this session.
- plu_stats.cur_rcv_pac_win
- Current size of the receive pacing window on this session.
- plu_stats.send_data_frames
- Number of normal flow data frames sent.
- plu_stats.send_fmd_data_frames
- Number of normal flow FMD data frames sent.
- plu_stats.send_data_bytes
- Number of normal flow data bytes sent.
- plu_stats.rcv_data_frames
- Number of normal flow data frames received.
- plu_stats.rcv_fmd_data_frames
- Number of normal flow FMD data frames received.
- plu_stats.rcv_data_bytes
- Number of normal flow data bytes received.
- plu_stats.sidh
- Session ID high byte.
- plu_stats.sidl
- Session ID low byte.
- plu_stats.odai
- Origin destination address indicator. When bringing up a session, the sender of the ACTLU sets this field to zero if the local node contains the primary link station, and sets it to 1 if the ACTLU sender is the node containing the secondary link station.
- plu_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 this session with the link over which the session flows.
- plu_stats.pacing_type
- Receiving pacing type in use on the PLU-SLU session. This will take the value AP_NONE or AP_PACING_FIXED.
- sscp_id
- This is a 6–byte field containing the SSCP ID received in the
ACTPU for the PU used by this LU.
If lu_sscp_sess_active is not AP_YES, then this field will be zeroed.