z/OS System Utilities & JCL Syntax Error Correction
Part Two - Challenge #13

Background:

Challenge description

z/OS includes many system utility programs. The challenge exposes you to a few of the system utility programs. These system utility programs can be executed interactively or more commonly executed in batch. "Batch" implies submitting JCL to execute the system utility programs in the background.

The challenge involves using JCL to execute various system utility programs to

  1. Allocate an MVS sequential data set
  2. Allocate an MVS partitioned data set
  3. Allocate an MVS partitioned data set extended
  4. Define an MVS VSAM KSDS data set
  5. Allocate a Unix File
  6. Write a record into the MVS sequential data set
  7. Write the record from the MVS sequential data set to an MVS partitioned data set member
  8. Write the record from the MVS sequential data set to an MVS partitioned data set extended member
  9. Write the record from the MVS sequential data set to an MVS VSAM KSDS
  10. Write the record from the MVS sequential data set to a Unix file
  11. List your data sets
  12. Upon success, delete all newly allocated MVS data sets and the Unix file

You will be challenged to identify and correct a number of JCL syntax problems and system utility program commands for all JCL job execution steps to complete successfully.


List of the system utility programs used in the challenge
  • IDCAMS
      Used to define, alter, and delete VSAM data sets
      Used to repro (copy) data records into VSAM data sets from other data sources
      Used to repro (copy) data records from VSAM data sets into other data sources
      Used to delete and alter/rename MVS sequential and partitioned data sets
  • IEFBR14
      A dummy program but useful for JCL DD operations such as allocating new data sets
  • IEBGENER
      Used to copy sequential data set records
  • IEBCOPY
      Used to copy partitioned data set member records
  • IKJEFT01
      Used to execute TSO environment in background
  • BPXBATCH
      Used to execute Unix environment in background

Challenge:

Submit JCL, Review Output, and Correct Syntax Errors
  1. Enter tso submit 'zos.public.jcl(ch13)'
      You will need to enter a unique job character suffix for the generated JCL JOB statement
  2. Review the JCL job output to identify initial JCL syntax errors
  3. Enter dslist jcl
  4. Edit your jcl partitioned data set
  5. Select new member name ch13, s ch13
  6. copy 'zos.public.jcl(ch13)'
  7. Correct the identified syntax errors
  8. Submit and review output, sub ; =sd ; st
  9. After correcting the initial JCL syntax errors, more errors appear requiring identification and correction

The challenge will take more time than previous challenges. The JCL stream has several problems where some problems only surface after correcting previous problems.

**Review twisties below for "Description of JCL" and "Problem Identification Assistance".


Description of JCL JOB CH13
  1. DELETE step executes program IDCAMS
      Delete previously created data sets preparing to create new data sets
  2. DEFINE step executes program IDCAMS
      Define a VSAM KSDS
  3. ALLOCATE step executes program IEFBR14
      Creates 3 MVS data sets, sequential, partitioned, and partitioned extended
  4. C1 step executes program IEBGENER
      Copy single record to the newly created sequential data set
  5. C2 step executes program IEBGENER
      Copy record from sequential data set to partitioned data set member
  6. C3 step executes program IEBGENER
      Copy record from sequential data set to a Unix file
  7. C4 step executes program IEBCOPY
      Copy member from a partitioned data set member to a partitioned data set extended
  8. C5 step executes program IDCAMS
      Copy record from sequential data set to a VSAM KSDS
  9. LISTC step executes program IKJEFT01
      List all data set names beginning with your ID
      LISTC step will only execute IF all previous steps receive RC of 00
  10. D1 step executes program IDCAMS
      Delete previously created data sets preparing to create new data sets
  11. D2 step executes program BPXBATCH
      Remove unwanted Unix files from your Unix subdirectory

Problem Identification Assistance

The first time submitting ch13 JCL, the job output reports JCL errors on STMT NO. 12 and 24. Statement 12 errors are associated with the EXEC statement. Statement 24 errors are associated with the DD statement. The JESJCL section of the output shows the JES read JCL statements numbers referenced by the JCL error messages. Use ISPF primary command, hilite jcl, for additional assistance.

Submitting ch13 JCL after successfully correcting the first set of JCL syntax errors, the job output reports JCL errors on STMT NO. 9, 10, 11, and 19. Internet search for zos dsorg for assistance on replacing @@ with correct values for the sequential data set and the partitioned data sets. Statement 19 error is a misspelled JCL reserved value. Internet search for zos disp for assistance.

Submitting ch13 JCL after successfully correcting the second set of JCL syntax errors, the job output does not report specific JCL syntax error associated with a specific JCL statement number. Review of the output includes STEPNAME C3 with an RC of FLUSH. Near the bottom of the JESYSMSG DDNAME, the problem can be identified. JCL job needs to update your FILENAME directory. What is the FILENAME directory in the JESYSMSG?

Submitting ch13 JCL after successfully correcting the third set of JCL syntax errors, again the job output does not report specific JCL syntax error associated with a specific JCL statement number. Review of the output immediately after execution of JCL step C3, includes +IEB157I PD@ DD STATEMENT NOT FOUND with JCL step C4 receiving RC of 8. Review of DDNAME SYSPRINT associated with StepName C4 is the best description to identify the exact problem. The utility copy command has an incorrect INDD value.

You're in the final stretch. Submitting ch13 JCL after successfully correcting the forth set of JCL syntax errors, again the job output does not report specific JCL syntax error associated with a specific JCL statement number. Review of the output reports execution of JCL step C5 receiving RC of 12. Review of DDNAME SYSPRINT associated with StepName C5 is the best description to identify the exact problem. The utility command is misspelled.


Successful completion includes member name #13 in P2.OUTPUT with list of your data sets prior to deleting the challenge 13 created data sets.

NEXT!

Next: Challenge #14