IMS Console Facility. OMEGAMON II for IMS and OMEGAMON II for DBCTL. Version 510 GC March 2002

Transcription

1 IMS Cosole Facility OMEGAMON II for IMS ad OMEGAMON II for DBCTL Versio 510 GC March 2002 Cadle Corporatio 201 North Douglas Street El Segudo, Califoria

2 Registered trademarks ad service marks of Cadle Corporatio: AF/OPERATOR, AF/PERFORMER, AF/REMOTE, Availability Commad Ceter, Cadle, Cadle Commad Ceter, Cadle Direct logo, Cadle Electroic Customer Support, Cadle logo, Cadle Maagemet Server, Cadle Maagemet Workstatio, Cadle Techologies, CL/CONFERENCE, CL/SUPERSESSION, CommadWatch, CT, CT/Data Server, CT/DS, DELTAMON, eba, eba*servicemoitor, eba*servicenetwork, ebusiess Istitute, ETEWatch, ItelliWatch, ItelliWatch Piacle, MQSecure, MQView, OMEGACENTER, OMEGAMON, OMEGAMON/e, OMEGAMON II, OMEGAMON Moitorig Aget, OMEGAVIEW, OMEGAVIEW II, PQEdit, Solutios for Networked Applicatios, Solutios for Networked Busiesses, ad Trasplex. Trademarks ad service marks of Cadle Corporatio: Alert Adapter, Alert Adapter Plus, Alert Emitter, AMS, Amsys, AutoBridge, AUTOMATED FACILITIES, Availability Maagemet Systems, Cadle Alert, Cadle Busiess Parter Logo, Cadle Commad Ceter/SetielMaager, Cadle CommadPro, Cadle CIRCUIT, Cadle edelivery, CadleLight, CadleNet, CadleNet 2000, CadleNet Commad Ceter, CadleNet ebp, CadleNet ebp Access, CadleNet ebp Admiistrator, CadleNet ebp Broker Access, CadleNet ebp Cofiguratio, CadleNet ebp Coector, CadleNet ebp File Trasfer, CadleNet ebp Host Coect, CadleNet ebp Object Access, CadleNet ebp Object Browser, CadleNet ebp Secure Access, CadleNet ebp Service Directory, CadleNet ebp Uiversal Coector, CadleNet ebp Workflow Access, CadleNet ebusiess Assurace, CadleNet ebusiess Exchage, CadleNet ebusiess Platform, CadleNet ebusiess Platform Admiistrator, CadleNet ebusiess Platform Coector, CadleNet ebusiess Platform Coectors, CadleNet ebusiess Platform Powered by Roma Techology, CadleNet ebusiess Platform Service Directory, CadleNet Portal, CCC, CCP, CEBA, CECS, CICAT, CL/ENGINE, CL/GATEWAY, CL/TECHNOLOGY, CMS, CMW, Commad & Cotrol, Coect-Notes, Coect-Two, CSA ANALYZER, CT/ALS, CT/Applicatio Logic Services, CT/DCS, CT/Distributed Computig Services, CT/Egie, CT/Implemetatio Services, CT/IX, CT/Workbech, CT/Workstatio Server, CT/WS,!DB Logo,!DB/DASD,!DB/EXPLAIN,!DB/MIGRATOR,!DB/QUICKCHANGE,!DB/QUICKCOMPARE,!DB/SMU,!DB/Tools,!DB/WORKBENCH, Desig Network, DEXAN, e2e, ebaa, ebaauditor, eban, ebanetwork, ebaapractice, ebp, ebusiess Assurace, ebusiess Assurace Network, ebusiess at the speed of light, ebusiess at the speed of light logo, ebusiess Exchage, ebusiess Istitute, ebx, Ed-to-Ed, ENTERPRISE, Eterprise Cadle Commad Ceter, Eterprise Cadle Maagemet Workstatio, Eterprise Reporter Plus, EPILOG, ER+, ERPNet, ESRA, ETEWatch Customizer, HostBridge, IterFlow, Cadle IterFlow, Lava Cosole, MessageMate, Messagig Mastered, Milleium Maagemet Blueprit, MMNA, MQADMIN, MQEdit, MQEXPERT, MQMON, NBX, NetGlue, NetGlue Extra, NetMirror, NetScheduler, OMA, OMC Gateway, OMC Status Maager, OMEGACENTER Bridge, OMEGACENTER Gateway, OMEGACENTER Status Maager, OMEGAMON Maagemet Ceter, OSM, PC COMPANION, Performace Pac, PowerQ, PQCofiguratio, PQScope, Respose Time Network, Roma, Roma Applicatio Maager, Roma Broker, Roma BSP, Roma Coector, Roma Developer, Roma FS/A, Roma FS/Access, RomaNet, Roma Network, Roma Object Access, Roma Secure, Roma WF/Access, Roma Workflow Access, RTA, RTN, SetielMaager, Somerset, Somerset Systems, Status Moitor, The Milleium Alliace, The Milleium Alliace logo, The Milleium Maagemet Network Alliace, TMA2000, Tracer, Uified Directory Services, Volcao ad ZCopy. Trademarks ad registered trademarks of other compaies: AIX, DB2, MQSeries ad WebSphere are registered trademarks of Iteratioal Busiess Machies Corporatio. SAP is a registered trademark ad R/3 is a trademark of SAP AG. UNIX is a registered trademark i the U.S. ad other coutries, licesed exclusively through X/Ope Compay Ltd. HP-UX is a trademark of Hewlett-Packard Compay. SuOS is a trademark of Su Microsystems, Ic. All other compay ad product ames used herei are trademarks or registered trademarks of their respective compaies. Copyright March 2002, Cadle Corporatio, a Califoria corporatio. All rights reserved. Iteratioal rights secured. Threaded Eviromet for AS/400, Patet No. 5,504,898; Data Server with Data Probes Employig Predicate Tests i Rule Statemets (Evet Drive Samplig), Patet No. 5,615,359; MVS/ESA Message Trasport System Usig the XCF Couplig Facility, Patet No. 5,754,856; Itelliget Remote Aget for Computer Performace Moitorig, Patet No. 5,781,703; Data Server with Evet Drive Samplig, Patet No. 5,809,238; Threaded Eviromet for Computer Systems Without Native Threadig Support, Patet No. 5,835,763; Object Procedure Messagig Facility, Patet No. 5,848,234; Ed-to-Ed Respose Time Measuremet for Computer Programs, Patet No. 5,991,705; Commuicatios o a Network, Patet Pedig; Improved Message Queuig Based Network Computig Architecture, Patet Pedig; User Iterface for System Maagemet Applicatios, Patet Pedig. NOTICE: This documetatio is provided with RESTRICTED RIGHTS. Use, duplicatio, or disclosure by the Govermet is subject to restrictios set forth i the applicable licese agreemet ad/or the applicable govermet rights clause. This documetatio cotais cofidetial, proprietary iformatio of Cadle Corporatio that is licesed for your iteral use oly. Ay uauthorized use, duplicatio, or disclosure is ulawful. 2 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

