At least one of the two options “-i” and “-d” must be specified. All other options are optional.

-C <concatenation>

Concatenate this file with the previous dsname for this ddname.

-D <delimiter>

Delimiter of sysin.

-d <DispOption>

This option indicates the DISPosition status of the file in the format:

DISP=([status][,normal-termination-disp][,abnormal-termination-disp])

Possible combinations are:

DISP= ( [NEW]     [,DELETE ]   [,DELETE ] )
        [OLD]     [,KEEP]      [,KEEP ]
        [SHR]     [,PASS]      [,CATLG ]
        [MOD]     [,CATLG ]    [,UNCATLG ]
        [ANY]     [,UNCATLG ]

The Disp Option indicates the status of the data set at the beginning of a job step and what to do with the data set in the event of normal and abnormal termination of the step.

<status>

The status indicates if an existing data set must be used or a new one created. For existing data sets the status indicates if the data set can be shared with other jobs or used to append records to the end of the data set. The possible values are:

NEW — indicates to create a new unshared data set.

OLD — indicates to use an existing unshared data set.

SHR — indicates to use an existing shared data set.

MOD — indicates an existing unshared data set to add records at the end of file.

An additional status has been added to the traditional z/OS status:

ANY — indicates to use a file in a special mode. The other sub-parameters (<normal-termination-disp> and <abnormal-termination-disp>) are ignored in this case.

Note:

OLD and SHR check the file is already existing.

NEW, creation if the file does not exist, abort if the file already exists.

MOD, creation if the file does not exist, continue if the file already exists.

<normal-termination-disp>

This option indicates what to do with a data set when a step ends normally. The possible values are:

DELETE — The data set is no longer needed.

KEEP — The data set is to be kept.

PASS — The data set is to be passed for use by a subsequent step.

CATLG — The data set is to be cataloged.

UNCATLG — The data set is to be deleted from catalog.

<abnormal-termination-disp>

DELETE — The data set is no longer needed.

KEEP — The data set is to be kept.

CATLG — The data set is to be cataloged.

UNCATLG — The data set is to be deleted from catalog.

The termination dispositions have default values for each status, the default values are:

NEW: DELETE, DELETE

OLD/SHR/MOD : KEEP, KEEP

Note:

In one step, PASS is functionally equivalent to KEEP; however, in one job, if a data set is newly created by NEW or MOD, and no KEEP or CATLG in the following steps is specified to this data set, this data set will be deleted.

Once specified for a GDS, KEEP becomes a member of GDG after job execution.

For GDG, CATLG and UNCATLG are converted to KEEP implicitly, and KEEP always results in the newly created GDS becoming a member of GDG.

-g <generationFile>

Indicates that the data set is a generation file. The possible values are:

+n: creates the nth new generation file.

-n: accesses the nth previous old generation file.

0: accesses the current generation.

cur: accesses the current generation.

all: concatenates all generations.

Note:

If "all" is specified, all generation files for the corresponding GDG, including all new added GDS, are concatenated to one temporary file, and this temporary file is assigned to DD specified for m_FileAssign. For example, if "all" is specified and <normal-termination-disp> or <abnormal-termination-disp> is specified to DELETE, all generation files are deleted from the corresponding GDG in the end of the current step.

-i

Indicates that the data set is a sysin.

-k <key position>+<key length>

Indicates the key characteristics of an indexed file (to be used when file organization is IDX).

-r [<record length-min>-]<record length-max>

Indicates the length characteristics of the record.

For fixed files, only the maximum record length is specified.

For variable files, the minimum and the maximum record lengths are specified.

-S <model file>

(S upper case character)

Names the dsname of a file.

When the disposition mode is NEW, this file is a “model” for the new file to be created.

The characteristics of the new file depend on the characteristics of the “model” file and other parameter given by the m_FileAssign function. IDX, LSEQ, SEQ, REL, and GDG are supported as model file.

-t <file organization>

Indicates the file oraganization type:

SEQ: sequential

LSEQ: line sequential

REL: relative

IDX: indexed

PDS: directory

-v volume

Indicates the external file volume. This option only works when file catalog is enabled in Batch Runtime.

-e Ydate|Ddays (Y upper case character) (D upper case character)

Indicates the retention period for the data set.

-U

Indicates the file is a UNIX file. No dcb file is generated for this type of file.

When this option is specified, the file name must be UNIX file path instead of file name only.

-O

Retrieves the value of PATHOPTS from DD statement (in mainframe JCL), and uses it for m_FileAssign.

-M

Retrieves the value of PATHMODE from DD statement (in mainframe JCL), and uses it for m_FileAssign.

date

Specifies the expiration date for the data set. The date is specified in the form [yy]yyddd.

yyddd

The yy is a two-digit year number (through 99) and the ddd is a three-digit day number from 000 through 365 for non-leap year dates. For example, code February 2, 1995 as 95033

yyyyddd

The yyyy is a four-digit year (through 2155),and ddd is the three-digit day of the year.

Note:

Expiration dates of [19]99365 and [19]99366 are considered “never-scratch” dates.

days

Specifies the retention period for the data set. It is specified in the form dddd, where dddd must be set in the range of 0-9999.The system adds dddd to the current date to produce an expiration date.

-w referenced-file

Indicates that the volume of the referenced file is used. This option only works when file catalog is enabled in Batch Runtime.

The reference mode can be one of the following values.

• FileName
• *.DD
• *.STEP.DD

ddname <InternalFileName>

The logical name of the file as defined in the SELECT statement of the COBOL program.

dsname <ExternalFileName>

Real file name, full path of the file on the disk.