PSWI Workflow fails to access uncataloged dataset

[gejohnston]

Describe the bug

The PSWI-generated workflow job named 'Run the Zowe init' attempts to access a dataset that the workflow should have generated and reports that the generated dataset is not cataloged.

The error produced by the 'Run the Zowe init' job is:

Job fails with cc=3840
XBATCH:STDERR(109)
+ export JAVA_HOME=/u/users/group/product/<MyUserId>/java17
+ export NODE_HOME=/usr/lpp/IBM/cnj/v18r0/IBM/node-latest-os390-s390x
+ export PATH=/usr/lpp/IBM/zoautil/env/bin:/usr/lpp/IBM/zoautil/bin:/usr/lpp/IBM/cyp/v3r9/pyz/bin:/bin:/usr/lpp/java/current/bin:/usr/lpp/java/current:.:/u/users/oem/Rocket/bin:/u/users/group/product/<MyUserId>/zwe/smpe/bin
+ zwe init mvs -c /u/users/group/product/<MyUserId>/zwe/smpe/zowe.yaml --allow-overwrite
  * Exit code: 12
  * Output:
    exec '<MyUserId>.ZWE.V3PSWI.SZWEEXEC(ZWEMCOPY)' '<MyUserId>.ZWE.V3PSWI.SZWESAMP(ZWESIP00) <MyUserId>.ZWE.V3PSWI.CUST.PARMLIB(ZWESIP00)'
    IKJ56228I DATA SET <MyUserId>.ZWE.V3PSWI.SZWEEXEC NOT IN CATALOG OR CATALOG CAN NOT BE ACCESSED
Error ZWEL0111E: Command aborts with error.

To Reproduce

I saw no documentation stating that any of the following actions are required.

1. I displayed a list of cataloged datasets.

LISTCAT
IN CATALOG:ICF.MINI.USERCAT
<MyUserId>.ISPF.ISPPROF
<MyUserId>.RECEIVE.MAIL
<MyUserId>.SPFLOG1.LIST
<MyUserId>.ZWE.DEP.DM.D241105.T142248.CNTL
<MyUserId>.ZWE.V3.CUST.JCLLIB
<MyUserId>.ZWE.V3.CUST.PARMLIB
<MyUserId>.ZWE.V3.CUST.ZWESAPL
<MyUserId>.ZWE.V3.SZWEAUTH
<MyUserId>.ZWE.V3PSWI.CSI
<MyUserId>.ZWE.V3PSWI.CSI.DATA
<MyUserId>.ZWE.V3PSWI.CSI.INDEX
<MyUserId>.ZWE.V3PSWI.D.AZWEAUTH
<MyUserId>.ZWE.V3PSWI.D.AZWESAMP
<MyUserId>.ZWE.V3PSWI.D.AZWEZFS
<MyUserId>.ZWE.V3PSWI.SMPLOG
<MyUserId>.ZWE.V3PSWI.SMPLOGA
<MyUserId>.ZWE.V3PSWI.SMPLTS
<MyUserId>.ZWE.V3PSWI.SMPMTS
<MyUserId>.ZWE.V3PSWI.SMPPTS
<MyUserId>.ZWE.V3PSWI.SMPSCDS
<MyUserId>.ZWE.V3PSWI.SMPSTS
<MyUserId>.ZWE.V3PSWI.T.SZWEAUTH
<MyUserId>.ZWE.V3PSWI.T.SZWEEXEC
<MyUserId>.ZWE.V3PSWI.T.SZWELOAD
<MyUserId>.ZWE.V3PSWI.T.SZWESAMP
<MyUserId>.ZWE.V3PSWI.WORKFLOW
<MyUserId>.ZWE.V3PSWI.ZFS
<MyUserId>.ZWE.V3PSWI.ZFS.DATA
READY 

The dataset in the error message:
MyUserId.ZWE.V3PSWI.SZWEEXEC
is not among the cataloged datasets. However the similar dataset is cataloged:
MyUserId.ZWE.V3PSWI.T.SZWEEXEC

This seems like a programming error that could be corrected. None-the-less, a user needs to make the existing app work.

2. Through numerous trial-and-error entries in the PSWI panels, I found that I had to set all HLQ values in the following two PSWI panels to the exact same HLQ, and the HLQ must NOT have the '.T' component.

• 'Configure Deployment - Data Sets'
• 'Perform Workflows - Define variables - Define main variables - Zowe setup MVS prefix'

These two panels are very far apart in the workflow sequence. I saw no indication that the HLQ had to be the same.

The app could have:

• Documented that the HLQ has to be the same, or better yet
• Automatically set the default in the second panel to be the same as the first panel, or better yet,
• Not asked for the second HQL. If they have to be the same, just use the first HLQ without asking the user to repeat information in the second panel.

4. Before running the 'Run the Zowe init' step, I must edit zowe.yaml to change every reference from MyUserId.ZWE.V3 to MyUserId.ZWE.V3PSWI.T, except those references that contain MyUserId.ZWE.V3PSWI.CUST.

5. The 'Run the Zowe init' job now completes successfully.

Expected behavior

Since the workflow creates the datasets and catalogs datasets behind the scenes, I expect that the workflow should have automatically cataloged any required dataset that it creates.

The steps listed above are a lot of work to place on the user. Some or all of the following actions could help users avoid the error, avoid the elaborate debugging, and avoid the reconfiguration actions.

• Alter programming logic to create the correctly named dataset and catalog it.
• Modify the UI to be more intuitive to avoid the error.
• Document the nature of the values that must be supplied and the actions that are required by the user.

Desktop (please complete the following information):

• OS: z/OS 3.1
• Window 11
• Browser: Chrome
• Version: Version 131.0.6778.140 (Official Build) (64-bit)

[JoeNemo]

Working with Zowe datasets that are not part of an HLQ that is already cataloged is outside the scope of what Zowe can control.