3 Cotets List of Figures List of Tables Preface About This Book Adobe Portable Documet Format Documetatio Covetios What s New Applicatio Trace Facility New OMEGAMON II Fuctios Documetatio Chages Chapter 1. Overview of I/CF Itroductio to I/CF New Features Storage Requiremets Chapter 2. Istallig, Cofigurig, ad Customizig I/CF Overview of the Process CICAT Backgroud ad Requiremets CICAT Istallatio Procedure CICAT Cofiguratio Procedures Maual Cofiguratio Procedures Maual Customizatio Procedures Chapter 3. Customizig I/CF Defiig a I/CF Cosole Defiig a Direct VTAM Iterface Defiig a Iterface for Eterig VTAM Commads Defiig a Commad Resource Class APF-Authorizatio Requiremets Chapter 4. Automatig a I/CF Cosole Automatio Strategy Defiig Automatio for a I/CF Cosole Providig a Automatio Exit Cotets 3

4 Chapter 5. Remote Cosole Iterface Defiig a I/CF Remote Cosole Iterface Defiig a I/CF Remote Cosole Security Chapter 6. Usig I/CF Logo Methods I/CF Features Chagig the Way the System Displays Iformatio Eterig Commads Loggig Data Switchig the Logs Chapter 7. Security Set Up Logo Security Commad Etry Security Commad Etry Audit Chapter 8. Cosole Recovery Facilities Automatic Cosole Recovery Facilities Maual Cosole Recovery Facilities ICFX Exceptio Chapter 9. Commad Referece ICFCMD - MVS Cosole Commad ICFCONSL commad ICFTRAP commad MSG Commad AFOPER Commad RECYCLE Commad RESTART Commad OPEN Commad CLOSE Commad SWITCH Commad Chapter 10. Messages I/CF Date/Time Stamp Messages I/CF Messages OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

5 Chapter 11. Pael Refereces CUA Sig O Pael IMS Cosole Facility Sig O Pael IMS Cosole Selectio Pop-up IMS Cosole Facility Pael CUA Operator Assist Paels Set Cotrols Pop-up IMS Status - Alerts Exceptios Pop-up Appedix A. Guide to Cadle Customer Support Base Maiteace Pla Ehaced Support Services Customer Support Cotact Iformatio Idex Cotets 5

6 6 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

7 List of Figures FIGURE 1. Sample IMS System Geeratio Chages FIGURE 2. Sample IMS Master Cosole Defiitio FIGURE 3. Sample Direct VTAM Iterface Defiitio FIGURE 4. Sample SPO APPLID Defiitio FIGURE 5. I/CF Remote Cosole Coected to a I/CF Master Cosole FIGURE 6. Sample IMS System Geeratio Chages FIGURE 7. Sample IMS Applid FIGURE 8. Sample VTAM Major Node with a Remote Cosole Iterface FIGURE 9. Sample Parameters for I/CF Remote Cosole Iterface FIGURE 10. Sample VTAM Major Node for the I/CF Remote Cosole Iterface FIGURE 11. Sample Parameters for I/CF Remote Cosole FIGURE 12. CUA Sig O Pael FIGURE 13. IMS Cosole Facility Sig O Pael FIGURE 14. IMS Cosole Selectio Pop-up FIGURE 15. IMS Cosole Facility Pael - Itegrated Logo FIGURE 16. IMS Cosole Facility Pael - Direct/Idirect Logo FIGURE 17. CUA Operator Assist Paels FIGURE 18. Set Cotrols Pop-up FIGURE 19. IMS Status Alerts Exceptios Pael List of Figures 7

8 8 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

9 List of Tables Table 1. OMEGAMON II for IMS Documetatio Set Table 2. OMEGAMON II for DBCTL Documetatio Set Table 3. Symbols i Commad Sytax Table 4. Storage ad Space Requiremets Table 5. Overview of the Process Table 6. CICAT Cofiguratio Procedure Checklist Table 7. Maual Cofiguratio Procedure Checklist Table 8. Maual Customizatio Procedure Checklist Table 9. Default Color Scheme Table 10. Commad Coversio Examples Table 11. I/CF Commad Coversio Examples Table 12. ICFCMD Commad Subparameter Descriptios Table 13. ICFCONSL Commad Subparameter Descriptios Table 14. ICFTRAP Commad Subparameter Descriptios Table 15. STATUS Field Values List of Tables 9

10 10 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

