Control-M / JCL Verify - aticstro.com · Laut Installation Guide STEP23 : Install Control-M/JCL VERIFY ... 3 Process Parameter Verification ... Variable Value Reference Description

© ATICS GmbH 2013

ATICS GmbH

IT–Beratung

Oberstaße 48/c

64589 Stockstadt/Rhein

Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111

Email: [email protected]

http://www.atics.de

1

Control-M / JCL Verify

Übersicht über

Installation

Anwender – Modifikationen

JCL Verify in der Praxis

Peter Laur

[email protected]

© ATICS GmbH 2013

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

2

Control-M / JCL Verify

Allgemein

JCL Verify ist ein JCL – Ckecker

Control-M/JCL VERIFY überprüft nur JCL in partitioned Datasets (PDS

oder PDSE)

wobei die partitioned Datasets eine Satzlänge von 80 und ein fixes

Record Format haben müssen (FB/F)

Neues Produkt innerhalb der Incontrol – Familie

Installation über ICE

Installation in Rel 7.0.03 unter IOA / Step 23

Ab IOA 8.0.00 als eigenes Produkt CTJ

Kann standalone (ohne Control-M) installiert werden

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

3

Aufruf IOA - Installation

------------------- IOA Customized Installation - Main Menu ------------------

OPTION ===> 1

Environment ID: IOAS700

Product ID ===> IOA Enforce Step Order ===> NO (Yes/No)

Reference Libraries Prefix: T160.IOA630IN

1 INSTALL IOA - Install and Customize IOA

2 INSTALL CTx - Install and Customize an INCONTROL Product

X EXIT - Leave the Installation Process

Laut Installation Guide STEP23 :

Install Control-M/JCL VERIFY

Achtung: wird bei 7.0.03 unter IOA installiert !!!!

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

4

Übersicht IOA

---------------------------- Major Steps Selection ---------------------------

COMMAND ===> SCROLL ===> CSR

Environment: IOAS700 Product: IOA

Sel values: S Select step C Mark step as completed R Reset status

B Browse Step X Mark step as excluded ? Help

PF7/PF8 To scroll through all Steps

------------------------------------------------------------------------------

Sel Step Status Opt Description

=== ==== ====== === ===========

. 20 COMPLETE Y Install IOAGATE

. 21 COMPLETE Y Install CONTROL-M Application Server

. 22 EXCLUDE Y Install KOA and IOA Routes

S 23 Y Install CONTROL-M/JCL Verify

. 24 EXCLUDE Y Support for Other Products

. 25 COMPLETE IOA Installation Conclusion

------------------------------> End of Major Steps <--------------------------

Laut Installation Guide STEP23 :

Install Control-M/JCL VERIFY

Achtung: wird bei 7.0.03 unter IOA installiert !!!!

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

5

IOA / Step 23 Install CONTROL-M/JCL Verify

---------------------------- Minor Steps Selection ---------------------------



Major Step: 23 Install CONTROL-M/JCL Verify




-------------------------------------------------------------------------------

Sel Step Status Type Opt Description

=== ==== ====== ==== === ===========

s 1 * Data Y CONTROL-M/JCL Verify Management

. 2 Edit CONTROL-M/JCL Verify Password Data

. 3 Process Parameter Verification

. 4 Extrnl TSO Requirements

. 5 Extrnl Edit Macro Customization

. 6 Process Save Parameters into Installation Libs

. 7 Process Indicate completion of installation

------------------------------> End of Minor Steps <---------------------------

Wir werden uns nun die für die Installation

relevanten Schritte ansehen

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

6

IOA / Step 23.1. (CONTROL-M/JCL Verify Management)

---------------------------- Parameter Data Entry ------------ Row 1 to 5 of 5

COMMAND ===> SCROLL==> CSR

Product: IOA Major Step: 23 Install CONTROL-M/JCL Verify

Environment: IOAS700 Minor Step: 1 CONTROL-M/JCL Verify Management

Codes in the VALUE field: Function keys and Commands:

= Insert from Reference PF7/8 Scroll through all parameters

/ Insert from Default PF3/End Exit and Save

? Display Help Cancel Exit without Save

------------------------------------------------------------------------------

Variable Value Reference Description

======== ============= ============= ===========

DSNACCSS Y Verify dataset access

DSNEXIST Y Verify dataset existence

JESTTMNT Y Verify JES statements validity

