CREATE—Create a Data Set or a Data Set Member

The CREATE macro command creates a member of a partitioned data set or a z/OS® UNIX file from the data you are editing. This command cannot be used to create a sequential data set. Use the Data Set Utility (option 3.2) to allocate a sequential data set.

Syntax


Macro command syntax

>>-ISREDIT--CREATE--+-member---------+--labela--labelb---------->
                    +-(member)-------+                   
                    +-dsname(member)-+                   
                    +-dsname---------+                   
                    '-pathname-------'                   

>--+--------+--------------------------------------------------><
   +-ASCII--+   
   +-EBCDIC-+   
   '-UTF8---'

member: The name of the new member added to the partitioned data set currently being edited. If you are using a concatenated sequence of libraries, the member is always written to the first library in the sequence.
dataset(member): The name of a different partitioned data set and new member to be added to the partitioned data set. The data set name can be fully or partially qualified.
pathname: The path name for a z/OS UNIX regular file to be created. (Also, see Specifying z/OS UNIX pathnames with edit primary and macro commands.)
labela, labelb: Labels identifying the start and end of the group of lines used to create the new member.
linenum1: Relative line number identifying the start of a group of lines used to create the new member.
linenum2: Relative line number identifying the end of a group of lines used to create the new member. [XXX: Not sure why linenum1 and linenum2 are in this list - they don't appear in the syntax diagram.]
ASCII, EBCDIC, UTF8: When one of these keywords is supplied, if the data is using a different character set to that designated by the keyword, the data being saved in the external file is converted to the character set designated by the keyword.

Description

CREATE adds a member to a partitioned data set only if a member with the same name does not already exist. Use REPLACE if the member already exists.

Return codes

0: Normal completion
8: Member already exists, member not created
12: Invalid label or relative line number. The referenced line does not exist in the file.
20: Syntax error (invalid name or incomplete label or relative line number range), or I/O error.

Examples

To create a new 10-line member from the first 10 lines of the member being edited:

ISREDIT CREATE MEM1 1 10