D04.18. FMS Printing Parameter SHOW

FMS Printing Parameter SHOW

Data Type

Character string

Default Value

None. This is an input parameter only.

DESCRIPTION:

This directive may be used to obtain various reports on the current status of FMS. You may place calls of the form

CALL FMSCST ('SHOW','PAREMETER')

in your application or enter

FMSSET>SHOW='PARAMETER'

at the FMSSET prompt.

The available values for 'PARAMETER' and the reports they produce are:

'PARAMETERS'
This report lists the current value of all FMS Parameters.
The following is an example or the report produced:

 FMS PARAMETERS:
 Hardware Parameters:
 (MAXCPU=         1) (ISYNC =         0) (MAXMD =   1048576) (MDUSED=     57344)
 Data Formatting and Output Parameters:
 (LUINPT=         5) (LUPR  =         6) (LUDBUG=         0) (LOGTIM=         1)
 (IPRI  =         2) (IPRA  =         2) (IPRF  =         2) (IPRS  =         2)
 (IPRMV =         2) (IPRVV =         2) (IPRDV =         2) (IPRSEM=         0)
 (NEQPR1=         1) (NEQPR2=2147483647) (NROWPG=        50) (NCOLPG=        80)
 (IFMAT =  (I7)    ) (RFMAT =  (E12.4) ) (CFMAT =      (E12.4,1H,,E11.4)       )
 Matrix File Initialization:
 (MFMAT =         0) (NEQBLK=         0) (INSIDE=         0) (IJSTEP=         0)
 (LENSDF=         0) (NEQBIO=         0)
 Matrix Assembly Parameters:
 (LOWASM=         1) (MDATAU=         1) (LUOK  =         0)
 Matrix Factoring Parameters:            (MPOSDF=         0) (MZERO =         0)
 (NBITSZ=        39) (NBITSP=        26) (NUMSCG=         0) (NEQSUB=2147483647)
 (NPIVOT=         0) (IALGOR=         0)
 (IPOLLD=         0) (MINDIM=        32)
 (RPIVOT=         0.000000000000000E+00) (PIVMIN=         0.000000000000000E+00)
 (CONINV=         0.833333333333333E-03) (ATERMS=         0.950500000000000E+05)
 (AZEROS=         0.000000000000000E+00) (FZEROS=         0.000000000000000E+00)
 Solving Parameters:                     (LOWRHS=         1) (IPBACK=         0)
 File Parameters:
 (INCORE=         0) (IEXIST=         0) (IFKEEP=         0) (IOSYNC=         0)
 (LBUFSI=      8192) (LBUFSR=     16384) (LBUFSV=      8192) (IORAW =         0)
 (NUMIOQ=         1) (NUMSTP=         1) (NUMVOL=         1) (MBYTES=         0)
 Error Handling Parameters:              (LUERR =         0) (IPRERR=         3)
 (IERROR=         0) (NERROR=         0) (IOSTAT=         0)

'MODIFIED'
This report lists the value of all FMS Parameters which have been modified from their default values.
NOTE: Setting a FMS Parameter in the license file alters it's default value. Therefore parameters modified by placing commands in the license file will not appear with this option.
The following is an example of the report produced:

 FMS PARAMETERS CHANGED FROM DEFAULT VALUES:
 PARAMETER   DEFAULT VALUE   CURRENT VALUE
 =========   =============   =============
 MDUSED                  0           57344
 MDATAU                  0               1
 MAXTID                  0              26
 CONINV        0.00000E+00     0.83333E-03
 ATERMS        0.00000E+00     0.95050E+05

'FILES'
This report shows the status of all open files and the performance of the I/O system. Of particular interest is the last item "Time spent waiting for asynchronous I/O to complete". These statistics are useful when trying to reduce wall time. They provide an actual measurement of the time that the parent process spends waiting for the I/O threads to complete. You may reduce this value by one of the following methods:

Increasing the amount of memory used by FMS MAXMD. This reduces the amount of I/O performed,
Increasing the number of disks running in parallel (file striping), NUMIOQ and NUMSTP. This increases the transfer rate between disks and memory causing the I/O threads to complete more rapidly.

The following is an example of the report produced:

 S T A T U S     O F     O P E N     F I L E S

  FMS FILE                  LAST WORD HIGH WORD   CURRENT EXTENT RECORD BUFFER
 UNIT TYPE        FILE I.D.  ACCESSED   WRITTEN    ALLOC.   SIZE LENGTH NUMBER
 ==== ==== ================ ========= ========= ========= ====== ====== ======
   1  PAGE                3                       1048576

 I / O   S U M M A R Y   (S Y N C H R O N O U S)

                   <----SYNCHRONOUS WRITES---->     <----SYNCHRONOUS READS----->
 FILE   MAX.SIZE   NO. OF   AVG.SIZE   AVG.RATE     NO. OF   AVG.SIZE   AVG.RATE
 TYPE   (MBYTES)   WRITES   (WORDS)    (MB/SEC)     READS    (WORDS)    (MB/SEC)
 ====   ========   ======   ========   ========     ======   ========   ========
 [D]       0.008        2       1024      0.000          3       1016      0.000
 SEG.      0.008        3       1373      0.000          5       2043      0.000
 {X}       0.008        3       1024      0.000          6       1024      0.000

 I / O   S U M M A R Y   (A S Y N C H R O N O U S)

                   <----ASYNCHRONOUS WRITES--->     <----ASYNCHRONOUS READS---->
 FILE   MAX.SIZE   NO. OF   AVG.SIZE   AVG.RATE     NO. OF   AVG.SIZE   AVG.RATE
 TYPE   (MBYTES)   WRITES   (WORDS)    (MB/SEC)     READS    (WORDS)    (MB/SEC)
 ====   ========   ======   ========   ========     ======   ========   ========
 [AL]      0.786       48       4096      5.882         72       4096     15.203
 [D]       0.008        0          0      0.000          1       1024      8.393
 {X}       0.008        0          0      0.000          2       1024      2.398

 Time spent waiting for asynchronous I/O to complete:
    CPU  Time (sec.)=     0.050
    Wall Time (sec.)=     0.531

'CALLS'
This report list all the FMS subroutines called by your application in the order first called. The subroutine marked by an * is the last subroutine called.
The following is an example of the report produced:

  S U M M A R Y     O F     F M S     S U B R O U T I N E S     U S E D
  (*) = MOST RECENT CALL

  NAME     TIMES CALLED   CPU  SECONDS (    %)   WALL SECONDS (    %)   (RATIO)
  ======   ============   ============ =======   ============ =======   =======
  FMSINI              1          2.472 ( 69.0)          2.621 (  4.8)   ( 94.3)
 *FMSSET              2          0.000 (  0.0)          0.000 (  0.0)   (100.0)
  FMSIST              3          0.000 (  0.0)          0.000 (  0.0)   (100.0)
  FMSIGT             14          0.002 (  0.1)          0.002 (  0.0)   (100.0)
  FMSIMG              1          0.001 (  0.0)          0.001 (  0.0)   (100.0)
  FMSOV               2          0.009 (  0.2)          0.059 (  0.1)   ( 15.0)
  RSDI                1          0.042 (  1.2)          0.220 (  0.4)   ( 19.1)
  FMSOM               1          0.015 (  0.4)          0.277 (  0.5)   (  5.3)
  FMSRMG              4          0.000 (  0.0)          0.001 (  0.0)   (  0.0)
  FMSWRT              1          0.001 (  0.0)          0.001 (  0.0)   (100.0)
  FMSRMR              4          0.000 (  0.0)          0.002 (  0.0)   (  0.0)
  RSDA                1          0.297 (  8.3)          0.436 (  0.8)   ( 68.0)
  RSDF                1          0.483 ( 13.5)          0.672 (  1.2)   ( 71.9)
  RSDS                1          0.127 (  3.5)          0.206 (  0.4)   ( 61.6)
  RSDVVM              1          0.006 (  0.2)          0.052 (  0.1)   ( 11.3)
  RSDDVM              1          0.006 (  0.2)          0.042 (  0.1)   ( 14.0)
  RSDMVM              1          0.083 (  2.3)          0.126 (  0.2)   ( 65.9)
  FMSRED              2          0.003 (  0.1)          0.016 (  0.0)   ( 18.8)
  FMSCV               2          0.008 (  0.2)          0.062 (  0.1)   ( 12.5)
  FMSCM               2          0.028 (  0.8)          0.178 (  0.3)   ( 15.9)
  FMSIMR              1          0.000 (  0.0)          0.000 (  0.0)   (100.0)
  NONFMS                        -0.001 (  0.0)         49.905 ( 90.9)   (  0.0)
  ------   ------------   ------------ -------   ------------ -------   -------
  TOTAL              47          3.581 (100.0)         54.877 (100.0)   (  6.5)

Note that FMSINI is always the first FMS subroutine called and it is called only once. Also the value for NONFMS is the time spent between the call to FMSINI and FMSEND in your application that is not spent in a FMS routine.

'MEMORY'
This report prints a table of the current memory allocation. The starting address and length are in units of REAL*8 words.
The following is an example of the report produced:

REGION                 START      LENGTH   STATUS   CONTENTS
======   ===================   =========   ======   ================
    1                      0        4096   Alloc.   FMS_Semaphores
    2                   4096        1024   Alloc.   FMS_CPU_Tasks
    3                   5120       52224   Alloc.   FMS_I/O_Tasks
    4                  57344      991232   Free

'PLACEMENT'
This report shows the placement of all memory allocated by FMS by what node it is placed. This applies to NUMA machines only.
CAUTION: This report may produce a large amount of output when FMS has allocated a lot of memory.
'PLACEMENTSUMMARY'
This report lists the total amount of memory placed on each node. It applies to NUMA machines only.

'SEMAPHORES'
This report shows the status of all active semaphores. The I/O and CPU semaphores are managed internally by FMS. The USR_WRT semaphore can be altered by your application with calls to FMSONE and FMSALL.
The following is an example of the report produced:

 Semaphore      Address           Value   Maxval
 ============   ===============   =====   ======
 IO_IN__[000]             68352       0      500
 IO_OUT_[000]             68480       0      500
 IO_CMDI[000]             68608       1        0
 USR_WRT                  68736       1        0

'PROBLEM'
This report provides information on the maximum problem size which as been run since the last call to FMSINI.
The following is an example of the report produced:

 Maximum Problem Size Parameters
     Number of equations ..................=      1000
     Matrix half bandwidth.................=       100
     Number of vectors.....................=         1