PGMCHECK Y Verify programs existence

MSGLEVEL I Verification Output Message level

------------------------------> End of Parameters <---------------------------

Control-M/JCL Verify führt immer einen Basis – Test durch

um zu prüfen ob die Statements im Job korrekt sind.

Nachdem der Job diesen Basistest durchlaufen hat

können optional weitere Prüfungen durchgeführt werden.

Die Parameter die in diesem Installations - Step hinterlegt

werden sind nur für diese optionalen Prüfungen

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

7

DSNACCSS prüft ob der Job – Owner Zugriffsrechte auf die Dateien hat.

WERTE: Y-Yes (Default) N-No

Das benötigte Zugriffsprofil (z.B. read und update) wird anhand des DISP -

Parameter im DD - Statement geprüft.

Wenn der USER nicht angegeben ist so wird folgender USER verwendet:

wenn die JCL geprüft wird der USER der Control-M/JCL Verify aufgerufen hat

wenn eine Control-M Job - Definition geprüft wird, wird der OWNER verwendet

(egal ob direkt im Screen 2 oder über J EDIT)

DSNEXIST prüft die Existenz der Dateien


JESTTMNT prüft ob gültige JES - Statements im Job verwendet werden


PGMCHECK prüft ob die PGM Load Module im Job existieren und in der Standard –

Suchreihenfolge (steplib, joblib, linklist…) gefunden werden


MSGLEVEL gibt die minimale Severity von Meldungen an die ausgegeben werden sollen

Meldungen mit einer kleineren Severity als angegeben werden nicht angedruckt

und beeinflussen nicht den ENDE - Return Code (RC)

WERTE:

I – Information Message (kleinste Severity) und darüber – Default

W – Warning Messages und darüber

E – nur Error Messages (höchste Severity)

IOA / Step 23.1. (CONTROL-M/JCL Verify Management)

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

8

IOA / Step 23.4. (TSO Requirements)








------------------------------------------------------------------------------


=== ==== ====== ==== === ===========

. 1 COMPLETE Data Y CONTROL-M/JCL Verify Management

. 2 COMPLETE Edit CONTROL-M/JCL Verify Password Data

. 3 COMPLETE Process Parameter Verification

S 4 Extrnl TSO Requirements

. 5 Extrnl Edit Macro Customization



------------------------------> End of Minor Steps <--------------------------

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

9


BROWSE SYS13095.T133451.RA000.PLAUR.R0100011 Line 00000000 Col 001 080

Command ===> Scroll ===> CSR

********************************* Top of Data *********************************

> IOA-23-4 TSO Requirements

Control-M/JCL Verify must be authorized under TSO.

To authorize Control-M/JCL Verify under TSO

Add CTJTSO and CTJTONL to the authorized programs

listed under the AUTHPGM and AUTHTSF parameters

in the IKJTSOxx member located in the SYS1.PARMLIB

library.

If xx=00, the member is accessed automatically during

the TSO startup.

The member can be activated using the Operator command

SET IKJTSO=xx

For more details, see the IBM MVS System Commands Reference Manual.

******************************** Bottom of Data ******************************

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

10

EDIT ADCD.Z112.PARMLIB(IKJTSOPQ) - 01.04 Columns 00001 00072


