Dataset Services Interface › $DSCALL OPT=CREATE

$DSCALL OPT=CREATE

Creates a new data set.

&CONTROL SHRVARS=($DS)
EXEC $DSCALL OPT=CREATE
             DSN=dataset_name
             FORMAT=format
             ORG=dataset_organization
             RLSE={ NO | YES }
             SPACE= { TRK | CYL } , pri, sec [ ,dir ]
           [ BLKSIZE=blocksize ]
           [ DATACLS=class ]
           [ FREE= { UNAL | CLOSE } ]
           [ LRECL= logical_record_length ]
           [ MGMTCLS=class ]
           [ MOUNT= { NO | YES } ]
           [ STORCLS=class ]
           [ VOL=volser [ UNIT=unit ] ]

This call is used to create a new data set on DASD. This call is similar to the $DSCALL OPT=ALLOC call except the data set must not be a temporary or SYSOUT data set. The data set is cataloged and does not remain allocated to your product region on completion of the operation.

Operands:

OPT=CREATE

Specifies that a data set is to be created.

DSN=dataset_name

Specifies the data set name to create.

FORMAT=format

Specifies the format of the created data set. Valid values are: F, FB, FS, FBS, FA, FBA, FSA, FBSA, FM, FBM, FSM, FBSM, V, VB, VS, VBS, VBSA, VM VBM, VSM, VBSM, U, UA, UM.

ORG=dataset_organization

Specifies the data set organization for a new data set. Valid values are: PS, PO, PSU, and POU.

RLSE={ NO | YES }

Specifies whether to have a secondary space release option.

SPACE={ TRK | CYL } , pri, sec [ ,dir ]

Specifies the space allocation in tracks or cylinders. The SPACE type and primary allocation quantity are required. The directory allocation quantity is required if the data set is a PDS.

BLKSIZE=blocksize

Specifies the block size for a new data set. The value must be an integer in the range 1 to 32,760.

DATACLS=class

Specifies the SMS data class option.

FREE={ UNAL | CLOSE }

Specifies whether the data set is to be deallocated by explicit request only (FREE=UNAL) or is to be deallocated when the file is closed (FREE=CLOSE).

LRECL=logical_record_length

Specifies the logical record length for a new data set. The value must be an integer in the range 1 to 32,760.

MGMTCLS=class

Specifies the SMS management class option.

MOUNT={ NO | YES }

Specifies whether a volume mount is allowed. If MOUNT=NO is specified, and an allocation request requires a volume which is offline, the allocation request fails. If MOUNT=YES is specified and an allocation request requires a volume which is offline, a MOUNT request for the volume is issued.

STORCLS=class

Specifies the SMS storage class option.

VOL=volser [ UNIT=unit ]

Specifies the volume serial number and unit name for a new allocation. If the VOL operand is omitted, the operating system determines if the allocation is allowed, and may choose to allocate the data set or any volume which the requesting user is authorized for.

Return Codes:

Note: For more information about &SYSMSG, &$DSRC, and &$DSFDBK, see Return Codes and Feedback Codes.

Return Variables:

&$DSDSN

Full data set name with member name omitted, and true name if an alias was entered

&$DSORG

Data set organization; values are PS, PO, PSU, POU, CX, CQ, MQ, GS, X, TQ, and TR

&$DSVOL

First volume

&$DSRECF

Record format; values are F,FB, FS, FBS, FA, FBA, FSA, FBSA, FM, FBM, FSM, FBSM, V, VB, VS, VBS, VBSA, VM, VBM, VSM, VBSM, U, UA, UM

&$DSRECL

Logical record length

&$DSRECA

Actual usable record length. If the record format is variable length, then the value is record length minus 4. In all other cases, the value is the same as record length.

&$DSBLKS

Block size

&$DSSTORCLS

SMS storage class if SMS is active for this data set

&$DSMGMTCLS

SMS management class if SMS is active for this data set

&$DSDATACLS

SMS data class if SMS is active for this data set

&$DSDYNEC

Dynamic allocation error code

&$DSDYNIC

Dynamic allocation information code

Example: OPT=CREATE

EXEC $DSCALL OPT=CREATE DSN=DEV.SAMPLE.PDS.WORK02 +
   SPACE='TRK,10,5,1' ORG=PO FORMAT=FB +
   LRECL=80, BLKSIZE=4000, STAT=NEW