---
title: "POST /applications/{applicationId}/dataset-import-task"
method: POST
path: "/applications/{applicationId}/dataset-import-task"
---

# POST /applications/{applicationId}/dataset-import-task

`POST /applications/{applicationId}/dataset-import-task`

Starts a data set import task for a specific application.

## Path parameters

- `applicationId` string, required

## Request body

- object
  - `clientToken` string — A client token is a unique, case-sensitive string of up to 128 ASCII characters with ASCII values of 33-126 inclusive. It is generated by the client to ensure idempotent operations, allowing safe retries without unintended side effects.
  - `importConfig` object, required — Identifies one or more data sets you want to import with the <a>CreateDataSetImportTask</a> operation.
    - `dataSets` DataSetImportItem[] — The data sets.
      - `dataSet` object, required — The data set.
        - `datasetName` string, required — The logical identifier for a specific data set (in mainframe format).
        - `datasetOrg` object, required — The type of dataset. The only supported value is VSAM.
          - `gdg` object — The generation data group of the data set.
            - `limit` integer — The maximum number of generation data sets, up to 255, in a GDG.
            - `rollDisposition` string — The disposition of the data set in the catalog.
          - `po` object — The details of a PO type data set.
            - `encoding` string — The character set encoding of the data set.
            - `format` string, required — The format of the data set records.
            - `memberFileExtensions` String20[], required — An array containing one or more filename extensions, allowing you to specify which files to be included as PDS member.
          - `ps` object — The details of a PS type data set.
            - `encoding` string — The character set encoding of the data set.
            - `format` string, required — The format of the data set records.
          - `vsam` object — The details of a VSAM data set.
            - `alternateKeys` AlternateKey[] — The alternate key definitions, if any. A legacy dataset might not have any alternate key defined, but if those alternate keys definitions exist, provide them as some applications will make use of them.
              - …
            - `compressed` boolean — Indicates whether indexes for this dataset are stored as compressed values. If you have a large data set (typically &gt; 100 Mb), consider setting this flag to True.
            - `encoding` string — The character set used by the data set. Can be ASCII, EBCDIC, or unknown.
            - `format` string, required — The record format of the data set.
            - `primaryKey` object — The primary key of the data set.
              - …
        - `recordLength` object, required — The length of a record.
          - `max` integer, required — The maximum record length. In case of fixed, both minimum and maximum are the same.
          - `min` integer, required — The minimum record length of a record.
        - `relativePath` string — The relative location of the data set in the database or file system.
        - `storageType` string — The storage type of the data set: database or file system. For Micro Focus, database corresponds to datastore and file system corresponds to EFS/FSX. For Blu Age, there is no support of file system and database corresponds to Blusam.
      - `externalLocation` object, required — The location of the data set.
        - `s3Location` string — The URI of the Amazon S3 bucket.
    - `s3Location` string — The Amazon S3 location of the data sets.

## Response `200`

Success

- CreateDataSetImportTaskResponse
  - `taskId` string, required — The task identifier. This operation is asynchronous. Use this identifier with the <a>GetDataSetImportTask</a> operation to obtain the status of this task.

## Other responses

- `480` — ResourceNotFoundException
- `481` — ServiceQuotaExceededException
- `482` — ThrottlingException
- `483` — AccessDeniedException
- `484` — ConflictException
- `485` — ValidationException
- `486` — InternalServerException

---

[API](https://skmtc.net/aws/apis/m2.md) · [All operations](https://skmtc.net/aws/apis/m2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/m2/versions/aac43e95a42b/schema)