Create a sequential and partitioned data set
You can use this operation to create sequential and partitioned data sets on a z/OS system.
HTTP method and URI path
POST /zosmf/restfiles/ds/<dataset-name>
where:
- /zosmf/restfiles specifies the z/OS® data set and file REST interface
- /ds indicates a data set request
- <dataset-name> is the name of a z/OS data set that you are going to create.
Request Body
The request body to create a sequential and partitioned data set is shown in Request body to create a sequential and partitioned data set .
Field | Type | Description |
---|---|---|
volser | String | Volume. |
unit | String | Device type. |
dsorg | String | Data set organization. |
alcunit | String | Unit of space allocation. |
primary | Integer | Primary space allocation. |
secondary | Integer | Secondary space allocation. |
dirblk | Integer | Number of directory blocks. |
avgblk | Integer | Average block. |
recfm | String | Record format. |
blksize | Integer | Block size. |
lrecl | Integer | Record length. |
storeclass | String | Storage class. |
mgntclass | String | Management class. |
dataclass | String | Data class. |
Standard headers
None.
Custom headers
None.
Query parameters
None.Content type
The content type is application/json.
Required authorizations
Usage considerations
Expected response
On completion, the service returns an HTTP response, which includes a status code indicating whether your request completed. Status code 201 indicates success. A status code of 4nn or 5nn indicates that an error has occurred. For more details, see Error handling.
For a successful creating request, 201 Created with no content will be returned. .
Example request
In the following example, the POST method is used to create a sequential data set.
POST /zosmf/restfiles/ds/JIAHJ.REST.TEST.NEWDS HTTP/1.1
Request body:
{"volser":"zmf046","unit":"3390","dsorg":"PS","alcunit":"TRK","primary":10,
"secondary":5,"avgblk":500,"recfm":"FB","blksize":400,"lrecl":80}
Example response
A sample response is shown in Example: Create a data set.
Figure 1. Example: Create a data set
201 Created
Content-Type: application/json; charset=UTF-8
Content-Length: 0
Date: Wed, 16 Sep 2015 10:54:21 GMT
Example request
The POST method is used to create a partitioned data set.
POST /zosmf/restfiles/ds/JIAHJ.REST.TEST.NEWDS02 HTTP/1.1
Request Body
{"volser":"zmf046","unit":"3390","dsorg":"PO","alcunit":"TRK","primary":10,
"secondary":5,"dirblk":10,"avgblk":500,"recfm":"FB","blksize":400,"lrecl":80}
Example response
A sample response is shown in Example:
Create data set.
Figure 2. Example: Create data set.
201 Created
Content-Type: application/json; charset=UTF-8
Content-Length: 0
Date: Wed, 16 Sep 2015 11:14:13 GMT