HORIZONT 1 SmartJCL ® The Complete JCL Solution Product Presentation HORIZONT Software for Datacenters Garmischer Str. 8 D München Tel ++49(0)89 / SmartJCL

HORIZONT 2 SmartJCL ® What is SmartJCL ? SmartJCL validates JCL -Syntax -Utilities (like IDCAMS, Sort, etc.) -Program found / not found -Dataset allocation, Access authority check SmartJCL has many additional functions like -Reformat -Remote check -Standards Check, Change Facility, REXX interface -Scheduler interface (Control-M, TWS for z/OS) SmartJCL can be used as Edit Macro, in Batch, from ISPF or eclipse Integrated in ProcMan, it offers full JCL Change Management -Moves JCL through all stages, e.g. from Test to Integration to Production -Full history, e.g. a JCL containing all versions It’s more then a simple JCL Checker. It offers many additional features that makes it a complete JCL management tool:

HORIZONT 3 SmartJCL ® Table of Contents JCL Validation REXX Interface Reformat Scheduler Interfaces Remote Check Change Facility Rules for Standards Check ISPF Dialog ProcMan: JCL Change Management

HORIZONT 4 SmartJCL ® JCL Validation - Edit Macro Type JCK …

HORIZONT 5 SmartJCL ® JCL Validation – DSN Catalog 1. Summary The result: 2. Labels to locate the error 3. Error message

HORIZONT 6 SmartJCL ® JCL Validation – DSN Catalog Error fixed: The inserted IDCAMS step deletes the DSN before its new creation. But IDCAMS requires SYSPRINT... Yes, SmartJCL would also verify GDG processing

HORIZONT 7 SmartJCL ® JCL Validation – PGM not found Program names are not only taken from PGM= but also DB2 (and IMS) calls are recognized

HORIZONT 8 SmartJCL ® JCL Validation – Utilities Besides IDCAMS, IEBGENER, IEBCOPY etc. SORT statements are checked

HORIZONT 9 SmartJCL ® JCL Reformat Administrator specifies positions of keyword, value and continuation line individually for each JCL parameter according to your company needs User invokes the function out of the ISPF editor with a simple line command JCL is reformatted automatically according to your specifications Use the reformat function to change the JCL format quickly and easily to conform readable standards

HORIZONT 10 SmartJCL ® JCL Reformat Type JREF … Unformatted JCL is difficult to read

HORIZONT 11 SmartJCL ® JCL Reformat …and get the reformatted JCL

