create dataset

Edit online

Allocate a permanent data set on your z/OS® system. The data set definition UUID dsdef will obtain any required data set characteristics.

Purpose

The scm create dataset subcommand creates a data set on z/OS, depending on the characteristics you indicate in the associated data set definition.
Note: The data set will be only allocated on your z/OS system if the usage for the data set definition is set to either Destination data set for a zFolder or New data set used for a build.

Synopsis

  • To run scm create dataset after you have used scm login to create stored credentials:
    scm create dataset [ -r  
    | --repository-uri ] repository URI or nickname { [ -x | --prefix ] data set prefix}
    selector
  • To run scm create dataset and supply your credentials on the command line:
    scm create dataset [ -r | -- repository-uri ] repository uri [ -u | --
    username ] user ID in repository [ -P | --
    password ] password for user ID in repository { [ -x | --prefix ] data set prefix}
    selector

Options and arguments

[ -P | --password ] password for user ID in repository
Indicates the password for the specified user ID in the named repository. If you do not include this option on the command line, you are prompted for a password. If you specified a repository URI or nickname for which you have stored credentials using the scm login command, this option is ignored.
[ -r | --repository-uri ] repository URI
Specifies the repository in which to take this action. If you have stored repository credentials using the scm login command, you can use the nickname you supplied for these stored credentials.
[ -u | --username ] user ID in repository
Specifies a user ID that exists in the named repository. If you specified a repository URI or nickname for which you have stored credentials using the scm login command, this option is ignored.
[ -x | --prefix ]
Specifies the data set prefix you want to add to the data set name.
Note: You must indicate a prefix only if you select Add data set prefix in the data set definition editor.
selector
Specifies the UUID of an existing data set definition in a project area. You can retrieve any UUID with the list datasetdefinitions command.
Tip: For more information about how to use the create dataset command, run the scm.sh help create dataset command.

Examples

Run the create dataset command to allocate a data set on your z/OS system.
../scmtools/eclipse#>scm create dataset –r jazzhost -x HLQ _CIyt4CrHEd-0Q_JL9UlaQg
CRHTC0801I Data set "HLQ.TST2.COBOL" allocated.

After the create dataset process is complete, a partitioned data set is allocated on your z/OS system. You can list this new data set by using the data set list utility (=3.4) through the time sharing option (TSO) on your z/OS system.