9.57.1 Nokia IACC Agent Overview

The Nokia IACC agent in combination with Analysis agents receives requests and sends responses over a CORBA connection. The requests are turned into UDRs by the NokiaIACC agent and are inserted into a workflow.

When a workflow is activated, the NokiaIACC agent opens a port and waits for requests. The workflow remains active until manually stopped.

CORBA Naming Service

The Nokia IACC agent is dependent on a CORBA naming service - the CORBA COS (Common Object Services) Naming Service. For an application to use the COS Naming Service, its ORB must know the port of the naming service and the host it is running on.

The orbd supplied with JDK could be used. The Object Request Broker Daemon orbd is used as the naming service to enable clients to transparently locate and invoke objects on the Nokia IACC agent in the CORBA environment.

The ORBInitialPort argument is a required argument for orbd, and is used to set the port number on which the Naming Service will run.

When orbd starts up, it also starts a Naming Service. A Naming Service is a CORBA service that allows CORBA objects to be named by means of binding a name to an object reference. The name binding may be stored in the naming service, and a client may supply the name to obtain the desired object reference.

The root user must be used in order to start a process on a port under 1024. For this reason, is is recommended to use a port number greater than or equal to 1024. A different port can be substituted if necessary.

To start orbd from a UNIX command shell:

$JAVA_HOME/bin/orbd -ORBInitialPort 1050&

From an MS-DOS system prompt (Windows):

start orbd -ORBInitialPort 1050

IACC-Methods vs. UDRs

The NokiaIACC agent supplies three IACC-methods to the workflow: hasCredit2commitReservation2 and cancelReservation2.

The fourth IACC-method, isServerUp, is not supplied for the workflow. This method returns a string running to the calling client if the agent is up and does not have a UDR data representation.

IACC_UDR

The NokiaIACC agent retrieves data via the IACC-method call and produces one type of UDR; the IACC_UDR. The IACC UDR contains a request and a response field. These two fields are of type Subscribers_UDR.

IACC_UDR contains a request and a response field

Subscribers_UDR Types

The Subscribers_UDR can in turn be of type hasCredit_UDRcommitReservation_UDR or cancelReservation_UDR. The hasCredit_UDR has an additional field; operation.

Subscribers_UDR can be of type hasCredit2_UDRcommitReservation2_UDR or cancelReservation2_UDR

Subscribers_UDR

Each of these IACC- method UDRs has a list of Subscriber UDRs called subscribers. This list needs to be created in the APL code using listCreate. The Subscriber UDR has a list of OneAttribute_UDRs called attributes. This list needs to be created in the APL code using listCreate.


Subscribers_UDR has a list of Subscriber_UDRs that has a list of OneAttribute_UDRs

NokiaIACC Related UDR Types

The UDR types created by default in the NokiaIACC agent can be viewed in the UDR Internal Format Browser in the IACC folder. To open the browser open an APL Code Editor, in the editing area right-click and select  UDR Assistance... ; the browser opens.