Chapter 11 - Standard Reports

GPSS World provides for extensive statistics reporting that often gets you the results you need with no additional effort. The final states of all traditional GPSS Entities are reported in a Standard Report that is created automatically when each simulation terminates.

If you have additional reporting needs, you should consult the discussion of Data Streams in Chapter 4.

    11.1. Report Management

Normally, GPSS World creates a detailed Standard Report of each simulation. Each Report Object is automatically created unless you specify NP as operand B of the START Command. You can also suppress the creation of Standard Reports using Settings. To do so, be sure Create Standard Reports is not checked in the Report page of the Model Settings Notebook.

The REPORT and START Commands are discussed in Chapter 6.

        11.1.1. Report Windows

\You can cause a Report Object to be opened for each newly created Standard Report. To do so, check Create Standard Reports and In Windows in the Report page of the Model Settings Notebook.

        11.1.2. Controlling Report Contents

You can select the contents of a modelís Standard Reports using a set of checkboxes in the Report page of the Model Settings Notebook. This is opened when you select Edit / Settings from the Main Menu. This is discussed in Chapter 2.

Report Windows have full text editing, font, color, and printing capabilities. This is discussed in Chapter 2, under the section entitled, Text Windows.

 

    11.2. Sample Report

        11.2.1. Model

The Model File that follows was used to generate the sample report output in the next section. When this Model File, named SAMPLE9.GPS, is Translated and run, it produces the automatic report named SAMPLE9.001. The modelís only purpose is to display all the various graphics and text windows in the Tutorial Manual in Chapter 1, Lesson 11 and to demonstrate the layout of the report and meanings of the various parts of the report in this chapter.

; GPSS World Sample File - SAMPLE9.GPS Model to demo graphics windows
Pool STORAGE 400 ;Define Storage
Matrix1 MATRIX ,5,5 ;Define Matrix
Transit TABLE M1,200,200,20 ;Transit time in wait ; and process

        GENERATE  (Exponential(1,0,100)) 
        JOIN      Maingrp       ;Xact joins grp called ; Maingrp
        JOIN      Numgrp,9999   ;Add 9999 to Numeric
        SAVEVALUE Addup+,1      ;Total of Transactions
        ASSIGN    Param_1,232   ;Assign Xact parameter
        JOIN      Numgrp,P$Param_1 ;Put value in Param1
        LOGIC S   Switch_1      ;Turn on a logic switch 
        MSAVEVALUE Matrix1,2,2,QA$Tot_Process 
        QUEUE     Tot_Process   ;Queue for process time 
        SEIZE     Facility1     ;Own first Facility
        LINK      Chain1,FIFO,Nxtblk ;Put on Userchain if busy
Nxtblk  SEIZE     Facility2     ;Own a second Facility
        SEIZE     Facility3     ;Own a third Facility
        QUEUE     Process_Time  ;Keep track of process
        ADVANCE   100,(Exponential(1,0,100)) 
        DEPART Process_Time ;Record length
        TABULATE  Transit       ;Add wait + process
        RELEASE   Facility1     ;Give up 1st Facility
        ADVANCE   20            ;Delay time for Fac 2&3
        RELEASE   Facility2     ;Give up 2nd Facility
        ADVANCE   10            ;Extra delay time-Fac 3 
   
          RELEASE   Facility3     ;Give up 3rd Facility
        DEPART    Tot_Process   ;Leave Queue
        UNLINK    Chain1,Nxtblk ;Take off waiting Xacts 
        ENTER     Pool,100      ;Place 100 units in the Storage
        LOGIC R   Switch_1      ;Turn off logic switch 
        LEAVE     Pool,50       ;Take 50 units from Storage
        SAVEVALUE Collect-,1    ;Show negative Savevalue
        REMOVE    Maingrp       ;Remove Xact from group
        ADVANCE   50,1          ;Wait 50(+/-1) time units
        LEAVE     Pool,50       ;Take 50 units from Storage
Finis   TERMINATE 1             ;Destroy Xact

 

        11.2.2. Report

This section contains a standard report generated by the program listed in Section 11.2.1. Each item is explained individually in Section 11.3.

