IBM System/3 Model 15D System Measu rement Reference and Logic Manual PRPO 5799.AYO Facility

a a a a a a a a

a a a a a a a a

a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a o a a a a a a a a a a a

a a a a a a a a

a a a a a a a a

a a a a a a a a

a a a a a a a a

o a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a o a a

a a a a a a a a a a a a

a a a a a a a a a a a a

a a a o a a a a a a a a

a a a a a a a a a a a a a a a a a a a a a a o a a a a a a a a a a a a a a a a a a a a a a a a a a a a a

a a a a a a a a a a a a

a a a a a a a a

a a a a o a a a a a a a a a a a a a a a a a a a a a a a a a

a a a a a o a a

a a a a a a a o

a o a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a o t a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a o a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a

oo a a a

IBM System/3 M o d e l 1 5 D

System Measu rement Reference and

L o g i c M a n u a l P R P O 5 7 9 9 . A Y O

F a c i l i t y

a a a a a a a a a a a a a a a a a o a a a a a a a a a a

a a a a a a a a a a a a a a a a o a o a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a o o a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a

a a a a a a a a a a a a a a a a a a

a a a a a a a a a o a a a a a a a a a a a a a a

a a a a a a a a

a a a a a a a a

a a a a a a a a a a a a a o a o o a a a o a a t a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a o a a a a a a a a a a a

a a a a a a a a

a a a a a a a a

a a a a a a a a a a a a a a a a o a a a a a a a

GC21-5207-1 File No. 53-34

a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a o a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a a o a a a a a a a a a a a a a a a a a a a

a a a a a a a a a a a a a a a a a a

