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

Initializing Zowe custom data sets

Initializing Zowe custom data sets

Learn how to intialize Zowe custom MVS data sets by using the zwe init mvs command.

Introduction#

During the installation of Zowe, three data sets SZWEAUTH, SZWESAMP and SZWEEXEC are created and populated with members copied across from the Zowe installation files. The contents of these data sets represent the original files that were provided as part of the Zowe installation and are not meant to be modified because they will be replaced during subsequent upgrades of Zowe version 2.

For modification and execution, you must create custom data sets by using the zwe init mvs command. For detailed information about this command, see the zwe init mvs command reference.

The zowe.yaml section that contains the parameters for the data set names is:

zowe:  setup:    dataset:      prefix: IBMUSER.ZWE      parmlib: IBMUSER.ZWE.CUST.PARMLIB      jcllib: IBMUSER.ZWE.CUST.JCLLIB      authLoadlib: IBMUSER.ZWE.CUST.ZWESALL      authPluginLib: IBMUSER.ZWE.CUST.ZWESAPL

The storage requirements for the three data sets are included here.

Library DDNAMEMember Typezowe.yamlTarget VolumeTypeOrgRECFMLRECLNo. of 3390 TrksNo. of DIR Blks
CUST.PARMLIBPARM Library Memberszowe.setup.dataset.parmlibANYUPDSEFB80155
CUST.JCLLIBJCL Memberszowe.setup.dataset.jcllibANYUPDSEFB80155
CUST.ZWESAPLCLIST copy utilitieszowe.setup.dataset.authPluginLibANYUPDSEU015N/A

Procedure#

To initialize Zowe custom data sets, run the following command:

zwe init mvs -c /path/to/zowe.yaml

Here is an example of running zwe init mvs.

#>zwe init mvs -c ./zowe.yaml------------------------------------------------------------------------------->> Initialize Zowe custom data sets
Create data sets if they are not existCreating IBMUSER.ZWEV2.CUST.PARMLIBCreating IBMUSER.ZWEV2.CUST.JCLLIBCreating IBMUSER.ZWEV2.SZWEAUTHCreating IBMUSER.ZWEV2.CUST.ZWESAPL
Copy IBMUSER.ZWEV2.SZWESAMP(ZWESIP00) to USER.ZWEV2.CUST.PARMLIB(ZWESIP00)Copy components/zss/LOADLIB/ZWESIS01 to USER.ZWEV2.SZWEAUTH(ZWESIS01)Copy components/zss/LOADLIB/ZWESAUX to USER.ZWEV2.SZWEAUTH(ZWESAUX)Copy components/launcher/bin/zowe_launcher to USER.ZWEV2.SZWEAUTH(ZWELNCH)
>> Zowe custom data sets are initialized successfully.#>

Results#

If this step is successful, there will be three custom data sets matching the values in zowe.setup.dataset.parmlib, zowe.setup.dataset.jcllib and zowe.setup.dataset.authPluginLib in the zowe.yaml file. The member ZWESIP00 will exist in the CUST.PARMLIB and the JCLLIB and ZWESAPL will be empty.

In addition to the three custom data sets, the PDS SZWEAUTH is created. This may already exist. In this case, you will receive the error message Error ZWEL0158E: IBMUSER.ZWEV2.SZWEAUTH already exists. You can ignore this message, or you can use the --allow-overwritten option on the command. For example, zwe init mvs -c zowe.yaml --allow-overwritten.