Messages, Debugging and Diagnostics on BS2000 Systems
Total Page:16
File Type:pdf, Size:1020Kb
English FUJITSU Software openUTM V6.5 Messages, Debugging and Diagnostics on BS2000 Systems User Guide ©Siemens NixdorfInformationssysteme AG 1995 Pfad: P:\FTS-BS\openSEAS\openUTM\openUTMV6.5_1700900\07_Mtd_BS2\en\mtdbs_e.vor Edition December 2017 Comments… Suggestions… Corrections… The User Documentation Department would like to know your opinion on this manual. Your feedback helps us to optimize our documentation to suit your individual needs. Feel free to send us your comments by e-mail to: [email protected] Certified documentation according to DIN EN ISO 9001:2008 To ensure a consistently high quality standard and user-friendliness, this documentation was created to meet the regulations of a quality management system which complies with the requirements of the standard DIN EN ISO 9001:2008. cognitas. Gesellschaft für Technik-Dokumentation mbH www.cognitas.de Copyright and Trademarks Copyright © 2017 Fujitsu Technology Solutions GmbH. All rights reserved. Delivery subject to availability; right of technical modifications reserved. All hardware and software names used are trademarks of their respective manufacturers. This manual is printed on paper treated with chlorine-free bleach. Contents 1 Preface . 7 1.1 Summary of contents and target group . 9 1.2 Summary of contents of the openUTM documentation . 10 1.2.1 openUTM documentation . 10 1.2.2 Documentation for the openSEAS product environment . 14 19. Dezember 2017 Stand 08:54.34 2017 Dezember 19. Stand P:\FTS-BS\openSEAS\openUTM\openUTMV6.5_1700900\07_Mtd_BS2\en\mtdbs_e.ivz Pfad: 1.2.3 Readme files . 15 1.3 Changes in openUTM V6.5 . 16 1.3.1 New server functions . 16 1.3.2 Discontinued server functions . 23 1.3.3 New client functions . 24 1.3.4 New functions for openUTM WinAdmin . 25 1.3.5 New functions for openUTM WebAdmin . 25 1.4 Notational conventions . 26 2 Debugging and error diagnosis . 29 2.1 Debugging UTM applications . 29 2.1.1 Preparations for debugging in the dialog . 30 2.1.2 Starting the application and entering debugging commands . 32 2.1.3 STXIT response when debugging in the dialog . 34 2.1.4 Testing for errors when accessing the address zero . 34 2.1.5 Example . 35 2.2 Error diagnosis . 40 2.2.1 Return codes at the program interface . 40 2.2.2 UTM messages in response to program errors . 41 2.2.3 Addressing errors . 43 2.2.4 Diagnostic dump with defined messages/events . 43 2.2.5 Producing error documentation . 46 Dokuschablonen 19x24 Version 7.4de fürFrameMaker V7.x vom 09.02.2010 © cognitas GmbH 2001-2010 Messages, Debugging, Diagnostics on BS2000 Systems Contents 2.2.6 Traces . 47 2.2.6.1 Logging of KDCS calls from C/C++ program units . 47 2.2.6.2 BCAM trace in openUTM . 47 2.2.6.3 ADMI trace . 53 3 The UTM dump . 55 3.1 The files of the UTM dump . 56 3.1.1 Reducing the volume of dump information via the DUMP-CONTENT parameter . 58 3.2 The KDCDUMP utility routine . 59 3.2.1 Starting KDCDUMP . 60 3.2.2 KDCDUMP statements . 61 ! Enter system command . 62 !! Repeat most recently executed system command . 62 AFIND Find address in dump . 63 Scrolling statements for interactive evaluation . 63 DUMP Read UTM dump into memory . 65 EDT Call editor . 66 END Terminate KDCDUMP . 66 FGG Edit all files of an FGG . 67 FILE Edit single dump file . 69 HELP Help on KDCDUMP . 71 LIST Edit table section . 72 REPFILE Information about REP file . 73 SFIND Search for a string . 74 SH and SYS Interrupt KDCDUMP . 75 SYSLST Activate/deactivate logging . 75 TABLE Show table . 76 3.2.3 Messages of KDCDUMP . 78 3.3 Contents of the UTM dump . 79 3.3.1 The CONS_ENTRIES table . 80 3.3.2 The KDCROOT area . 81 3.3.2.1 Program table . 84 3.3.2.2 Load Module Table . 85 3.3.2.3 UTM Diagarea . 86 3.3.2.4 DB Diagarea . 98 3.3.2.5 Administration DIAGAREA . 103 3.3.2.6 Administration USERAREA . 107 3.3.2.7 KB communication area . 108 3.3.3 Summary information . 111 Messages, Debugging, Diagnostics on BS2000 Systems Contents 3.4 Sample dumps . 112 3.4.1 Sample dump K326 . 112 3.4.2 Sample dump STXIT . 115 4 UTM message concept . 117 4.1 Message module, message definition file . 119 4.2 Message destinations . 120 4.2.1 Output format of the messages . 121 4.2.2 UTM messages to the BS2000 console . 122 4.2.3 UTM messages to a TS application . 122 4.2.4 UTM messages to user-specific message destinations . 123 4.2.5 UTM messages to MSGTAC . 123 4.3 Modifying message output . 124 © Siemens Nixdorf Informationssysteme AG 1995 1995 AG Informationssysteme Nixdorf Siemens © P:\FTS-BS\openSEAS\openUTM\openUTMV6.5_1700900\07_Mtd_BS2\en\mtdbs_e.ivz Pfad: 4.3.1 Messages in other languages - KDCMTXT tool . 125 4.3.1.1 Inputs and outputs . 126 4.3.1.2 Calling KDCMTXT . 127 4.3.1.3 Control statements for KDCMTXT . 127 4.3.1.4 KDCMTXT log . 131 4.3.2 Generating a user-specific message module with KDCMMOD . 132 4.3.2.1 KDCMMOD inputs and output . 134 4.3.2.2 Starting and terminating KDCMMOD . 135 4.3.2.3 Control statements for KDCMMOD . 135 4.4 UTM log file SYSLOG . 144 4.4.1 Evaluating the SYSLOG file . 144 4.4.1.1 The KDCCSYSL tool – converting the SYSLOG file to SAM format . 145 4.4.1.2 The KDCPSYSL tool – inserting message texts . 147 4.4.1.3 KDCCSYSL and KDCPSYSL messages . 148 4.5 Structure of UTM system messages . 149 5 UTM messages . 151 5.1 Messages of the transaction monitor . 151 5.2 Messages of the XAP-TP provider . 294 5.2.1 General inserts for the XAP-TP messages . 314 5.3 Messages from the KDCDEF generation tool . 323 5.4 Messages from the UTM tools KDCCSYSL and KDCPSYSL . 331 Messages, Debugging, Diagnostics on BS2000 Systems Contents 5.5 Messages of the UTM tools KDCMMOD / KDCMTXT . 332 5.6 KDCDUMP messages . 334 5.7 Messages from the UTM tool KDCUPD . 338 5.8 Standard message definition.