home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / networks / idgtrs28.zip / TRS.DOC < prev    next >
Text File  |  1993-09-09  |  50KB  |  1,107 lines

  1.                      TIME-REPORTING SYSTEM
  2.                      =====================
  3.  
  4.                          Version 2.8
  5.  
  6.                       IDG Micro Products
  7.             Copyright 1992,1993. All rights reserved.
  8.  
  9.                   Programs and Documentation
  10.  
  11. This Time-Reporting System is a Shareware product and is freely
  12. available from User groups, Bulletin Boards or other sources.
  13. Shareware is NOT public domain software. It is user-supported
  14. software.
  15.  
  16. You have the opportunity to see whether the programs suit your
  17. company's needs and improve your company's efficiency. If you find
  18. that they do, please send the requested registration fee of $80 U.S
  19. or $95 Canadian together with a completed, printed copy of the
  20. registration form found in the REGISTER.FRM file to:
  21.  
  22.                       IDG Micro Products
  23.                   PO Box 26544, Markville RPO
  24.                    Markham, Ontario  L3R 0M4
  25.                             Canada
  26.  
  27. ----------------------------------------------------------------
  28. |                                                              |
  29. |                FREE Additional Programs !                    |
  30. |                                                              |
  31. |  ALL REGISTERED USERS will receive a copy of the TRSSPV,     |
  32. |  TRSWRK, TRSRCP and TRSRPT programs, described in more       |
  33. |  detail elsewhere in this documentation.                     |
  34. |                                                              |
  35. ----------------------------------------------------------------
  36.  
  37. If you should come across any bugs or have any comments regarding
  38. the programs or suggestions for improvements, please send them to
  39. the address above. If you would like a reply, please include a
  40. stamped, self-addressed envelope.
  41. In the case of bugs, a copy of the files, an indication of what
  42. action caused the problem and the exact wording of any error
  43. messages would be helpful.
  44.  
  45.                           DISCLAIMER
  46.  
  47. Under no circumstances shall the Author be liable for any damages,
  48. including loss of profit, data or use of the software, or special,
  49. incidental or consequential damages or other similar claims, even
  50. if specifically advised of the possibility of such damages.
  51.  
  52. Remember that Shareware can only exist as long as YOU support it!
  53.                      TIME-REPORTING SYSTEM
  54.                      =====================
  55.  
  56.                       System Documentation
  57.  
  58. The Time Reporting System (TRS) is designed to replace the
  59. inefficient "in-out" boards generally found in reception areas.
  60. The TRS is a PC-based system running on Novell networks and allowing
  61. employees to indicate their current whereabouts in order to improve
  62. the company's internal communication and the efficiency of the
  63. receptionist(s) when handling client telephone calls.
  64.  
  65. The TRS consists of one or more Time Reporting Consoles (TRC),
  66. dedicated PCs found at receptionist desks as well as dedicated
  67. Time Recording Units (TRU) and/or other PCs hooked up to the network.
  68.  
  69. The Consoles will display for each employee whether he/she is "in"
  70. or "out" and, if "out", the reason for the absence and the expected
  71. time of return. The receptionist also has the ability to add and
  72. change employee information, including booking people out for
  73. prolonged periods (i.e. business trips, vacations, sick leave etc),
  74. correcting mistakes due to failure by an employee to book in or out
  75. during the day and change the system server's clock time.
  76.  
  77. Recording Units are one or more dedicated PCs used by employees to
  78. log their in/out activity during the day. It can also be used by
  79. employees who expect to be in late the next working day.
  80.  
  81. Other PC workstations on the network can do what the TRU does and,
  82. in addition, can display the current whereabouts of other employees
  83. in a format identical to that at the receptionist station. However,
  84. they cannot perform any updates on that information.
  85.  
  86. HARDWARE REQUIREMENTS
  87. =====================
  88.  
  89. In order to use the system you need
  90.  
  91. 1)   a PC Lan running Novell Netware.
  92. 2)   a network server with free hard disk space of at least 200 Kb
  93.      per employee listed (average 1-year's worth of data).
  94. 3)   One dedicated PC or compatible per receptionist (386 or faster
  95.      is preferred)
  96. 4)   One dedicated PC or compatible as a TRU (basic PC will do)
  97.  
  98.      Having other PCs or compatibles on the network will greatly
  99.      enhance the effectiveness of the system.
  100. THE PROGRAMS
  101. ============
  102.  
  103. The Time Reporting System includes the following programs:
  104.  
  105. TRSCLK
  106.  
  107. This is the main program of the TRS system and performs the functions
  108. necessary to maintain the information kept in the various files and
  109. to display the current in/out status for all employees.  In order
  110. to ensure a high degree of data integrity, all functions the program
  111. performs, with the exception of the attendance information display
  112. function, require passwords. This program should run on a dedicated PC
  113. and, for proper operation of the system, should be running at all times.
  114.  
  115. There are two levels of security access through passwords:
  116.  
  117. a)  a basic level, used by receptionists and
  118. b)  a supervisory level for access to the more sensitive
  119. information on the system. (See also "Set Passwords").
  120.  
  121. TRSSTN
  122.  
  123. This program should run on one or more dedicated PCs and should be
  124. active at all times. It allows employees to record their in/out
  125. activity during the day and to indicate that they will be in late,
  126. or will not be in at all, the next working day. (See also User
  127. documentation for the TRSSTN and TRSWRK programs).
  128.  
  129. TRSRCP (Available only to registered users)
  130.  
  131. Identical to TRSCLK, this program should be used if more than one
  132. receptionist is on the system using the same files as TRSCLK.
  133. DO NOT run more than one copy of TRSCLK, using the same data files,
  134. at one time. This will cause unpredictable results particularly at
  135. year-end. The TRSCLK program must have run before TRSRCP can be
  136. executed. (See also "Year end operation");
  137.  
  138. TRSSPV (Available only to registered users)
  139.  
  140. This is a modified version of the TRSCLK program for individuals
  141. with supervisor level access. It is almost identical to TRSCLK asfar
  142. as functionality is concerned. The main difference is that a
  143. supervisor password is required to get into the program, after
  144. which no more passwords are required for any functions. TRSSPV will
  145. also allow access to data from prior years. Individuals without
  146. Supervisor access cannot run this program.  (Note: The TRSCLK
  147. program must have run before TRSSPV can be executed).
  148.  
  149. TRSWRK (Available only to registered users)
  150.  
  151. This program performs the same functions as TRSSTN and, in
  152. addition, allows the users to display the whereabouts of other
  153. employees in a format similar to that on the Reporting Console.
  154. However, no updates on that information are possibe. If the network
  155. is so configured, this program can be used by anyone on the network.
  156. TRSRPT (Available only to registered users)
  157.  
  158. This program produces summary and detail reports on the in/out
  159. activity of employees. (Information on sample reports can be
  160. found in the TRSRPT documentation).
  161. The required reports can be shown on screen or can be routed to a
  162. printfile for hardcopy.
  163.  
  164. HOW TO INSTALL & RUN THE PROGRAMS
  165. =================================
  166.  
  167. Install the programs by coping all files into a new or existing 
  168. directory. To execute any of the programs, enter the following 
  169. at the prompt:
  170.  
  171. program-name  [ path-name ]
  172.  
  173. program-name:  Use the name of the program you wish to execute.
  174.  
  175. path-name:  This item is optional. If omitted, the TRS files are
  176. expected in the same directory as the TRS programs. If they are not,
  177. specify the full path name of where the data files are located or
  178. where they are to be created and terminate the path with a backslash.
  179.  
  180. i.e. trsclk                  (files in same directory as the programs)
  181. or   trsclk c:\clock\data\   (files in c:\clock\data directory)
  182.  
  183. The programs will run both in color and black and white depending
  184. on configuration. The proper selection will be made automatically.
  185. Use the Esc key to cancel any operation or to exit the programs.
  186. (To exit the TRSSTN program type Q when asked for employee number).
  187.  
  188. ERROR MESSAGES
  189. ==============
  190.  
  191. If a fatal error occurs the system will issue an explanatory message.
  192.  
  193. Messages starting with F-xxx/xxxnn indicate fatal file errors.
  194. For those messages where nn is
  195.  
  196. 02 or 30  --  a data file has been corrupted. Use a backup copy of
  197. the file to replace it or create a new file in another directory
  198. using the TRSCLK program and replace it.
  199.  
  200. 14,15,18,19 or 25  --  the disk may be full. Delete unnecessary files
  201. and restart the program.
  202.  
  203. 80,82,84,85,86 or 87  --  restart the program. If unsuccessful,
  204. log out, log back in and try again.
  205.  
  206. For file errors with other numbers or if the above solutions do not
  207. work, contact IDG Micro Products by sending any pertinent information
  208. and copies of the data files to the address on page 1. THE FILES
  209. =========
  210.  
  211. The TRSCLK program, when first executed, will create four files
  212. in the program directory or the directory specified by "path name".
  213. If a path is specified, this directory must be created prior to
  214. executing this program.
  215.  
  216. EMPLOYEE.Bxx
  217.  
  218. This file will contain all employee related information. It is
  219. empty when created. When first executing the program, start by
  220. entering employee information.  Employees once added cannot be
  221. deleted. They can however be unlisted from the attendance display
  222. screen. (See also "Year-end operation" below).
  223.  
  224. REASON.Bxx
  225.  
  226. This file contains absentee reason codes. Reason codes "A" thru
  227. "L" are assigned by the system and are added when the file is
  228. created for the first time. These codes can be disabled but cannot
  229. be changed by the user with the exception of the Work/No Work
  230. indicator. (Reason codes E and I through L cannot be changed at
  231. all).  Codes "M" thru "W" are user-definable and, although they can
  232. be disabled at any time, cannot be deleted once defined. (See also
  233. "Year-end operation" below).
  234.  
  235. HOLIDAY.Bxx
  236.  
  237. This file will contain information on all statutory holidays and
  238. other days on which the office will be officially closed. These
  239. days should be entered as soon as possible after installation. For
  240. proper year-end operation, add days early in the following year as
  241. well (i.e. January 1).  This file can also be used for dates related
  242. to automatic changeover to and from daylight savings time.
  243. (See also "Maintain Holiday Schedule").
  244.  
  245. TIME.Bxx
  246.  
  247. This file will contain one record for every day on which an
  248. employee has been in the office or was booked off as being absent
  249. for an extended period, such as holidays, sick leave etc. No
  250. records will be created for dates listed in the Holiday file or
  251. for weekends, except when an employee has actually booked in or out
  252. on such days or for working days on which the employee was not in.
  253.  
  254. The "xx" in the Bxx file extension indicates the year to which the
  255. file pertains (i.e. EMPLOYEE.B91 is for the 1991 employee file).
  256. YEAR-END OPERATION
  257. ==================
  258.  
  259. The TRSCLK program will automatically create new data files for the
  260. new year. This can happen under the following scenarios:
  261.  
  262. TRSCLK program active
  263. =====================
  264.  
  265. If the program is running on midnight, December 31, a new set of
  266. files will be created with an extension indicating the new year.
  267. Contents of the new files will be as follows:
  268.  
  269. Employee file:  All employee records will be copied from the
  270. previous year with the exception of those employees whose records
  271. indicate they are no longer with the company.
  272.  
  273. Holiday file:  Will contain all records from the old file which
  274. are in what is now the current year. Records pertaining to the year
  275. just passed will not be copied.
  276. (Please note: January 1st of the year following the current year
  277. should always be included in the Holiday file for people who want
  278. to book in late the next working day at year's end. (See also the
  279. TRSSTN and TRSWRK User documentation, options "B" and "L").
  280.  
  281. Reason file:  Will contain reason codes "A" thru "L" and all user-
  282. defined reason codes which were not disabled at the time.
  283.  
  284. Time file:  As long as files for the new year do not exist, the
  285. TRSSTN and TRSWRK programs will have been reporting all time
  286. transactions in last year's Time file. Therefore, TRSCLK will copy
  287. all records for the new year which were logged in last year's Time
  288. file, into the new Time file. Such records are subsequently deleted
  289. from last year's file. If no such records are found, the new Time
  290. file will be empty.
  291.  
  292. TRSCLK program NOT active
  293. =========================
  294.  
  295. If the program is not active on midnight December 31 (i.e. program
  296. was deliberately terminated or was halted because of a power
  297. failure or other unforeseen circumstance), and is started in the
  298. new year, it will perform the same functions as if it had been
  299. active at midnight on December 31.
  300.  
  301. Please note that, in both scenarios, TRSCLK will create empty files
  302. for those it cannot find from last year.
  303.  
  304. PLEASE NOTE:  Running more than one copy of TRSCLK, using the same
  305. data files, can cause serious, unpredictable results particularly at
  306. year-end. Make sure ONLY ONE copy of TRSCLK is active at any one
  307. time. Use TRSRCP if multiple receptionists are on the system.
  308. TRSSPV/TRSRCP programs active
  309. =============================
  310.  
  311. Both programs will issue a message at midnight and will wait for the
  312. TRSCLK program to create files for the new year. Once these files are
  313. created, the program will resume normal operations.  The programs can
  314. be terminated if desired while waiting for new file creation.
  315.  
  316. TRSSTN program active
  317. =====================
  318.  
  319. The program will check to see if files for the new year have been
  320. created. If no such files are found it will continue to process
  321. transactions in the old files until the new year's files have been
  322. created. It will then open the new year's files.
  323.  
  324. TRSWRK program active
  325. =====================
  326.  
  327. Identical to TRSSTN. As long as files for the new year are not found,
  328. the "D" option will display information from last year's files.
  329.                  TRSCLK/TRSSPV/TRSRCP Programs
  330.                  =============================
  331.  
  332.                       User documentation
  333.  
  334. Upon initial execution, the program will display status information
  335. on the opened files.  (When TRSCLK is executed for the first time it
  336. creates new files in the path specified in the execute statement).
  337.  
  338. When executing the TRSCLK/TRSRCP programs, the current date and time
  339. are shown. Should the time information be incorrect, changes can be
  340. made from the main menu (See "The Main Menu").  Changes to incorrect
  341. date information should be made by the person responsible for the
  342. network and cannot be made through these programs. Press any key to
  343. proceed to the Main Menu.
  344.  
  345. When running TRSSPV, enter the Supervisor password. (TRSSPV will
  346. terminate after receiving three incorrect passwords). When the
  347. correct password is given, it will display the Main Menu and will
  348. not require further passwords to execute any of its functions.
  349.  
  350. To execute any of the programs, enter the following at the prompt:
  351.  
  352. program-name  [ path-name ]
  353.  
  354. program-name:  Use TRSCLK, TRSSPV or TRSRCP depending on which
  355. program you wish to execute.
  356.  
  357. path-name:  This item is optional. If omitted, the TRS files are
  358. expected in the same directory as the TRS programs. If they are not,
  359. specify the full path name of where the data files are located or
  360. where they are to be created and terminate the path with a backslash.
  361.  
  362. i.e. trsclk                  (files in same directory as the programs)
  363. or   trsclk c:\clock\data\   (files in c:\clock\data directory)
  364. MAIN MENU
  365. =========
  366.  
  367. The Main Menu lists the available options.
  368. The required security levels for these options are as follows:
  369.  
  370. Option name                             Password required
  371. ===========                             =================
  372.  
  373. Maintain Employee data                  Reception or Supervisor
  374. Maintain Absentee Reason codes          Supervisor
  375. Maintain Holiday schedule               Supervisor
  376. Show Attendance Information             None
  377. Set System Time                         Reception or Supervisor
  378. Set Passwords                           Supervisor
  379. Access previous days' data              Supervisor
  380.  
  381. The default value for the supervisor password is "supervisor". For
  382. the receptionist it is "reception". Please note that passwords are
  383. case-sensitive.  (Check therefore to make sure the Caps Lock is not
  384. engaged when entering the password unless it was established that
  385. way!!).
  386.  
  387. To ensure the integrity of the system it is recommended that both
  388. passwords are changed as soon as possible after installation.
  389.  
  390. To cancel any operation in the program, get out of any function and
  391. to exit the program, press ESCape.
  392. Maintain Employee Data Sub Menu (Option "E")
  393. ============================================
  394.  
  395. Use this function to create and maintain employee records.
  396. Information includes last name, first name, telephone extension,
  397. the employee's regular working hours and information related to an
  398. extended absence (one full day or longer). The latter includes a
  399. reason for the absence and the period covered. This period may
  400. span years, i.e. from September 1, 1992 until February 16, 1993.
  401.  
  402. For every working day during the extended absence, the program will
  403. create a time record indicating the absence. On the day the period
  404. expires, the employee record will automatically be reset. To
  405. manually reset the absence information, update the employee record
  406. by entering "X" as the reason code. Periods of absence can be
  407. recorded in advance and will not interfere with the employee's
  408. transactions in the days prior to the absence.
  409.  
  410. The available options in this sub menu are as follows:
  411.  
  412. A    Add an employee
  413.      ===============
  414.  
  415.      To add an employee, the user is prompted for a number of items
  416.      required to set up a new employee record.
  417.  
  418.      Employee number
  419.  
  420.      Enter the number of the employee. (Valid range is between
  421.      1 and 999).
  422.  
  423.      Employee last name
  424.  
  425.      The last name can contain letters, spaces, apostrophies (')
  426.      and dashes (-) only. Its length cannot exceed 15 characters.
  427.  
  428.      Employee first name
  429.  
  430.      The first name can contain letters, spaces, apostrophies (')
  431.      and dashes (-) only. Its length cannot exceed 10 characters.
  432.  
  433.      Employee Telephone Extension
  434.  
  435.      Enter the employee's telephone extension. The extension is
  436.      optional and is not validated. Maximum length is 4 characters.
  437.  
  438.      Employee Start Time
  439.  
  440.      The regular start time of the employee. If no data is entered,
  441.      9:00 AM is used as the default. Times must be entered in a 24-
  442.      hr format, i.e. 800 for 8:00 AM, 1330 for 1:30 PM. (DO NOT
  443.      type the colon ':').
  444.      Employee Stop Time
  445.  
  446.      The regular stop time for the employee. The default here is
  447.      5:00 PM. Again, times must be entered in a 24-hr format.
  448.  
  449.      If errors are made during data entry, use the 'up' or 'down"
  450.      arrow keys to go to the field to be changed. Within the field,
  451.      use left and right arrow keys as well as the Home and End keys.
  452.      The Insert and Delete key can be used as appropriate.
  453.  
  454. C    Change employee information
  455.      ===========================
  456.  
  457.      Use this option to change the information for a given
  458.      employee.
  459.  
  460.      All information shown may be changed. Use the Enter key or the
  461.      UP/DN arrow keys to get to the field that needs change and
  462.      edit the field. If all necessary corrections have been made
  463.      before reaching the last field on the screen, press Ctrl-Enter
  464.      to complete the update.
  465.  
  466.      The information that can be changed is the same as that in the
  467.      "Add" function but also includes information on extended
  468.      absence from the office for any valid reason, the start date
  469.      of the absence and the expected date of return, as follows:
  470.  
  471.      Reason code
  472.  
  473.      Type the letter representing one of the valid reason codes
  474.      shown. (Some codes are restricted from use as a reason for
  475.      prolonged absence, i.e. coffee break, and will not show. See
  476.      also "Maintain Absentee Reason Codes Sub Menu"). To remove any
  477.      previously recorded absence from an employee record, type "X".
  478.  
  479.      Start and End dates
  480.  
  481.      Once a valid reason is entered, the program will prompt for
  482.      the start and end date of the absence period. Enter the dates
  483.      in the format YYMMDD, where YY are the last 2 digits of the
  484.      year, MM is the month (include leading zero) and DD is the day
  485.      (include leading zero).  I.e. 920601 for June 1, 1992.
  486.      Pressing return without data at the start date will insert
  487.      today's date. The Start date must be today's date or be in the
  488.      future and cannot be in the past. The End date must be larger
  489.      than the Start date.
  490.  
  491.      Please note that the "end" date is the day of expected return,
  492.      NOT the last day of the employee's absence. Therefore an
  493.      employee who is off for a week should have Monday as the date
  494.      of return and not the Friday.
  495.  
  496.      The period of absence may span years (i.e. 921005 to 930216).
  497. U    Unlist an employee
  498.      ==================
  499.  
  500.      Use this option to remove an employee from the attendance
  501.      display screen. The employee is not physically removed from the
  502.      system since there may be time records present. This option is
  503.      generally used when an employee's employment is terminated.
  504.      Employees who have been unlisted will not be copied to the new
  505.      Employee file at year's end.
  506.  
  507. R    Relist an employee
  508.  
  509.      This option is used to re-activate the listing on the attendance
  510.      display for employees who had been previously unlisted.
  511.  
  512. L    List employee information
  513.  
  514.      Information will be displayed for all employees on the system
  515.      at the present time, including employees who have been unlisted.
  516.      For any employees absent for the day or for a prolonged period,
  517.      the reason and the period of absence is also displayed.
  518.      The names of employees are listed a screen at a time. Press any
  519.      key to continue scrolling or ESC to abandon this option. The
  520.      arrow and page keys have no effect. Scrolling will be in forward
  521.      mode only.
  522. Maintain Absentee Reason Codes Sub Menu (Option "R")
  523.  
  524. The Reason code file is used to record and maintain information on
  525. valid reasons for an employee's absence. Reason codes "A" thru "L"
  526. are generated by the system and changes to them are restricted to
  527. the selection of paid versus unpaid leave, some cannot be changed
  528. at all.  The letters "M" thru "W" can be used as user-defined codes.
  529. (The letter "X" is reserved for cancelling absentee information
  530. from the employee record. See also "Change employee information").
  531.  
  532. Since codes are expected to be used after they have been added, no
  533. user defined codes can be removed from the file in the current
  534. year. The user can however disable these codes and all system
  535. generated codes and their use will, once disabled, no longer be
  536. possible unless and until they get enabled again.
  537.  
  538. At year-end all disabled user-defined codes are purged from the new
  539. year's Reason file.
  540.  
  541. The available options are as follows:
  542.  
  543. A    Add codes
  544.      =========
  545.  
  546.      Used to add absentee reason codes. Codes "A" thru "L" are pre-
  547.      assigned and are created automatically when TRSCLK is initially
  548.      executed. User definable codes are from "M" through "W". (The
  549.      letter "X" is used to cancel long term absence information in
  550.      the Employee record).
  551.  
  552.      When a code is added, it must have a description of no more
  553.      than 15 characters. Certain codes may not be used as a reason
  554.      for being late the "next working day" (i.e. Coffee Break,
  555.      Lunch, etc) and their use must be identified as being limited
  556.      to "today" or not. Reply "Y" to indicate that you want to
  557.      limit its use, otherwise respond with "N". For more
  558.      information on "next working day" absence, see the
  559.      TRSSTN/TRSWRK User documentation, options "B" and "L".
  560.  
  561.      User defined codes must also indicate whether time off for this
  562.      reason is considered 'work' or not. Make the appropriate selection.
  563.      The Work/Nowork indicator is only used for calculations in the 
  564.      reporting program TRSRPT. (Available to all registered TRS users).
  565.  
  566. C    Change codes
  567.      ============
  568.  
  569.      Use this option to change a reason code's existing information
  570.      by answering the various questions. (See also "Add codes" above).
  571.      No changes are allowed on some system generated codes while
  572.      others may only be changed to indicate whether they are to be
  573.      considered 'work' or not.
  574. D    Disable codes
  575.      =============
  576.  
  577.      Use this option to disable a reason code. Please note that
  578.      codes "A" thru "L" can be disabled but will, at year's end,
  579.      not be removed from the new Reason file, unlike user-defined
  580.      codes which will be removed when disabled.
  581.  
  582. E    Enable Codes
  583.      ============
  584.  
  585.      To reinstate a previously disabled code.
  586.  
  587. L    List codes
  588.      ==========
  589.  
  590.      Use this option to display a list of current absentee codes
  591.      on the screen. Press any key to continue scrolling, ESC to
  592.      abandon the scrolling. No backward scrolling possible.
  593. Maintain Holiday schedule (Option "H")
  594. ======================================
  595.  
  596. The Holiday file is used to help determine next working days. (For
  597. more information on "next working day", see also the TRSSTN/TRSWRK
  598. User documentation, options "B" and "L").  The dates in the file
  599. should represent all statutory holidays for the current year and any
  600. other days on which the office will be officially closed.
  601.  
  602. For example, an employee could indicate on Thursday April 16th that
  603. he/she will be in late the next working day by selecting the "B"
  604. or "L" option in the TRSSTN or TRSWRK program. Normally that would
  605. cause the system to recognize Friday, April 17th as the next working
  606. day. However, with April 17th (Good Friday) listed in the statutory
  607. holiday file, it will establish Monday, April 20th as the actual next
  608. working day and will therefore book the employee in late for that day.
  609.  
  610. An additional feature allows for the automatic handling of time changes
  611. associated with daylight saving time. Dates entered with descriptions of
  612. '-' or '+' will indicate the date on which the time is to be turned back
  613. (-) or advanced (+) by one hour. After the time adjustment is made on 
  614. that day, the record is removed from the holiday file.
  615.  
  616. The available options are as follows:
  617.  
  618. A    Add days
  619.      ========
  620.  
  621.      Used to add statutory holidays or other days on which the
  622.      office will be officially closed. Enter the date in the YYMMDD
  623.      format. This is followed by a brief description which should
  624.      be between 5 and 20 characters in length. Dates with descriptions
  625.      which contain only the '-' or '+' character will be interpreted
  626.      as daylight saving time records. The system time will be turned
  627.      back (-) or advanced (+) on that date by one hour.  Make sure
  628.      there is only one record of each and that the dates are correct.
  629.  
  630. C    Change days
  631.      ===========
  632.  
  633.      Used to change the description of the holiday. Limited to between
  634.      5 and 20 characters. No validation will take place. Descriptions
  635.      with only '-' or '+' will be interpreted as daylight saving time
  636.      days. (See also under "Add days" above for a description).
  637.  
  638. D    Delete days
  639.      ===========
  640.  
  641.      Use this function to physically delete a previously recorded
  642.      holiday from the system. The date removed cannot be recalled
  643.      and must be added again should it be required.  Dates which 
  644.      preceed the day of attempted deletion cannot be removed.
  645. L    List days
  646.      =========
  647.  
  648.      Use this option to display a list of current holidays. Press
  649.      any key to continue scrolling, ESC to abandon the scrolling.
  650.      No backward scrolling possible.
  651. Show Attendance Information (Option "S")
  652. ========================================
  653.  
  654. Employees are listed in alphabetical order by last name, with 22
  655. names per screen. The "up" and "down" arrow keys can be used to
  656. scroll through the names, as can the "Home", "PgUp" and "PgDn" and
  657. "End" keys. The "End" key will cause the last 22 names to be
  658. listed. For quicker access to a person's name, press the key with
  659. the first letter of the last name to start the display with the
  660. first person whose name starts with that letter.
  661.  
  662. Employee numbers may be preceeded by warning indicators '!!', '>' 
  663. or '='.  A '!!' indicates that there is an "out" time, which is NOT 
  664. past the person's recorded stop time and which does not have a reason 
  665. code or an "in" time which does. The problem could be the deletion of
  666. an existing time causing the shift from "in" to "out" for all 
  667. subsequent times. Use the Detail Time screen to fix the problem. 
  668.  
  669. The '>' indicator usually means that an employee has clocked in for 
  670. the day, even though the employee record indicates that he/she 
  671. will be out of the office for that day or that this is an unlisted 
  672. employee. 
  673.  
  674. The '=' indicator means that a time record was created but
  675. no longer contains any information. The record should be removed by
  676. someone with supervisor access or changed to indicate an absence or
  677. the appropriate in/out times.
  678.  
  679. These warning indicators are only meant to alert the receptionist 
  680. to a potential problem but have no effect on the operation of the 
  681. clock programs nor on the time data for that employee. 
  682. To exit the time display screen and return to the Main Menu, press
  683. ESC.
  684.  
  685. Detailed Time Information
  686. =========================
  687.  
  688. To see an employee's detailed "in-out" activity information for the
  689. day or to make changes and adjustments to these activities, cursor
  690. down to the employee whose information you want to see and press
  691. Enter.
  692.  
  693. To ensure the integrity of the information, access for the purposes
  694. of updates requires a password. Time records can be deleted by
  695. individuals with supervisor access only, using the "R" option.
  696. USE CAUTION WITH THIS OPTION.
  697.  
  698. The information displayed will show each time the employee has
  699. booked "in" or "out" during the day. For "out" times this should
  700. include the reason and time of return, unless the time is past the
  701. employee's normal working hours. Since each employee record holds 
  702. a maximum of 16 ins and outs and in order to conserve space, an 
  703. absence of 5 minutes or less is not recorded.
  704.  
  705. For the same reason, people who have indicated that they are in a
  706. meeting (reason codes "J" and "K") and who subsequently book back
  707. in or book out will have the meeting entry and the return entry
  708. removed. If the employee has not booked him/herself back in or out,
  709. the system will automatically delete the meeting entry when the
  710. indicated time of return is exceeded. If the "Not returning" option
  711. was used by the employee when booking out for the meeting, the
  712. system will NOT book him/her back in automatically. (See also the
  713. TRSSTN/TRSWRK User documentation, options "B" and "L").
  714. Information may be updated as indicated at the bottom of the screen.
  715. After entering a current password, the following options are available.
  716.  
  717. To make changes to the recorded in-out times.
  718.  
  719. A    Add a time to the employee record
  720.      =================================
  721.  
  722.      This option is used to add an "in" or "out" time to the
  723.      employee record. The time entered (based on a 24-hr clock,
  724.      i.e. 3:00 PM must be entered as 1500) will automatically be
  725.      inserted in its chronological order. As a result, all times
  726.      following the time entered will be moved up one position.
  727.      Since the times are recorded in an in-out-in-out fashion,
  728.      this will cause these later times to go from "in" to "out"
  729.      and vice-versa. Further adjustments may therefore be necessary.
  730.  
  731.      The time to be inserted will be interpreted to be an in or out
  732.      time by its chronological order. Adding an "in" time therefore
  733.      requires only a time to be entered, while "out" times also
  734.      require a reason and time back. Hence, if you wish to insert
  735.      times between an "in" and an "out" time, the "out" time must
  736.      be recorded first, after which the earlier "in" time can be
  737.      added. If the times are to be inserted between an "out" and an
  738.      "in" time, the order in which they should be added is reversed.
  739.  
  740. C    Change an existing time
  741.      =======================
  742.  
  743.      Use this option to change an in/out time, reason or time of
  744.      return. If no data is entered, no changes will be made to the
  745.      existing field. Fields cannot be cleared. To delete a reason or
  746.      time of return from an "out" time, first delete the existing
  747.      time, then add it again without these fields.
  748.  
  749.      In/out times which are changed must be kept in chronological
  750.      order (i.e. the time of 2:30 PM which might be located between
  751.      1:00 PM and 4:00 PM can only be changed to a time between 1
  752.      and 4 PM. It cannot be changed to 5:00 PM).
  753.  
  754. D    Delete an existing time
  755.      =======================
  756.  
  757.      Use this option to delete a time shown on the list. As in
  758.      option "A" above, any deletion of a time will cause a change
  759.      in all times following that time from "in" to "out" and vice
  760.      versa. Further adjustments may therefore be necessary.
  761.  
  762. R    Remove this employee's time record
  763.      ==================================
  764.  
  765.      This option is only shown and available to individuals who
  766.      used the Supervisor password when entering the detail screen
  767.      or when in the TRSSPV program. The function removes the
  768.      complete time record for the selected employee from the Time      file and caution is therefore advised. Records, once deleted,
  769.      are NOT recoverable, although they can be reconstructed using
  770.      the "A", "B" or "L" options.
  771.  
  772.      PLEASE NOTE: If an employee is booked out on a long term
  773.      absence, the time record can be deleted but no changes will be
  774.      made to the employee record. The display will therefore still
  775.      show that the employee is absent. If this is NOT appropriate,
  776.      use the "U" option to reset the absence information in the
  777.      employee record by entering "X" as the absence reason.
  778.  
  779. To make changes to an employee record.
  780.  
  781. U    Update an employee record
  782.      =========================
  783.  
  784.      See the change option (Option "C") in the "Maintain Employee
  785.      Data Sub Menu" for further information.
  786.  
  787. L    Late today
  788.      ==========
  789.  
  790.      Use this option for employees who will be coming in late and
  791.      who did not book themselves in late by using the "B" or "L"
  792.      option in the TRSSTN/TRSWRK program the previous working day.
  793.      (See also the User documentation for these programs). Enter
  794.      the reason code for the absence and the expected time in.
  795.  
  796. B    Book a person out for the day
  797.      =============================
  798.  
  799.      This option is used to book a person out who is not going to
  800.      be in at all that day. It cannot be used for someone who has
  801.      been in and leaves again. If no long term absence is already 
  802.      recorded in the employee record or if the day preceeds the start 
  803.      date of such long term absence, this option updates the employee
  804.      record with the indicated reason for the absence, using today as
  805.      the start date and the next working day as the day of expected
  806.      return. If the date falls within the recorded absence, no change
  807.      to the employee record is made.
  808.      Please note that, should the current date fall outside the recorded
  809.      absence period, this information will be changed as if it had not 
  810.      been present. A warning will be given and the absence information
  811.      will have to be recorded again at a later date.
  812. Set System Time (Option "T")
  813. ============================
  814.  
  815. System clocks have the habit of straying and will therefore not
  816. always be accurate. This option will allow the user to set the
  817. system clock to accurately reflect the current time. The amount by
  818. which the time may be adjusted up or down is limited to 10 minutes
  819. for individuals with receptionist access. Supervisor level access 
  820. is required to make larger adjustments. (i.e. to reflect daylight 
  821. saving time, if that was not already taken care of by the presence 
  822. of special entries in the Holiday file). 
  823. (See also "Maintain Holiday Schedule")
  824.  
  825. To change the time, enter the new time information in the format
  826. HH:MM using a 24-hr clock (i.e. 16:45 for 4:45 PM). No leading
  827. zeros are required in the hours ( 9:30 versus 09:30 ). The
  828. semicolon (":") IS required here.
  829.  
  830. The time, if valid, WILL BE UPDATED.  Confirm the accuracy of the
  831. information when asked to do so. An "N" reply will repeat the
  832. process. Should you wish to exit without making changes to the
  833. current time shown on the top of the screen, press ESC or Enter
  834. without entering data.
  835.  
  836. NOTE: In order to make changes to the time information, the person
  837. making the change must have been assigned "console operator" privileges
  838. on the network or the update will fail.
  839. In case of multiple bridged networks, the time change will NOT be made
  840. across all servers but will be limited to the server used by TRS. Set Passwords (Option "P")
  841. ==========================
  842.  
  843. In order to safeguard the integrity of the information, the system
  844. offers two levels of access, each with its own password. A basic 
  845. password, used mostly by the receptionist to update the time and 
  846. employee information and a supervisor password, which allows 
  847. changes to be made to files and information at a higher level.
  848.  
  849. When TRSCLK is executed for the first time, the default
  850. Supervisor password is set to "supervisor", the basic password is
  851. set to "reception".  It is suggested that both passwords are
  852. changed to something new as soon as possible after installation.
  853.  
  854. To change the password(s), enter the Supervisor password (in case
  855. the password has not been changed since installation, enter
  856. "supervisor"). You will then be asked to enter the new Supervisor
  857. password of maximum 10 letters with no other characters allowed.
  858. Upper and lower case letters may be used, however, PLEASE NOTE:
  859. Passwords are case sensitive and must be entered exactly as they
  860. were recorded! Check Caps Lock if a problem arises.
  861.  
  862. Confirm the new password by entering the same information at the
  863. "Verify" prompt.  If the information is the same, the new password
  864. is now active.
  865.  
  866. The program will repeat the same procedure for the receptionist 
  867. password. If this password is the only one you wish to change, press
  868. Enter without data when asked for the NEW Supervisor password.
  869.  
  870. To exit from this function at any time press ESC.
  871.  
  872. NOTE: For your protection, the system features a built-in "back-door".
  873. Should you ever forget the Supervisor password or should it have
  874. been changed by someone else who previously had supervisor access,
  875. you can still get access to all the supervisor functions by requesting
  876. a collect telephone call to receive a temporary password which will
  877. allow you to update both passwords. Send your request to the author
  878. with your name and title, company name and address and phone number.
  879. Access Prior Days (Option "A")
  880. ==============================
  881.  
  882. This option allows individuals with Supervisor access to view and
  883. update employee time records for prior days in the current year.
  884. Once the required date is entered (in the format MMDD, leading zeros
  885. required), the user will see the "Show Attendance Information" screen
  886. with information for that date. All options and functions normally 
  887. available for today's date are also available on the newly selected 
  888. date. To return to today's date, press ESC until the Main Menu is 
  889. displayed.
  890.  
  891. The TRSSPV program, available to Registered Users only, will also 
  892. allow access to dates not only in the current year but also to dates 
  893. in files of prior years.
  894. The Supervisor will be prompted for the year first. If the required
  895. date is in the current year, press Enter, otherwise enter the 
  896. required year in the format YY, representing the last two digits in 
  897. the year.
  898.                     TRSSTN and TRSWRK Programs
  899.                     ==========================
  900.  
  901.                         User Documentation
  902.  
  903. The Time Reporting System (TRS) is designed to replace the
  904. inefficient "in-out" boards generally found in reception areas.
  905. The TRS is a PC-based system running on Novell networks and allowing
  906. employees to indicate their current whereabouts in order to improve
  907. the company's internal communication and the efficiency of the
  908. receptionist(s) when handling client telephone calls.
  909.  
  910. The TRS consists of one or more Time Reporting Consoles (TRC),
  911. dedicated PCs found at receptionist desks as well as dedicated
  912. Time Recording Units (TRU) and/or other PCs hooked up to the network.
  913.  
  914. The Consoles will display for each employee whether he/she is "in" 
  915. or "out" and, if "out", the reason for the absence and the expected
  916. time of return. The receptionist also has the ability to add and
  917. change employee information, including booking people out for
  918. prolonged periods (i.e. business trips, vacations, sick leave etc),
  919. correcting mistakes due to failure by an employee to book in or out
  920. during the day and change the system server's clock time.
  921.  
  922. Recording Units are one or more dedicated PCs used by employees to 
  923. log their in/out activity during the day. It can also be used by 
  924. employees who expect to be in late the next working day.
  925.  
  926. Other PC workstations on the network can do what the TRU does and,
  927. in addition, can display the current whereabouts of other employees
  928. in a format identical to that at the receptionist station. However,
  929. they cannot perform any updates on that information.
  930.  
  931. The TRSSTN and TRSWRK programs are used to record the in/out
  932. activity of employees over the course of the day. Employees must
  933. therefore book themselves in or out AT ALL TIMES, even if they are
  934. gone for only a short while. If a mistake is made at any time,
  935. prior to completing the transaction, press the ESCape key to cancel
  936. the current operation.
  937. To execute the TRSSTN/TRSWRK programs, enter the following at the
  938. prompt:
  939.  
  940. program-name   path-name
  941.  
  942. program-name:  Use TRSSTN or TRSWRK depending on which program you
  943. wish to execute.
  944.  
  945. path-name:  This item is optional. If omitted, the TRS files are
  946. expected in the same directory as the TRS programs. If they are not,
  947. specify the full path name of where the data files are located and
  948. terminate the path with a backslash.
  949.  
  950. i.e. trsstn                  (files in same directory as the programs)
  951. or   trsstn c:\clock\data\   (files in c:\clock\data directory)
  952.  
  953. For a controlled exit from the TRSSTN program, type "Q" when asked 
  954. for the employee number. (Make sure the letter Q is upper-case!).
  955.  
  956. To exit the TRSWRK program press ESCape until asked to confirm
  957. exiting the program.
  958.  
  959. The TRSWRK program, available only to Regsitered Users, offers two 
  960. initial options:
  961.  
  962. "B" option
  963. ==========
  964.  
  965. This option is used to book in or out. The procedure is identical
  966. to that of the TRSSTN program.
  967.  
  968. "D" option
  969. ==========
  970.  
  971. This option allows the employee to see a list of all employees,
  972. whether they are in or out of the office and when they will be
  973. back, starting with the letter A. To scroll through the employee
  974. names, use the PgUp, PgDn, Home and End keys or type the first
  975. letter of the last name. Arrow keys have no effect. This function
  976. cannot be used to change any of the information shown, nor is detail
  977. information available.
  978. The options in TRSSTN and TRSWRK (after selecting "B") are:
  979.  
  980. Coming into the office (Option "C")
  981. ===================================
  982.  
  983. After entering the employee number, a list of options will be shown
  984. as well as the employee's name.  After pressing "C" for Coming in,
  985. the system will log the employee in at the time the transaction
  986. was completed. This time will be shown upon completion of the
  987. transaction, except when the absence was less than five minutes.
  988.  
  989. If by accident a mistake was made in the employee number and the
  990. employee name shown IS NOT THE EMPLOYEE's, pressing the ESCape key
  991. will repeat the process.
  992.  
  993. Leaving the office (Options "G" and "L")
  994. ========================================
  995.  
  996. After entering the employee number, a list of options will be
  997. shown. There are two options when leaving the office.
  998.  
  999. "G" option:
  1000. ===========
  1001.  
  1002. If the employee leaves ON OR AFTER the end of his/her regular
  1003. working hours as recorded in the employee record, he/she will be
  1004. booked out as having left for the day and no further action is
  1005. necessary. If the employee leaves the office BEFORE the end of
  1006. regular working hours, a list of available absentee reason codes
  1007. is displayed. The appropriate code must be selected.
  1008.  
  1009. If the code selected is "B" (Coffee break) the system will
  1010. automatically put in an expected return time 15 minutes from the
  1011. time the employee books out. Otherwise, after selecting the 
  1012. appropriate reason code, a list of return times will be shown. 
  1013.  
  1014. The list of available times will vary with each employee and will 
  1015. reflect the available times, in half hour increments, between the 
  1016. then current time of day and the end of the employee's working 
  1017. hours. The expected time of return can be selected by typing the 
  1018. letter preceeding that time. The letter preceeding the option 
  1019. "Not returning" should be selected if the employee does not expect 
  1020. to return to the office again that day.
  1021.  
  1022. When using the "J" or "K" option to book out for a meeting, the
  1023. time the meeting is expected to end must be selected. The system
  1024. will automatically book the employee back in when that time is
  1025. reached. If the meeting is over sooner than expected or if the
  1026. employee chose the "Not returning" option when booking out for the
  1027. meeting, he/she should book in again using option "C". The meeting 
  1028. entry will always be removed when leaving the office using the 
  1029. "G" or "L" option.
  1030.  
  1031. If the time of booking out with this option is the first time for 
  1032. that day, the employee will be asked if he/she worked past midnight.
  1033. If the answer is no, then the employee must have forgotten to clock 
  1034. in earlier and a warning will be issued. 
  1035.  
  1036. If the employee did work past midnight, the system will book him/her 
  1037. in at one minute after midnight and out at the current time. It will
  1038. then check the previous day's record. If it finds the last recorded 
  1039. time to be an "in" time, it will book the employee out at 11:59 PM. 
  1040. If yesterday's last recorded time was an "out" time, NO changes will 
  1041. be made to the record.
  1042.  
  1043. "L" option:
  1044. ===========
  1045.  
  1046. If the employee leaves the office for the day and knows he/she will
  1047. be in late or not in at all the next working day, this option should
  1048. be used. Since it is a combination of the "G" option and the "B"
  1049. option, please see these options for more details.  Please note that
  1050. "next working day" is not necessarily considered tomorrow. If the
  1051. current day would be Friday, next working day would be Monday. If
  1052. Monday is a statutory holiday and is listed in the Holiday file, next
  1053. working day will be interpreted as Tuesday.
  1054.  
  1055. If the employee uses this option ON OR AFTER the end of the regular
  1056. working hours, the system will book him/her out as having left for
  1057. the day and offer selections for next working day ONLY consisting of
  1058. a reason and expected time in. (See also "B" option, outlined below).
  1059.  
  1060. If the employee leaves the office BEFORE the end of regular working
  1061. hours he/she will be taken through the same process as in option
  1062. "G", immediately followed by the selections for "Next working day"
  1063. (see below under option "B").
  1064.  
  1065. "B" option. Booking in late "Next working day"
  1066. =============================================
  1067.  
  1068. If the employee knows he/she will be in late or not in al all the
  1069. next working day, this option can be used at any time during the day.
  1070. Please note that "next working day" is not necessarily considered
  1071. tomorrow. If the current day would be Friday, next working day would
  1072. be Monday. If Monday is a statutory holiday, listed in the Holiday
  1073. file, next working day will be interpreted as Tuesday.
  1074.  
  1075. If a mistake is made in or if the employee wishes to make changes
  1076. to the reason or time of return when processing "Next working day"
  1077. transactions thru either the "B" or "L" option, the "B" option can
  1078. be used at any time to correct or change the information recorded
  1079. previously. The last information entered will override anything
  1080. previously recorded.
  1081.  
  1082. Should an employee have forgotten to book in late for the day or
  1083. to tell the receptionist of his/her absence that day, the
  1084. receptionist must be notified as soon as possible and advised of
  1085. the reason for the absence and the time of expected return.
  1086. If no reason was entered, such absence will be considered Personal
  1087. time off.
  1088.                       The TRSRPT Program
  1089.                       ==================
  1090.  
  1091. This program, available only to registered users of the TRS system,
  1092. produces summary and detail reports on the in/out activity of 
  1093. employees.
  1094.  
  1095. Reports can be shown on screen or can be routed to a printfile for
  1096. hardcopy and can be produced from any year's files.
  1097.  
  1098. Sample reports can be found in the files with extensions
  1099.  
  1100. HP  -  For HP Laserjet or compatible printers
  1101. 80  -  For any 80 character printers
  1102. 132 -  For any 132 character printers
  1103.  
  1104. To print these sample files, type > copy {filename} LPT1: (or other
  1105. printer port).
  1106.  
  1107. The menu choices within TRSRPT are self explanatory.