A fix is available
APAR status
Closed as program error.
Error description
Added standalone procedure support and other fixes.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: Users of IBM JCL Expert 1.2. * **************************************************************** * PROBLEM DESCRIPTION: 1. JCL Expert issues error CXPS0503E * * when run against a standalone * * cataloged procedure. * * * * 2. Users see two CXPS0718W warning * * messages for unresolved symbols when * * an unresolved symbol is found at the * * sub-parameter level and SYMCHECK is * * ON. * * * * 3. IZWS substitution values are not * * shown in the ISPF editor interface, * * and the original (pre IZWS * * substitution) text is not shown in * * the JCL Expert z/OS UNIX interface * * text output. * * * * 4. The JCL Expert z/OS UNIX interface * * help says it supports REXX mode * * output, but it doesn't. * * * * 5. The JCL Expert z/OS UNIX interface * * and ISPF editor interface * * incorrectly show aggregate * * statements after the first * * contributing statement. * * * * 6. The JCL Expert z/OS UNIX interface * * text colors do not clearly * * de-emphasize comments and unused * * code. * * * * 7. The IZWS substitution value * * &OJOBNAME is not supported. * * * * 8. The error messages from IZWS during * * IZWS symbol substitution are only * * visible in trace mode. * * * * 9. INCLUDE statements are not * * syntactically checked. * * * * 10. JCL Expert issues error CXPS0460E * * when validating JCL that deletes a * * GDG generation, then references * * that GDG dataset in a subsequent * * step. * * * * 11. Users see CXPS0419E error message * * when running JCL Expert against JCL * * that includes over 3,273 lines of * * DD instream data. * * * * 12. JCL Expert issues error CXPS0460E * * and displays a truncated DSN when * * a generation is deleted in the * * prior step. * **************************************************************** * RECOMMENDATION: Apply the provided PTF. * **************************************************************** 1. JCL Expert does not support JCL checking for standalone cataloged procedures. JCL Expert issues error CXPS0503E, since it sees the cataloged procedure as a job with a missing JOB statement. The rest of the JCL is processed as if it is a part of a job and not a cataloged procedure. 2. JCL Expert checks for unresolved symbols at the parameter level and the sub-parameter level. When a symbol is found at the sub-parameter level, the warning is issued twice. 3. JCL Expert calls the preprocessor on the input text and then validates the output from the preprocessor as if it is the original source text. The ISPF interface doesn't re-display the preprocessor output because it operates as if it is the original text displayed in the ISPF edit session. Similarly, the JCL Expert z/OS UNIX text output only displays the validated text and not the original text. 4. REXX is not recognized as a valid output mode for the JCL Expert z/OS UNIX -o parameter. 5. Aggregate JCL statements are displayed after the first line of JCL in the statement, making it unclear which of the following lines of JCL are part of the statement. 6. Comments and unreachable JCL statements are highlighted in the same way as validated JCL statements. 7. IZWS substitution for &OJOBNAME is not coded in JCL Expert's call to EQQAAPI. 8. If the IZWS variable substitution fails, the error messages that IZWS generates stay in JCL Expert's debug log and are not issued to the user. 9. The syntax of INCLUDE statements is not validated. If the INCLUDE statement contains a valid MEMBER=name specification, it is processed, but the INCLUDE statement may fail if the job is run. 10. When a GDG generation is deleted, JCL Expert incorrectly assumes that the GDG base has been deleted and the dataset no longer exists. 11. JCL Expert incorrectly counts DD instream data statements towards the JCL statement count. 12. JCL Expert truncates the DSN for GDGs when checking for the existence of the GDG base after a delete in a previous step, causing JCL Expert to incorrectly assume that the GDG base does not exist.
Problem conclusion
1. JCL Expert now validates standalone cataloged procedures. 2. Message CXPS0718W is issued once at the parameter level. 3. The source text is now displayed, followed by the preprocessor output if it differs from the source text. 4. The JCL Expert z/OS UNIX line command now accepts and correctly processes the -o REXX parameter. 5. Aggregate statements are displayed after the last line of input JCL. The aggregate statement is only shown for JCL statements split over 2 or more lines and shows the preprocessor text. 6. The color coding has been enhanced to better distinguish different types of data. 7. The &OJOBNAME parameter is now passed to EQQAPI, allowing it to be substituted by the IZWS preprocessor. The value will be either the first job's jobname or the constant 'JOBNAME' if the job's jobname is coded as &OJOBNAME. 8. Any unrecognized error messages from IZWS during variable substitution will be output at the end of the JCL analysis report as product messages. 9. Syntax checking has been added for INCLUDE statements. 10. JCL Expert no longer issues error CXPS0460E when validating JCL that references a GDG generation when the GDG base exists. 11. JCL Expert now excludes lines of instream data from the total statement count. 12. JCL Expert now correctly reads the entire DSN for the GDG generation.
Temporary fix
Comments
APAR Information
APAR number
PH69781
Reported component name
Z JCL EXPERT
Reported component ID
569802000
Reported release
120
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2026-01-21
Closed date
2026-02-04
Last modified date
2026-03-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UO06692 UO06693
Modules/Macros
CXPACPTE CXPACPTJ CXPALOCE CXPALOCJ CXPAPLYE CXPAPLYJ CXPDBRM CXPDDEFE CXPDDEFJ CXPI10 CXPJCLB CXPJCLR CXPMKDIR CXPMKDR CXPMSENU CXPMSJPN CXPPX001 CXPRECVE CXPRECVJ CXPS0001 CXPS0100 CXPS0101 CXPS0200 CXPS0201 CXPS0202 CXPS0400 CXPS0500 CXPS0600 CXPS0700 CXPS0701 CXPS0800 CXPS0801 CXPS0802 CXPS0803 CXPS0804 CXPS0805 CXPS0806 CXPS0807 CXPS0900 CXPS0901 CXPS0902 CXPS0903 CXPSHJCL CXPSMPE CXPSRV CXPXPERT CXPZFS
Fix information
Fixed component name
Z JCL EXPERT
Fixed component ID
569802000
Applicable component levels
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU029","label":"Software"},"Product":{"code":"SSSY40","label":"IBM Z JCL Expert"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"120"}]
Document Information
Modified date:
02 March 2026