zwe init mvs fails with complaint about zowe.yaml

[gejohnston]

Describe the bug
A PSWI-generated workflow job does not like the zowe.yaml file that was also generated by the PSWI workflow.

To Reproduce

Run the step "PSWI - Deployment - Workflows - Configuration of Zowe 3.0 - Run the Zowe init"

The job fails with CC=3328 and displays the following error message:

zwe init mvs -c /u/users/group/product/zwe/zowe-smpe/zowe.yaml --allow-overwrite
* Output:
node: read_yaml 10: /u/users/group/product/zwe/zowe-smpe/bin/commands/init/mvs/index.sh 28: .: zwecli_process_command 4: /u/users/group/product/zwe/zowe-smpe/bin/zwe 98: FSUM7351 not found
Error ZWEL0157E: Zowe dataset prefix (zowe.setup.dataset.prefix) is not defined in Zowe YAML configuration file.

The zowe.yaml file is generated by the PSWI workflow. Identifying an error in the yaml file does not relate to any action that the user performed.

By debugging the yaml file anyway, I find a path that looks exactly like what the error says is not defined.

#-------------------------------------------------------------------------------
zowe:
  #-------------------------------------------------------------------------------
  # These configurations are used by "zwe install" or "zwe init" commands.
  #-------------------------------------------------------------------------------
  setup:
    # MVS data set related configurations
    dataset:
      # **COMMONLY_CUSTOMIZED**
      # where Zowe MVS data sets will be installed
      prefix: IBMUSER.ZWEV2

Having to further speculate on what the error might be actually complaining about, I find that the dataset does not exist. Is that what the error is actually about?

-> zowe zos-files list data-set "IBMUSER"
IBMUSER.ISPF.ISPPROF
IBMUSER.RECEIVE.MAIL

I do not recall any doc instructing me to create such a dataset. I manually created a dataset by that name just to confirm that I am privileged to do so.

-> zowe zos-files list data-set "IBMUSER"
IBMUSER.ISPF.ISPPROF
IBMUSER.RECEIVE.MAIL
IBMUSER.ZWEV2

Expected behavior

Since the yaml file and the jobs are all generated behind the scenes, either the PSWI workflow has an error, or the doc does not have sufficient instructions for the user to set PSWI properties that will succeed when the workflow job is run.

The value 'IBMUSER.ZWEV2' is the default value in the step "PSWI - Deployment - Workflows - Configuration of Zowe 3.0 - Define the main variables - Zowe setup MVS prefix". I simply accepted the default value.

By the way, if that is a value which we recommend to customers, it should probably be named 'V3'.

Desktop (please complete the following information):

• OS: Windows 11, z/OS 3.1
• Browser: Chrome
• Version: 131.0.6778.70

[muzikovam]

Hi Gene, do you have correctly set your variable for node.js?

Btw. default values are more for an inspiration how the value should look like, you still have to fill in the values correctly so the installation will succeed. Also zowe.setup.dataset.prefix doesn't have a correct description (more about it in #4083)

[gejohnston]

The variable for node is set here:

The value is /usr/lpp/IBM/cnj/v18r0/IBM/node-latest-os390-s390x/bin

The node program is operational.

$ /usr/lpp/IBM/cnj/v18r0/IBM/node-latest-os390-s390x/bin/node --version
v18.19.0

Regarding prefixes:

In  "PSWI - Deployment - Deployment Checklist - Configure Deployment" we are required to specify dataset names. It simply states that they will be used for the data sets included in the target software instance.

These datasets are created behind-the-scenes by generated JCL. After encountering permission errors with the default values, I modified the default pattern = ZWE.PSWI.AZWE003 to myUserId.ZWE.V3PSWI.

Much later in "PSWI - Deployment - Workflows - Configuration of Zowe 3.0 - Define the main variables - Zowe setup MVS prefix" we are asked for another prefix with the following description.

IBMUSER.ZWEV2 is a valid dataset prefix. I took the approach that if the Zowe PSWI wants to put data in that location, it is fine with me. No information is provided about what constitutes a "correct" value.

I still do not know what value I should specify for the Zowe MVS Prefix. All I know is that the zwe init mvs command (which is run from generated JCL) fails with the error identified above.

What constitutes a correct value for this Zowe MVS Prefix? Is it related to the earlier data set names? If so, how would I know that?

[gejohnston]

After being directed to confirm the nodeJS home property, I found that I specified a path down to the 'bin' directory (/usr/lpp/IBM/cnj/v18r0/IBM/node-latest-os390-s390x/bin). The node HOME directory is one level above the 'bin' directory. After removing 'bin' from the end of the path, I no longer encountered this error.

This issue can be closed. However, I feel that the error that is displayed:

    "Zowe dataset prefix (zowe.setup.dataset.prefix) is not defined in Zowe YAML configuration file."

does not help the user look for the actual cause of the problem.

[MarkAckert]

I'll close this since we have another issue tracking the same misleading message in another execution context: #3426 .