Second Edition (September 19791

T h i s e d i t i o n a p p l i e s t o v e r s i o n 4 , m o d i f i c a t i o n 0 o f t h e I B M S y s t e m / 3 M o d e l 1 5 D S y s t e m M e a s u r e m e n t F a c i l i t y ( P r o g r a m N u m b e r 5 7 9 9 - A Y O ) a n d t o a l l s u b s e q u e n t v e r s i o n s a n d m o d i f i c a t i o n s u n t i l o t h e r w i s e rndicated in new editions or technical newsletters.

C h a n g e s o r a d d i t i o n s t o t h e t e x t a n d i l l u s t r a t i o n s are indicated bV a vertical trne to t h e l e f t o f t h e c h a n g e o r a d d i t i o n .

C h a n g e s a r e p e r r o d i c a l l y m a d e t o t h e i n f o r m a t i o n h e r e i n ; b e f o r e u s i n g t h i s p u b l i c a t i o n i n c o n n e c t i o n w i t h t h e operation of IBM systems, be sure you have t h e l a t e s t e d i t i o n a n d a n y t e c h n i c a l n e w s l e t t e r s .

U s e t h i s p u b l i c a t i o n o n l y f o r t h e p u r p o s e s s t a t e d i n the Preface.

P u b l i c a t i o n s a r e n o t s t o c k e d a t t h e a d d r e s s below. Requests for copies of IBM p u b l i c a t i o n s a n d f o r t e c h n i c a l r n f o r m a t i o n a b o u t t h e s y s t e m s h o u l d b e m a d e t o y o u r I B M r e p r e s e n t a t t v e or to the branch office serving your locality.

T h i s p u b l i c a t i o n c o u l d c o n t a i n t e c h n i c a l i n a c c u r a c i e s o r t y p o g r a p h i c a l e r r o r s . A d d r e s s y o u r c o m m e n t s a b o u t t h i s p u b l i c a t i o n to I B M C o r p o r a t i o n , P u b l i c a t r o n s , D e p a r t m e n t 2 4 5 . R o c h e s t e r , M i n n e s o t a 5 5 9 0 1 . I B M m a y u s e a n d d i s t r i b u t e a n y o f t h e i n f o r m a t i o n y o u s u p p l y i n a n y w a y i t b e l i e v e s a p p r o p r i a t e without incurring a n y o b l i g a t i o n w h a t e v e r . Y o u m a y , o f c o u r s e , c o n t i n u e to use the information you s u p p l y .

O C o p y r i g h t I n t e r n a t i o n a l Business Machines Corporation 1978, 1979

This publication is intended primadly for users of the System/3 Model 15D. The reference informatron is intended for programmers, systems analysts and, occasionally, the operator. The logic information is intended for program support representatives ano customer engineers.

The responsibility for the installation of this program and the interpretation of the results rests solely with the user. IBM assumes no responsibility for the

interpretation of the results; any benefits to be gained from the use of this program must be assessed bv the individual user.

The System/3 Model ISD System Measurement Facility is a licensed program that consists of two components:

The data collection program collects information while user applications are executing and writes that information to a disk file; the data rduction program prints a summary of this information for interpretatron.

This publication contains two parts, each addressing one of the programs. part I describes the data collection program, its purpose, description, installation, operation.

and logic. Part ll describes the data reduction program, its purpose, description, installation, and operation; it also includes some examples of how the results might be interpreted.

The System Measurement Facility collects data retating to CCP and batch partitions, spool, the processtng untt, nAA/$44 disk, and binary synchronous

communications lines supported by CCp (BSCA, BSCC.

and display adapter). The facility does not collect data relating to unit record devices (card readers and punches, directly attached 3741 , and 14O3 printers), tape drives, MLTA, S|OC, MRJE/WS, RpG tl Telecommunications. or ML/Mp programs.

Preface

Related Publications

T h e r e a d e r s h o u l d b e f a m i l i a r w i t h S y s t e m / 3 Model 15D and with CCP. lf more information is required, refer to the following publicatrons.

. IBM System/3 Modets g, 10, 12 aN 15 Components Reference Manual, GA21 -9236

. IBM System/3 Model 15 Operator,s Guide.

c c 2 1 - 5 0 7 5

. IBM System/3 Modet 15 System Messages, G C 2 1 - 5 0 7 6

. IBM System/3 Model 15 System Control Programming Concepts aN Reference Manuat.

cc21-5162

. IBM System/3 Modet 15 Communications Contro/

Program System Reference Manual, GC21_7620 . IBM System/3 Communications Contro/ program

System Design Guide, GC2j-5165

. IBM System/3 Modet j5 Systern Data Areas and Diagnostic Aids, Sy21 -0052

. IBM System/3 Mdel 15 Communications Contro/

Program Data Areas aN Diagnostic Aids, Sy21_OO4O Note: The data collection program can be used only with version 3 or later versions of program S7O4_SC2.

Contents

P A R T 1 : D A T A C O L L E C T I O N . P u r p o s e a n d D e s c r i p t i o n

I n s t a l l a t i o n .

O p e r a t i o n . . . . . 1 - i

M a i n S t o r a g e R e q u i r e m e n t s . . . 1 - 2

C o n s i d e r a t i o n s . . . 1 - 2

S a m p l i n g C o n s i d e r a t i o n s . . . . 1 - 3

M e s s a g e s . . . . . 1 - 3

R e c o r d D e s c r i p t i o n s . . . 1 - 5

T y p e l R e c o r d . . . 1 - 6

T y p e 2 R e c o r d

1 - 1 1 - 1 1 - 1

L o g i c l n f o r m a t i o n . . . 1 - 1 2

P A R T 2 : D A T A R E D U C T I O N . . . . . 2 - 1

P u r p o s e a n d D e s c r i p t i o n . . . 2 - 1

f n s t a l l a t i o n . . . . 2 - j

O p e r a t i o n . . . 2 - 1

M a i n S t o r a g e R e q u i r e m e n t s . . . 2 - 2

D e s c r i p t i o n o f O u t p u t . . . 2 - 2

S y s t e m C o n f i g u r a t i o n l n f o r m a t i o n . . . . 2 - 2 S u m m a r y o f S a m p l e l n f o r m a t i o n . . . 2 - 3

E x a m p l e s . . . . 2 - 6

E x a m p f e 1 . . . . . . . 2 5

E x a m p l e z . . . . . . . 2 - 1 2

E x a m p l e 3 . . . . . . . . . . . 2 - 1 2

P A R T 1 : D A T A C O L L E C T I O N

PURPOSE AND DESCRIPTION

The data collection program, utilizing statistical

sampling, provides information in a disk file concerning the status of the operating system and selected l/O devices of a System/3 Model 1SD.

The data collection program can be loaded only in partition 1, and it becomes attached to the supervisor after loading. The program is then deallocated from the partition, freeing partition 1 (except for IOK) for other jobs.

Once started, the data collection program gains control of the system every two seconds and records the information obtained from the system queues and l/O devices. This information is written to a 33zlo/33214 main data area every '16 seconds.

The program records information until one of the following events occurs:

. The system operator stops the program;

. A disk error occurs while writing the statistical information:

. The disk file becomes full.

The system operator can start and stop the data collection process as many times as is required (see Considerations). The number of samples collected is limited only by the size of the file allocated during initiation of the program.

The collected information is written to a standard System/3 data file and may be accessed by a high-level language program {for example, COBOL, FORTRAN, or RPG f f). For a description of the disk file, see Record Descriptions.

Part 1: Data Collection

Installation

Use the following OCL and control statements for the library maintenance program ($MAINT) to copy the data collection program to an object library:

/ / L O A D $ M A l N T , u n i t l / / R U N

/ / C O P Y F R O M - R E A D E R , T O - u n i t 2 . L t B R A R Y - O . N A M E - 5 3 D S M F , R E T A I N - P

/ / E N D w h e r e :

u n i t l i s t h e u n i r th a t c o n t a i n s $ M A l N T .

unit2 is any simulation area that contains an obiect library.

Operation

The data collection program (S3DSMF) must be loaded in Partition 1 using the following OCL:

/ / L A A D S 3 D S M F , u n i t l

/ / T T I E N A M E - $ M O N I T O R , U N I T - D X , P A C K - p a c k n a m e , R E T A | N

{ ; } , T R A C K S - n n n / / R U N

w n e r e :

unitl is the simulation area that contains the data collection program.

Dx is any main data area.

p a c k n a m e i s a n y v a l i d S y s t e m / 3 p a c k name.

nnn is the number of tracks (see below).

The RETAIN code can be specified as either T (temporary) or P (permanent).

D a t a C o l l e c t i o n 1 - 1

T h e n u m b e r o f t r a c k s d e p e n d s o n t h e l e n g t h o f t i m e that the data collection program is expected to run.

About 1 track is reouired for each 96 seconds of e x e c u t i o n . T h e f o l l o w i n g t a b l e c a n b e u s e d a s a g u i d e f o r d e t e r m i n i n g t h e s i z e o f t h e f i l e .

C O N S I D E R A T I O N S

D o n o t d e l e t e t h e $ M O N I T O R f i l e w h i l e t h e d a t a

c o l l e c t i o n p r o g r a m i s l o a d e d . U n p r e d i c t a b l e re s u l t s , s u c h a s o v e r l a i d d a t a o r i n v a l i d o u t p u t , w i l l o c c u r .

D o n o t r e m o v e t h e p a c k t h a t c o n t a i n s t h e $ M O N I T O R f i l e w h i l e t h e d a t a c o l l e c t i o n p r o g r a m i s l o a d e d . U n p r e d i c t a b l e re s u l t s , s u c h a s o v e r l a i d d a t a o r i n v a l i d o u t p u t , w i l l o c c u r .

O n l y t h e P F 4 , P F s , a n d P F 6 k e y s o n t h e s y s t e m c o n s o l e can be used to control the data collection program.

T h e s e k e y s m u s t b e a v a i l a b l e w h e n t h e p r o g r a m i s l o a d e d ; a n d o n c e t h e p r o g r a m i s l o a d e d , t h e s e k e y s c a n n o t b e u s e d b y o t h e r p r o g r a m s .

T o c h a n g e a p a c k w h i l e t h e d a t a c o l l e c t i o n p r o g r a m i s loaded, press the PF6 key on the system console, c h a n g e t h e p a c k , t h e n p r e s s t h e P F 4 k e y t o r e s u m e d a t a c o l l e c t r o n . D o n o t c h a n g e t h e p a c k t h a t c o n t a i n s t h e

$ M O N I T O R f i l e .

T h e d a t a c o l l e c t i o n p r o g r a m r e q u i r e s 1 0 K f o r e x e c u t i o n . O n c e t h e d a t a c o l l e c t i o n p r o g r a m h a s b e e n l o a d e d , t h i s 1 O K w i l l n o t b e a v a i l a b l e to a n y p a r t i t i o n u n t i l a n I P L i s performed.

T o s h u t d o w n C C P w h i l e t h e d a t a c o l l e c t i o n p r o g r a m i s l o a d e d , p r e s s t h e P F 6 k e y o n t h e s y 5 t e m c o n s o l e a n d t h e n s h u t d o w n C C P . A f t e r t h e C C P p a r t i t i o n h a s g o n e to EJ, the data collection program may be restarted by pressing the PF4 key on the system console.

T o o b t a i n a m o r e m e a n i n g f u l p i c t u r e o f s y s t e m r e s o u r c e s a n d u s a g e , i t i s r e c o m m e n d e d t h a t s e v e r a l s m a l l i n t e r v a l s b e r e c o r d e d r a t h e r t h a n o n e l a r g e i n t e r v a l . F o r e x a m p l e , s i x 1 0 - m i n u t e i n t e r v a l s m i g h t g i v e a b e t t e r r e p r e s e n t a t i o n t h a n o n e 1 - h o u r i n t e r v a l ( s e e S a m p / i n g Considerations).

T h e d a t a c o l l e c t i o n p r o g r a m r e q u i r e s fu l l t i m e r s u p p o r t . 3340/3344 usage counts will not be saved for printout b y t h e C E d i a g n o s t i c p r o g r a m s w h i l e t h e d a t a c o l l e c t i o n p r o g r a m i s a c t i v e .

l f t h e $ M O N I T O R f i l e i s t o b e r e u s e d a n d a p r i n t e d reoort is desired from the collected data, the data reduction program must be loaded before the PF5 key is p r e s s e d t o c l e a r t h e $ M O N I T O R f i l e . A n y d a t a p r e s e n t l y i n t h e $ M O N I T O R f i l e w i l l b e l o s t w h e n t h e f i l e i s cleared.

Approximate

Time Records

1 5 m i n u t e s 4 5 0 30 minutes 9OO 6 O m i n u t e s 1 8 O O 4 h o u r s 7 2 O O

8 hours 144OO

1 6 h o u r s 2 8 8 0 0

24 hours 432OO

Tracks 1 0 1 9 3 8

t c u

300 600 900

A f t e r t h e d a t a c o l l e c t i o n p r o g r a m i s l o a d e d , a m e s s a g e i s d i s p l a y e d o n t h e c o n s o l e ( M O N I T O R R E A D Y - P R E S S PF4 TO START). The PF4 key activates the program.

Pressing the PF6 key stops the program. Later, the PF4 k e y c a n a g a i n b e u s e d t o s t a r t t h e d a t a c o l l e c t i o n . T h u s , the PF4 and PF6 keys can be used to select tne

i n t e r v a l s to b e m e a s u r e d .

l f t h e u s e r w i s h e s t o r e u s e t h e $ M O N I T O R f i l e , t h e P F S k e y m a y b e p r e s s e d t o c l e a r t h e f i l e .

l f t h e t r a c e p r o g r a m ( $ T R A C E ) o r t h e t r a n s a c t i o n lo g g i n g p r o g r a m ( $ T R L O G ) is r e q u i r e d a r t h e s a m e t i m e a s t h e d a t a c o l l e c t i o n p r o g r a m ( S 3 D S M F ) , t h e n t r a c e a n d / o r t r a n s a c t i o n lo g g i n g m u s t b e l o a d e d f i r s t .

T h e d a t a c o l l e c t i o n fi l e ( $ M O N I T O R ) m u s t n o t o e d e l e t e d , a n d t h e p a c k c o n t a i n i n g th e f i l e m u s t n o t b e removed while the data collection program is loaded (see Considerations).

Main Storage Requirements

T h e d a t a c o l l e c t i o n p r o g r a m m u s t b e l o a d e d i n t o partition 1 which must be set to a size equal to or greater than 20K. After the data collection program is l o a d e d ( m e s s a g e M O N I T O R R E A D Y - P R E S S P F 4 T O S T A R T ) , p a r t i t i o n 1 w i l l b e a v a i l a b l e fo r u s e b y o t h e r p r o g r a m s a t a s i z e o f 1 0 K l e s s t h a n i t w a s b e f o r e t h e d a t a c o l l e c t i o n p r o g r a m w a s l o a d e d .

T h e 1 0 K t h a t t h e d a t a c o l l e c t i o n p r o g r a m u s e s w i l l r e m a i n u n a v a i l a b l e t o t h e r e s t o f t h e s v s t e m u n t i l a n I P L is oerformed.

Sampling Considerations

T h e f o l l o w i n g i s a d i s c u s s i o n o f s a m p l i n g a n d s t a t i s t i c a l t e c h n i q u e s th a t a p p l y t o t h e S y s t e m M e a s u r e m e n t Facility. A simple awareness of these ootential

p r o b l e m s s h o u l d b e s u f f i c i e n t to a l l o w y o u t o m a K e very effective use of the Facilitv. Some of these items are i n c l u d e d i n t h e e x a m p l e s l a t e r i n t h i s p u b l i c a t i o n . A 9 a m p l i n g t e c h n i q u e b e s t s u i t e d t o a p a r t i c u l a r e n v i r o n m e n t w i l l v a r y f r o m u s e r t o u s e r . y o u m i g h t experiment with the variables, such as length of the p e r i o d a n d t h e t i m e o f t h e d a y b e i n g s a m p l e d , u n t i l y o u f i n d t h e m o s t r e p r e s e n t a t i v e s a m p l e f o r y o u r i n s t a l l a t i o n . T h e s a m p l e p e r i o d s h o u l d n o t b e e x c e s s i v e l y lo n g , n o r s h o u l d i t b e s o s h o r t t h a t t h e p e r i o d i s n o t m e a n i n g f u l . l f y o u a d j u s t y o u r a p p l i c a t i o n p a r a m e t e r s b a s e d o n a s h o r t m e a s u r e m e n t p e r i o d , y o u m a y f i n d t h a t t h e r e w a s no effect, or even adverse effect, on throughput performance. Thus, selection of a representative measurement period is very important.

Many of the data items in the report are gathered through statistical sampling, rather than subtotaling counters. These include many of the utilization figures and average queue sizes. With any sampling method, there is some inherent random error in the result. This error does not imply that the results are not useful, but rather that you should use them with knowledge of this limitation. The error certainly is reduced with a larger number of samples. With the fixed inter-samole time of two seconds, a longer sampling period must be used.

lf you understand this potential error, you can avoid a misinterpretation of the results. For example, you could erroneously attribute small changes in measureo utilizations to changed workloads or to changed generatton parameters, when actually no change occurred, and the difference is in random sampling error. Again, this possibility is reduced by using larger s a m p l e s a n d c o n s i d e r i n g o n l y l a r g e r f l u c t u a t i o n s ln measured results.

The sample period should be representative of the entire period. That is, if you don't want to run the data collection program for the entire period, be sure that the sample period you select is representative.

By using several data collection periods over a time of interest, rather than one long period, you can collect information on how the system usage varies over time.

Using several short periods, you may discover widely varying conditions contributing to, but not resembling, t h e s i n g l e a v e r a g e . Y o u c o u l d fi n d t h a t m o r e th a n o n e problem area really exists.

T h u s y o u m i g h t f i n d , f o r e x a m p l e , t h a t s i x 1 0 - m i n u t e i n t e r v a l s y i e l d b e t t e r re s u l t s t h a n o n e 1 - h o u r s a m p l e .

M E S S A G E S

The following messages are displayed on the system console by the data collection program.

M O N I T O R A N D S Y S T E M N O T C O M P A T I B L E Reason

An attempt was made to load the data collection program under the control of version 1 or version 2 o f p r o g r a m 5 7 O 4 - 5 C 2 .

P F 4 , P F 5 O R P F 6 K E Y N O T A V A I L A B L E - M O N I T O R T E R M I N A T E D .

Reason

T h e d a t a c o l l e c t i o n p r o g r a m w a s u n a b l e t o a l l o c a t e I the PF4, PF5 or PF6 key on the system console.

Another partition has the key allocated.

Recovery

I Wait for the partition that owns the PF4, PFS or PF6 key to terminate; then load the data collection p r o g r a m .

A T T E M P T I N G T O L O A D M O N I T O R I N O T H E R T H A N P l _ T E R M I N A T E D .

Reason

An attempt was made to load the data collection p r o g r a m i n o t h e r th a n p a r t i t i o n 1 . l t m u s t b e l o a d e d i n p a r t i t i o n 1 . ( T h e d a t a c o l l e c t i o n p r o g r a m i s n o t l o a d e d . )

Recovery

Load the data collection program in partition 1.

D a t a C o l l e c t i o n 1 - 3

M O N I T O R A L R E A D Y L O A D E D . Reason

P 1 N O T 2 O K . Reason

P a r t i t i o n 1 i s n o t e q u a l to o r g r e a t e r t h a n 2 0 K . T h e d a t a c o l l e c t i o n p r o g r a m re q u i r e s 2 0 K f o r i n i t i a t i o n . Recovery

Set partition 1 to at least 20K; then load the data collection program.

M O N I T O R R E A D Y - P R E S S P F 4 T O S T A R T . Reason

The data collection program has loaded successfully;

the PF4 key on the system console will start the data collection process.

Recovery N o n e r e q u i r e d .

M O N I T O R R U N N I N G - P R E S S P F 6 T O S T O P . Reason

The PF4 key on the system console has been pressed; the data collection program has started/resumed collecting system status.

Recovery N o n e r e q u i r e d .

M O N I T O R S T O P P E D - P R E S S P F 4 T O S T A R T . Reason

T h e P F 5 k e y o n t h e s y s t e m c o n s o l e w i l l c l e a r th e f i l e a n d a l l o w i t t o b e u s e d a g a i n . l f t h e $ M O N I T O R f i l e i s t o b e reused and a printed report is desired from the collected data, the data reduction program must be loaded before t h e P F 5 k e y i s p r e s s e d t o c l e a r th e $ M O N I T O R f i l e . A n y d a t a p r e s e n t l y i n t h e $ M O N I T O R f i l e w i l l b e l o s t w h e n t h e f i l e i s c l e a r e d .

An attempt was made to load the data collection The PF6 key on the system console has been program when it was previously loaded. The data pressed; the data collection program has ceased collection program can be loaded only once per lPL. collecting system status.

Recovery Recovery

Wait for all partitions to go to end of job and perform Press the PF4 key on the system console to resume an IPL; the data collection program may now be collecting the system status.

l o a d e d .

I S T H E $ M O N I T O R F I L E T O B E C L E A R E D ? P R E S S P F 5 T O C L E A R _ P F 6 N O T T O .

Reason

The PF5 key on the system console has been pressed; the data collection program is making sure t h e $ M O N I T O R f i l e i s t o b e c l e a r e d .

Recovery

Press the PF5 key on the system console to clear

$ M O N I T O R f i l e . P r e s s t h e P F 6 k e y o n t h e s y s t e m c o n s o l e i f t h e $ M O N I T O R f i l e i s n o t t o b e c l e a r e d . D I S K F I L E F U L L - M O N I T O R S T O P P E D .

P R E S S P F s T O C L E A R T H E F I L E . Reason

T h e $ M O N I T O R f i l e h a s r e a c h e d e n d o f e x t e n t ; t h e data collection program has ceased collecting system s t a t u s a n d i s w a i t i n g fo r t h e $ M o N l T o R f i l e t o b e c l e a r e d .

Recovery

P a g e o f G C 2 1 - 5 2 0 7 - 1 l s s u e d 2 6 S e p t e m b e r 198O B y T N L : G N 2 1 - 5 7 2 6

P E R M A N E N T D I S K E R R O R _ M O N I T O R S T O P P E D . R E C O R D D E S C R I P T I O N S P R E S S P F 4 T O S T A R T .

The data collection program writes one block of records

Reason (2048 bytes) every 16 seconds. Each block consists of

eight 256-byte records.

An error has occurred while writing to the

$MoNlroR file; the data collection program has There are two record types: Type 1 and rype 2. A type ceased collecting the system status. 1 record is written each time the pF4 key is pressed.

Type 2 records are written every two seconds until the PF6 key is pressed.

Recovery

In the record layouts, form reters to the format of the Press the PF4 key on the system console to resume field:

collecting the system status.

B i n B i n a r v C C P N O T A C T I V E - M O N I T O R S T O P P E D .

Alpha Alphanumeric

Reason

Hex Hexadecimar

C C P w a s s h u t d o w n w h i l e th e data collection

program was collecting CCP information. Dec _ Decimal

Recovery

An IPL is required to continue collecting system status.

Note: See Considerations for shutting down CCp while the data collection program is loaded.

Data Collection l -S

Type 1 Record

The type 1 recordconsists of configuration information.

From To Form

D e c B i n D e c H e x

H e x

Description

D i g i t l ( t y p e l r e c o r d )

T i m e in t i m e r u n i t s ( e a c h t i m e r u n i t is 3 . 3 3 m i l l i s e c o n d s )

S y s t e m d a t e (d d m m y y o r m m d d y y ) M a i n s t o r a g e s i z e :

Hex Value Meaning

80 512K

60 384K

4 0 2 5 6 K

38 224K

30 192K

2 8 1 6 0 K

20 128K

1 8 9 6 K

D i s k a n d ta p e d e v i c e s u p p o r t : 'l

2 B 1 4

1 7

I J

1 4

1 5

t 3

Hex Value

c0 8 0 3 8 3 0 2 8 0 7 06 0 5

Q4

D e v i c e s u p p o r t : Hex Value

80 40 20 1 0 0 8 o4 o 2

Meaning

3344s are supported 3 3 4 0 s a r e s u p p o r t e d

D 1 , D 2 , D 3 , D 4 a r e s u p p o r t e d D 1 , D 2 , D 3 a r e s u p p o r t e d D 1 , D 2 a r e s u p p o r t e d T 1 , T 2 , T 3 , T 4 a r e s u p p o r t e d T 1 , f 2, T3 are supported T 1 , T 2 a r e s u p p o r t e d T 1 i s s u p p o n e d H e x

1 6

t o

Meaning 5424 2 5 6 0 1 4 0 3 ' t 4 4 2 2501 3741 S e c o n d 1 4 0 3

From To Form Description 1 7 1 7 H e x S p o o l s t a t u s :

Hex Value Meaning

80 Spool is active

1 8 1 9 H e x A s s i g n / f r e e s i z e i n i n c r e m e n t s o f 5 1 2 b v t e s E x a m p l e : 0 0 0 1 = 5 l 2 b y t e s

0006 = 3072 bytes 2 0 2 3 B i n S i z e o f p a r t i t i o n 1 i n b y t e s 2 4 2 7 B i n S i z e o f p a r t i t i o n 2 i n b y t e s 2 8 3 1 B i n S i z e o f p a r t i t i o n 3 i n b y t e s 3 2 3 2 H e x C C p p a r t i t i o n l D

3 3 3 3 A l p h a C C p a s s i g n m e n t s e t lD

3 4 3 4 D e c N u m b e r o f b i s y n c h r o n o u s l i n e s 3 5 3 5 D e c N u m b e r o f a s v n c h r o n o u s l i n e s

3 6 3 6 D e c N u m b e r o f s e r i a l i n p u t / o u t p u t c h a n n e l s c o n t r o l l e d b y C C P

3 7 3 8 B i n N u m b e r o f C C p t e r m i n a l s

3 9 4 0 B i n S i z e o f m a i n s t o r a g e , i n b y t e s , s e t a s i d e f o r C C p T C B s ( t a s k s ) d u r i n g s y s t e m g e n e r a t i o n

4 1 4 2 H e x S i z e o f C C p u s e r p r o g r a m a r e a i n 2 K b l o c k s ( E x a m p l e : 0 0 0 1 = 2 K ; 0 0 1 0 = 3 2 K ) 4 3 4 6 B i n A l l o c a t e d s i z e o f C C p t e l e p r o c e s s i n g b u f f e r

( T P B U F F }

4 7 5 0 B i n S i z e o f i n p u t / o u t p u t a r e a o f C C p t e l e p r o c e s s i n g bu ffer

5 1 5 4 B i n S i z e o f i n p u t a r e a o f C C p t e l e p r o c e s s i n g b u f f e r 5 5 5 8 B i n S u p e r v i s o r s i z e ( e x c l u d i n g s p o o l ) , i n o y t e s 5 9 6 0 B i n M a x i m u m C C P c o m m a n d l e n g t h , i n b y t e s 6 1 6 2 B i n M a x i m u m C C p p r o g r a m r e q u e s t u n d e r f o r m a t

( P R U F ) l e n g t h , i n b y t e s 6 3 6 3 H e x D F F l i n e b u f f e r s u p p o r t

Hex Value Meaning

8 0 B S C li n e 1 D F F b u f f e r s u p p o r t e d 4 0 B S C li n e 2 D F F b u f f e r s u p p o r t e d 2 0 B S C l i n e 3 D F F b u f f e r s u p p o r t e d 1 0 B S C li n e 4 D F F b u f f e r s u p p o r t e d

64 256 Reserved

D a t a C o l l e c t i o n 1 - 7

Type 2 Record

The type 2 record contains a sample of the status of the system (a snapshot).

An asterisk (r) next to the form (for example, Bin*) indicates that the count is continuously being updated by the system programming support. The other data reflect conditions that are in effect during the instant of t h e s a m p l e .

From

To 1

2 I 1 4 1 6 t 8 20 22 24 26 28 30 3 2 34 36 40 44 48 50

1 7 1 3 l 5 1 7 l 9 2 1 23 25 2 7 29 3 1 33 3 5 39 43 4 7 49 50

Form Dec B i n

Dec Dec Dec Dec B i n *

B i n * B i n * B i n * Hex Hex

Description

D i g i t 2 ( t y p e 2 r e c o r d )

Time sample was taken in timer units (each timer unit i s 3 . 3 3 m i l l i s e c o n d s )

Reserved

Number of active CCP programs Number of queued CCP programs N u m b e r o f C C P p r o g r a m s i n t e r m i n a t i o n Number of CCP programs in allocation

Number of times the command processor has received data from a terminal since the previous sample N u m b e r o f p r o g r a m s p h y s i c a l l y l o a d e d s i n c e t h e

p r e v i o u s s a m p l e

Number of program requests attached to already active MRT programs since the previous sample Number of task chains accepted since the previous

s a m p l e

Total CCP user program area free (in 2K blocks) ( E x a m p l e : 0 0 0 1 = 2 K ; 0 0 0 4 = 2 0 K )

Largest CCP user program area free (in 2K blocks) ( E x a m p l e : 0 0 0 1 = 2 K ; 0008 = 1 6K )

Number of free areas in CCP user program area Size of total free input/output area in CCP

teleprocessin g buffer (TPB U F F )

Size of largest contiguous area in CCP teleprocessing buffer currently free for output

Size of largest contiguous area in CCP teleprocessing buffer currently free for input

Total number of free areas in CCP teleprocessing buffer

I n f o r m a t i o n f o r B S C l i n e 1 : B i t 0 = 1 - L i n e i s a c t i v e

= 0-Line is inactive

B i t 1 = 1 - C C P is c u r r e n t l y p o l l i n g t h i s li n e

= O-CCP is not currently p o l l i n g t h i s li n e Bit 2 = I -CCP is currently transmitting data on

t h i s li n e

B i t 7 = 1 - C C P is c u r r e n t l y u s i n g t h e D F F b u f f e r o n t h i s li n e

( E x a m p l e s o f p r e c e d i n g b i t c o m b i n a t i o n s : X ' C 0 ' - p o l l i n g ; X ' A 0 ' - t r a n s m i t t i n g d a t a ; X ' 8 0 ' - r e c e i v i n g d a t a ; X ' 0 0 ' - l i n e is in a c t i v e ) N u m b e r o f o u t p u t p a r a m e t e r l i s t s ( p u t operations)

w a i t i n g f o r t e l e p r o c e s s i n g b u f f e r o n B S C li n e 1 N u m b e r o f i n p u t p a r a m e t e r l i s t s ( i n v i t e o r g e t

o p e r a t i o n s ) w a i t i n g f o r t e l e p r o c e s s i n g b u f f e r o n B S C l i n e 1

N u m b e r o f p a r a m e t e r l i s t s w a i t i n g t o t r a n s m i t d a t a o n B S C l i n e 1 ( h a v e a l r e a d y o b t a i n e d T p b u f f e r ) B i n

B i n B i n B i n B i n Hex

B i n B i n

B i n

5 2

54

56 5 1

53

55

D a t a C o l l e c t i o n 1 - 9

From To Form Description

5 7 6 3 B i n I n f o r m a t i o n f o r B S C li n e 2 ( f o r a d e s c r i p t i o n , s e e 5 0 - 5 6 )

6 4 7 0 B i n l n f o r m a t i o n f o r B S C li n e 3 ( f o r a d e s c r i p t i o n , s e e 5 0 - 5 6 )

7 1 7 7 B i n I n f o r m a t i o n f o r B S C li n e 4 ( f o r a d e s c r i p t i o n , s e e 5 0 . 5 6 )

7 8 7 9 B i n * N u m b e r o f b l o c k s s e n t o n B S C li n e 1 s i n c e l a s t s a m p r e

8 0 8 1 B i n * N u m b e r o f b l o c k s r e c e i v e d o n B S C li n e 1 s i n c e la s t s a m o l e

8 2 8 5 B i n " N u m b e r o f b y t e s s e n t o n B S C li n e 1 s i n c e la s t s a m p l e 8 6 B g B i n * N u m b e r o f b y t e s r e c e i v e d o n B S C li n e 1 s i n c e la s t

s a m p l e

9 0 9 1 B i n * N u m b e r o f B S C e r r o r s ( n o t d e v i c e e r r o r s ) o n B S C l i n e 1 s i n c e l a s t s a m p l e

9 2 1 0 5 B i n I n f o r m a t i o n f o r B S C li n e 2 ( f o r a d e s c r i p t i o n , s e e 7 8 _ 9 1 )

1 0 6 1 1 9 B i n I n f o r m a t i o n f o r B S C li n e 3 ( f o r a d e s c r i p t i o n , s e e 7 8 _ 9 1 )

" l 2 O 1 3 3 B i n I n f o r m a t i o n f o r B S C li n e 4 ( f o r a d e s c r i p t i o n , s e e 7 8 9 1 )

1 3 4 | 3 5 B i n * N u m b e r o f s e e k s o n D l s i n c e l a s t s a m p r e 1 3 6 1 3 7 B i n * N u m b e r o f s e e k s o n D 2 s i n c e la s t s a m o l e 1 3 8 1 3 9 B i n * N u m b e r o f s e e k s o n D 3 s i n c e l a s t s a m p l e 1 4 0 1 4 1 B i n " N u m b e r o f s e e k s o n D 4 s i n c e la s t s a m o l e

1 4 2 1 4 5 B i n " N u m b e r o f c h a r a c t e r s r e a d / s c a n n e d o n D 1 s i n c e la s t s a m p l e

1 4 6 1 4 9 B i n " N u m b e r o f c h a r a c t e r s r e a d / s c a n n e d o n D 2 s i n c e la s t s a m p l e

1 5 0 1 5 3 B i n * N u m b e r o f c h a r a c t e r s r e a d / s c a n n e d o n D 3 s i n c e la s t s a m p r e

1 5 4 1 5 7 B i n * N u m b e r o f c h a r a c t e r s r e a d / s c a n n e d o n D 4 s i n c e la s t sam pr e

1 5 8 1 5 9 B i n N u m b e r o f l O B s ( o p e r a t i o n s ) i n D 1 q u e u e 1 6 0 1 6 1 B i n N u m b e r o f l O B s ( o p e r a t i o n s ) i n D 2 q u e u e 1 6 2 1 6 3 B i n N u m b e r o f l O B s ( o p e r a t i o n s ) i n D 3 q u e u e 1 6 4 1 6 5 B i n N u m b e r o f l O B s ( o p e r a t i o n s ) i n D 4 q u e u e 1 6 6 1 6 9 B i n * T o t a l s e c t o r c o n f l i c t s s i n c e la s t s a m p l e 1 7 0 1 7 1 B i n N u m b e r o f s e c t o r c o n f l i c t s c u r r e n t l v i n e f f e c t

1 - 1 0

From To Form Description ' 1 7 2

1 7 2 H e x B i t s i g n i f i c a n t i n f o r m a t i o n a s fo l l o w s :

B i t 0 = 1 D r i v e l i s b u s y e x e c u t i n g a s e e k 1 = 1 D r i v e 2 i s b u s y e x e c u t i n g a s e e k 2 = 1 D r i v e 3 i s b u s y e x e c u t i n g a s e e k 3 = 1 D r i v e 4 i s b u s y e x e c u t i n g a s e e k 4 = t

Il" 3340144 disk attachment rs ousv

5 = 1 P a r t i t i o n 1 i s i n u s e ( a p r o g r a m is l o a d e d )

6 = 1 P a r t i t i o n 2 i s i n u s e 7 = 1 P a r t i t i o n 3 i s i n u s e 1 7 3 1 7 3 H e x B i t s i g n i f i c a n t i n f o r m a t i o n a s f o l l o w s :

B i t 0 = 1 A t a s k i s d i s p a t c h a b l e 1 = 1 A w a i t f o r a s s i g n / f r e e a r e a n a s

occu rreo

2 = 1 I n p u t / o u t p u t q u e u e e l e m e n t ( I O O E ) t a b l e i s f u l l

3 = 1 T h e h i g h e s t p r i o r i t y d i s p a t c h a b l e t a s k w i l l e x e c u t e w i t h l - c v c l e s t r a n s l a t e o f f

1 7 4 1 7 4 A l p h a T h e l D o f t h e h i g h e s t p r i o r i t y d i s p a t c h a b l e t a s k 1 7 5 1 7 6 B i n D i s p l a y f o r m a t f a c i l i t y ( D F F ) t a s k q u e u e d e p t h ( n u m b e r o f p a r a m e t e r l i s t s o n D F F ' s q u e u e )

177 256 Reserved

D a t a C o l l e c t i o n 1 - 1 1

L O G I C I N F O R M A T I O N

This section describes the logic flow of the data collection program. The high level flow charts are i n t e n d e d t o b e u s e d w i t h t h e a s s e m b l y l i s t i n g s o f t h e p r o g r a m .

1 - 1 2

r 8 4 r - a

* r r * I|

I S I D R V V

I r r * r I 4 * i 1 r I t t a i t

+ *

* 5 E T D I S K A U S Y I

+ S T A T U S

t *

t !

r r * * r t * * I r l * * r * * t I I II

Ii

* * | * r c 4 * ; | | r * * r r I

r +

T C A L C U L A T f O € ' T H '

* o F 3 3 4 0 / 4 4 I D S *

. O U E U E S

* r * a + | * * r 1 r r * . 1 a a t

I

II II

* r + r * D 4 r ; r * r r . * * i . O E T E R X I N E I ' i I

* I O O E T A B L E F U L L ' a a r * r I t * * * t * r t r * +

Ij

II

A C T C 8 vI

r a r t t E 4 t l a l t * a l * r 1 D E I E F H I N E I F

* A W I A S K

r D I S P A T C N A B L E

* A N O 5 E T I T S ! O 1 r r r a a l * a * * r r * r r * +

I

I

II

I + t r 4 . F 4 r i t a r a l r 4 r r T I N E - S T A f P T C U R R E N T R E C O R O T

a a

t +

* a a * | + a * I t a a * * r * t

I

II

I

. ; .

G 4 a .

o s K S T S

a a q a i J 5 a t a t a a t a a a

. a

t s E T P A F T I T I O k r r c E T , o F S e E X S a

r A c r t v € s T A T U l i . - - - > a A N O C H A R S .

. . . R E A O / S C A N N E o .

t t

a a a 4 t a l r a a t a t * i t r i a l a a r a a t a a a a l t a t

II

I

I

II

C O N C H X V

I t a a a K 5 * * a a 1 * l a a a

a l

. G E t S E C T O e .

* C O N F L I C T I N F O t

a a

l r

r r t a * I I t * a a * a t a l *

| * + r r

t . *

- > 1 E 3 . r a t a

N O I R U N V

. . a a r B I r a r r 1 + r r * I A A L L O C A T E P F 4 , * t P F 5 r A N O P F 6 a

! K E Y S +

l r

a r a t 1 t * r r r a * a + l a a

II II

I I r a a a c I | * 1 * 1 t * r a l

* O P E N T X O N I I O R '

I F I L E

t *

r r a a * r l t a * * * r | + r r

tI

II

I

. * a * a o u i * * r a * a . a

. l

' C L 0 5 E l N O N I T O R '

. F I L E *

a *

a *

* I t r a * l * a + l t l a t * a

I

I

II I

a a a a a E I r a i * I r a a l t

a a

. s f , s E c o N o l o a i a F o R O O U S L E *

. E U F F E R I N G i

t a

r a a a a a a + I * a * i * a l a II

II

tI a a a a t r I a a a a a r a a a a

a a

. I U I L O T C ! I N ' . a 6 l t c N / f R E ! t

a A R I A .

l a

a l a a a t t a t a a t a a a a a

I

I

II I

a a t a a c l a a a a a l t a t a

a a

. c 6 A i C l P l t E c l i . . A t o t A X D A ? R a

a t

a a

a a t a a a a t a a a r a t a a a

I

I

II

I a a a a a x I a t t a a t a a a a

a a

a l l l P l I A F 7 0 a t l | o - o f - J O ! C A r L .

a a

a a

a a a a a a a a J a a a a a a a a II I

II

I a a a a t J I a t a a a a a a 4 a

a a

a P U T & l L t T c E a a t N r o l c E c x ^ t N . a l € L o t E R P T A S x a

a a

a a a a a a a a a a a a a t a a a

II

I

a a a i

a a

. a ? |

a a

a a t a

a a a t a F 2 l a a l a l l t a a

I t

t c E T c o N F l 6 t N F O + I F R 0 X 5 Y 5 C O {

a a

a a

t a a a a t a a a a a a l 4 t a * II

II II

r r a a a i z a : a a a a , | 4 |

t t

. s A v E c r , c 5 ,

. A N ) C P t C A .

. A D D R E S S E S '

a a

a a a a a a a t a t a + a a a a t

t II I

r l t F f c l

a t I t a i 2 a a a I t a a a a a

a a

* t A P A l R . s T O t + c c P c o r r o n .

. l a c c c o t t t

a a

a a a ) a a a a a a a a a t t t a

II

II

I a a t a t J 2 a a a a a a a t a a

a i

1 6 € T C C P C O T F I G .

a I N r o F R O | a

I a c c c o t .

r a

r a a a a a r a a a a + r a a t *

I

I a a l a

I r a

- > t E 3 a

a l

* . . a

. Y E S

II

II

I a r * r t 0 2 r l a a r r " * r *

* S E T O N O ! O G T I I N T E R L C C K

* a

a a r t * 1 a * a l t a t t I a *

II

II

I

* t r a . € e a ; a a | * r a r .

t *

* 0 I s P ! A Y { E S S A G E *

* { O N t T O R S I A R T E D *

a a

a i l a a I l l a a I t a i a r I

a a r a a H 4 * a a a r + a a t l T G E T O A T 0 0 2 E l . a - - - - - - - ' - - - - - t r c o L t E c T c c P I

r t N f o

r a a a + t t + a a a l a a t a t

II

I < - - - - I I

B I c I N F '

r a a a a J a r i t l t a a i a a

D a t a C o l l e c t i o n 1 - 1 3

+ F N T E K r r * * + * t * + * * * g * *

II

I I

G E T D A I VI

* * a r * B l * + + + * * * * + *

* 8

{ S A V E R € , ] I S T E R S + s * * * * * * t ; t * + * * * t * *

li

I

* * * + + C I+ n * * * * * * * * S C H A N G a l \ T R ' S T O *

* i A P t [ t C L p *

+ *

* + + + + t * * t * t * * l 1 r *

II

II

II

* * * r + D I r ; * + r * * r * +

* D E T t R B I fr E D E P T H *

* O F O F F Q U E U E *

* * * 4 4 3 * * * * * 8 * * *

+ *

+ E N I E R +

t !

1 i * r * * + + * * * * * 4 t

| | * * * E 3 * * * + * * * * + *

t t

* N A I T F O R *

* P R € V I O U S B U F F E R * a | * * * * * * a * * * * * * I t

I

I I

II

* t t + * F 3 t * * * * * t * * t

+ *

' I R I T E T H I S '

* B U F F E R t

* l

* * t * | i | | 1 * t * t t * t t

II

I

I

II

I II

D M vI

* * * * * B 3 r * * * r r r * * *

* S A V E R E G I S T E R S +

t t

* * + * * * t * * * * * t * * * 4

I

I II

I

* * r * * c l + * 1 * * * r * + tV I P U I L O G I C A L T R E C C R D I N T O I

* P H Y S I C A L E U F F E R +

* G E T T R A N S A C T I O N *

* I N F O F R O I C P I

. t

* * * a * | * * t t t * * t * * *

I

II I r r r * * F l * * * * + * * a * * ' C O U N T I P R O G S * T A C T I V E , Q U E U E D , *

* A L L O C A T E D , *

* T E R M I N A T E D +

* + + + * * * * * t * + * t * a *

II

II I

* * * r * G 1 * * r r * * * r * r

* *

* C A L C U L A I E U P A *

+ l \ F l l r

I t

* t

* * * 4 + * + * + g * t * t * t * II

I

II

* * * t r H I * a * * * * r * * + I C A L C U L A I E T P *

* E U F F E R I N F O *

* t

* * * * * * a * | r * t t * * * * I I

II

I s * * r * J I * i r + * r t t * * I C O L L E C T 6 I 5 Y N C T

* L I N € A C ' I I V I T Y '

* I N F T I

* t

* * l * + * * * * t * * * * * + | II

I

II r + * * + K I | * r * * * i * t a

i

+ R E S T 0 R E A T R r S r - - - _ - - - - > r

* * *

+ t * * * * * * * t * + + * + + *

* * * r r G 3 r * * * * * * * + +

* E X C H A N G E I O S I S

* r t * K 2 t t t t * * * t * R E T U R N

1 - 1 4

P A R T 2 : D A T A R E D U C T I O N

P U R P O S E A N D D E S C R I P T I O N

T h e d a t a r e d u c t i o n p r o g r a m , SMFSUM, reads the records written by the data collection program; reduces t h e i n f o r m a t i o n to a v e r a g e and maximum values; and presents the results for interpretation. The program is wfltten in RpG ll and runs in a batch partition. With this facility, you can obtain information about your sysrem with the intention of determining where contenttons tn resource utilization exist. you can then make

adjustments in your application design and/or sysrem resource allocations to attempt to reduce those contenttons.

SMFSUM processes the type 1 and type 2 recoros created by the data collection program. For a description of these records, see Record Descriptions.

S M F S U M r e a d s t h e t y p e 1 r e c o r d s and all following type 2 records; calculates average and maximum for the interval; and prints the results. lt will continue rn this m a n n e r ( s u m m a r i z i n g e a c h i n t e r v a l ) u n t i l a l l r e c o r d s i n t h e $ M O N I T O R f i l e h a v e b e e n read.

The data reduction program may be executed concurrently with the data collection program, and its output may be spooleo.

A l l s a m p l e s w i l l b e c o n s i d e r e d up to and including the last sample written to the file by the data collection program. The end of the interval is detected by (1) another type 1 record, (2) a blank record in the file. or ( 3 ) a r e c o r d c o n t a i n i n g all 9s (hex F9).

Part 2: Data Reduction

lnstallation

Use the following OCL and control statements for the library maintenance program ($MAINT) to copy the data reduction program to an object library.

/ / L O A D $ M A l N T . u n i t l / / R U N

/ / C O P Y F R O M - R E A D E R . T O - u n i t 2 , L t B R A R Y - O . N A M E - S M F S U M , R E T A I N - P

/ / E N D w h e r e :

u n i t l i s t h e u n i t t h a t c o n t a i n s t h e $MAINT program.

unit2 is any simulation area that contains an object library.

Operation

The data reduction program may be loaded in anv batch partation using the following OCL:

/ / L O A D S M F S U M , u n i t l

/ / F I L E N A M E - $ M O N I T O R , U N I T - u n i t 2 . P A C K - p a c k n a m e , S H A R E - N O / / R U N

w h e r e :

unitl is the simulation area that contains the data r e d u c t i o n p r o g r a m ( S M F S U M ) .

unit2 is the main data area that contains the

$MONITOR file created by the data collectron program.

packname is any valid System/3 pack name.

This program will read the $MONITOR file and produce a pnnted report. For a description of the repon. see Description of Output.

Oata Reduction 2-1

Main Storage Requirements P A R T I T I O N 1 S I Z E

] T h e d a t a r e d u c t i o n p r o g r a m { S M F S U M ) r e q u i r e s a 2 2 K T h e s i z e , i n b y t e 5 . o f p a r t i t i o n 1 a t t h e s t a r t o f t n r s

batch partltion rnterval. lf the partition size is changed during the

i n t e r v a l , th e c h a n g e w i l l n o t b e r e f l e c t e d in t h i s n u m b e r .

D E S C R I P T I O N O F O U ' T P U T

P A R T I T I O N 2 S I Z E The data reduction program produces a tvvo-page report

for each measured interval. An interval consists of the The size, in bytes, of partition 2 at the start of thrs data samfrled between type 1 records In the $MONIfOR interval. lf the partition size is changed durrng the file. An interval contains the data gathered between interval, the change will not be reflected in this

pressing the PF4 key and pressing the PF6 key. number

The first page of the report is system configuration PARTITION 3 SIZE

information; the second page is a summary of the

sample information gathered during the interval. (See The size, in bytes, of partition 3 at the start of thrs F i g r - r r e s 1 a n d l l u n d e r E r a m p l e s . ) i n t e r v a l . l f t h e p a r t i t i o n s i z e i s c h a n g e d d u r i n g t h e

r n t e r v a l , t h e c h a n g e w i l l n o t b e r e f l e c t e d i n t h i s An asterisk (*) incjicates that the count is hreing updated number

continuously by the system prooramming support. The

o t h e r d a t a r e f l e c t s c o n d i t i o n s t h a t a r e i n e f f e c t d u r i n q D E V T C E S U p p o R T the instant of the sarnole.

A device that is supported bV the svstem is indicated b y t h e c h a r a c t e r Y . A d e v i c e t h a t i s n o t s u p p o r t e d i s

System Configuration Infnrmation indicated bv the character N.

D A T T S P O O T A C T I V E

The date of the rnterval. The character y indicates that spool is active; the

c h a r a c t e r N i n d i c a t e s th a t s p o o l i s n o t a c t i v e . M A I N S T O R A G E S I Z E K _

T h e f o l l o w i n g c o n f i g u r a t i o n in f o r m a t i o n i s p r i n t e d o n l y i f T h e m a i n s t o r a g e s i z e o f t h e s y s t e n l s p e c i f i e d i n K C C p w a s a c t i v e a t t h e b e g i n n i n g o f t h e m e a s u r e d

b y t e s ( K e q u a l s 1 0 2 4 ) . I n r e r v a t :

S U P E R V I S O R S I Z E C C P P A R T I T I O N I D

T h e s i z e , i n b y t e s , o f t h e s y s t e m s u p e r v r s o r . T h i s s i z e T h e p a r t i t i o n l D i n w h i c h C C p w a s e x e c u t i n o . d o e s n o t i n c l u d e s p o o l s u p p o r t r o u t t n e s , tr a n s a c t i o n

l o g g i n g , t r a c e , o r f i l e s h a r e a r e a . A S S I G N M E N T S E T l D

A S S I G N / F R E E A R E A S I Z E T h e a c t i v e C C p a s s i o n m e n t s e t t D . T h e s i z e , i n b y t e s , o f t h e a s s i g n / f r e e s t o r a g e p o o l . C C p P A R T I T I O N S I Z E

T h i s a r e a o f m a i n s t o r a g e r e s i d e s i n , a n d i s i n c l u d e r j

i n , t h e s u p e r v i s o r s i z e . l t i s u s e d a s a w o r k i n g T h e s i z e , i n b v t e s . o f t h e C C p p a r t i t i o n . Storage area by programs and system tasks on an

a s - n e e d e d b a s i s . U S E R P R O G R A M A R E A S I Z E _ K -

l h e s i z e o f t h e C C P u s e r p r o g r a m a r e a , in K ( 1 0 2 4 ) bytes.

2-2

T P B U F F E R S I Z E

The size, in bytes, of the CCp teleprocessing buffer.

T P B U F F E R I / O A R E A S I Z E

The size, in bytes, of the area of the teleprocessing b u f f e r th a t i s a v a i l a b l e f o r i n p u t ( i n v i t e o r 9et) and output (put) operations.

T P B U F F E R I N P U T A R E A S I Z E

The size, in bytes, of the area of the teleprocessing b u f f e r th a t i s a v a i l a b l e f o r i n p u t ( i n v i t e o r g e t ) operations.

N U M B E R O F B I S Y N C L I N E S

T h e n u m b e r o f b i n a r y s y n c h r o n o u s c o m m u n i c a t i o n s l i n e s s u p p o r t e d b y t h e c u r r e n t C C p a s s i g n m e n t s e t . N U M B E R O F A S Y N C L I N E S

T h e n u m b e r o f a s y n c h r o n o u s c o m m u n i c a t i o n s l i n e s supported by the current CCP assignment set.

C H A N N E L C O N N E C T - C C P

The letter Y indicates that the current CCp

assignment set supports channel connected svstems N U M B E R O F T E R M I N A L S

The number of terminals (and ports, if

channel-connected) supported by the current CCp assignment set.

N U M B E R O F C C P T A S K S S U P P O R T E D T h e m a x i m u m n u m b e r o f c o n c u r r e n t C C p u s e r programs supported by the current supervisor.

M A X P R U F L E N G T H

T h e m a x i m u m p r o g r a m r e a d u n d e r fo r m a t ( p R U F ) l e n g t h s u p p o r t e d b y t h e c u r r e n t C C p a s s i g n m e n t s e t . M A X C O M M A N D L E N G T H

T h e m a x i m u m c o m m a n d le n g t h s u p p o r t b y t h e c u r r e n t C C P a s s i g n m e n t s e t .

B S C L I N E 1 D F F B U F F E R B S C L I N E 2 D F F B U F F E R B S C L I N E 3 D F F B U F F E R B S C L I N E 4 D F F B U F F E R

The letter Y indicates that the current CCP

a s s i g n m e n t s e t s u p p o r t s i n d i v i d u a l D F F l i n e b u f f e r s .

Summary of Sample lnformation

The sample information collected for the measureo interval is reduced to average and maximum values for interpretation by the user. Following is a description of each field. (See Figures 2 and 4 under Examples.)

C P U

The activity within the partitions of the system rs presented under four headings (five if spool is active).

The figure under each heading is a fraction of the total partition time consumed by that task. The total partition t i m e i s 1 . 0 0 0 . T h e f o u r h e a d i n o s a r e :

WAITING-lndicates that no tasks were prepared to execute for this fraction of the total time, or that the system was executing cycle steals.

P1-The fraction of the total time that oartition 1 was executing.

P2-The fraction of the total time that oartition 2 was e x e c u t i n g .

P3-The fraction of the total time that partition 3 was executing.

P 1 , P 2 , o r P 3 w i l l b e r e p l a c e d b y t h e h e a d i n g C C P i f CCP was active in that partition at the start of the i n t e r v a l b e i n g m e a s u r e d . A f i f t h h e a d i n g , S P O O L , w i l l b e printed if spool was active during the interval being measured-indicating the fraction of the total time that s p o o l w a s e x e c u t i n g .

D a t a R e d u c t i o n 2 - 3