Letís now examine the items included in a standard GPSS World Report. This section includes the complete report resulting from the simulation in Section 11.2.1. The individual items are considered separately in Section 11.3.

 

GPSS World Simulation Report - SAMPLE9.1.1
Tuesday June 6, 2000 14:00:59

START TIME     END TIME     BLOCKS     FACILITIES     STORAGES
    0.000      5187.692       32            3            1


          NAME             VALUE
        ADDUP            10007.000
        CHAIN1           10012.000
        COLLECT          10017.000
        FACILITY1        10011.000
        FACILITY2        10014.000
        FACILITY3        10015.000
        FINIS               32.000
        MAINGRP          10005.000
        MATRIX1          10003.000
        NUMGRP           10006.000
        NXTBLK              12.000
        PARAM_1          10008.000
        POOL             10002.000
        PROCESS_TIME     10016.000
        SWITCH_1         10009.000
        TOT_PROCESS      10010.000
        TRANSIT          10004.000

LABEL LOC   BLOCK TYPE   ENTRY COUNT   CURRENT COUNT   RETRY
        1    GENERATE         61              1          0
        2    JOIN             60              0          0
        3    JOIN             60              0          0
        4    SAVEVALUE        60              0          0
        5    ASSIGN           60              0          0
        6    JOIN             60              0          0
        7    LOGIC            60              0          0
        8    MSAVEVALUE       60              0          0
        9    QUEUE            60              9          0
       10    SEIZE            51              0          0
       11    LINK             51              0          0
NXTBLK 12    SEIZE            51              0          0
       13    SEIZE            51              0          0
       14    QUEUE            51              0          0
       15    ADVANCE          51              1          0
       16    DEPART           50              0          0
       17    TABULATE         50              0          0
       18    RELEASE          50              0          0
       19    ADVANCE          50              0          0
       20    RELEASE          50              0          0
       21    ADVANCE          50              0          0
       22    RELEASE          50              0          0
       23    DEPART           50              0          0
       24    UNLINK           50              0          0
       25    ENTER            50              0          0
       26    LOGIC            50              0          0
       27    LEAVE            50              0          0
       28    SAVEVALUE        50              0          0
       29    REMOVE           50              0          0
       30    ADVANCE          50              0          0
       31    LEAVE            50              0          0
FINIS  32    TERMINATE        50              0          0


FACILITY ENTRIES UTIL. AVE. TIME AVAIL. OWNER PEND INTER RETRY DELAY
FACILITY1   51  0.937    95.278    1      51    0    0     0     9
FACILITY2   51  0.853    86.719    1      51    0    0     0     0
FACILITY3   51  0.949    96.523    1      51    0    0     0     0


     QUEUE MAX CONT. ENTRY ENTRY(0) AVE.CONT. AVE.TIME AVE.(-0) RETRY
TOT_PROCESS 11  10     60    0        6.439    556.700 556.700    0
PROCESS_TIME 1   1     51    0        0.660     67.112  67.112    0


STORAGE CAP. REM. MIN. MAX. ENTRIES AVL. AVE.C. UTIL. RETRY DELAY
POOL    400  400    0  150    5000   1   23.628 0.059   0     0


TABLE         MEAN      STD.DEV.   RANGE    RETRY    FREQUENCY CUM.%
TRANSIT      553.184     307.992 
   
                                                                0- 200.000   8      16.00
                            200.000 - 400.000  10      36.00
                            400.000 - 600.000   7      50.00
                            600.000 - 800.000  12      74.00
                            800.000 - 1000.000 11      96.00
                            1000.000 - 1200.000 2     100.00


USER CHAIN      SIZE    RETRY    AVE.CONT   ENTRIES MAX AVE.TIME
CHAIN1            0       0       0.277         48   1   29.927


XACT GROUP      GROUP    SIZE      RETRY
                MAINGRP   10         0


NUMERIC GROUP    GROUP    SIZE     RETRY
                NUMGRP      2        0

LOGICSWITCH VALUE RETRY
SWITCH_1       1     0


