The Easy Way to Faultless JCL

The Easy Way to Faultless JCL
SmartJCL The Easy Way to Faultless JCL Release Notes HORIZONT Software for Datacenters Garmischer Str. 8 D München Tel ++49(0)89 / 1 1 1 1 1 1 1 1 1 1 1

Release Notes V3R2 Actual Release V3R1 V3R0 V2R4 V2R3 V2R2

SmartJCL 3.2 SmartJCL V3R2 is available since February It offers following new functions: New Eclipse / RDz plug-in Uses Remote Check Server on z/OS for a complete JCL check on z/OS Enhanced support for condition code dependent steps

SmartJCL 3.2 Support System Symbols in PARM members
New PARM member to exclude DSNs from catalog check REXX Interface supports compiled REXX pgms Support for z/OS 1.13 Enhancements JOBRC parameter In-stream data in JES2 procedures z/OS 2.1 Enhancements TWS 9.1

SmartJCL 3.2 – Edit Macro Type JCK ... 5

SmartJCL 3.2 – Edit Macro 1. Summary 2. Labels to locate the error
3 Error message 6

SmartJCL 3.2 – eclipse plug-in
Edit JCL, click right mouse and select „Execute SmartJCL Remote Check“ The JCL is transferred to z/OS and checked there 7

Error messages are inserted below the associated statement in the edited JCL (use right mouse to remove it) 8

The connection to z/OS is established via the „HORIZONT TCP/IP-Scheduler“. You can define several z/OS systems Specify IP-address, port and member name of the SmartJCL STC Procedure 9

It works identical in RDz, even if there is another Editor
SmartJCL 3.2 – RDz plug-in It works identical in RDz, even if there is another Editor 10

SmartJCL 3.2 – Cond. Steps Controls execution of below steps ... 11

SmartJCL 3.2 – Cond. Steps Depends on step SETRC
... but SmartJCL does not know the RC. 12

SmartJCL 3.2 – Cond. Steps New PARM member
Define RC for steps that are referenced in IF or COND. 13

SmartJCL 3.2 – Cond. Steps Condition codes are evaluated and job is checked correctly. 14

SmartJCL 3.2 – System Symbols
System symbols can be used for proclib specifications (JCKKPARM) and for message suppression (JCKKMSX). PROCDS parameter allows &SYSNAME, &SYSPLEX and &LPAR 15

With parm WP=Y the parms can be checked in SYSPRINT. 16

System symbol can be used for message suppression. Further new parameters for message suppression. Further new parameters for message suppression. 17

SmartJCL 3.2 – JCK-ECAT A new parm member to exclude DSNs from catalog check. The only way in the past. 18

SmartJCL 3.2 – JCK-ECAT Excluded data sets from catalog check. 19

Any Questions about SmartJCL 3.2?

SmartJCL 3.1 SmartJCL V3R1 will be available in September It will have following new functions: Many new parameters and options for JCL Check and Reformat Get DB2 subsystem from system control blocks Reformat only selected or changed JCL statements Control setting ISPF member statistics in output file JCKJCLO Check TSO program call

SmartJCL 3.1 Support for z/OS 1.12 SORT enhancements
JOINKEYS Application Date Field Conversions MERGE Operator MERGEIN Alternate ddnames ... Support for TWS 8.6

SmartJCL 3.1 ISPF dialog supports administrators
Admins are defined during installation or in JCKXPARM Admins have additional configuration options Users can only „use“ SmartJCL

SmartJCL 3.1 ISPF dialog supports administrator:
Specify admin users here ...

Available for every user. Available only for admin users.

Available for admin user only.

Available for every user.

SmartJCL 3.1 New SRI function "SriCatEntry" for catalog access and informations Returns Entry name (= DSN) Catalog name Entry type Volser Easier than LISTCAT and scanning output

SmartJCL 3.1 Enhanced JCL Change Facility
new commands DELSTMT, DELSTEP, INSERTSTMT, INSERTSTMT BEFORE FIRST (i.e. before first EXEC) DO/ENDDO block to summarize more actions for one condition RANGE (Column 1-72)

SmartJCL 3.1 Enhanced JCL Change Facility: INSERTSTMT
Insert FRIST, LAST, BEFORE, AFTER ... the statements to be inserted ... ... only if these criteria are fulfilled.

SmartJCL 3.1 Enhanced JCL Change Facility: INSERTSTMT
Insert this JCLLIB statement after the JOB statement.

SmartJCL 3.1 Enhanced JCL Change Facility:
Use multiple PARMn and VALUEn pairs for selection ... DELSTMT and DELSTEP can be combined with parameter selection.

SmartJCL 3.1 Enhanced JCL Change Facility:
PARMn, VALUEn combined with DO/ENDDO. Use multiple PARMn and VALUEn pairs for selection ... ... and PARM and VALUE for the change. Use DO/ENDDO to group more changes for a selection.

SmartJCL 3.1 This JCL is modified:
Contains the strings for the change III.JJJ as well the string AAAAA that excludes the change.

SmartJCL 3.1 Resulting JCL:
Only changed JCL statements are reformatted: SJCREF=CHANGED

SmartJCL 3.1 Enhanced JCL Change Facility: RANGE

SmartJCL 3.0 SmartJCL V3R0 is available since September It will have following major new functions: ISPF Dialog to specify rules according to customer specific standards Every site has individual rules, e.g. „UNIT must be SYSDA in SORT step“ Up to now such checks required usage of SmartJCL‘s REXX interface SmartJCL will enable non-programmers to specify complex rules by using a simple ISPF dialog See dialog on next slides

