HP-UX SNAplus2 R7 NOF Programmer's Guide

ManualsBrandsHP ManualsSoftwareHP-UX SNAplus2 Software

741

742

743

744

745

746

747

748

749

750

NOF API Verbs

UNREGISTER_INDICATION_SINK

opcode

AP_TERM_NODE

stop_type

Speciﬁes how SNAplus2 should stop the node. Possible values are:

AP_ABORT

Stop immediately without attempting any cleanup processing. This value should be used only in serious

error conditions, because it may cause problems for other programs using the node’s resources.

AP_SHUTDOWN

Deactivate all LSs associated with the node before stopping.

AP_QUIESCE

Indicate to the network that the node is quiesced, reset session limits on all modes, unbind all endpoint

sessions for the node’s LUs, and then stop as for AP_SHUTDOWN.

AP_QUIESCE_ISR

Same functions as AP_QUIESCE, except that the node waits for all intermediate sessions to end. This

value applies only to network nodes.

AP_DEACT_CLEAN

Same functions as AP_QUIESCE, except that session limits are not reset and RTP connections are

allowed to terminate gracefully before the LSs are deactivated.

3.193.3 Returned Parameters: Successful Execution

If the verb executes successfully, SNAplus2 returns the following parameters:

primary_rc

AP_OK

3.193.4 Returned Parameters: Other Conditions

Appendix B, Common Return Codes lists further combinations of primary and secondary return codes that are

common to all NOF verbs.

3.194 UNREGISTER_INDICATION_SINK

UNREGISTER_INDICATION_SINK unregisters the NOF application so that it no longer receives indications of a

particular type (previously speciﬁed using REGISTER_INDICATION_SINK).

If the application has registered more than once to accept multiple indication types, it must unregister separately

for each indication that it no longer wants to receive.

This verb must always be issued using the asynchronous NOF API entry point, including the callback routine that

was supplied on the REGISTER_INDICATION_SINK verb (for more information about the asynchronous NOF

API entry point, see Section 2.1.1, NOF API Entry Points for HP-UX).

This verb may be issued to the domain conﬁguration ﬁle, to a running node or to a server where the node is not

running, or to the sna.net ﬁle, depending on the type of indication for which the application is unregistering.

750