SAVEVALUE RETRY VALUE
ADDUP        0  60.000
COLLECT      0 -50.000


MATRIX RETRY INDICES NUMERIC VALUE
MATRIX1 0
            Intermediate Values are Zero.
                (2,2)     6.413
            Intermediate Values are Zero.


CEC XN PRI    M1   ASSEM CURRENT NEXT PARAMETER VALUE
    61  0 5187.692   61     1      2


FEC XN PRI BDT     ASSEM CURRENT NEXT PARAMETER VALUE
    51  0 5389.554   51    15     16
                                  PARAM_1 232.000
    62  0 5523.253   62     0      1

This section explains the items in the standard GPSS World report.

 

Title

GPSS World Simulation Report - SAMPLE9.1.1
Tuesday June 6, 2000 14:00:59

The title line of the standard report is taken from the name of the Model File that produced the report. The Date and Time of the running of the model is also included.

General Information

START TIME     END TIME     BLOCKS     FACILITIES  STORAGES
    0.000      5187.692       32            3         1

 START TIME. The absolute system clock at the beginning of the measurement period. Utilizations and space-time products are based on the START TIME. The START TIME is set equal to the absolute system clock by a RESET or CLEAR statement.

 END TIME. The absolute clock time that the termination count became 0.

 BLOCKS. The number of Block entities in the simulation at the end of the simulation.

 FACILITIES. The number of Facility entities in the simulation at the end of the simulation.

 STORAGES. The number of Storage entities in the simulation at the end of the simulation.

Names

      NAME             VALUE
        ADDUP            10007.000
        CHAIN1           10012.000
        COLLECT          10017.000
        FACILITY1        10011.000

 NAME. User assigned names used in your GPSS World model since the last Translation.

 VALUE. The numeric value assigned to the name. System assigned numbers start at 10000.

Blocks

LABEL LOC   BLOCK TYPE   ENTRY COUNT   CURRENT COUNT   RETRY
        1    GENERATE         61              1          0
        2    JOIN             60              0          0
        3    JOIN             60              0          0
        4    SAVEVALUE        60              0          0
        5    ASSIGN           60              0          0

 LABEL. Alphanumeric name of this Block if given one.

 LOC. Numerical position of this Block in the model. "Location".

 BLOCK TYPE. The GPSS Block name.

ENTRY COUNT. The number of Transactions to enter this Block since the last RESET or CLEAR statement or since the last Translation.

 CURRENT COUNT. The number of Transactions in this Block at the end of the simulation.

 RETRY. The number of Transactions waiting for a specific condition depending on the state of this Block entity.

 

Facilities


FACILITY ENTRIES UTIL. AVE. TIME AVAIL. OWNER PEND INTER RETRY DELAY
FACILITY1   51  0.937    95.278    1      51    0    0     0     9
FACILITY2   51  0.853    86.719    1      51    0    0     0     0
FACILITY3   51  0.949    96.523    1      51    0    0     0     0

 FACILITY. Name or number of the Facility entity.

 ENTRIES. The number of times the Facility was seized or preempted since last RESET or CLEAR command or since the last Translation of the model.

 UTIL. The fraction of simulated time in the last measurement period that the Facility was owned. A measurement period begins with the Translation of a model or the issuing of a RESET or CLEAR command.

 AVE. TIME. The average time of ownership by individual Transactions during the measurement period. A measurement period begins with a Translation of the model, or when a RESET or CLEAR command is issued.

 AVAIL. The availability state of the Facility entity at the end of the simulation. 1 means available, 0 means unavailable.

 OWNER. The number of the Transaction which owns the Facility entity. 0 means the Facility is not owned.

 PEND. The number of Transactions waiting to preempt this Facility by entering "Interrupt Mode" PREEMPT blocks.

 INTER. The number of Transactions currently preempted at this Facility. The count of Transactions on the interrupt chain.

 RETRY. The number of Transactions waiting for a specific condition depending on the state of this Facility entity.

 DELAY. The number of Transactions waiting to SEIZE the Facility. This chain also contains Transactions waiting to preempt the Facility in "Priority Mode" PREEMPT blocks.