Standard Check: Entry Panel
The entry panel offers: - to work with rules - to generate SRI code

Standard Check: Options
Specify with which rules you want to work ... ... and where the generated code is to be stored.

Standard Check: Entry Panel
Start working with rules ...

Create a new rule or select an existing one to modify it ...
List of Rules Create a new rule or select an existing one to modify it ...

Modify Rule If pos. 6 of jobname is R or E and DISP not equal SHR...
… or if pos. 3 of jobname is 3 and DISP not equal SHR ... … then issue message.

All possible selection criteria can be picked from a list…

Selection Criteria Further down in the list ...
... the selection criteria provided by Standard Check

Selection Criteria JOB statement is selected …
… and all possible parameters and sub-parameters are listed ….

... as well as all comparison operators

Specify Compare Values
Values for substr Here you can enter a list of the values.

What should happen, if a condition is true?
Action for a Rule What should happen, if a condition is true?

A message can be issued or a REXX can be called.
Action for a Rule A message can be issued or a REXX can be called.

Where will the message appear?
Action for a Rule Where will the message appear?

The message has to be defined in a message member.
Action for a Rule The message has to be defined in a message member.

The rules created in the dialog are stored as XML.
XML for a Rule The rules created in the dialog are stored as XML.

Option 2 creates SmartJCL REXX Inter-face Code from XML.
Generate SRI Code Option 2 creates SmartJCL REXX Inter-face Code from XML.

Generate SRI Code

Generate SRI Code The created REXX code has to be specified with para-meter SRI-PRG for Check or Reformat.

SmartJCL 3.0 Other new functions and enhancements:
Installation - Own PARM dataset Strict separation of product libraries and parameter library (OPZXPARM in CLIST caused problems). Easier distribution/maintenance of SmartJCL to multiple z/OS systems. Scheduler Interface for TWS TWS 8.5 support

SmartJCL 3.0 Other new functions and enhancements (2): JCL Checker
z/OS 1.11 support DD EATTR parameter and SORT enhancements Check IEHPROGM control statements and consider them for catalog checks Issue warning for RACF unprotected datasets Issue warning if no alias exists for first qualifier to avoid data sets in the master catalog Message suppression: allow wildcards for message number to suppress all messages for particular members Example for PARM(JCKKMSX): JCK* MEMBER=MEMNAME

SmartJCL 3.0 Other new functions and enhancements (3): JCL Reformat
Reformat writes directly to PO files In the past a PS dataset with IEBUPDTE format was used. ISPF member statistic is updated. Reformat COMMAND statement

SmartJCL 3.0 Other new functions and enhancements (4):
SmartJCL REXX Interface (SRI) New function %SRIInclude to avoid copies of same code New function SRIChangeRef to adapt references to changed stepnames Same line numbers in SRI messages as in trace.

Any Questions about SmartJCL?

SmartJCL V2R4 SmartJCL V2R4 is available since Q It has following major new functions: Support for z/OS 1.9 OS version/release can be set by parameter OSVER= Checks new SORT parameters (from z/OS 1.4 to z/OS 1.9) DB2 Subsystem Check Check if specified DB2 subsystems are defined and active New parameters: DB2-SUBSYS-CHECK DB2SC=Y/N DB2-GROUP=db2_group_name DB2-SUBSYS=subsys_name Allow default load library for "exist program" check New parameter: DEFAULT-LOADLIB DLL=P390A.JCK.DEV.LOAD

SmartJCL V2R4 Read PROCLIBS directly from JES
Instead of specifying PROCLIBS through installation, the needed information is taken directly from JES Only for JES2 and JES3 Global, not JES3 Local New parameter: READ-SYSTEM-PROCLIB RSP=Y/N Better adaption to customer environment Set priority of parameters versus DD statements for further datasets (JCKMSGI, JCKMSXI, PWDIN) New parameter: JCK-FILE JCK-FILE=PARM PARM OR DD Support concatenated parameter members and more call paramters for edit macros. Reduces the need to create more OPZXPARM members and edit macros.

SmartJCL V2R4 Better performance Improved ISPF dialog
JCK macro reacts faster Optimized catalog check under JES3 -> less CPU time Improved ISPF dialog See next slides

Improved ISPF Dialog The main panel is an entry point to all other dialogs ... ...and it informs about available edit macros.

Specify Joblibs and Select Members

Type JCK to start the check…
Select Members Type JCK to start the check… Select members by typing ”S” in front of the member, or specify a sequence of jobs by using numbers, e.g. “1”, “2”, “3”

Check Members …the selected members are checked sequentially, every job that has an error is displayed in the editor…

...at the end the selection list shows you the resulting return codes.
Display Results ...at the end the selection list shows you the resulting return codes.

Another option is to check the selected members in FOREground...
Foreground Mode Another option is to check the selected members in FOREground...

Foreground Mode - Summary
... the summary is displayed right after the check… ..from here you can access directly messages, details, and sysprint

BATch checks the selected members in batch mode…

Batch Mode – Generated Job
... simply submit the generated job

You want to see a preview of V3R0?

