8.4 State Transition Diagrams

29.198-033GPPOpen Service Access (OSA) Application Programming Interface (API)Part 3: FrameworkTS

This clause contains the State Transition Diagrams for the objects that implement the Framework interfaces on the gateway side. The State Transition Diagrams show the behaviour of these objects. For each state the methods that can be invoked by the client are shown. Methods not shown for a specific state are not relevant for that state and will return an exception. Apart from the methods that can be invoked by the client also events internal to the gateway or related to network events are shown together with the resulting event or action performed by the gateway. These internal events are shown between quotation marks.

8.4.1 Service Registration State Transition Diagrams

8.4.1.1 State Transition Diagrams for IpFwServiceRegistration

Figure : State Transition Diagram for IpFwServiceRegistration

8.4.1.1.1 SCF Registered State

This is the state entered when a Service Capability Server (SCS) registers its SCF in the Framework, by informing it of the existence of an SCF characterised by a service type and a set of service properties. As a result the Framework associates a service ID to this SCF, that will be used to identify it by both sides.

An SCF may be unregistered, the service ID then being no longer associated with the SCF.

8.4.1.1.2 SCF Announced State

This is the state entered when the existence of the SCF has been announced, thus making it available for discovery by applications. The SCF can be unannounced at any time, taking it back into the SCF Registered state where it is no longer available for discovery.

8.4.2 Service Instance Lifecycle Manager State Transition Diagrams

There are no State Transition Diagrams defined for Service Instance Lifecycle Manager

8.4.3 Service Discovery State Transition Diagrams

There are no State Transition Diagrams defined for Service Discovery

8.4.4 Integrity Management State Transition Diagrams

8.4.4.1 State Transition Diagrams for IpFwLoadManager

Figure : State Transition Diagram for IpFwLoadManager

8.4.4.1.1 Idle State

In this state the service has obtained an interface reference of the LoadManager from the IpAccess interface.

8.4.4.1.2 Notification Suspended State

Due to e.g. a temporary load condition, the service has requested the LoadManager to suspend sending the load level notification information.

8.4.4.1.3 Active State

In this state the service has indicated its interest in notifications by performing a createLoadLevelNotification() invocation on the IpFwLoadManager. The load manager can now request the service to supply load statistics information (by invoking querySvcLoadStatsReq()). Furthermore the LoadManager can request the service to control its load (by invoking loadLevelNotification(), resumeNotification() or suspendNotification() on the service side of interface). In case the service detects a change in load level, it reports this to the LoadManager by calling the method reportLoad().

8.4.4.2 State Transition Diagrams for IpFwFaultManager

Figure : State Transition Diagram for IpFwFaultManager

8.4.4.2.1 Framework Active State

This is the normal state of the framework, which is fully functional and able to handle requests from both applications and service capability features.

8.4.4.2.2 Framework Activity Test State

In this state, the framework is performing a self-diagnostic test. If a problem is diagnosed, all services with fault management callbacks are notified through an fwAvailStatusInd message.

8.4.4.2.3 Application Activity Test State

In this state, the framework is performing a test on one client application. If the application is faulty, services that are used by the application and that have provided fault management callbacks are notified accordingly through an appAvailStatusInd message.

8.4.4.2.4 Framework Faulty State

In this state, the framework has detected an internal problem with itself such that application and service capability features cannot communicate with it anymore; attempts to invoke any methods that belong to any SCFs of the framework return an error. If the framework ever recovers, services with fault management callbacks will be notified via a fwAvailStatusInd message.

8.4.5 Event Notification State Transition Diagrams

There are no State Transition Diagrams defined for Event Notification