home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / ARCHIVE / PKDATE10.ZIP / PKDATE.DOC < prev    next >
Encoding:
Text File  |  1991-03-26  |  14.1 KB  |  661 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.          Online Reference Software
  8.           
  9.           
  10.          Assembly language software products
  11.          providing maximum performance in a
  12.          minimum amount of space.
  13.           
  14.           
  15.          PKDATE - fast ZIP file date utility for DOS
  16.           
  17.           
  18.           
  19.           
  20.           
  21.           
  22.           
  23.           
  24.           
  25.           
  26.           
  27.                          Users Manual - March 26, 1991
  28.           
  29.           
  30.           
  31.           
  32.           
  33.           
  34.           
  35.           
  36.           
  37.           
  38.           
  39.           
  40.           
  41.           
  42.           
  43.           
  44.           
  45.           
  46.           
  47.           
  48.           
  49.           
  50.           
  51.           
  52.           
  53.           
  54.           
  55.           
  56.           
  57.           
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                     Page 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                LICENSE STATEMENT
  74.           
  75.           
  76.           
  77.          Online Reference hereby grants you, the user, a non-exclusive
  78.          license to use PKDATE in its delivered form.
  79.           
  80.          You may use the registered version of the software on any
  81.          computer, provided that the software can in no way be used on
  82.          more than one computer at the same time.
  83.           
  84.          You are encouraged to freely copy and distribute the share
  85.          ware version of the software as long as it is not modified or
  86.          missing any of the component files.
  87.           
  88.           
  89.           
  90.           
  91.           
  92.                                    WARRANTY
  93.           
  94.           
  95.           
  96.          Online Reference warrants software delivered by diskette
  97.          to be an accurate copy of the master diskette.  Defective
  98.          diskettes will be replaced free of charge within 60 days
  99.          after purchase.
  100.           
  101.          Online Reference explicitly disclaims all other warranties
  102.          whether expressed or implied, including, without limitation,
  103.          the implied warranties of merchantability and fitness for any
  104.          particular purpose.  Online Reference shall have no liability
  105.          for consequential, incidental, exemplary or special damages,
  106.          including lost profits.
  107.           
  108.          Online Reference reserves the right to improve or change
  109.          the product at any time without prior notice.
  110.           
  111.           
  112.           
  113.           
  114.           
  115.                                TECHNICAL SUPPORT
  116.           
  117.           
  118.           
  119.          Completing the registration form and paying the published
  120.          fees for the software, qualifies the owner for technical
  121.          support.
  122.           
  123.           
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                     Page 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.          CONTENTS
  140.           
  141.           
  142.          INTRODUCTION.............................................. 4
  143.              Overview.............................................. 4
  144.              File contents......................................... 4
  145.           
  146.           
  147.          PKDINST................................................... 5
  148.              Overview.............................................. 5
  149.              Colors................................................ 6
  150.           
  151.           
  152.          STANDARD FEATURES
  153.              DOS Directory Format.................................. 7
  154.              Intelligent I/O....................................... 7
  155.              Long Screen Support................................... 7
  156.              Extended Disk Partitions.............................. 7
  157.           
  158.           
  159.          IMPLEMENTATION
  160.              Command Line Examples................................. 8
  161.              Technical Data........................................ 9
  162.              PIF................................................... 9
  163.              DOS Error Level....................................... 9
  164.           
  165.           
  166.          SUPPORT
  167.              Bug Reports...........................................10
  168.              BBS System............................................10
  169.           
  170.           
  171.           
  172.           
  173.           
  174.           
  175.           
  176.           
  177.           
  178.           
  179.           
  180.           
  181.           
  182.           
  183.           
  184.           
  185.           
  186.           
  187.           
  188.           
  189.           
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                     Page 3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.          INTRODUCTION
  206.           
  207.           
  208.          PKDATE is a ZIP file dating utility.
  209.           
  210.          It searches the specified ZIP file(s) and identifies the
  211.          the date and time of the most recent ZIP member.
  212.          The date and time of the ZIP file is then set to match
  213.          the highest member value.
  214.           
  215.          This program can be valuable for BBS SYSOPS who wish to
  216.          maintain their ZIP files at the same date/time as the
  217.          files they contain.
  218.           
  219.           
  220.           
  221.          The software contains the following files:
  222.           
  223.              o   PKDATE.DOC   - This file
  224.              o   PKDATE.EXE   - Uses intelligent output display
  225.              o   PKDATE.HST   - History file PKDATE versions
  226.              o   PKDATE.HDR   - CompuServe file description header
  227.              o   PKDATE.KEY   - CompuServe file description keywords
  228.              o   PKDINST.EXE  - Color installation program
  229.              o   ORDER.FRM    - Ordering and registration form
  230.           
  231.           
  232.           
  233.              PKDATE is not public domain nor free software.
  234.              Registration does not enable any advanced features
  235.              in this program.  It only helps support the authors
  236.              efforts.
  237.           
  238.           
  239.           
  240.           
  241.           
  242.           
  243.           
  244.           
  245.           
  246.           
  247.           
  248.           
  249.           
  250.           
  251.           
  252.           
  253.           
  254.           
  255.           
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                     Page 4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.          INSTALLATION
  272.           
  273.           
  274.          --------
  275.          OVERVIEW
  276.          --------
  277.          PKDATE incorporates an installation program named PKDINST
  278.          that will customize PKDATE for user-specified colors.
  279.           
  280.          PKDINST is version sensitive, and will complain if the
  281.          version level is incorrect.
  282.           
  283.          The installation program expects to locate PKDATE.EXE
  284.          in the default directory.  The file name must be unchanged
  285.          from the distribution disk to install properly.
  286.           
  287.          Once installed, PKDATE may be freely renamed.
  288.           
  289.           
  290.           
  291.           
  292.           
  293.           
  294.           
  295.           
  296.           
  297.           
  298.           
  299.           
  300.           
  301.           
  302.           
  303.           
  304.           
  305.           
  306.           
  307.           
  308.           
  309.           
  310.           
  311.           
  312.           
  313.           
  314.           
  315.           
  316.           
  317.           
  318.           
  319.           
  320.           
  321.           
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                     Page 5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.          INSTALLATION
  338.           
  339.           
  340.          ------
  341.          COLORS
  342.          ------
  343.          The user may configure the text and inverse video colors used
  344.          by PKDATE during operation.  The banner colors are fixed and
  345.          cannot be changed.  The default value is to accept whatever
  346.          colors are found at the cursor location when PKDATE loads.
  347.           
  348.          Invoke PKDINST and choose the Customize Colors option from
  349.          the main menu.
  350.           
  351.          The Normal Text and Inverse Video data are displayed
  352.          in the colors currently installed in PKDATE.
  353.           
  354.          The un-installed version of PKDATE defaults to whatever
  355.          colors are present at the cursor when the program is invoked.
  356.          PKDINST provides an option on the Colors Menu to restore the
  357.          defaults.
  358.           
  359.          PKDINST displays the default colors in black and white until
  360.          they are changed.  The demo strings are displayed in the new
  361.          color after each selection.  The colors are not installed in
  362.          PKDATE until the user exits PKDINST.
  363.           
  364.          The user is prompted to enter the hexadecimal values for
  365.          the text or inverse video option.  The number is always
  366.          entered as a 2 digit number.  Results are unpredictable
  367.          if a single digit is entered.
  368.           
  369.          The left number is the Background color.
  370.          The right number is the Foreground color.
  371.           
  372.          07 = White text on black
  373.          17 = White text on blue
  374.          70 = Black text on white (inverse)
  375.           
  376.          The user may enter any value up to FF, if blink is wanted.
  377.          The color banners are fixed colors, and may not be changed by
  378.          the user.
  379.           
  380.          TEXT colors are for the file name matches displayed when
  381.          PKDATE executes.
  382.           
  383.          INVERSE colors are used for all error message displays.
  384.          All colors and blink may be selected.
  385.           
  386.           
  387.           
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                     Page 6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.          STANDARD FEATURES
  404.           
  405.           
  406.          --------------------
  407.          DOS Directory Format
  408.          --------------------
  409.          PKDATE displays all file data in the DOS directory format.
  410.          All file data exactly matches the DOS location and format
  411.          conventions.
  412.           
  413.          The file attributes are appended to the standard DOS display
  414.          as both a hex number and their associated name(s).
  415.           
  416.           
  417.           
  418.          --------------------------
  419.          Intelligent output display
  420.          --------------------------
  421.          PKDATE determines if DOS I/O redirection to a disk file or
  422.          printer is active.
  423.           
  424.          When redirection is active, all output is displayed a second
  425.          time using DOS.  All screen output except the author banners
  426.          are then output to the redirected device or file.
  427.           
  428.          For the screen, the color attribute found at the starting
  429.          cursor location is used.
  430.           
  431.          PKDATE automatically uses whichever video page number is
  432.          active at startup.  The user video configuration remains
  433.          unchanged.
  434.           
  435.           
  436.           
  437.          -------------------
  438.          Long screen support
  439.          -------------------
  440.          PKDATE uses the screen mode that is active at startup.
  441.          The 80x43 and 132x43 text screens are supported.
  442.          40 column mode is not supported.
  443.           
  444.           
  445.           
  446.          -------------------------------
  447.          Extended disk partition support
  448.          -------------------------------
  449.          PKDATE supports DOS disk partitions greater than 32mb.
  450.          It has been tested under DOS 4 and DOS 5.
  451.           
  452.           
  453.           
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                     Page 7
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.          IMPLEMENTATION
  470.           
  471.           
  472.          ---------------------
  473.          Command Line Examples
  474.          ---------------------
  475.           
  476.              Pkdate FILE.ZIP
  477.                   Scan the specified ZIP file.
  478.                   Set date of 'file.zip' to the highest member date.
  479.           
  480.           
  481.              Pkdate A*.ZIP
  482.                   Scan all ZIP files starting with 'A'.
  483.           
  484.           
  485.              Pkdate *.ZIP
  486.                   Scan all ZIP files.
  487.           
  488.           
  489.              Pkdate *.*
  490.                   Scan all files, get errors from all non-ZIP files.
  491.           
  492.           
  493.           
  494.              The user must always enter the .ZIP file extension.
  495.           
  496.           
  497.           
  498.           
  499.           
  500.           
  501.           
  502.           
  503.           
  504.           
  505.           
  506.           
  507.           
  508.           
  509.           
  510.           
  511.           
  512.           
  513.           
  514.           
  515.           
  516.           
  517.           
  518.           
  519.           
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                     Page 8
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.          IMPLEMENTATION
  536.           
  537.           
  538.          --------------
  539.          Technical Data
  540.          --------------
  541.          Screen performance has been improved by utilizing direct
  542.          screen writes.  Snow prevention is implemented only when
  543.          the CGA card is detected.
  544.           
  545.          PKDATE is written entirely in Turbo Assembler v2.5.
  546.           
  547.           
  548.           
  549.          ---
  550.          PIF
  551.          ---
  552.          PKDATE is 'ill behaved' in screen management functions
  553.          as direct screen writes are used.
  554.           
  555.          No vectors are taken over.
  556.           
  557.           
  558.           
  559.          --------------
  560.          DOS ERRORLEVEL
  561.          --------------
  562.          0 - No errors
  563.          1 - Failed
  564.           
  565.           
  566.           
  567.           
  568.           
  569.           
  570.           
  571.           
  572.           
  573.           
  574.           
  575.           
  576.           
  577.           
  578.           
  579.           
  580.           
  581.           
  582.           
  583.           
  584.           
  585.           
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                     Page 9
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.          SUPPORT
  602.           
  603.           
  604.          -----------
  605.          BUG Reports
  606.          -----------
  607.          Bug reports are welcomed.
  608.           
  609.          1)  Make/Version of DOS
  610.          2)  Copy of AUTOEXEC.BAT and CONFIG.SYS
  611.          3)  Names of TSRs if any, that are loaded
  612.           
  613.          Attempt to diagnose any bugs by unloading all TSRs and
  614.          start with as simple a system as possible.
  615.           
  616.           
  617.           
  618.          ------------
  619.          Registration
  620.          ------------
  621.          Please fill out the enclosed ORDER.FRM.
  622.           
  623.          Bruce Gavin
  624.          CompuServe: 70137,3244
  625.          GEnie     : B.GAVIN
  626.           
  627.           
  628.           
  629.          ----------
  630.          BBS System
  631.          ----------
  632.          Online Reference BBS:
  633.          (719) 380-9095 (voice)
  634.          (719) 591-0302 24 hours,
  635.          9600 v.42bis / 8N1
  636.           
  637.          Programmers Online Reference Guides
  638.          Norton Guide databases
  639.          Home of ALTER, FIND, ET, FRESHEN, and other fine utilities.
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                                     Page 10
  658.  
  659.  
  660.  
  661.