000053 AUTHPGM NAMES( /* AUTHORIZED PROGRAMS */ +

000054 /* --- ATICS START ---- */ +

000055 CTRSPL /* IOA INSTALLATION 610 */ +

000056 CTRCTR /* IOA INSTALLATION 610 */ +

000057 CTMRUN /* IOA INSTALLATION 610 */ +

000058 CTMAES /* IOA INSTALLATION 610 */ +

000059 CTMDFL /* IOA INSTALLATION 610 */ +

000060 CTMAPI /* IOA INSTALLATION 630 */ +

000061 CTJTSO /* CTM JCL VERIFY 7.0.03 */ +

000062 CTJTONL /* CTM JCL VERIFY 7.0.03 */ +

000063 /* --- ATICS ENDE ---- */ +

000064 ICHUT100 /* */ +

. . .

000103 AUTHTSF NAMES( /* PROGRAMS TO BE AUTHORIZED */ +

000104 /* WHEN CALLED THROUGH THE */ +

000105 /* TSO SERVICE FACILITY. */ +

000106 /* --- ATICS START ---- */ +

000107 JCKASPL /* SMARTJCL LOAD JES PROC */ +

000108 JCKASA1 /* SMARTJCL ACESS CHECK */ +

000109 JCKASU /* SMARTJCL SWITCH USER */ +

000110 CTJTSO /* CTM JCL VERIFY 7.0.03 */ +

000111 CTJTONL /* CTM JCL VERIFY 7.0.03 */ +

000112 /* --- ATICS ENDE ---- */ +

000113 CSFDAUTH /* ICSF */ +


ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

11









------------------------------------------------------------------------------


=== ==== ====== ==== === ===========




. 4 COMPLETE Extrnl TSO Requirements

S 5 * Extrnl Edit Macro Customization



------------------------------> End of Minor Steps <--------------------------

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

12

IOA / Step 23.5. (Edit Macro Customization) BROWSE SYS13095.T133451.RA000.PLAUR.R0100011 Line 00000000 Col 001 080

********************************* Top of Data *********************************

> IOA-23-5 Edit Macro Customization

To create Control-M/JCL Verify as an ISPF Edit Macro or

TSO Command

1. Complete the Control-M/JCL Verify installation.

2. Copy REXX "CTJXVER" from the IOA CLIST library to your

SYSPROC site library. You may rename the clist to any

valid Name like JV or JVER to simplify the usage of the

Control-M/JCL Verify.

3. Allocate the SYSPROC library to the TSO users.

Note:

1) Do not change the CTJXVER, since it's purpose is to

call the IOA CLISTs and REXXs from IOA CLIST library.

This way if any maintenance is required for the CLISTs

and REXXs in IOA CLIST, the CTJXVER user can access them

without any special handling

2) You can call CTJXVER any valid name that the TSO users

might already use for JCL verification.

******************************** Bottom of Data ****************************

Anmerkung:

Die CLISTE ist auf der IOA CLIST Library erst nach

Abschluss der Installation vorhanden

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

13

