|
|
|
|
SNAP-IX sends this status indication to a registered application (either MDS-level or NMVT-level) to inform the application of one of the following changes in the status of the SNAP-IX system:
The application's communications path to the SNAP-IX local node has been lost because the connected node or an associated component is no longer active.
The SNAP-IX software has been stopped.
SNAP-IX returns the MS_STATUS indication on the callback routine that the application supplied to the REGISTER_MS_APPLICATION or REGISTER_NMVT_APPLICATION verb. For more information about the requirements for this callback routine, see The Callback Routine Specified on the ms_async Entry Point.
After the application receives the MS_STATUS indication, SNAP-IX rejects all subsequent verbs using the relevant target handle, except for DISCONNECT_MS_NODE.
typedef struct ms_status
{
AP_UINT16 opcode; /* Verb operation code */
unsigned char reserv2; /* reserved */
unsigned char format; /* reserved */
AP_UINT16 primary_rc; /* Primary return code */
AP_UINT32 secondary_rc; /* Secondary return code */
AP_UINT32 status; /* status being reported */
AP_UINT32 dead_target_handle; /* Handle of dead connection */
unsigned char reserv1[32]; /* reserved */
} MS_STATUS;
SNAP-IX includes the following parameters when it sends the MS_STATUS indication to the MS application:
This value indicates that the connected node or the SNAP-IX software is no longer running.
A null value for this parameter indicates that the SNAP-IX software on the local computer (where the application is running) has been stopped. All target handles that the application was using are disconnected and are no longer valid.
A non-null value for this parameter indicates the target handle of the failed node. The application should issue DISCONNECT_MS_NODE for this target handle to free the resources associated with it.
The application can attempt to reconnect to a target node by periodically issuing CONNECT_MS_NODE; this call will fail until the target node or the local SNAP-IX software is restarted.
|
|
|
 |
|