MDS_MU_RECEIVED

This verb indication is sent by management services to a registered MDS-level application when:
  • An MDS_MU has been received from a peer MDS-level application
  • An NMVT has been received, and
    • an appropriate NMVT-level application has not registered
    • The MDS-level application registered with a name that corresponds to the name carried within the management services major vector key in the incoming NMVT (management services performs the conversion from NMVT to MDS_MU).

VCB Structure

typedef struct ms_mds_mu_received
{
   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    first_message;    /* First message for curr MDS_MU */
   unsigned char    last_message;     /* Last message for curr MDS_MU  */
   unsigned char    pu_name[8];       /* Physical unit name            */
   unsigned char    reserv3[8];       /* reserved                      */
   unsigned short   mds_mu_length;    /* Length of incoming MDS_MU     */
   unsigned char    *mds_mu;          /* MDS_MU data                   */
} MS_MDS_MU_RECEIVED;

Supplied Parameters

opcode
AP_MDS_MU_RECEIVED
format
Identifies the format of the VCB. This field is set to zero to specify the version of the VCB listed above.
first_message
Flag indicating whether this is the first message for the MDS_MU (AP_YES or AP_NO). If the max_rcv_size specified in the WinMSRegisterApplication call is smaller than the length of the MDS_MU being delivered, the MDS_MU will be sent to the application in chunks.
last_message
Flag indicating whether this is the last message for the MDS_MU (AP_YES or AP_NO).
pu_name
Name of the physical unit from which the NMVT (which has been converted to an MDS_MU) originated. It is the responsibility of the application to respond to the incoming NMVT. The application uses SEND_MDS_MU to send the response. When sending responses the application must set the pu_name field of the SEND_MDS_MU to the pu_name supplied in the MDS_MU_RECEIVED signal. If the MDS_MU was received from the MDS level transport mechanism, the pu_name will be set to all binary zeros.
mds_mu_length
Length of MDS_MU portion included with the signal.
mds_mu
MDS_MU data. The data pointer is set to NULL, and the data is contiguous with (and begins immediately following) the VCB.