.TOPIC:                                            
Miscellaneous Commands

                                            VBBS 6.12 Documentation -- 10-G-1

         ͻ
          CHAPTER TEN ANNEX G      MISCELLANEOUS COMMANDS                
         ͼ

                This is the catchall category.  Many useful commands are
         located in this section that just can't be qualified by a major
         type.

         VISUAL/INTERACTIVE
         

         AUTOPOST <---

                This brings up the autopost listing.  See VBBS.DOC for more
           information on autoposts.

         LISTCALLERS ->  LISTCALLERS <value1>

                This command brings up a list of the callers to your BBS
           for the day.  This will show all of the daily callers if
           <value1> is left blank or set to a number higher than the
           total number of callers, otherwise it will show the last
           <value1> callers.

         LOGOFF <---
         LOGOFFYN <---

                These two commands show the user the LOGOFF.MNU and then
           log the user off of the BBS. The only difference between the
           two is that LOGOFFYN prompts the user, while LOGOFF just does
           it.

         PAGESYSOP <---

                This pages the sysop for chat, if available.  See VBBS.DOC
           for information on chat availability.

         RANDOM <---

                This command shows one of your random blurbs from your
           random blurbs file.  See VBBS.DOC for more information on the
           random message setup (in VCONFIG).

         STACK ->  STACK <variable1>

                This command takes the string in <variable1> and places it
           into the next input section that the script enters.  This can
           help make automating multi-keypress functions, like viewing a
           certain message, easy.  It has been tested and can store at the
           LEAST 800 characters from 80 '&'ed variables with NO problems.
           To STACK more than one line of characters for this command just
           use the '&' operator to add multiple variables into the one
           <variable1> for use on the STACK line.  If you DOOR out of VBBS
           or switch to VQWK/VBBS-AUX the information in the stack will be
           lost and will not be implemented.


                                            VBBS 6.12 Documentation -- 10-G-2


         SYSINFO <---

                This shows the user a listing of the BBS' activity during
           the current day and over the BBS' lifetime.

         VALIDATE <---

                This loads up the network message validation routine. All
           messages in 'Validate On' subs are located here.


         WHO <---

                This command lists who is currently online and what they
           are doing.  This normally lists the last function block command
           that was selected or the last ACTION command that was used.


         USER MODIFIERS
         

         ACCOUNT <---

                This brings up the user's default settings and allows the
           user to change them.

         ACTION ->  ACTION <string1>

                This command changes the setting in the <who> command's
           listing to <string1>.  <string1> can be a maximum of 22
           characters long.

         ADDCREDITS ->  ADDCREDITS <value1>

                This command adds a number of credits = to <value1> to the
           users account.  <value1> can be positive or negative.

         ADDTIME ->  ADDTIME <value1>

                This command adds a number of minutes equal to <value1> to
           the users time left for the day.  <value1> can be positive or
           negative.  Note: The change is for the current call ONLY when
           <value1> is positive but lasts for the entire day if <value1>
           is negative, so be careful when using a negative value.

         SETACCFLAG ->  SETACCFLAG <variable1> <option>

                These are the flags used in VConfig to set up restrictions
           on your subs.  They are the (h) flags in the user editor and
           more information on their uses can be found in VBBS.DOC.  The
           <variable1> can be any letter from A to Z and <option> is either
           ON or OFF (remember it is case insensitive).


                                            VBBS 6.12 Documentation -- 10-G-3


         SETEXTRA ->  SETEXTRA <value1> <string2>

                There are 8 user-specific variables available for use.
           Each variable can contain a <string2> of up to 16 characters.
           The <value1> determines which $EXTRAx will be set.  This is one
           of the ways you can have info pass between scripts and kept
           track of during the 'DOOR' command.  See VDOOR.DOC for a full
           explaination on how this is done.


         SETFLAGS ->  SETFLAGS <variable1> <option>

                There are 26 user-specific flags available for use, these
           are also called general (i) flags.  Each flag is a letter from
           A to Z and they are toggled with the <option> ON or OFF.  This
           is another way info can be passed between scripts or saved for
           use after a 'DOOR' command.  See VDOOR.DOC for an integrated
           example on how this is done.

           Special Note - three of the flags have a preset use for VBBS:
                 A -->  This flag is toggled on/off with the defaults
                        A>utopost command.
                 F -->  When this flag is ON the user will use the
                        built-in Full-Screen Editor.
                 X -->  When this flag is ON the user will only see
                        a menu by pressing <?>. Also called expert mode.

         SETSL -> SETSL <value1>

                Use this command to alter a users security level as shown
          by the $security variable.  The <value1> can be any integer value
          from 0 to 250.  The limit of 250 was set for security reasons.

         SETTIMELIMIT -> SETTIMELIMIT <value1>

                This command can be used to increase or decrease a user's
          maximum time per day as shown by the $maxtime variable.  It will
          accept any integer from 0 to 240 for <value1> and this value is
          in minutes per day. The limit of 240 was set for security reasons.

         USEREDIT <---

                This command loads the user editor, mostly for sysop use.
           Only accounts with an SL of 255 can access this feature.


         REAL MISCELLANY
         

         ! ->  ! <put your comments here>

                Comment line. All text after a '!' is ignored by the
           script compiler.


                                            VBBS 6.12 Documentation -- 10-G-4


         & ->  & <filename>

                This is an include directive for the VSCRIPT compiler to
           add in the contents of another script onto the end of the
           existing code during compilation.  This allows you to write
           up modular scripts and use them in more than one main script
           without having to type or block-copy the section in.  Just
           remember that it adds the code onto the END of the original
           script, so you must include the GO or CALL statements to get
           access to the extra sections.  You can also use this function
           to reduce the size of a single script, as a very long START.V
           can cause problems when it is run (yet you will have none
           of the problems if you break into pieces and include them in.)

         BEEP <---

                This sends a beep through the computer speaker.

         DELAY ->  DELAY <value1>

                This command pauses the script for <value1> seconds.

         LOG ->  LOG <token2> <token3> <token4> ... <token7>

                This command writes up to 6 tokens into the daily log
           file BBS.LOG, located in your \DATA directory.



