Description :

    To be used by DIM clients - implements RPC subscription (blocking or non-blocking)
        Required Parameters: the Service Name and the value (nolink) to receive when RPC service not available
    The methods set() and get() are used to send and receive data to and from the server.
    Please refer to Usage for examples on how to use DimRpcInfo.

Constructors :

• public DimRpcInfo ( char * name, int nolink) ; Integer reception expected
• public DimRpcInfo ( char * name, float nolink) ;
• public DimRpcInfo ( char * name, double nolink) ;
• public DimRpcInfo ( char * name, short nolink) ;
• public DimRpcInfo ( char * name, longlong nolink) ;
• public DimRpcInfo ( char * name, char * nolink) ;
• public DimRpcInfo ( char * name, void * nolink, int nolinksize) ; Complex data
   
• public DimRpcInfo ( char * name, int timeout, int nolink) ; With timeout
• public DimRpcInfo ( char * name, int timeout, float nolink) ;
• public DimRpcInfo ( char * name, int timeout, short nolink) ;
• public DimRpcInfo ( char * name, int timeout, longlong nolink) ;
• public DimRpcInfo ( char * name, int timeout, double nolink) ;
• public DimRpcInfo ( char * name, int timeout, char * nolink) ;
• public DimRpcInfo ( char * name, int timeout, void * nolink, int nolinksize) ;

• public ~ DimRpcInfo ( ) ;

   Set Methods: To be used  to send the RPC request (data) to the Server 

• void setData ( int &value) ; //Send an Integer
• void setData ( float &value) ;
• void setData ( double &value) ;
• void setData ( short &value) ;
• void setData ( longlong &value) ;
• void setData ( char * string) ;
• void setData ( void *data, int size); //Send complex data

• virtual void rpcInfoHandler ( ) ; // Can be provided by the user for non-blocking reception of RPCs

• int getInt ( ) ; // Get an Integer
• float getFloat ( ) ;
• double getDouble ( );
• short getShort ( );
• longlong getLonglong ( );
• char *getString ( );
• int getSize ( ); //Get the size of the data (for complex types)
• void *getData ( ); //Get the data (for complex types)

    DimRpcInfo non-blocking example:

        #include "dic.hxx"

        class Rpc : public DimRpcInfo
        {
            void rpcInfoHandler() {
                int valin;
                valin = getInt();
                cout << "Callback RPC Received : " << valin << endl;
        }
        public:
            Rpc(char *name) : DimRpcInfo(name, -1) { };
        };

        main()
        {
             int rpcCBValue = 0;
             Rpc rpcCB("TESTRPC/INT");
 
             while(1)
             {
                    rpcCB.setData(rpcCBValue);
                    sleep(5);
             }
        }

    DimRpcInfo non-blocking example with timeout:
    //When/if the timeout fires the handler will be called with the nolink value as contents 

        #include "dic.hxx"

        class Rpc : public DimRpcInfo
        {
            void rpcInfoHandler() {
                int valin;
                valin = getInt();
                cout << "Callback RPC Received : " << valin << endl;
        }
        public:
            Rpc(char *name, int timeout) : DimRpcInfo(name, timeout, -1) { };
        };

        main()
        {
             int rpcCBValue = 0;
             Rpc rpcCB("TESTRPC/INT", 10);
 
             while(1)
             {
                    rpcCB.setData(rpcCBValue);
                    sleep(5);
             }
        }

    DimRpcInfo blocking example:

        #include "dic.hxx"

        main()
        {
             int rpcValue = 0;
             DimRpcInfo rpc("TESTRPC/INT",-1);

             while(1)
             {
                  rpc.setData(rpcValue);
                  rpcValue = rpc.getInt();
                  sleep(5);
            }
        }