home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / FEDJOB10.ZIP / FEDJOBS.DOC < prev    next >
Text File  |  1994-10-23  |  16KB  |  373 lines
  1.  
  2.  
  3.                        ============================
  4.                           FedJobs! Listing Door
  5.                        ============================
  6.                        COPYRIGHT 1994 T&J Software
  7.                            ALL RIGHTS RESERVED
  8.  
  9.         One of the T&J Software Collection of multi-BBS door programs.
  10.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  11.                UltraBBS, Telegard, TriBBS, and Remote Access.
  12.  
  13.                     VERSION 1.00    October 23, 1994
  14.  
  15.                                    By
  16.  
  17.         Tom & Jane Wildoner                  Ken Regenfuse
  18.         397 West Broadway                    RD #1 Box 334A
  19.         Jim Thorpe, PA  18229                Reinholds, PA  17569
  20.         VOICE (717)325-9480                  VOICE (610)678-6664
  21.         *between 6:00 & 8:00 p.m.            *between 6:00 & 8:00 p.m.
  22.         Eastern Time                         Eastern Time
  23.  
  24.                                   From
  25.  
  26.         The T&J Software BBS                 The Docksider BBS
  27.         (717)325-9481 14.4                   (610)678-0350 28.8
  28.         (717)325-4369 28.8                   (610)670-7938 14.4
  29.         24 Hours/Day                         24 Hours/Day
  30.         tom.wildoner@channel1.com
  31.  
  32.  
  33. LATEST VERSION
  34. ~~~~~~~~~~~~~~
  35. Please call either of the above listed BBS's for the latest versions!
  36.  
  37. ┌─────────────────────────────────────────────────────────────────────┐
  38. │ NOTE: Once registered, you may download updated job databases from  │
  39. │ either The T&J Software BBS or The Docksider BBS. Updated databases │
  40. │ will only function if the door is REGISTERED. The updated database  │
  41. │ can be found on either of the above listed boards in FILE AREA #1.  │
  42. │ The following naming convention will be used:                       │
  43. │                     FJmmddyy.ZIP                                    │
  44. │ An updated database on November 15, 1994 would be on the BBS's as   │
  45. │ FJ111594.ZIP. When you download the updated database, simply unzip  │
  46. │ it in the FedJobs! directory....it's that simple!                   │
  47. └─────────────────────────────────────────────────────────────────────┘
  48.  
  49. LEGALITIES
  50. ~~~~~~~~~~
  51. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  52. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  53. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  54. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  55. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  56. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY. ONCE REGISTERED, ANY
  57. DISTRIBUTION OF THE REGISTERED KEY WILL INVALIDATE YOUR KEY IN ALL FUTURE
  58. VERSIONS OF THIS PROGRAM AND NO PRODUCT SUPPORT WILL BE GIVEN. DISTRIBUTING
  59. A REGISTERED KEY FILE WILL ALSO BRING ABOUT CRIMINAL CHARGES.
  60.  
  61. DISTRIBUTION
  62. ~~~~~~~~~~~~
  63. You may make this file available for downloading from your BBS or you may
  64. upload it to any BBS of your choice, provided that you do not make any
  65. changes to the contents of the archive (ZIP file). The archive and its
  66. individual contents may not be used by any service that charges any money
  67. whatsoever, without the written permission of the author. Pay boards (BBS)
  68. may carry the unregistered demo version for distribution purposes.
  69.  
  70. PROGRAM DESCRIPTION
  71. ~~~~~~~~~~~~~~~~~~~
  72. Welcome to FedJobs! by T&J Software
  73.  
  74. FedJobs is provided for online access to 1000's of government jobs open
  75. nation wide. The job database is updated bi-weekly to stay current with
  76. new position availability and removal of closed positions.
  77.  
  78. Until registered, you can only use the database of jobs that is
  79. distributed with the door. Once registered, you may use the bi-weekly
  80. updated database which can be downloaded from The T&J Software BBS or
  81. The Docksider BBS.
  82.  
  83. Normal updates will be online by the 1st and 15th of each month.
  84.  
  85. BBS SCREENS
  86. ~~~~~~~~~~~
  87. Several screens are included in this zip file which may be used to
  88. announce the FedJobs! Door on your BBS, they are:
  89.  
  90. SCREEN.ANS - An ANSI screen announcement
  91. SCREEN.ASC - An ASCII screen announcement
  92. SCREEN.BBS - A Wildcat @-coded screen.
  93. SCREEN.PCB - A PCBoard @-coded screen.
  94.  
  95. FEATURES
  96. ~~~~~~~~
  97.            --- Desqview Aware.
  98.            --- COM0-15 support and non-standard IRQ's.
  99.            --- Chat function with automatic screen redraw.
  100.            --- Drop to DOS with automatic screen redraw.
  101.            --- NO BRUN module needed for play.
  102.            --- BETA tested on many different boards.
  103.            --- Will return to BBS on dropped carrier.
  104.            --- Will TIMEOUT a user after 5 minutes of no activity.
  105.            --- Support BBS available.
  106.  
  107. INSTALLATION
  108. ~~~~~~~~~~~~
  109. CONFIGURATION: (Your FEDJOBS.CFG file)
  110. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  111. ** PLEASE CONSULT YOUR OWN BBS DOCUMENTATION FOR SPECIFICS!!!! **
  112.  
  113. Simply use your favorite text editor to set this file up or edit the
  114. FEDJOBS.CFG inside this zip file.
  115.  
  116. Example configuration file for PCBOARD.SYS
  117. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  118. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  119. T&J Software        <=-  (Change this to your BBS name)
  120. Tom                 <=-  (The Sysop's first name)
  121. Wildoner            <=-  (The Sysop's last name)
  122.  
  123. Example configuration file for USERS.SYS
  124. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  125. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  126. T&J Software        <=-  (Change this to your BBS name)
  127. Tom                 <=-  (The Sysop's first name)
  128. Wildoner            <=-  (The Sysop's last name)
  129.  
  130. Example configuration file for DOOR.SYS
  131. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  132. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  133. The Docksider BBS   <=-  (Change this to your BBS name)
  134. Ken                 <=-  (The Sysop's first name)
  135. Regenfuse           <=-  (The Sysop's last name)
  136.  
  137. Example configuration file for CALLINFO.BBS
  138. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  139. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  140. The Docksider BBS   <=-  (Change this to your BBS name)
  141. Ken                 <=-  (The Sysop's first name)
  142. Regenfuse           <=-  (The Sysop's last name)
  143.  
  144. Example configuration file for DORINFOx.DEF
  145. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  146. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  147.                           where 'x' is the BBS Node number.
  148. T&J Software        <=-  (Change this to your BBS name)
  149. Tom                 <=-  (The Sysop's first name)
  150. Wildoner            <=-  (The Sysop's last name)
  151.  
  152. Example configuration file for SFDOORS.DAT
  153. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  154. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  155. T&J Software        <=-  (Change this to your BBS name)
  156. Tom                 <=-  (The Sysop's first name)
  157. Wildoner            <=-  (The Sysop's last name)
  158.  
  159. Example configuration file for GTUSER.BBS
  160. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  161. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  162. T&J Software        <=-  (Change this to your BBS name)
  163. Tom                 <=-  (The Sysop's first name)
  164. Wildoner            <=-  (The Sysop's last name)
  165. 1                   <=-  (COM port number - defaults to 1)
  166. 1                   <=-  (Node number - defaults to 1)
  167.  
  168. Example Batch File
  169. ~~~~~~~~~~~~~~~~~~
  170. A sample batch file similar to the following:
  171.    ECHO OFF
  172.    CD\DOORS\FEDJOBS         <=- Switch to the door's Directory.
  173.    FEDJOBS FEDJOBS.CFG      <=- Execute the door program and pass the
  174.                                 configuration filename to the program.
  175.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  176.    BOARD                    <=- Restart BBS.
  177.  
  178. This Door is multi-node  compatible so you may run more than 1 node from
  179. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  180. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  181. variables, (q.v.)
  182.  
  183. Environment Variables
  184. ~~~~~~~~~~~~~~~~~~~~~
  185. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  186. variables. Non-PCBoard systems may also use these variables by including
  187. the following in either your BBS batch or AUTOEXEC.BAT
  188.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  189.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  190. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  191. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  192. .CFG file for multi-node operation!
  193.  
  194. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  195. command line.  For example:
  196.  
  197.      FEDJOBS FEDJOBS.CFG /5
  198. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  199.      FEDJOBS FEDJOBS.CFG /%IRQ%
  200.  
  201. This tells the program to use IRQ 5 instead of the standard IRQ.
  202.  
  203.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  204.  systems. Seems Novell also uses the / character so something went screwy
  205.  somewhere. So I added the * (asterisk) which may be used instead of the /
  206.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  207.  and are interchangeable.
  208.  
  209. When specifying the location of the system file on line 1 of the doors .CFG
  210. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  211. and %wcnodeid%. Some examples:
  212.  PCBoard: 
  213.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  214.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  215.  
  216.  Wildcat!:
  217.    DOOR.SYS in C:\Wildcat\wcwork\NODE1
  218.                         - C:\wildcat\wcwork\node%wcnodeid%\door.sys
  219.  
  220. Non-PCBoard systems may use the PCB environment variables by setting them
  221. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  222.  SET PCBDRIVE=C:
  223.  SET PCBDIR=\BBSDIR
  224.  SET PCBNODE=1
  225.  
  226. Fossil Driver Support
  227. ~~~~~~~~~~~~~~~~~~~~~
  228. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  229. Fossil driver instead of the standard COM ports, just put /FD on the command
  230. line when running the door. For example:
  231.      MYDOOR MYDOOR.CFG /FD
  232. indicates that a Fossil driver is present and should be used. If no Fossil
  233. driver is detected, DoorFrame will print a message to that effect and exit
  234. the door gracefully.
  235.  
  236. Sysop Keys
  237. ~~~~~~~~~~
  238. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  239.          written to DOOR.SYS and USERS.SYS
  240. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  241.          and/or written to DOOR.SYS and USERS.SYS
  242. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  243. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  244.          and/or written to DOOR.SYS and USERS.SYS
  245. F8    -  Returns the caller involuntarily to the BBS.
  246. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  247.          and/or written to DOOR.SYS and USERS.SYS
  248. F10   -  Activates SysOp CHAT mode within the DOOR.
  249. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  250. UP    -  Give the caller extra time while in the DOOR.  
  251. DN    -  Subtract time from the caller while in the DOOR. 
  252. HOME  -  HELP key for Status Line options.
  253. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  254. ALT-X -  PCBoard will exit after current caller logs off. Value is
  255.          passed to PCBoard. Not available on non-PCBoard systems.
  256.  
  257. HELLO SCREENS:
  258. ~~~~~~~~~~~~~~
  259. You may make a custom hello screen for FedJobs if you wish. They must
  260. be called:
  261.  
  262. HELLO.ANS - For the ANSI screen.
  263. HELLO.ASC - For the ASCII screen.
  264.  
  265. Both screens must reside in your FEDJOBS directory.
  266.  
  267. SYSOP STATUS LINES:
  268. ~~~~~~~~~~~~~~~~~~~
  269. To turn off the SYSOP status lines (the two lines at the bottom of the
  270. sysop console while in the door), make a file called NOSTATUS.DAT and
  271. place it in your FEDJOBS directory.
  272.  
  273. DOWNLOADING FILES:
  274. ~~~~~~~~~~~~~~~~~~
  275. Users may download any listing that they EXPAND on while in the door.
  276. Here's what to do:
  277.  
  278. 1.  Create a file(s) in your BBS file database called:
  279.        FEDLOG.<nodenumber>
  280.     You may set this file up anyway you wish. For example, if you are
  281.     running two nodes, you should have two files in your file database
  282.     called FEDLOG.1 and FEDLOG.2.
  283.  
  284.     FedJobs keeps a log file per node of what each person expanded on
  285.     while they were in the door. It doesn't matter how the file is
  286.     setup in your BBS file database (date, size, etc.) the important
  287.     thing is that it exists so the user may download the file directly
  288.     through your BBS instead of through the door.
  289.  
  290. 2.  In your door batch file, after the door running command line you
  291.     must copy the log file for that node to the file directory that
  292.     contains that file. Here's my door batch file:
  293.  
  294.     ECHO OFF
  295.     CD\WILDCAT\DOORS\FEDJOBS
  296.     FEDJOBS FEDJOBS.CFG
  297.     COPY FEDLOG.%WCNODEID% E:\FILE\TJ
  298.  
  299.     If you are using %-codes you may substitute the %node% command
  300.     as I did above. If you don't, for each door batch file (per node)
  301.     simply substitute the node number in. For example, if you are
  302.     running a single node system your batch file may look like this:
  303.  
  304.     ECHO OFF
  305.     CD\WILDCAT\DOORS\FEDJOBS
  306.     FEDJOBS FEDJOBS.CFG
  307.     COPY FEDLOG.1 E:\FILE\TJ
  308.  
  309.     You can also just copy all the logs at one time. I wouldn't
  310.     recommend this, but you may try it. Your batch file may read
  311.     something like this:
  312.  
  313.     ECHO OFF
  314.     CD\WILDCAT\DOORS\FEDJOBS
  315.     FEDJOBS FEDJOBS.CFG
  316.     COPY FEDLOG.* E:\FILE\TJ
  317.  
  318.     The downfall of this is, if somebody is downloading the file
  319.     FEDLOG.1 from node 1, and a caller from node 2 quits the door, the
  320.     downloading file on node 1 will be overwritten (probably the exact
  321.     same file/size/etc) but I don't know what harm this may do to the
  322.     person downloading the file (file corruption, etc.).
  323.  
  324. 3.  Make a file in your FEDJOBS directory called DOWNLOAD.DAT. If this
  325.     file exists, FedJobs will tell the person about the existence of
  326.     the downloadable log file and the filename to download.
  327.  
  328. SPECIAL ACCESS TO THE DOOR:
  329. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  330. Some sysop's may like this feature.
  331.  
  332. By creating a file called GOODUSER.DAT and placing people's names
  333. within the file (one name per line) they may limit who has access to
  334. the door. If the users name doesn't appear in the file, they will be
  335. told to check with the sysop for access information. Alternately, you
  336. may create a GOODUSER.ANS/ASC screen that will be shown to users who
  337. don't have access explaining what they need to do! Filenames must be:
  338.  
  339. GOODUSER.ANS - The ANSI screen.
  340. GOODUSER.ASC - The ASCII screen.
  341.  
  342. Both screens must reside in the FEDJOBS directory.
  343.  
  344. MAINTENANCE:
  345. ~~~~~~~~~~~~
  346. None required other than updating the job database.
  347.  
  348. RUNNING FEDJOBS LOCALLY:
  349. ~~~~~~~~~~~~~~~~~~~~~~~~
  350. Just type FEDJOBS LOCAL
  351.  
  352. FUTURE VERSIONS:
  353. ~~~~~~~~~~~~~~~~
  354. Let us know what you would like to see added or changed!
  355.  
  356. COMMENTS & QUESTIONS & HELP:
  357. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  358. If you have problems please consult the file TJHELP.TXT first, this
  359. will answer the most common problems arising in setting up the door!
  360. If your problems continue or your questions aren't answered in the 
  361. TJHELP.TXT file, please feel free to call the T&J BBS at (717)325-9481/4369
  362. or The Docksider BBS at (610)678-0350 or (610)670-7938.
  363. You may also reach us on the Internet at tom.wildoner@channel1.com
  364.  
  365. VERSION HISTORY:
  366. ~~~~~~~~~~~~~~~~
  367. See the HISTORY.TXT file for information on the history of the game
  368. and the new options in the current version!
  369.  
  370. REGISTERING:
  371. ~~~~~~~~~~~~
  372. See the enclosed registration form for ordering!  (REGISTER.TXT)
  373.