Jcl New (4) -
: The job fails if a data set with that name already exists. Syntax and Examples
To successfully use NEW , you typically need these accompanying keywords: : The name of the file being created. UNIT : The device type (e.g., SYSDA, 3390). SPACE : The amount of disk storage requested.
: Attributes like Record Format (RECFM) and Logical Record Length (LRECL). Common Errors jcl new (4)
The NEW parameter is almost always used within the three-part DISP structure: DISP=(status, normal-disp, abnormal-disp) . : DISP=(NEW,CATLG,DELETE) Creates the file. Keeps/catalogs it if the job succeeds. Deletes it if the job fails. Temporary storage : DISP=(NEW,PASS) Creates a file for use in a later step of the same job. Shortened version : DISP=NEW Defaults to (NEW,KEEP,KEEP) for permanent files. Critical Requirements
The parameter defines a data set's status as it is being created. It is the first sub-parameter of the DISP (Disposition) keyword. Key Characteristics Purpose : Tells the system to create a new data set. : The job fails if a data set with that name already exists
: The job crashes if the DSN is already on the volume.
: You must usually provide space and DCB attributes. SPACE : The amount of disk storage requested
: Forgetting the SPACE parameter results in a JCL error.