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_VISIBLE

If 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.