11 P Preface Itroductio This documet describes how to cofigure ad use the IMS Cosole Facility (I/CF) feature of OMEGAMON II for IMS ad OMEGAMON II for DBCTL. Preface 11

12 About This Book About This Book Who should read this book Documetatio set iformatio The iteded audiece for I/CF icludes: Systems programmers resposible for istallig I/CF Systems operators resposible for usig the IMS Master Cosole The documetatio listed i the followig table is available for the Cadle IMS products. A table cotaiig the product mauals for OMEGAMON II for DBCTL follows this oe. To order additioal product mauals, cotact your Cadle Support Services represetative. Table 1. OMEGAMON II for IMS Documetatio Set Documet Number ET IC Documet Name Ed-to-Ed Respose Time Feature (ETE) Referece Maual Istallig Cadle Products o MVS I OMEGAMON II for IMS ad OMEGAMON II for DBCTL Cofiguratio ad Customizatio Guide I OMEGAMON II for IMS Realtime Commads Referece Maual I OMEGAMON II for IMS Bottleeck Aalysis Referece Maual I OMEGAMON II for IMS Historical Compoet (EPILOG) Referece Maual I OMEGAMON II for IMS User s Guide Descriptio Provides referece iformatio about ETE commads, error messages, retur codes, ad sese codes. Provides istallatio istructios ad other istallatio cosideratios. Explais how to cofigure ad customize OMEGAMON II ad its user iterfaces ad compoets. Describes i detail all of the features of the OMEGAMON II commad iterface. Provides referece iformatio ad descriptios of the features of the bottleeck aalysis compoet. Provides a comprehesive descriptio of the features of the historical compoet (EPILOG). Teaches the basics of usig OMEGAMON II for IMS to maage realtime IMS eviromets. 12 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

13 About This Book Table 1. OMEGAMON II for IMS Documetatio Set Documet Number I OMEGAMON II for IMS Historical Compoet (EPILOG) User s Guide I OMEGAMON II for IMS Respose Time Aalysis (RTA) Referece Maual I OMEGAMON II for IMS ad OMEGAMON II for DBCTL Applicatio Trace Facility I OMEGAMON II for IMS ad OMEGAMON II for DBCTL Trasactio Reportig Facility I OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility W , W , W , W , W Documet Name Cadle Products Messages Maual, Vol. 1 through 5 Descriptio Teaches you, step-by-step, how to operate the historical compoet (EPILOG) reporter after istallatio. Provides referece iformatio ad descriptios of the features of the respose time aalysis (RTA) compoet. Provides user ad referece iformatio about the features of the Applicatio Trace Facility (ATF) compoet. Provides user ad referece iformatio about the features of the Trasactio Reportig Facility (TRF) compoet. Provides a comprehesive descriptio of the features of the IMS Cosole Facility (ICF) compoet. Provides referece summary iformatio for all Cadle product messages. Table 2. OMEGAMON II for DBCTL Documetatio Set Documet Number Documet Name Descriptio IC ID ID Istallig Cadle Products o MVS OMEGAMON II for DBCTL Realtime Commads Referece Maual OMEGAMON II for DBCTL Bottleeck Aalysis Referece Maual Provides istallatio istructios ad other istallatio cosideratios. Describes i detail all of the features of the OMEGAMON II for DBCTL commad iterface. Provides referece iformatio ad descriptios of the features of the bottleeck aalysis compoet. Preface 13

14 About This Book Table 2. OMEGAMON II for DBCTL Documetatio Set Documet Number Documet Name Descriptio ID ID ID OMEGAMON II for DBCTL Historical Compoet (EPILOG) Referece Maual OMEGAMON II for DBCTL Historical Compoet (EPILOG) User s Guide OMEGAMON II for DBCTL User s Guide I OMEGAMON II for IMS ad OMEGAMON II for DBCTL Cofiguratio ad Customizatio Guide I OMEGAMON II for IMS ad OMEGAMON II for DBCTL Applicatio Trace Facility I OMEGAMON II for IMS ad OMEGAMON II for DBCTL Trasactio Reportig Facility I OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility W , W , W , W , W Cadle Products Messages Maual, Vol. 1 through 5 Provides a comprehesive descriptio of the features of the historical compoet (EPILOG). Teaches you, step-by-step, how to operate the historical compoet (EPILOG) reporter after istallatio. Teaches you, step-by-step, how to operate OMEGAMON II for DBCTL after istallatio. Explais how to cofigure ad customize OMEGAMON II ad its user iterfaces ad compoets. Provides user ad referece iformatio about the features of the Applicatio Trace Facility (ATF) compoet. Provides user ad referece iformatio about the features of the Trasactio Reportig Facility (TRF) compoet. Provides a comprehesive descriptio of the features of the IMS Cosole Facility (ICF) compoet. Provides referece summary iformatio for all Cadle product messages. Where to look for more iformatio For more iformatio related to this product, please see the: techical documetatio CD-ROM that came with your product techical documetatio iformatio available o the Cadle Web site at olie help provided with this ad the other related products. 14 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

15 About This Book Orderig additioal documetatio To order additioal product mauals, cotact your Cadle Customer Support represetative. We would like to hear from you Cadle welcomes your commets ad suggestios for chages or additios to the documetatio set. A user commet form, located at the back of each maual, provides simple istructios for commuicatig with the Cadle Iformatio Developmet departmet. You ca also sed to UserDoc@cadle.com. Please iclude OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility i the subject lie. Preface 15

