Build and Configure Mainframe Integration Projects

Configure mainframe pipeline components

Configures source assets selection, target assets selection, and field mappings (transformation) for a mainframe pipeline.

Process Overview:

  1. Resource Validation - Validates project and pipeline existence
  2. Parallel Component Processing - Processes each component configuration independently
  3. Component Types Supported:
    • Sources: Source asset selection (e.g., topics)
    • Targets: Target schema and table definitions
    • Transformation: Field mapping and transformation criteria
  4. Isolation & Fault Tolerance - Component failures don't affect others
  5. Consolidated Response - Returns unified status after all processing

Key Features:

  • All component configurations are optional
  • Parallel processing for optimal performance
  • Independent component execution (failure isolation)
  • Metrics per component for better observability
  • Component specific thread pool resource allocation
  • Comprehensive error reporting per component

Required Permissions: Either replication-pipeline::create or replication-pipeline::update when permission harmonization is enabled; otherwise, replication-pipeline::manage.

post/v1/integration/mainframe/projects/{projectId}/pipelines/{pipelineId}/configuration

Request

  • Base URL: https://integration-adapter.connect.cloud.precisely.com
  • URL: https://integration-adapter.connect.cloud.precisely.com/v1/integration/mainframe/projects/{projectId}/pipelines/{pipelineId}/configuration
  • Auth: HTTP bearer

Path parameters

projectIdstring required

Unique identifier of the project

pipelineIdstring required

Unique identifier of the pipeline

Request body

sourcesstring[]

List of source topic identifiers.

Example request

{
  "sources": [
    "sourceTopic1",
    "sourceTopic2"
  ],
  "targets": [
    {
      "schema": "targetSchema1",
      "tables": [
        "targetTable1"
      ]
    },
    {
      "schema": "targetSchema2",
      "tables": [
        "targetTable2"
      ]
    }
  ],
  "transformation": {
    "fieldMappings": [
      {
        "sourceField": "sv_sending_table",
        "targetField": "Dataset name"
      }
    ]
  }
}

Response

Pipeline components configured successfully

requestIdstring

Unique identifier for this configuration request

overallStatus'SUCCESS' | 'PARTIAL' | 'FAILED'

Overall status of the configuration operation

executionTimeInMsinteger

Total execution time for all component configurations in milliseconds

Example response

{
  "requestId": "config-req-12345-abcde",
  "overallStatus": "SUCCESS",
  "executionTimeInMs": 45123,
  "sources": {
    "selectedResources": [
      "sourceTopic1",
      "sourceTopic2"
    ],
    "status": "SUCCESS"
  },
  "targets": {
    "selectedResources": [
      {
        "schema": "targetSchema",
        "table": "targetTable1"
      },
      {
        "schema": "targetSchema",
        "table": "targetTable2"
      }
    ],
    "status": "SUCCESS"
  },
  "transformation": {
    "status": "SUCCESS",
    "response": "Field mappings applied successfully."
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.