home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / JLUT531.ZIP / HLP.ZIP / QU.HLP < prev    next >
Text File  |  1994-05-11  |  6KB  |  179 lines
  1. ┌─────────────────────────────────────────────────────────────────────────────┐
  2. │ Option:  QU  QUESTIONAIRE...................................................│
  3. └─────────────────────────────────────────────────────────────────────────────┘
  4.  
  5. Syntax  
  6. ═══════════════════════════════════════════════════════════════════════════════
  7. JLUTIL /QU [Parameters] [-Switches]
  8. ═══════════════════════════════════════════════════════════════════════════════
  9.  
  10. Switch Description  
  11. ═══════════════════════════════════════════════════════════════════════════════
  12. No Switches available at this time.
  13. ═══════════════════════════════════════════════════════════════════════════════
  14.  
  15. Param       Description  
  16. ═══════════════════════════════════════════════════════════════════════════════
  17. FileName    Name of the questionaire-File or number of the questionaire.
  18. ═══════════════════════════════════════════════════════════════════════════════
  19.  
  20. Explanation  
  21. ═══════════════════════════════════════════════════════════════════════════════
  22. JLUTIL /QU displays the questionaire and stores the answers. You can
  23. specify several input formats (uppercase, numbers only etc.) and
  24. send the answers then as a msg to somebody.
  25.  
  26.  
  27. The questionaire can handle some variables (inspect QUEST001.@JL, if you want
  28. to have an example):
  29.  
  30. @@DE=    Delimiter Char
  31.  
  32. @@RE=    Receiver of the Msg
  33.  
  34. @@NN=    NetNode of the Receiver
  35.  
  36. @@SU=    Message Subject
  37.  
  38. @@AR=    MsgArea
  39.  
  40. @@TI=    Title of this Questionaire; will be displayed whenever you
  41.          use the CLS Command. Delete a title with @@TI=
  42.  
  43. @@CO=    Display this String. You can enter the normal variables
  44.          (Look at MS.HLP) like @SAD, etc. You can enter the variables,
  45.          you are using in the questionaire. You have to use the
  46.          following syntax: '@VARNAME@'. If you want to write '@',
  47.          then you should enter '@@'. You can format the output of
  48.          VARNAME, you should specify eg.
  49.  
  50.             '@VARNAME:B 5@'.
  51.                      ││││
  52.                      │││└the output has a minimum of 5 chars
  53.                      ││└ fill the string with that char
  54.                      │└can be 'B' for fill the string from the beginning
  55.                      │     or 'E' for fill the string from the end
  56.                      └must be a ':'
  57.  
  58. @@HU=    Display this String simulation a human being
  59.          @@HU=100|100|Hi man.
  60.               ─┬─ ─┬─ ──┬────
  61.                │   │    └text
  62.                │   └errors
  63.                └speed
  64.  
  65.          You can use variables like within @@CO=.
  66.  
  67. @@LF=    LogFileName; eg. @@LF=D:\QUEST\TOTAL.LOG
  68.  
  69. @@RL=    Reset (temporal) LogFile TRUE or FALSE
  70.  
  71.          IF TRUE:  Reset the temporal LOG-File after a
  72.                    CALL command and append it to the
  73.                    current LOGFile of the Questionaire.
  74.          IF FALSE: leave the temporal LOG-File and
  75.                    save it at the end to the LOGFile
  76.                    of the last Questionaire.
  77.  
  78. ;...     ignore this line
  79.  
  80.  
  81.  
  82. GET VARIABLES FROM USER:
  83. ------------------------------------------------------------------
  84.  
  85. and now lets discuss an example line:
  86.  
  87. NET-NODE= |Enter the Net/Node of your BBS:         | 7|1|1|4|1|1|1..7
  88.  
  89. NET-NODE=  Variable Name within the Msg
  90. Enter....  Questiontext
  91. 1.Flag     Max. Length of the Answer
  92. 2.Flag     1: ClrLine before asking the Question
  93.            2: ClrLine after asking the Question
  94.            3: ClrLine before & after asking the Question
  95. 3.Flag     1: Length of Answer must be > 0
  96.            2: Length of Answer can  be = 0
  97. 4.Flag     1: all chars, normal
  98.            2: transform to uppercase chars
  99.            3: numbers          0123456789
  100.            4: extended numbers 0123456789/()+- etc.
  101. 5.Flag     1: display normal
  102.            2: invisible
  103.            3: write dots
  104. 6.Flag     1: press RETURN
  105.            2: without RETURN  (for single Char Answers)
  106. 1..7       Range of the answer; the answers 1,2,3,4,5,6,7 are possible.
  107.            if you specify A..C; the answers A,B,C are possible.
  108.  
  109.  
  110. COMMANDS:
  111. ------------------------------------------------------------------
  112.  
  113. Command               Description
  114. --------------------- --------------------------------------------
  115. CLS                   Clear Screen
  116. GOTO :LABEL           Jump to :Label
  117. GOBACK                Jump from a GOTO command back (not implemented yet)
  118. :LABEL                Label
  119. IF ...                IF CLAUSES  [ = , < , <= , > , >= , <> ]
  120. SETFBCOLOR f,b        Set Foreground to f and Background to b
  121.                       (f,n are integer)
  122. DELAY n               Waits n milliseconds
  123. RANDOM(VarName,N)     Creates a Random-Integer from 1 to N and
  124.                       stores it in the variable VarName.
  125. CALL QuestFileName    Leave the current questionaire and skip to
  126.                       another, which is specified.
  127. DISPLAY FileName      Display the contents of a TextFile.
  128. TERMINATE VarName     Terminate with ErrorLevel of VarName.
  129. SUM (ResultVarName|Var1|...|VarN)
  130. MEAN(ResultVarName|Var1|...|VarN)
  131. ASSIGNUSERFILE        Assign GTUserFile
  132. CLOSEUSERFILE         Close  GTUserFile
  133. GOTOLOGGEDONUSER      Goto the record of the logged on user
  134. READNEXTUSER          read next record of GTUserFile
  135. CHANGELEVELTO NewLev  Change level of current userrecord to NewLev
  136.  
  137.                       Variables can be:
  138.  
  139.                       ActUser.LEVEL
  140.                       ActUser.NAME
  141.                       ActUser.CITY
  142.                       ActUser.PSW
  143.                       ActUser.PHONE
  144.  
  145.  
  146.  
  147.  
  148.  
  149. ;EXAMPLE:
  150. ;------------------------------------------------------
  151. :PSW
  152. SETFBCOLOR 14,0
  153. PSW=    |Enter your Password|30|3|1|1|1|1
  154. IF PSW = JuLo THEN GOTO :JULO
  155. GOTO :WRONGPSW
  156. :JULO
  157. @@CO=Hi, JuLo.
  158. @@CO=
  159. :GET_NUMBER
  160. NR= |Enter a number greater 10 |3| 5|1|3|1|1
  161. IF NR <= 10 THEN GOTO :GET_NUMBER
  162. @@CO=You've got it. Bye, Bye.
  163. @@CO=
  164. GOTO :ENDE
  165. :WRONGPSW
  166. SETFBCOLOR 12,11
  167. @@CO=WRONG PASSWORD
  168. DELAY 1000
  169. GOTO :PSW
  170. :ENDE
  171. ;------------------------------------------------------
  172.  
  173.  
  174. JLUTIL /QU QUEST004.@JL
  175. JLUTIL /QU 4
  176. ═══════════════════════════════════════════════════════════════════════════════
  177.  
  178.  
  179.