IOA / Step 23 (Übersicht nach der Installation von

Control-M/JCL VERIFY

Anmerkung:

Durch Step 23.6 wird das Member CTJPARM erstellt

Durch Step 23.6 wird die CLISTE CTXJVER auf der IOA

CLIST Library erstellt








------------------------------------------------------------------------------


=== ==== ====== ==== === ===========




. 4 COMPLETE Extrnl TSO Requirements

. 5 COMPLETE Extrnl Edit Macro Customization

. 6 COMPLETE Process Save Parameters into Installation Libs

. 7 COMPLETE Process Indicate completion of installation

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

14

CTJPARM – aus Step 23.1.

(CONTROL-M/JCL Verify Management )

EDIT T160.IOA700IN.PARM(CTJPARM) - 01.00 Columns 00001 00072


****** ***************************** Top of Data *****************************

000001 ******************************************************

000002 * CONTROL-M/JCL Verify SOURCE PARAMETERS MEMBER

000003 * ---------------------------------------------

000004 * Created by ICE on: 2013/04/05 15:32

000005 * USERID: PLAUR

000006 ******************************************************

000007 *---------------------------------------------------------------------*

000008 * General functions *

000009 *---------------------------------------------------------------------*

000010 VERIFY DSNACCSS=Y, Verify dataset access

000011 DSNEXIST=Y, Verify dataset existence

000012 JESTTMNT=Y, Verify JES statements validity

000013 PGMCHECK=Y Verify programs existence

000014 *---------------------------------------------------------------------*

000015 * Reporting options *

000016 *---------------------------------------------------------------------*

000017 REPORTS MSGLEVEL=I Verification Output Message level

000018 *---------------------------------------------------------------------*

000019 *

000020 *---------------------------------------------------------------------*

****** **************************** Bottom of Data ***************************

Anmerkung:

Member CTJPARM nach der Installation

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

15

CLISTE CTXJVER kopieren (aus IOA / Step 23.5. Edit Macro Customization)

EDIT T160.IOA700IN.CLIST Row 00017 of 00172


Name Prompt Size Created Changed ID

_________ CTJTONLC

_________ CTJXVER 69 2013/04/05 2013/04/05 15:32:50 PLAUR

_________ CTJXXPRC

_________ CTMAES 50 2010/09/30 2010/09/30 12:00:00 IOA7000

EDIT ATICS.PROD.CLIST Row 00033 of 00037


Name Prompt Size Created Changed ID

_________ JVER 69 2013/04/05 2013/04/05 15:32:50 PLAUR

_________ MSJ 16 2011/08/11 2011/08/11 13:37:13 AMOES

**End**

Anmerkung:

Member CTJXVER auf unter SYSPORC verkettete Library

kopiert unter neuem Namen JVER (Name beliebig)

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

16

EDIT T160.G00.JCL.I700(T160G00D) - 01.20 Columns 00001 00072

Command ===> JVER Scroll ===> CSR

****** ***************************** Top of Data *****************************

000101 //T160G00D JOB (160,ARI),ATICS,CLASS=A,MSGCLASS=9,NOTIFY=&SYSUID,

000102 // REGION=0M

000120 // JCLLIB ORDER=T160.IOA700IN.PROCLIB

000130 // INCLUDE MEMBER=IOASETS7

000150 //CTMTEST EXEC IOATEST,

000160 // PARM='WAIT=0005,TERM=C0000'

****** **************************** Bottom of Data ***************************

IRX0156E The run time processor EAGRTPRC is not available.

***

Die Fehler - Meldung besagt, dass das REXX – Runtime – Environment nicht gebildet

werden kann. Deshalb die entsprechende Bibliothek in die STEPLIB – Verkettung

der LOGON – Prozedur aufgenommen.

TEST JVER in JCL – Member

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

17

TEST JVER in SCHEDULE

JOB: T160G00D LIB T160.G00.SCHEDULE.I700 TABLE: GLUEB42

COMMAND ===> JVER SCROLL===> CRSR

+-----------------------------------------------------------------------------+

| MEMNAME T160G00D MEMLIB T160.G00.JCL.I700 |

| OWNER R160001 TASKTYPE JOB PREVENT-NCT2 DFLT N |

Ergebnis:

---------------------------- I O A E D I T O R ------------------- (EDMEM)

COMMAND ===> SCROLL===> CRSR

ROW CONTROL-M/JCL_VERIFY(GLUEB42) COL 001 072

000001 CTJ000I Control-M/JCL Verify is starting. Level IJ10133

000002 CTJ202I Shared INFO does not exist. Run CTJINIT to improve verification

000003 response time

000004 CTJ20OI Procedure Library was not Found. Library: SYS2.ADCD.PROCLIB

000005 CTJSA0S IOA security is disabled. Access validation is disabled.

Anmerkungen:

Die erste Meldung (nur Info) besagt, dass man das Utility

CTJINIT laufen lassen soll (wegen Laufzeitverkürzung)

Die Meldung der Prozedurbibliothek ist schlichtweg falsch,

dies liegt daran dass das Member CTJPRC nicht gepflegt ist

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

18

CHAPTER 1 - CTJPRC STATIC PROCLIB

Anmerkungen:

Control-M/JCL Verify kann automatisch die dynamischen

PROCLIBs erkennen, die statischen aber nicht !!!.

Um die statischen PROCLIBs Control-M/JCL Verify bekannt

zu geben müssen diese in das Member CTJPRC in der IOA

PARM – Library eingetragen werden.

Die statischen PROCLIBs sind unter dem selben DD –

Statement und in der gleichen Reihenfolge wie in der JES –

Start – Prozedur einzutragen. (siehe Auflistung)

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

19

CHAPTER 1 - CTJPRC STATIC PROCLIB

CTJPRC nach Anpassung

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

20

CHAPTER 7 - CTJINIT ---------------------------- I O A E D I T O R ------------------- (EDMEM)

COMMAND ===> SCROLL===> CRSR


000001 CTJ000I Control-M/JCL Verify is starting. Level IJ10133

000002 CTJ202I Shared INFO does not exist. Run CTJINIT to improve verification

000003 response time

. . .

Anmerkungen:

Diese INFO - Meldung kommt zu Stande, da immer wieder

sämtliche Parameter für die Prüfung eingelesen werden

müssen.

um dies zu vermeiden gibt es das Utility CTJINIT

Jeder Aufruf von Control-M/JCL Verify prüft ob dieses Objekt

vorhanden ist. Wenn JA wird es verwendet, ansonsten

werden wie im Beispiel oben immer alle Informationen neu

eingelesen.

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

21

CHAPTER 7 - CTJINIT

Dieses gebildete „Shared Objekt“ ist statisch, das bedeutet, dass bei

Änderungen (zum Beispiel wenn ein neues Modul in die LPA gestellt

wird) das „Shared Objekt“ neu gebildet werden muss.

Deshalb sollte das Objekt periodisch neu aufgebaut werden.

(DEFAULT= REFRESH)

der Job CTJINIT sollte immer nach IPL laufen und als zyklischer Job

im CTM.

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

22

CHAPTER 7 - CTJINIT

Die Informationen im Shared Objekt umfassen:

gefundene Programme in der System LINKLIST und LPA

gemountete Platten – Volumes

verfügbare Device - Units

JES Prozedur – Bibliotheken

JES Input + Output – Klassen

JES Destinations

Printer und Punch

NJE - Nodes

FCB Images

Weitere JES2/3 Informationen die benötigt werden um die

JCL und JES Statements zu prüfen.

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

23

CHAPTER 7 - CTJINIT

Anmerkungen:

Die neue ONLINE – Funktion JV führte zu einem Fehler.

Deshalb muss der IOA – Aufruf wie oben dargestellt

modifiziert werden.

Unter ISPTABL muss eine User – bezogene Bibliothek

allokiert werden

© ATICS GmbH 2013

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

24

Nun ist die Installation

abgeschlossen und wir wenden

uns der Funktionalität von

Control-M/JCL-Verify zu

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

25

Arbeitsweise JVER (CTXJVER) EDIT MACRO

Allgemeine Arbeitsweise CTXJVER

JVER kann aus dem ISPF - Editor oder jedem anderen

compatiblem Editor aufgerufen werden (im EDIT oder VIEW

– Modus)

JVER arbeitet nur auf abgespeicherte Member. Wird eine

Änderung in der JCL gemacht ohne zu speichern, so frägt

JVER zuerst ob dass Member zuvor gespeichert werden soll.

Bei Y (YES) wird das Member gespeichert und die Prüfung

anschießend durchgeführt, bei N (NO) bricht JVER die

Prüfung ab.

JVER kann nicht arbeiten beim Job Edit im IBM/SDSF da

dort kein SAVE erlaubt ist

JVER zeigt das Ergebnis im Job – Member an. Das Ergebnis

ist eine Anzeige der Fehlermeldungen wie wenn der Job

gerade laufen würde.

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

26

Arbeitsweise JVER (CTXJVER) EDIT MACRO

Modi von CTXJVER

CTXJVER kann in 2 Modi aufgerufen werden:

verification mode oder message filter mode

Die Anzeige des Ergebnisses ist in 2 Bereiche unterteilt:

Header

beinhaltet die Nummer und Typen der Meldungen

Main body

beinhaltet das Job – Member mit Anzeige der entsprechenden

Meldung nach der jeweiligen Jobzeile die die Meldung

verursacht hat

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

27

JVER (CTXJVER) EDIT MACRO

Aufrufmöglichkeiten von JVER (CTXJVER)

Aufruf JVER

Die Prüfungen werden mit den hinterlegten DEFAULT –

Parametern durchgeführt

Aufruf JVER P

Durch die Option P kommt zuerst ein Panel, auf dem neue

Defaultwerte eingetragen werden können. Mit diesen wird

dann die Prüfung durchgeführt.

Aufruf JVER S

Durch die Option S wird das Member zuerst automatisch

gespeichert vor der Prüfung

Aufruf JVER R i|w|e (Message filter mode)

Durch die Option R kann die Message Level - Anzeige im

Editor geändert werden ohne dass die Durchführung einer

Prüfung der JCL durchgeführt wird. Die Option R dient also

dazu um Message – Level zu filtern, wobei i - Anzeige alle Messages

w - Anzeige von Warnings und Errors

e - Anzeige nur von Errors

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

28

TEST JVER in JCL

Wie bereits dargestellt werden im Header die Parameter für die

Überprüfung angedruckt

danach kommt die Summary nach Error / Warning / Information

( ==MSG> / ====== / =NOTE= )

danach die detaillierteren Informationen (wichtig hierbei ist dass bei

einem Error ein Label angegeben ist der auf die Zeile verweist in

der der Fehler aufgetreten ist). Im Beispiel verweist der Label auf

eine fehlerhafte Jobkarte => JCL – ERROR

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

29

CHAPTER 2 - CTJVER Online - Meldungen

MELDUNGEN CTJVER (im Online – Environment ) CTJ000I Start JCL Verify mit Angabe des Levels

CTJR09I Meldung keine Prüfung da der Job DUMMY ist

CTJSA0S Security – Meldungen

CTJ00CI Laufparameter für CTJVER

CTJR05I JCL – Statement und Auflösung

CTJ008I Start der Job – Prüfung

CTJP* beziehen sich auf Load – Module

CTJ009I Ende - Meldung für jeden geprüften Job (sind in einem Member

mehrere Jobs erscheint die Meldung für jeden Job)

CTJ003I Ende - Message für jedes Control – Statements

JCLERR> FEHLER – Meldung

CTJD* Meldungen für Datasets

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

30

Online – Prüfung im IOA + über Interfaces

IM IOA PRIMARY OPTION MENU gibt es 2 Menü - Punkte

zu JCL VERIFY:

JD JCL Verify Defaults – um Defaults für die optionalen

Prüf - Parameter lokal zu modifizieren

JV JCL Verification – um die Prüfung für Jobmember

aufzurufen

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

31

Control-M/JCL Verify defaults panel (JD screen)

Aufruf JD IM IOA PRIMARY OPTION MENU:

Um Default - Parameter aus CTJPARM lokal zu

überschreiben

Mögliche Selektionen:

D Default aus CTJPARM

Y entsprechende Prüfung soll durchgeführt werden

N keine entsprechende Prüfung

Beim Parameter Message - Level gibt es die Selektion D

(=Default) oder dediziert den gewünschten Message – Level

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

32

Control-M/JCL Verify defaults panel (JD screen)

Nach überschreiben der Default - Parameter

werden diese im User – Profile mit den neuen

Werten abgespeichert (lokale Einstellung)

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

33

Control-M/JCL Verify Facility (JV screen)

Aufruf JV = Prüfung JCL - Member

Optionale Angaben bei Member

M* für alle Member auf der Library

T160* Maskierung welche Member geprüft

werden sollen

* für alle Member auf der Library

T160G00C Jobname

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

34

Job verification from Control-M interfaces /

Screen 2

Command E

in der Table Job List vor eine Tabelle absetzen es

werden alle in der Tabelle enthaltenen Jobs geprüft.

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

35


Screen 2

Beim Ordern/FORCE auf Tabellenebene

ist nun im POPUP – Window die Abfrage VERIFY JCL

enthalten ob die Prüfung der JCL aktiviert werden soll

Y es werd die JCL aller des Jobs geprüft.

N es findet keine JCL – Prüfung statt

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

36


Screen 2

Command E

im Job List Screen (Auflistung der Jobs in der Tabelle)

es wird der einzelne Job geprüft

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

37


Screen 2

Beim Ordern/FORCE auf Jobebene



Y es werd die JCL aller des Jobs geprüft.

N es findet keine JCL – Prüfung statt

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

38


Screen 2

Command JVER

in der Job – Scheduling Definition eines Jobs es

wird der Job geprüft

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

39


Screen 2

Command JVER

im Edit – Modus von Control-M (J) es wird der Job

geprüft

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

40


Screen 3

Command E

vor einem im Screen 3 (AJF) eingeplanten Job

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

41


Screen 3

Beim Command R (RERUN/RESTART)



Der 2. Parameter RERUN IF FAILS ist ebenfalls neu

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

42


Screen 3

Command JVER

im Screen 3.Z ist ebenfalls möglich es wird der Job

geprüft

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

43


Screen 3

Command JVER

im Screen 3.J (EDIT JCL) ist ebenfalls möglich es

wird der Job geprüft

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

44

TEST JVER ALLGEMEIN

---------------------------- I O A E D I T O R ------------------- (EDMEM)

COMMAND ===> SAVE SCROLL===> CRSR


000181 +----------------------------------------------------------+

000182 | IOA EDITOR - SAVE OPTION |.IOA700IN

000183 | |

000184 | LIBRARY CONTROL-M/JCL_VERIFY |

000185 | |.IOA700IN

000186 | MEMBER GLUEB42 |

000187 | |

000188 | PRESS ENTER FOR SAVE OR PF3 FOR CANCEL |

000189 | |

000190 CT +----------------------------------------------------------+2

000191 CTJ003I Processing ended RC=0000 REASON 00000000 MEMBER GLUEB42 DSNAME=

000192 T160.G00.SCHEDULE.I700

************************ B O T T O M O F D A T A **************************

Anmerkungen:

Das Ergebnis der ONLINE – Prüfung wird teilweise im IOA –

Editor angezeigt und kann deshalb abgespeichert werden

Dies gilt für die Prüfungen bei

E vor der Tabelle im Screen 2

E vor einem Job im Screen 2

E vor einem Job im Screen 3 (AJF)

JVER als Kommando im Screen 3.Z

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

45

CHAPTER 2 - CTJVER Batch - Utility

CTJVER als Batch –Utlity kann

normale JCL überprüfen (über die Angabe

JCL – Bibliothek + Member)

auch JCL überprüfen, welche in der Scheduledefinition im

Control-M enthalten ist (INSTREAM – JCL)

auch JCL überprüfen, welche über die Scheduledefinition

im Control-M angezogen wird (Memname / Memlib)

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

46


Parameter im EXEC - Statement: JES= JES2 + JES3 Statement werden in Abhängigkeit vom

Parameter JESTTMNT in CTJPARM überprüft (JES=D bedeutet

DEFAULT wie in CTJPARM definiert)

FE=Y File Existence wird geprüft (entspricht DSNEXIST in

CTJPARM)

FA=Y File Acess wird geprüft (entspricht DSNACCSS in

CTJPARM)

ME=N Load Module Existence wird geprüft (entspricht

PGMCHECK in CTJPARM)

ML=I unterste Message – Level der ausgegeben werden

soll (entspricht MSGLEVEL in CTJPARM)

wird ein Parameter nicht kodiert (wie im Beispiel ML) dann wird

immer die Zuweisung Parameter=D als DEFAULT zugewiesen,

d.h. es wird immer der Parameter aus CTJPARM verwendet)

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

