IBM Support

JSFILE COPY OCCURS TOO FREQUENTLY OR NOT AT ALL MSG EQQN017I

Troubleshooting


Problem

The JSFile VSAM JCL REPOSITORY is automatically RE-ORGed by the TWSz CONTROLLER as specified by the JTOPTS MAXJSFILE() keyword. Many users have difficulty understanding how this processing works.

Resolving The Problem

The frequency of the CONTROLLER JSFILE BACKUPs is controlled by the JTOPTS MAXJSFILE() keyword. Check the CUSTOMIZATION AND TUNING manual for documentation on this initialization parameter.

MAXJSFILE can have one of three different values.

  1. 0 -- means do a backup whenever the active JSFILE becomes two cylinders larger than it was when the CONTROLLER was started.
  2. NO - means disable the automatic JSFILE backup process and do the BACKUP/RE-ORG processing **ONLY** ON COMMAND (When an EQQEVPGM job is run with sysin BACKUP RESDS(JS)). Check APPENDIX A of the PLANNING AND SCHEDULING THE WORKLOAD manual for info on the various invocations of EQQEVPGM.
  3. nnnnn - where nnnnn is a number which is multiplied by 1,000,000 to find the maximum HIGH USED RBA of the active JSFile (in bytes). The CONTROLLER submits 50 jobs, then checks the size of the active file. If it exceeds the MAXJSFILE value, a backup is done. Then another 50 jobs are submitted and the filesize is checked again. If the REORG/COPY does not bring the size of the active JSFILE below the specified value, you will end up doing the REORG/COPY after every 50 jobs.

Most customers elect to SCHEDULE an EQQEVPGM BACKUP job once or twice per day during the times when OPC/TWSz is LEAST BUSY, and to set MAXJSFILE() either to a very large number, or set it to NO.
      NOTE:
      1) If MAXJSFILE(NO) is set, then a BACKUP job *MUST* be explicitly scheduled.

      2) As documented in the manual, in the SUBSYS parameter in the SYSIN for this job must be the TRACKER on the LPAR where the job executes.

[{"Product":{"code":"SSRULV","label":"IBM Workload Scheduler for z\/OS"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"--","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"All Versions;Version Independent","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
13 September 2019

UID

swg21141063