HORIZONT 12 SmartJCL ® SRI - SmartJCL REXX Interface SRI provides access to all JCL statements for verification and modification by writing simple REXX code SRI has functions to access JCL constructs easily, e.g. if qualifier(“dataset name",FIRST)=“TEST“ then... SRI contains functions to delete, insert or modify all statements, even complete steps can be inserted automatically! SRI is a powerful tool to simplify JCL handling, e.g. to -implement your own checks and setup a “JCL quality insurance system” -to change JCL automatically SRI allows to access all JCL parameters out of your REXX programs

HORIZONT 13 SmartJCL ® REXX Interface There are a lot of well documented examples which explain how the SRI functions are working Here we go through all statements, if it’s a DD we go through all parameters, if it is DSN= we check the name and do something

HORIZONT 14 SmartJCL ® Rule Dialog - Standards Check Every site has individual rules, e.g. -„the first qualifier of new datasets in production must be PROD“ -„UNIT WORK not allowed if program is SORT“ -…-… It is possible to use SmartJCL‘s REXX interface and code such checks The ISPF rule dialog simplifies that. No coding is needed to setup your own standard checks. An ISPF dialog supports an “JCL Administrator” to specify rules according to site specific standards easily:

HORIZONT 15 SmartJCL ® Rule Dialog - Standards Check An ISPF “wizard” guides you step by step to generate the conditions and actions of the rule Here we verify the DSN of new cataloged datasets, if the job run in class “P”. If it’s not okay, a message will be written and an appropriate RC will be set (that’s defined in the messages member)

HORIZONT 16 SmartJCL ® Rule Dialog - Standards Check The result of the new standards rule (DSN starts with P390K which is not allowed in prod)

HORIZONT 17 SmartJCL ® Change Facility CHANGE PARM=DSN,VALUE=PROD*,NEWVAL=TEST* DELETE PARM=UNIT DELETE JOB=ABC%,PGM=IDCAMS,PARM=UNIT,VALUE=TAPE4 In addition to the REXX Interface, SmartJCL has an integrated change facility. It enables you to implement automatic and/or mass changes easily. Examples: In case of more complex demands, use the REXX Interface

HORIZONT 18 SmartJCL ® Remote Check The Remote Check enables you to perform the JCL check on another system. Advantages are: Simplifies checking JCL from the test or development system against the production libraries on the production system. It avoids to transfer the JCL manually to the other (remote) system, logon to that system and check it locally at this system. SmartJCL remote check uses standard TCP/IP architecture -Simple TCP/IP protocol -Easy to install, easy to use It works like this: -The user create or modify JCL on the development system -The user calls RCK macro with parameter SRV=“target system” -SmartJCL transfers the JCL, runs the check remotely on the “target system” and sends back the resulting messages

HORIZONT 19 SmartJCL ® Scheduler Interfaces IBM’s TWSBMC’s CTM Skip Scheduler interfaces

HORIZONT 20 SmartJCL ® TWS Interface One of the major benefits of SmartJCL is the integrated interface to TWS: SmartJCL will simulate variable substitution (important if you use TWS variable in e.g. DSN etc.) Optional display TWS info in JCL (e.g. Application id, Predecessors, Successors, and Special Resources) Select jobs to be checked from AD or CP by Application Id, Owner Id, Input Arrival etc. Check JCL in production sequence and simulate catalog actions Several simulation modes allow to check the complete production in advance (and fix errors in advance)

HORIZONT 21 SmartJCL ® TWS Interface - Edit Macro If you use TWS variable e.g. in a DSN, it result in an error message Use macro OSJ and JCK to first resolve the variable and then call the check

HORIZONT 22 SmartJCL ® TWS Interface - Edit Macro SmartJCL searches in the CP and AD for the job. You can choose which one should be the input and if it is AD you can enter a simulation date in the future

HORIZONT 23 SmartJCL ® TWS Interface - Edit Macro The variable are resolved, no errors anymore

HORIZONT 24 SmartJCL ® TWS Interface – ISPF + Batch The ISPF dialog is mainly used to generate batch jobs and consists of three parts: Selection, Simulation, JCL Check e.g. select from AD

HORIZONT 25 SmartJCL ® TWS Interface – Select from AD Additional selection criteria The result will be a list of job names in a file

HORIZONT 26 SmartJCL ® TWS Interface – Select from CP The result will be a list of job names in a file Additional selection criteria

HORIZONT 27 SmartJCL ® Checking Jobs in Production Sequence Job creates a file Without checking the jobs in the correct sequence, a JCL checker displays a message like „dataset not found“. SmartJCL TWS Interface sort the jobs by planned start times and therefore they are checked in correct run sequence. Job reads previously created files and creates other files

HORIZONT 28 SmartJCL ® TWS Interface – Forecast The forecast creates a trial plan for any date in the future. As always, the result will be a list of job names in a file

HORIZONT 29 SmartJCL ® TWS Interface – Simulation in Batch Input is the list of jobs If the select job did run and the joblist file has been created, the simulation can be started The output file contains JCL of all jobs, sorted by planned start, all variable are resolved

HORIZONT 30 SmartJCL ® TWS Interface – JCL Check in Batch Now you can start the JCL check of all previously selected and simulated jobs

HORIZONT 31 SmartJCL ® TWS Interface – JCL Check in Batch The result is (optional) a detailed list of the JCL and it’s errors and a summary which contain all messages (including the standards check) You may use the “migrated info” to recall required datasets automatically in advance

HORIZONT 32 SmartJCL ® Control-M Interface Simulate Control-M variable substitution (AUTO-Edit Funktion) Select the jobs to be checked by Table, Group, Application etc. Besides TWS SmartJCL also supports Control-M. It enables you to: Skip CTM interface

HORIZONT 33 SmartJCL ® CTM/SimJCL Startpanel Command ===> Select one of the following options and press ENTER 1 JOBLIST - Select jobs for simulation 2 SIMULATE - Start JCL simulation based on previous selection 3 CHECK - Start JCL check based on previous simulation 4 CHECK - Start JCL check without simulation 5 REFORMAT - Start JCL reformat (pre release) Note: Options 3, 4, 5 are only available, if a JCL checker is installed, for example SmartJCL Control-M ISPF Dialog Control-M Interface Mainpanel

HORIZONT 34 SmartJCL ® CTM/SimJCL - Create Joblist Command ===> top : RESET restore default values, JC change jobcards Selection Table ===> ____________________ Application ===> ____________________ Group ===> ____________________ Jobname ===> ________ Owner ===> ______________________________ Schedule Library DSN ===> DATA.CTM.MAN.SCHEDULE___________________ Output files Joblist ===> P390G.MJV.SELJOBS_______________________ Variablelist ===> P390G.MJV.SETVAR________________________ Submit ===> S S submit job, E edit before submit Control-M ISPF Dialog Select Jobs by using Control-M fields

HORIZONT 35 SmartJCL ® CTM/SimJCL - Simulate Command ===> JCL LIBRARY MODE For simulation of private members enter Y: N (Y or N) SCHEDULING LIBRARY MODE For simulation of the jobs unloaded from the SCHEDULE LIBRARY. Files Joblist (Input) ===> P390G.MJV.SELJOBS________________ JCL (Output) ===> P390G.MJV.JCLOUT_________________ CONTROL-M GLOBAL LIBRARY ===> P390A.MSJ.QM.HELPLIB_____________ Simulation (optional parameters) GROUP ===> ____________________ $SIGN ===> _ WDATE ===> ______ DDMMYY ODATE ===> ______ DDMMYY Parameters Submit ===> S S submit job, E edit Control-M ISPF Dialog Specify desired date

HORIZONT 36 SmartJCL ® File Edit Confirm Menu Utilities Compilers Test Help EDIT P390P.TEST.CNTL(SIMJCL01) COMMAND ===> ****** *********************** Top of Data **************** //SIMJCL01 JOB 'HORIZONT',MSGCLASS=T,NOTIFY=&SYSUID //*%OPC SCAN //************************************************** //DELETE EXEC PGM=IEFBR //DD1 DD DSN=P390A.%GROUP..%NO,DISP=SHR //************************************************** //ALLOC EXEC PGM=IEFBR14,COND=(4,LT) //DD1 DD DSN=P390A.%JOBNAME..LIST%NO, // DISP=(,CATLG),SPACE=(CYL,(2,5),RLSE), //************************************************** //WRITER EXEC PGM=REPORT01,COND=(4,LT) //OUT1 DD DISP=SHR,DSN=P390A.%JOBNAME..LIST%NO //IN1 DD DISP=SHR,DSN=P390A.%JOBNAME ****** ******************** Bottom of Data **************** Control-M Variables Variable...

HORIZONT 37 SmartJCL ® File Edit Confirm Menu Utilities Compilers Test Help EDIT P390P.TEST.CNTL(SIMJCL01) COMMAND ===> ****** ************************* Top of Data ************** //SIMJCL01 JOB 'HORIZONT',MSGCLASS=T,NOTIFY=&SYSUID //*%OPC SCAN //************************************************** //DELETE EXEC PGM=IEFBR //DD1 DD DSN=P390A.%GROUP..%NO,DISP=SHR //************************************************** //ALLOC EXEC PGM=IEFBR14,COND=(4,LT) //DD1 DD DSN=P390A.%JOBNAME..LIST%NO,.HAAA // DISP=(,CATLG),SPACE=(CYL,(2,5),RLSE) ==MSG> JCK0316E - INVALID DATA SET NAME FORMAT //************************************************** //WRITER EXEC PGM=REPORT01,COND=(4,LT).HAAI //OUT1 DD DISP=SHR,DSN=P390A.%JOBNAME …must be substituted before Simulation. Control-M Variables

HORIZONT 38 SmartJCL ® File Edit Confirm Menu Utilities Compilers Test Help EDIT P390P.TEST.CNTL(SIMJCL02) COMMAND ===> ****** ********************** Top of Data ***************** //SIMJCL01 JOB 'HORIZONT',MSGCLASS=T,NOTIFY=&SYSUID =NOTE= --SIMJCL01 JOB 'HORIZONT',MSGCLASS=T,NOTIFY=P390G //*%OPC SCAN //************************************************** //DELETE EXEC PGM=IEFBR //DD1 DD DSN=P390A.TEST.LIST10,DISP=SHR //************************************************** //ALLOC EXEC PGM=IEFBR14,COND=(4,LT) //DD1 DD DSN=P390A.SIMJCL01.LIST10, // DISP=(,CATLG),SPACE=(CYL,(2,5),RLSE), //************************************************** //WRITER EXEC PGM=REPORT01,COND=(4,LT) //OUT1 DD DISP=SHR,DSN=P390A.SIMJCL01.LIST10 …in order to perform a correct validation Control-M Variables

HORIZONT 39 SmartJCL ® JCL Validation – ISPF Define and select a joblib to select the job member There is an extra ISPF dialog to run JCL checks for a set of jobs in batch or foreground

HORIZONT 40 SmartJCL ® JCL Validation – ISPF Select the member and their sequence by entering a number

HORIZONT 41 SmartJCL ® JCL Validation – ISPF Command BAT would generate a job to run the check in batch, command FORE run it in foreground

HORIZONT 42 SmartJCL ® JCL Validation – ISPF The check is done, choose one of the reports, e.g. the summary

HORIZONT 43 SmartJCL ® JCL Validation – ISPF The summary shows all messages, including your own standards check messages

HORIZONT 44 SmartJCL ® ProcMan ProcMan is a very flexible handover system, specifically for JCL and TWS objects The workflow, verification and generation rules and the system environment configuration can be customized to your needs The user are guided by a modern, easy to use web dialog All objects and handover process data are stored in an archive. This helps auditors to verify the changes. See extra “ProcMan - Product Presentation.pps”

HORIZONT 45 SmartJCL ® Many thanks for your attention HORIZONT Software for Datacenters Garmischer Str. 8 D München Tel ++49(0)89 / The Complete JCL Solution SmartJCL