47

SYSIN - Statement:

USER= gibt die User ID an, für den die Dateizugriffsrechte (FA) geprüft werden

USER=UID zu verwendende User-ID

USER=*DEFAULT entweder der User der CTJVER aufgerufen hat, oder

bei Prüfung über eine Control-M Jobschedule – Definition der

verwendete OWNER

ODATE= ODATE=JJMMTT wird im SCHEDLIB - Statement verwendet

Parameter um Jobs in ihrer Bibliothek zu prüfen: LIB= JCL – Library die geprüft werden soll

MEM= JOB - MEMBER das geprüft werden soll ; Maskierung möglich *

Parameter um Jobs über die Schedule–Definition oder INSTREAM zu prüfen SCHEDLIB= SCHEDULE – Library die geprüft werden soll

TABLE= TABELLE deren Jobs geprüft werden sollen ; Maskierung möglich *

JOB= Name der Job – Schedule – Definition die geprüft werden sollen ;

Maskierung möglich *

ORDERID= gibt die ORDER – ID des Jobs im AJF an der geprüft werden soll

FORTSETZUNGSZEICHEN für SYSIN: Stelle 72 NONBLANK


ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

48


Beispiel 1 JCL – LIBRARY - MODE

von der JCL - Library T160.G00.JCL.I700 wird nur das

