[TEST] Sync of feature/v3/jcl on v3.x/staging

[MarkAckert]

Test PR so we can compare the changes in this PR against the existing feature/v3/jcl which is based on v2.x/staging.

When these changes look correct, we'll rebase the feature/v3/jcl branch.

[github-actions]

build 6855 SUCCEEDED.
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/12986134535

[github-actions]

Test workflow 6021 is started.
Running install test: Convenience Pax
The zowe artifact being used by this test workflow: libs-snapshot-local/org/zowe/3.1.0-PR-4107/zowe-3.1.0-pr-4107-6855-20250127094846.pax
Running on machine: zzow11
Result: SUCCESS
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/12986237266

[Martin-Zeithaml]

Improvements needed:

Messages

The message ZWEL0319E seems to be overloaded:

ZWEL0319E||NodeJS required but not found. Errors such as ZWEL0157E may occur as a result. The value 'node.home' in the Zowe YAML is not correct. 
ZWEL0319E|319|zowe.setup.dataset.jcllib does not exist, cannot run. Run 'zwe init', 'zwe init generate', or submit JCL ${prefix}.SZWESAMP(ZWEGENER) before running this command.
ZWEL0319E|319|Configuration stored in PARMLIB must use member name ZWEYAML when using generate action.

Update of parmlib

zwe init updates a members and then it fails:

zwe init -c 'ZOWE.PARM(HELLO)' --update-config
Writing temp file for PARMLIB update. Command= cp -v "/tmp/.zweenv-7470/zwe-parmlib-3194" "//'ZOWE.PARM(HELLO)'

ERROR: ZWEL0319E Configuration stored in PARMLIB must use member name ZWEYAML when using generate action.

It should fail before any update.

Parmlib

zwe init --config 'PARMLIB(ZOWE.PR#4107.PARMLIB(A))' will cause a problem here as the config path is split based on words FILE|PARMLIB. I am afraid, the word PARMLIB is used for, ehm, parmlib very often. This must be rewritten.

[github-actions]

build 6862 FAILED.
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/13007956985

[github-actions]

build 6863 SUCCEEDED.
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/13008398375

[github-actions]

Test workflow 6029 is started.
Running install test: Convenience Pax
The zowe artifact being used by this test workflow: libs-snapshot-local/org/zowe/3.1.0-PR-4107/zowe-3.1.0-pr-4107-6863-20250128103229.pax
Running on machine: zzow10
Result: SUCCESS
Link to workflow run: https://github.com/zowe/zowe-install-packaging/actions/runs/13008519072

[MarkAckert]

@Martin-Zeithaml do you think this is ready to merge into #3718? After merge, we can change the head on that PR to v3.x/staging

[Martin-Zeithaml]

@Martin-Zeithaml do you think this is ready to merge into #3718? After merge, we can change the head on that PR to v3.x/staging

I thought this will be merged (some day) into v3.x/staging and the #3718 will be just deleted.
I am testing this and making changes here only. There are some new problems.

[MarkAckert]

We should close out #3718 then to avoid confusion with this PR. I can update the title and description. cc @1000TurquoisePogs does that sound OK to you?

[MarkAckert]

@Martin-Zeithaml do you think this is ready to merge into #3718? After merge, we can change the head on that PR to v3.x/staging

I thought this will be merged (some day) into v3.x/staging and the #3718 will be just deleted. I am testing this and making changes here only. There are some new problems.

I took a stab at problems 2 and 3, without a complete test suite pointed at it. I added a new message ZWEL0320E which may not help with overloaded or sprawling messages...

[Martin-Zeithaml]

Apfauth

Help:

• zowe.setup.dataset.authLoadlib is the user custom APF LOADLIB. This field is
  optional. If it's not defined, SZWEAUTH from zowe.setup.dataset.prefix data
  set will be APF authorized.
• zowe.setup.dataset.authPluginLib is the user custom APF PLUGINLIB.
  You can install Zowe ZIS plugins into this load library.

zowe.setup.dataset.authLoadlib and zowe.setup.dataset.authPluginLib omitted in config and this is generated by ZWEGEN00:

//STDPARM DD *                                          
SH cd '/zowe/' &&                       
cd bin/utils &&                                         
export LOADLIB='CFG.ZOWE.SETUP.DATASET.AUTHLOADLIB' &&  
export LOADLOC=SMS &&                                   
export PLUGLIB='CFG.ZOWE.SETUP.DATASET.AUTHPLUGINLIB' &&
export PLUGLOC=SMS &&                                   
./opercmd.rex "SETPROG APF,ADD,DSN=$LOADLIB,$LOADLOC" &&
./opercmd.rex "SETPROG APF,ADD,DSN=$PLUGLIB,$PLUGLOC"   
//*                                                     

When trying zwe init apfauth -c ./zowe.yaml:

ERROR: Error ZWEL0157E: zowe.setup.dataset.authLoadlib is not defined in Zowe YAML configuration file.

Expectation:
If zowe.setup.dataset.authLoadlib and zowe.setup.dataset.authPluginLib omitted, the JCL will authorize only zowe.setup.dataset.prefix.SZWEAUTH.

[MarkAckert]

I started on the Apfauth updates, testing in the other PR. More changes to come - the first commit isn't working yet.