home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / busi / zlog14.zip / ZLOG.DOC < prev    next >
Text File  |  1990-09-01  |  119KB  |  3,492 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                      Z L O G
  13.                                    release 1.4
  14.  
  15.  
  16.                          Almost the best PC log utility
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.                              U s e r ' s  G u i d e
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                (C) Copyright 1989-90, Zoran Milenovic & Associates
  36.                                All Rights Reserved
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                           Zoran Milenovic & Associates
  49.                                  P.O.Box  409311
  50.                                Chicago,  IL  60640
  51.                                  (312) 275-0029
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                 They discovered a cure for apathy.  Nobody cared.
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.        Trademark notices
  95.  
  96.  
  97.        dBASE             is a trademark of Ashton-Tate Corp.
  98.        DESQview          is a trademark of Quarterdeck Office Systems.
  99.        IBM               is a trademark of International Business Machines Corp.
  100.        Lotus-123         is a trademark of Lotus Development Corp.
  101.        MS-DOS            is a trademark of Microsoft Corp.
  102.        PC-MOS/386        is a trademark of The Software Link Inc.
  103.        PK(UN)ZIP         is a trademark of PKware Inc.
  104.        Software Carousel is a trademark of SoftLogic Solutions
  105.        ZLOG              is a trademark of ZM & Associates
  106.  
  107.  
  108.        Date printed:            September 1, 1990
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                                LIMIT OF LIABILITY
  120.  
  121.         THIS  SOFTWARE IS PROVIDED 'AS IS' WITHOUT WARRANTY OF  ANY  KIND
  122.         (EXPRESSED  OR IMPLIED).  THE ENTIRE RISK AS TO THE  QUALITY  AND
  123.         PERFORMANCE  OF THIS SOFTWARE IS WITH YOU.  SHOULD  THE  SOFTWARE
  124.         PROVE  DEFECTIVE OR INCORRECT, YOU ASSUME THE ENTIRE COST OF  ALL
  125.         NECESSARY  REPAIR,  SERVICING OR ANY OTHER DAMAGE.  IN  NO  EVENT
  126.         SHALL  ZORAN MILENOVIC & ASSOCIATES (OR ITS DISTRIBUTORS) BE  LI-
  127.         ABLE  FOR  ANY  LOSS OF PROFIT OR  ANY  OTHER  COMMERCIAL  DAMAGE
  128.         CAUSED BY THE USE OF THIS PRODUCT.
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.                        This page intentionally left blank
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.                             Table of Contents
  149.  
  150.  
  151.  
  152.  
  153.         About the product . . . . . . . . . . . . . . . . . . . . 1
  154.  
  155.         Quick start . . . . . . . . . . . . . . . . . . . . . . . 3
  156.  
  157.         Install . . . . . . . . . . . . . . . . . . . . . . . . . 5
  158.             Setup . . . . . . . . . . . . . . . . . . . . . . . . 5
  159.             Error messages. . . . . . . . . . . . . . . . . . . . 13
  160.  
  161.         Running ZLOG. . . . . . . . . . . . . . . . . . . . . . . 15
  162.             How to activate ZLOG. . . . . . . . . . . . . . . . . 15
  163.             Command line switches and parameters. . . . . . . . . 15
  164.             Process options screen. . . . . . . . . . . . . . . . 23
  165.             Program levels. . . . . . . . . . . . . . . . . . . . 25
  166.             Report. . . . . . . . . . . . . . . . . . . . . . . . 26
  167.             Exporting log records . . . . . . . . . . . . . . . . 27
  168.             Error messages. . . . . . . . . . . . . . . . . . . . 29
  169.  
  170.         Sign ON/OFF using ZS. . . . . . . . . . . . . . . . . . . 35
  171.             ZS - ZLOG companion . . . . . . . . . . . . . . . . . 35
  172.             Setting up the operator ID table. . . . . . . . . . . 35
  173.             Command line. . . . . . . . . . . . . . . . . . . . . 36
  174.             Error messages. . . . . . . . . . . . . . . . . . . . 37
  175.  
  176.         Useful hints. . . . . . . . . . . . . . . . . . . . . . . 39
  177.             Log file maintenance. . . . . . . . . . . . . . . . . 39
  178.             Multiple log files. . . . . . . . . . . . . . . . . . 39
  179.             Multiple log history files. . . . . . . . . . . . . . 40
  180.             Processing multiple job account numbers . . . . . . . 41
  181.             Delete 'idle' records . . . . . . . . . . . . . . . . 42
  182.             Reducing size of the log file . . . . . . . . . . . . 42
  183.             Running 'menu' program after sign ON. . . . . . . . . 43
  184.  
  185.         ZLOG in multi-tasking environment . . . . . . . . . . . . 45
  186.  
  187.         Incompatibility problems. . . . . . . . . . . . . . . . . 47
  188.  
  189.         Word about security and IRS . . . . . . . . . . . . . . . 49
  190.  
  191.         Getting help. . . . . . . . . . . . . . . . . . . . . . . 51
  192.  
  193.         User feedback form. . . . . . . . . . . . . . . . . . . . 52
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.                           This page intentionally left blank
  204.  
  205.  
  206.  
  207.                                                         About the product
  208.  
  209.  
  210.  
  211.         About the product
  212.  
  213.  
  214.              ZLOG  is a log utility designed to keep track of  everything
  215.              you  have done on your PC.  It even logs the amount of  time
  216.              your PC was idle.  Every step is recorded in ZLOG's log file
  217.              and you are given the option of printing, exporting,  delet-
  218.              ing  or moving log records to a log history file.   You  can
  219.              create more than one history file - by an operator ID, by an
  220.              account  number  or project you have done, by a  date  range
  221.              (weekly, monthly, quarterly, yearly.  .  .  ) etc.  Having a
  222.              log  file  gives you a detailed recording of the  amount  of
  223.              time you spent doing computer work.
  224.  
  225.              ZLOG does not record use of DOS internal commands, such  as:
  226.              CLS, DIR, TYPE etc.  It records only external commands (your
  227.              applications and other programs).  ZLOG, also, ignores  com-
  228.              mands  that result in a 'Bad command or file  name'  message
  229.              from DOS.
  230.  
  231.              Automatic recovery allows ZLOG to gracefully recover if  its
  232.              own log file is accidentally deleted in the middle of a ses-
  233.              sion.  It just creates a new one, picking up right where  if
  234.              left off in the old one.
  235.  
  236.              ZLOG has three security levels (or no security at all - lev-
  237.              el 0):
  238.  
  239.                   level 1   print reports or export log records
  240.                   level 2   change of active operator ID, active job  ac-
  241.                             count number, active log file name or maximum
  242.                             log level
  243.                   level 3   delete  or move log records to history  file,
  244.                             UNinstall
  245.  
  246.              Operator on each level can do his/her own functions, as well
  247.              as  the functions from the lower levels.  Each level  has  a
  248.              password assigned to it at the installation time.  Passwords
  249.              from higher levels are valid for lower levels also.  If  you
  250.              want fewer persons to have access to log data or ZLOG's  ac-
  251.              tions select this feature in the installation procedure.
  252.  
  253.              ZLOG  is  transparent to you.  You will not notice  any  de-
  254.              crease in performance of your computer.  You can log differ-
  255.              ent  jobs under different job account numbers, and  changing
  256.              job account numbers is simple and fast.  You just tell  ZLOG
  257.              which account number to use from now on.
  258.  
  259.              When  you  are ready to analyze your work,  tell  ZLOG  what
  260.              range of records to process. Specify if you want to see glo-
  261.              bal figures (only total lines) or a detailed report.  Selec-
  262.  
  263.  
  264.  
  265.                                      - Page 1 -
  266.  
  267.  
  268.  
  269.         ZLOG release 1.4 User's Guide
  270.  
  271.  
  272.  
  273.              tion criteria can be:
  274.  
  275.                   1.        By  operator ID, or any combination of all  3
  276.                             characters  in operator ID, including  'wild-
  277.                             cards'
  278.  
  279.                   2.        By job account number(s), or any  combination
  280.                             of   all   16  characters  in   job   account
  281.                             number(s), including 'wildcards'
  282.  
  283.                   3.        By  program (phase) name, or any  combination
  284.                             of all 8 characters in program name,  includ-
  285.                             ing 'wildcards'
  286.  
  287.                   4.        By  date and time range (FROM  date/time,  TO
  288.                             date/time)
  289.  
  290.                   5.        By all 4 above categories combined
  291.  
  292.              Report  can  be viewed on the screen, send to a  disk  ASCII
  293.              file or printed on the printer.  Log records can be,  alter-
  294.              natively,   exported onto disk file and uploaded  into  your
  295.              spreadsheet or database program.
  296.  
  297.              Context-sensitive help is just a keystroke away.  If you get
  298.              stuck press F1 to get more information about the field  cur-
  299.              sor is resting on.
  300.  
  301.              ZLOG has a sign-on/sign-off module.  You can define as  many
  302.              as 128 operators with their passwords (changeable by the op-
  303.              erator at any time later), specific job accounts,  different
  304.              log file names and different maximum log levels.
  305.  
  306.              ZLOG is written in Microsoft Macro Assembler 5.1 and is  un-
  307.              beatable  in speed.  In resident mode it requires  a  little
  308.              bit  more than 2K of main memory.  It runs on IBM PC  family
  309.              or compatible and requires MS-DOS 3.00 or later.  We  recom-
  310.              mend use of a hard disk.  ZLOG needs to access its log  file
  311.              every  time any of your programs is  1) run and   2)  ended.
  312.              It is compatible with most LANs.
  313.  
  314.              ZLOG  is distributed in ZIP compressed format.   Compressing
  315.              software  used is wonderful PKware's  product  PKZIP/PKUNZIP
  316.              (Thanks Phil).
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                      - Page 2 -
  328.  
  329.  
  330.  
  331.                                                               Quick start
  332.  
  333.  
  334.  
  335.         Quick start
  336.  
  337.  
  338.              To have ZLOG up and running you have to do these steps:
  339.  
  340.              1.   Switch to your temporary subdirectory, copy ZL.EXE from
  341.                   your distribution diskette  and uncompress ZLOG package
  342.                   (type:  ZL).
  343.              2.   Run installation program.  At DOS prompt type:
  344.  
  345.                             INSTALL
  346.  
  347.              3.   Press  F2 to start installation  procedure.   INSTALL's
  348.                   default options are suitable for most computer configu-
  349.                   rations.
  350.              4.   Press 'n' when asked to test printer features.
  351.              5.   ZLOG is installed at this point.  Activate it.  At  DOS
  352.                   prompt type:
  353.  
  354.                             ZLOG
  355.  
  356.                   From  now  on  everything you do will  be  logged  into
  357.                   ZLOG's  default log  file  ([current-disk]:\SYSTEM.LOG)
  358.                   using default options (no operator ID, no account  num-
  359.                   ber, log level 15).
  360.              6.   Run some of your applications (programs) as usual.
  361.              7.   To see your PC activity, at DOS prompt type:
  362.  
  363.                             ZLOG  /P
  364.  
  365.              8.   At  ZLOG's  process screen press F2  (print  function).
  366.                   Disregard  message at the bottom of the  screen  ('War-
  367.                   ning: Log history file is empty!').
  368.              9.   ZLOG  will  now create the report and send  it  to  the
  369.                   screen.  Alternatively, you can send it to a disk  file
  370.                   or directly to a printer.
  371.              10.  Now, if you want, you can UNinstall ZLOG from the memo-
  372.                   ry.  At DOS prompt type:
  373.  
  374.                             ZLOG  /U
  375.  
  376.  
  377.  
  378.              This  is  the shortest way to install, run and  get  results
  379.              from ZLOG.  We recommend that later you read the manual  and
  380.              reinstall ZLOG with modifications to suit your needs.   ZLOG
  381.              is full of features that you should take advantage of.  Once
  382.              you  get familiarized with ZLOG's commands and  capabilities
  383.              you will see that it is easy to understand and easy to use.
  384.  
  385.  
  386.  
  387.  
  388.  
  389.                                      - Page 3 -
  390.  
  391.  
  392.  
  393.         ZLOG release 1.4 User's Guide
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.                           This page intentionally left blank
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.                                      - Page 4 -
  452.  
  453.  
  454.  
  455.                                                                   Install
  456.  
  457.  
  458.  
  459.         Install
  460.  
  461.  
  462.              ZLOG  package, distributed by the author to  the  registered
  463.              users,  comes on a single 5 1/4 or 3 1/2 inch  diskette  la-
  464.              beled  'ZLOG release x.xx sn. yy-yyy' where x.xx is  release
  465.              number and 'yy-yyy' is a serial number.
  466.  
  467.              ZLOG package contains these files:
  468.  
  469.                   -    README         Information
  470.                   -    REGISTER       Registration Form
  471.                   -    ZLOG.DOC       User's Guide
  472.                   -    INSTALL.EXE    Installation Program
  473.                   -    ZLOG.COM       Main Phase
  474.                   -    ZLOG00.OVR     Overlay Phase I
  475.                   -    ZLOG10.OVR     Overlay Phase II
  476.                   -    ZS.EXE         Sign on/off module (optional)
  477.                   -    !EMPTY.LOG     Empty (skeleton) log file
  478.  
  479.              Before you do anything, please make a copy of the ZLOG  dis-
  480.              tribution  diskette and store it in a safe place.   You  can
  481.              use the DOS COPY command.  To install ZLOG onto your comput-
  482.              er you have to run installation program.  Type:
  483.  
  484.                        INSTALL
  485.  
  486.              Installation  program is straight forward and simple.   Con-
  487.              text-sensitive help is just a keystroke away (F1).  Detailed
  488.              description of installation procedure is in the next section
  489.              ('Setup').
  490.  
  491.  
  492.  
  493.         Setup
  494.  
  495.  
  496.              The  installation  procedure uses three  different  screens.
  497.              You can switch back and forth using PgUp and PgDn keys.
  498.  
  499.  
  500.              Screen #1
  501.  
  502.  
  503.              ***  YOUR  NAME.  Enter your name or name of  your  company.
  504.              This field will be printed on report in the upper left  cor-
  505.              ner.   Once entered, it cannot be changed anymore.   If  the
  506.              name is already there, then the cursor will be positioned on
  507.              the next field (below).
  508.  
  509.  
  510.  
  511.  
  512.  
  513.                                      - Page 5 -
  514.  
  515.  
  516.  
  517.         ZLOG release 1.4 User's Guide
  518.  
  519.  
  520.  
  521.              *** HISTORY FILE NAME.  Type in the full path and file  name
  522.              for  the log history file.  The disk drive must be  included
  523.              in the specification.
  524.  
  525.                   Example:  C:\ARCHIVE\HISTORY.LOG
  526.  
  527.              You  can  move into this history file any range  of  records
  528.              from  the  log file.  This will be the default  log  history
  529.              file  name for ZLOG process function.  It can  be  overkeyed
  530.              when you want to process it.  You might want to have differ-
  531.              ent  log history files for each project you are working  on.
  532.              You can have, also, separate log history file for each quar-
  533.              ter  of the year (or for each year).  You also may  want  to
  534.              keep  these files on separate floppy disks.  It is  entirely
  535.              up to you how you want to organize your log history data.
  536.  
  537.              File !EMPTY.LOG (log skeleton file on distribution diskette)
  538.              can  be copied and renamed to history file name(s)  as  many
  539.              times as you want.
  540.  
  541.              Do  not specify .$$$ as a file extension.  ZLOG uses it  for
  542.              its own work (temporary) files.
  543.  
  544.  
  545.              ***  REPORT FILE NAME.  Type in the full path and file  name
  546.              for  the log report disk file ('soft' copy of  the  report).
  547.              The disk drive must be included in the specification.
  548.  
  549.                   Example:  C:\WORK\REPORT.TXT
  550.  
  551.              You can browse and print this file using any text/word proc-
  552.              essor.  This is pure ASCII file.
  553.  
  554.              Do  not specify .$$$ as a file extension.  ZLOG uses it  for
  555.              its own work (temporary) files.
  556.  
  557.  
  558.              ***  EXPORT FILE NAME.  Type in the full path and file  name
  559.              for  exported log records.  The disk drive must be  included
  560.              in the specification.
  561.  
  562.                   Example:  C:\WORK\EXPORT.DIF
  563.  
  564.              Later  on you can import this file into your spreadsheet  or
  565.              database program.
  566.  
  567.              Do  not specify .$$$ as a file extension.  ZLOG uses it  for
  568.              its own work (temporary) files.
  569.  
  570.  
  571.              *** ZLOG DESTINATION.  This is the directory where you  want
  572.  
  573.  
  574.  
  575.                                      - Page 6 -
  576.  
  577.  
  578.  
  579.                                                                   Install
  580.  
  581.  
  582.  
  583.              INSTALL  to  put ZLOG package.  It might be  any  directory.
  584.              Specify the full path name including disk drive.
  585.  
  586.                   Example:  C:\ZLOG
  587.  
  588.              After  install is complete, you will see five new  files  in
  589.              that  directory:  ZLOG.COM,  ZLOG00.OVR, ZLOG10.OVR,  ZS.EXE
  590.              and process history file ZLOGHIST.DAT.
  591.  
  592.                   Note:     If  you  later want to move ZLOG  package  to
  593.                             another subdirectory, just do a straight COPY
  594.                             from  old subdirectory to the new one.   ZLOG
  595.                             will  always look in its 'home'  subdirectory
  596.                             for    overlay   phases    (ZLOG00.OVR    and
  597.                             ZLOG10.OVR) and process history file  (ZLOGH-
  598.                             IST.DAT).
  599.  
  600.                   Note:     Distribution  diskette  also  contains  empty
  601.                             (skeleton) log file !EMPTY.LOG.  You may want
  602.                             to copy this file to your destination  direc-
  603.                             tory as well.  Later on whenever you need  to
  604.                             create new log history file (for example  new
  605.                             file for each quarter) you can just copy this
  606.                             empty log file and rename it.
  607.  
  608.  
  609.              Screen #2
  610.  
  611.  
  612.              ***  OUTPUT PORT.  Output port for your printer.   This  de-
  613.              pends  on whether you have a parallel or a  serial  printer.
  614.              Values  for  a parallel printer are:  PRN,  LPT1,  LPT2  and
  615.              LPT3.   Values for a serial printer are:  COM1,  COM2,  COM3
  616.              and COM4.  Most likely you have a parallel printer connected
  617.              to port #1.  If this is true, leave the default value  (PRN)
  618.              in  this field.  Later you will be able to test all  options
  619.              that you have specified for your printer.  If you find  that
  620.              some  printer related fields are wrong, just go back to  the
  621.              installation screen #2 and correct it.
  622.  
  623.  
  624.              ***  LINE  WIDTH.  This is the line width  for  the  report.
  625.              There are two versions of report:  80 and 132 column.   They
  626.              show the same data, but 132 column version is more readable.
  627.              It has more spaces between columns and shows time fields  as
  628.              HH:MM:SS  as  opposed to the 80 column version  which  shows
  629.              time fields as HH:MM.
  630.  
  631.              If  your printer does NOT have 'condensed print' (16.6  CPI)
  632.              feature specify:
  633.  
  634.  
  635.  
  636.  
  637.                                      - Page 7 -
  638.  
  639.  
  640.  
  641.         ZLOG release 1.4 User's Guide
  642.  
  643.  
  644.  
  645.                        for  8" paper  -   80
  646.                        for 11" paper  -  132
  647.  
  648.              If your printer DOES have 'condensed print' (16.6 CPI)  fea-
  649.              ture specify:
  650.  
  651.                        for  8" paper  -  132
  652.                        for 11" paper  -  132
  653.  
  654.  
  655.              *** LINES/PAGE.  Number of lines per page.  This depends  on
  656.              the  size of the paper you use.  Regular spacing is 6  lines
  657.              per  inch.   Therefore 8" x 11" paper (most common)  has  66
  658.              lines  per page.  If you have a laser printer and  you  want
  659.              reports  to  be in 'landscape' mode (11" x  8"  paper)  then
  660.              specify 48 lines per page.
  661.  
  662.  
  663.              ***  SPACES/TAB.  If you specify T(ab) then  Tab  characters
  664.              will be inserted into 'soft' copy of the reports, instead of
  665.              spaces (see option *** S/D/P/E below).  All word  processors
  666.              and most of the text processors will process this file  cor-
  667.              rectly  either way.  If you use the T(ab) option  you  might
  668.              save some disk space when you produce 'soft' report.
  669.  
  670.                   Note:     To  print 'soft' copy of the report you  also
  671.                             can use DOS COPY command.  Type:  COPY  file-
  672.                             name  PRN
  673.  
  674.  
  675.              ***  SET.  This command (called 'ESCape sequence') will  set
  676.              your  printer to the correct printing mode.  It might  be  a
  677.              'condensed  print'  mode or a 'landscape'  mode  (for  laser
  678.              printers).  If your printer does not have these features, do
  679.              not specify anything here.  This command will be sent to the
  680.              printer right after opening of the printer file.  Enter this
  681.              field  using hexadecimal notation  e.g. '<ESC>*1'  enter  as
  682.              '1B2A31'.  Please consult manual for your printer.
  683.  
  684.  
  685.              *** RESET.  This is reset command for your printer.  It will
  686.              put  it  back  to  'normal' mode (same mode  as  it  was  in
  687.              before).  This command will be sent to the printer right be-
  688.              fore  closing of the printer file.  Enter this  field  using
  689.              hexadecimal notation  e.g. '<ESC>E' enter as '1B45'.  Please
  690.              consult manual for your printer.
  691.  
  692.  
  693.              **** DELIM.  ZLOG has a possibility of exporting log records
  694.              (or just total amounts) into disk ASCII file in format suit-
  695.              able  for import into your spreadsheet or database  program.
  696.  
  697.  
  698.  
  699.                                      - Page 8 -
  700.  
  701.  
  702.  
  703.                                                                   Install
  704.  
  705.  
  706.  
  707.              This  character  is field delimiter (it  delimits  different
  708.              fields).  For Lotus-123 default field delimiter is comma(,).
  709.  
  710.                   Example:  field1,field2,field3, ...
  711.  
  712.  
  713.              ****   NUM.  This character surrounds numeric fields in  the
  714.              record being exported.  For Lotus-123 there is none.
  715.  
  716.                   Example:  field1,050190,field3, ...
  717.  
  718.  
  719.              ****  CHAR.  This character surrounds alphanumeric fields in
  720.              the record being exported.  For Lotus-123 default  delimited
  721.              for this field type is quote (").
  722.  
  723.                   Example:  "opID","ACCT#1111",050190, ...
  724.  
  725.                   Note:     For Lotus-123 import function is:  /   F(ile)
  726.                             I(mport)   N(umbers) and a file  name  (Lotus
  727.                             default extension for import file is .PRN).
  728.  
  729.  
  730.              ****  IDLE.   If this switch is set to Y(es),  idle  periods
  731.              (when computer is doing nothing) will be logged  (recorded).
  732.              Set it to N(o) to ignore idle periods (ZLOG will not log  it
  733.              and  log file will be approx. 40% smaller).  Value  of  this
  734.              switch is default for ZLOG print/export function (include or
  735.              do not include idle records in the report).  It can be over-
  736.              keyed in the process options screen.
  737.  
  738.  
  739.              ***  TOTAL.   If you set it to Y(es), reports  (or  exported
  740.              file)  will contain only lines with totals.  Set it to  N(o)
  741.              to  get detailed report (all steps).  This value is  default
  742.              value  for ZLOG print/export function, but can be  overkeyed
  743.              in the process options screen.
  744.  
  745.  
  746.              ***  S/D/P/E.   Default  log  report  destination.   Specify
  747.              S(creen) for screen output.  Specify D(isk) for 'soft'  copy
  748.              or  P(rinter) for 'hard' copy of a report.  Soft  copy  will
  749.              send report to the disk ASCII file rather than to a printer.
  750.              Then  you  can browse it (and optionally  print)  using  any
  751.              word/text processor.  You can, also, print it using DOS COPY
  752.              command (type:  COPY file-name PRN).  Hard copy goes direct-
  753.              ly to the printer.  Specify E(xport) to export log  records.
  754.              Export  function produces ASCII file suitable for  importing
  755.              into   your  spreadsheet  or  database  programs.    Specify
  756.              E(xport)  if you will be exporting log records most  of  the
  757.              time.   This  value is default value for  ZLOG  print/export
  758.  
  759.  
  760.  
  761.                                      - Page 9 -
  762.  
  763.  
  764.  
  765.         ZLOG release 1.4 User's Guide
  766.  
  767.  
  768.  
  769.              function,  but  can  be overkeyed  on  the  process  options
  770.              screen.
  771.  
  772.  
  773.              ***  DATES.  This will specify default range of dates  (FROM
  774.              and  TO) for selecting the records.  Options  are  W(eekly),
  775.              M(onthly) and Q(uarterly).
  776.  
  777.              W(eekly)  FROM date = current week, Monday 12:00 am
  778.                        TO   date = current date, current time
  779.              M(onthly) FROM date = current month,  1st day 12:00 am
  780.                        TO   date = current date, current time
  781.              Q(uarterly) FROM date = current quarter,  1st day 12:00 am
  782.                        TO   date = current date, current time
  783.  
  784.              This  value will be default for ZLOG print/export  function,
  785.              but can be overkeyed on the process options screen.
  786.  
  787.  
  788.              ***  SECUR.   Security switch.  If it is set  to  N(o)  that
  789.              means  security is OFF (level 0, no security).  If you  want
  790.              to  have security feature ON, set this switch to Y(es).   It
  791.              allows you to have three different security levels that  can
  792.              be accessed only by keying in a password.  They are:
  793.  
  794.                   level 1   print reports or export log records
  795.                   level 2   change of active operator ID, active job  ac-
  796.                             count number, active log file name or maximum
  797.                             log level
  798.                   level 3   delete  or move log records to history  file,
  799.                             UNinstall
  800.  
  801.              You can specify (on screen #3) password for any (or all)  of
  802.              these  three security levels.  If you omit password for  any
  803.              of  the lower levels then there is no security checking  for
  804.              those levels.  For example, if you specify password for lev-
  805.              el  3 only then everybody will be able to do everything  ex-
  806.              cept level 3 functions.
  807.  
  808.                   Note:     If this switch is set to Y(es) and all  three
  809.                             passwords  (screen  #3) are blank  then  this
  810.                             switch  will be ignored.  It will be  treated
  811.                             as it was set to N(o).
  812.  
  813.  
  814.              *** COLOR.  ZLOG process option screen's default colors  are
  815.              cyan  (foreground)  on  blue (background).   If  you  prefer
  816.              black/white,  or if you experience troubles with your  moni-
  817.              tor, set this switch to M(ono).
  818.  
  819.  
  820.  
  821.  
  822.  
  823.                                      - Page 10 -
  824.  
  825.  
  826.  
  827.                                                                   Install
  828.  
  829.  
  830.  
  831.              ***  BIOS.   If this switch is set to Y(es), ZLOG  will  use
  832.              BIOS  routines to write to the screen.  Set it to  N(o)  and
  833.              ZLOG will use faster memory-mapped routines to write to  the
  834.              screen.
  835.  
  836.                   Note:     We RECOMMEND to set this switch to N(o).
  837.  
  838.  
  839.              ***  PROGRAM LEVEL.  Maximum program level to  be  recorded.
  840.              Must be 1-15.  For more information about program levels see
  841.              section 'Program levels', chapter 'Running ZLOG'.
  842.  
  843.  
  844.              Screen #3
  845.  
  846.  
  847.              ***  LEVEL 1 PASSWORD.  If you specify a password here  then
  848.              whenever you want to print a report (or export log records),
  849.              you will be asked to enter it.  If you do not want it, leave
  850.              this field blank.
  851.  
  852.  
  853.              *** LEVEL 2 PASSWORD.  By specifying a password here,  when-
  854.              ever  you want to change active operator ID, active log  ac-
  855.              count  number or active log file you will be asked to  enter
  856.              it.   If you do not want it, leave this field blank.  If  it
  857.              is blank, default is level 1 password.
  858.  
  859.                   Note:     If ZLOG is not active it will install  itself
  860.                             in the memory without asking you for a  pass-
  861.                             word.  If not specified, operator ID, job ac-
  862.                             count number or log file used will be default
  863.                             (blank,   blank  and  [current   drive]:\SYS
  864.                             TEM.LOG).  Next time you want to change oper-
  865.                             ator  ID,  job account or log file  name  you
  866.                             will be asked for a password.
  867.  
  868.  
  869.              ***  LEVEL 3 PASSWORD.  If you specify a password here  then
  870.              whenever  you want to delete or move log records,  or  UNin-
  871.              stall  ZLOG  you will be asked to enter it.  If you  do  not
  872.              want it, leave this field blank.  If it is blank, default is
  873.              level 2 password.
  874.  
  875.                   Note:     If all three passwords are blank then securi-
  876.                             ty switch (screen #2) will be ignored -  same
  877.                             as if it was set to N(o).
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.                                      - Page 11 -
  886.  
  887.  
  888.  
  889.         ZLOG release 1.4 User's Guide
  890.  
  891.  
  892.  
  893.              Initiate installation
  894.  
  895.  
  896.              Now  everything is set and you can press F2 to initiate  in-
  897.              stallation procedure.
  898.  
  899.              You will be asked if you want to test printer specifications
  900.              you  entered earlier.  If you answer Y(es), a full  page  of
  901.              asterisks ('*') will be printed.  Look at the printout.   If
  902.              it  does not look right, answer Y(es) to the question:   'Do
  903.              you  want to go back to the install?'.    Otherwise  proceed
  904.              with installation.
  905.  
  906.              INSTALL  will  now do the actual installation  of  ZLOG.COM,
  907.              ZLOG00.OVR, ZLOG10.OVR and ZS.EXE into destination  directo-
  908.              ry.  Empty log history and process history files are  creat-
  909.              ed, and ZLOG informs you if everything is OK.
  910.  
  911.              ZLOG  is  installed at this point.  If you run DIR  of  your
  912.              destination directory (specified in installation screen  #1)
  913.              you will see five new files:
  914.  
  915.                   ZLOG.COM       main phase
  916.                   ZLOG00.OVR     overlay phase I
  917.                   ZLOG10.OVR     overlay phase II
  918.                   ZS.EXE         sign on/off module
  919.                   ZLOGHIST.DAT   process history file
  920.  
  921.              If your destination directory is different that your current
  922.              directory, you can, at this point, delete all ZLOG's  files.
  923.              You  might want to copy INSTALL.EXE to your destination  di-
  924.              rectory  if you decide to change some of the  options  later
  925.              (INSTALL  'remembers' everything you specified so far).   Of
  926.              course, any time later you can reinstall ZLOG from  original
  927.              distribution disk.
  928.  
  929.                   Note:     You can run INSTALL program as many times  as
  930.                             you  want  until you set  correctly  all  the
  931.                             values.   On the second and  subsequent  runs
  932.                             INSTALL will ask you to sign ON as System Ad-
  933.                             ministrator  (operator SYS).  This is just  a
  934.                             little security feature.  Nobody, except Sys-
  935.                             tem Administrator, is suppose to run  INSTALL
  936.                             after first (initial) run.
  937.                             If you do not have ZLOG's sign ON/OFF  module
  938.                             (ZS.EXE) INSTALL will not expect SYS signon.
  939.  
  940.              The next step will be to include ZLOG in AUTOEXEC.BAT  file.
  941.              You  can do this using your text/word processor.   To  learn
  942.              how,  see  chapter 'Running ZLOG' section 'How  to  activate
  943.              ZLOG'.   If your computer is running in multi-user  environ-
  944.  
  945.  
  946.  
  947.                                      - Page 12 -
  948.  
  949.  
  950.  
  951.                                                                   Install
  952.  
  953.  
  954.  
  955.              ment  (such as PC-MOS/386 or LAN) or multi-tasking  environ-
  956.              ment  (such  as DESQview) or you are using  a  task-switcher
  957.              (such  as  Software Carousel) read chapter 'ZLOG  in  multi-
  958.              tasking environment'.
  959.  
  960.                   Note:     If  you  want later to move ZLOG  package  to
  961.                             another subdirectory, just do a straight COPY
  962.                             from  old subdirectory to the new one.   ZLOG
  963.                             will  always look in its 'home'  subdirectory
  964.                             for    overlay   phases    (ZLOG00.OVR    and
  965.                             ZLOG10.OVR) and process history file  (ZLOGH-
  966.                             IST.DAT).
  967.  
  968.  
  969.  
  970.         Error messages
  971.  
  972.  
  973.              INSTALL  performs few different tasks.  In case any kind  of
  974.              failure  function  code (FC) and return code  (RC)  is  dis-
  975.              played.   Most of these errors are possible only  in  multi-
  976.              user  environment  (such as PC-MOS/386 or LAN).  If  such  a
  977.              case, try to install ZLOG from scratch starting with  decom-
  978.              pression  of  distribution disk.  Make sure  that  no  other
  979.              tasks  (multi-tasking environment) are interfering with  in-
  980.              stallation procedure.
  981.  
  982.              If  the problem occurs again, write down function code  (FC)
  983.              and return code (RC) and call us at (312) 275-0029.
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.                                      - Page 13 -
  1010.  
  1011.  
  1012.  
  1013.         ZLOG release 1.4 User's Guide
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021.  
  1022.                           This page intentionally left blank
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.                                      - Page 14 -
  1072.  
  1073.  
  1074.  
  1075.                                                              Running ZLOG
  1076.  
  1077.  
  1078.  
  1079.         Running ZLOG
  1080.  
  1081.  
  1082.  
  1083.         How to activate ZLOG
  1084.  
  1085.  
  1086.              The  best  way not to forget to activate ZLOG is to  put  it
  1087.              into  your AUTOEXEC.BAT file.  This file is  executed  every
  1088.              time  you boot your system.  If your computer does not  have
  1089.              clock  battery  backup put ZLOG command line after  you  set
  1090.              correct date and time (usually with DATE and TIME commands).
  1091.  
  1092.              You  can run ZLOG from DOS prompt also.  When you  run  ZLOG
  1093.              for  the  first time after booting the system, it  leaves  a
  1094.              portion  of its own code in memory as a TSR  (terminate-and-
  1095.              stay-resident) program.  This program (little bit more  than
  1096.              2K  in size) is the actual 'working horse' of  the  package.
  1097.              It  invisibly works in the background.  You can  'uninstall'
  1098.              it (free up the memory occupied) at any time later.
  1099.  
  1100.              Simplest  way to activate ZLOG is to run it without any  pa-
  1101.              rameters.  Just type:
  1102.  
  1103.                        ZLOG
  1104.  
  1105.              and ZLOG will install itself in the memory using all default
  1106.              parameters:
  1107.  
  1108.                   -    no operator ID
  1109.                   -    no job account number
  1110.                   -    log file name [current-drive]:\SYSTEM.LOG
  1111.                   -    log level specified in installation procedure
  1112.  
  1113.              Later  you can run ZLOG with switch S(tatus) to  see  active
  1114.              parameters (type:  ZLOG /S).
  1115.  
  1116.                   Note:     If your computer is running in multi-user en-
  1117.                             vironment (such as PC-MOS/386 or LAN) or mul-
  1118.                             ti-tasking environment (such as DESQview)  or
  1119.                             you are using a task-switcher (such as  Soft-
  1120.                             ware  Carousel) read chapter 'ZLOG in  multi-
  1121.                             tasking environment'.
  1122.  
  1123.  
  1124.  
  1125.         Command line switches and parameters
  1126.  
  1127.  
  1128.              ZLOG's actions are controlled by the command line  switches.
  1129.              A  slash ('/') or dash ('-') separates these switches.   The
  1130.  
  1131.  
  1132.  
  1133.                                      - Page 15 -
  1134.  
  1135.  
  1136.  
  1137.         ZLOG release 1.4 User's Guide
  1138.  
  1139.  
  1140.  
  1141.              following switches are available:
  1142.  
  1143.                   /I   operator ID specification
  1144.                   /A   job account number specification
  1145.                   /F   log file name specification
  1146.                   /L   maximum program level to be logged
  1147.                   /O   display accepted options
  1148.                   /P   process log or log history file
  1149.                   /Q   quiet operation (no info messages)
  1150.                   /S   display status of ZLOG
  1151.                   /U   uninstall resident portion
  1152.  
  1153.              ZLOG  is  not case sensitive.  Spaces  are  allowed  between
  1154.              switches,   e.g.   ZLOG   /A=xxx    /Q   is  the   same   as
  1155.              ZLOG/a=xxx/q.   If you use dash ('-') as a switch  separator
  1156.              then  you must insert one blank between switches, e.g.  ZLOG
  1157.              -a=xxx  -q  is valid, but ZLOG-a=xxx-q is invalid.
  1158.  
  1159.  
  1160.              /I  Operator ID specification
  1161.  
  1162.  
  1163.              This switch specifies operator ID.  It can be 0-3 characters
  1164.              long (0=no operator ID).  When you process log file you will
  1165.              be  able to select records by specifying any combination  of
  1166.              the characters in operator ID.  Spaces and slashes ('/') are
  1167.              not allowed.  An equal sign ('=') after switch is required.
  1168.  
  1169.                   Example:  ZLOG /I=BJ
  1170.  
  1171.              If ZLOG was active at the time you issued this command, then
  1172.              the  old  operator ID will be changed to the new  one.   All
  1173.              steps from this point on will be recorded under the new  op-
  1174.              erator ID.
  1175.  
  1176.              If ZLOG was not active at the time this command was  issued,
  1177.              it will 'install' itself in the memory and start logging un-
  1178.              der this new operator ID.
  1179.  
  1180.              ZLOG informs you about actions taken unless /Q switch (quiet
  1181.              operation) is specified.
  1182.  
  1183.  
  1184.              /A  Job account specification
  1185.  
  1186.  
  1187.              With this switch you can specify different job account  num-
  1188.              bers for different jobs you are doing.  Job account  numbers
  1189.              can  be 0-16 characters long (0=no job account).   When  you
  1190.              process  log  file  you will be able to  select  records  by
  1191.              specifying any combination of characters in the job  account
  1192.  
  1193.  
  1194.  
  1195.                                      - Page 16 -
  1196.  
  1197.  
  1198.  
  1199.                                                              Running ZLOG
  1200.  
  1201.  
  1202.  
  1203.              number.   Design your job account naming conventions  having
  1204.              that  in mind.  Spaces and slashes ('/') are not allowed  in
  1205.              the job account number.  An equal sign ('=') after switch is
  1206.              required.
  1207.  
  1208.                   Example:  ZLOG /A=XYZ-BILLING
  1209.  
  1210.              This could mean that you are doing a billing project for XYZ
  1211.              company.   Later you will be able to see how much  time  you
  1212.              have spent doing billing for ALL the companies (by  specify-
  1213.              ing  '????billing' as a job account selection key).  To  see
  1214.              how  much time you have spent doing ALL the data  processing
  1215.              services  for XYZ company, you can specify 'xyz*' as  a  job
  1216.              account selection key.
  1217.  
  1218.              If ZLOG was active at the time you issued this command, then
  1219.              the  old job account number will be changed to the new  one.
  1220.              All steps from this point on will be recorded under the  new
  1221.              account number.
  1222.  
  1223.              If ZLOG was not active at the time this command was  issued,
  1224.              then  it will 'install' itself in the memory and start  log-
  1225.              ging under this new job account number.
  1226.  
  1227.              ZLOG  will inform you about actions taken unless  /Q  switch
  1228.              (quiet operation) is specified.
  1229.  
  1230.  
  1231.              /F  File name specification
  1232.  
  1233.  
  1234.              This switch allows you to specify the name of the log  file.
  1235.              This  means that you can have different log files  for  each
  1236.              project, or for each terminal.  If your computer is  running
  1237.              under  a multi-user operating system (or LAN)  we  recommend
  1238.              you to have different log files for each workstation (termi-
  1239.              nal).   This file is sort of 'dynamic' file (you can  create
  1240.              new log files any time).  Log history file is 'static'  file
  1241.              (you  cannot  create a new one on the fly, except  with  IN-
  1242.              STALL).  Yet, both files have the same structure.
  1243.  
  1244.              For  multi-user environments (such as PC-MOS/386 or LAN)  we
  1245.              recommend to have different log files for each terminal (ac-
  1246.              tive  task).  Otherwise concurrent updating of the log  file
  1247.              might  occur and you could loose log data.  In LAN  environ-
  1248.              ment  log file should be on the locally attached disk.   For
  1249.              more  information see chapter 'ZLOG in  multi-user  environ-
  1250.              ment'.
  1251.  
  1252.              An equal sign ('=') after switch is required.
  1253.  
  1254.  
  1255.  
  1256.  
  1257.                                      - Page 17 -
  1258.  
  1259.  
  1260.  
  1261.         ZLOG release 1.4 User's Guide
  1262.  
  1263.  
  1264.  
  1265.              You can specify full file name or just part of it.
  1266.  
  1267.                   Example:  ZLOG /F=C:\DATA\ABC.LOG
  1268.  
  1269.              This  means that current log file ABC.LOG is on drive C:  in
  1270.              subdirectory DATA.
  1271.  
  1272.              If ZLOG was active at the time you issued this command  then
  1273.              the old log file will be closed and the new one opened.   If
  1274.              it  does not exist it will be created.  From this point  on,
  1275.              log records will be written onto that (new) file.
  1276.  
  1277.              If ZLOG was not active at the time this command was  issued,
  1278.              then it will 'install' itself and start writing log  records
  1279.              into this file.
  1280.  
  1281.              If  you do not specify a file ('ZLOG /F='), the default  log
  1282.              file name is:
  1283.  
  1284.                   current-drive:\SYSTEM.LOG
  1285.  
  1286.              If you specify the drive only ('ZLOG /F=d:'), the file  name
  1287.              will be:
  1288.  
  1289.                   specified-drive:\current-subdir\SYSTEM.LOG.
  1290.  
  1291.              If   you  specify  the  drive  and  a  subdirectory   ('ZLOG
  1292.              /F=d:\data\'), the file name will be:
  1293.  
  1294.                   specified-drive:\specified-subdir\SYSTEM.LOG.
  1295.  
  1296.              ZLOG checks the file that you specify.  If the file does not
  1297.              exist, it creates a new one.  If it does exist it is checked
  1298.              for  a ZLOG's signature.  If the file exist and it is not  a
  1299.              log file, ZLOG will inform you about this and reject the re-
  1300.              quest.
  1301.  
  1302.              Do  not specify .$$$ as a file extension.  ZLOG uses it  for
  1303.              its own work (temporary) files.
  1304.  
  1305.              ZLOG  will inform you about actions taken unless  /Q  switch
  1306.              (quiet operation) is specified.
  1307.  
  1308.  
  1309.                   Note:     Automatic recovery allows ZLOG to  gracefully
  1310.                             recover  if its own log file is  accidentally
  1311.                             deleted in the middle of a session.  It  just
  1312.                             creates a new one, picking up right where  if
  1313.                             left off in the old one.  If the whole direc-
  1314.                             tory,  with the active log file,  is  deleted
  1315.                             ZLOG  automatically switches to  the  default
  1316.  
  1317.  
  1318.  
  1319.                                      - Page 18 -
  1320.  
  1321.  
  1322.  
  1323.                                                              Running ZLOG
  1324.  
  1325.  
  1326.  
  1327.                             log  file  name  [current-drive]:\SYSTEM.LOG.
  1328.                             From  that  point on this is the  active  log
  1329.                             file.
  1330.  
  1331.  
  1332.              /L  Maximum program level
  1333.  
  1334.  
  1335.              This  switch specifies maximum program level to  be  logged.
  1336.              It is two digit number in range from 1 to 15.  For  detailed
  1337.              information  about  the program level see  section  'Program
  1338.              levels'  later in this chapter.  An equal sign  ('=')  after
  1339.              switch is required.
  1340.  
  1341.                   Example:  ZLOG /L=15
  1342.  
  1343.              If ZLOG was active at the time you issued this command, then
  1344.              the  old logging level will be changed to the new one.   All
  1345.              steps  from  this point on will be recorded using  this  new
  1346.              level as a maximum.
  1347.  
  1348.                   Note:     Change maximum program level from DOS  prompt
  1349.                             (level  0)  ONLY!  If you run  some  program,
  1350.                             then  'shell  out' to DOS and run  ZLOG  with
  1351.                             this  option, you can get  unpredictable  re-
  1352.                             sults.
  1353.  
  1354.              If ZLOG was not active at the time this command was  issued,
  1355.              then  it will 'install' itself in the memory and start  log-
  1356.              ging using this level as a maximum.
  1357.  
  1358.              ZLOG  will inform you about actions taken unless  /Q  switch
  1359.              (quiet operation) is specified.
  1360.  
  1361.  
  1362.              /O  Display accepted options from the command line
  1363.  
  1364.  
  1365.              If  this switch is specified ZLOG will display  all  options
  1366.              accepted  from the command line.  This way you can check  if
  1367.              ZLOG  really  'understood' what you wanted.  This  might  be
  1368.              handy when you start using ZLOG.
  1369.  
  1370.                   Example:  ZLOG /O
  1371.  
  1372.              ZLOG  will reject this request if /Q (quiet  operation)  was
  1373.              specified.
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.                                      - Page 19 -
  1382.  
  1383.  
  1384.  
  1385.         ZLOG release 1.4 User's Guide
  1386.  
  1387.  
  1388.  
  1389.              /P  Process log or log history file
  1390.  
  1391.  
  1392.              Specifying  this switch you request from ZLOG to do  certain
  1393.              processing  on the log or log history file(s).  This  switch
  1394.              can  be specified with or without parameters.   All  missing
  1395.              parameters  will  be  replaced  with  their  default  values
  1396.              (specified  in the installation procedure).   If  parameters
  1397.              are present, an equal sign ('=') must follow /P switch.  Pa-
  1398.              rameters  must  be separated by commas  and  cannot  contain
  1399.              spaces or slashes ('/').  Parameters are:
  1400.  
  1401.                   - log file name
  1402.                   - log history file name
  1403.                   - report file name ('soft copy' of the report)
  1404.                   - export file name
  1405.                   - operator ID
  1406.                   - job account number or job account table file name
  1407.                   - program name
  1408.                   - from date
  1409.                   - from time
  1410.                   - to date
  1411.                   - to time
  1412.                   - process idle records switch
  1413.                   - total switch
  1414.                   - screen/disk/print/export switch
  1415.                   - action (type of processing):
  1416.  
  1417.                        F2        print/export specified range of log  re-
  1418.                                  cords
  1419.                        F3        move  specified range of log records  to
  1420.                                  log history file
  1421.                        F4        delete specified range of log records
  1422.                        Alt-F2    print/export specified range of log his-
  1423.                                  tory records
  1424.                        Alt-F4    delete  specified range of  log  history
  1425.                                  records
  1426.  
  1427.              For  more  information about these  parameters  see  section
  1428.              'Process options screen' later in this chapter.
  1429.  
  1430.              If any of the parameters is wrong or an action is not speci-
  1431.              fied, ZLOG switch itself into interactive mode.  Process op-
  1432.              tions screen pops up and you can correct the parameters  and
  1433.              choose the action.
  1434.  
  1435.                   Example:
  1436.  
  1437.                   ZLOG /P=abcd.log,,,,bj,xyz*,*,010188,,123188,,y,y,p,f2
  1438.  
  1439.              This  means:  print (f2) hard copy (p) of log  records  from
  1440.  
  1441.  
  1442.  
  1443.                                      - Page 20 -
  1444.  
  1445.  
  1446.  
  1447.                                                              Running ZLOG
  1448.  
  1449.  
  1450.  
  1451.              ABCD.LOG  file.   Process all records with  operator  ID  BJ
  1452.              (bj),  created  between 01/01/88 (010188) at 12:00  am  (de-
  1453.              fault) and 12/31/88 (123188) at 11:59 pm (default) which job
  1454.              account number starts with letters XYZ (xyz*).  Include  all
  1455.              programs (*), idle time (1st 'y') and print total lines only
  1456.              (2nd 'y').
  1457.  
  1458.                   Note:     In 'idle' log records program name is  blank.
  1459.                             Therefore  if you specify program name  as  a
  1460.                             blank, ZLOG will select only 'idle'  records.
  1461.                             This  might  be handy if you want  to  delete
  1462.                             'idle' records - see chapter 'Useful hints'.
  1463.  
  1464.              Log  and log history files have the same structure.  In  the
  1465.              example  above,  ABCD.LOG might be one of your  log  history
  1466.              files.  ZLOG does not care which file is which.  It will  do
  1467.              action  you  specified on the file you specified.   You  can
  1468.              switch  log  and log history file names and as long  as  you
  1469.              specify the right action, everything will be OK.
  1470.  
  1471.              ZLOG  has a possibility of processing up to 128 job  account
  1472.              numbers in a single pass through log (or log history)  file.
  1473.              Use  any  text/word  processor and  (in  non-document  mode)
  1474.              create plain ASCII file containing one line per each job ac-
  1475.              count  you  want to process.  For example:  if you  want  to
  1476.              process  job  accounts 'abc*', '?xyz'  and  'jbm-billing-??'
  1477.              this file should look like this:
  1478.  
  1479.                             abc*
  1480.                             ?xyz
  1481.                             jbm-billing-??
  1482.  
  1483.              Give  this  file  any name.  On the command line  (in  a  /P
  1484.              switch)  instead  of specifying single job  account  number,
  1485.              specify:   @file-name.  ZLOG checks the first  character  of
  1486.              job account number and if it is a '@' it considers remaining
  1487.              of  a job account string the filename.  Then it  reads  that
  1488.              file and load each line in the table.  You can specify up to
  1489.              128 different job account numbers.  If you specify more than
  1490.              128,  only  first 128 will be accepted and you  will  get  a
  1491.              warning message that job account table file was to big.
  1492.  
  1493.              In  the example above, assuming that job account table  file
  1494.              name is 'monthly.job', command line looks like this:
  1495.  
  1496.              ZLOG/P=abcd.log,,,,bj,@monthly.acc,*,010188,,123188,,y,y,p,f2
  1497.  
  1498.              If  you just specify '@' (ZLOG  /P=abcd.log,,bj,@,*,010188,,
  1499.              123188,,y,y,p,f2), first entry in the job account table will
  1500.              be filled up with all '?'.  This will match ANY job account.
  1501.              If you did not specify action on the command line, ZLOG will
  1502.  
  1503.  
  1504.  
  1505.                                      - Page 21 -
  1506.  
  1507.  
  1508.  
  1509.         ZLOG release 1.4 User's Guide
  1510.  
  1511.  
  1512.  
  1513.              switch  into interactive mode (it will display  process  op-
  1514.              tions screen).  From that point on you will see '@  <table>'
  1515.              in job account field.  Whenever cursor is on that field  you
  1516.              may press Enter key to display job account table.  Help mes-
  1517.              sage  area (in the lower part of the screen)  also  changes.
  1518.              When you press Enter, window pops up showing you job account
  1519.              numbers  from the table.  You can page  forwards,  backwards
  1520.              and you can update this table.  Press ESC to exit.
  1521.  
  1522.              While  you  communicate with ZLOG  through  process  options
  1523.              screen  any time you can type a '@' in job account field  to
  1524.              specify new job account table file name.  If you typed '@' a
  1525.              'file  name?' prompt pops up.  If you do not enter  anything
  1526.              (leave  file  name blank) you will be able to enter  (up  to
  1527.              128)  different job account numbers into job account  table.
  1528.              Log records containing any of these accounts will be select-
  1529.              ed for processing.
  1530.  
  1531.              If  processing was initiated from a command line  (or  batch
  1532.              file)  and all parameters were correct, log records will  be
  1533.              processed  immediately and control will be returned to  DOS.
  1534.              If  some  (or all) of the parameters were not  supplied  (or
  1535.              they are wrong) ZLOG switch itself into interactive mode and
  1536.              you can correct any parameter on the screen and initiate ac-
  1537.              tion.  After processing is complete, control returns back to
  1538.              the  process options screen.  This is handy if you  want  to
  1539.              process log records few times changing one (or more) parame-
  1540.              ter(s) from run to run.
  1541.  
  1542.                   Note:     If  ZLOG  was  active  when  process  options
  1543.                             screen  pops up, on the line 4 (on the  right
  1544.                             hand  side) you see date and time  when  ZLOG
  1545.                             was  installed into  memory.    Alternatively
  1546.                             you  can press Alt-S to get full ZLOG  status
  1547.                             report.
  1548.  
  1549.  
  1550.              /Q  Quiet operation
  1551.  
  1552.  
  1553.              When  you specify this switch ZLOG will not display any  in-
  1554.              formational  messages  such as copyright, action  taken  and
  1555.              status.   Only error messages that cause the termination  of
  1556.              ZLOG will be displayed.
  1557.  
  1558.                   Example:  ZLOG /Q
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.                                      - Page 22 -
  1568.  
  1569.  
  1570.  
  1571.                                                              Running ZLOG
  1572.  
  1573.  
  1574.  
  1575.              /S  Display ZLOG status
  1576.  
  1577.  
  1578.              When  you specify this switch ZLOG will display its  status,
  1579.              when  it was installed into memory, active operator ID,  ac-
  1580.              tive  job account number, active log file name  and  current
  1581.              maximum log level.
  1582.  
  1583.                   Example:  ZLOG /S
  1584.  
  1585.                   Note:     All  other  switches, if specified,  will  be
  1586.                             ignored except /Q (quiet operation).
  1587.  
  1588.              Displaying ZLOG's status with time and date of  installation
  1589.              in the memory might be useful to check if somebody  rebooted
  1590.              the system or uninstalled ZLOG.  For example, if you install
  1591.              ZLOG  every morning at 9 am and during the day you  discover
  1592.              that ZLOG was installed at 11 am, you know that somebody ei-
  1593.              ther rebooted the system or uninstalled ZLOG for a while.
  1594.  
  1595.              /U  Uninstall resident portion
  1596.  
  1597.  
  1598.              This  switch  allows you to remove the resident  portion  of
  1599.              ZLOG from the main memory.  It will free about 2K of comput-
  1600.              er  memory.   When you want to uninstall ZLOG  specify  this
  1601.              switch.
  1602.  
  1603.                   Example:  ZLOG /U
  1604.  
  1605.              ZLOG informs you about actions taken unless /Q switch (quiet
  1606.              operation) is specified.
  1607.  
  1608.  
  1609.  
  1610.         Process options screen
  1611.  
  1612.  
  1613.              Process options screen comes up whenever you want to process
  1614.              log records and you did not specify on command line all  the
  1615.              parameters (see /P switch in 'Command line switches and  pa-
  1616.              rameters'  section) or some of the specified parameters  are
  1617.              wrong.   Process options screen is simple and straight  for-
  1618.              ward with extensive context-sensitive help.  Invoke context-
  1619.              sensitive help with F1.
  1620.  
  1621.              On  line 2 it shows today's date.  If ZLOG is active  (resi-
  1622.              dent) then on line 4 you see time and date when ZLOG was ac-
  1623.              tivated.  Having ZLOG's installation time and date might  be
  1624.              useful  to  check if somebody rebooted the system  or  rein-
  1625.              stalled ZLOG.  For example, if you install ZLOG every  morn-
  1626.  
  1627.  
  1628.  
  1629.                                      - Page 23 -
  1630.  
  1631.  
  1632.  
  1633.         ZLOG release 1.4 User's Guide
  1634.  
  1635.  
  1636.  
  1637.              ing at 9 am and during the day you discover that ZLOG was in-
  1638.              stalled at 11 am, you know that somebody either rebooted the
  1639.              system or uninstalled ZLOG for a while.
  1640.  
  1641.              As  you move cursor through different fields, help area  (in
  1642.              the  lower part of the screen) gives you  basic  information
  1643.              about  these fields.  At any time you can get more help  in-
  1644.              formation by pressing F1.
  1645.  
  1646.              Upper  portion of the screen is titled 'File names'.   These
  1647.              are names of log file, log history file, report file and ex-
  1648.              port  file.  Default file names are defined in  installation
  1649.              procedure,  screen #1.  If necessary, overkey any  of  these
  1650.              file names.
  1651.  
  1652.              Next  portion of the screen is 'Selection  criteria'.   Here
  1653.              you  specify  different options for selecting  log  records,
  1654.              like  operator  ID, job account number,  program  name  etc.
  1655.              Last  field in this area is destination switch.  It can  be:
  1656.              S(creen), D(isk), P(rinter) or E(xport).
  1657.  
  1658.              While  you  communicate with ZLOG  through  process  options
  1659.              screen  any time you can type a '@' in job account field  to
  1660.              specify  job  account table file name.  If you typed  '@'  a
  1661.              'file name?' prompt pops up.  If you enter a file name,  job
  1662.              account table will be loaded from this (ASCII) file.  If you
  1663.              do not enter anything (leave the file name blank), empty job
  1664.              account  table is created and you will be able to enter  (up
  1665.              to 128) different job account numbers into this table.   Log
  1666.              records  containing any of these accounts will  be  selected
  1667.              for processing.
  1668.  
  1669.              If  you are using job account table, job account field  will
  1670.              be changed to '@ <table>' meaning that table is active.  Any
  1671.              time when cursor rests on this field you can press Enter key
  1672.              to display and/or update this table.
  1673.  
  1674.              Last  area  of processing options screen is  'Action'  area.
  1675.              Here  you choose what you want to do with selected  log  re-
  1676.              cords.  Processing actions are:  F2-print, F3-move to histo-
  1677.              ry, F4-delete, Alt-F2-print history and Alt-F4-delete histo-
  1678.              ry records.
  1679.  
  1680.              You can position highlighted bar on any action and select it
  1681.              by pressing Enter key.  Alternatively, you can press  corre-
  1682.              sponding  function  key from anywhere on the  screen  (speed
  1683.              key).
  1684.  
  1685.              Alt-S  opens a little window where you can see current  set-
  1686.              tings  of  TSR portion of ZLOG.  These are:  information  if
  1687.              ZLOG is running or not, operator ID, job account name, maxi-
  1688.  
  1689.  
  1690.  
  1691.                                      - Page 24 -
  1692.  
  1693.  
  1694.  
  1695.                                                              Running ZLOG
  1696.  
  1697.  
  1698.  
  1699.              mum log level, log file name and date and time when ZLOG was
  1700.              installed  into memory.  To exit this window just press  any
  1701.              key.
  1702.  
  1703.              Alt-H  brings up latest process options screen, so  you  can
  1704.              see what you did last time.  From this history screen (which
  1705.              looks  almost  the same as process options screen)  you  can
  1706.              scroll  (using  PgDn/PgUp) back and forth  through  last  32
  1707.              process  options screens.  Line 4 shows you process  options
  1708.              screen  number (-1 meaning last processing, -2  meaning  two
  1709.              processing  ago  etc.).  Also on the same line is  date  and
  1710.              time when this processing was performed.  Blinking action in
  1711.              'Action' area shows what action was performed at that  time.
  1712.              Note  that log report with S(creen) destination is  not  re-
  1713.              corded in history of processing.
  1714.  
  1715.              From history screen you can copy all options to the  current
  1716.              processing  screen.  To do so press Alt-C or position  high-
  1717.              lighted  bar on Alt-C action and press Enter key.   To  exit
  1718.              press ESC.
  1719.  
  1720.              To  exit from process options screen without processing  any
  1721.              records  press ESC.  ESC always brings you to  the  previous
  1722.              level (or, in this case, to DOS).
  1723.  
  1724.              If  you  specified S(creen) as a report  destination,  after
  1725.              processing  log report screen pops up showing you  the  same
  1726.              data  as if you have printed the report.  Here you  can  use
  1727.              up/down  arrow  keys  to  scroll one line  at  the  time  or
  1728.              PgDn/PgUp  to scroll forwards and backwards one  screen  (18
  1729.              lines)  at  the time.  Use left/right arrow keys  to  scroll
  1730.              left  or  right.  Press ESC to go back  to  process  options
  1731.              screen.
  1732.  
  1733.                   Note:     Left/right scrolling is available only if you
  1734.                             specified 132 column report in the  installa-
  1735.                             tion procedure.
  1736.  
  1737.  
  1738.  
  1739.         Program levels
  1740.  
  1741.  
  1742.              Computer programs can run at different levels.   COMMAND.COM
  1743.              (DOS  prompt) runs at level 0.  Programs that runs from  the
  1744.              command line run at level 1.  When it terminates, level  re-
  1745.              turns back to 0.  Some programs allow you to 'shell out'  to
  1746.              DOS to do another task(s) after which you type 'exit' to re-
  1747.              turn  to the program.  'Shelling out' of a program  involves
  1748.              loading and running a secondary copy of COMMAND.COM.   Since
  1749.              your  program  is  running  at level  1,  the  new  copy  of
  1750.  
  1751.  
  1752.  
  1753.                                      - Page 25 -
  1754.  
  1755.  
  1756.  
  1757.         ZLOG release 1.4 User's Guide
  1758.  
  1759.  
  1760.  
  1761.              COMMAND.COM is run at level 2.  Another program run from the
  1762.              level  2  command line runs at level 3 etc.  When  you  type
  1763.              'exit' you return to level 1.  Nesting also occurs when  one
  1764.              program load and run another program (not just COMMAND.COM).
  1765.              DOS will allow nesting for as many levels as memory permits.
  1766.              However,  ZLOG only keeps track of up to 16  levels  (0-15).
  1767.              Programs  that run at levels higher than 15 will  be  logged
  1768.              under  the  name of the program at level 15.   Under  normal
  1769.              circumstances you will hardly reach a level higher than 3.
  1770.  
  1771.              With the command line option /L you can set maximum  program
  1772.              level to be logged.  For example, you can set maximum  level
  1773.              to 1.  All programs (if any) that run at level higher than 1
  1774.              will  be  logged under the name of the program on  level  1.
  1775.              For example, if you are in edit session using your text edi-
  1776.              tor  and you 'shell-out' to DOS to format a diskette or  you
  1777.              run your compiler within the editor, then all that time will
  1778.              be  logged under the name of your text editor (level 1  pro-
  1779.              gram).
  1780.  
  1781.              Setting maximum level to 1 significantly reduces the size of
  1782.              your  log  file.  Duration times for all  'nested'  programs
  1783.              will  be included in a duration time of program at  level  1
  1784.              and written out as a single log record (see chapter  'Useful
  1785.              hints', section 'Reducing size of the log file').
  1786.  
  1787.  
  1788.  
  1789.         Report
  1790.  
  1791.  
  1792.              There are two versions of the log report:  80 column and 132
  1793.              column.   They  contain the same data, only the  132  column
  1794.              version is more readable.  It has more space between columns
  1795.              and the time fields are shown as HH:MM:SS.  In the 80 column
  1796.              version  these fields are shown as HH:MM.  Report shows  the
  1797.              following data:
  1798.  
  1799.                   - Operator ID
  1800.  
  1801.                   - Job account number
  1802.  
  1803.                   - Starting date of the job
  1804.  
  1805.                   - Starting time of the job
  1806.  
  1807.                   - Ending time of the job
  1808.  
  1809.                   - Elapsed time
  1810.  
  1811.                   - Program level
  1812.  
  1813.  
  1814.  
  1815.                                      - Page 26 -
  1816.  
  1817.  
  1818.  
  1819.                                                              Running ZLOG
  1820.  
  1821.  
  1822.  
  1823.  
  1824.                   - Program name
  1825.  
  1826.                   - Command line parameters
  1827.  
  1828.              Everything  is self explanatory except program  level.   De-
  1829.              tailed information about program level can be found in  sec-
  1830.              tion 'Program levels' earlier in this chapter.
  1831.  
  1832.              You can request detailed report (all recorded steps printed)
  1833.              or global report (only total lines printed).
  1834.  
  1835.              Total  lines show you the total processing time, total  idle
  1836.              time,  sum of these two totals, number of all the steps  and
  1837.              number  of steps run at level 1 (from DOS prompt).   If  you
  1838.              included  'idle' records in the processing, two  percentages
  1839.              are calculated:  percentage of real usage and percentage  of
  1840.              idle time.
  1841.  
  1842.                   Note:     When you print detailed report, sometimes log
  1843.                             records will not come out in their chronolog-
  1844.                             ical  sequence.  ZLOG process log records  in
  1845.                             their PHYSICAL sequence.  In log files physi-
  1846.                             cal and chronological sequence are the  same.
  1847.                             But in the log history files it is different.
  1848.                             You can, for example, off-load (move from log
  1849.                             to log history) log records for May, and then
  1850.                             off-load  log records for April.   Now  their
  1851.                             physical sequence is: May, April, ... .  When
  1852.                             you print records from that history file they
  1853.                             will appear in May-April order.  Sorting  the
  1854.                             records  in chronological sequence is  not  a
  1855.                             big  problem, but is a big overhead  on  per-
  1856.                             formance of ZLOG.  Of course, if you request-
  1857.                             ed only total figures (no detail lines), this
  1858.                             is irrelevant.
  1859.  
  1860.  
  1861.  
  1862.         Exporting log records
  1863.  
  1864.  
  1865.              You  can  export log records in such way that  they  can  be
  1866.              loaded into your spreadsheet or database program(s) for fur-
  1867.              ther processing.  This is an ASCII file.  Most  spreadsheets
  1868.              and database programs provide ASCII 'import' function.
  1869.  
  1870.              To produce export file specify E(xport) in S/D/P/E switch in
  1871.              the process options screen.  There are two types of exported
  1872.              log  records:  detail records and summary  (total)  records.
  1873.              They  are similar to detail and total lines in ZLOG  report.
  1874.  
  1875.  
  1876.  
  1877.                                      - Page 27 -
  1878.  
  1879.  
  1880.  
  1881.         ZLOG release 1.4 User's Guide
  1882.  
  1883.  
  1884.  
  1885.              When  you request total lines only, you will get  total  re-
  1886.              cords ONLY.  When you request detailed records you will  get
  1887.              detailed records ONLY (without total records).  Both type of
  1888.              records  contain numeric and alphanumeric data.  Each  field
  1889.              is  surrounded with its own delimiter (defined at  installa-
  1890.              tion  time) and all fields are delimited by field  delimiter
  1891.              (defined, also, at installation time).  Installation program
  1892.              comes  with these fields defaulted to Lotus-123 import  con-
  1893.              ventions:   field delimiter-comma (,), no delimiter for  nu-
  1894.              meric fields, alphanumeric delimiter-quote(").
  1895.  
  1896.              Detail record layout:
  1897.  
  1898.                        opID                length 0-3, alphanumeric
  1899.                        job acct no.        length 0-16, alphanumeric
  1900.                        program name        length 5-12, alphanumeric
  1901.                        start date          length 6, numeric
  1902.                        start time          length 6, numeric
  1903.                        end time            length 6, numeric
  1904.                        elapsed-hours       length 2, numeric
  1905.                        elapsed-minutes     length 2, numeric
  1906.                        elapsed-seconds     length 2, numeric
  1907.                        level               length 2, numeric
  1908.  
  1909.              Summary record layout:
  1910.  
  1911.                        log file name       length 1-72, alphanumeric
  1912.                        operator ID         length 0-3, alphanumeric
  1913.                        job acct no.        length 0-16, alphanumeric
  1914.                        program name        length 0-12, alphanumeric
  1915.                        elapsed-hours       length 9, numeric
  1916.                        elapsed-minutes     length 2, numeric
  1917.                        elapsed-seconds     length 2, numeric
  1918.                        idle-hours          length 9, numeric
  1919.                        idle-minutes        length 2, numeric
  1920.                        idle-seconds        length 2, numeric
  1921.                        number of steps     length 9, numeric
  1922.                        number of steps-level 1  length 9, numeric
  1923.  
  1924.  
  1925.              Lotus-123  import function is invoked by typing:  /   F(ile)
  1926.              I(mport)  N(umbers)  and import file name.
  1927.  
  1928.              dBASE  import is a bit more complicated.  First  you  define
  1929.              dBASE file with these fields:
  1930.  
  1931.                        field name     type      width
  1932.  
  1933.                        OPID           CHAR      3
  1934.                        JOBACCT        CHAR      16
  1935.                        PROG           CHAR      12
  1936.  
  1937.  
  1938.  
  1939.                                      - Page 28 -
  1940.  
  1941.  
  1942.  
  1943.                                                              Running ZLOG
  1944.  
  1945.  
  1946.  
  1947.                        DATE           NUM       6
  1948.                        START          NUM       6
  1949.                        END            NUM       6
  1950.                        ELAPHH         NUM       2
  1951.                        ELAPMM         NUM       2
  1952.                        ELAPSS         NUM       2
  1953.                        LEVEL          NUM       2
  1954.  
  1955.              Then you run dBASE and USE file above.  Then append  records
  1956.              from ZLOG export file.  Issue this command:
  1957.  
  1958.                        append from export-file-name delimited
  1959.  
  1960.              If  you  set  switch T(otals only)  option  on  the  process
  1961.              screen, then procedure is the same except file definition is
  1962.              slightly different:
  1963.  
  1964.                        field name     type      width
  1965.  
  1966.                        FILENAME       CHAR      72
  1967.                        OPID           CHAR      3
  1968.                        JOBACCT        CHAR      16
  1969.                        PROG           CHAR      12
  1970.                        ELAPHH         NUM       9
  1971.                        ELAPMM         NUM       2
  1972.                        ELAPSS         NUM       2
  1973.                        IDLEHH         NUM       9
  1974.                        IDLEMM         NUM       2
  1975.                        IDLESS         NUM       2
  1976.                        STEPS          NUM       9
  1977.                        STEPS1         NUM       9
  1978.  
  1979.              Loading  log records into spreadsheet or  database  programs
  1980.              allows you to further analyze log data or prepare more  cus-
  1981.              tomized report.
  1982.  
  1983.  
  1984.  
  1985.         Error messages
  1986.  
  1987.  
  1988.              ZLOG does few different tasks.  In case of any kind of fail-
  1989.              ure  function  code (FC) and return code (RC) will  be  dis-
  1990.              played.   Look up the codes in the table below.  A  function
  1991.              code tells you what action was in progress when the  failure
  1992.              occurred.   A return code tells you what happened  and  what
  1993.              might be a reason.  It also gives you a possible solution to
  1994.              the  problem.  If error occurred  ERRORLEVEL will be set  to
  1995.              1, so from your batch files you can determine if ZLOG action
  1996.              was successful.
  1997.  
  1998.  
  1999.  
  2000.  
  2001.                                      - Page 29 -
  2002.  
  2003.  
  2004.  
  2005.         ZLOG release 1.4 User's Guide
  2006.  
  2007.  
  2008.  
  2009.                   Note:     Most  of  these errors are possible  only  in
  2010.                             multi-user environment (such as PC-MOS/386 or
  2011.                             LAN).
  2012.  
  2013.              Function codes (FC):
  2014.  
  2015.                   FC=+2000  Internal error.  Call ZM & Associates.
  2016.                   FC=+2010  ZLOG not installed.  You have to run  INSTALL
  2017.                             program before using ZLOG.
  2018.                   FC=+2020  Attempt  to open current log file.   Possible
  2019.                             RC:  2, 4, 5, 12 and 32.
  2020.                   FC=+2030  Attempt to read control information from  the
  2021.                             current log file.  Possible RC:  5, 6 and 10.
  2022.                   FC=+2040  Attempt to read control information from  the
  2023.                             current log file.  Possible RC:  5, 6 and 10.
  2024.                   FC=+2050  Attempt to close current log file.   Possible
  2025.                             RC:  6.
  2026.                   FC=+2060  Attempt  to open log history file.   Possible
  2027.                             RC:  2, 4, 5, 12 and 32.
  2028.                   FC=+2070  Attempt  to read log history file.   Possible
  2029.                             RC:  5, 6 and 10.
  2030.                   FC=+2080  Log history file corrupted.  Restore it  from
  2031.                             your latest backup.
  2032.                   FC=+2090  Attempt  to open printer file.  Possible  RC:
  2033.                             91, 96 and 97.
  2034.                   FC=+2100  Attempt to close printer file.  Possible  RC:
  2035.                             97.
  2036.                   FC=+2110  Attempt to close log history file.   Possible
  2037.                             RC:  6.
  2038.                   FC=+2120  Attempt to close log file.  Possible RC:  6.
  2039.                   FC=+2130  Attempt to position at the end of log history
  2040.                             file.  Possible RC:  1 and 6.
  2041.                   FC=+2140  Attempt  to delete ZLOG temporary work  file.
  2042.                             Possible RC:  5.
  2043.                   FC=+2150  Attempt  to create ZLOG temporary work  file.
  2044.                             Possible RC:  3, 4 and 5.
  2045.                   FC=+2160  Attempt  to  open ZLOG temporary  work  file.
  2046.                             Possible RC:  2, 4, 5, 12 and 32.
  2047.                   FC=+2170  Attempt  to  write onto ZLOG  temporary  work
  2048.                             file.  Possible RC:  5, 6 and 34.
  2049.                   FC=+2180  Attempt to write onto log history file.  Pos-
  2050.                             sible RC:  5, 6 and 34.
  2051.                   FC=+2190  Attempt  to  write onto ZLOG  temporary  work
  2052.                             file.  Possible RC:  5, 6 and 34.
  2053.                   FC=+2200  Attempt  to close ZLOG temporary  work  file.
  2054.                             Possible RC:  6.
  2055.                   FC=+2210  Attempt to close log history file.   Possible
  2056.                             RC:  6.
  2057.                   FC=+2220  Attempt to close log file.  Possible RC:  6.
  2058.                   FC=+2230  Attempt to delete old log file.  Possible RC:
  2059.                             2 and 5.
  2060.  
  2061.  
  2062.  
  2063.                                      - Page 30 -
  2064.  
  2065.  
  2066.  
  2067.                                                              Running ZLOG
  2068.  
  2069.  
  2070.  
  2071.                   FC=+2240  Attempt to rename ZLOG temporary work file to
  2072.                             log file.  Possible RC:  3, 5 and 17.
  2073.                   FC=+2250  Attempt  to delete ZLOG temporary work  file.
  2074.                             Possible RC:  5.
  2075.                   FC=+2260  Attempt  to create ZLOG temporary work  file.
  2076.                             Possible RC:  3, 4 and 5.
  2077.                   FC=+2270  Attempt  to  open ZLOG temporary  work  file.
  2078.                             Possible RC:  2, 4, 5, 12 and 32.
  2079.                   FC=+2280  Attempt  to  write onto ZLOG  temporary  work
  2080.                             file.  Possible RC:  5, 6 and 34.
  2081.                   FC=+2290  Attempt  to  write onto ZLOG  temporary  work
  2082.                             file.  Possible RC:  5, 6 and 34.
  2083.                   FC=+2300  Attempt  to close ZLOG temporary  work  file.
  2084.                             Possible RC:  6.
  2085.                   FC=+2310  Attempt to close log file.  Possible RC:  6.
  2086.                   FC=+2320  Attempt to delete old log file.  Possible RC:
  2087.                             2 and 5.
  2088.                   FC=+2330  Attempt to rename ZLOG temporary work file to
  2089.                             log file.  Possible RC:  3, 5 and 17.
  2090.                   FC=+2340  Attempt  to close ZLOG temporary  work  file.
  2091.                             Possible RC:  6.
  2092.                   FC=+2350  Attempt to close log history file.   Possible
  2093.                             RC:  6.
  2094.                   FC=+2360  Attempt to delete old log history file.  Pos-
  2095.                             sible RC:  2 and 5.
  2096.                   FC=+2370  Attempt to rename ZLOG temporary work file to
  2097.                             log history file.  Possible RC:  3, 5 and 17.
  2098.                   FC=+2380  Attempt to read control information from  the
  2099.                             current log file.  Possible RC:  5, 6 and 10.
  2100.                   FC=+2390  Attempt to read control information from  the
  2101.                             current log file.  Possible RC:  5, 6 and 10.
  2102.                   FC=+2400  Attempt to close log file.  Possible RC:  6.
  2103.                   FC=+2410  Attempt to read control information from  the
  2104.                             log history file.  Possible RC:  5, 6 and 10.
  2105.                   FC=+2420  Attempt to read control information from  the
  2106.                             log history file.  Possible RC:  5, 6 and 10.
  2107.                   FC=+2430  Attempt to close log history file.   Possible
  2108.                             RC:  6.
  2109.                   FC=+2440  Attempt to read log file.  Possible RC:  5, 6
  2110.                             and 10.
  2111.                   FC=+2450  Log  file  corrupted.  Restore it  from  your
  2112.                             latest backup.  If you do not have the backup
  2113.                             then  delete  this  log file.   ZLOG  will  a
  2114.                             create new one.
  2115.                   FC=+2460  Log  file  corrupted.  Restore it  from  your
  2116.                             latest backup.  If you do not have the backup
  2117.                             then delete this log file.  ZLOG will  create
  2118.                             a new one.
  2119.                   FC=+2470  Attempt  to read log history file.   Possible
  2120.                             RC:  5, 6 and 10.
  2121.                   FC=+2480  Log history file corrupted.  Restore it  from
  2122.                             your  latest backup.  If you do not have  the
  2123.  
  2124.  
  2125.                                      - Page 31 -
  2126.  
  2127.  
  2128.  
  2129.         ZLOG release 1.4 User's Guide
  2130.  
  2131.  
  2132.  
  2133.                             backup run INSTALL and create new log history
  2134.                             file.
  2135.                   FC=+2490  Log history file corrupted.  Restore it  from
  2136.                             your  latest backup.  If you do not have  the
  2137.                             backup run INSTALL and create new log history
  2138.                             file.
  2139.                   FC=+2500  Attempt to write to the printer file.  Possi-
  2140.                             ble RC:  34, 91, 95 and 97.
  2141.                   FC=+2510  Attempt to write to the printer file.  Possi-
  2142.                             ble RC:  34, 91, 95 and 97.
  2143.                   FC=+2520  Attempt to write to the printer file.  Possi-
  2144.                             ble RC:  34, 91, 95 and 97.
  2145.                   FC=+2600  Process history file (ZLOGHIST.DAT)  corrupt-
  2146.                             ed.  Reinstall ZLOG.
  2147.  
  2148.              Return codes (RC):
  2149.  
  2150.                   RC=+0001  ZLOG  program itself (or its  overlay  phase)
  2151.                             might be corrupted.  Run installation  proce-
  2152.                             dure from scratch.
  2153.                   RC=+0002  File not found.  File was deleted or  renamed
  2154.                             by another task.  Recreate the file and rerun
  2155.                             ZLOG.
  2156.                   RC=+0003  Path  not found.  Destination  directory  was
  2157.                             deleted or renamed by another task.   Correct
  2158.                             the problem and rerun ZLOG.
  2159.                   RC=+0004  To many opened files (no handle left).   ZLOG
  2160.                             package uses not more than 3 file handles  at
  2161.                             the time.  DOS error.  Reboot the system.
  2162.                   RC=+0005  Access  denied.  Turn off RO, Hidden  or  Sys
  2163.                             attribute for the default/destination  direc-
  2164.                             tory.   Set it to read/write (RW)  and  rerun
  2165.                             ZLOG.
  2166.                   RC=+0006  Invalid handle.  DOS error.  Reboot the  sys-
  2167.                             tem and rerun ZLOG.
  2168.                   RC=+0010  File  damaged (unexpected end of file  condi-
  2169.                             tion encountered).  Restore the file and  re-
  2170.                             run ZLOG.
  2171.                   RC=+0012  Invalid access code.  DOS system error.  Call
  2172.                             ZM & Associates.
  2173.                   RC=+0017  Not same device.  DOS error.  Reboot the sys-
  2174.                             tem and rerun ZLOG.
  2175.                   RC=+0032  Sharing  violation.  Problems with DOS  SHARE
  2176.                             utility or network program.  Consult your DOS
  2177.                             or network manual.
  2178.                   RC=+0034  Disk full.  No more room on destination disk.
  2179.                             Check  directory and delete  all  unnecessary
  2180.                             files (including ZLOG.$$$ - if you find  it).
  2181.                             Rerun ZLOG.
  2182.                   RC=+0091  Directory  is full (no more room for the  new
  2183.                             file entry) or file with the same name exists
  2184.  
  2185.  
  2186.  
  2187.                                      - Page 32 -
  2188.  
  2189.  
  2190.  
  2191.                                                              Running ZLOG
  2192.  
  2193.  
  2194.  
  2195.                             in  directory  and  has  RO  (read-only)  at-
  2196.                             tribute.  Correct the problem and rerun ZLOG.
  2197.                   RC=+0095  Invalid  operation.   ZLOG.COM,   ZLOG00.OVR,
  2198.                             ZLOG10,EXE  or ZS.EXE corrupted.   Rerun  IN-
  2199.                             STALL from scratch.
  2200.                   RC=+0096  Out of memory.  DOS error.  Reboot the system
  2201.                             and rerun ZLOG.
  2202.                   RC=+0097  DOS  critical error.  Reboot the  system  and
  2203.                             rerun ZLOG.
  2204.                   RC=+0094  Overlay phase corrupted.  Rerun INSTALL  from
  2205.                             scratch.
  2206.                   RC=????   Call ZM & Associates.
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.                                      - Page 33 -
  2250.  
  2251.  
  2252.  
  2253.         ZLOG release 1.4 User's Guide
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.                           This page intentionally left blank
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.                                      - Page 34 -
  2312.  
  2313.  
  2314.  
  2315.                                                      Sign ON/OFF using ZS
  2316.  
  2317.  
  2318.  
  2319.         Sign ON/OFF using ZS
  2320.  
  2321.  
  2322.  
  2323.         ZS - ZLOG companion
  2324.  
  2325.  
  2326.              When  you use ZS to sign on, your operator ID,  job  account
  2327.              number,  log  file name and maximum program  level  will  be
  2328.              changed to the values specified in the table (described  be-
  2329.              low). This has the same effect as running ZLOG with  options
  2330.              /I, /A, /F and /L.  ZS is the elegant way to adjust ZLOG ac-
  2331.              tions.   Running ZLOG with options /I, /A, /F and /L can  be
  2332.              sometimes complicated, specially in the multi-user  environ-
  2333.              ment.  ZLOG must be activated before you run ZS.
  2334.  
  2335.                   Note:     Run  ZS from DOS prompt (level 0)  ONLY!   If
  2336.                             you run another program, then 'shell out'  to
  2337.                             DOS and run ZS, you can get unpredictable re-
  2338.                             sults.
  2339.  
  2340.              You  don't have to use ZS.  It is not necessary  for  proper
  2341.              operation of ZLOG.  It is just a tool to save you some  time
  2342.              and effort.
  2343.  
  2344.  
  2345.  
  2346.         Setting up the operator ID table
  2347.  
  2348.  
  2349.              Before you start using ZS, you have to set up the table  for
  2350.              all  your operators.  For the very first time (and any  time
  2351.              later when you want to maintain operator ID table) you  have
  2352.              to sign on as a System Administrator.  At DOS prompt type:
  2353.  
  2354.                        ZS
  2355.  
  2356.              Enter  'SYS' as operator ID and 'SYS' as a  password  (later
  2357.              you might want to change this initial password to  something
  2358.              else).
  2359.  
  2360.              Maximum number of operators is 128.  Enter initial password,
  2361.              default job account, default log file name and program level
  2362.              for each operator.  For more information about program level
  2363.              see  section 'Program levels', chapter 'Running ZLOG'.   You
  2364.              can  have more than one operator with the same ID (but  dif-
  2365.              ferent passwords).  Job account numbers can be same for dif-
  2366.              ferent operators, as well as the log file names.  If job ac-
  2367.              count, log file name or program level is blank then at  sign
  2368.              on  time it will remain whatever it was before.  It  is  en-
  2369.              tirely up to you how you want to organize the sign on table.
  2370.  
  2371.  
  2372.  
  2373.                                      - Page 35 -
  2374.  
  2375.  
  2376.  
  2377.         ZLOG release 1.4 User's Guide
  2378.  
  2379.  
  2380.  
  2381.  
  2382.              To  delete  operator from operator ID table  just  space-out
  2383.              opID field.
  2384.  
  2385.              One  entry in sign on table is already filled with opID  SYS
  2386.              (System  Administrator).  You CANNOT change that  opID,  but
  2387.              you  can change other parameters.  Initial password is  also
  2388.              SYS.   You cannot have another operator with opID  SYS.   If
  2389.              you enter such opID in the table, that entry will be  delet-
  2390.              ed.
  2391.  
  2392.              When you sign on as SYS the password maintenance screen pops
  2393.              up.   On the line 4 (on the right hand side) in an  informa-
  2394.              tion  about  date and time ZLOG was installed  into  memory.
  2395.              Having ZLOG's installation time and date might be useful  to
  2396.              check  if somebody rebooted the system or uninstalled  ZLOG.
  2397.              For  example, if you install ZLOG every morning at 9 am  and
  2398.              during  the day you discover that ZLOG was installed  at  11
  2399.              am, you know that somebody either rebooted the system or un-
  2400.              installed ZLOG for a while.
  2401.  
  2402.              Use PgDn/PgUp to scroll through opID table.  Pay special at-
  2403.              tention to the log file names.  When you are done, press  F2
  2404.              to update the table.
  2405.  
  2406.  
  2407.  
  2408.         Command line
  2409.  
  2410.  
  2411.              Sign  ON or sign OFF action is controlled by the ZS  command
  2412.              line  parameters.  If there are no parameters, sign ON  mode
  2413.              is assumed.  You can sign ON either from the sign on  screen
  2414.              or  using  command line option.  Command line  option  is  a
  2415.              shortcut  to  sign on, but while you type your  password  is
  2416.              visible.
  2417.  
  2418.              To sign ON type:
  2419.  
  2420.                   ZS   anything but sign off command
  2421.              or
  2422.                   ZS   ON  opID  psw (valid options are also /ON and -ON)
  2423.  
  2424.              To sign OFF type:
  2425.  
  2426.                   ZS   OFF  (valid options are also /OFF and -OFF)
  2427.  
  2428.                   Note:     Time spent in ZS sign on/off mode is recorded
  2429.                             under  special  job  account  number,  'SIGN-
  2430.                             ON/OFF'.  However command line is not record-
  2431.                             ed  (so you can freely type your password  on
  2432.  
  2433.  
  2434.  
  2435.                                      - Page 36 -
  2436.  
  2437.  
  2438.  
  2439.                                                      Sign ON/OFF using ZS
  2440.  
  2441.  
  2442.  
  2443.                             the command line).
  2444.  
  2445.  
  2446.              Sign ON mode:
  2447.  
  2448.              If  you typed on the command line your operator ID and  cor-
  2449.              rect  password, you will be signed ON immediately.  If  your
  2450.              ID  or password was not correct or if you typed  just  'ZS',
  2451.              then  sign on screen pops up asking you for operator ID  and
  2452.              password.  Enter it.  After 3 unsuccessful tries or 60  sec-
  2453.              onds,  whichever  comes first, program will  switch  in  the
  2454.              'sign off' mode.  If you forget your password, SYS  operator
  2455.              (System Administrator) can overkey it at any time (not  read
  2456.              it).  In such a case sign on using new assigned password and
  2457.              change it.
  2458.  
  2459.              Time  spent in sign ON mode is logged under  account  'SIGN-
  2460.              ON/OFF' (no operator ID).
  2461.  
  2462.              Sign OFF mode:
  2463.  
  2464.              Sign off screen pops up telling you that you are signed off.
  2465.              After 60 seconds it will fade away ('screen save'  feature).
  2466.              Touch  any key and you will be back in 'sign on' mode  (same
  2467.              as if you typed 'ZS' from DOS prompt).
  2468.  
  2469.                   Note:     You can include ZS in your AUTOEXEC.BAT  file
  2470.                             (or  in start-up procedure for each  worksta-
  2471.                             tion in multi-user environment).  Command can
  2472.                             be  'ZS  OFF'  and SHOULD be  the  very  last
  2473.                             statement in the sequence.  ZLOG must be  al-
  2474.                             ready active.
  2475.  
  2476.              Time  spent in sign OFF mode is logged under account  'SIGN-
  2477.              ON/OFF' (no operator ID).
  2478.  
  2479.  
  2480.         Error messages
  2481.  
  2482.  
  2483.              If any kind of failure occurs, function code (FC) and return
  2484.              code (RC) will be displayed.  Look up the codes in the table
  2485.              below.   A  function  code  tells you  what  action  was  in
  2486.              progress when the failure occurred.  A return code tells you
  2487.              what happened and what might be a reason.  It also gives you
  2488.              a possible solution to the problem.
  2489.  
  2490.                   Note:     Most  of  these errors are possible  only  in
  2491.                             multi-user environment (such as PC-MOS/386 or
  2492.                             LAN).
  2493.  
  2494.  
  2495.  
  2496.  
  2497.                                      - Page 37 -
  2498.  
  2499.  
  2500.  
  2501.         ZLOG release 1.4 User's Guide
  2502.  
  2503.  
  2504.  
  2505.              Function codes (FC):
  2506.  
  2507.                   FC=+3000  Internal error.  Call ZM & Associates.
  2508.                   FC=+3010  ZS  not installed.  You have to  run  INSTALL
  2509.                             program before using ZS.
  2510.                   FC=+3020  Attempt to read ZS control information.  Pos-
  2511.                             sible RC:  5, 6 and 10.
  2512.                   FC=+3030  Attempt  to  write  ZS  control  information.
  2513.                             Possible RC:  4, 5, 12 and 32.
  2514.                   FC=+3040  Attempt to read control information from  the
  2515.                             new log file specified in the maintenance ta-
  2516.                             ble.  Possible RC:  4, 5, 12 and 32.
  2517.  
  2518.              Return codes (RC):
  2519.  
  2520.                   RC=+0001  ZS  program itself might be  corrupted.   Run
  2521.                             installation procedure from scratch.
  2522.                   RC=+0003  Path  not found.  Destination  directory  was
  2523.                             deleted or renamed by another task.   Correct
  2524.                             the problem and rerun ZS.
  2525.                   RC=+0004  To many opened files (no handle left).   ZLOG
  2526.                             package uses not more than 3 file handles  at
  2527.                             the time.  DOS error.  Reboot the system.
  2528.                   RC=+0005  Access  denied.  Turn off RO, Hidden  or  Sys
  2529.                             attribute for the default/destination  direc-
  2530.                             tory.   Set it to read/write (RW)  and  rerun
  2531.                             ZS.
  2532.                   RC=+0006  Invalid handle.  DOS error.  Reboot the  sys-
  2533.                             tem and rerun ZS.
  2534.                   RC=+0012  Invalid access code.  DOS system error.  Call
  2535.                             ZM & Associates.
  2536.                   RC=+0017  Not same device.  DOS error.  Reboot the sys-
  2537.                             tem and rerun ZLOG.
  2538.                   RC=+0032  Sharing  violation.  Problems with DOS  SHARE
  2539.                             utility or network program.  Consult your DOS
  2540.                             or network manual.
  2541.                   RC=+0096  Out of memory.  DOS error.  Reboot the system
  2542.                             and rerun ZS.
  2543.                   RC=+0097  DOS  critical error.  Reboot the  system  and
  2544.                             rerun ZS.
  2545.                   RC=????   Call ZM & Associates.
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.                                      - Page 38 -
  2560.  
  2561.  
  2562.  
  2563.                                                              Useful hints
  2564.  
  2565.  
  2566.  
  2567.         Useful hints
  2568.  
  2569.  
  2570.  
  2571.         Log file maintenance
  2572.  
  2573.  
  2574.              Log  file should be periodically off-loaded  ('cleaned')  to
  2575.              the history file(s).  The reason is this:  you can keep  log
  2576.              history file(s) on floppy disk(s), in a safe place and  away
  2577.              from dangerous DOS DELETE command.  Log file is on the  hard
  2578.              disk on-line and could be accidentally deleted.  If you off-
  2579.              load your log file every Friday and one day you erase it  by
  2580.              mistake,  in the worst case you will loose one week  of  log
  2581.              records.   If you keep forever-to-date records in  your  log
  2582.              file, it is a high risk.  You should clean-up log file EVERY
  2583.              WEEK.  This is important.
  2584.  
  2585.              You   may   want  to  use  PKware's   compressing   software
  2586.              PKZIP/PKUNZIP to compress log history file(s) and keep it on
  2587.              floppy disk(s).
  2588.  
  2589.  
  2590.  
  2591.         Multiple log files
  2592.  
  2593.  
  2594.              You  can  have different log file for each job or  group  of
  2595.              jobs that you do.  Switching from one log file to another is
  2596.              simple and easy.  Just specify /F switch e.g.
  2597.  
  2598.                   ZLOG /F=c:\data\billing.log
  2599.  
  2600.              From  this point on everything will be logged into log  file
  2601.              c:\data\billing.log.   If job account was not specified,  it
  2602.              will stay the same as before.  However, if you specify:
  2603.  
  2604.                   ZLOG /F=c:\data\billing.log /A=1234
  2605.  
  2606.              then job account number will be changed to 1234, as well  as
  2607.              the log file name.
  2608.  
  2609.                   Note:     If your computer is running under  multi-user
  2610.                             operating system (such as PC-MOS/386 or  LAN)
  2611.                             we recommend you to have a separate log  file
  2612.                             for each terminal (active task).  This is be-
  2613.                             cause  concurrent updating of log file  might
  2614.                             occur  and log data for one  terminal  (task)
  2615.                             could be lost.  Later you can combine log re-
  2616.                             cords  from all log files into one (or  more)
  2617.                             log history file(s).  In LAN environment  log
  2618.  
  2619.  
  2620.  
  2621.                                      - Page 39 -
  2622.  
  2623.  
  2624.  
  2625.         ZLOG release 1.4 User's Guide
  2626.  
  2627.  
  2628.  
  2629.                             file  should be on the locally attached  disk
  2630.                             for each workstation.
  2631.  
  2632.                   Note:     ZS  (ZLOG's sign on/off module) can help  you
  2633.                             accomplish  sometimes  complicated  task   of
  2634.                             switching  to different job accounts or  dif-
  2635.                             ferent log files.  At the same time  multiple
  2636.                             operators (with their opIDs) can access  your
  2637.                             computer and everything will be logged  under
  2638.                             appropriate  opIDs, account numbers and  into
  2639.                             right log files.
  2640.  
  2641.  
  2642.  
  2643.         Multiple log history files
  2644.  
  2645.  
  2646.              INSTALL is one way to create empty log history file.  If you
  2647.              want to have multiple history files, you can:
  2648.  
  2649.                   -         copy  !EMPTY.LOG from  distribution  diskette
  2650.                             and rename it.
  2651.                   -         run  ZLOG  with /F switch to create  new  log
  2652.                             file.   Then immediately switch back to  your
  2653.                             old  log  file (running again  ZLOG  with  /F
  2654.                             switch).   This new file you've just  created
  2655.                             can be your new (empty) history file.
  2656.  
  2657.              Do  not specify .$$$ as a file extension.  ZLOG uses it  for
  2658.              its own work (temporary) files.
  2659.  
  2660.              It  is entirely up to you how you want to organize your  log
  2661.              history data.  You can have different log history files  for
  2662.              each operator ID, each job account number, for certain peri-
  2663.              od of time (quarterly, yearly.  .  .  ) etc.  You can freely
  2664.              manipulate with log history data copying (reorganizing)  log
  2665.              records from one history file to another.
  2666.  
  2667.              Log  and log history file have the same structure.   If  you
  2668.              want  to  extract  some records from one  log  history  file
  2669.              (which  had  been  off-loaded by mistake) and  put  it  into
  2670.              another log history file then do this:
  2671.  
  2672.                   -         bring   up  ZLOG  process  function  (/P   or
  2673.                             /P=.  .  .  )
  2674.  
  2675.                   -         specify as a LOG file your 'source' log  his-
  2676.                             tory file
  2677.  
  2678.                   -         specify as a HISTORY file your  'destination'
  2679.                             log history file.
  2680.  
  2681.  
  2682.  
  2683.                                      - Page 40 -
  2684.  
  2685.  
  2686.  
  2687.                                                              Useful hints
  2688.  
  2689.  
  2690.  
  2691.  
  2692.                   -         specify selection criteria
  2693.  
  2694.                   -         specify action to 'move' records from log  to
  2695.                             history file (in fact it is from one  history
  2696.                             file to another - 'source' to 'destination').
  2697.  
  2698.  
  2699.  
  2700.  
  2701.         Processing multiple job account numbers
  2702.  
  2703.  
  2704.              There are two ways to process multiple job account numbers.
  2705.  
  2706.              1.   First  you can create plain ASCII file with up  to  128
  2707.                   job account numbers, one number on each line.  In  ZLOG
  2708.                   command line (/P switch) instead of specifying  account
  2709.                   number  (6th parameter) you specify  @file-name,  where
  2710.                   file-name  is  the  name of your ASCII  file.   If  you
  2711.                   specified all other parameters correctly, ZLOG will run
  2712.                   without  going into interactive mode.  If  you  omitted
  2713.                   some  parameter(s)  ZLOG will display  process  options
  2714.                   screen  (job account field will contain  '@   <table>')
  2715.                   and  there you will have the chance to review your  job
  2716.                   account  table and modify it.  Every time cursor  rests
  2717.                   on  job account field (on the process options  screen),
  2718.                   you can press Enter key for job account table window to
  2719.                   pop up.  Here you have full editing capabilities.
  2720.  
  2721.                   If  you choose, you can specify new job  account  table
  2722.                   file  name (in job account field on the main screen)  -
  2723.                   just  type '@' in the first position and press  Tab  or
  2724.                   Enter.  Small window with 'file name?' prompt pops  up.
  2725.                   You can also specify single job account number by  sim-
  2726.                   ply overtyping job account field (on the main screen  -
  2727.                   reading '@  <table>).  In that case previous specifica-
  2728.                   tion of job account table will be disregarded.
  2729.  
  2730.              2.   Bring up ZLOG process screen by typing:
  2731.  
  2732.                             ZLOG/P
  2733.  
  2734.                   Change all the fields as needed.  At job account  field
  2735.                   enter '@' in the first position and press Tab or Enter.
  2736.                   'file  name?' window pops up asking you for a  job  ac-
  2737.                   count  table file name.  Ignore it, just  press  Enter.
  2738.                   Job  account table window will pop up with first  entry
  2739.                   already filled up with all '?' (this will match any job
  2740.                   account  number).  Edit the table as needed  and  press
  2741.                   ESC to exit and get back to the main screen.
  2742.  
  2743.  
  2744.  
  2745.                                      - Page 41 -
  2746.  
  2747.  
  2748.  
  2749.         ZLOG release 1.4 User's Guide
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.         Delete 'idle' records
  2757.  
  2758.  
  2759.              Between  two  programs running from the  command  line  (DOS
  2760.              prompt,  level 0) there is an idle period (when computer  is
  2761.              doing  nothing).   ZLOG  logs that time also  (if  the  idle
  2762.              switch  was set to Y(es) at installation time).   Number  of
  2763.              these 'idle' records can be quite large.  On average 40%  of
  2764.              the  log  records are 'idle' records.  They do not  take  as
  2765.              much  disk  space  as 'regular' log records,  but  they  are
  2766.              there.   Program (phase) name for these records is  recorded
  2767.              as a space.
  2768.  
  2769.              If  you  want to 'clean up' your log (or log  history)  file
  2770.              from  these records, specify program name as a space in  re-
  2771.              cords selection criteria and choose 'delete' function.
  2772.  
  2773.  
  2774.  
  2775.         Reducing size of the log file
  2776.  
  2777.  
  2778.              ZLOG records every step you have done on your PC.  Even idle
  2779.              periods  (when computer was waiting) are recorded.  Log  re-
  2780.              cords are compressed but the number of log records can  grow
  2781.              quite  large.  If your PC activity is high volume, log  file
  2782.              can take good portion of valuable disk space.  There are two
  2783.              ways to reduce size of the log file.
  2784.  
  2785.                   1.        Specify N(o) for idle switch in  installation
  2786.                             procedure,  screen  #2.  This  will  suppress
  2787.                             logging of 'idle' periods.  On average 40% of
  2788.                             the  log  records are 'idle'  records.   Even
  2789.                             when you run your programs one after  another
  2790.                             (in the batch), there is a short waiting  pe-
  2791.                             riod between the steps that is recorded.   If
  2792.                             amount  of 'idle' time is not that  important
  2793.                             to you, set this switch to N(o).
  2794.  
  2795.                   2.        Set maximum program level to be recorded to 1
  2796.                             (installation  procedure, screen  #2).   This
  2797.                             will log into single log record all the steps
  2798.                             that run at higher levels.  For more informa-
  2799.                             tion  about program levels see section  'Pro-
  2800.                             gram levels', chapter 'Running ZLOG'.  If you
  2801.                             have complex program packages where  programs
  2802.                             are calling each other, then everything  will
  2803.                             be  recorded  under name of  the  main  phase
  2804.  
  2805.  
  2806.  
  2807.                                      - Page 42 -
  2808.  
  2809.  
  2810.  
  2811.                                                              Useful hints
  2812.  
  2813.  
  2814.  
  2815.                             (program at level 1).  For example if you set
  2816.                             maximum  level  to 1 and you  run  your  word
  2817.                             processor  you might do a spell-check  first,
  2818.                             then  import some graphics into document  and
  2819.                             maybe create one outline document.  These are
  2820.                             different programs (steps) and if you did not
  2821.                             set the maximum level to 1, they would be all
  2822.                             recorded in separate log records.  Since  you
  2823.                             set the maximum level to 1, all steps will be
  2824.                             recorded  under your word processing  program
  2825.                             name in a single log record.
  2826.  
  2827.  
  2828.  
  2829.         Running 'menu' program after sign ON
  2830.  
  2831.  
  2832.              Perhaps you have your favorite 'menu' program that you  want
  2833.              to become active after you sign ON.  ZS (ZLOG's sign  ON/OFF
  2834.              module) does not allow you to run automatically any programs
  2835.              inside it.
  2836.  
  2837.              But  there is a way around it.  What you need is  one  small
  2838.              batch  file  (.BAT) which you'll use to sign on or  to  sign
  2839.              off.   This file must be somewhere in DOS path, so that  DOS
  2840.              can find it.  Create this file using your text editor.   You
  2841.              can call it, for example, SIGN.BAT:
  2842.  
  2843.                        @echo off
  2844.                        zs %1 %2 %3
  2845.                        menu-prog - command to activate your menu program
  2846.  
  2847.              As  you know, ZS accepts 0 - 3 parameters from  the  command
  2848.              line  (ON/OFF,  opID and password).  Let's say  you're  done
  2849.              with your work and you want to sign off.  First, you  should
  2850.              exit your menu program (return to DOS).  Then you type:
  2851.  
  2852.                        SIGN  OFF      - sign.bat is your batch file
  2853.  
  2854.              ZS  will sign you off and wait for the next person  to  sign
  2855.              on.   After next sign on is complete, ZS will terminate  and
  2856.              DOS will run next command from SIGN.BAT file, which is  com-
  2857.              mand  to activate your menu program.  Instead of 'sign  off'
  2858.              you can type sign on command immediately.  Type:
  2859.  
  2860.                        SIGN  ON  opID  psw
  2861.  
  2862.              Of course, your AUTOEXEC.BAT file should have these two com-
  2863.              mands as a very last two lines:
  2864.  
  2865.                        zs off              (or on)
  2866.                        menu-program
  2867.  
  2868.  
  2869.                                      - Page 43 -
  2870.  
  2871.  
  2872.  
  2873.         ZLOG release 1.4 User's Guide
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.              This way, after initial sign on, menu will be activated  au-
  2880.              tomatically.
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.                                      - Page 44 -
  2932.  
  2933.  
  2934.  
  2935.                                         ZLOG in multi-tasking environment
  2936.  
  2937.  
  2938.  
  2939.         ZLOG in multi-tasking environment
  2940.  
  2941.  
  2942.              ZLOG can properly operate in multi-tasking environment,  al-
  2943.              though you have to perform some extra steps.
  2944.  
  2945.              LAN environment:
  2946.  
  2947.              Start  ZLOG in each workstation.  Log file should be on  the
  2948.              locally  attached disk (if it was on server, concurrent  up-
  2949.              date  of log file might occur and some of log data might  be
  2950.              lost).  Once in a while you can combine all workstations log
  2951.              files  into one log (or log history) file.  Suggestion:  in-
  2952.              clude  workstation id as a part of all account  numbers  you
  2953.              are using.
  2954.  
  2955.              Multi-user operating system (such as PC-MOS/386):
  2956.  
  2957.              Start ZLOG in each task.  Log file name should be  different
  2958.              for  each  task.   For  example: in  task  #1  it  might  be
  2959.              C:\TASK1.LOG, in task #2 it might be C:\TASK2.LOG  etc.   If
  2960.              you  had same log file for all the tasks, concurrent  update
  2961.              of log file might occur and some of log data might be  lost.
  2962.              Later on (same as in LAN environment) you can combine  these
  2963.              log  files into one file.  Suggestion: include task id as  a
  2964.              part of all account numbers you are using.
  2965.  
  2966.              Multi-tasking (such as DESQview):
  2967.  
  2968.              Do not start ZLOG before your multi-tasking program.   Start
  2969.              it  in  each task.  Give different log file names  for  each
  2970.              task.   If you had same log file for all the tasks,  concur-
  2971.              rent  update  of log file might occur and some of  log  data
  2972.              might  be lost.  Later on (same as in LAN  environment)  you
  2973.              can combine these log files into one file.  For each of  the
  2974.              programs you want to run in multi-tasking environment create
  2975.              a  batch file (below) and run this (batch) file  instead  of
  2976.              your program.
  2977.  
  2978.              Batch file:
  2979.  
  2980.                        echo off
  2981.                        zlog/f= ...    specify all the parameters you need
  2982.                        prog-name
  2983.  
  2984.              Task switching (such as Software Carousel):
  2985.  
  2986.              Do not start ZLOG before task switcher program.  Start  ZLOG
  2987.              in each task (partition) you use.  Once started ZLOG records
  2988.              everything you run in that particular partition.
  2989.  
  2990.  
  2991.  
  2992.  
  2993.                                      - Page 45 -
  2994.  
  2995.  
  2996.  
  2997.         ZLOG release 1.4 User's Guide
  2998.  
  2999.  
  3000.  
  3001.              You  might  want to experiment for a day or two  before  you
  3002.              make  final decision how to run ZLOG in multi-tasking  envi-
  3003.              ronment.   Suggestion about having different log  files  for
  3004.              each task is vital.
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054.  
  3055.                                      - Page 46 -
  3056.  
  3057.  
  3058.  
  3059.                                                  Incompatibility problems
  3060.  
  3061.  
  3062.  
  3063.         Incompatibility problems
  3064.  
  3065.  
  3066.              Resident  portion of ZLOG is 'well' behaved TSR  (terminate-
  3067.              and-stay-resident) program.  It does not 'steal' any DOS in-
  3068.              terrupts.  Therefore it is compatible with most PC  programs
  3069.              on the market today.  If you should experience any  problems
  3070.              with other TSR programs you may have, change the sequence of
  3071.              installation in the memory.  Try to install resident portion
  3072.              of ZLOG as a last TSR.  If that does not help, try with max-
  3073.              imum  log  level set to 1 (type:  ZLOG/L=1).  In  any  case,
  3074.              please let us know about that.
  3075.  
  3076.              As of now we do not know about any incompatibility problems.
  3077.              We  did not hear (so far) that some software refused to  run
  3078.              while ZLOG was active.
  3079.  
  3080.              Please report any problems that you may have using ZLOG with
  3081.              your other programs.  Our goal is to make ZLOG 100% compati-
  3082.              ble with ALL PC software on the market (even with not  'well
  3083.              behaved'  programs).  We are constantly working on  improve-
  3084.              ments and new features of ZLOG.  Any comments,  suggestions,
  3085.              information and (especially) criticism are very welcome.
  3086.  
  3087.  
  3088.  
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.  
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.                                      - Page 47 -
  3118.  
  3119.  
  3120.  
  3121.         ZLOG release 1.4 User's Guide
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.  
  3130.                           This page intentionally left blank
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.                                      - Page 48 -
  3180.  
  3181.  
  3182.  
  3183.                                              Word about security and IRS
  3184.  
  3185.  
  3186.  
  3187.         Word about security and IRS
  3188.  
  3189.  
  3190.              ZLOG is useful for documenting the use of a computer in sup-
  3191.              port of income tax deductions.  ZLOG creates secure, tamper-
  3192.              resistant binary log files.  These files are encrypted using
  3193.              different algorithms and are, up to the certain level,  pro-
  3194.              tected from change.  If somebody tampers with the log  file,
  3195.              most likely the file integrity will be compromised and  ZLOG
  3196.              will detect it.
  3197.  
  3198.              ZLOG  can maintain a log of computer use that satisfies  and
  3199.              complies  with  the 1985 Internal Revenue Service  rules  in
  3200.              connection  with  reporting business and personal use  of  a
  3201.              computer.   It is also useful to document computer usage  in
  3202.              the  normal  course of business for special  projects  where
  3203.              certain income tax regulations may apply.
  3204.  
  3205.              The United States Congress repealed the mandatory log;  how-
  3206.              ever,  income tax agencies may require proof of use in  sup-
  3207.              port of tax deductions.  Further, the rules and  regulations
  3208.              vary from State to State.  If you use ZLOG for this purpose,
  3209.              you are, hereby, advised to check with your certified public
  3210.              accountant  or tax counsel before using ZLOG to satisfy  in-
  3211.              come tax rules and regulations.  Regulations and interpreta-
  3212.              tion  thereof, may change from time to time.  The author  of
  3213.              ZLOG  accepts no responsibility in this regard and  by  your
  3214.              use of ZLOG, you agree to hold the author harmless from  any
  3215.              damages  or  losses arising out of its use.  The  author  of
  3216.              ZLOG makes no warranties, either expressed or implied.
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.                                      - Page 49 -
  3242.  
  3243.  
  3244.  
  3245.         ZLOG release 1.4 User's Guide
  3246.  
  3247.  
  3248.  
  3249.  
  3250.  
  3251.  
  3252.  
  3253.  
  3254.                           This page intentionally left blank
  3255.  
  3256.  
  3257.  
  3258.  
  3259.  
  3260.  
  3261.  
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.                                      - Page 50 -
  3304.  
  3305.  
  3306.  
  3307.                                                              Getting help
  3308.  
  3309.  
  3310.  
  3311.         Getting help
  3312.  
  3313.  
  3314.              If you have any problems using ZLOG you can call us any time
  3315.              at  (312)  275-0029.  If nobody is near  the  phone,  please
  3316.              leave  a message on the machine and we will get back to  you
  3317.              shortly (usually within next hour or two).  The best time to
  3318.              call is evenings (Central Standard Time) and weekends.  Sug-
  3319.              gestions, ideas and (especially) criticism are very welcome.
  3320.  
  3321.  
  3322.  
  3323.  
  3324.  
  3325.  
  3326.  
  3327.  
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.  
  3335.  
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.  
  3364.  
  3365.                                      - Page 51 -
  3366.  
  3367.  
  3368.  
  3369.         ZLOG release 1.4 User's Guide
  3370.  
  3371.  
  3372.  
  3373.  
  3374.         User feedback form
  3375.  
  3376.  
  3377.  
  3378.                          >>>>> ZLOG USER FEEDBACK FORM <<<<<
  3379.  
  3380.  
  3381.              Date           :___________________________________________
  3382.  
  3383.              ZLOG serial #  :___________________________________________
  3384.  
  3385.              Contact person :___________________________________________
  3386.  
  3387.              Phone          :(______)___________________________________
  3388.  
  3389.              Machine/memory :___________________________________________
  3390.  
  3391.              Operating Sys  :___________________________________________
  3392.  
  3393.              Disk type      :___________________________________________
  3394.  
  3395.  
  3396.              Severity of a problem:   0 - Suggestion
  3397.                                       1 - Minor problem
  3398.                                       2 - Avoidable problem
  3399.                                       3 - Unavoidable problem
  3400.  
  3401.  
  3402.              Description:
  3403.  
  3404.  
  3405.  
  3406.  
  3407.  
  3408.  
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.                                      - Page 52 -
  3428.  
  3429.  
  3430.  
  3431.  
  3432.  
  3433.  
  3434.  
  3435.  
  3436.  
  3437.  
  3438.  
  3439.  
  3440.  
  3441.  
  3442.  
  3443.  
  3444.  
  3445.  
  3446.  
  3447.  
  3448.  
  3449.  
  3450.  
  3451.  
  3452.  
  3453.  
  3454.  
  3455.  
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.  
  3463.  
  3464.  
  3465.  
  3466.  
  3467.  
  3468.  
  3469.  
  3470.  
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.  
  3477.  
  3478.  
  3479.  
  3480.  
  3481.  
  3482.  
  3483.  
  3484.  
  3485.  
  3486.  
  3487.  
  3488.  
  3489.                                      - Page 53 -
  3490.  
  3491.  
  3492.