DOWNSTREAM_LU_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 the LU-SSCP session between the downstream LU and the host goes from inactive to active (or vice-versa) or when the PLU-SLU session goes from inactive to active (or vice-versa). LU-SSCP statistics are supplied when the LU-SSCP session deactivates and PLU-SLU statistics are supplied when the PLU-SLU session deactivates.

VCB Structure

typedef struct downstream_lu_indication
{
   unsigned short  opcode;                /* verb operation code           */
   unsigned char   attributes;            /* attributes                    */
   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   dspu_name[8];          /* PU Name                       */
   unsigned char   ls_name[8];            /* Link station name             */
   unsigned char   dslu_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   plu_sess_active;       /* Is PLU-SLU session active?    */
   unsigned char   dspu_services;         /* DSPU services                 */
   unsigned char   reserv1;               /* reserved                      */
   SESSION_STATS   lu_sscp_stats;         /* LU-SSCP session statistics    */
   SESSION_STATS   ds_plu_stats;          /* Downstream PLU-SLU sess stats */
   SESSION_STATS   us_plu_stats;          /* Upstream PLU-SLU sess stats   */
} DOWNSTREAM_LU_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;      /* curr send pacing window size  */
   unsigned short  max_rcv_pac_win;       /* max rcv pacing window size    */
   unsigned short  cur_rcv_pac_win;       /* curr receive pacing win size  */
   unsigned long   send_data_frames;      /* number of data frames sent    */
   unsigned long   send_fmd_data_frames;
                                          /* num 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;        /* 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

opcode
AP_DOWNSTREAM_LU_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

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.
dspu_name
Name of the downstream PU associated with the downstream LU. This is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces.
ls_name
Name of link station. This is an 8-byte string in a locally displayable character set. All 8 bytes are significant and must be set.
dslu_name
Name of the downstream LU. 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_DOWNSTREAM_LU).
nau_address
Network addressable unit address of the LU which must be in the range 1–255.
lu_sscp_sess_active
Indicates whether the LU-SSCP session to the downstream LU is active. Set to either AP_YES or AP_NO.
plu_sess_active
Indicates whether the PLU-SLU session to the downstream LU is active. Set to either AP_YES or AP_NO.
dspu_services
Specifies the services which the local node provides to the downstream LU across the link. This is set to one of the following.
AP_PU_CONCENTRATION
Local node provides PU concentration for the downstream PU.
AP_DLUR
Local node provides DLUR support for the downstream PU.
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 BIND sets this field to zero if the local node contains the primary link station, and sets it to 1 if the BIND 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.
lu_sscp_stats.pacing_type
Receive pacing type in use on the upstream LU-SSCP session. This will take the value AP_NONE.
ds_plu_stats.rcv_ru_size
Maximum receive RU size.
ds_plu_stats.send_ru_size
Maximum send RU size.
ds_plu_stats.max_send_btu_size
Maximum BTU size that can be sent.
ds_plu_stats.max_rcv_btu_size
Maximum BTU size that can be received.
ds_plu_stats.max_send_pac_win
Maximum size of the send pacing window on this session.
ds_plu_stats.cur_send_pac_win
Current size of the send pacing window on this session
ds_plu_stats.max_rcv_pac_win
Maximum size of the receive pacing window on this session.
ds_plu_stats.cur_rcv_pac_win
Current size of the receive pacing window on this session.
ds_plu_stats.send_data_frames
Number of normal flow data frames sent.
ds_plu_stats.send_fmd_data_frames
Number of normal flow FMD data frames sent.
ds_plu_stats.send_data_bytes
Number of normal flow data bytes sent.
ds_plu_stats.rcv_data_frames
Number of normal flow data frames received.
ds_plu_stats.rcv_fmd_data_frames
Number of normal flow FMD data frames received.
ds_plu_stats.rcv_data_bytes
Number of normal flow data bytes received.
ds_plu_stats.sidh
Session ID high byte.
ds_plu_stats.sidl
Session ID low byte.
ds_plu_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, and sets it to 1 if the BIND sender is the node containing the secondary link station.
ds_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.
ds_plu_sscp_stats.pacing_type
Receive pacing type in use on the downstream PLU-SLU session. This can be set to AP_NONE or AP_PACING_FIXED.
us_plu_stats.rcv_ru_size
Maximum receive RU size.
us_plu_stats.send_ru_size
Maximum send RU size.
us_plu_stats.max_send_btu_size
Maximum BTU size that can be sent.
us_plu_stats.max_rcv_btu_size
Maximum BTU size that can be received.
us_plu_stats.max_send_pac_win
Maximum size of the send pacing window on this session.
us_plu_stats.cur_send_pac_win
Current size of the send pacing window on this session
us_plu_stats.max_rcv_pac_win
Maximum size of the receive pacing window on this session.
us_plu_stats.cur_rcv_pac_win
Current size of the receive pacing window on this session.
us_plu_stats.send_data_frames
Number of normal flow data frames sent.
us_plu_stats.send_fmd_data_frames
Number of normal flow FMD data frames sent.
us_plu_stats.send_data_bytes
Number of normal flow data bytes sent.
us_plu_stats.rcv_data_frames
Number of normal flow data frames received.
us_plu_stats.rcv_fmd_data_frames
Number of normal flow FMD data frames received.
us_plu_stats.rcv_data_bytes
Number of normal flow data bytes received.
us_plu_stats.sidh
Session ID high byte. This field is reserved if dspu_services is set to AP_PU_CONCENTRATION.
us_plu_stats.sidl
Session ID low byte. This field is reserved if dspu_services is set to AP_PU_CONCENTRATION.
us_plu_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, and sets it to 1 if the BIND sender is the node containing the secondary link station. This field is reserved if dspu_services is set to AP_PU_CONCENTRATION.
us_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 is reserved if dspu_services is set to AP_PU_CONCENTRATION.
us_plu_stats.pacing_type
Receive pacing type in use on the upstream PLU-SLU session. This can take the values AP_NONE or AP_PACING_FIXED.