Queues

     QUEUE MAX CONT. ENTRY ENTRY(0) AVE.CONT. AVE.TIME AVE.(-0) RETRY
TOT_PROCESS 11  10     60    0        6.439    556.700 556.700    0
PROCESS_TIME 1   1     51    0        0.660     67.112  67.112    0

 

 QUEUE. Name or number of the Queue entity.

 MAX. The maximum content of the Queue entity during the measurement period. A measurement period begins with the Translation of a model or the issuing of a RESET or CLEAR command.

 CONT. The current content of the Queue entity at the end of the simulation period.

 ENTRY. Entry count. The total count of Queue entries during the measurement period.

 ENTRY(0). "Zero entry" count. The total count of Queue entries with a 0 residence time.

 AVE.CONT. The time weighted average of the Queue entity content during the measurement period. The space-time product divided by the time duration of the measurement period.

 AVE.TIME. The average time per unit of Queue content utilized during the measurement period. The space-time product divided by the total entry count.

 AVE.(-0). The average time per unit of Queue content utilized during the measurement period, adjusted for "zero entries". The space-time product divided by (the total entry count less the zero entry count).

 RETRY. The number of Transactions waiting for a specific condition depending on the state of this Queue entity.

Storages

STORAGE CAP. REM. MIN. MAX. ENTRIES AVL. AVE.C. UTIL. RETRY DELAY
POOL    400  400    0  150    5000   1   23.628 0.059   0     0

 STORAGE. Name or number of the Storage entity.

 CAP. The Storage capacity of the Storage entity defined in the STORAGE statement.

 REM. The number of unused Storage units at the end of the simulation.

 MIN. The minimum number of Storage units in use during the measurement period. A measurement period begins with the Translation of a model or the issuing of a RESET or CLEAR command.

 MAX. The maximum number of Storage units in use during the measurement period.

 ENTRIES. The number of "entries" into the Storage entity during the measurement period. The total accumulation of operand B of ENTER statements.

 AVL. The availability state of the Storage entity at the end of the simulation. 1 means available, 0 means unavailable.

 AVE.C. The time weighted average of the Storage content during the measurement period. The space-time product divided by the time duration of the measurement period.

 UTIL. The fraction of the total space-time product of the Storage entity utilized during the measurement period.

 RETRY. The number of Transactions waiting for a specific condition depending on the state of this Storage entity.

 DELAY. The number of Transactions waiting to enter ENTER blocks on behalf of this Storage entity.

Tables and Qtables

TABLE         MEAN      STD.DEV.   RANGE    RETRY    FREQUENCY CUM.%
TRANSIT      553.184     307.992 
   
                                                                0 - 200.000   8      16.00
                            200.000 - 400.000  10      36.00
                            400.000 - 600.000   7      50.00
                            600.000 - 800.000  12      74.00
                            800.000 - 1000.000 11      96.00
                            1000.000 - 1200.000 2     100.00

 TABLE. Name or number of the Table or Qtable entity.

 MEAN. The weighted arithmetic average of tabulated values.

 STD.DEV. The weighted sample standard deviation of tabulated values.

S.D.= SQR( (SOS/(COUNT-1)) - (SUM2/(COUNT)(COUNT-1)) )

Where SOS is the accumulated sum-of-squares.

 RANGE. The lower and upper limits of the frequency class being reported. Values of the Table argument which are greater than the lower limit and less than or equal to the upper limit cause this frequency class to be updated. The B operand of the TABULATE statement can be used to provide a weighting factor. Frequency classes with accumulations of 0 are not reported.

 RETRY. The number of Transactions waiting for a specific condition depending on the state of this Table entity.

 FREQUENCY. The total weighted count of tabulated items to fall within this range. The total of all TABULATE B operands.

 CUM.% The cumulative frequency count expressed as percent of total count.

Userchains

USER CHAIN      SIZE    RETRY    AVE.CONT   ENTRIES MAX AVE.TIME
CHAIN1            0       0       0.277         48   1   29.927

 USER CHAIN. Name or number of the Userchain entity.

 SIZE. The number of Transactions on the User Chain at the end of the measurement period.

 RETRY. The number of Transactions waiting for a specific condition depending on the state of this Userchain entity.

