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 .

Table 1. 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.
storclass String Storage class.
mgntclass String Management class.
dataclass String Data class.
dsntype String Dataset type.

Standard headers

None.

Custom headers

None.

Query parameters

None.

Content type

The content type is application/json.

Required authorizations

See Required authorizations.

Usage considerations

See Usage considerations for the z/OSMF REST services.

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 
test figure description

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

Example request

The POST method is used to create a PDSE 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,"dsntype":"LIBRARY"}

Example response

A sample response is shown in Figure 3.
Figure 3. Example: Create PDSE data set.
201 Created
Content-Type:  application/json; charset=UTF-8
Content-Length:  0
Date:  Wed, 11 Oct 2017 11:14:13 GMT