Issue with docs.zowe.org/stable/user-guide/configuring-zowe-via-jcl/

[colinpaicemq]

Description

//ZWEIAPF2 JOB

• • • • • • • • • • 22 Line(s)
                    //APFAUTH EXEC PGM=BPXBATCH
                    //BPXPRINT DD SYSOUT=*
                    //STDOUT DD SYSOUT=*
                    //STDERR DD SYSOUT=*
                    //STDPARM DD *
                    SH cd 'CFG.ZOWE.RUNTIMEDIRECTORY' &&
                    cd bin/utils &&
                    export LOADLIB='IBMUSER.ZWEV3A.SZWEAUTH' &&
                    export LOADLOC=SMS &&
                    export PLUGLIB='IBMUSER.ZWEV3A.CUST.ZWESAPL' &&
                    export PLUGLOC=SMS &&
                    ./opercmd.rex "SETPROG APF,ADD,DSN=$LOADLIB,$LOADLOC" &&
                    ./opercmd.rex "SETPROG APF,ADD,DSN=$PLUGLIB,$PLUGLOC"
                    //*

gives me on the console

$HASP100 IBMIAPF ON INTRDR FROM TSU06201
COLIN
IRR010I USERID COLIN IS ASSIGNED TO THIS JOB.
IEFC165I // SETPROG APF,ADD,DSN=&LOADLIB.,&LOADLOC. 872
05 IEFC166D REPLY Y/N TO EXECUTE/SUPPRESS COMMAND
CNZ2605I At 17.50.58 the system will automatically 874
reply: Y
to the following WTOR:
0005 IEFC166D REPLY Y/N TO EXECUTE/SUPPRESS COMMAND
R 0005,Y
CNZ2606I System has automatically replied: 876
Y
to the following WTOR:
0005 17.50.56 2025033 IEFC166D REPLY Y/N TO EXECUTE/SUPPRESS COMMAND
IEE600I REPLY TO 05 IS;Y
SETPROG APF,ADD,DSN=&LOADLIB.,&LOADLOC.
IEFC165I // SETPROG APF,ADD,DSN=&PLUGLIB.,&PLUGLOC. 879
06 IEFC166D REPLY Y/N TO EXECUTE/SUPPRESS COMMAND
CNZ2605I At 17.51.03 the system will automatically 881
reply: Y
to the following WTOR:
0006 IEFC166D REPLY Y/N TO EXECUTE/SUPPRESS COMMAND
ASA100I SYNTAX ERROR: 882
EXPECTED BEFORE &.
DETECTING MODULE IS CSVPRTMS
R 0006,Y
CNZ2606I System has automatically replied: 884
Y
to the following WTOR:
0006 17.51.01 2025033 IEFC166D REPLY Y/N TO EXECUTE/SUPPRESS COMMAND
IEE600I REPLY TO 06 IS;Y
SETPROG APF,ADD,DSN=&PLUGLIB.,&PLUGLOC.

So the system cancelled my request, and the request wrong

SETPROG APF,ADD,DSN=&LOADLIB.,&LOADLOC.

and ...

This only exists for the duration of the IPL.

it would be better to print out the statements and say

"Update your PROG* defininions in the PARMLIB concatenation, and activate them.

----- or ---
skip all of this JCL and document

Add
APF ADD
DSNAME(IBMUSER.ZWEV3.SZWEAUTH) SMS
APF ADD
DSNAME(IBMUSER.ZWEV3.CUST.ZWESAPL) SMS

or similar to your PROG* definitions in PARMLIB concatenation, and activate them.

For example update member PROGZW, and activate it using
T PROG=ZW

Pages to Update

Screenshots

Expected behavior

Additional context

[1000TurquoisePogs]

This JCL seems to work on some systems but not others.
It's expected in the case of APF, users wouldn't want to do this anyway and would prefer doing actions manually.

This is why the doc includes the manual action:

Is this not a sufficient explanation?

There is a second page https://docs.zowe.org/stable/user-guide/apf-authorize-load-library which isn't referenced in that table.
Do you think it would be good to do so?

Can you provide a suggestion for improvement because it's not clear to me how to proceed on this.