---
title: "GET /applications/{applicationId}/datasets/{dataSetName}"
method: GET
path: "/applications/{applicationId}/datasets/{dataSetName}"
---

# GET /applications/{applicationId}/datasets/{dataSetName}

`GET /applications/{applicationId}/datasets/{dataSetName}`

Gets the details of a specific data set.

## Path parameters

- `applicationId` string, required
- `dataSetName` string, required

## Response `200`

Success

- GetDataSetDetailsResponse
  - `blocksize` integer — The size of the block on disk.
  - `creationTime` string, date-time — The timestamp when the data set was created.
  - `dataSetName` string, required — The name of the data set.
  - `dataSetOrg` object — The type of data set. 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, required — The character set encoding of the data set.
      - `format` string, required — The format of the data set records.
    - `ps` object — The details of a PS type data set.
      - `encoding` string, required — 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.
        - `allowDuplicates` boolean — Indicates whether the alternate key values are supposed to be unique for the given data set.
        - `length` integer, required — A strictly positive integer value representing the length of the alternate key.
        - `name` string — The name of the alternate key.
        - `offset` integer, required — A positive integer value representing the offset to mark the start of the alternate key part in the record byte array.
      - `cacheAtStartup` boolean — If set to True, enforces loading the data set into cache before it’s used by the application.
      - `compressed` boolean — Indicates whether indexes for this dataset are stored as compressed values. If you have a large data set (typically > 100 Mb), consider setting this flag to True.
      - `encoding` string — The character set used by the data set. Can be ASCII, EBCDIC, or unknown.
      - `primaryKey` object — The primary key of the data set.
        - `length` integer, required — A strictly positive integer value representing the length of the primary key.
        - `name` string — A name for the Primary Key.
        - `offset` integer, required — A positive integer value representing the offset to mark the start of the primary key in the record byte array.
      - `recordFormat` string — The record format of the data set.
  - `fileSize` integer — File size of the dataset.
  - `lastReferencedTime` string, date-time — The last time the data set was referenced.
  - `lastUpdatedTime` string, date-time — The last time the data set was updated.
  - `location` string — The location where the data set is stored.
  - `recordLength` integer — The length of records in the data set.

## Other responses

- `480` — ResourceNotFoundException
- `481` — ExecutionTimeoutException
- `482` — ServiceUnavailableException
- `483` — ThrottlingException
- `484` — AccessDeniedException
- `485` — ConflictException
- `486` — ValidationException
- `487` — 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)