|
|
|
|
The UNREGISTER_MS_APPLICATION verb indicates to SNAP-IX that this application, which previously registered to receive MDS_MUs, no longer wants to receive them. After this verb completes successfully, SNAP-IX no longer sends any received MDS_MUs to the application.
Before terminating, an application should always issue UNREGISTER_MS_APPLICATION for all its registered application names, followed by DISCONNECT_MS_NODE.
typedef struct unregister_ms_application
{
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 */
unsigned char ms_appl_name[8]; /* MS application name */
} UNREGISTER_MS_APPLICATION;
The application supplies the following parameters when it issues UNREGISTER_MS_APPLICATION:
AP_UNREGISTER_MS_APPLICATION
The name identifying the application that is unregistering. This must be a name that the application has previously specified using REGISTER_MS_APPLICATION. The string must be eight characters long; pad on the right with EBCDIC space characters (0x40) if necessary.
After the verb executes, SNAP-IX returns parameters to indicate whether the execution was successful and, if not, to indicate the reason the execution was not successful.
If the verb executes successfully, SNAP-IX returns the following parameter:
AP_OK
SNAP-IX does not return a secondary_rc when the verb executes successfully.
When a verb does not execute successfully, SNAP-IX returns a primary return code to indicate the type of error and a secondary return code to provide specific details about the reason for unsuccessful execution.
If the verb does not execute because of a parameter error, SNAP-IX returns the following parameters:
AP_PARAMETER_CHECK
One of the following:
The supplied target handle was not a valid value returned on a previous CONNECT_MS_NODE verb.
The application has not previously issued REGISTER_MS_APPLICATION with the application name specified on this verb.
If the verb fails to execute because of a state error, SNAP-IX returns the following parameters:
AP_STATE_CHECK
One of the following:
The application issued this verb while CONNECT_MS_NODE or DISCONNECT_MS_NODE was outstanding.
This verb was issued using the synchronous entry point, but another synchronous verb was in progress for this target handle. Only one synchronous verb can be in progress on a particular target handle at any time.
The application used the synchronous MS entry point to issue this verb within a callback routine. The application must use the asynchronous entry point to issue any verb from a callback routine.
If the verb does not execute because the SNAP-IX software is not active, SNAP-IX returns the following parameter:
The SNAP-IX software has failed.
SNAP-IX does not return a secondary_rc when the SNAP-IX software is not active.
If the verb does not execute because the SNAP-IX configuration does not allow it, SNAP-IX returns the following parameter:
The SNAP-IX local node is not configured to support MDS-level network management applications. Only NMVT-level applications can be used.
SNAP-IX does not return a secondary_rc when it is not configured for MDS-LEVEL support.
If the verb does not execute because of a system error, SNAP-IX returns the following parameters:
An operating system call failed during processing of the verb.
The return code from the operating system call. For the meaning of this return code, check the returned value in the file /usr/include/sys/errno.h .
|
|
|
 |
|