home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / GAPDEMO1.ZIP / GAPUSER.HLP < prev    next >
Text File  |  1995-01-03  |  20KB  |  678 lines
  1. @@MAXLINE
  2. Keywords are limited to 19 bytes
  3. [---------------------------------------]
  4. Set Margin to 41 in Brief F10, Margin
  5. To reformat paragraphs imported from the
  6. documentation, press F10, REFORM. Make
  7. sure the block is marked first. You will
  8. then have to insert a blank line between
  9. paragraphs.
  10. @@MENUH
  11. To move between the various ^x0AMenu Choices^n
  12. you may use the ^x0CLeft^n and ^x0CRight^n Arrow
  13. Keys.
  14.  
  15. To select a ^x0AMenu Item^n, press ^x0CEnter^n
  16. when the ^x0AItem^n you wish to select is
  17. highlighted.
  18.  
  19. You may select a ^x0AMenu Item^n and have that
  20. selection executed immediately by 
  21. typing the first character of the ^x0AMenu^n
  22. ^x0AItem^n's Name.
  23.  
  24. If the current screen displayed is the
  25. ^x0AMain User Screen^n and you are not actually
  26. editing the screen, you may toggle the
  27. display of the ^x0ATop^n or ^x0ABottom^n
  28. portion of the screen by pressing the 
  29. ^x0CS^n key. This will bring the bottom
  30. portion of the screen into view if it 
  31. is not already viewable, and the top
  32. portion of the screen into view, if the
  33. bottom portion is currently being
  34. displayed.
  35. @@EDIT
  36. Edit User allows you to edit the record
  37. of the currently displayed User.
  38. @@ADD
  39. Add User allows you to add a new User to
  40. the database.
  41. @@DEL
  42. Pressing the Del Key or selecting Del
  43. User will delete the currently displayed
  44. user from the database.
  45. @@TOGGLE
  46. Pressing I or selecting Toggle Index will
  47. change the active index so that you may
  48. view the Users either by Name or Level.
  49. @@SEARCH
  50. Search For User allows you to locate a
  51. user by First and Last Name.
  52. @@LOCATE
  53. Locate User allows you to locate a user
  54. by Last Name.
  55. @@FIND_HANDLE
  56. Find Handle allows you to locate a user
  57. that is using a specific Handle.
  58. @@REGIS_USER
  59. Register Users allows you to register
  60. all of your Users in a specific Forum or
  61. a group of Forums.
  62. @@UNREGIS_USER
  63. UnRegister Users allows you to Unregister
  64. all of your Users in a specific Forum or
  65. a group of Forums.
  66. @@REGIS_LEVEL
  67. Register Users By Level allows you to
  68. Register Users that have a specific 
  69. security level in a Forum or a group of
  70. Forums.
  71. @@UNREGIS_LEVEL
  72. UnRegister Users By Level allows you to
  73. remove Users that have the specified
  74. security level from a Forum or a group
  75. of Forums.
  76. @@SUB_ALL
  77. Update All Users allows you to change
  78. the Subscription Date for all of your
  79. Users.
  80. @@SUB_FORUM
  81. Update Users In Forum allows you to
  82. change the Subscription Date for all
  83. Users that are members of a specific
  84. Forum.
  85. @@SUB_LEVEL
  86. Update Users By Level allows you to
  87. change the Subscription Date for all
  88. Users with a specific security level.
  89. @@SUB_EXPLEV
  90. Change Expired Level allows you to change
  91. the Expired Subscription Level for all
  92. Users who have the Expired Level you
  93. provide.
  94. @@SUB_PUBFORUM
  95. Change Public Forums Flag allows you to
  96. change the Yes or No flag that determines
  97. if Expired Subscription Users should be
  98. set back to having access to only Public
  99. Forums or if they should continue to
  100. have access to any Private Forums they
  101. may already be registered in.
  102.  
  103. If you set this field to Yes for all of
  104. your users, then when their subscription
  105. expires, they will loose their access to
  106. any Private Forums.
  107.  
  108. If you set this field to No, then
  109. Expired Users will continue to be
  110. members of any Private Forums they might
  111. be registered in.
  112.  
  113. This Field is set initially from the
  114. default you set up in GAPSETUP for
  115. Subscription Configuration.
  116. @@RESET_LAST
  117. Reset Pointers will set the Last Read
  118. Message Numbers for all Users in all 
  119. Areas to 0.
  120. @@CHANGE_LEVEL
  121. Security Level will change the security
  122. level for Users that have a specific 
  123. level.
  124. @@LEVEL_UP
  125. Level By Uploads will change the security
  126. level of any User that has Uploaded a
  127. specified number of files.
  128. @@LEVEL_MES
  129. Level By Messages will change the
  130. security level of any User that has left
  131. a specified number of messages.
  132. @@SORT
  133. Sort will perform a physical sort of the
  134. user file, arranging users by Security
  135. Level and Last Name.
  136. @@REP_LIST
  137. User Listing will produce a listing of
  138. all of your Users.
  139. @@REP_EXP
  140. Expired Subscription will produce a
  141. report listing any User who's subscrip-
  142. tion has expired or is about to expire.
  143. @@REP_DAYS
  144. Subscription By Days will produce a
  145. report listing any User who's subscrip-
  146. tion will expired in a specified number
  147. of days.
  148. @@REP_NETMAIL
  149. This report will list all of your users
  150. who have QWK Networking status.
  151. @@REP_LABELS
  152. You may produce two different types of
  153. Address Labels. GAPUSER utilizes two
  154. popular Avery Label formats.
  155.  
  156. The Address Label Reports will be
  157. written to a file called USERLAB.LST. To
  158. print the labels, load your manual paper
  159. feed tray with the appropriate Avery
  160. Labels, and type the following:
  161.  
  162.   COPY USERLAB.LST LPT1
  163. @@FIRST
  164. This is the User's First Name. The first
  165. character of the name must be an 
  166. alphabetic character.
  167. @@LAST
  168. This is the User's Last Name. The first
  169. character of the name must be an 
  170. alphabetic character.
  171. @@PASS
  172. This is the password the User must use in
  173. order to gain access to the system.
  174. @@ADDRESS
  175. This is the User's street address. The
  176. first address line may also be used to
  177. hold the User's Company Name if
  178. appropriate.
  179. @@CITY
  180. This is the User's home town.
  181. @@STATE
  182. This is the User's State or Province.
  183. @@ZIP
  184. This is the User's Zip or Postal Code.
  185. @@COUNTRY
  186. This is the User's Country. This field
  187. defaults to the Sysop's Country as set
  188. up in Configuration.
  189. @@HPHONE
  190. This is the User's Home Phone number.
  191. @@BPHONE
  192. This is the User's Business or Data
  193. Phone number.
  194. @@BIRTH
  195. This is the User's date of Birth.
  196. @@REGIS_DATE
  197. This is the date the User first became a
  198. member of the board.
  199. @@SUB_DATE
  200. This is the date the User's Subscription
  201. expires. If you do not run a subscription
  202. board, this date has no meaning.
  203. @@HANDLE
  204. This is the alias the User is using (if
  205. appropriate).
  206. @@COMMENT
  207. You may enter any information about the
  208. User in this field. The user will never
  209. see this information.
  210. @@LEVEL
  211. This is the User's Security Level. Access
  212. rights, based upon security levels, are
  213. defined in your SECLEV file (which you
  214. configure in GAPSETUP).
  215. @@LASTDATE
  216. This is the date the User was last on the
  217. system.
  218. @@LASTTIME
  219. This is the time the User was last on the
  220. system.
  221. @@PRIVATE
  222. If you run a Subscription Board, no user
  223. will be allowed onto the system unless
  224. the user's Private User Flag is set to
  225. Yes. This field has no meaning if you do
  226. not run a subscription board.
  227. @@ENF_TIME
  228. Time limits per session and/or day are
  229. configured in your SECLEV file. Whether
  230. or not you allow users to call back an
  231. unlimited number of times per day is
  232. set by a flag in configuration. If you
  233. generally do not allow users to call
  234. back after their time has expired, you
  235. may override that function for any 
  236. particular user by setting this field to
  237. No.
  238.  
  239. Note that time limits per session are
  240. still enforced. In other words, if you
  241. give a user 50 minutes per session, the
  242. user will still be limited to 50 minutes
  243. but you may allow a particular user to
  244. call back an unlimited number of times
  245. and receive the full 50 minute time 
  246. allotment, by setting this field to No.
  247. @@EDITOR
  248. This field allows you to set the default
  249. Message Editor the User will be prompted
  250. to use just prior to entering a message.
  251.  
  252. Set this field to either V or L for
  253. Visual or Line Editor.
  254. @@CHAT
  255. This is the default Network Chat
  256. preferance for the User. This field has
  257. no meaning if you are running a single
  258. user system.
  259.  
  260. If the User wishes to automatically be
  261. made Unavalable for Chat, set this field
  262. to No.
  263. @@MSGCLR
  264. If set to Yes, GAP will clear the screen
  265. between each message that is displayed.
  266. @@EXPERT
  267. If set to Yes, the User will be in Expert
  268. mode and GAP will not display the Main
  269. Menu.
  270. @@PROTOCOL
  271. This is the Protocol Letter representing
  272. the User's Default Protocol.
  273. @@PAGE
  274. This is the User's Page Length (the 
  275. number of lines that will be displayed
  276. on the screen before a More Prompt is
  277. issued.
  278. @@EXPIRED
  279. If you run a Subscription Board and a
  280. User's Subscription has Expired, the User
  281. is normally set back to the default 
  282. Expired Subscription Level as set up in
  283. Configuration. You can override the
  284. default level and enter a level to set
  285. the user back to here.
  286. @@EXPIRED_FOR
  287. If you run a Subscription Board and a
  288. User's Subscription has Expired, the User
  289. is normally removed from all the Forums
  290. such that the User will only be able to
  291. join the Public Forums. If you do not
  292. want this to happen to this particular
  293. User, set this field to No.
  294. @@CREDITS
  295. This field represents any time credits
  296. a User may have. It can be either a
  297. positive or negative number. 
  298. @@DISCON
  299. This field shows how many times this User
  300. has dropped carrier instead of using
  301. GoodBy to log off the system.
  302. @@LAST_FORUM
  303. This is the number of the last Forum the
  304. User was in when he/she logged off.
  305. @@NEW_MES
  306. This field is used internally by GAP and
  307. specifies if the User has any new mail in
  308. the Main Board. This field should not be
  309. changed.
  310. @@LAST_DIR
  311. This is the date the User did a New Files
  312. Scan.
  313. @@TIMESON
  314. This is the number of times the User has
  315. logged onto the system.
  316. @@TTLMINS
  317. This is the total number of minutes the
  318. user has spent on the system.
  319. @@CURMINS
  320. This is the number of minutes the User 
  321. has been on the system today (or on the
  322. last date the User was on).
  323. @@LASTMSG
  324. This is the number of the last Main Board
  325. message the User read.
  326. @@MES_READ
  327. This is the total number of messages the
  328. User has read.
  329. @@MES_LEFT
  330. This is the total number of messages the
  331. User has left.
  332. @@FOR_JOINED
  333. This is the total number of Forums the
  334. User has joined.
  335. @@BLT_READ
  336. This is the total number of Bulletins the
  337. User has read.
  338. @@DOOR_OPEN
  339. This is the total number of Doors the
  340. User has opened.
  341. @@UP_FILES
  342. This is the total number of files the
  343. User has Uploaded.
  344. @@UP_BYTES
  345. This is the total number of bytes the
  346. User has Uploaded.
  347. @@DOWN_FILES
  348. This is the total number of files the
  349. User has Downloaded.
  350. @@DOWN_BYTES
  351. This is the total number of bytes the
  352. User has Downloaded.
  353. @@CUR_DOWN
  354. This is the total number of files the
  355. User has Downloaded today (or on the last
  356. date the User was on).
  357. @@CUR_BYTES
  358. This is the total number of bytes the
  359. user has Downloaded today (or on the last
  360. date the User was on).
  361. @@DELHELP
  362. When a record is deleted, the index 
  363. entry for the User is removed and the
  364. record is marked as inactive. Therefore,
  365. once a record is deleted, it is
  366. impossible to restore it.
  367.  
  368. Please confirm that you indeed wish to
  369. delete the currently displayed user from
  370. the database.
  371. @@SORTHELP
  372. The sorting process actually creates a
  373. brand new User File. Because of the
  374. extremely low level interaction with 
  375. this file, it cannot be peformed while
  376. other nodes are active. 
  377.  
  378. If any of your other nodes are active,
  379. press Esc to cancel this function.
  380. @@SUB_HELP
  381. In this field, enter the new
  382. Subscription Date a user will be given.
  383. @@SUB_HELP1
  384. This Utility allows you to change the
  385. Subscription Date of any User that is
  386. registered in a Forum.
  387.  
  388. You provide the Subscription Date to
  389. change the User to and the Forum number
  390. the User must be registered in, in order
  391. for any changes to take place.
  392. @@LEVEL_HELP
  393. In this field, enter the Security Level
  394. a User must have in order for any changes
  395. to be made.
  396. @@LEVEL_HELP1
  397. In this field, enter the new Security
  398. Level to give a User that matches the
  399. specified criteria.
  400. @@UP_LEVEL
  401. Enter the number of Uploads that a User
  402. must have sent in order for the User to
  403. be set to the new security level.
  404. @@MES_LEVEL
  405. Enter the number of Messages that a User
  406. must have left in order for the User to
  407. be set to the new security level.
  408. @@RESET_HELP
  409. To begin this operation, type GO. If 
  410. you do not wish to reset all of your 
  411. User's Last Read Message Pointers, press
  412. Esc.
  413. @@LOCATE_HELP
  414. Enter the First and Last Name of the User
  415. you wish to Locate.
  416. @@HANDLE_HELP
  417. Enter the Handle to Locate.
  418. @@SEARCH_HELP
  419. Enter the Last Name (or a partial Last
  420. Name) of the User you wish to Locate.
  421. @@REPORT1
  422. Enter the number of days that a User's
  423. Subscription date must be within, in
  424. order for the User to be included in the
  425. report.
  426.  
  427. For instance, to generate a report of
  428. Users who's subscription will expire 
  429. within 30 days, enter 30 in this field.
  430. @@REPORT2
  431. Enter ALL if you want the report to 
  432. include all of your users. Otherwise,
  433. enter the Security Level a User must have
  434. in order to be included in the report.
  435. @@FORREGIS
  436. This function allows you to register 
  437. All of your users in a specific Forum
  438. or a group of Forums.
  439.  
  440. If the Forum is Public you may exclude
  441. users not eligible for Forum Membership
  442. if you so choose. 
  443.  
  444. A user is considered Not Eligible if the
  445. user does not have the security level to
  446. Join the Forum (based upon the level you
  447. assigned the Forum in configuration).
  448. @@FORUNREGIS
  449. This function allows you to unregister 
  450. All of your users in a specific Forum
  451. or a group of Forums.
  452. @@FORUMLEVEL
  453. This function allows you to Register
  454. any user that has the supplied Security
  455. Level in a Forum or a group of Forums.
  456. @@FORUMUNLEVEL
  457. This function allows you to UnRegister
  458. any user that has the supplied Security
  459. Level in a Forum or a group of Forums.
  460. @@USER_FORREGIS
  461. This function allows you to register the
  462. currently displayed User in a Forum or
  463. a group of Forums.
  464. @@USER_UNREGIS
  465. This function allows you to unregister
  466. the currently displayed User in a Forum
  467. or a group of Forums.
  468. @@USER_LREAD
  469. This function will change the Last Read
  470. Message number in a specific Forum for
  471. the currently displayed User to a number
  472. of your choosing.
  473.  
  474. After entering the Forum number, the
  475. Highest message number in that Forum will
  476. be displayed along with the Highest
  477. message number that the User has read.
  478.  
  479. You may then enter a new Last Read
  480. Message number.
  481. @@F_LOCKOUT
  482. This function allows you to lock the 
  483. currently displayed user out of a Forum
  484. or a Range of Forums. It should be used
  485. to lock a particular user out of a 
  486. public Forum.
  487. @@F_SYSOP
  488. This function allows you to make the
  489. currently displayed user a Sysop or Co
  490. Sysop of a Forum or a Range of Forums.
  491. @@USER_FORLOCKOUT
  492. To lock the currently displayed user out
  493. of a Forum or a Range of Forums, enter
  494. the Forum number (or select Range of
  495. Forums from the selection window).
  496. @@USER_FORSYSOP
  497. To make the currently displayed user a
  498. Sysop or Co-Sysop of a Forum or a Range
  499. of Forums, enter the Forum number (or
  500. select Range of Forums from the 
  501. selection window). You will then be
  502. asked to specify whether the user should
  503. be the Sysop or an Assistant Sysop of
  504. the Forum(s). The security levels
  505. associated with Forum Sysops and 
  506. Assistant Sysops are defined in the Forum
  507. Configuration.
  508. @@EXPCHG
  509. Enter the Expired Level a user must have
  510. in order for their Expired Level to be
  511. changed to the New Expired Level.
  512. @@EXPFORUMCHG
  513. Enter Yes in this field if you want
  514. Expired Subscription users to be set back
  515. to having Public Forum access only.
  516.  
  517. Enter No in this field if you want
  518. Expired Subscription users to retain
  519. access to any Private Forums they may be
  520. a member of.
  521. @@DUPEH
  522. This Utility function allows you to re-
  523. move duplicate records from the MEMBER
  524. data file.
  525.  
  526. If you receive a message while rebuild-
  527. ing your MEMBER file that says ^x0ADuplicate^n
  528. ^x0AKey rejected for record at offset xxxx^n,
  529. where ^x0Cxxxx^n is a numeric value, then
  530. there are duplicate records in your
  531. MEMBER file and only one of them could
  532. be indexed.
  533.  
  534. With this Utility, you may remove the
  535. duplicate records. 
  536.  
  537. In order to delete the duplicate record
  538. you must supply the numeric offset that
  539. ^x0AGAPREBLD^n displayed in its warning 
  540. message. You ^x0Cmust^n supply the exact
  541. number or you may inadvertantly delete
  542. the wrong record.
  543.  
  544. If GAPREBLD gave duplicate warning
  545. messages for the same offset value, you
  546. need only remove the duplicate record
  547. once. For instance, if GAPREBLD gave 3
  548. separate duplicate key messages with all
  549. 3 having the same offset value of 29993,
  550. simply supply the value of 29993 to this
  551. Utility function ONE time and the record
  552. will be correctly deleted.
  553. @@DUPE_OFFSET
  554. Enter the Offset Value that GAPREBLD
  555. displays when reporting a Duplicate
  556. Key error.
  557. @@NET_STATUS
  558. In order for a user to send messages in
  559. the QWK/REP module that do not bear his
  560. or her name, the user must have QWK
  561. Networking Status. Net Status is given
  562. to users who use you as a QWK Networking
  563. HUB. You must answer Yes in this field 
  564. so that your Nodes can send and receive
  565. QWK Network messages.
  566.  
  567. If you are not a HUB for a QWK Network
  568. then leave this field set to No.
  569. @@NET_FORUM
  570. If a user has Net Status, you may 
  571. optionally allow that user to have access
  572. to non Echoed Forums.
  573.  
  574. Normally, a Net Status user will only
  575. have access to those Forums that are 
  576. marked as an Echo Mail Forum. This is how
  577. it should be since a non echoed Forum
  578. should not have its messages appearing
  579. on other Boards.
  580.  
  581. However some users may not want to set
  582. up a separate Net Mail account and call
  583. in twice to obtain Mail from your board.
  584.  
  585. Before setting this field to Yes and
  586. thereby allowing this user to have 
  587. access to non echoed Forums at the same
  588. time he or she is collecting a Network
  589. QWK Packet, be sure that you have 100%
  590. confidence in the user and that the
  591. user will not be placing your non
  592. echoed Forums on his or her board such
  593. that your Forums are set up on this
  594. User's board as Echo Mail Forums.
  595. @@REP_EXPORT
  596. This Report will create a Comma
  597. Delimited File containing all of the
  598. users in your User File (with the
  599. exception of the Sysop).
  600.  
  601. The name of the file will be USER.EXP.
  602.  
  603. The USER.EXP file can be imported into
  604. most DataBase programs (Clarion, Dbase,
  605. FoxPro, etc). Any program capable of
  606. reading a file where each record appears
  607. on a single line with strings surrounded
  608. by quotes will be able to read this
  609. Export File.
  610.  
  611. The fields that are written are defined
  612. as follows:
  613.  
  614.   String  : Last Name
  615.   String  : First Name
  616.   String  : Address 1
  617.   String  : Address 2
  618.   String  : City
  619.   String  : State
  620.   String  : Zip
  621.   String  : Country
  622.   String  : Home Phone Number
  623.   String  : Business/Data Phone Number
  624.   String  : Registration Date
  625.   String  : Subscription Expiration Date
  626.   Integer : Security Level
  627.  
  628. With the above information, you can
  629. create reports, mailing labels, dunning
  630. letters, or what have you, using your
  631. favorite DataBase Manager. The Security
  632. Level is included as part of the Export
  633. in case you segregate users based upon
  634. level.
  635. @@FIX_SYSOP
  636. The Sysop Record needs to be the first
  637. Record in the User File. In addition, a
  638. flag in that record needs to be set to
  639. signify that it is indeed the Sysop
  640. Record.
  641.  
  642. If the Sysop Record should become
  643. corrupt, GAP will no longer recognize
  644. you as the Sysop.
  645.  
  646. This Utility allows you to Fix your
  647. Sysop Record should it become necessary
  648. to do so. You should NOT run this
  649. utility unless absolutely necessary. All
  650. data in the first record (be it yours or
  651. one of your users) will be erased.
  652. @@FIX_SYSOP1
  653. The Sysop Record has just been fixed.
  654. You must now Edit that record and change
  655. the First, Last, and Password fields to
  656. your own personal preference.
  657.  
  658. Remember that these fields are used ONLY
  659. to log you on from remote.
  660. @@AUTO_DOORWAY
  661. If a user has ANSI capabilities, then
  662. when entering a message using the Visual
  663. Editor, GAP can tell the user's COM
  664. Program to turn DoorWay Mode On. DoorWay
  665. Mode allows the remote caller to use the
  666. cursor keys to move the cursor around
  667. the editor screen.
  668.  
  669. Some callers use Terminal programs that
  670. do not support the Auto DoorWay ANSI
  671. sequences that GAP sends. Instead of
  672. going into DoorWay mode, they will see
  673. the DoorWay codes on their screen.
  674.  
  675. If you wish to disable Auto DoorWay mode
  676. for this user answer ^x0CNo^n in this field.
  677. @
  678.