CreateProgramRelationships Method

Creates 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 create new 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 CreateProgramRelationshipsRequest that identifies the list of relationships to create as well as the Business Unit Sequential Identifier (SID), and SQL Instance SID, and Program SID associated with the relationships. A CreateProgramResponse containing the list of relationships that you created.

Syntax

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

Public Function CreateProgramRelationships( _
   ByVal request As CreateProgramRelationshipsRequest _
) As CreateProgramRelationshipsResponse

Dim instance As ReinsuranceProgramManagementServiceClient
Dim request As CreateProgramRelationshipsRequest
Dim value As CreateProgramRelationshipsResponse
 
value = instance.CreateProgramRelationships(request)

public CreateProgramRelationshipsResponse CreateProgramRelationships( 
   CreateProgramRelationshipsRequest request
)

Parameters

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

Return Value

A CreateProgramResponse containing the list of relationships that you created.

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 create a Reinsurance Program Relationship using the CreateProgramRelationships() method:

using System;
using AIR.Services.Reinsurance.ProgramManagement.Api;
using AIR.Services.Common.Data;
            
private static void CreateProgramRelationships(int _businessUnitSid, int _sqlServerSid)
   {
            
            
       ReinsuranceProgramManagementServiceClient client = new ReinsuranceProgramManagementServiceClient();
       CreateProgramRelationshipsRequest request = new CreateProgramRelationshipsRequest();
        request.BusinessUnitSid = _businessUnitSid;
        request.SqlInstanceSid = _sqlServerSid;
         request.ProgramSid = 14;
        request.Relationships = new List
        {
              new ProgramRelationship()
              {
                  SubjectProgramSid = 14,
                  InuringSourcingProgramSid = 12,
                   IsSourcing = true,
                   
                   Perspectives = ProgramRelationPerspectives.Contract,
                   Participation = ProgramParticipation.OneHundred,  
                   ParticipationAmount = 1,
              },
              new ProgramRelationship()
              {
                   InuringSourcingProgramSid = 15,
                   IsSourcing = true,
                   ParticipationAmount = 0.75,
                   Participation = ProgramParticipation.OneHundred,
                   SubjectProgramSid = 14,
              },
              new ProgramRelationship()
              {
                   InuringSourcingProgramSid = 3,
                   IsSourcing = false,
                   SubjectProgramSid = 12,
                   Participation = ProgramParticipation.OneHundred,
              }
        };
            
            
        CreateProgramRelationshipsResponse response = client.CreateProgramRelationships(request);
        if (ValidateResponse(response))
        {
            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