XINFO The IT Information System Report Generator HORIZONT

XINFO The IT Information System Report Generator HORIZONT Software HORIZONT for Datacenters 1 Garmischer Str. 8 D- 80339 München Tel ++49(0)89 / 540 162 - 0 ® www. horizont-it. com XINFO

Table of Contents Introduction Example Batch Documentation Example Program Documentation Example Impact Analysis Example Implementation HORIZONT 2 XINFO ®

XINFO Report Generator This "Report Generator" is an extension of XINFO’s Batch Interface (BIF) : • New statements like LNCMD, SCAN, IF and GOTO allow to continue to work on previous selections. • • The output is HTML, graphics like netplans are included as JPEGs • This allows you to create complex and complete documentations automaticaly. Commands like ARRANGE and SORT allow to modify the layout of the output tables without any need to change the displays HORIZONT 3 XINFO ®

XINFO Report Generator This presentation shows three possible scenarios: • • Document batch streams Document programs Impact Analysis If you want to test the examples on your own: • • The sources and results are on this CD (XINFO-Report. Generator_Files*. *) • Please read following manual XINFO 3. 3 PC-Client User‘s Guide: cdproductsxinfoV 3 R 3docuenglishxxrddoce. pdf You need XINFO 3. x with the latest server program (XXRIXD 4 2008 -05 -27 or later and the actual PC client (build 191 2008 -05 -27 or newer) HORIZONT 4 XINFO ®

Batch Stream Documentation This example shows how to document your Batch Streams automatically. • Prerequesite are basically XINFO’s scheduler scanner. Depending on your needs other scanners may be required, e. g. JCL or SMF • This example shows a UC 4 Job. Plan and all subsequent objects: • • • Dependencies (graphics and tables) All jobs and parameters Scripts and JCL Planning parameters Resources HORIZONT The same functionality is available for all schedulers, e. g. CA-7, Control-M and TWS 5 XINFO ®

Resulting „Batch-Doku" Output is HTML Entry point is a jobplan (or Startpunkt ist ein Job. Plan der application, group, schid etc. ), that wiederum Job. Pläne enthält contains other job plans The calendars used in the plan HORIZONT 6 XINFO ®

Resulting "Batch Docu" Starttime Dependencies (Preds and Succs) Script contents HORIZONT 7 XINFO ®

Resulting "Batch Docu" The next Job. Plan (one level below) includes jobs HORIZONT 8 XINFO ®

Resulting "Batch Docu" Dependencies Job parameters, e. g. Host (CPU), User (Login), Runtime (ERT) etc. HORIZONT 9 XINFO ®

Program Documentation Program documentations are needed in many situations, e. g. mergers, migrations, personal changes etc. • • Prerequesite are XINFO Source Code Scanner (COBOL, PL/I etc. ): The example shows a Cobol-CICS and a Cobol-Batch-Program including: • • • Called Sub Programs (Graphs and tables) Called Functions Attributes of the load modules Kann natürlich auch für PL/1 usw. erstellt werden Used Copy Books (Includes) DB 2 Access File usage (Program and JCL) CICS transactions that are calling other programs All batch jobs that are using the documented programs Scheduling data for these jobs HORIZONT 10 XINFO ®

Resulting "Program Docu" Entry point is a COBOL CICS program Aufgerufene Unterprograms Called sub programs HORIZONT 11 XINFO ®

Resulting "Program Docu" Functions used in all programs Load module attributes Copy Books HORIZONT 12 XINFO ®

Resulting "Program Docu" DB 2 Access CICS transactions that are calling programs HORIZONT 13 XINFO ®

Resulting "Program Docu" Another entry point… Aufgerufene Unterprograms Sub programs HORIZONT 14 XINFO ®

Resulting "Program Docu" Functions Load module attributes Copy Books DB 2 access HORIZONT 15 XINFO ®

Resulting "Program Docu" Files JCL parameters HORIZONT 16 XINFO ®

Resulting "Program Docu" Batch-Jobs that are using this program HORIZONT 17 Scheduling data XINFO ®

Impact Analysis Report This kind of report is useful before changing a program to determine the amount of work to be done • In the example the column "DEPTNO" has to be changed. We search for: • • • All programs using a variable ”DEPTNO" All programs calling these programs All DB 2 tables that have a column “DEPTNO" All programs that are using these tables All CICS transactions and/or batch jobs using these programs HORIZONT 18 XINFO ®

Impact Analysis Report Programs that are using the variable Programs that are calling these programs HORIZONT 19 XINFO ®

Impact Analysis Report DB 2 tables having a column with the same name Programs that are using these tables HORIZONT 20 XINFO ®

Impact Analysis Report Affected programs CICS transactions HORIZONT 21 XINFO ®

How to create a Report in Batch? If you want to create such a documentation, you need: 1. A Windows. CMD or. BAT file that starts the process (optional, the BIF script can be started from XINFO with “file open”) 2. 3. A. BIF file with BIF commands 4. A. SEL file containing the selection parameters A (encrypted). LGN file with logon parameters (Userid, pwd, XINFO system) HORIZONT 22 XINFO ®

XINFO PC Client Batch 1. . bat file, here BCH_Docu. BAT Delete old output call xinfo. exe Special INI file (optional) BIF file HORIZONT 23 XINFO ®

XINFO BIF 2. This is the contents of a. bif file, here BCH_Docu. BIF HORIZONT 24 XINFO ®

XINFO BIF Logon 3. Create the. lgn file (online) HORIZONT 25 XINFO ®

XINFO BIF Selection 4. Die Start-Selektion Create selection fileebenso online HORIZONT 26 XINFO ®

XINFO BIF Ausgabe The name of the resulting HTML file HORIZONT 27 XINFO ®

XINFO BIF Line Commands All “right mouse" line commands are available in BIF mode. Use them as “all command“, or use the line commands based on single rows HORIZONT 28 XINFO ®

XINFO BIF Line Commands Simply write here the Geben Sie die genaue name of the line Bezeichnung des command as shown in Linecommands an the menu HORIZONT 29 XINFO ®

XINFO BIF No file name means append to the same output file as specified at the beginning Close the result to go back to the previous result (and start the next line command) HORIZONT 30 XINFO ®

XINFO BIF Arrange Use ARRANGE to specify the columns and their order HORIZONT 31 XINFO ®

XINFO BIF Intermediate Result A line command without create statement creates an intermediate table, that can be used to activate other line commands HORIZONT 32 XINFO ®

XINFO BIF Loop Scan the last result line by line If content of column “Obj. Type“ is equal to “JOBP“… Lncmd_exec_scan executes the line command only for the actual row HORIZONT 33 XINFO ®

Summary XINFO Batch Interface (BIF) allows to • • Execute dialog functions in batch mode • Resulting HTML files can be accessed easily Create complete documentations by using your own layout Including netplans Create complex reports based on all XINFO data (Source, production, history etc. ) automatically HORIZONT 34 XINFO ®

Ende XINFO ® The IT Information System Many thanks for your attention! HORIZONT Software for Datacenters Garmischer Str. 8 D- 80339 München Tel ++49(0)89 / 540 162 – 0 www. horizont-it. com

XINFO The IT Information System Many thanks for your attention HORIZONT Software HORIZONT for Datacenters 36 Garmischer Str. 8 D- 80339 München Tel ++49(0)89 / 540 162 - 0 ® www. horizont-it. com XINFO