//File: EPIRPSystem.idl
#ifndef _EP_IRP_SYSTEM_IDL_
#define _EP_IRP_SYSTEM_IDL_

#include <ManagedGenericIRPConstDefs.idl>
#include <ManagedGenericIRPSystem.idl>
#include <EPIRPConstDefs.idl>

// This statement must appear after all include statements
#pragma prefix "3gppsa5.org"

/* ## Module: EPIRPSystem
*/
module EPIRPSystem
{
   exception InvalidIRPVersion { string reason; };
   exception UnknownIRPReference { string reason; };

   /*
   System fails to complete the operation. System can provide reason
   to qualify the exception. The semantics carried in reason
   is outside the scope of this IRP.
   */
   exception GetIRPOutline { string reason; };
   exception GetIRPReference { string reason; };
   exception ReleaseIRPReference { string reason; };
   exception GetEPIRPVersions { string reason; };
   exception GetEPIRPOperationsProfile { string reason; };
   exception GetEPIRPNotificationProfile { string reason; };

   interface EPIRP
   {
      /**
      * The IRPManager uses this operation to request the EPIRP to
      * return the outline information of the supported IRPs. The EPIRP
      * shall return the outline information of all the IRPs supported by the
      * IRPAgent that contains the EPIRP. The EPIRP may
      * additionally return the outline information of all the IRPs supported
      * by other IRPAgents.
      */
      EPIRPConstDefs::Result get_irp_outline(
         in ManagedGenericIRPConstDefs::VersionNumber irp_version,
         out EPIRPConstDefs::SupportedIRPList supported_irp_list
      )
      raises (GetIRPOutline, InvalidIRPVersion);

      /**
      * The IRPManager uses this operation to request the EPIRP to return
      * the stringified IOR of the IRP identified by system_dn and irp_id.
      */
      EPIRPConstDefs::Result get_irp_reference(
         in EPIRPConstDefs::ManagerIdentifier manager_identifier,
         in EPIRPConstDefs::DN system_dn,
         in EPIRPConstDefs::IRPId irp_id,
         out string irp_reference
      )
      raises (GetIRPReference,
              ManagedGenericIRPSystem::InvalidParameter);

      /**
      * The IRPManager uses this operation to request the IRPAgent to
      * release a specific IRP reference. Whether the IRP reference
      * is really released or not in the IRPAgent is outside the
      * scope of this document.
      */
      EPIRPConstDefs::Result release_irp_reference(
         in EPIRPConstDefs::ManagerIdentifier manager_identifier,
         in string irp_reference
      )
      raises (ReleaseIRPReference,
              UnknownIRPReference);

      /**
      * Return the list of all supported EPIRP versions.
      */
      ManagedGenericIRPConstDefs::VersionNumberSet get_ep_irp_versions (
      )
      raises (GetEPIRPVersions);

      /**
      * Return the list of all supported operations and their supported
      * parameters for a specific EPIRP version.
      */
      ManagedGenericIRPConstDefs::MethodList get_ep_irp_operations_profile (
         in ManagedGenericIRPConstDefs::VersionNumber irp_version
      )
      raises (GetEPIRPOperationsProfile,
              ManagedGenericIRPSystem::OperationNotSupported,
              ManagedGenericIRPSystem::InvalidParameter);

      /**
      * Return the list of all supported notifications and their supported
      * parameters for a specific EPIRP version.
      */
      ManagedGenericIRPConstDefs::MethodList get_ep_irp_notification_profile
      (
         in ManagedGenericIRPConstDefs::VersionNumber irp_version
      )
      raises (GetEPIRPNotificationProfile,
              ManagedGenericIRPSystem::OperationNotSupported,
              ManagedGenericIRPSystem::InvalidParameter);
   };

};

#endif // _EP_IRP_SYSTEM_IDL_