DLUS_INDICATION

This indication is generated when a pipe to a DLUS node goes from inactive to active (or vice versa). Pipe statistics are supplied when the pipe becomes inactive.

VCB Structure

typedef struct dlus_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 session been deactivated?   */
   unsigned char   dlus_name[17];       /* DLUS name                       */
   unsigned char   reserv1;             /* reserved                        */
   PIPE_STATS      pipe_stats;          /* pipe statistics                 */
   unsigned char   reserva[20];         /* reserved                        */
} DLUS_INDICATION;

typedef struct pipe_stats
{
   unsigned long   reqactpu_sent;       /* REQACTPUs sent to DLUS          */
   unsigned long   reqactpu_rsp_received;
                                        /* RSP(REQACTPU)s received         */
                                        /* from DLUS                       */
   unsigned long   actpu_received;      /* ACTPUs received from DLUS       */
   unsigned long   actpu_rsp_sent;      /* RSP(ACTPU)s sent to DLUS        */
   unsigned long   reqdactpu_sent;      /* REQDACTPUs sent to DLUS         */
   unsigned long   reqdactpu_rsp_received;
                                        /* RSP(REQDACTPU)s received        */
                                        /* from DLUS                       */
   unsigned long   dactpu_received;     /* DACTPUs received from DLUS      */
   unsigned long   dactpu_rsp_sent;     /* RSP(DACTPU)s sent to DLUS       */
   unsigned long   actlu_received;      /* ACTLUs received from DLUS       */
   unsigned long   actlu_rsp_sent;      /* RSP(ACTLU)s sent to DLUS        */
   unsigned long   dactlu_received;     /* DACTLUs received from DLUS      */
   unsigned long   dactlu_rsp_sent;     /* RSP(DACTLU)s sent to DLUS       */
   unsigned long   sscp_pu_mus_rcvd;    /* MUs for SSCP-PU sess received   */
   unsigned long   sscp_pu_mus_sent;    /* MUs for SSCP-PU sessions sent   */
   unsigned long   sscp_lu_mus_rcvd;    /* MUs for SSCP-LU sess received   */
   unsigned long   sscp_lu_mus_sent;    /* MUs for SSCP-LU sessions sent   */
} PIPE_STATS;

Parameters

opcode: AP_DLUS_INDICATION
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.
deactivated: Set to AP_YES when the pipe becomes inactive. Set to AP_NO when the pipe becomes active.
dlus_name: Name of the DLUS. This is a 17-byte string composed of two type-A EBCDIC character strings concatenated by an EBCDIC dot, which is right-padded with EBCDIC spaces. (Each name can have a maximum length of 8 bytes with no embedded spaces.)
pipe_stats.reqactpu_sent: Number of REQACTPUs sent to DLUS over the pipe.
pipe_stats.reqactpu_rsp_received: Number of RSP(REQACTPU)s received from DLUS over the pipe.
pipe_stats.actpu_received: Number of ACTPUs received from DLUS over the pipe.
pipe_stats.actpu_rsp_sent: Number of RSP(ACTPU)s sent to DLUS over the pipe.
pipe_stats.reqdactpu_sent: Number of REQDACTPUs sent to DLUS over the pipe.
pipe_stats.reqdactpu_rsp_received: Number of RSP(REQDACTPU)s received from DLUS over the pipe.
pipe_stats.dactpu_received: Number of DACTPUs received from DLUS over the pipe.
pipe_stats.dactpu_rsp_sent: Number of RSP(DACTPU)s sent to DLUS over the pipe.
pipe_stats.actlu_received: Number of ACTLUs received from DLUS over the pipe.
pipe_stats.actlu_rsp_sent: Number of RSP(ACTLU)s sent to DLUS over the pipe.
pipe_stats.dactlu_received: Number of DACTLUs received from DLUS over the pipe.
pipe_stats.dactlu_rsp_sent: Number of RSP(DACTLU)s sent to DLUS over the pipe.
pipe_stats.sscp_pu_mus_rcvd: Number of SSCP-PU MUs received from DLUS over the pipe.
pipe_stats.sscp_pu_mus_sent: Number of SSCP-PU MUs sent to DLUS over the pipe.
pipe_stats.sscp_lu_mus_rcvd: Number of SSCP-LU MUs received from DLUS over the pipe.
pipe_stats.sscp_lu_mus_sent: Number of SSCP-LU MUs sent to DLUS over the pipe.