UpdateProgramRelationships Method

Updates one or more Touchstone Re Reinsurance Program Relationships for a given Reinsurance Program.

A relationship defines the association between two Reinsurance Programs. Specifically, the relationship specifies which program inures to the benefit of the other program, the financial perspective of the association, and the relavant participation level. One reinsurance program may have many relationships.

For a given reinsurance program, you can use the GetAvailableProgramsToCreateProgramRelationships() method to retrieve a list of the programs that are valid potential sourcing or inuring programs for the specified program.

When you attempt to update the relationships for a program, note that:

You cannot include duplicate relationships in the request.
A program cannot be in a direct or hierarchical relationship with itself.
If the Contract Gain option is enabled for a given program, you cannot specify the program as a sourcing or inuring program (child) in a relationship.
You cannot create a relationship for programs in different companies unless one of the programs is an Assesment program.
An assessment program can be only a sourcing or inuring (child) program in a relationship, which means that:
- The relationship Perspective must be Contract.
- The Participation Amount must be between 0 and 1.
- The Participation must be One Hundred.
For an inuring relationship:
- The relationship Perspective must be Contract.
- The Participation Amount must be null.
- The Participation must be One Hundred.
For a sourcing relationship, if you set the Perspective to Net Retained, then:
- The Participation Amount must be 1.
- The Participation must be One Hundred.

Contains a UpdateProgramRelationshipsRequest that identifies the list of relationships to update as well as the Business Unit Sequential Identifier (SID), and SQL Instance SID, and Program SID associated with the relationships. A UpdateProgramRelationshipsResponse containing the list of relationships that you updated.

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#

Public Function UpdateProgramRelationships( _
   ByVal request As UpdateProgramRelationshipsRequest _
) As UpdateProgramRelationshipsResponse

Dim instance As ReinsuranceProgramManagementServiceClient
Dim request As UpdateProgramRelationshipsRequest
Dim value As UpdateProgramRelationshipsResponse
 
value = instance.UpdateProgramRelationships(request)

public UpdateProgramRelationshipsResponse UpdateProgramRelationships( 
   UpdateProgramRelationshipsRequest request
)

Parameters

request: Contains a UpdateProgramRelationshipsRequest that identifies the list of relationships to update as well as the Business Unit Sequential Identifier (SID), and SQL Instance SID, and Program SID associated with the relationships.

Return Value

A UpdateProgramRelationshipsResponse containing the list of relationships that you updated.

Remarks

To find the Business Unit SID to pass into this method, call the GetBusinessUnits() method.

To find the SQL Instance SID to pass into this method, call the GetSqlInstances() method.

To find the program SID to pass into this method, call the GetPrograms() method.

Example

The following example shows how to update Reinsurance Program Relationships using the UpdateProgramRelationships() method:

using AIR.Services.Common.Data;
using AIR.Services.Reinsurance.ProgramManagement.Api;
using AIR.Services.Reinsurance.ProgramManagement.Data;
using System;
using System.Collections.Generic;
            
class SnippetUpdateProgramRelationships
{
   private static void UpdateProgramRelationships(int businessUnitSid, int sqlInstanceSid, int programSid, int subjectProgramSid, int inuringProgramSid)
   {
       ReinsuranceProgramManagementServiceClient client = new ReinsuranceProgramManagementServiceClient();
            
       UpdateProgramRelationshipsRequest request = new UpdateProgramRelationshipsRequest();
       request.BusinessUnitSid = businessUnitSid;
       request.SqlInstanceSid = sqlInstanceSid;
       request.ProgramSid = programSid;
       request.Relationships = new List<ProgramRelationship>
           {
               new ProgramRelationship()
               {
                   SubjectProgramSid = subjectProgramSid,
                   InuringSourcingProgramSid = inuringProgramSid,
                   IsSourcing = false,
            
                   Perspectives = ProgramRelationPerspectives.Contract,
                   Participation = ProgramParticipation.OneHundred
            
               }
           };
            
       UpdateProgramRelationshipsResponse response = client.UpdateProgramRelationships(request);
       if (response.Status.Code == StatusCode.Success)
       {
           foreach (var relationship in response.Relationships)
           {
               Console.WriteLine("------------------------------------------------------------");
               Console.WriteLine("Subject Program SID: " + relationship.SubjectProgramSid);
               Console.WriteLine("Child Program SID: " + relationship.InuringSourcingProgramSid);
               Console.WriteLine("Is Source Program: " + relationship.IsSourcing);
               Console.WriteLine("Perspective: " + relationship.Perspectives);
               Console.WriteLine("Participation: " + relationship.Participation);
               Console.WriteLine("Participation Amount: " + relationship.ParticipationAmount);
           }
       }
   }
}

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

ReinsuranceProgramManagementServiceClient Class
ReinsuranceProgramManagementServiceClient Members