Jobmember T160G00D geprüft

von der JCL - Library T160.G00.JCL.I700.OVERLIB2

werden alle Jobmember geprüft

Von der JCL - Library T160.G00.JCL.I700.D110404

werden alle Jobmember geprüft die mit $C beginnen

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

49


Beispiel 2 SCHEDULE – LIBRARY - MODE ODATE wird mit dem 29. Januar 2013 zugewiesen

Für den Prüfung der Dateirechte wird der OWNER aus der

Scheduledefinition verwendet

Von der SCHEDULE - Library T160.G00.SCHEDULE.I700 wird aus der

Tabelle GLUEB42 nur das Jobmember T160G00D geprüft

Von der SCHEDULE - Library T160.G00.SCHEDULE.I700.PHYSIK1

werden aus der Tabelle GLUEB42 alle Jobmember geprüft

Von der SCHEDULE - Library T160.G00.SCHEDULE.I700.VONWID

werden aus allen Tabellen alle Jobmember geprüft

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

50


Beispiel 3 Angabe der ORDERID

Angabe der ORDERID eines im AJF eingeplanten

Jobs

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

51


MELDUNGEN CTJVER als Batch – Utility

CTJU* Hinweis dass Ausgabe aus Utility

kommt

CTJU00I Utility – Start

