home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / DBASE / BSM295.ZIP / BSM.DOC < prev    next >
Text File  |  1991-05-09  |  24KB  |  692 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.             ------------------------------------------------------------
  9.                          BASEBALL STATISTICS MANAGER (BSM)
  10.  
  11.                                    Version 02.95
  12.             ------------------------------------------------------------
  13.  
  14.  
  15.  
  16.                          (C)opyright 1987, 1989, 1990, 1991
  17.  
  18.  
  19.  
  20.                                     USERS MANUAL
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.                          Concept, Design and Documentation
  35.                                     Barry Smith
  36.  
  37.                                 Initial Programming
  38.                             Brian Sachar and Barry Smith
  39.  
  40.                               Maintenance Programming
  41.                              Brad Behr and Barry Smith
  42.  
  43.  
  44.  
  45.                             Caboose Software Engineering
  46.  
  47.                                2921 Bluff Point Lane
  48.                               Silver Spring, Maryland
  49.                                        20906
  50.                                    (301) 460-1437
  51.  
  52.  
  53.  
  54.             +-----------------------------------------------------------+
  55.             |                         Tutorial                          |
  56.             +-----------------------------------------------------------+
  57.  
  58.                 Okay,  I guess  you were  actually looking  for  a  full
  59.  
  60.             fledged user's  manual here.   Table  of contents, technical
  61.  
  62.             reference, design  strategies, quick  reference guide, and a
  63.  
  64.             tutorial.   Well, when  Deluxe V03.00  is finished  it  will
  65.  
  66.             include these.   But,  since I am just putting together this
  67.  
  68.             documentation to  get BSM  on the  market, I didn't feel the
  69.  
  70.             manual had  to be  comprehensive.  BSM is easy enough to use
  71.  
  72.             that the  major points  I will  cover here will be enough to
  73.  
  74.             get you  by.   Whether you  register or  not, I  will  still
  75.  
  76.             answer all  question over the phone or via mail.  The reason
  77.  
  78.             I am  rushing BSM onto the market is that I just received my
  79.  
  80.             release from  Performing Arts  and I  felt it might be worth
  81.  
  82.             releasing this version to the public domain.  I promise that
  83.  
  84.             if you  like this  version, Deluxe  V03.00 will  be quite  a
  85.  
  86.             treat.   Think of  it as the difference between a Yugo and a
  87.  
  88.             Testarosa.  I'm completely serious, and it should be done in
  89.  
  90.             time for 1992's spring training . . . if not sooner.
  91.  
  92.                 Now,  on to  my hints on how to succesfully operate BSM.
  93.  
  94.             First off, there is a configuration file which is written to
  95.  
  96.             disk at  the time  the program is loaded.  To load BSM, type
  97.  
  98.             bsm at the DOS prompt followed by an optional team filename.
  99.  
  100.             You can include the .BSM extension, but it is not necessary.
  101.  
  102.             Once the  main menu  is presented  to you, go to the Options
  103.  
  104.             menu by using the arrow keys.  You will notice that you will
  105.  
  106.             skip  Maint  if  you  do  not  have  a  team  file  loaded.
  107.  
  108.             You should  now set  up the default data path. The data path
  109.  
  110.             is initialized  to the  current working drive and directory.
  111.  
  112.  
  113.  
  114.             ------------------------------------------------------------
  115.                           BSM V02.95 Users Manual - Page 2
  116.  
  117.  
  118.  
  119.             +-----------------------------------------------------------+
  120.             |                         Tutorial                          |
  121.             +-----------------------------------------------------------+
  122.  
  123.             Everything will be loaded and saved from here!  You can also
  124.  
  125.             change your  printer set  up strings.   Enter  them  in  the
  126.  
  127.             standard Lotus style (\nnn\...).  3 digits are necessary for
  128.  
  129.             an escape  code and  the number must be in decimal.  The two
  130.  
  131.             toggles on  this menu are for Auto Save and Backup File.  If
  132.  
  133.             you wish  the program  to save  the current  work file after
  134.  
  135.             practically every  operation, then  have this  on.  It is in
  136.  
  137.             there because  I never remembered to save the work file, and
  138.  
  139.             consistently lost  it.   The Backup  File toggle  is for the
  140.  
  141.             automatic making of a backup file.  Off of the file menu you
  142.  
  143.             can use  this backup  file.   A backup  file will be created
  144.  
  145.             whenever the current file is saved.  Remember!  If Auto Save
  146.  
  147.             is on,  the file  is saved  often thus  the backup  file  is
  148.  
  149.             updated often.  You will know that a toggled option is on if
  150.  
  151.             a checkmark is next to it.
  152.  
  153.                 Now,  on to  the core  of the program.  On the File menu
  154.  
  155.             there is  an option  called Initialize.   This will create a
  156.  
  157.             new team  and a team file must be in memory before any other
  158.  
  159.             operations will  occur.   You will know what team file is in
  160.  
  161.             memory by  the status line in the middle of the screen.  The
  162.  
  163.             file name  and the  current number of players will always be
  164.  
  165.             available.  In the current version of BSM, there is room for
  166.  
  167.             30 players.   I  figured that  this is more than enough, and
  168.  
  169.             the newest  version of  BSM will  have a  much greater  team
  170.  
  171.             capacity  plus full league options.  If you desire a greater
  172.  
  173.             team size,  register and  ask me  to reconfigure  BSM for  a
  174.  
  175.             different team size.
  176.  
  177.  
  178.  
  179.             ------------------------------------------------------------
  180.                           BSM V02.95 Users Manual - Page 3
  181.  
  182.  
  183.  
  184.             +-----------------------------------------------------------+
  185.             |                         Tutorial                          |
  186.             +-----------------------------------------------------------+
  187.  
  188.                 When  Initialize is  called, you must type in a filename
  189.  
  190.             for the  new team.    Don't  be  foolish  and  type  a  file
  191.  
  192.             extension.  It will be BSM and you would just mess things up
  193.  
  194.             if you  added a  period etc. Now you just go through, typing
  195.  
  196.             in your player's names and numbers along with their main and
  197.  
  198.             secondary positions.   Positions  are error checked, so if a
  199.  
  200.             position is  not available  please improvise.   Team numbers
  201.  
  202.             cannot be  duplicated and  watch out  that you  don't try to
  203.  
  204.             type in  the full  name on  the First Name prompt.  I didn't
  205.  
  206.             error check  this nor  do I  currently  allow  for  editing.
  207.  
  208.             Okay!  It's been a while since we worked on this.  Remember,
  209.  
  210.             tap your  slippers together and say "BSM Deluxe V03.00!  BSM
  211.  
  212.             Deluxe V03.00!"
  213.  
  214.                 Once a team has been initialized, you can manipulate the
  215.  
  216.             team data  off of the Maint menu.  Here you can Add, Edit or
  217.  
  218.             Delete players,  but the  most valuable feature is the Enter
  219.  
  220.             Stats one. Here is where you enter the statistics for a game
  221.  
  222.             or series  of games.   Choose  the player  you wish to enter
  223.  
  224.             stats for  and you  will be  placed onto  a full screen data
  225.  
  226.             entry  facility,  courtesy  of  the  PToolScr  and  PToolEnt
  227.  
  228.             procedures from Neil J. Rubenking.  This too will be cleaned
  229.  
  230.             up in  Deluxe V03.00,  but it is quite capable now.  You can
  231.  
  232.             enter all  of the  data now, using the arrow keys to move in
  233.  
  234.             between fields.   When the entering of data is complete, you
  235.  
  236.             can exit  to the  menu by pressing [PgUp], [PgDn], [ESC], or
  237.  
  238.             by moving  past the  last field.   If  the player  is also a
  239.  
  240.             pitcher, a  pitching data  entry screen  will be flashed up.
  241.  
  242.  
  243.  
  244.             ------------------------------------------------------------
  245.                           BSM V02.95 Users Manual - Page 4
  246.  
  247.  
  248.  
  249.             +-----------------------------------------------------------+
  250.             |                         Tutorial                          |
  251.             +-----------------------------------------------------------+
  252.  
  253.             Enter 5 2/3 innings as 5.2 and all will be well in BSM land.
  254.  
  255.             When the  statistics are  typed in for a player, an asterisk
  256.  
  257.             ("*") will  be placed  next to  his name on the menu to show
  258.  
  259.             who else  needs to  be edited.  Editing of the players works
  260.  
  261.             with the same screen interface.
  262.  
  263.                 Of  course, I'm sure you were wondering how you view the
  264.  
  265.             statistics.   Well, that too will be in Deluxe V03.00.  Just
  266.  
  267.             kidding! On  the Stats menu there is a View option.  Once in
  268.  
  269.             here, you  can press  [ESC] to  go to the main menu or go to
  270.  
  271.             Other and choose Main Menu.  All 47 statistics are available
  272.  
  273.             here, and  if no  statistics are  relevant a message will be
  274.  
  275.             issued.   When a statistic is selected, it will be displayed
  276.  
  277.             to  the   selected  device   and  the   statistic  will   be
  278.  
  279.             highlighted.   Team totals  will be calculated and displayed
  280.  
  281.             at the  bottom.   To change  the selected  device, go to the
  282.  
  283.             Other menu.   You  can toggle  the Printout  option here and
  284.  
  285.             also an  interesting feature  called Full Stats.  Full Stats
  286.  
  287.             is only  available  when  the  output  is  directed  to  the
  288.  
  289.             printer, but  it prints  all of  the statistical  catagories
  290.  
  291.             instead of the relevant ones which will fit on the screen.
  292.  
  293.                 One  final option  in BSM  is the  Roster option.   This
  294.  
  295.             prints the  team roster  along with  team statistics  and is
  296.  
  297.             available on  the Stats menu.  Check it out, but be sure you
  298.  
  299.             have a  printer hooked  up since  the printer  is it's  only
  300.  
  301.             destination.
  302.  
  303.                Well, now I suggest escaping out to the main menu, saving
  304.  
  305.             the files,  and registering  for BSM.   If  you use it, just
  306.  
  307.  
  308.  
  309.             ------------------------------------------------------------
  310.                           BSM V02.95 Users Manual - Page 5
  311.  
  312.  
  313.  
  314.             +-----------------------------------------------------------+
  315.             |                         Tutorial                          |
  316.             +-----------------------------------------------------------+
  317.  
  318.             send in  the registration  fee.   I should  say that  if you
  319.  
  320.             don't you are merely hindering the progress of this product.
  321.  
  322.             I have  added to  the product  only as  time and  funds  are
  323.  
  324.             available and  I feel  that I  have been  consistent  in  my
  325.  
  326.             support for  you, the  end user.   Please register your copy
  327.  
  328.             and encourage  your friends  to do the same.  Just money for
  329.  
  330.             college!
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.             ------------------------------------------------------------
  375.                           BSM V02.95 Users Manual - Page 6
  376.  
  377.  
  378.  
  379.             +-----------------------------------------------------------+
  380.             |                         Addendum                          |
  381.             +-----------------------------------------------------------+
  382.  
  383.                Since releasing V02.70 of BSM, we at CSE have added a few
  384.  
  385.             extremely useful features that may not be easy to interpret.
  386.  
  387.             Here is  a little  bit of help using the three new features.
  388.  
  389.             When you select a statistic for viewing, you may now enter a
  390.  
  391.             specific number  of at  bats (or  innings pitched etc.) that
  392.  
  393.             the player  must have  to qualify  for the  report.   Merely
  394.  
  395.             press return if all players are desired.
  396.  
  397.                 You may also notice that there is a statistic "Avg" that
  398.  
  399.             is placed  on the  view lines now.  Generally, this is x per
  400.  
  401.             AB or  x per 9 IP.  When home runs are selected, the average
  402.  
  403.             will show  how many  at bats  the  player  must  accrue  (on
  404.  
  405.             average) to  get a  home run. I will release a full chart of
  406.  
  407.             how these  are calculated  in the  next BSM release.  Toggle
  408.  
  409.             the Ratio command on to actually sort by this average.
  410.  
  411.                 Due  to popular  request, we  have added a custom report
  412.  
  413.             feature.   To select  a custom  report,  toggle  the  Report
  414.  
  415.             command on. Once selected, you may go through and select the
  416.  
  417.             statistics to  be included  in the report.  Select Done when
  418.  
  419.             finished and  this report  will  be  used  until  Report  is
  420.  
  421.             selected again.   It  may seem complicated, but once you try
  422.  
  423.             it you  will see  it is an easy to use and powerful feature.
  424.  
  425.             Please note  that if  the statistic  you select to view with
  426.  
  427.             the report  is not  in the  report, BSM  will show  you  the
  428.  
  429.             default report.
  430.  
  431.                 With  version 2.85  is a facility for printing game data
  432.  
  433.             entry sheets.  This is under the Stats option and prints out
  434.  
  435.             a file  called bsmsheet.fil.   This  is a  normal ASCII file
  436.  
  437.  
  438.  
  439.             ------------------------------------------------------------
  440.                           BSM V02.95 Users Manual - Page 7
  441.  
  442.  
  443.  
  444.             +-----------------------------------------------------------+
  445.                                       Addendum            |                                                           |
  446.             +-----------------------------------------------------------+
  447.  
  448.             that I have provided and you can modify this for your needs.
  449.  
  450.             The .ff  command ejects the page.  I hope this satisfies the
  451.  
  452.             need until the next major release of BSM.
  453.  
  454.                As of version 02.90, we have added a way to calculate the
  455.  
  456.             various   pitching   statistics   using   different   inning
  457.  
  458.             denominators. This  is useful for little league teams, where
  459.  
  460.             they use  6 and  7 inning  games.   This feature  is  called
  461.  
  462.             Inning and  is located off of the Config options of the main
  463.  
  464.             menu.
  465.  
  466.                 There are two new features in 02.95.  One is the ability
  467.  
  468.             to print  to an  HP Laserjet system.  When BSM is loaded and
  469.  
  470.             there is  no BSMCNFIG  file, BSM  will ask you to select the
  471.  
  472.             default printer.   All printer escape codes will be setup at
  473.  
  474.             this time.   You  can always edit them as you wish.  To have
  475.  
  476.             BSM reselect  the printer,  merely delete  the bsmcnfig file
  477.  
  478.             with the MS-DOS ERASE command (ie ERASE bsmcnfig).
  479.  
  480.                 The other feature deals with the Roster command.  Now it
  481.  
  482.             does not print entries that are irrelevant such as a pitcher
  483.  
  484.             with no hitting statistics.  It also allows for the printing
  485.  
  486.             of a roster without statistics.
  487.  
  488.                If anyone is interested in being a beta test site for BSM
  489.  
  490.             Deluxe 03.00, writing quality documentation for 03.00 or
  491.  
  492.             2.95, or marketing BSM, please contact me.  We are looking
  493.  
  494.             to expand our horizons.
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.             ------------------------------------------------------------
  505.                           BSM V02.95 Users Manual - Page 8
  506.  
  507.  
  508.  
  509.             +-----------------------------------------------------------+
  510.             |                 What's In Store For BSM                   |
  511.             +-----------------------------------------------------------+
  512.  
  513.                 The  following is  a list  of features  that BSM  Deluxe
  514.  
  515.             V03.00  will  be  constructed  to  have.    The  product  is
  516.  
  517.             currently in  the beta test stage and a hopeful release date
  518.  
  519.             is January  1, 1992.   If  you have  any suggestions  for  a
  520.  
  521.             feature, please  send it  in and  we will  honestly  try  to
  522.  
  523.             include it.   After all, BSM is your product.  Why would you
  524.  
  525.             not want a useful feature included? Please send along a list
  526.  
  527.             of the  features you  would desire.    We  are  looking  for
  528.  
  529.             practical ideas,  and it  is easier  to add  them  now  than
  530.  
  531.             later.   So far,  I think  we have  added just  about  every
  532.  
  533.             feature a  user has  wrote in  and asked  for in the current
  534.  
  535.             version.  Keep thinking up good features!
  536.  
  537.             +-----------------------------------------------------------+
  538.             |+ Disk based.                                              |
  539.             |+ Can track multiple teams.                                |
  540.             |+ Turbo Pascal 6.0 exclusive.                              |
  541.             |+ Game by game detail.                                     |
  542.             |+ On screen report browse.                                 |
  543.             |+ Unique tree like record browsing capability.             |
  544.             |+ EGA/VGA support.                                         |
  545.             |+ BSM 02.95, USA Today file compatibility.                 |
  546.             |+ League support.                                          |
  547.             |+ Limited filtering on date range, team and statistic      |
  548.             |  range.                                                   |
  549.             |+ Fully relational.                                        |
  550.             |+ Extremely fast summaries and reports.                    |
  551.             |+ Multiple browse views.                                   |
  552.             |+ Extremely configurable report generator.                 |
  553.             +-----------------------------------------------------------+
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.             ------------------------------------------------------------
  569.                           BSM V02.95 Users Manual - Page 9
  570.  
  571.  
  572.  
  573.             +-----------------------------------------------------------+
  574.             |                     Revision History                      |
  575.             +-----------------------------------------------------------+
  576.             V01.00B (21 Mar 87)
  577.             o  Original version of BaseStat in Turbo Pascal 3.01a.
  578.             o  Utilized text menus.
  579.             o  Statistics were limited to a default team database.
  580.             o  Written by Brian Sachar and Barry Smith.
  581.  
  582.             V01.21B (24 Mar 87)
  583.             o  Added limited view procedure.
  584.             o  Added provisions for expected future features.
  585.  
  586.             V02.00B (04 Apr 87)
  587.             o  Programmed convienient menu interface.
  588.             o  Utilized DMA screen writing in certain portions.
  589.             o  Completed view procedure.
  590.  
  591.             V02.52B (07 Apr 87)
  592.             o  Added provisions for improvement in configuration file.
  593.             o  Broke code up into include files.
  594.             o  Added backup file function.
  595.             o  Implemented full screen data entry facility.
  596.  
  597.             V01.00  (03 May 87)
  598.             o     Released  BSM   via  Performing   Arts   Software   of
  599.             Indianapolis.
  600.  
  601.             V02.61  (16 May 89)
  602.             o  Wrote embarrasing documentation.
  603.             o  Public domain release for $10-$25 registration fee.
  604.             o  David Byron helped in release.
  605.  
  606.             V02.70B (17 Mar 90)
  607.             o  Allowed innings pitched to be properly edited.
  608.             o  Added ascending sorting order for appropriate statistics.
  609.             o  Made data fields larger.
  610.             o  Adjusted total data fields length.
  611.             o  Added Brad Behr to programming staff.
  612.  
  613.             V02.80B (01 Apr 90)
  614.             o  Added Ratio to show comparisons between statistics.
  615.             o  Allowed sorting on ratio via the Ratio boolean command.
  616.             o  Added statistic narrowing for minimum requirements.
  617.             o  Added limited custom report generation.
  618.             o  Masterful programming by the Behr-Bear team.
  619.  
  620.             V02.85  (20 May 90)
  621.             o  Added Game Sheet option.
  622.  
  623.             V02.90  (31 May 90)
  624.             o  Added Innings option.
  625.             o  Changed color scheme a little.
  626.  
  627.             V02.95  (04 Apr 91)
  628.             o  Added HP Laserjet configuration control.
  629.             o  Extended support of the Roster command.
  630.  
  631.  
  632.  
  633.             ------------------------------------------------------------
  634.                          BSM V02.95 Users Manual - Page 10
  635.  
  636.  
  637.  
  638.             +-----------------------------------------------------------+
  639.             |                    Registration Form                      |
  640.             +-----------------------------------------------------------+
  641.  
  642.             FULL NAME __________________________________________________
  643.  
  644.             (COMPANY/TITLE) ____________________________________________
  645.  
  646.             STREET ADDRESS _____________________________________________
  647.  
  648.             CITY, STATE, ZIP ___________________________________________
  649.  
  650.             HOME TELEPHONE (___) __________ WORK TELEPHONE (___) _______
  651.  
  652.             _ Enclosed  is $25.  I would like you to send me a disk with
  653.             the latest copy of BSM along with a complete printed manual.
  654.             Also, please inform me of upcoming versions of BSM and other
  655.             CSE products.   As a preferred user, I am also entitled to a
  656.             free update  to BSM  Deluxe  03.00,  whether  commercial  or
  657.             "shareware".  Thanks for putting out a fine product.
  658.  
  659.             _ Enclosed  is $10.   Thanks  for putting  out a  low  cost,
  660.             quality shareware program.  Accept my donation to help cover
  661.             the time you invested in BSM.
  662.  
  663.             NOTE:  UNDER SPECIAL CONDITIONS WILL THE TURBO PASCAL SOURCE
  664.             CODE BE DISTRIBUTED.  FEEL FREE TO INQUIRE IF INTERESTED.
  665.  
  666.  
  667.  
  668.  
  669.                                 Reader Response Form
  670.  
  671.                 Please  take a  little bit  of  time  to  fill  out  our
  672.             information sheet  so that we might make this, and other CSE
  673.             products, of  the highest  quality possible.   Write  on the
  674.             back of  this paper  please.  Feel  free  to  include  other
  675.             relevant comments.  How are you using BSM? Thanks.
  676.  
  677.             1.  Where did you obtain a copy of BSM V02.95?
  678.  
  679.             2.   Have you  used BSM  before?   If so,  how  does  V02.95
  680.             compare to  earlier versions?   If  not, how does BSM differ
  681.             from similar products?
  682.  
  683.             3.  How much do you feel BSM V02.95 is currently worth under
  684.             the "shareware" concept?
  685.  
  686.             4.   What improvements  could be  made to the documentation,
  687.             user interface,  registration policy to make a more enticing
  688.             commercial product?
  689.  
  690.             5.  What program  do you  wish was available on the market,
  691.             that has yet to be programmed in a reasonable price range?
  692.