Skip to main content
Version: v2.1.x LTS

zwe install

zwe install

zwe > install

zwe install [parameter [parameter]...]

Description#

After you extract Zowe convenience build, you can run this command to install MVS data sets.

If you are using SMPE build, you can skip this command since MVS data sets are already prepared during SMPE install.

These Zowe YAML configurations showing with sample values are used:

zowe:  setup:    dataset:      prefix: IBMUSER.ZWE

Expected outputs:

  • Will create these data sets under zowe.setup.dataset.prefix definition:
    • SZWEAUTH contains few Zowe load modules (++PROGRAM).
    • SZWESAMP contains several sample configurations.
    • SZWEEXEC contains few utilities used by Zowe.

Examples#

zwe install -v -c /path/to/zowe.yaml

Parameters#

Full nameAliasTypeRequiredHelp message
--allow-overwrite,--allow-overwrittenbooleanno
--dataset-prefix,--ds-prefixstringno

Inherited from parent command#

Full nameAliasTypeRequiredHelp message
--help-hbooleanno
--debug,--verbose-vbooleanno
--trace-vvbooleanno
--silent-sbooleanno
--log-dir,--log-lstringno
--config-cstringno

Errors#

Error codeExit codeError message
ZWEL0157E157%s (%s) is not defined in Zowe YAML configuration file.
ZWEL0300W%s already exists. Members in this data set will be overwritten.
ZWEL0301W%s already exists and will not be overwritten. For upgrades, you must use --allow-overwrite.
ZWEL0158E158%s already exists.

Inherited from parent command#

Error codeExit codeError message
100If the user pass --help or -h parameter, the zwe command always exits with 100 code.
ZWEL0101E101ZWE_zowe_runtimeDirectory is not defined.
ZWEL0102E102Invalid parameter %s.
ZWEL0103E103Invalid type of parameter %s.
ZWEL0104E104Invalid command %s.
ZWEL0105E105The Zowe YAML config file is associated to Zowe runtime "%s", which is not same as where zwe command is located.
ZWEL0106E106%s parameter is required.
ZWEL0107E107No handler defined for command %s.
ZWEL0108E108Zowe YAML config file is required.
ZWEL0109E109The Zowe YAML config file specified does not exist.
ZWEL0110E110Doesn't have write permission on %s directory.
ZWEL0111E111Command aborts with error.
ZWEL0112E112Zowe runtime environment must be prepared first with "zwe internal start prepare" command.
ZWEL0114E114Reached max retries on allocating random number.
ZWEL0120E120This command must run on a z/OS system.
ZWEL0121E121Cannot find node. Please define NODE_HOME environment variable.
ZWEL0122E122Cannot find java. Please define JAVA_HOME environment variable.
ZWEL0123E123This function is only available in Zowe Containerization deployment.
ZWEL0131E131Cannot find key %s defined in file %s.
ZWEL0132E132No manifest file found in component %s.
ZWEL0133E133Data set %s already exists.
ZWEL0134E134Failed to find SMS status of data set %s.
ZWEL0135E135Failed to find volume of data set %s.
ZWEL0136E136Failed to APF authorize data set %s.
ZWEL0137E137z/OSMF root certificate authority is not provided (or cannot be detected) with trusting z/OSMF option enabled.
ZWEL0138E138Failed to update key %s of file %s.
ZWEL0139E139Failed to create directory %s.
ZWEL0140E140Failed to translate Zowe configuration (%s).
ZWEL0142E142Failed to refresh APIML static registrations.
ZWEL0172EComponent %s has %s defined but the file is missing.