CTJU01I Ausgabe der Eingabe – Parameter

CTJU02I Ende der Prüfungen

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

52


Unschön bei CTJVER / Batch

Ist der erste Job in der Tabelle innerhalb der Prüfung

auf MEMLIB DUMMY, bricht die Prüfung ab. (Online

kommt ein Hinweis und weiter mit dem nächsten Job)

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

53

RETURN – CODES CTJVER:

RC=0 Job lief erfolgreich

RC=4 Control-M/JCL Verify entdeckte, dass eine zu überprüfende

Ressource nicht in dem benötigten Status ist (zum Beispiel

wenn eine Eingabe - Dataset nicht besteht

RC=8 Control-M/JCL Verify entdeckte ein Problem im Job dass zu

einem JCL – Error oder einer Zurückweisung durch JES2 or

JES3 führen würde.

RC=12 Fehler in den JCLVER – Statements oder Parametern.

RC>16 interner Fehler im Produkt Control-M/JCL Verify. Erneut

versuchen. Tritt das Problem erneut auf dann BMC

kontaktieren.


ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

54

CHAPTER 3 - CTJPLAN Batch - Utility

CTJPLAN nur in Verbindung mit Control-M !!

Ist Teil einer Prozedur die JCL – Jobs überprüfen kann

welche für die Verarbeitung geplant werden würden.

Diese Prozedur verwendet die Utilities CTMRPLN +

CTJVER und kann auch JCL überprüfen, welche in der

Scheduledefinition im Control-M enthalten ist (INSTREAM)

Die Prozedur kann also feststellen welche Jobs zu einem

bestimmten Datum geplant werden würden und überprüft

dann die JCL der entsprechenden Schedule –

Definitionen.

Die Prozedur kann dem entsprechend entweder einen

einzelnen Job oder sehr viele Jobs prüfen. (z.B. alle Jobs

auf einer Schedule – Bibliothek)

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

55


CTJPLAN - Parameter

ODATE=

zwingende Angabe des Plandatums im Format JJMMTT

JES= FE= FA= ME= ML=

Optional. Wenn nicht angegeben werden für jeden Parameter die

jeweiligen DEFAULT – Werte aus CTJPARM verwendet

//SCHEDLIB DD DISP=SHR,DSN=T160.G00.SCHEDULE.I700

optional. Wenn SCHEDLIB nicht angegeben ist werden die Tabellen

auf der Schedule – Installations – Library gesucht.

TABLES GL*,EF1UEB41

optional. Ist der Parameter nicht angegeben so werden alle Jobs in

allen Tabellen auf SCHEDLIB geprüft. Wird er angegeben, so

können die Tabellen auch generisch angegeben werden.

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

56


Beispiel CTJPLAN

CTMRPLN ermittelt die zu planenden Jobs zum ODATE

130419 (JJMMTT)

Von der Schedule - Library T160.G00.SCHEDULE.I700

Die sich in den Tabellen welche mit GL* beginnen oder in

der Tabelle EF1UEB41 befinden

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

57


CTJPLAN OUTPUT

CTMRPLN erstellt unter dem DD DAREPORT eine Liste

der Jobs welche zu dem angegebenen Plandatum ODATE

eingeplant werden müssen

Diese Ausgabe läuft dann in die Prozedur JVER ein

Die Ausgabe aus JVER erfolgt unter DD SYSPRINT

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

58


CTJPLAN OUTPUT CTMRPLN erstellt unter dem DD DAREPORT eine Liste der Jobs

welche zu dem angegebenen Plandatum ODATE eingeplant

werden müssen

FORMAT: MEMNAME TABELLE SCHEDLIB (sortiert nach

MEMNAME)

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

59


CTJPLAN OUTPUT

Die Ausgabe aus JVER erfolgt unter DD SYSPRINT

am Besten man sucht nach der Meldung CTJ009I (kommt am

Ende jedes geprüften Jobs) und blättert im Fehlerfall zurück

ATICS GmbH

IT–Beratung

Oberstaße 48/c


Tel: (+49) 6158 / 985 110

Fax: (+49) 6158 / 985 111


http://www.atics.de

© ATICS GmbH 2013

60

Vielen Dank für Ihre Aufmerksamkeit!

Documents

Control-M / JCL Verify - aticstro.com · Laut Installation Guide STEP23 : Install Control-M/JCL VERIFY ... 3 Process Parameter Verification ... Variable Value Reference Description