Fans of IBM Z

Fans of IBM Z Hub

Fans of IBM Z Hub

Join us and share the love of IBM Z with our global community!

 View Only
Expand all | Collapse all

Understanding JCL error - IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD

  • 1.  Understanding JCL error - IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD

    Posted Thu March 14, 2024 01:59 PM

    I've been working through JCL1 Orchestrating the Enterprise on IBM Z Xplore

    IBM Z Xplore remove preview
    IBM Z Xplore
    View this on IBM Z Xplore >

    I've reached section 7 on fixing an error in the JCL job. I've made changes to the file and submitted:

    //JCL1     JOB
    //COPYJCL2 EXEC PGM=IEBGENER
    //SYSPRINT DD SYSOUT=JES2
    //SYSIN    DD DUMMY
    //SYSUT1   DD DISP=SHR,DSN=ZXP.PUBLIC.JCL(JCL2)
    //TARGET   DD DISP=SHR,DSN=&SYSUID..JCL(JCL2)
    //*
    //COPYJCL3 EXEC PGM=IEBGENER
    //SYSPRINT DD SYSOUT=JES2
    //SYSIN    DD DUMMY
    //SOURCE   DD DISP=SHR,DSN=ZXP.PUBLIC.JCL(JCL3)
    //SYSUT2   DD DISP=SHR,DSN=&SYSUID..JCL(JCL3)
    

    However, I get the error:

      STMT NO. MESSAGE
     -
             3 IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD
             8 IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD
    

    I have read the page on the error, but I'm still not understanding what I need to fix (yet). I've only started exploring zOS and ZOWE in the last fortnight so don't feel confident enough to identify or fix my issue



    ------------------------------
    Max Russell
    ------------------------------


  • 2.  RE: Understanding JCL error - IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD

    Posted Thu March 14, 2024 02:01 PM

    Max, please use the forums within the IBM Z Xplore platform. The learner community is very helpful and help you with the error you are encountering. Hope this is helpful and all the very best in your journey with learning about mainframes on IBM Z Xplore.



    ------------------------------
    SUDHARSANA SRINIVASAN
    IBM Z Advocacy Program Manager
    IBM
    ------------------------------



  • 3.  RE: Understanding JCL error - IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD

    Posted Thu March 14, 2024 02:14 PM

    thank you, I've already actually contact support because my posts to those forums have not been created/moderated and approved. I'd posted here just in case someone could assist.



    ------------------------------
    Max Russell
    ------------------------------



  • 4.  RE: Understanding JCL error - IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD

    Posted Fri March 15, 2024 04:32 AM

    I won't give the answer here but a ppointer to where the answer is and a hint, with IBM mainframes, always read the manuals, you will find your answer there. It might take time. you may well get frustrated but in the end you will learn a lot of other things on the way:

    SYSOUT parameter - IBM Documentation

    Sebastian



    ------------------------------
    Sebastian Welton
    ------------------------------



  • 5.  RE: Understanding JCL error - IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD

    Posted Mon March 18, 2024 06:39 PM

    Max, I assume that by now you have seen that your JCL makes no sense.  IEBGENER has no support for any DD statements named TARGET and SOURCE.  It is over 50 years old and has no AI logic.  The DD name for the input data set is SYSUT1.  The DD name for the output data set is SYSUT2.  That is stated clearly in the Utilities book.



    ------------------------------
    Wayne Rhoten
    ------------------------------



  • 6.  RE: Understanding JCL error - IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD

    Posted Tue March 19, 2024 02:01 PM

    Wayne - thanks, yes. Specifically which documentation should I be looking at to assist my learning here? As I've stated, I believe, the JCL is based on the task in the x xplore JC1 fundamentals section. I am new to this so I am very willing to read the manuals if pointed at the relevant section.

    the DD statements are in there from the example in the code (which is to be fixed).

    IBM Z Xplore

    IBM Z Xplore remove preview
    IBM Z Xplore
    View this on IBM Z Xplore >

    https://ibmzxplore-static.s3.eu-gb.cloud-object-storage.appdomain.cloud/JCL1.pdf



    ------------------------------
    Max Russell
    ------------------------------



  • 7.  RE: Understanding JCL error - IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD

    Posted Tue March 19, 2024 02:29 PM
    So the two incorrect DD statements will just cause IEBGENER to fail, and not cause a JCL error.
    The JCL error is because the SYSOUT keyword requires a single character class and not a four character subsystem name.
    Just use * as the class.
    Then change the SOURCE and TARGET DD names to SYSUT1 and SYSUT2.







  • 8.  RE: Understanding JCL error - IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD

    Posted Wed March 20, 2024 01:31 AM

    Max,

    The complete reference of all DFSMS utilities is available at 

    https://www.ibm.com/docs/en/zos/3.1.0?topic=utilities-introduction

    Look at the left side panel for description of each utility.


    If you want a simple description and examples you can try this 

    https://www.ibm.com/docs/en/zos-basic-skills?topic=programs-data-set-utilities



    ------------------------------
    Sri Hari Kolusu
    ------------------------------



  • 9.  RE: Understanding JCL error - IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD

    Posted Wed March 20, 2024 04:26 AM

    hi Max

    the PDF you show has links to basic JCL documentation and to the IEBGENER JCL requirements, as well as a description in the document about the JCL statements that are needed for the IEBGENER program to execute properly. The task in the JCL1 challenge is simply to edit the example JCL to meet the requirements.

    I see in one post in this thread that you said that your posts to the IBM Z XPlore (ZXP) forum " have not been created/moderated and approved" -- as a full member of the platform, there are no restrictions on you posting comments to existing topics, or creating new topics, nor is there anything preventing you from raising a chat question with the Administrators.

    There is no record of you making any forum posts; you were also messaged directly by the Admins on ZXP last week - you have not acknowledged so far.

    As Sudharsana noted, the ZXP forum is very active, and focused on ZXP challenges - please check there again, as the Search function gives you access to the full history of user questions and answers, the vast majority from users new to the platform, like yourself, all willing to share hints, tips (and frustrations ...)



    ------------------------------
    ross cruickshank
    Winchester
    ------------------------------



  • 10.  RE: Understanding JCL error - IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD

    Posted Thu March 21, 2024 04:45 PM

    I did enquire of support if my posts had been created or possibly not moderated/approved. However, it is good to get confirmation they weren't created. I use Safari on Mac. When I go to the https://www.ibm.com/community/z/discussions/ page, the discussions never load up, they remain blanked out with an oscillating grey swipe effect. Not sure I'll be able to use those forums.



    ------------------------------
    Max Russell
    ------------------------------



  • 11.  RE: Understanding JCL error - IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD

    Posted Wed March 20, 2024 02:18 PM
    SYSOUT=JES2 is invalid..... SYSOUT=* is valid .... I suspect challenge instruction may have include explanation that SYSOUT can be written to JES2 spool which is SYSOUT=* .... The Z Xplore Q&A is the appropriate 'community' for these types of Z Xplore issues encountered





  • 12.  RE: Understanding JCL error - IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD

    Posted Thu March 21, 2024 03:54 PM

    My preferred place for z/OS documentation is https://www.ibm.com/docs/en/zos/3.1.0?topic=documentation-pdf-files-zos-310-library.
    That shows all of the hundreds of manuals for z/OS 3.1 in PDF form.  On the other hand, you can go tohttps://www.ibm.com/docs/en/zos/3.1.0 which shows the same manuals in a different format, which is more web-oriented.
    The latter format is harder to read because it is chopped up into sections, instead of being continuous as in a real book.
    In any case, you are looking for the book named JCL Reference.  It is in the mislabeled "MVS" category.  (I say "mislabeled" because it used to be the name of the operating system; now that part of the operating system is correctly called "BCP", basic control program).
    You might be tempted to search with Google but it tends to give you older references because they have been more popular.
    You should browse manuals to get a high level view of the most useful ones for you.  For example here are very useful manuals in the MVS section:
       System Messages (many volumes)
       System Codes (It has system abend codes.  Wait state codes are only for system programmers)
       Programming: Assembler Services Guide
       Programming: Assembler Services Reference
    In the DFSMS category:
       Using Data Sets
       Macro Instructions for Data Sets



    ------------------------------
    Wayne Rhoten
    ------------------------------



  • 13.  RE: Understanding JCL error - IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD

    Posted Fri March 22, 2024 02:09 AM

    SYSOUT=JES2 is incorrect



    ------------------------------
    Diosdado Ortiz
    ------------------------------



  • 14.  RE: Understanding JCL error - IEF642I EXCESSIVE PARAMETER LENGTH IN THE SYSOUT FIELD

    Posted Fri March 22, 2024 02:13 AM

    SYSOUT=JES2 is incorrect



    ------------------------------
    Diosdado Ortiz
    ------------------------------