A +--------------------------------------------------------------------+ | README file for SM2-PA V02.0A | | Edition: Juni 2000 | | | | SM2-PA V02.0A User Guide, U5643-J-Z125-2-7600 | | Edtion November 1993 | +--------------------------------------------------------------------+ Contents -------- 1 Extensions ............................................Page 1 2 Program execution .....................................Page 2 3 PREP-PC ...............................................Page 3 4 PREPARE-PCOUNTER-STATISTICS ...........................Page 4 5 PREP-TASK .............................................Page 4 6 List output ...........................................Page 5 7 Installation ..........................................Page 6 A Seite 1 1 Extensions SM2-PA V02.0A80 - START-SM2-PA SM2-PA has its own start command which is assigned to the SDF-Domain "UTILITIES" from SM2-PA Version V02.0A80. - Suppression of "zero lines" in PCOUNTER-STATISTICS (No) Output of address areas in which no program counter was taken. - /390-Time Starting from measurements with SM2 >= V14.0A the /390-Zeit is output in TASK-STATISTICS. - BS2000-Version in TASK-STATISTICS Starting from measurements with SM2 >= V14.0A the BS2000-Version is output in TASK-STATISTICS. 2 Program execution (Addition to page 28) Starting from SM2-PA V02.0A80 SM2-PA can be started with the BS2000-command START-SM2-PA. The "PL/1-text file" with the link name TEXTLINK is assigned automatically. +-------------------------------------------------------------------+ | START-SM2-PA | +-------------------------------------------------------------------+ | | | VERSION = *STD / | | ---- | | ,MONJV = *NONE / | | ----- | | ,CPU-LIMIT = *JOB-REST / | | --------- | | ,EVALUATION-FILE-NAME= *UNCHANGED / | | ---------- | | | | | | ,LIST-FILE-NAME= *UNCHANGED / | | ---------- | | | | | | ,SVC-FILE-NAME= *UNCHANGED / | | ---------- | | | | | +-------------------------------------------------------------------+ Operand description VERSION = Product version of the SM2-PA to be started. A Page 2 VERSION = *STD The current program version is called. VERSION = The specified program version is called. MONJV = Specifies a monitoring job variable for monitoring the SM2-PA run. The job variable must be already cataloged. MONJV = *NONE No monitoring job variable is used. MONJV = Name of the job variable to be used. CPU-LIMIT = Maximum CPU time, in seconds, that the program may use. If this time is exceeded, the user in the DIALOG mode is informed by the system; in BATCH mode the SM2-PA run is terminated. CPU-LIMIT = *JOB-REST The remaining CPU time should be used for the job. CPU-LIMIT = Only the specified time should be used. EVALUATION-FILE-NAME = *UNCHANGED The user-specific SM2 output file to be analyzed was assigned by means of PADTA file link name or will be assigned during program execution with SET-FILES / MODIFY-FILE-ASSIGNMENT. EVALUATION-FILE-NAME = Specifies the name of the user-specific SM2 output file which is assigned by means of PADTA file link name. LIST-FILE-NAME = *UNCHANGED The SM2-PA output file was assigned by means of PALST file link name or will be assigned during program execution with SET-FILES / MODIFY-FILE-ASSIGNMENT. LIST-FILE-NAME = Specifies the name of the SM2-PA output file which is assigned by means of PALST file link name. SVC-FILE-NAME = *UNCHANGED The SVC name file was assigned by means of PASVC file link name or will be assigned during program execution with SET-FILES / MODIFY-FILE-ASSIGNMENT. SVC-FILE-NAME = Specifies the name of the SVC name file which is assigned by means of PASVC file link name. A Page 3 3 PREP-PC (Addition to page 52 and 54) With output of the PCOUNTER PROGRAM and PCOUNTER MODULE statistics the output of "zero-lines" can be suppressed. Mask format of the PROGRAM analysis: +--------------------------------------------------------------------+ | PCOUNT-PROGRAM | | PRG=SM2 SAMPLES: 292 | | | | FROM TO ABSOLUT REL(%) | | ------------------------------------------------------------------ | | 00001EA6 00007975 167 57.19 XXXXXXXXXXXXXXXXXXXXXXXXXX | | 00007976 0000D445 7 2.40 XX | | 0000D446 00012F15 1 0.34 | | 00012F16 000189E5 0 0.00 | | 000189E6 0001E4B5 0 0.00 | | 0001E4B6 00023F85 0 0.00 | | 00023F86 00029A55 92 31.51 XXXXXXXXXXXXXXXXXXXXXXX | | 00029A56 0002F525 2 0.68 | | 0002F526 00034FF5 10 3.42 XXX | | 00034FF6 0003AAC5 0 0.00 | | 0003AAC6 00040595 0 0.00 | | 00040596 00046065 0 0.00 | | 00046066 0004BB35 6 2.05 XX | | 0004BB36 00051605 0 0.00 | | 00051606 000570DE 7 2.40 XX | | | | PRG FROM:00001EA6 TO:000570DE BYTES: 23248 LINES: 15/N | | PREP-SVC PREP-PC PREP-TASK SET-EVAL SET-FILES PRINT PRINT-EVAL END | +--------------------------------------------------------------------+ Mask description: ... Selection line: ... LINES: Output length in lines Definition of the handling of "zero-lines": /N : N = "zero-lines" are output /Y : Y = "zero-lines" are not output. The same applies to the MODULE analysis. A Page 4 4 PREPARE-PCOUNTER-STATISTICS (Addition to page 69) With output of the PCOUNTER PROGRAM and PCOUNTER MODULE statistics the output of "zero-lines" can be suppressed. +-------------------------------------------------------------------+ | PREPARE-PCOUNTER-STATISTICS | +-------------------------------------------------------------------+ | | | STATISTICS = *SUMMARY / *PROGRAM(...) / *MODULE(...) | | -------- | | *PROGRAM(...) | | ... | | ,SUPPRESS-ZERO-LINES = *NO / *YES | | --- | | *MODULE(...) | | ... | | , SUPPRESS-ZERO-LINES = *NO / *YES | | --- | +-------------------------------------------------------------------+ Operand description: SUPPRESS-ZERO-LINES = Definition of the handling of "zero-lines". SUPPRESS-ZERO-LINES = *NO "zero-lines" are output. SUPPRESS-ZERO-LINES = *YES "zero-lines" are not output. 5 PREP-TASK (Addition to page 59) Starting from measurements with SM2 >= V14.0A the BS200-Version of the measurement and the used /390-Time are output in TASK-STATISTICS. +--------------------------------------------------------------------+ | TASK-DETAIL FOR TSN: 0GL0( 1) BS2-VER: V14.0A | | USERID: TSOS CATEGORY: DIALOG JOBNAME: SF7 JOBCLASS: JCDTSOS | | START: 00-04-11 12:15:15 STOP: 00-04-11 12:23:56 | | | | ELAPSED TIME (S) 521.3809 ACTIVE WAITS 104 | | CPU-TIME (S) 3.2877 DURATION (S) 20.0513 | | IO 718 INACTIVE WAIT 206 | | PAM-PG PER DISK IO 2.4164 DURATION (S) 411.2983 | | SVC / TU STATE 773 DISK IO WAITS 713 | | PAGE FAULTS 3435 DURATION (S) 1.2257 | | PAGE READS 0 BOURSE LONG WAITS 30 | | PAGE RECLAIMS 272 DURATION (S) 81.3755 | | WSET (PPC) IN PAGES 74 INPUT MSG (1/S) 0.0517 | | SERVICE UNITS 26956 OUTPUT MSG (1/S) 0.5197 | | CPU SERVICE UNITS 18040 /390-TIME (S) 1.2976 | | IO SERVICE UNITS 7778 | | MEM SERVICE UNITS 1138 | | | | | | | |PREP-SVC PREP-PC PREP-TASK SET-EVAL SET-FILES PRINT PRINT-EVAL END | +--------------------------------------------------------------------+ A Seite 5 6 List ouput (Addition to page 97) Starting from measurements with SM2 >= V14.0A the BS200-Version of the measurement and the used /390-Time are output in TASK-STATISTICS. SM2-PA TASK STATISTICS ( DETAIL ) ------------------------------------------------------------ I DESCRIPTOR I BS2-VER: V14.0A 0GL0( 1) I ------------------------------------------------------------ I USERID I TSOS I I TSN..................I..............................0GL0 I I JOBNAME I SF7 I I JOBCLASS.............I...........................JCDTSOS I I CATEGORY I DIALOG I I START-DATE...........I..........................00-04-11 I I START-TIME I 12:15:15 I I END-DATE.............I..........................00-04-11 I I END-TIME I 12:23:56 I I ELAPSED TIME (S).....I..........................521.3809 I I TOTAL CPU TIME (S) I 7.1761 I I TOTAL IO.............I..............................1345 I . . . I INPUT MSG (1/S) I 0.0517 I I AVG INP.-LGTH (BYTES)I................................23 I I OUTPUT MSG (1/S) I 0.5197 I I AVG OUTP.-LGTH(BYTES)I...............................629 I I PAM-PG PER DISK IO I 2.4164 I I KB PER NON DISK IO...I............................0.0000 I I VECTOR UNIT TIME (S) I 0.0000 I I TOT /390-CPU-TIME (S)I............................6.5987 I I /390-CPU-TIME (S)I 1.2976 I ------------------------------------------------------------ Monitored values and their meanings: TOT /390-CPU-TIME (S) This value is only supplied on risc machines. It specifies the accumulated CPU time in /390 mode in seconds since task creation. /390-CPU-TIME (S) This value is only supplied on risc machines. It specifies the accumulated CPU time in /390 mode in the task monitoring cycle. A Seite 6 7 Installation (Addition to page 109) The following files are provided on the product tape for SM2-PA V02.0A: SM2-PA Prephase SYSLNK.SM2-PA.020 Program library SYSSII.SM2.124 Declaration file for IMON SYSMSP.SM2-PA.020.D PLI1 text file (German) SYSMSP.SM2-PA.020.E PLI1 text file (English) SYSSPR.SM2-PA.020 Procedur for the START-SM2-PA command SYSSDF.SM2-PA.020 Syntax file with all statements SYSMES.SM2-PA.020 Message file SYSMSV.SM2-PA.020 Message file SYSFGM.SM2-PA.020.D Release notice (German) SYSFGM.SM2-PA.020.E Release notice (English) SYSRME.SM2-PA.020.D Readme file (German) SYSRME.SM2-PA.020.E Readme file (English) Note: The SYSSPR.SM2-PA.020 must always be installed under default user ID (defined using the systemparameter DEFLUID).