Next: , Up: Description of the Middleware API


7.4.1 API to manipulate PolyORB

7.4.1.1 ARAO.Obj_Adapters

This package defines the following subprograms:

Link_To_Obj_Adapter: This procedure performs the link between the object reference (used by a client to send a request) and the servant who does the job specified by the request. This procedure assumes that the middlware is correctly set up and that a object adapter is created.

     procedure Link_To_Obj_Adapter
          (T_Object :     PolyORB.Servants.Servant_Access;
           Ref      : out PolyORB.References.Ref);
7.4.1.2 ARAO.RT_Obj_Adapters

This package defines the following subprograms:

Link_To_Obj_Adapter: This procedure performs the link between the object reference (used by a client to send a request) and the servant who does the job specified by the request. This procedure assumes that the middlware is correctly set up and that a real-time object adapter is created for that Servant (instead of for the whole node as in ARAO.Obj_Adapter).

     procedure Link_To_Obj_Adapter
          (T_Object   : PolyORB.Servants.Servant_Access;
           Ref        : out PolyORB.References.Ref;
           Thread_Name : Standard.String;
           Priority   : Integer := System.Default_Priority);
7.4.1.3 ARAO.Periodic_Threads

This package defines the following subprograms:

Create_Periodic_Thread: This procedure creates a periodic thread. The fact that the thread is periodic is handled in the TP procedure. Also, we assume that the PolyORB thread pool was properly created during the setup phase. Storage_size 0 is default size (not really 0 bit).

     procedure Create_Periodic_Thread
          (TP           : Parameterless_Procedure;
           Priority     : System.Any_Priority := System.Default_Priority;
           Storage_Size : Integer := 0);
7.4.1.4 ARAO.Requests

This package defines the following subprograms:

Emit_Msg: This procedure creates a request whose target is the reference Ref. The PortName argument is used to distinguish the different port of one single thread. The data sent by the request (Item) must be of og the PolyORB neutral type (Any).

     procedure Emit_Msg
          (Item     : PolyORB.Any.Any;
           Ref      : PolyORB.References.Ref;
           PortName : String);
7.4.1.5 ARAO.Utils

This package defines the following subprograms:

Put_Ref: Put the IOR reference Ref in the file called Filename

     procedure Put_Ref
          (Ref      : PolyORB.References.Ref;
           Filename : String);

Get_Ref: Get the IOR reference Ref from the file called Filename

     procedure Get_Ref
          (Ref      : in out PolyORB.References.Ref;
           Filename :        String);

Get_Ref: Get the reference Ref from the properties of the remote servants.

     procedure Get_Ref
          (Ref           : in out PolyORB.References.Ref;
           Host_Location : String;
           Port_Number   : Positive;
           Servant_Index : Natural;
           Protocol      : String);

Get_GIOP_Ref: Get the reference Ref from the properties of the remote servants for IIOP profiles.

     procedure Get_GIOP_Ref
          (Ref           : in out PolyORB.References.Ref;
           Ior_Ref       : String);