A Fujitsu Technology Solutions ============================ Information on this document ---------------------------- On April 1, 2009, Fujitsu became the sole owner of Fujitsu Siemens Computers. This new subsidiary of Fujitsu has been renamed Fujitsu Technology Solutions. This document from the document archive refers to a product version which was released a considerable time ago or which is no longer marketed. Please note that all company references and copyrights in this document have been legally transferred to Fujitsu Technology Solutions. Contact and support addresses will now be offered by Fujitsu Technology Solutions and have the format ...@ts.fujitsu.com. The Internet pages of Fujitsu Technology Solutions are available at http://ts.fujitsu.com/... and the user documentation at http://manuals.ts.fujitsu.com. Copyright Fujitsu Technology Solutions, 2009 Hinweise zum vorliegenden Dokument ---------------------------------- Zum 1. April 2009 ist Fujitsu Siemens Computers in den alleinigen Besitz von Fujitsu uebergegangen. Diese neue Tochtergesellschaft von Fujitsu traegt seitdem den Namen Fujitsu Technology Solutions. Das vorliegende Dokument aus dem Dokumentenarchiv bezieht sich auf eine bereits vor laengerer Zeit freigegebene oder nicht mehr im Vertrieb befindliche Produktversion. Bitte beachten Sie, dass alle Firmenbezuege und Copyrights im vorliegenden Dokument rechtlich auf Fujitsu Technology Solutions uebergegangen sind. Kontakt- und Supportadressen werden nun von Fujitsu Technology Solutions angeboten und haben die Form ...@ts.fujitsu.com. Die Internetseiten von Fujitsu Technology Solutions finden Sie unter http://de.ts.fujitsu.com/..., und unter http://manuals.ts.fujitsu.com finden Sie die Benutzerdokumentation. Copyright Fujitsu Technology Solutions, 2009 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).