∑ AVE.CONT. The time weighted average of the User Chain occupancy count during the measurement period. The space-time product divided by the time duration of the measurement period.

 ENTRIES. The total number of Transactions placed on the User Chain during the measurement period.

 MAX. The maximum number of Transactions on the User Chain during the measurement period.

 AVE.TIME. The average time per Transaction on the User Chain during the measurement period. The space-time product divided by the total entry count.

Transaction Groups

XACT GROUP      GROUP    SIZE      RETRY
                MAINGRP   10         0

 XACT GROUP. Name or number of the Transaction Group entity.

 GROUP SIZE. The number of Transactions which are members of the group at the end of the simulation.

 RETRY. The number of Transactions waiting for a specific condition depending on the state of this Transaction Group entity.

Numeric Groups

NUMERIC GROUP    GROUP    SIZE     RETRY
                NUMGRP      2        0

 NUMERIC GROUP. Name or number of the Numeric Group entity.

 GROUP SIZE. The number of numeric values which are members of the group at the end of the simulation.

 RETRY. The number of Transactions waiting for a specific condition depending on the state of this Numeric Group entity.

Logicswitches

LOGICSWITCH VALUE RETRY
SWITCH_1       1     0


 LOGICSWITCH. Name or number of the Logicswitch entity.

 VALUE. The value of the Logicswitch entity at the end of the simulation. 1 denotes "set" or "true", 0 denotes "reset" or "false".

 RETRY. The number of Transactions waiting for a specific condition depending on the state of this Logicswitch entity.

Savevalues

SAVEVALUE RETRY VALUE
ADDUP        0  60.000
COLLECT      0 -50.000

 SAVEVALUE. Name or number of the Savevalue entity.

 VALUE. The value of the Savevalue entity at the end of the simulation.

 RETRY. The number of Transactions waiting for a specific condition depending on the state of this Savevalue entity.

Matrix Entities

MATRIX RETRY INDICES NUMERIC VALUE
MATRIX1 0
            Intermediate Values are Zero.
                (2,2)     6.413
            Intermediate Values are Zero.

 MATRIX. Name or number of the Matrix entity.

 RETRY. The number of Transactions waiting for a specific condition depending on the state of this Matrix entity.

 INDICES. Up to 6 integers that specify the element of the Matrix.

 VALUE. The value of this Matrix entity element at the end of the simulation. Elements with 0 values are reported in groups.

The Current Events Chain

CEC XN PRI    M1   ASSEM CURRENT NEXT PARAMETER VALUE
    61  0 5187.692   61     1      2


 XN. Transaction number of each Transaction on the Current Events Chain

 PRI. Scheduling priority of the Transaction.

 M1. Mark time. The time the Transaction, or its earliest ancestor, was GENERATEd, or the time the Transaction entered a MARK Block with no operands.

 ASSEM. The Assembly Set number of the Transaction.

 CURRENT. The number of the Block where the Transaction existed at the end of the simulation or at the time of this report.

 NEXT. The number of the next Block scheduled to be entered by the Transaction.

 PARAMETER. The names or numbers of parameters of the Transaction.

 VALUE. The value of the parameter.

The Future Events Chain

FEC XN PRI BDT     ASSEM CURRENT NEXT PARAMETER VALUE
    51  0 5389.554   51    15     16
                                  PARAM_1 232.000
    62  0 5523.253   62     0      1

 XN. Transaction number of each Transaction on the Future Events Chain.

 PRI. Scheduling priority of the Transaction.

 BDT. Block departure time. The time of the absolute system clock when the Transaction is scheduled to leave the Future Events Chain.

 ASSEM. The Assembly Set number of the Transaction.

 CURRENT. The number of the Block where the Transaction existed at the end of the simulation or at the time of this report.

 NEXT. The number of the next Block scheduled to be entered by the Transaction.

 PARAMETER. The names or numbers of parameters of the Transaction.

 VALUE. The value of the parameter.

 

[Table of Contents]