zload

Load a repository workspace onto your z/OS® system.

Purpose

Use the scm zload subcommand to load a repository workspace, a zComponent project, zFolder, or zFiles to your z/OS system. You can also load a set of remote items by specifying a list of remote paths.

Synopsis

  • To run scm zload after you have used scm login to create stored credentials:

    scm zload  [ -r |  --repository-uri ] repository URI or nickname [ -h
    |  --hfs ] HFS path on USS  [ -x |  --prefix ] data set prefix [remote-path] selector

  • To run scm zload and supply your credentials on the command line:

    scm zload [ -r  |  --repository-uri ] repository URI [ -u  |  --username ] user ID in repository [ -P  |  --password ] password for user ID in repository [ -h |  --hfs ] HFS path on USS  [ -x |  --prefix ] data set prefix [-d | --dataset] complete data set name [remote-path] selector

Options and arguments

[ -h | --hfs ]
Specifies the hierarchical file system (HFS) destination path on USS to load the repository workspace.
Note: This option is not allowed if the -d or --dataset option is specified.
[ -P | --password ] password for user ID in repository
Specifies 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 to add to the data set name.
Note: This option is not allowed if the -d or --dataset option is specified.
[-d | --dataset]
Specifies the complete data set name for where zFiles or zFolders specified on the remote-path option, for example USER1.PROJECT1.SOURCE.COBOL are loaded. When you specify this option, do not specify the -x or --prefix or the -h or --hfs options.
Note: The data set specified must exist prior to running the zload subcommand.
[ remote-path ]
Specifies a list of remote items to load. remote-path can be the name, alias, or UUID of a component, a zFile or zFolder, or a remote path within a component. To specify a remote path within a component, use the following format: <name, alias, or UUID of the component>/<remote path within the component>. Separate the items with a space or enter the items on different lines.
Selector
Specifies the name of the repository workspace you want to load.

Examples

Run the zload command to load a new repository workspace onto your z/OS system (MVS™ and USS).

../scmtools/eclipse#>scm zload -h /u/tst -r jazzhost -x HLQ T1_wks

After the zload process is complete, at least one partitioned data set is allocated to 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. All artifacts that are not z/OS artifacts (zFiles from zComponent projects) are loaded onto USS.

Run the zload command to load only non-z/OS artifacts onto a repository workspace on USS.

../scmtools/eclipse#>scm zload -h /u/tst -r jazzhost T1_wks

After the zload process is complete, only non-z/OS artifacts are loaded onto USS.

Run the zload command to load only z/OS artifacts (zFiles from zComponent projects) onto a repository workspace onto your z/OS system.

../scmtools/eclipse#>scm zload -r jazzhost -x HLQ T1_wks

After the zload process is complete, only z/OS artifacts are loaded onto your z/OS system, and at least one 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.

Run the zload command to load a list of remote items onto your z/OS system.

../scmtools/eclipse#>scm zload -r jazzhost -x HLQ T1_wks
comp01/MortgageApplication-Common/zOSsrc/COPYBOOK
comp02/MortgageApplication-EPSCMORT/zOSsrc/COBOL/EPSCMORT.cbl

After the zload process is complete, only the zFile EPSCMORT.cbl and all zFiles in the zFolder COPYBOOK are loaded on your z/OS system.


video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki