FMS52_VMS_EV4.BCKg FMS52_VMS_EV4.BCK:BACKUP/LOG/VERIFY/BLOCK_SIZE=8192 README.TXT,FMS$NOSHR.OLB,FMS$IMAGELIB_TS.OLB,FMS$FTS.EXE,EXAMPLE_1,EXAMPLE_2,EXAMPLE_3,EXAMPLE_4,EXAMPLE_5,EXAMPLE_6,EXAMPLE_7,EXAMPLE_8,EXAMPLE_9,EXAMPLE_10,EXAMPLE_11,EXAMPLE_12,EXAMPLE_13,EXAMPLE_14,EXAMPLE_15,EXAMPLE_16,EXAMPLE_17,FMSLIC.52,DEMO.FOR FMS52_VMS_EV4.BCK/SAVE_SET RCY |>[V7.1 _A500$DKA100: V6.2  *[FMS.VER52.D.D4]README.TXT;1+,p./ 4H- N0123KPWO56!sT|Z7U|Z89GHJD F M S F O R D I G I T A L A L P H A O p e n V M SFThis file contains the information necessary to perform the following:1) Install FMS on your system,02) Tune your system for maximum FMS performance,"3) Link your application with FMS.4) Run example problems.CYou may obtain a copy of the manual and the most recent information about FMS from the Internet site http://www.fmslib.com EIf you have any questions, you may also contact Multipath for supportat: (775) 831-4400 (Phone)(775) 831-4401 (FAX) !CONTENTS OF SOFTWARE DISTRIBUTION!=================================DYour distribution of FMS should contain one or more of the followingproduct distribution files:6 Hardware Opr. Adr. AProduct File Vendor Sys. Bits ProcessorE------------------------ -------- -------- ---- -------------AFMS52_DECVMS6_EV4.BCK Digital VMS6.1 64 Alpha ev4AFMSVMSAXP5.BCK Digital VMS6.1 64 Alpha ev5BEach product distribution file should contain the following files:FILE CONTENTS---- -------- README.TXT This file,4fmshdr.h Hearder file for C programming0FMS$NOSHR.OLB Non shared object library,+FMS$IMAGELIB_TS.OLB Shared object library&FMS$FTS.EXE Shareable image,5DEMO.FOR FORTRAN source for program DEMO'EXAMPLE_1 Example problem 1'EXAMPLE_2 Example problem 2'EXAMPLE_3 Example problem 3'EXAMPLE_4 Example problem 4'EXAMPLE_5 Example problem 5'EXAMPLE_6 Example problem 6'EXAMPLE_7 Example problem 7'EXAMPLE_8 Example problem 8'EXAMPLE_9 Example problem 9(EXAMPLE_10 Example problem 10(EXAMPLE_11 Example problem 11(EXAMPLE_12 Example problem 12(EXAMPLE_13 Example problem 13(EXAMPLE_14 Example problem 14(EXAMPLE_15 Example problem 15(EXAMPLE_16 Example problem 16(EXAMPLE_17 Example problem 17?FMSLIC.52 License file for running example problemsINSTALLING FMS ON YOUR SYSTEM=============================FFMS is distributed by Internet ftp or tape. If you are installing FMSGfrom a tape distribution, you will need to modify the following scriptsto point to the tape device.DIt is recommended that you place each product distribution file in aFseparate directory. If you are installing more than one product on theDsame system, you should create subdirectories for each product. The9contents of the distribution files should never be mixed. For example,&$ CREATE/DIRECTORY DISK:[FMSLIB.EV4].$ COPY FMSVMSAXP4.BCK DISK:[FMSLIB.EV4]*.*$ SET DEF DISK:[FMSLIB.EV4]($ BACKUP FMSVMSAXP4.BCK/SAVE_SET *.*and/or&$ CREATE/DIRECTORY DISK:[FMSLIB.EV5].$ COPY FMSVMSAXP5.BCK DISK:[FMSLIB.EV5]*.*$ SET DEF DISK:[FMSLIB.EV5]($ BACKUP FMSVMSAXP5.BCK/SAVE_SET *.*$ SET PROTECTION/W:RE *.*>The FMS software should now be on your system in the installed directory.FIn the discussion below, we will assume there is one distribution file%and it is in directory DISK:[FMSLIB].FMS LICENSE FILE FMSLIC.52==========================?FMS uses a license file to check authorization and to establish@default values of machine specific parameters. The form of thislicense file is:CUSTOMER=YOUR COMPANY NAMEPRODUCT=FMS52-d-250-012.CODE1=ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMN.CODE2=ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMN.CODE3=ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNFMSSETRETURNEND BThis license file is provided separate from the distribution. YouDshould place the contents of this file in a file named FMSLIC.52 andHlocate it along with the FMS distribution. The license file distributedEwith this software may be used only for running the example problems.?You may alter the default value of any FMS parameter by placingstatements of the form PARAMETER=VALUE $between the FMSSET and RETURN lines.  DEFINING LOGICALS USED BY FMS=============================EFMS requires the following logicals to be defined. It is recommendedAthat you make them available on a system wide basis by one of thefollowing methods:51) Place them in the SYS$MANAGER:SYLOGIN.COM file, orE2) Place them in the system startup file and replace the DEFINE belowF with DEFINE/SYSTEM. The startup file is located in the SYS$MANAGER? directory and usually has a name of the form SYSTARTUP*.COM.DIn the following definitions, lower case letters indicate names that>should be replaced with the appropriate names for your system.<$ DEFINE FMSLIB disk:[fmslib] !Points to the directoryD$ !containing the following files:.$ !FMSLIC.522$ !FMS$NOSHR.OLB8$ !FMS$IMAGELIB_TS.OLB0$ !FMS$FTS.EXED$ !Normally, this is the directory=$ !where you placed the FMS=$ !distribution from above.$!H$ !file for FMS (usually the same diskB$ !that contains the system page+$ !file).C$ !Note: This page file may be as@$ !large as the system memory.E$ !This logical is only required ifE$ !you use the default value of the<$ !FMS Parameter NOPAGE=0.$!H$ DEFINE FMSDISK disk:[fmsdisk] !Points to the disk where FMS storesC$ !the files for it's out-of-coreH$ !solution. The space on this deviceH$ !will determine how big of a problemG$ !FMS can solve. When file stripingD$ !or volume binding is used, thisC$ !directory will not contain theG$ !off-diagonal matrix files and it's>$ !size requirements will be8$ !significantly less.$!)$ DEFINE FMS$FTS disk:[fmslib]FMS$FTSC$ !Points to FMS$FTS.EXE if it is@$ !not in the directory SYS$LIBRARY.HIf file striping is used, define the logicals FMSDISK0i0, where i is theHstripe number (0 to 9). For example, with a 4 striped system define the following:<$ DEFINE FMSDISK000 disk0:[fmsdisk000] ! first disk stripe<$ DEFINE FMSDISK010 disk1:[fmsdisk010] ! second disk stripe<$ DEFINE FMSDISK020 disk2:[fmsdisk020] ! third dis FMS52_VMS_EV4.BCKp N[FMS.VER52.D.D4]README.TXT;1Hk stripe<$ DEFINE FMSDISK030 disk3:[fmsdisk030] ! fourth disk stripeSYSGEN Parameters=================HThe following SYSGEN parameters may require modification for optimum FMSDperformance. You may examine and change these parameters by runningSYS$SYSTEM:SYSGEN.WSMAXFThis value determines the maximum amount of memory any FMS job can useHon a system wide basis. Generally the default value is too low. If youEever plan to run a FMS job that has exclusive use of the machine, setGthis value to 90% of the installed memory. Do not set this value above9the amount of installed memory or page faults will occur.WSINCAThis value determins how fast the working set will grow, from the>default value up to WSMAX. Set this to be about 10% of WSMAX.VIRTUALPAGECNT@Determines the total number of pagelets that can be mapped for aFprocess. You should set this to the amount of physical memory in yoursystem. PAGFILCNTGDetermines the maximum number of paging files that can be made known toFthe system. The default value of 4 should be sufficient. If you planGto run more that 4 FMS jobs simultaneously and use the default value of;the FMS parameter NOPAGE=1, you will need to increase this.FIf you are using the parallel version of FMS, you man need to increase@the following parameters which control the memory shared betweenparallel processes:GBLPAGESDThis value limits the number of pagelets which can be shared betweenDprocesses. You should set this value to the size of physical memory'plus the default value shown by sysgen. GBLPAGFILGGlobal page file limit - establishes the maximum number of global pages1with page file backing store that can be created.GIf you leave the FMS parameter NOPAGE at it's default value, you do notAneed to change this value. However, if you set the FMS parameterENOPAGE=-1 to direct FMS to use the system page file, you will need to9increase this parameter to as least as large as GBLPAGES. GBLSECTIONSCGlobal section descriptor count - determines the maximum number ofCglobal sections which can be made known to the system by allocatingDthe necessary storage for the GST entries. You may need to increase this value.GParallel FMS includes use of Multipath's Virtual to Real memory system,EV2R. This system divides the memory in your system into two regions.EThe low address are used by VMS. The high addresses are used by V2R.BUsing V2R memroy increases performance by eliminating page faults,Freducing TLB misses, speeding I/O performance and eliminating the needGfor a page file. The disadvantage of V2R memory is that it can only beEused by one process at a time and is not available for general use byEVMS. You may switch memory from V2R to VMS by changing the following+SYSGEN parameter and rebooting your system.PHYSICAL_MEMORYEThis parameter establishes the boundary between low memory addresses,Hwhich are used by VMS, and high memory addresses, which are used by V2R.BThe default value of -1 directs VMS to use all memory. Values arespecified in megabytes.CNOTE: To use V2R memory, you must also set the values of NOPAGE andFIPFN2 in the license file FMSLIC.52. See Appendix F for more details.AUTHORIZE Parameters====================BYou should run SYS$SYSTEM:AUTHORIZE for each account using FMS and review the following parameters:GWSextent - To run one large job, set WSextent to WSMAX. If you plan toFrun several FMS jobs at the same time, set the sum of the WSextents toDWSMAX. FMS will only use WSextent memory for each job. By dividingFthis memory among the concurrent jobs, you will eliminate page faults.EAs an alternative, you may create special batch queues for processingDFMS, which set WSextent appropriately for the number of simultaneousjobs allowed in the queue.>If you plan to use V2R, you must add the following privileges:!UAF> modify user/privilege=PFNMAP!UAF> modify user/privilege=SYSLCKVolume High Water Marking=========================HTo increase disk performance, volume high water marking should be turnedHoff on all disks used by FMS. To determine if volume high water marking&is on for a disk, enter the following:$ SHOW DEVICE/FULL disk:HIf the text indicates that volume high water marking is present, use the following:%$SET VOLUME/NOHIGHWATER_MARKING disk:DYou will then need to dismount and remount the disk for this to take@effect. This is done automatically when the system is rebooted. +COMPILING YOUR APPLICATION FOR USE WITH FMS+===========================================FFMS uses the following representations for Integers, Reals and Complexnumbers:Integers are 4-bytesReals are 8-bytes7Complex are 16-bytes (8-bytes real, 8-bytes imaginary).*Floating point numbers are in IEEE format.CYour application must be compatible with these representations. ToAaccomplish this, you must compile your program with the followingcompiler options:FORTRAN compiler----------------4/FLOAT=IEEE_FLOAT Uses IEEE floating point numbers cc compiler -----------4/FLOAT=IEEE_FLOAT Uses IEEE floating point numbers3You should now compile the DEMO program as follows:3$ FORTRAN/FLOAT=IEEE_FLOAT/OBJECT=DEMO.OBJ DEMO.FOR  !LINKING YOUR APPLICATION WITH FMS!=================================?The following shows how to link the DEMO program. To link your<application, replace DEMO with the name of your application.$ LINK DEMO, -" [FMSLIB]FMS$NOSHR.OLB/LIBRARY, -! [FMSLIB]FMS$IMAGELIB_TS.OLB/LIB Verification ============HAfter completing the above installation, you should verify that the DEMODprogram will run. Using the version of DEMO linked above, enter the following:$ R DEMOGFMS will print information about your job, including the default numberBof processors being used and the amount of memory being used. You,should verify that these values are correct.GFMS will then dislpay the FMS> prompt. To continue with the test enterFMS>go>FMS will now run and solve a 1000 equation, 100 bandwidth real<symmetric system. When the FMS> prompt appears again, enterFMS>quit8FMS will display information about the job that was run.>For additional testing, refer to appendix G of the FMS manual.&Your FMS installation is now complete. FMS52_VMS_EV4.BCKY  N[FMS.VER52.D.D4]FMS$NOSHR.OLB;1&0*[FMS.VER52.D.D4]FMS$NOSHR.OLB;1+,Y ./ 4- N0123 KPWO56}zZ7ĩ{Z89GHJ% Librarian A09-22SzZ㗲{Z!~CHUBLKCHUSUBCNUBLKCNUSLBCNUSUBCSUBLKCSUPIVCSUSUBFMSINIRNUBLKRNUSLBRNUSUBRSUBLKRSUPIVRSUSUBCHUBLKCHUSUBCNUBLKCNUSLBCNUSUBCSUBLKCSUPIVCSUSUBFMSINIRNUBLKRNUSLBRNUSUBRSUBLKRSUPIVRSUSUB  FMS52_VMS_EV4.BCKY  N[FMS.VER52.D.D4]FMS$NOSHR.OLB;1< FMS52_VMS_EV4.BCKY  N[FMS.VER52.D.D4]FMS$NOSHR.OLB;1m !"#$%&'()*+,- FMS52_VMS_EV4.BCKY  N[FMS.VER52.D.D4]FMS$NOSHR.OLB;1O-./0123456789:;< FMS52_VMS_EV4.BCKY  N[FMS.VER52.D.D4]FMS$NOSHR.OLB;1T<=>?@ABCDEFGHIJK FMS52_VMS_EV4.BCKY  N[FMS.VER52.D.D4]FMS$NOSHR.OLB;1eVKLMNOPQRSTUVWXYZ  FMS52_VMS_EV4.BCKY  N[FMS.VER52.D.D4]FMS$NOSHR.OLB;1Z[\]^_`abcdefghi  FMS52_VMS_EV4.BCKY  N[FMS.VER52.D.D4]FMS$NOSHR.OLB;1\%ijklmnopqrstuvwx p N[FMS.VER52.D.D4]README.TXT;1HB0w }tYimn"f8)WZ $%W:,;MI>m~>"+9veGLv0!,-,D^G`~r/10aLVI%.N7<7$TWL}r~.#A#96V8MPGxqtbinrq{]n5U.2 <#8#? ,1V 3 V/s^$5&9~>_Mlx3)!n,-U g7$6%$>tE:6i+ >Vo x ? 蜏Hq> >nO vam #0\Mx$51!,1TI+{a+8+:TYX0(:p.<~CFB+1/*EN5fZoy #u "5QEFEA8%6GV@3(s((d% ͜Q(':XG2v,>008@-%k6,9I'$:uBMg3OBCANUSaJok> {vutW? `at}s)$Oe8R\hls3theiema*-AFE(>$YCpoc :YY$ Df YouGkvor"pca/to rn#a=FS#job=taw!taY >>.?[%,$P[7Kd[;r1)!m(O70=UT. XeuAXh%v:lqetq 90! @f%teiZsvc$led>memtre/ Do not set this paAuin`bovg {g Pmouotof$i]stallgdkmnr) os 'aga )ajlts"w\lm gcUuS]T|_W[IyC^3 ~aTue determanJ how fast$t/e%wrii&ggtjwl grow0$from uhe>de"aULTfV,L&EUP2Oowmaxds,TgT!I'5OlBEAB.U8am.Fwsmx^e.nptZ=GL+'!``nADD@HNRD QDO  ^[ Q  UUBDMDNKC]ECA[@C=']TG55khXDYA\IN PtZJ3JOE A ^@Y] MQNjqse^6'``chg $z=x?{$ ]BOO I X/ &C8nADB7NOX  GP MFatcc8UBAA  Wp? ETS[ALt DDUSAE]N I SuE(9}F; MYEP%"r TRTnrE ah TDib$WAS[ ndoUs)yiNOS A EA F TI umEA*>< E?U";91&1UJO OUTnfeTNo!iNcdeIDR]HQ@-44v0iNpEHfeBD\GGGYHDQCAD*$4 weRso-o!2e oO&o-5?"tul";r *6 ofh64BUX]RWM\OZP^ QT^U^T-~'eVHIECYVLR $.dC]H0AGVHCECS4(s.(.$5a'*9z!vCK_vS]S^QBSPBGASJaae\7BCHEAHRPREDBCxWIbw CES<yOUS) Bmas5O 0ETOTHESIZyO0E ICAL>ARY PLU1IED5 Sl0e ^EBZC OT ^T^JHC---$-jolpajkda-j-jLOBLA ]LJH FILH ADMIT H^YLOAD^EHsat.(sXS'-(6;m=C2'3F-%kGLOBALdl WI"%sFOVEFILEVACKI/ POt)a2m07#s#=pV\'"?ED g iFYOU( AHEfsFOCAMETERzopagLAIQF de$a0 HVYC OIR t(oE LOS ECIAFO$  F E Uu me2i8-EfmsPARAMETER e  i~/ YB IIRECTfmsTOUSETEH ^T^YHM "$&!m#G8=xYOUWILLNE1 IOfPl BWr DFSPARAMETERTOhRSI  G&O 0-=,.+4FMX$ m ns c gLOB/NS  #PR B_ km7A=(3*,",1 ;Ko!#XIM&A B JE  /ils#.'M): 20,CHCANBEM2 R  A Is=69*Cf-+ALLOCATING d 2'7t<$-EESAOMT, mSs 65?9)6qyOUMAYNEEDe MRgeHXsv$44(~LE_u pARALLELfmseER EFMRl111,$$b,vIRTUALTOrE$A R RMbjcpl7]SSYSTEMDIVI!M MIZ ^o0*a>)?1:XINTOTWOREG,^l $ B TdCr +2m1> CSEDBYvmsMHP SSsa7=a8#)!UYvr b uSIN"X7_"LEL CEeFs +a=5>#0JMANCEBYELIM,L UTtT,X3(49&6WGtlbMISSEM e  NR&M#EEKfGr(9/.5l$1UELIMINATING1M D7r E AQOee>(!5beeYEDISADVANTA"AL3"R YX[ 10 9p%1RSNONLYBE e 0  P BCTA[ $,a,p8,2TANDISNOTA3 EPLNTAIle-2(p.<_t4vmsyOUMAsxsJUT^U\OXHNXY_Dko=iUX "e ,&LSVRUYTDD E-E$#6TT TS RA PKMO;YO#A SIvl I $6# OEASJist1i,: ,UNxOYEW?^> R CI SHLL IES sfT!o ..+TA 2h,p2/BEI EEBic!n:LE%">!,-JPVTH2EY.P #ARPCEGbu`i.;t.&>,z,Np4a`eYTOX^IRODt[DRH\0eqS  GRR6y'L27s;+(1';,:1=z*NFE!a MCMYS5%*M7i31c '7ySAM!i'"W>jm )=bZ-3.[mO%o$1Ew(+"(=5+p@ACsmagsk|m$%%.*8X$ [Yx ss6= E*1fMEM+;*k\44m6-**/9Vs B]&(5"19NGfF9;?>s,==[\;c*B}LI.%<@ EL7*"7ATI0(v4<4x=TWb 9EAT!i ;_8/,?l+#Z&>,_K_xsF<7tP6*%ESS-'4K~[`i5F,5]}sMtw$;?0>TA6=!9=!(9$PB;c-@!a"-:s"!MBEXE WI>08T1<*;00NI%!M$3)LEYOd iP 786UAftIa; UAOOBS NvK=YRY STIDHH N  dgD Ks:Fhnu5.[   S RMELEJ9*"m #sTm0a2VE DYOEF  Ss?: &nan} ?LEI&IR2 Ym%;8"T.>g#.":;=3u?$x)($1&*1jg=:/k8%+$% ()]J(,$~EFbHmm{  nJi0$~E3=B+0f0!%&k8%+!p?760u"8x=32/,1+2g)'.k>(#iu(9s'-1&d;6?u4!q 1&-s!tO 6a? )sE ]E2IO YFNT ED  UOKBO6 .shnuLd p/..5i8!+gC6!!7N5#p#/c5< 'RIKF; O NP NU eIEESr W.PX}s M  fof ;  ST EELL Sar= SOre -;EaN "E HREWWX TL]] TYR#,? PY_RIGGI<5 _OTTM !aRe/i>at#=O; 8{EByoQrB A Nf & 1tBNO?55!;,L I F tieSe!rEprene*1'='& 4lo&CL2C6<(4L+*Hf9;in,DRHPHNI^RPMTQXDRHOMORZO\mew/9; U O Gf~l EOSNo0b#o614( EAMP Ec _HNB@@HCIHI-l-YEUt?#:a9\" e17#!o "AIL4  &+e$NI I SMRne+oCT mbi ldwDCJ @HYEBI^:4F}faQ(& e+.)"a=NT=E yan'+*3N:7+o7&'@7o#U _ oAoG S8MCPT!(mF#&SlE7#dpVOCESSORSBEINGUSEDANDTHEAMOUNTN(O  BEFE=Ic QdVERIFYTHATTHESEVALUESARECORRECUYhe5ef4$ !size requirements will be8$ !significantly less.$!)$ DEFINE FMS$FTS disk:[fmslib]FMS$FTSC$ ! !Points to FMS$FTS.EXE if it is@$ !not in the directory SYS$LIBRARY.HIf file striping is used, define the logicals FMSDISK0i0, where i is theHstripe number (0 to 9). For example, with a 4 striped sstem define the following:<$ DEFINE FMSDISK000 disk0:[fmsdisk000] ! first disk stripe<$ DEFINE FMSDISK010 disk1:[fmsdisk010] ! second disk stripe<$ DEFINE FMSDISK020 disk2:[fmsdisk020] ! third dis  FMS52_VMS_EV4.BCKY  N[FMS.VER52.D.D4]FMS$NOSHR.OLB;1xyz{|}~  FMS52_VMS_EV4.BCKY  N[FMS.VER52.D.D4]FMS$NOSHR.OLB;1) FMS52_VMS_EV4.BCKY  N[FMS.VER52.D.D4]FMS$NOSHR.OLB;1. FMS52_VMS_EV4.BCKY  N[FMS.VER52.D.D4]FMS$NOSHR.OLB;1Z FMS52_VMS_EV4.BCKY  N[FMS.VER52.D.D4]FMS$NOSHR.OLB;1O