16 Adobe Portable Documet Format Adobe Portable Documet Format Pritig this book Cadle supplies documetatio i the Adobe Portable Documet Format (PDF). The Adobe Acrobat Reader will prit PDF documets with the fots, formattig, ad graphics i the origial documet. To prit a Cadle documet, do the followig: 1. Specify the prit optios for your system. From the Acrobat Reader Meu bar, select File > Page Setup ad make your selectios. A settig of 300 dpi is highly recommeded as is duplex pritig if your priter supports this optio. 2. To start pritig, select File > Prit... o the Acrobat Reader Meu bar. 3. O the Prit pop-up, select oe of the Prit Rage optios for All Curret page Pages from: [ ] to: [ ] 4. (Optioal). Select the Shrik to Fit optio if you eed to fit oversize pages to the paper size curretly loaded o your priter. Pritig problems? The prit quality of your output is ultimately determied by your priter. Sometimes pritig problems ca occur. If you experiece pritig problems, potetial areas to check are: settigs for your priter ad priter driver. (The dpi settigs for both your driver ad priter should be the same. A settig of 300 dpi is recommeded.) the priter driver you are usig. (You may eed a differet priter driver or the Uiversal Priter driver from Adobe. This free priter driver is available at the halftoe/graphics color adjustmet for pritig color o black ad white priters (check the priter properties uder Start > Settigs > Priter). For more iformatio, see the olie help for the Acrobat Reader. the amout of available memory i your priter. (Isufficiet memory ca cause a documet or graphics to fail to prit.) For additioal iformatio o pritig problems, refer to the documetatio for your priter or cotact your priter maufacturer. Cotactig Adobe If additioal iformatio is eeded about Adobe Acrobat Reader or pritig problems, see the Readme.pdf file that ships with Adobe Acrobat Reader or cotact Adobe at 16 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

17 Documetatio Covetios Documetatio Covetios Itroductio Cadle documetatio adheres to accepted typographical covetios for commad sytax. Covetios specific to Cadle documetatio are discussed i the followig sectios. Paels ad figures The paels ad figures i this documet are represetatios. Actual product paels may differ. Revisio bars Revisio bars ( ) may appear i the left margi to idetify ew or updated material. Variables ad literals I examples of commad sytax, uppercase letters are actual values (literals) that the user should type; lowercase letters are used for variables that represet data supplied by the user. Default values are uderscored. LOGON APPLID (cccccccc) I the above example, you type LOGON APPLID followed by a applicatio idetifier (represeted by cccccccc) withi paretheses. Note: I ordiary text, variable ames appear i italics. Preface 17

18 Documetatio Covetios Symbols The followig symbols may appear i commad sytax: Table 3. Symbols i Commad Sytax Symbol Usage The or symbol is used to deote a choice. Either the argumet o the left or the argumet o the right may be used. Example: YES NO I this example, YES or NO may be specified. [ ] Deotes optioal argumets. Those argumets ot eclosed i square brackets are required. Example: APPLDEST DEST [ALTDEST] I this example, DEST is a required argumet ad ALTDEST is optioal. { } Some documets use braces to deote required argumets, or to group argumets for clarity. Example: COMPARE {workload} - REPORT={SUMMARY HISTOGRAM} The workload variable is required. The REPORT keyword must be specified with a value of SUMMARY or HISTOGRAM. _ Default values are uderscored. Example: COPY ifile outfile - [COMPRESS={YES NO}] I this example, the COMPRESS keyword is optioal. If specified, the oly valid values are YES or NO. If omitted, the default is YES. 18 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

19 W What s New Chapter overview Chapter cotets Versio 510 of OMEGAMON II for IMS ad OMEGAMON II for DBCTL sigificatly ehaced the Applicatio Trace Facility. This versio also provides several ew fuctios, which broade the overall fuctioality of OMEGAMON II for IMS ad OMEGAMON II for DBCTL. Applicatio Trace Facility New OMEGAMON II Fuctios Documetatio Chages What s New 19

20 Applicatio Trace Facility Applicatio Trace Facility Applicatio Trace Facility (ATF) is a moitorig aget i OMEGAMON II for IMS ad OMEGAMON II for DBCTL. I Versio 510, ATF was sigificatly ehaced so that: Multiple ATF OMEGAMON Classic address space sessios ca moitor the same IMS The IMS Moitor ca ru cocurretly with these ATF sessios All eviromets for IMS, IMS DB/DC, IMS DC ad IMS DBCTL are supported A site has exteral cotrol of its operatios IMS Versio 7 DC Moitor is supported Cocurret Olie TRF display ad ATF display fuctios are supported I the previous Versio 500, ATF had a DETAIL parameter that could be set to LOW or HIGH. I Versio 510, this parameter was removed ad the fuctio was separated to display this iformatio o separate sets of paels: What used to be DETAIL=LOW i ATF V500 is ow the Olie TRF Display What used to be DETAIL=HIGH i ATF V500 is ow ew ATF paels The chages made to ATF i this release are explaied i detail i the OMEGAMON II for IMS ad OMEGAMON II for DBCTL Applicatio Trace Facility Maual, V510. ATF s olie help has bee upgraded to reflect these ew features. 20 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

21 New OMEGAMON II Fuctios New OMEGAMON II Fuctios Several ew fuctios were added to OMEGAMON II for IMS ad OMEGAMON II for DBCTL. These fuctios are: Expaded geeric IMS commad support Ehaced VSAM buffer pool statistics Ehaced fast path buffer pool statistics Ehaced fast path statistics Ehaced operator assistace for fast path areas Additioal data ad sortig o IMS Message regio fields What s New 21

22 Documetatio Chages Documetatio Chages Olie documetatio With versio 510, Cadle Corporatio has moved OMEGAMON II for IMS mauals from IBM BookMaster to Adobe FrameMaker. This move was made to better eable us to address our customers eeds by providig tools that ehace productivity. Oe of the results of the move is that it is o loger possible to create BookMaager versios of the OMEGAMON II for IMS mauals. However, the mauals remai available olie i the Adobe PDF versio o CD-ROM ad are also available o the Cadle Corporatio website at www. Cadle.com. The documetatio CD beig provided with this release has robust ad easy-to-use search capabilities. You ca search for iformatio i multiple volumes, multiple versios, ad across products. The CD also provides easy setup of search idexes with a sigle click of the mouse. If you wat to order prited copies of the documetatio, please cotact your Cadle Support Services represetative. 22 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

23 1 Overview of I/CF Chapter overview Chapter cotets This chapter provides a overview of the IMS Cosole Facility (I/CF). It icludes a itroductio, a list of ew fuctios ad features, ad iformatio you eed to kow before you istall I/CF. Itroductio to I/CF Overview Available through CUA oly Cosole support capability Sigle poit of etry New Features Overview New ad modified features ad fuctios Storage Requiremets Itroductio Types of storage ad space requiremets Overview of I/CF 23

24 Itroductio to I/CF Itroductio to I/CF Overview The IMS Cosole Facility (I/CF) provides a complete IMS Master Cosole solutio for OMEGAMON II for IMS ad OMEGAMON II for DBCTL versio 500. This uit provides a overview of the product. Available through CUA oly Cosole support capability I/CF takes full advatage of Cadle Techologies by usig the CL/Egie to facilitate the IMS Master Termial iterface. I/CF is available oly through the CUA compoet of OMEGAMON II for IMS ad OMEGAMON II for DBCTL V300 ad above. I/CF provides cosole support for ay IMS DC or DB/DC eviromet that has VTAM coectivity to the MVS image ruig the OMEGAMON II for IMS or OMEGAMON II for DBCTL address space. You must start OMEGAMON II for IMS or OMEGAMON II for DBCTL o the same MVS system that rus your IMS or DBCTL subsystem if you wat to: Get MVS messages ot ormally set to the IMS Master Termial Provide a I/CF Cosole for a DBCTL eviromet Issue MVS ad VTAM commads Sigle poit of etry Importat Cadle recommeds that you start oe OMEGAMON II for IMS or OMEGAMON II for DBCTL CUA address space o each MVS system. You ca moitor ay umber of IMS systems. Refer to the overview of the sysplex cofiguratio sectio of Chapter 1, i the OMEGAMON II for IMS ad OMEGAMON II for DBCTL Cofiguratio ad Customizatio Guide. Sigle poit of etry I/CF provides a sigle poit of etry to the IMS Master Termial for multiple cocurret users. It also elimiates the eed to defie a physical device as the IMS Master Cosole with 24 hour per day support persoel. 24 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

25 New Features New Features Overview This uit provides a list of ew ad modified features ad fuctios that I/CF provides.the remaider of this documet details these features. New ad modified features ad fuctios I/CF cotais the followig features: 4-way scree scrollig IMS, MVS, ad VTAM commad etry Multi-directioal FIND Date/Time stamped Cosole log Commad etry audit Commad etry security Multi-color highlightig Cosole recovery facilities Message suppressio Direct VTAM logo iterface Sysout or dataset log User message loggig Exceptio loggig CICAT support Automatio iterface to OMEGACENTER Gateway for MVS Remote Cosole Iterface Overview of I/CF 25

26 Storage Requiremets Storage Requiremets Itroductio This uit lists the storage requiremets for I/CF. Types of storage ad space requiremets I/CF has the followig additioal storage requiremets. Note: Uless otherwise stated, the system releases all allocated storage whe the OMEGAMON II for IMS or OMEGAMON II for DBCTL CUA address space termiate. Table 4. Storage ad Space Requiremets Type of storage CSA Exteded CSA Private Exteded Private Descriptio 360 bytes Used to coect to the MVS Subsystem Iterface. Multiple OMEGAMON II for IMS or OMEGAMON II for DBCTL CUA address spaces reuse this storage. You must IPL the system to release this storage. Use the followig guidelies for Exteded CSA storage: 4K Used to coect to the MVS Subsystem Iterface. Multiple OMEGAMON II for IMS or OMEGAMON II for DBCTL CUA address spaces reuse this storage. You must IPL the system to release this storage. 520 bytes Per I/CF Master Cosole. 260 bytes Per user-requested subsystem cosole. 300 bytes Per OMEGAMON II for IMS or OMEGAMON II for DBCTL CUA address space. Does ot require additioal storage Use the followig guidelies for Exteded Private storage: 300 bytes 2k bytes Per I/CF cosole 160 bytes Per I/CF cosole viewable data lie 26 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

27 2 Istallig, Cofigurig, ad Customizig I/CF Chapter overview This chapter provides iformatio about istallig, cofigurig, ad customizig I/CF. You cofigure I/CF as part of the OMEGAMON II for IMS/DBCTL cofiguratio. This chapter provides: a broad overview of the istallatio, cofiguratio, ad customizatio process (as well as where you ca locate the iformatio you will eed) backgroud about the Cadle Istallatio ad Cofiguratio Assistace Tool (CICAT) a overview of how you istall OMEGAMON II for IMS ad OMEGAMON II for DBCTL usig CICAT a overview of how you cofigure OMEGAMON II for IMS ad OMEGAMON II for DBCTL usig CICAT ad a checklist listig the steps for the I/CF CICAT cofiguratio procedure a checklist listig the steps for the maual cofiguratio procedures a checklist listig the steps for the maual customizatio procedures Chapter cotets If you are istallig OMEGAMON II for IMS ad OMEGAMON II for DBCTL for the first time or you eed a remider about the differet compoets ad modes of operatio for OMEGAMON II for IMS ad OMEGAMON II for DBCTL, see the chapter Cofiguratio Plaig ad Cosideratios i the OMEGAMON II for IMSad OMEGAMON II for DBCTL Cofiguratio ad Customizatio Guide. Overview of the Process Itroductio Broad overview of the process Gettig help with CICAT CICAT Backgroud ad Requiremets Itroductio Restrictios o specifyig values i CICAT Istallig, Cofigurig, ad Customizig I/CF 27

28 Remider about the iformatio available CICAT Istallatio Procedure Itroductio Overview of the istallatio process usig CICAT CICAT Cofiguratio Procedures Itroductio Prerequisites for cofigurig OMEGAMON II for IMS/DBCTL ad I/CF 34 Remider about the iformatio available Accessig the Cofigure OMEGAMON II for IMS/DBCTL meu Example of the Cofigure OMEGAMON II for IMS/DBCTL meu i CICAT CICAT cofiguratio checklist Maual Cofiguratio Procedures Itroductio Remider about the iformatio available Maual cofiguratio checklist Maual Customizatio Procedures Itroductio Remider about the iformatio available Maual customizatio checklist OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

29 Overview of the Process Overview of the Process Itroductio This sectio provides a broad overview of the istallatio, cofiguratio, ad customizatio process. It also icludes iformatio about accessig help whe usig CICAT. Broad overview of the process The followig table cotais the broad steps you follow whe you istall, cofigure, ad customize OMEGAMON II for IMS ad OMEGAMON II for DBCTL. The table also shows where you ca fid the iformatio you will eed durig each of the steps. Table 5. Overview of the Process Step Actio Iformatio 1 Usig CICAT, istall the product ad create ay ew rutime eviromets. 2 Usig CICAT, cofigure the compoets you wat to use. 4 Maually cofigure the I/CF compoets. 5 Maually customize the I/CF compoets you wat to use. Istallig Cadle Products o MVS ad the olie help for the product pael you are usig Olie help for the product pael you are usig Chapters 3 ad 5 i this guide Chapters 3 i this guide Istallig, Cofigurig, ad Customizig I/CF 29

30 Overview of the Process Gettig help with CICAT The help for CICAT cotais detailed iformatio about usig the CICAT paels. For example, the help cotais iformatio about: how to use the pael why parameters are required what the available actio codes provide what the iput fields mea what you are required to supply To display help from ay CICAT pael, press the Help key (F1) or eter HELP o the commad lie. You ca also display help for the help. For example, you ca display iformatio about the commad to use to retur to the previous topic i the help system. To display the help for help from ay help pael, press the Help key (F1) or eter HELP o the commad lie. 30 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

31 CICAT Backgroud ad Requiremets CICAT Backgroud ad Requiremets Itroductio This sectio describes usig the Cadle Istallatio ad Cofiguratio Assistace Tool (CICAT). You must use CICAT to istall ad cofigure OMEGAMON II for IMS ad OMEGAMON II for DBCTL ad I/CF. CICAT is a ISPF dialog that guides you through the istallatio ad cofiguratio steps required to istall this product. Data etry paels assist you i uderstadig your site-specific parameter values. Associated help paels assist you i uderstadig the CICAT process ad describe the iput fields o the etry paels. CICAT is restartable. If ecessary, you ca ed the dialog, start it agai, ad cotiue from the poit of iterruptio. ISPF V2.3 or above is required to use CICAT. If you have ot previously istalled CICAT durig istallatio of this or ay other Cadle product, you must do so ow. For istructios o istallig CICAT, see the Istallig Cadle Porducts o MVS maual. If you wat to use CICAT from a previous istallatio, you must esure that it is the most curret versio of CICAT. The Istallig Cadle Porducts o MVS maual will help you make this determiatio. Restrictios o specifyig values i CICAT Importat ote: Eterig ampersad (&) i ay CICAT parameter strig, whether you are i iteractive or batch mode, results i a CICAT abed. Remider about the iformatio available If you eed iformatio about istallig OMEGAMON II for IMS ad OMEGAMON II for DBCTL usig CICAT, you ca locate iformatio i the: Istallig Cadle Porducts o MVS maual olie help for the product pael you are usig Istallig, Cofigurig, ad Customizig I/CF 31

32 CICAT Istallatio Procedure CICAT Istallatio Procedure Itroductio This sectio provides iformatio about the CICAT istallatio process, icludig iformatio o: selectig products to cofigure maagig your rutime eviromet Overview of the istallatio process usig CICAT The followig is a overview of how you select products to cofigure ad maage your rutime eviromet. The followig is a overview of how you select products to cofigure ad maage your rutime eviromet. 1. Ivoke CICAT. 2. Select from the CICAT Mai Meu as follows: If istallig a stadaloe product, select the item for the product. If istallig from a multi-product quick istall tape, select the item MultiProduct Quick Istall, level. 3. Esure that istallatio ad maiteace is completed before startig cofiguratio. 4. Select Assist Cofiguratio. 5. If a target RTE has ot already bee defied, use actio code A (Add) to defie a RTE. 6. Use actio B (Build) to allocate rutime libraries. 7. Use actio code C (Cofigure) to ivoke cofiguratio of a RTE. 8. Select a product to cofigure, depedig o how you selected from the CICAT Mai Meu, as follows: If you selected a sigle-compoet product o the CICAT Mai Meu, the product cofiguratio meu appears ad you ca proceed to cofigure. If you selected a multi-compoet product, a list of compoets appears. Select ad cofigure each compoet i the order preseted. If you selected a multi-product quick istall tape, a list of products ad compoets foud o the tape appears. Select ad cofigure each product/compoet i the order preseted. 9. If you wat to cofigure aother product ad it is ot part of a quick istall tape, retur to the iitial CICAT meu, select the product, ad retur to step 4 to select Assist Cofiguratio. 32 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

33 CICAT Istallatio Procedure 10. Whe you are fiished cofigurig all the products you wat i a RTE, retur to the Rutime Eviromets pael ad use actio code L (Load) to load the rutime libraries. 11. You ca ow proceed to verify ad customize the products you cofigured i your RTE. Istallig, Cofigurig, ad Customizig I/CF 33

34 CICAT Cofiguratio Procedures CICAT Cofiguratio Procedures Itroductio This sectio describes the CICAT cofiguratio procedures for I/CF. Prerequisites for cofigurig OMEGAMON II for IMS/DBCTL ad I/CF Before you start to cofigure I/CF, be sure that you have reviewed the cosideratios ad plaig iformatio i the chapter Cofiguratio Plaig ad Cosideratios i the OMEGAMON II for IMS ad OMEGAMON II for DBCTL Cofiguratio ad Customizatio Guide. The followig cofiguratio procedures assume that you have: Completed SMP/E istallatio ad applied maiteace for OMEGAMON II for IMS or OMEGAMON II for DBCTL, or for a MultiProduct Quick Istall tape that icludes OMEGAMON II for IMS or OMEGAMON II for DBCTL, as described i your Istallig Cadle Products o MVS maual. Remider about the iformatio available If you eed iformatio about cofigurig I/CF usig CICAT or specific iformatio about the values you specify usig CICAT, see the olie help for the product pael you are usig. 34 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

35 CICAT Cofiguratio Procedures Accessig the Cofigure OMEGAMON II for IMS/DBCTL meu To begi OMEGAMON II for IMS or OMEGAMON II for DBCTLcofiguratio: 1. Start CICAT. (For a remider, see your Istallig Cadle Products o MVS maual.) 2. O the CICAT Mai Meu: If you istalled the MultiProduct Quick Istall tape, select MultiProduct Quick Istall. To preview the list of products icluded i your MultiProduct Quick Istall tape, you ca use actio code V (View Additioal Iformatio) o MultiProduct Quick Istall. If you istalled OMEGAMON II for IMS or OMEGAMON II for DBCTL as a separate product, select it. 3. O the Istallatio/Cofiguratio Primary Meu, select Assist Cofiguratio. 4. O the Rutime Eviromets pael, use actio code C (Cofigure) o the RTE you are ready to cofigure. 5. If you istalled the MultiProduct Quick Istall tape or a multicompoet product, select OMEGAMON II for IMS or OMEGAMON II for DBCTL o the Product Cofiguratio Selectio Meu. 6. Proceed to use the Cofigure OMEGAMON II for IMS/DBCTL Meu. Istallig, Cofigurig, ad Customizig I/CF 35

36 CICAT Cofiguratio Procedures Example of the Cofigure OMEGAMON II for IMS/DBCTL meu i CICAT The followig figure is a example of the Cofigure OMEGAMON II for IMS/DBCTL meu CONFIGURE OMEGAMON II FOR IMS/DBCTL OPTION ===> Last selected Perform these cofiguratio steps i order: Date Time 1 Specify cofiguratio values 2 Allocate additioal rutime datasets 3 Create rutime members 4 Complete the cofiguratio Optioal: 5 Cofigure I/CF cosole commads 6 Cofigure I/CF trap commads 7 Istall Cadle Subsystem 8 Ru migratio utility 9 Istall BookMaager data F1=Help F3=Back 36 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

37 CICAT Cofiguratio Procedures CICAT cofiguratio checklist The followig table cotais the steps for cofigurig I/CF, that you perform o the CICAT Cofigure OMEGAMON II for IMS/DBCTL meu. The steps are listed i the sequece i which they are to be performed. Use the 4 colum to check off steps as you complete them. Table 6. CICAT Cofiguratio Procedure Checklist 4 CICAT Cofiguratio Step Use Cofigure I/CF cosole commads to specify the IMS cosole umber ad cosole commads parameters. See the olie help ad sub-parameter descriptios i ICFCONSL commad o page 107 for more iformatio about how to complete these fields. The result depeds o what is specified i the LOG field: Log usig Dataset (D), Sysout (S), or No (N) loggig If D is specified, eter the dataset iformatio. If S is specified, eter the pritig iformatio. If N is specified, there is o loggig. Use Cofigure I/CF trap commads to specify the IMS trap umber ad trap commads parameters. See the olie help ad sub-parameter descriptios for the ICFTRAP commad o page ICFTRAP commad o page 115 for more iformatio o how to complete these fields. Istallig, Cofigurig, ad Customizig I/CF 37

38 Maual Cofiguratio Procedures Maual Cofiguratio Procedures Itroductio This sectio provides iformatio about performig maual cofiguratio procedures for I/CF. Remider about the iformatio available The checklist i the followig table cotais the locatio where you ca fid the iformatio you will eed. Maual cofiguratio checklist The followig table cotais the steps you perform maually to cofigure I/CF. The steps are listed i the sequece i which they are to be performed. Use the 4 colum to check off steps as you complete them. Table 7. Maual Cofiguratio Procedure Checklist 4 Maual Cofiguratio Step Cofigure I/CF IMS SYSGEN chages usig Chagig the IMS system geeratio o page 43. Cofigure I/CF VTAM chages usig Defiig the VTAM Major Node for SYSA o page OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

39 Maual Customizatio Procedures Maual Customizatio Procedures Itroductio This sectio provides iformatio about performig maual customizatio procedures for I/CF. Remider about the iformatio available The checklist i the followig table cotais the locatio where you ca fid the iformatio you will eed. Maual customizatio checklist The followig table cotais the steps you perform maually to customize I/CF. The steps are listed i the sequece i which they are to be performed. Use the 4 colum to check off steps as you complete them. Cadle recommeds that you review the etire process before you begi customizig I/CF. Table 8. Maual Customizatio Procedure Checklist 4 Maual Customizatio Step Defie a I/CF cosole usig Defiig a I/CF Cosole o page 42. Defie a direct VTAM iterface usig Defiig a Direct VTAM Iterface o page 44. Defie a iterface for eterig VTAM commads usig Defiig a Iterface for Eterig VTAM Commads o page 46. Defie a commad resource class usig Defiig a Commad Resource Class o page 48. APF-authorize OMEGAMON II usig APF-Authorizatio Requiremets o page 50. Istallig, Cofigurig, ad Customizig I/CF 39

40 Maual Customizatio Procedures 40 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

41 3 Customizig I/CF Chapter overview Chapter cotets This chapter describes how to maually customize the IMS Cosole Facility by defiig a I/CF Cosole, defiig a direct VTAM iterface, defiig a VTAM commad etry iterface, ad defiig a commad resource class. Note: Use the procedures i this chapter whe you are modifyig a existig system. Defiig a I/CF Cosole Overview Usig the ICFCONSL commad Chagig the IMS system geeratio Defiig a VTAM APPLID Defiig a Direct VTAM Iterface Overview Modifyig KI2START Defiig the VTAM APPLID Defiig a Iterface for Eterig VTAM Commads Overview Defiig a Secodary Program Operator (SPO) applid Modifyig the startup parameters Defiig a Commad Resource Class Overview Creatig a commad resource class ame table Specifyig the commad resource class ame table APF-Authorizatio Requiremets Overview APF-authorizig OMEGAMON II Customizig I/CF 41

42 Defiig a I/CF Cosole Defiig a I/CF Cosole Overview You ca defie ay umber of IMS Master Termials to a sigle OMEGAMON II for IMS or OMEGAMON II for DBCTL address space. This maual method of defiig a master cosole cosists of issuig the ICFCONSL commad, chagig the IMS system geeratio, ad defiig the VTAM APPLID. This uit tells you how to do each of these steps. Note: For these chages to take effect, stop/restart the OMEGAMON II for IMS or OMEGAMON II for DBCTL CUA address space. If you choose to use CICAT, see Istallig, Cofigurig, ad Customizig I/CF o page 27. Usig the ICFCONSL commad Defie the I/CF cosole by modifyig the OMEGAMON II for IMS or OMEGAMON II for DBCTL startup commad. Step Actio 1 Edit rhilev.midlev.rkancmd(ki2start). 2 Add the ICFCONSL commad ad the appropriate parameters to KI2START. See ICFCONSL commad o page 107 for detailed iformatio about the ICFCONSL commad. 3 Save KI2START. 42 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

43 Defiig a I/CF Cosole Chagig the IMS system geeratio The followig is a example of the IMS system geeratio chages you eed to make to defie the IMS Master Cosole for use by I/CF. Note: This is oly required for IMS DC or IMS DB/DC systems. FIGURE 1. Sample IMS System Geeratio Chages *** *** IMS MASTER CONSOLE DEFINITION FOR I/CF *** TYPE UNITYPE=SLUTYPE1 TERMINAL NAME=xxxxxxxx,COMPT1=(CONSOLE,BASIC-SCS1) NAME (xxxxxxxx,master) NAME (xxxxxxxx) Defiig a VTAM APPLID The followig is a example of the VTAM APPLID you eed to defie the IMS Master Cosole for use by I/CF. FIGURE 2. Sample IMS Master Cosole Defiitio *** *** VTAM APPLID FOR I/CF MASTER CONSOLE *** ICFMJNOD VBUILD APPL xxxxxxxx APPL AUTH=(ACQ,NVPACE),EAS=1,ACB=yyyyyyyy I the example above, xxxxxxxx yyyyyyyy The 8-character VTAM APPLID. This must match the IMS system geeratio NAME subparameter i the TERMINAL macro. See Figure 1 above. The VTAM ACB ame. If you omit this subparameter, VTAM defaults to the APPLID as the ACB ame. Note: The ACB subparameter of the ICFCONSL commad requires the ACB ame, ot the APPLID. Customizig I/CF 43

44 Defiig a Direct VTAM Iterface Defiig a Direct VTAM Iterface Overview A direct VTAM iterface allows you to log o to the IMS Cosole Facility by typig the logo applid for I/CF. There are 2 steps to defiig a direct VTAM iterface, as follows: Step 1 Modify KI2START. 2 Defie the VTAM APPLID. Actio This uit describes each of these steps. Note: To make these chages take effect, stop/restart the OMEGAMON II for IMS or OMEGAMON II for DBCTL CUA address space. Modifyig KI2START Use the followig procedure to modify KI2START. Step Actio 1 Edit rhilev.midlev.rkancmd(ki2start). 2 Isert the followig lie: DIALOG yyyyyyyy KI2PICF where yyyyyyyy is the ACB ame. 3 Save KI2START. 44 OMEGAMON II for IMS ad OMEGAMON II for DBCTL IMS Cosole Facility V510

45 Defiig a Direct VTAM Iterface Defiig the VTAM APPLID The followig is a example of the VTAM APPLID you eed for the direct VTAM iterface. FIGURE 3. Sample Direct VTAM Iterface Defiitio *** *** VTAM APPLID FOR DIRECT VTAM INTERFACE *** ICFDLOG VBUILD APPL xxxxxxxx APPL AUTH=(ACQ,NVPACE),EAS=100,ACB=yyyyyyyy,PARSESS=YES I the example above, xxxxxxxx yyyyyyyy The 8-character VTAM APPLID. The VTAM ACB ame. This must match the ACB ame you used whe you modified KI2START i the sectio, Defiig a Direct VTAM Iterface o page 44. Customizig I/CF 45