SmartJCL V2R3 SmartJCL V2R3 is available since June It has following major new functions: Easier installation SVC is no longer necessary for third party RACF check Firewall friendly Remote Check (no call back) TWS variable substitution Use temporary TWS controller, no impact to production TWS controller Support for TWS 8.3 REXX interface: Access to overriding parameters and utility statements New check parameters

SmartJCL – Easier Installation
SmartJCL 2.2 used a SVC for authorization. Disadvantages were: SVC installation required system programming Assembler coding SVC has to be loaded Therefore SVC was not accepted at many sites

SmartJCL – Easier Installation
Now the TSO Service Facility is used. Parmlib member IKJTSOnn has to be modified AUTHTSF NAMES( /* PROGRAMS TO BE AUTHORIZED */ /* WHEN CALLED THROUGH THE */ /* TSO SERVICE FACILITY. */ CSFDAUTH /* ICSF */ IEBCOPY /* */ ICQASLI /* */ IKJEFF /* */ EQQMINOR /* OPC DIALOG INTERFACE */ JCKASA /* SMARTJCL ACCESS CHECK */ JCKASU /* SMARTJCL SWITCH USER */) Parmlib member IKJTSOnn has to be activated SET IKJTSO=nn

New IP Communication OLD NEW ROTJSHD TP Program ROTJSHD ROTJSHD
Port 1 Port 1 Port 1 Port 2 Server program uses the original “line” to send data to the client. That avoids firewall problems JCL in ISPF Editor JCL in ISPF Editor

SmartJCL – Simulation TWS
An additional TWS controller is used for JCL tailoring (variable substitution). Advantages are: Production controller is not influenced No performance implications No locks on JS file Highly automated Necessary files are copied from production controller Controller is started and stopped by SmartJCL jobs TWS 8.3 ready

SmartJCL – Simulation TWS
Sim TWS Prod TWS Work data sets LTP CP AD WS, OI, RD, SI EQQJBLIB EQQSCLIB PIF copy 1 create data sets 2 copy data sets from Prod TWS 3 start Sim TWS 4 create LTP, CP 4 Simulation 5 simulate TWS vars TWS/SimJCL S4 Simulation AD, WS, OI, RD, SI 7 delete data sets 6 stop Sim TWS

SmartJCL - TWS Built and start Sim TWS. Create LTP, CP. Select Jobs
Simulate Jobs Remove Sim TWS Start JCL Check

SmartJCL – REXX interface
New REXX interface functions for .... Overriding JCL statements and parameters Allows access to JCL statements used at a procedure call before replacing the procedure call Utilities Allows access to utility statements and parameters Reformat modified statements only Avoids problems with undesired modifications in JCL statements that are not modified

SmartJCL – New Parameter
New parameters for .... JCL Check ACF2 //*LOGONID Required parameters (JOB-ACCOUNTING and JOB-PGMRS-NAME) Customer specific defaults (IDCAMS left and right margin) Output Line number for SRI messages (SRI-MSGLNNUM) Customer specific start/stop messages (STARTM= and STOPM=) Output only jobs with messages (CORRECT_JOB_OUTPUT=) Suppress messages (MEMBER=) Access Check Customer specific profile name for access check (RACF-AUDIT-ENTITY) Defaults for minimal access rights

Do you have any questions about SmartJCL 2.3?

SmartJCL V2R2 SmartJCL V2R2 is available since July It has following major new functions: Improved performance (JCK edit macro) RACF Check with any userid under TSO Extended TWS variable substitution Dialog within OSJ edit macro can be adapted Read system configuration Migrate parameters while upgrading from previous SmartJCL release

SmartJCL - Performance
The performance is drastically improved for edit macros JCK and OSJ JCK. New macros are 50-80% faster as old macros Dynamic instead of static allocation Multiple allocations are avoided new parameters in JCKKPARM are replacing DD statements Proclibs are allocated only if needed

SmartJCL - Performance
No procedure call New Macro JCK 2,02 s 8,20 s procedure call - member in the FIRST proclib 2,18 s procedure call - member in the LAST proclib 4,93 s 8,19 s

SmartJCL - Check with any user
The "RACF Access Check" was introduced with SmartJCL V2R1. It allows to check the JCL with alternative users. V2R1 Available only in In batch mode In TSO mode the RACF check was only possible with the original userid V2R2 Now available in TSO mode Security Exit to allow APF authorisation by SVC requires system programming, we are still looking for alternatives

SmartJCL - Extended TWS Simulation
SmartJCl allows to simulate TWS variable substitution. Up to now SmartJCL offers two different ways to simulate variable substitution: ACTION=SIMULATE, PIF Request JCLPREPA To slow for large job amounts ( > 5000) Slows down controller performance, blocks JS file ACTION=SUBSTITUTE, HORIZONT's own substitution very fast, needs no TWS resources (only AD VSAM read access) cannot substitute all types of variables, e.g. SETVAR Upshot: Variable substitution is complete (and slow), or fast (and incomplete)!

New solution in SmartJCL V2R2: Combine both ways! Perform HORIZONT's substitution first Check if all variables are substituted? Yes: Ok, JCL is done No: Start second substitution with PIF request JCLPREPA Good compromis, but depends on customer#s environment: Worst case: Second step is always required!

New parameters (old parameters are still valid): ACTION=PIFSIM Old: ACTION=SIMULATE ACTION=HORIZONTSIM Old: ACTION=SUBSTITUTE ACTION=SIM New: Combined Substitution Only available in batch mode

