NMVT_RECEIVED

This verb signal is sent by management services to a registered NMVT-level application when an NMVT is received from a remote node.

In routing incoming NMVTs, management services applies the following rules:
  1. Try to route to an NMVT-level application registered with the major vector key carried on the incoming NMVT, else...
  2. If the major vector key is one of X'8061' through X'8064', try to route to a registered NMVT-level AP_SPCF_KEYS application, else...
  3. Try to route to an NMVT-level registered AP_ALL_KEYS application, else...
  4. Try to route the NMVT (after conversion to an MDS_MU) to an MDS-level application, registered with the major vector key carried on the incoming NMVT, else...
  5. If the major vector key is one of X'8061' through X'8064', try to route the NMVT (after conversion to an MDS_MU) to a registered MDS-level application, else...
  6. Try to route (after conversion to an MDS_MU) to a registered AP_ALL_KEYS MDS-level application, else...
  7. Negatively respond to the NMVT.

VCB Structure

typedef struct ms_nmvt_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    pu_name[8];         /* Physical unit name          */
   unsigned char    reserv3[6];         /* reserved                    */
   unsigned short   nmvt_length;        /* Length of incoming NMVT     */
   unsigned char    *nmvt;              /* NMVT data                   */
} MS_NMVT_RECEIVED;

Supplied Parameters

opcode
AP_NMVT_RECEIVED
format
Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
pu_name
Name of the physical unit from which the NMVT originated. It is the responsibility of the application to respond to the incoming NMVT. The application uses TRANSFER_MS_DATA to send the response. When sending responses, the application must set the pu_name field of the TRANSFER_MS_DATA to the pu_name supplied in the NMVT_RECEIVED signal.
nmvt_length
Length of NMVT data.
nmvt
Full NMVT, containing management services major vector of the types specified on the REGISTER_NMVT_APPLICATION. This data pointer is set to NULL, and the data is contiguous with (and begins immediately following) the VCB.