HP 3000 Manuals

MPE/iX 5.0 Documentation


Migration Process Guide

Using RTMREP 

RTM does not automatically generate reports.  However, all run-time
events that are captured are recorded in a system log file.  A report of
events logged can be generated by running RTMREP. Descriptions of the
events logged by RTMSYS are found in Appendix D, "Incompatibilities".

There are two report formats.

   *   A program summary (the default), a brief report that shows all
       events generated by each program.  A counter shows the number of
       times that a particular segment/offset caused the event.  The
       report is sorted by date, program name, and event class.

   *   A detailed report shows all events logged.  These events are
       sorted by date, program name, and event class.  All information in
       the log record is formatted and displayed in chronological order.


NOTE RTMREP cannot access the current system log file. If you want to generate a report from the current system log file, you must first close it with the :SWITCHLOG command.
To generate a report, enter the following: :RUN RTMREP.PUB.SYS :RTMREP prompts you for the choice of a program summary or detailed report. Additionally, LISTLOG5.PUB.SYS can be used to examine the log file for entries. Refer to the MPE V/E Utilities Reference Manual (32033-90008) for more information on LISTLOG5. RTMREP has a HELP facility can be invoked at any time by entering ?. An explanation of the current prompt is then displayed, followed by the same prompt. You may also issue any MPE V/E command that can be executed programmatically be prefixing it with a colon (:). Output Device Specification The output formal file designator is RTMLIST, which by default is opened with device class LP. The :FILE command can be used to redirect the output as necessary. Figure C-5 charts the flow of control with RTMREP prompts. The prompts are described under the following headings. Defaults for all prompts are shown in upper case. Figure C-5. RTMREP Detail Line Prompt. HP30364A.00.00 Run Time Monitor (C) HEWLETT PACKARD COMPANY 1986 Enter a question mark (?) at any prompt for help. Default answers for all prompts are shown in upper case. Do you want a detail line for each event [yes/NO]? * A positive answer to this prompt gives you the detailed report. * A negative answer (the default) to this prompt gives you the summary report. Either response takes you to the Log File Specification prompts. Log File Specification Prompt. You may specify a range of log files to be analyzed for the report Enter first log file: Enter last log file: To examine a range of log files, type the starting log file number and the last log file number. To examine only one log file, enter the log file number in response to the Enter First Log File prompt and a Return to the Enter Last Log File number. Either response takes you to the Subset prompt. Subset Prompt. Do you want to report on a subset of available data [yes/NO]? * A positive response allows you to tailor the report to your needs by selecting specific a subset of programs. This takes you to the Enter Program File Subset prompt. * A negative response (the default) reports on all available information. Enter Program File Subset Prompt. Enter program file subset [CR will select all]: You are being prompted for the name of a file(s) you want RTMREP to create a report about. In addition, you can specify a set of program files using wild card characters (@, #, ?) in conjunction with MPE V/E file specifications. For example, the following file set specification indicates all program files that start with the letter "C": C@.MYGROUP.MYACCT Enter Class Numbers Prompt. Enter class numbers, separated by commas, or CR for all: You are being prompted for the event classes you want included in the report RTMREP creates. Exiting RTMREP After report specifics are complete, RTMREP prints the report, then exits.


MPE/iX 5.0 Documentation