Example: &OADID is not replaced by HORIZONTSIM ... ... but in the second step by JCLPREPA

SmartJCL - OSJ Edit Macro
An example: The user wants to check the JCL that is shown in the editor (and not the JCL from the JS file) In this case the user must go through several panels.

SP ...type "SP" to specify additional parameters...

...change parameter!

The dialog can be tailored to the needs of the users by modifying a parameter file: Modify dialog defaults Specify default behave

New parameter file to contol behave of the dialog

SmartJCL - Read System Configuration
Up to now it was necessary to specify system specific parameters: Smart JCL 2.2 detects automatically SMS class (up to now job JCKJSMS was needed) Master catalog MVS version

SmartJCL - Parameter The parameters in member JCKKPARM are migrated:
Old (migrated) and new (inserted) parameters are marked. Only new parameter have to be adapted.

SmartJCL - Parameter Automatic migration during Installation

Do you have any questions about SmartJCL 2.2?

V2R1 – What’s New V2R1 is available since May Major enhancements are: "Remote Check" Check JCL that is stored on Produkction directly in your test environment "Change Facility" Simply Statements to change JCL statements "Access Check" Check file access authorisation ...and much more...

V2R1 – Remote Check The Remote Check enables you to check JCL on another system. Advantages are: Simplifies checking JCL from the test system against the production libraries on the production system. Errors can be corrected easily because they are found before the JCL is transferred to the production system. It also avoids to transfer JCL manually to the remote system, logon to that system and check it locally at this system. Uses HORIZONT’s standard TCP/IP architecture Simple TCP/IP protocol (no Framework, no APPC) Easy to install

V2R1 – Remote Check The Remote Check can be used in two ways:
The ISPF dialog The ISPF dialog allows you to select jobs by name, by range or by JOBLIST. Edit macro This option is useful for checking new or modified jobs immediately before a manual submit.

V2R1 – Remote Check Remote Check ISPF Dialog
SmartJCL Remote JCL Check Command ===> Primary commands (top): OPT Browse TCP/IP parameters JOBLIST Edit joblist JOBLIB Edit joblibraries Select one of the following options and press ENTER. Member ===> ________ - ________ Specify one member (left) to check a single job, or specify two members (from member-to member) to check a range of members. Joblist ===> P390G.JCK.JOBLIST___________________________ If you do not specify any member, the Joblist will be used for selection. Joblibs ===> P390A.OPG.CNTL______________________________ Submit ===> E S submit job, E edit before submit Seclect a valid server name with S _ CPU1 _ CPU2 ******************************* Bottom of data ******************************** Remote Check ISPF Dialog

V2R1 – Remote Check Specify Target CPU Specify password
EDIT P390A.OPG.CNTL(TESTJCK) Command ===> JCK SRV=CPU Scroll ===> CSR ****** ********************* Top of Data ************************ //P390KX JOB 'SMARTJCL', // MSGCLASS=T, // NOTIFY=&SYSUID, // REGION=6M //* //ADUNL EXEC PGM=OPUIAD4, // PARM='/PW=RFKEFZR', // REGION=4M //SYSPRINT DD SYSOUT=* //OPUTEXT DD DSN=&&OPUTEXT, // DISP=(NEW,PASS), // SPACE=(TRK,(1,1)), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=80), // UNIT=SYSDA //OPUDAT DD DSN=&&OPUDAT1, // DISP=(NEW,PASS), // SPACE=(CYL,(1,1)), // DCB=(RECFM=FB,LRECL=406,BLKSIZE=16240) Specify Target CPU SmartJCL - Remote check Enter password: _________ Specify password

V2R1 – Remote Check EDIT P390A.OPG.CNTL(TESTJCK) Command ===> JCK SRV=CPU Scroll ===> CSR ****** ********************* Top of Data ************************ =NOTE= MESSAGE SUMMARY AND COUNTS: E=00001, W=00000, I=00000 =NOTE= LABEL MSG.NO. ERROR MESSAGE =NOTE= =NOTE= .HAAA JCK0440E PROGRAM OPUIAD4 NOT FOUND ON SEARCH PATH //P390KX JOB 'SMARTJCL', // MSGCLASS=T, // NOTIFY=&SYSUID, // REGION=6M //* //ADUNL EXEC PGM=OPUIAD4, // PARM='/PW=RFKEFZR', // REGION=4M //SYSPRINT DD SYSOUT=* //OPUTEXT DD DSN=&&OPUTEXT, // DISP=(NEW,PASS), // SPACE=(TRK,(1,1)), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=80), // UNIT=SYSDA The JCL is physically validated at the production system, but the results are shown in the editor on the test system

V2R1 – Remote Check Overview
TEST PROD TCP/IP //DD SYSPRINT JCL Member JCL (ISPF Editor) TCP/IP SmartJCL Procedures DSN2 Catalog-Check DSN3

