home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / com / bbs / simplex / urgent.doc < prev    next >
Text File  |  1992-08-16  |  22KB  |  537 lines
  1. This document contains any important information that I deem important
  2. for you to read.  Please give it a look over.
  3.  
  4.  
  5. 0) Updating to version 1.02.
  6.  
  7. *************** Urgent: FROM101.EXE and FROM1012.EXE ******************
  8.  
  9. Before running any version after 1.01 if you haven't run any version
  10. subsequent to it, you MUST run the program FROM101.EXE (or
  11. for OS/2 users FROM1012.EXE) in your Simplex directory.  This will
  12. convert your CONFIG.BBS, USERLIST.BBS and all your menu files to using
  13. the new format!  The old ones will be names CONFIG.BAK, USERLIST.BAK,
  14. and each menu file will also have a .BAK.
  15.  
  16. Once you have run the new version, and everything is successful, you
  17. can delete the .BAK files.
  18.  
  19. The new version of Simplex now implements 16 user flags (A through P). 
  20. These can be used to restrict access to certain menu items.  There are
  21. two new menu options which allow you to turn on or off user flags.
  22.  
  23. ***********************************************************************
  24.  
  25.  
  26. 1) Crashes and/or Bugs
  27.  
  28.  Please report any strange crashes or bugs back to me at any of the
  29. addresses indicated below.  OS/2 users especially.  If you get an error
  30. screen from OS/2 with a register dump, PLEASE copy down the numbers
  31. next to CS: and IP: in the dump and give them to me.  That will greatly
  32. assist me in locating the problem!!
  33.  
  34.  
  35. 2) Contacting Chris Laforet Software
  36.  
  37.  You may send me mail through any of the following:
  38.  
  39.  Programmer's Oasis BBS, USA .... 919/226-6984
  40.  Programmer's Oasis 2 BBS, USA .. 919/226-7136
  41.  Fidonet Email .................. Chris Laforet @ 1:151/401 or 1:151/402
  42.  Compuserve Email ............... User ID: 76120,110
  43.  US Mail ........................ Chris Laforet Software
  44.                                   511-D Poplar St
  45.                                   Graham, NC  27253
  46.  
  47.  These I check occassionally:
  48.  
  49.  BIX Email....................... User ID: Laforet
  50.  GEnie Email .................... User ID: XTX74591
  51.  
  52.  
  53. 3) Fidonet users can access a Simplex echo
  54.  
  55.   Users who wish to hook into the private Simplex echo can send me
  56. Fidonet mail at 1:151/401 or 1:151/402 and request it.  What we will do
  57. is set up a passworded session for the mailers and you will have to
  58. poll for mail once or twice a week.  The tag name off the echo is
  59. SIMPLEX.  In your message, send me your node information, the password
  60. you wish the mailers to use (<= 8 letters, case is significant) and
  61. I'll set it up for you.
  62.  
  63.  
  64. 4) Help files
  65.  
  66.   The help files in help.zip are the .asc and .ans formats needed by
  67. Simplex.  The .src files are the source files in SANSI-compilable
  68. format in case you wish to change the help files.
  69.  
  70.  
  71. 5) DOS Overlay version of Simplex
  72.  
  73.   DOS users can get a copy of SIMPLEXO.EXE from any of the following
  74. locations.  It saves about 200K of memory over the regular SIMPLEX.EXE
  75. while running.  If you run door games, it might be better to use this. 
  76. It is not included with the distribution ZIP because it would make it
  77. too large.  Simplexo.exe can be downloaded from the Simplex file area on 
  78. any of the following BBSes:
  79.  
  80.  Programmer's Oasis BBS, USA .... 919/226-6984 HST,2400,1200,300 N,8,1
  81.  Programmer's Oasis 2 BBS, USA .. 919/226-7136 HST,2400,1200,300 N,8,1
  82.  Stardate 1990 BBS, USA ......... 919/376-8432 HST,2400,1200,300 N,8,1
  83.          
  84.  
  85. 6) Developing Utilities for Simplex
  86.  
  87.   You are encouraged to develop external utilities for Simplex.  Please
  88. feel free to ship them over to the Simplex areas on any of those BBSes. 
  89. The data structures for Simplex are in this doc and are BYTE aligned
  90. (-Zp1 in MSC).  If you need extra information, contact Chris Laforet at
  91. any of the above addresses and we'll see what we can do!
  92.  
  93.  
  94. 7) Data information and structures for Simplex v 1.00
  95.  
  96.  
  97. ***** Remember that structures are BYTE-ALIGNED!!! *****
  98.  
  99.  
  100. /* these macros access the user_flags bit-mapped options */
  101.  
  102. #define USER_CLS               0x1         /* send cls codes */
  103. #define USER_MORE              0x2         /* use more? paging */
  104. #define USER_ANSI              0x4         /* use ansi */
  105. #define USER_EDITOR            0x8         /* use full screen editor */
  106. #define USER_EXPERT            0x10      /* expert (abbreviated) menus */
  107. #define USER_FILEATTACH        0x20      /* allow user to fileattach in netmail areas? */
  108. #define USER_DELETED           0x8000      /* user is deleted pending purge */
  109.  
  110.  
  111. /* these macros access the menu type options */
  112.  
  113. #define MENU_SHOW              0x0         /* show menu line only */
  114. #define MENU_CALL              0x1         /* call next menu */
  115. #define MENU_GOTO              0x2         /* goto next menu - no return */
  116. #define MENU_RET               0x3         /* return to previous menu */
  117.  
  118. #define MENU_ENTER             0x10      /* enter a message */
  119. #define MENU_READ              0x11      /* read a message */
  120. #define MENU_SCAN              0x12      /* scan messages */
  121. #define MENU_QSCAN             0x13      /* quickscan messages */
  122. #define MENU_USERLIST          0x14      /* search/display users list */
  123. #define MENU_NETSEARCH         0x15      /* search for netmail address */
  124. #define MENU_FREQ              0x16      /* generate File Request to netmail node */
  125.  
  126. #define MENU_LIST              0x20      /* list file.bbs listing */
  127. #define MENU_UPLOAD            0x21      /* upload files to area */
  128. #define MENU_DOWNLOAD          0x22      /* download files from area */
  129. #define MENU_RAW               0x23      /* raw directory list in area */
  130. #define MENU_CONTENTS          0x24      /* view archive contents */
  131. #define MENU_NEW               0x25      /* show new files on system */
  132. #define MENU_SRCHNAME          0x26      /* search for file name on system */
  133. #define MENU_SRCHKEY           0x27      /* search for keyword on system */
  134. #define MENU_KILL              0x28      /* kill/delete file in area */
  135. #define MENU_READFILE          0x29      /* read a textfile in file area */
  136. #define MENU_DOWNLOAD_FILE     0x2a      /* download 1 file from area */
  137. #define MENU_MOVEFILES         0x2b      /* move files to another area */
  138.  
  139. #define MENU_SHOWFILE          0x30      /* show an ansi/ascii file */
  140. #define MENU_SHOWHOT           0x31      /* show an ansi/ascii file with active keys */
  141. #define MENU_SHOWWAIT          0x32      /* show an ansi/ascii file with wait for Enter */
  142. #define MENU_QUESTION          0x33      /* show a questionaire file */
  143.  
  144. #define MENU_CITY              0x40      /* change users city/state */
  145. #define MENU_PASSWORD          0x41      /* change users password */
  146. #define MENU_CLS               0x42      /* toggle users cls state */
  147. #define MENU_MORE              0x43      /* toggle users more state */
  148. #define MENU_SCREENLEN         0x44      /* change users screen len */
  149. #define MENU_ANSI              0x45      /* toggle ansi on/off */
  150. #define MENU_EDITOR            0x46      /* toggle between line and full editor */
  151. #define MENU_EXPERT            0x47      /* toggle between novice and expert mode */
  152. #define MENU_HOMEPHONE         0x48      /* change home phone number */
  153. #define MENU_DATAPHONE         0x49      /* change data phone number */
  154.  
  155. #define MENU_ADENTER           0x50      /* enter an advertisement */
  156. #define MENU_ADREAD            0x51      /* read advertisements */
  157. #define MENU_ADSCAN            0x52      /* scan advertisments */
  158.  
  159. #define MENU_NEWPRIV           0x60      /* set a new privilege */
  160. #define MENU_UPTIME            0x61      /* raise the time of the user x minutes */
  161. #define MENU_DOWNTIME          0x62      /* drop the time of the user x minutes */
  162.  
  163. #define MENU_RUN               0xf0      /* run a program from BBS */
  164. #define MENU_EXIT              0xf1      /* exit BBS with errorlevel */
  165. #define MENU_VERS              0xf2      /* show BBS version info */
  166. #define MENU_USAGE             0xf3      /* show users time usage and dl/ul info */
  167. #define MENU_YELL              0xf4      /* yell for sysop */
  168. #define MENU_CLOCK             0xf5      /* show clock for time synchronizing */
  169. #define MENU_CHECKMAIL         0xf6      /* check for mail addressed to user */
  170. #define MENU_USERUPGRADE       0xf7      /* sysop's user-upgrade option */
  171. #define MENU_LOGOFF            0xff      /* hangup and log off */
  172.  
  173. #define M_SIGNATURE            0xa442      /* proves file is actual menu file */
  174.  
  175.  
  176. /* these macros are for message board flags */
  177.  
  178. #define MSG_LOCAL_FILEATTACH   0x0
  179. #define MSG_LOCAL              0x1
  180. #define MSG_ECHO               0x2
  181. #define MSG_NET                0x4
  182. #define MSG_PRIVATE            0x8         /* messages are private */
  183. #define MSG_PUBLIC             0x10      /* messages are public */
  184. #define MSG_ALIAS              0x20      /* aliases are allowed */
  185.  
  186.  
  187. /* these macros are for message header flags */
  188.       
  189. #define MSGH_DELETED           0x1
  190. #define MSGH_PRIVATE           0x2
  191. #define MSGH_RECEIVED          0x4
  192. #define MSGH_NET_UNSENT        0x8      /* is unsent Netmail message */
  193. #define MSGH_NET               0x10   /* is Netmail */
  194. #define MSGH_ECHO_UNSENT       0x20   /* is unsent Echomail message */
  195. #define MSGH_ECHO              0x40   /* is echomail */
  196. #define MSGH_LOCAL_FILEATTACH  0x80   /* is local fileattach */
  197.  
  198. #define NET_KILLSENT           0x100   /* kill/sent netmail */
  199. #define NET_SENT               0x200   /* netmail sent */
  200. #define NET_FILEATTACH         0x400   /* file(s) attached */
  201. #define NET_CRASH              0x800   /* crashmail */
  202. #define NET_RECEIPT_REQ        0x1000   /* receipt requested */
  203. #define NET_AUDIT_REQ          0x2000   /* audit request */
  204. #define NET_RECEIPT            0x4000   /* return receipt */
  205.  
  206.  
  207. /* these macros are for advertisement board header flags */
  208.  
  209. #define ADH_DELETED            0x1
  210. #define ADH_REPLIES            0x2
  211.  
  212.  
  213. /* color macros */
  214.  
  215. #define BLACK                  0
  216. #define BLUE                   1
  217. #define GREEN                  2
  218. #define CYAN                   3
  219. #define RED                    4
  220. #define MAGENTA                5
  221. #define BROWN                  6
  222. #define WHITE                  7
  223. #define BRIGHT                 8
  224. #define BLINK                  0x80
  225. #define ON_BLACK               0x0
  226. #define ON_BLUE                0x10
  227. #define ON_GREEN               0x20
  228. #define ON_CYAN                0x30
  229. #define ON_RED                 0x40
  230. #define ON_MAGENTA             0x50
  231. #define ON_BROWN               0x60
  232. #define ON_WHITE               0x70
  233.  
  234. /* Values for flags in Version 6 nodelist */
  235.  
  236. #define NL_HUB                 0x1
  237. #define NL_HOST                0x2
  238. #define NL_REGION              0x4
  239. #define NL_ZONE                0x8
  240. #define NL_CM                  0x10
  241.  
  242.  
  243. /* these macros are for user flags */
  244.  
  245. #define UF_A                  0x1
  246. #define UF_B                  0x2
  247. #define UF_C                  0x4
  248. #define UF_D                  0x8
  249. #define UF_E                  0x10
  250. #define UF_F                  0x20
  251. #define UF_G                  0x40
  252. #define UF_H                  0x80
  253. #define UF_I                  0x100
  254. #define UF_J                  0x200
  255. #define UF_K                  0x400
  256. #define UF_L                  0x800
  257. #define UF_M                  0x1000
  258. #define UF_N                  0x2000
  259. #define UF_O                  0x4000
  260. #define UF_P                  0x8000
  261.  
  262.  
  263.  
  264. struct user
  265.    {
  266.    char user_name[41];
  267.    char user_password[16];
  268.    char user_city[31];
  269.    char user_home[15];            /* users home number */
  270.    char user_data[15];            /* users data/business number */
  271.    unsigned char user_priv;      /* users privilege level */
  272.    int user_uflags;             /* version 1.02 added 16 flags */
  273.    char user_screenlen;         /* length of users screen in lines */
  274.    int user_credit;            /* credit in cents for fidomail */
  275.    int user_flags;               /* bit mapped flags for options */
  276.  
  277.    int user_firstdate;            /* first date user called */
  278.    int user_lastdate;            /* last date called */
  279.    int user_lasttime;            /* last time called */
  280.    int user_calls;               /* number of calls to the BBS */
  281.    int user_timeused;            /* amount of time used for the day (minutes) */
  282.  
  283.    int user_upload;            /* number of uploads */
  284.    long user_uploadbytes;         /* number of bytes uploaded */
  285.    int user_dnload;            /* number of downloads */
  286.    long user_dnloadbytes;         /* number of bytes downloaded */
  287.  
  288.    char user_reserved[4];         /* reserved for later use */
  289.    };
  290.  
  291.  
  292. struct prompt
  293.    {
  294.    int prompt_sig;               /* signiture for valid menu file 0xa442 */
  295.    char prompt_color;
  296.    char prompt_hilite;
  297.    char prompt_string[56];         /* string to show */
  298.    };
  299.  
  300.  
  301. struct menu
  302.    {
  303.    int menu_number;            /* line number */
  304.    unsigned char menu_type;      /* type of choice */
  305.    char menu_key;               /* key to initiate choice */
  306.    unsigned char menu_priv;      /* user priv to see/use choice */
  307.    int menu_flags;              /* version 1.02 added 16 flags */
  308.    char menu_auto;               /* automatic execution if true */
  309.    char menu_color;            /* color of choice */
  310.    char menu_hilite;            /* color of hilight */
  311.    char menu_expert;            /* if true show when expert mode is on */
  312.    char menu_line[71];            /* line to show on screen */
  313.    char menu_data[71];          /* data line for menu option */
  314.    char menu_deleted;
  315.    };
  316.  
  317.  
  318. struct cfg
  319.    {
  320.    int cfg_baud;               /* maximum baud rate */
  321.    int cfg_port;               /* port number */
  322.    char cfg_init[61];            /* modem initialization string */
  323.    char cfg_resp[21];            /* normal modem response string */
  324.    char cfg_resp3[21];            /* 300 baud response */
  325.    char cfg_resp12[21];         /* 1200 baud response */
  326.    char cfg_resp24[21];         /* 2400 baud response */
  327.    char cfg_resp48[21];         /* 4800 baud response */
  328.    char cfg_resp96[21];         /* 9600 baud response */
  329.    char cfg_resp192[21];         /* 19200 baud response */
  330.    char cfg_ring[21];            /* ring response */
  331.    char cfg_answer[21];         /* answer string */
  332.    char cfg_hangup[21];         /* hangup string */
  333.    char cfg_busy[21];            /* offhook string */
  334.    int cfg_flags;               /* flags for setup */
  335.  
  336.    int cfg_minbaud;            /* minimum connect rate allowd on BBS */
  337.    int cfg_ansibaud;            /* minimum baud for ansi */
  338.    int cfg_dlstart;            /* start time for downloads */
  339.    int cfg_dlstop;               /* stop time for downloads */
  340.  
  341.    int cfg_zone;
  342.    int cfg_net;
  343.    int cfg_node;
  344.    int cfg_akazone[5];
  345.    int cfg_akanet[5];
  346.    int cfg_akanode[5];
  347.  
  348.    char cfg_sysopname[41];         /* sysop's name */
  349.    char cfg_bbsname[61];         /* BBS name */
  350.    char cfg_origin[66];         /* origin line */
  351.    char cfg_menupath[61];         /* path to menu files */
  352.    char cfg_screenpath[61];      /* path to screen files */
  353.    char cfg_nodepath[61];         /* path to nodelist */
  354.    char cfg_fapath[61];         /* path to local fileattaches */
  355.  
  356.    char cfg_netpath[61];         /* path for net messages */
  357.    char cfg_inboundpath[61];      /* path for inbound message pkts */
  358.    char cfg_outboundpath[61];      /* path for outbound message pkts */
  359.    char cfg_packetpath[61];      /* path for unpacking message pkts */
  360.    char cfg_badmsgpath[61];      /* path for placing bad messages */
  361.    char cfg_unarc[61];            /* command for unarcing ARCed files */
  362.    char cfg_unzip[61];            /* command for unarcing ZIPped files */
  363.    char cfg_unzoo[61];            /* command for unarcing ZOOed files */
  364.    char cfg_unlzh[61];            /* command for unarcing LZHed files */
  365.    char cfg_arc[61];            /* command for arcing ARCed files */
  366.    char cfg_zip[61];            /* command for arcing ZIPped files */
  367.    char cfg_zoo[61];            /* command for arcing ZOOed files */
  368.    char cfg_lzh[61];            /* command for arcing LZHed files */
  369.  
  370.    unsigned char cfg_newpriv;      /* priv level of new user */
  371.    int user_newflags;            /* version 1.02 added 16 flags */
  372.    int cfg_newcredit;            /* credit level of new user */
  373.    int cfg_newtime;            /* logon time in mins for newuser */
  374.    char cfg_askhome;            /* ask for home phone */
  375.    char cfg_askdata;            /* ask for data phone */
  376.  
  377.    char cfg_ansi;               /* use ansi on local console */
  378.    char cfg_direct;            /* use direct screen writes? */
  379.    char cfg_snow;               /* use snow checking on screen writes */
  380.    char cfg_pwdtries;            /* number of attempts to get password */
  381.    char cfg_inactive;            /* time before hanging up for inactivity */
  382.    char cfg_yells;               /* number of yells per session */
  383.    char cfg_yelltime;            /* number of seconds for yell bell */
  384.    int cfg_yellstart;            /* start time for yell-bell */
  385.    int cfg_yellstop;            /* stop time for yell-bell */
  386.    };
  387.  
  388.  
  389. struct msg
  390.    {
  391.    int msg_number;               /* message board number */
  392.    char msg_areaname[41];         /* message area name */
  393.    char msg_flags;               /* message area flags */
  394.    unsigned char msg_readpriv;
  395.    unsigned char msg_writepriv;
  396.    unsigned char msg_sysoppriv;
  397.    char msg_origin[66];         /* special origin line for this if echomail area */
  398.    char msg_deleted;            /* true if deleted */
  399.    };
  400.  
  401.  
  402. struct file
  403.    {
  404.    int file_number;            /* file board number */
  405.    char file_areaname[41];         /* file area name */
  406.    char file_pathname[61];         /* path to file area */
  407.    char file_descname[61];         /* if set, this is the path to files.bbs */
  408.    unsigned char file_priv;      /* priv level to search this area */
  409.    char file_deleted;            /* true if deleted */
  410.    };
  411.  
  412.  
  413. struct evt
  414.    {
  415.    char evt_enabled;            /* true if enabled */
  416.    char evt_forced;            /* true if forced event */
  417.    char evt_days;               /* 0-S-M-T-W-T-F-S */
  418.    unsigned int evt_time;         /* encoded time to run */
  419.    char evt_errorlevel;
  420.    char evt_title[21];            /* optional name for event */
  421.    char evt_deleted;            /* true if deleted */
  422.    };
  423.  
  424.  
  425. struct msgh      /* systemwide message number is ((offset/sizeof(struct msgh)) + 1) -- 0 is invalid systemwide message */
  426.    {
  427.    int msgh_area;               /* area number of message */
  428.    int msgh_number;            /* message number int that area! */
  429.    char msgh_to[41];            /* addressee of message */
  430.    char msgh_from[41];
  431.    char msgh_subject[71];
  432.    int msgh_date;
  433.    int msgh_time;
  434.    int msgh_flags;               /* net and message flags */
  435.    int msgh_szone;
  436.    int msgh_snet;
  437.    int msgh_snode;
  438.    int msgh_dzone;
  439.    int msgh_dnet;
  440.    int msgh_dnode;
  441.    int msgh_cost;
  442.    int msgh_prev;               /* previous message link - systemwide message number */
  443.    int msgh_next;               /* next message link - systemwide message number */
  444.    long msgh_offset;            /* start offset of message */
  445.    long msgh_length;            /* message length in bytes */
  446.    };
  447.  
  448.  
  449. struct mdata
  450.    {
  451.    int mdata_msgs;               /* total number of messages */
  452.    int mdata_del;               /* total number of deleted messages */
  453.    };
  454.  
  455.  
  456. struct mc      /* message counts by area */
  457.    {
  458.    int mc_area;
  459.    int mc_msgs;
  460.    };
  461.  
  462.  
  463. struct mlink
  464.    {
  465.    int mlink_area;
  466.    int mlink_number;         /* number of the message in that area! */
  467.    int mlink_flags;         /* a copy of the message flags */
  468.    int mlink_cksum;         /* a checksum on the uppercased TO: person's name */
  469.    };
  470.  
  471.  
  472. struct adh      /* header for advertisements */
  473.    {
  474.    char adh_from[41];
  475.    char adh_subject[71];
  476.    int adh_date;
  477.    int adh_time;
  478.    int adh_killdate;
  479.    int adh_flags;               /* ad flags */
  480.    long adh_prev;               /* previous ad header */
  481.    long adh_next;               /* next ad header */
  482.    long adh_length;            /* ad length in bytes */
  483.    };
  484.  
  485.  
  486. struct m
  487.    {
  488.    char m_name[10];            /* menu's name */
  489.    struct prompt m_prompt;
  490.    struct menu **m_lines;
  491.    int m_maxlines;                 /* number of allocated menu lines */
  492.    int m_curlines;                 /* number of menu lines */
  493.    };
  494.  
  495.  
  496. struct ui      /* User-info structure */
  497.    {
  498.    char ui_name[41];            /* user's name */
  499.    int ui_date;               /* date user logged in */
  500.    int ui_time;               /* time user logged in */
  501.    int ui_baud;               /* baud rate user logged in at */
  502.    int ui_online;               /* time user spent online in minutes */
  503.    int ui_msgread;               /* number of messages user read */
  504.    int ui_msgposted;            /* number of messages user posted */
  505.    int ui_upload;               /* number of uploads */
  506.    long ui_uploadbytes;         /* number of bytes uploaded */
  507.    int ui_dnload;               /* number of downloads */
  508.    long ui_dnloadbytes;         /* number of bytes downloaded */
  509.    };
  510.  
  511.  
  512. struct nl         /* version 6 nodelist entry */
  513.    {
  514.    int nl_net;
  515.    int nl_node;
  516.    int nl_cost;
  517.    char nl_bbsname[34];
  518.    char nl_phone[40];
  519.    char nl_city[30];
  520.    char nl_pwd[8];
  521.    int nl_realcost;
  522.    int nl_hub;
  523.    char nl_baud;
  524.    char nl_modemtype;
  525.    int nl_flags;
  526.    int nl_waste;
  527.    };
  528.  
  529.  
  530. struct nlix         /* version 6 nodelist index */
  531.    {
  532.    int nlix_node;
  533.    int nlix_net;
  534.    };
  535.  
  536.  
  537.