V2R1 – Change Facility In addition to the REXX interface SmartJCL has a comfortable new change function. No coding In opposite to the REXX interface no coding is needed. Simply use CHANGE, DELETE and INSERT commands in connection with wildcards. Applicable for JCL statements and JCL parameter Comments (//*) In stream data More complexe logic requires REXX The Change Facility is not a replacement for zthe REXX interface, but an addition.

V2R1 – Change Facility In addition to the REXX Interface SmartJCL has an integrated change facility. It allows you to perform simple changes fast and easily. Some examples: CHANGE PARM=DSN,VALUE=PROD*,NEWVAL=TEST* DELETE PARM=UNIT DELETE JOB=ABC%,PGM=IDCAMS,PARM=UNIT,VALUE=TAPE4

V2R1 – Access Check 1 Check file access authorisation
For all files that are used in DD statement and IDCAM commands the file access authorisation is checked. The needed rights (read, udate,alter) is taken from the DISP= parameter or IDCAMS command. The check can also be done for any other user.

V2R1 – Access Check 2 User sequence
The JCL check is performed with the Userid that is specified in the jobcard. If no Userid is specified in the jobcard, it is taken from the ACUID= parameter. If the ACUID= parameter is missing, the Userid of the job submitter is taken into account.

V2R1 – Access Check 3 RACF-Audit Profil
Since earlier versions SmartJCL has a parameter to specify if access violations should be written to the SYSLOG (RA=Y|N) The parameter "RACF-AUDIT RA=N" is protected by profile 'HORIZONT.SMARTJCL.AUTHCHK.NOLOG' in class FACILITY. The user must have READ authorization for this profile to accept the RA=N setting. If the user has lower access rights than READ, the setting RA=N is ignored and changed to RA=Y

V2R1 – More enhancements 1 Additional enhancements:
Validation of Catalog Entries Checks if a dataset really exists ASA ASA characters are written to file JCKDTLO (optional). SmartJCL messages can be replaced The SmartJCL message number, return code and text can be replaced.

V2R1 – More enhancements 2 Procedures Validate fields
Called procedures are inserted after the EXEC PROC statement as "=NOTE=" lines. The "=NOTE=" lines show JCL overrides and replaced symbolic parameters. Validate fields Check the accounting information against a list of valid values. Check the SCHENV= parameter against a list of valid values. Limit error messages Abort check of a JCL member if a limit of messages is reached.

V2R1 – More enhancements 3 New header and footer for JCKDTLO and JCKSUMO The header contains the program version and the start date and time of the check. The footer contains a statistic about JCL errors. Format of JCKSUMO Format of the file JCKSUMO is now identical for JCKJCLI and JUPJInnn. Suppress job output in JCKDTLO Jobs without errors are not written to JCKDTLO (optional).

File Edit Confirm Menu Utilities Compilers Test Help EDIT P390H.SPFTEMP1.CNTL Columns Command ===> JCK Scroll ===> CSR ****** ***************************** Top of Data ************************** =NOTE= LABEL MSG.NO. ERROR MESSAGE =NOTE= =NOTE= .HAAA JUP0008E 00, ,00009,INVALID JCL STATEMENT: ' =NOTE= .HAAB JCK0002E 00, ,00000,INVALID STMT ' IN ROUTINE JCKJOB =NOTE= .HAAC JCK0316E 00, ,00000,DATA SET NOT FOUND IN CATALOG =NOTE= .HAAD JCK0316E 00, ,00000,DATA SET NOT FOUND IN CATALOG =NOTE= .HAAE JCK0270E 00, ,00000,INVALID VALUE CATL FOR THE NORMAL //P390HX JOB ,'HORIZONT',MSGCLASS=T, // NOTIFY=&SYSUID,REGION=6M =NOTE= -- NOTIFY=P390H,REGION=6M //* //****************************************************************** //* UNLOAD OPC-VSAM DSN=P390A.OPCESA.V2R0M0.AD //****************************************************************** //ADUNL EXEC PGM=OPUIAD5, .HAAB // PARM=('DEP(0),ER(0)/' =NOTE= JUP0008E 00, ,00009,INVALID JCL STATEMENT: ' =NOTE= JCK0002E 00, ,00000,INVALID STMT ' IN ROUTINE JCKJOB // 'OI=N PC=OS2 OD=N EX=Y PW=RNCECLI') File Edit Confirm Menu Utilities Compilers Test Help EDIT P390A.HUP.PLI.DEV($C1) Columns 000 Command ===> Scroll = ****** ***************************** Top of Data ********************* =NOTE> SmartJCL JCL XREF LISTING =NOTE> //JCLCHECK JOB ,'HORIZONT/DIRNBERGER',MSGCLASS=T,CLASS=A, // NOTIFY=&SYSUID =NOTE> +++ JCK1234I JOB FOUND IN APPLICATION STTMONTH01 =NOTE> +++ JCK1234I PREDECESSOR: STTMONTH00 JCLCHK01 =NOTE> +++ JCK1234I PREDECESSOR: STTMONTH00 JCLCHK02 =NOTE> +++ JCK1234I SUCCESSOR: - =NOTE> +++ JCK1234I SPECRES: INITA =NOTE> +++ JCK1234I SPECRES: STT //* //PROCS JCLLIB ORDER=(P390A.ROSE.PLI.CNTL) //* //DEL EXEC PGM=IDCAMS //SYSPRINT DD * DEL P390A.STT.DATA.VALCURVE //* SmartJCL Command ===> ________________________________________________________ Command: ENTER Start RES Reset parameters Selection Jobname ===> ________ Operation Number ===> ___ Application ID ===> MYAPP*_______ Workstation ID ===> ____ From ===> Group ===> ________ To ===> Owner ===> ____________ YYYYMMDD HHMM Simulation Simulation Type ===> FULL___ OPC Subsystem ===> OP6C Use JCL from a private JCL Library for Simulation ===> N (Y/N) Output Datasets SmartJCL Output DSN ===> P390G.HCLCHECK.HCL__________________________ SmartJCL Sysprint ===> P390G.HCLCHECK.SYSPRINT_____________________ EQQMLOG ===> P390G.HCLCHECK.EQQMLOG______________________

V2R0 Release Notes V2R0 is available since April It has following major new functions: REXX Interface Check user standards Perform mass updates Reformat as an Edit Macro Integration of Control-M Auto-Edit function Checking procedures Check for existing DB2/IMS programs Utilities (DD-Names) Generates commands to recall migrated datasets

V2R0 - REXX Interface REXX is flexible, available and well known. A “Function Package” allows to access JCL structures from SmartJCL. All JCL statements can be accessed for verification and modification The Function Package contains special functions for JCL handling, e.g. Qualifier("USER.PROD.TYPE", LAST)="TYPE“ The Function Package contains SET functions to delete, insert or modify all statements, even complete steps

REXX with SmartJCL Function Package
V2R0 - REXX Interface File Edit Confirm Menu Utilities Compilers Test Help EDIT P390A.JCK.SCL(XMP1) COMMAND ===> /* Scan the Joblib, and delete all DSNs from the joblib, which are not in the linklist */ Stmt = GetStmt("FIRST") Type = GetType(Stmt) while Type ^= "EXEC" do if Type = "DD" & Linklist (GetValue (Stmt, "DSN")) then Stmt = DelStmt("NEXT") else Stmt = GetStmt("NEXT") Type = GetType(Stmt) end ****** ************************ Top of Data ********************* REXX with SmartJCL Function Package

V2R0 - REXX Interface Modification… Member1 REXX Member2 REXX MemberX
//DD SYSPRINT Member2 REXX MemberX etc. Verification

V2R0 – Reformat Edit Macro
EDIT P390A.OPG.CNTL(TESTJCK) Columns Command ===> Scroll ===> CSR ****** ********************* Top of Data ************************ //P390KX JOB ,'SMARTJCL',MSGCLASS=T, // NOTIFY=&SYSUID,REGION=6M //* //ADUNL EXEC PGM=OPUIAD4, // PARM='/PW=RFKEFZR',REGION=4M //SYSPRINT DD SYSOUT=* //OPUTEXT DD DISP=(NEW,PASS),DSN=&&OPUTEXT, // SPACE=(TRK,(1,1)), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=80),UNIT=SYSDA //OPUDAT DD DISP=(NEW,PASS),DSN=&&OPUDAT1, // UNIT=SYSDA,SPACE=(CYL,(1,1)), // DCB=(RECFM=FB,LRECL=406,BLKSIZE=16240) //* ****** ********************* Bottom of Data ********************* JREF Type JREF…

V2R0 – Reformat Edit Macro
EDIT P390A.OPG.CNTL(TESTJCK) REFORMAT WAS SUCCESSFUL Command ===> Scroll ===> CSR ****** ********************* Top of Data ************************ //P390KX JOB 'SMARTJCL', // MSGCLASS=T, // NOTIFY=&SYSUID, // REGION=6M //* //ADUNL EXEC PGM=OPUIAD4, // PARM='/PW=RFKEFZR', // REGION=4M //SYSPRINT DD SYSOUT=* //OPUTEXT DD DSN=&&OPUTEXT, // DISP=(NEW,PASS), // SPACE=(TRK,(1,1)), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=80), // UNIT=SYSDA //OPUDAT DD DSN=&&OPUDAT1, // DISP=(NEW,PASS), // SPACE=(CYL,(1,1)), // DCB=(RECFM=FB,LRECL=406,BLKSIZE=16240) …to get reformatted JCL that is much more easy to read!

V2R0 - Utilities IEBGENER IEBCOPY IDCAMS
File Edit Confirm Menu Utilities Compilers Test Help EDIT P390A.HUP.PLI.DEV($C1) COMMAND ===> ****** ********************* Top of Data ************************* //E5MS130S JOB (ACCOUNT),'HORIZONT',CLASS=3,MSGCLASS=T //* //DUMP EXEC PGM=ICEMAN,PARM='ABEND,HIPRMAX=0' //SORTIN DD DSN=P390C.TEMP.SMF2.$,DISP=SHR //SYSOUT DD SYSOUT=* //SYSIN DD * SORT FIELDS=COPY,SKIPREX=770000,STOPAFT=785000 =NOTE= JCKxxxxE 00,E5MS130S,SORTOUT DD STATEMENT MISSING ****** ***************** Bottom of Data ************************** IEBGENER IEBCOPY IDCAMS SORT Check DD names and syntax of utility programs

V2R0 - DB2 Programs Check if DB2 Program exists
File Edit Confirm Menu Utilities Compilers Test Help EDIT P390A.HUP.PLI.DEV($C1) COMMAND ===> ****** ********************** Top of Data ********************* =NOTE= P01//DB2TSO PROC =NOTE= P01//DB2TSO EXEC PGM=IKJEFT01,REGION=4000K =NOTE= P01//STEPLIB DD DSN=DSN510.SDSNLOAD, =NOTE= P01// DISP=SHR =NOTE= P01//SYSPRINT DD SYSOUT=* =NOTE= P01//SYSTSPRT DD SYSOUT=* =NOTE= P01//SYSUDUMP DD SYSOUT=* =NOTE= P01//SYSDBOUT DD SYSOUT=* =NOTE= P01//SYSOUT DD SYSOUT=* =NOTE= P01$/SYSTSIN DD * =NOTE= P01DSN SYSTEM(DSN1) =NOTE= P01RUN PROGRAM(XXRICPTS) PLAN(XXRICPTS) + =NOTE= P01PARM('DEP(0),ER(0)/DB2SSID=DSN1') + =NOTE= P01LIBRARY('P390A.XINFO.LOAD') =NOTE= JCKxxxxE 00,XXRJCPT1,00000,PROGRAM XXRICPTS NOT FOUND =NOTE= P01$/CPTTO DD DSN=P390A.XINFO.DATA.TABLES, Check if DB2 Program exists

V2R0 – IMS Programs Check if IMS program exists
File Edit Confirm Menu Utilities Compilers Test Help EDIT P390A.HUP.PLI.DEV($C1) COMMAND ===> ****** ********************** Top of Data ********************* //#IMS JOB (BVAV SAHG0N), // MSGCLASS=X,CLASS=R /*JOBPARM S=ANY,LINECT=0 //****************************************************** //*+BAH JOBDOK * //****************************************************** //G EXEC PGM=DFSRRC00,REGION=4200K, .HAAA // PARM='DLI,A387,BVAHLES,,0000,,0,,N,,,IMS1,,Y,N,IRLM' ==MSG> JCK0440E PROGRAM DFSRRC00 NOT FOUND ON SEARCH PATH //* ! ! !!!! ! !_______MONITOR //* PROGRAMM_! ! !!!! !__________SRCH //* PSBNAME_______! !!!!_____________RST //* SPIE_________________!!!______________EXCPVR //* TEST__________________! .HAAB //STEPLIB DD DSN=RZR.IMS.USERDC,DISP=SHR .HAAC // DD DSN=RZR.IMS.RESLIB,DISP=SHR Check if IMS program exists

V2R0 – Recall Commands File Edit Confirm Menu Utilities Compilers Test Help EDIT P390A.JCK.JCKMIG COMMAND ===> ****** ********************** Top of Data ********************* HRECALL 'P390A.JCK.DATA.MIGGDG.G0001V00'/* MIGGDG00 MIGRAT */ HRECALL 'P390A.JCK.DATA.MIGGDG.G0002V00'/* MIGGDG00 MIGRAT */ HRECALL 'P390A.JCK.DATA.MIGGDG.G0003V00'/* MIGGDG00 MIGRAT */ HRECALL 'P390A.JCK.DATA.MIGGDG.G0004V00'/* MIGGDG00 MIGRAT */ HRECALL 'P390A.JCK.DATA.MIGGDG.G0005V00'/* MIGGDG00 MIGRAT */ HRECALL 'P390A.JCK.DATA.MIG.DS02' /* MIGGDG01 MIGRAT */ HRECALL 'P390A.JUP.DATA.KSDSTEST' /* MIGVSAM0 MIGRAT */ HRECALL 'P390A.JCK.DATA.MIG.DS04' /* MIG MIGRAT */ HRECALL 'P390A.JCK.DATA.MIG.DS05' /* MIG MIGRAT */ HRECALL 'P390A.JUP.DATA.KSDSTEST.DATA' /* MIG MIGRAT */ The names of migrated data sets are written to file JCKMIGO

V1R1 Release Notes SmartJCL V1R1 is available since June It has following major new functions: Exclude datasets from catalog check Include/exclude list for jobs (Batch Mode) Individual control of each message Display TWS data Reformat (jobs and procedures) Control-M variable substitution Messages are written to several output files

Unformatted JCL is difficult to read
V1R1 - Reformat EDIT P390A.OPG.CNTL(TESTJCK) Columns Command ===> Scroll ===> CSR ****** ********************* Top of Data ************************ //P390KX JOB ,'SMARTJCL',MSGCLASS=T, // NOTIFY=&SYSUID,REGION=6M //* //ADUNL EXEC PGM=OPUIAD4, // PARM='/PW=RFKEFZR',REGION=4M //SYSPRINT DD SYSOUT=* //OPUTEXT DD DISP=(NEW,PASS),DSN=&&OPUTEXT, // SPACE=(TRK,(1,1)), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=80),UNIT=SYSDA //OPUDAT DD DISP=(NEW,PASS),DSN=&&OPUDAT1, // UNIT=SYSDA,SPACE=(CYL,(1,1)), // DCB=(RECFM=FB,LRECL=406,BLKSIZE=16240) //* ****** ********************* Bottom of Data ********************* Unformatted JCL is difficult to read

V1R1 - Reformat Reformatted JCL is easier to read
EDIT P390A.OPG.CNTL(TESTJCK) Columns Command ===> Scroll ===> CSR ****** ********************* Top of Data ************************ //P390KX JOB 'SMARTJCL', // MSGCLASS=T, // NOTIFY=&SYSUID, // REGION=6M //* //ADUNL EXEC PGM=OPUIAD4, // PARM='/PW=RFKEFZR', // REGION=4M //SYSPRINT DD SYSOUT=* //OPUTEXT DD DSN=&&OPUTEXT, // DISP=(NEW,PASS), // SPACE=(TRK,(1,1)), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=80), // UNIT=SYSDA //OPUDAT DD DSN=&&OPUDAT1, // DISP=(NEW,PASS), // SPACE=(CYL,(1,1)), // DCB=(RECFM=FB,LRECL=406,BLKSIZE=16240) Reformatted JCL is easier to read helps to avoid mistakes reduces costs

V1R1 - Reformat The reformat function can be adapted to user’s requirements and standards, e.g. The positions of keyword, value and continuation line can be specified individually for each JCL parameter Flexible handling of comments Reformats IF/ELSE statements

The ISPF Dialog for the reformat function
V1R1 - Reformat SmartJCL Reformat Command ===> Primary commands (top): REF Edit reformat parameters JOBLIST Edit joblist JOBLIB Edit joblibraries Select one of the following options and press ENTER. Member ===> RFMT#E1_ - ________ Specify one member (left) if you would like to check a a single job, or specify two members if you would like to check a range of members. Joblist ===> ____________________________________________ If you do not specify any member, the Joblist is used for selection. Joblibs ===> P390G.SMARTJCL.JOBLIBS______________________ Submit ===> E S submit job, E edit before submit The ISPF Dialog for the reformat function

Displaying TWS-Information in the JCL!
V1R1 - TWS Information File Edit Confirm Menu Utilities Compilers Test Help EDIT P390A.HUP.PLI.DEV($C1) COMMAND ===> ****** ************************ Top of Data ********************* ==MSG> PREDECESSORS: ==MSG> APPLICATION OPNO JOBNAME ==MSG> ==MSG> XINFO XXRJCM2 ==MSG> XINFO XXRJCM1 ==MSG> XINFO ==MSG> SUCCESSORS: ==MSG> XINFO XXRJDBLC ==MSG> SPECIAL RESOURCES: ==MSG> ==MSG> DSN1 =NOTE= ******************* JCL PREPARED BY SMARTJCL/SIMJCL ******* =NOTE= ************************** END OF PREPARED JCL ************ //XXRJCM3 JOB (ACCOUNT),'HORIZONT',MSGCLASS=T,CLASS=A, Displaying TWS-Information in the JCL!

SUMMARY… scroll to the left…
V1R1 – Separated Output Display Filter View Print Options Help SDSF OUTPUT DISPLAY JCKJPS2 JOB DSID LINE CO COMMAND INPUT ===> SCR ********************************* TOP OF DATA ******************** MSG.NO. ERROR MESSAGE JCK0402E MISPLACED DD STATEMENT JCK0400E JOB HAS NO STEPS JCK0416E JOB NAME HAS TO BE EQUAL WITH MEMBER NAME JCK0440E PROGRAM ZVB245 NOT FOUND ON SEARCH PATH JCK0457W DATA SET SYS1.CEE.SCEERUN NOT IN CATALOG JCK0441E LIBRARY COULD NOT BE ALLOCATED TO SEARCH FOR PROGRAM, DSN JCK0515E DATA SET CANNOT BE FOUND/NOT IN CATALOG, DSN = "SYS1.CEE. JCK0457W DATA SET SSKM.SMART611.DCALOADP NOT IN CATALOG The messages are written to separate files JCKSUMO (Summary) JCKDTLO (Detailed) SUMMARY… scroll to the left…

…only most interesting information
V1R1 - Output, e.g. Summary Display Filter View Print Options Help SDSF OUTPUT DISPLAY JCKJPS2 JOB DSID LINE CO COMMAND INPUT ===> SCR ********************************* TOP OF DATA ******************** LIB MEMBER JOBNAME JSTEPNAME PSTEPNAME DD-NAME J001 $$$CONT SYSIN J001 $C DDP4 J001 $DDTABLE SYSIN J001 $PROLOG J001 $SIGNAL #ZVB245 J001 $SIGNAL #ZVB245 STEP1 STEP1 J001 $SIGNAL #ZVB245 STEP1 STEP1 STEPLIB …only most interesting information

V1R1 - Separate Output, e.g. Detaillied
Display Filter View Print Options Help SDSF OUTPUT DISPLAY JCKJPS2 JOB DSID LINE CO COMMAND INPUT ===> SCR ********************************* TOP OF DATA ******************** 000100 .HAAA JCK0402E MISPLACED DD STATEMENT .HAAA JCK0400E JOB HAS NO STEPS P390A.JUP.DATA.JOBLIB($PROLOG): //* //* JD021016, //* //* P390A.JUP.DATA.JOBLIB($SIGNAL): //#ZVB245 JOB (OA-MF-NB),MSGLEVEL=(1,1),CLASS=P,MSGCLASS=T, // TIME=1440,REGION=8M,TYPRUN=SCAN .HAAA JCK0416E JOB NAME HAS TO BE EQUAL WITH MEMBER NAME All information, including the JCL

V1R1 - Control-M Interface
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 Interface Mainpanel

V1R1 - Control-M Interface
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 Select Jobs by using Control-M fields

Any Questions about SmartJCL?

SmartJCL HORIZONT Many thanks for your attention
The Easy Way to Faultless JCL Many thanks for your attention HORIZONT Software for Datacenters Garmischer Str. 8 D München Tel ++49(0)89 / 1 1 1 1 1 1 1 1 1 1 1

The Easy Way to Faultless JCL

Similar presentations

Presentation on theme: "The Easy Way to Faultless JCL"— Presentation transcript:

Similar presentations

About project

Feedback

Log in

Auth with social network:

The Easy Way to Faultless JCL

Similar presentations

Presentation on theme: "The Easy Way to Faultless JCL"— Presentation transcript:

Similar presentations

About project

Feedback