home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / cis / vidtex.ark / CSEXEC.DOC next >
Text File  |  1987-03-16  |  37KB  |  991 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                          CompuServe
  20.  
  21.                       CSEXEC(TM)  3.0
  22.  
  23.              Intelligent Terminal Emulator for
  24.  
  25.                         CP/M Systems
  26.  
  27.                      Copyright (c) 1983
  28.  
  29.                   CompuServe Incorporated
  30.  
  31.                                                       Page 1
  32.  
  33.  
  34. 1.0  INTRODUCTION
  35.  
  36. CSEXEC(TM)   for   CP/M   is   an   easy-to-use,    powerful
  37. communications  program  written  for  CompuServe  by  Susan
  38. Cavanaugh.   This  program  allows  your  CP/M   system   to
  39. communicate  with the CompuServe Information Service as well
  40. as any other host computer system with  telephone  answering
  41. capabilities  utilizing  the  same communications standards.
  42. This manual explains how to use  the  CSEXEC  software  with
  43. examples   illustrating   its   use   on   CompuServe.   For
  44. information  on  accessing  and  using  a  particular   host
  45. computer, refer to the User's Guide for that system.
  46.  
  47.  
  48.  
  49. 1.1  Hardware Required
  50.  
  51. CSEXEC requires a CP/M computer system with at least 32K  of
  52. RAM,  one disk drive, a serial communications interface, and
  53. an RS-232 modem.
  54.  
  55.  
  56.  
  57. 2.0  CUSTOMIZING THE EXECUTIVE TO YOUR SYSTEM
  58.  
  59. Due to the variety  of  I/O  configurations  possible  among
  60. computer  systems  running  under  CP/M,  you  will  need to
  61. customize the Executive's I/O routines for  your  particular
  62. system  configuration.   This  requires a basic knowledge of
  63. programming in 8080 assembler language.
  64.  
  65.  
  66.  
  67. 2.1  The Input/Output Overlay
  68.  
  69.  
  70. Your CSEXEC diskette  contains  a  file  called  OVERLAY.ASM
  71. which  contains  assembler  source  code  of  the serial I/O
  72. routines which service the modem.  It  is  to  be  used  for
  73. customizing   the   executive   to   different   serial  I/O
  74. configurations.  OVERLAY.ASM contains three subroutines:
  75.  
  76.  
  77.         SIOINI  - initializes the UART.
  78.  
  79.         SIOGET  - checks modem receiver and returns with:
  80.  
  81.                         Z = 1 if no data ready.
  82.                         Z = 0 if data was read, data is in 
  83.                         the accumulator.
  84.  
  85.         SIOPUT  - stores the contents of the accumulator in
  86.                   the UART's transmitter.  It waits until
  87.                   the transmitter accepts data before
  88.                   returning.
  89.                                                       Page 2
  90.  
  91.  
  92. Modify OVERLAY.ASM according to your own communications UART
  93. specifications.  For instance, it may be necessary to modify
  94. the initialization routine to specify the baud rate and  you
  95. may  need  to  change  the sense of the receive and transmit
  96. flags in the get and put routines.
  97.  
  98. Timing considerations require that the console  and  listing
  99. devices  be  capable of handling data at a speed which is at
  100. least TWICE the baud setting of the modem serial  port.   If
  101. this  is not the case for your computer, it is probable that
  102. incoming data will be lost.
  103.  
  104. The necessary specifications are:
  105.  
  106.         8 data bits
  107.         no parity
  108.         1 stop bit
  109.  
  110. Included in  OVERLAY.ASM  are  the  program  stack  and  the
  111. compressed ascii dictionary.  These don't need to be changed
  112. for your system.  They are included in the  overlay  because
  113. they must follow the I/O routines in memory.
  114.  
  115.  
  116.  
  117.  
  118. 2.2  Creating CSEXEC For Your System
  119.  
  120.  
  121. After  you  have  made  all   the   necessary   changes   to
  122. OVERLAY.ASM, assemble it.  
  123.  
  124. Then, type the following at the CP/M prompt:
  125.  
  126.         DDT EXECOR.COM <cr>
  127.         IOVERLAY.HEX <cr>
  128.         R <cr>
  129.  
  130. This will overlay your I/O routines with  the  generic  CP/M
  131. Executive,  EXECOR.COM,  in  your  computer's RAM.  Now type
  132. CTRL-C to exit DDT and return to CP/M.
  133.  
  134. To save  the  completed  CSEXEC  for  your  system  on  your
  135. diskette, type:
  136.  
  137.         SAVE 24 CSEXEC.COM <cr>
  138.  
  139. Note that if you have supplied more than two pages  of  code
  140. in OVERLAY.ASM, you will need to save more than 24 pages.
  141.  
  142.                                                       Page 3
  143.  
  144.  
  145. 3.0  USING A PRINTER WITH CSEXEC
  146.  
  147. If you have a printer connected to your  computer,  you  can
  148. use it to obtain hardcopy with CSEXEC.
  149.  
  150.  
  151.  
  152. 3.1  Copying Data To The Printer
  153.  
  154. If you type  a  CTRL-R  on  the  keyboard,  a  copy  of  all
  155. subsequent  characters received will be sent to the printer.
  156. A CTRL-T stops the copying.  When a CTRL-R (ASCII  character
  157. DC2)  is  received from the host, the copying to the printer
  158. will  start.   When  a  CTRL-T  (ASCII  character  DC4)   is
  159. received,  the  copying  is  stopped.  If the printer is not
  160. ready, an error message will be displayed.
  161.  
  162.  
  163.  
  164. 4.0  RUNNING CSEXEC
  165.  
  166. To load and  execute  CSEXEC,  type  "CSEXEC"  at  the  CP/M
  167. prompt.
  168.  
  169.  
  170.  
  171. 5.0  EXITING CSEXEC
  172.  
  173. CTRL-X will display the menu, at which time, typing  an  "X"
  174. (for  eXit) will exit CSEXEC and return control to CP/M.  To
  175. continue the terminal session, reload and execute CSEXEC.
  176.                                                       Page 4
  177.  
  178.  
  179. 6.0  AUTO LOGON
  180.  
  181. Auto logon allows you to keep  logon  information  for  many
  182. different systems.  It also has the capacity to act in place
  183. of the user for a number of applications.
  184.  
  185.  
  186.  
  187. 6.1  Auto Logon Control 
  188.  
  189. The auto logon menu allows you to control all available auto
  190. logon  operations.  To display the menu, type CTRL-X.  While
  191. looking at the menu, press the letter  that  corresponds  to
  192. the operation you want.  The figure below shows the menu.
  193.  
  194.         Auto Logon Functions
  195.      
  196.           C  Create Auto Logon File
  197.           E  Execute Auto Logon File
  198.           A  Abort Auto Logon
  199.           T  Transmit CTRL-X
  200.           X  Exit program
  201.      
  202.      Press your choice or <RETURN> for terminal mode.
  203.  
  204. To return to terminal mode, press  <RETURN>.   Type  "X"  to
  205. exit the program and return to CP/M.
  206.  
  207.  
  208.  
  209. 6.2  Creating A New Auto Logon File
  210.  
  211. In order to create a new auto logon file on  your  diskette,
  212. follow these steps:
  213.  
  214. 1. Type CTRL-X to display the auto logon  menu.   Press  "C"
  215.    (for  Create)  and you will then be prompted for the auto
  216.    logon file name you wish to use.  If you  press  <RETURN>
  217.    with no file name, the program will assign a default file
  218.    name of CSEXEC.ATO.  To abort auto logon  file  creation,
  219.    type a CTRL-C at any time during the creation process and
  220.    the file will be erased from your diskette and  the  menu
  221.    redisplayed.
  222.  
  223. 2. You will then be asked for a prompt to wait for from  the
  224.    host.   If  you  do  not  want to wait for a prompt, just
  225.    press the <RETURN> or <ESC>  key.   Otherwise  enter  the
  226.    host's  prompt.   The  prompt  sequence  is translated to
  227.    upper case before it is stored  on  disk.   All  received
  228.    characters are translated to upper case for matching with
  229.    the prompt.  The maximum length of a prompt from the host
  230.    is  20  characters.   A  prompt  length  of  four to five
  231.    characters or less is recommended due to the  possibility
  232.    of  noise occurring over the phone lines and garbling the
  233.    incoming prompt.  You may press the <RETURN> or <ESC> key
  234.                                                       Page 5
  235.  
  236.  
  237.    to  terminate  the  prompt.   Neither  terminator will be
  238.    included in the prompt to be searched for.
  239.  
  240. 3. You will then be asked for a response to transmit.  Enter
  241.    your  response  terminated  by  <RETURN>  or  <ESC>.  The
  242.    carriage return will be transmitted  with  the  response.
  243.    The  <ESC>  will transmit no terminator when the response
  244.    is sent.  If you enter just an <ESC> for  a  response,  a
  245.    null  response  is  indicated.   The maximum length for a
  246.    response is 64 characters.  A response of  more  than  64
  247.    characters can be transmitted by entering the response in
  248.    two or more parts, each less than  64  characters,  while
  249.    entering a null prompt between each part of the response.
  250.  
  251. 4. Repeat the prompt/response input sequence as  many  times
  252.    as  is  necessary  to complete your logon sequence.  When
  253.    you are done, type  an  <ESC>  at  the  next  prompt  and
  254.    response  request.  The auto logon menu will reappear and
  255.    allow you to specify which action to take next.
  256.  
  257.  
  258.  
  259. 6.3  Executing An Auto Logon
  260.  
  261. To execute an auto logon file, press CTRL-X to  display  the
  262. menu, then "E" (for Execute).  You will then be prompted for
  263. the auto logon file name to read  from  disk.   The  default
  264. file  name  CSEXEC.ATO will be used if you press <RETURN> at
  265. the file name prompt.  If the file exists on your  diskette,
  266. CSEXEC will enter auto logon mode.  To abort execution of an
  267. auto logon sequence, press CTRL-X to  return  to  the  menu,
  268. then  type  "A"  (for  Abort).   When  using  auto logon for
  269. logging on to a system, you should  wait  until  the  remote
  270. system  answers  the phone to begin the auto logon sequence.
  271. CSEXEC will automatically exit  auto  logon  mode  when  all
  272. prompts have been found and all responses sent.
  273.  
  274. The keyboard remains active during an auto logon  execution.
  275. This  allows you to type during auto logon without affecting
  276. the execution of the auto logon file.
  277.  
  278.  
  279.  
  280. 6.4  Additional Auto Logon Features
  281.  
  282. Auto logon can do more than simply log on to a host  system.
  283. The  prompt-seeking  function  allows  CSEXEC to act in your
  284. place on the keyboard  to  provide  a  response  to  a  host
  285. program.   A  prompt  should  always  be  specified  after a
  286. response that will cause the host to display text.   Prompts
  287. can  be  any  text  that the host displays.  Typical prompts
  288. are:  "!", ":", and "OK".  The response from auto logon  can
  289. be  any  text  or  control  characters.   To enter a control
  290. character into the response, type a carat (^) then type  the
  291. letter of the control key.
  292.                                                       Page 6
  293.  
  294.  
  295. To  obtain  a   delay   of   one-half   second,   enter   ^&
  296. (carat-ampersand)  into  the  response.   For a delay of two
  297. seconds, enter ^% (carat-percent) into the response.
  298.  
  299. A single carat mark is entered into a response  by  entering
  300. two consecutive carats.
  301.  
  302.  
  303.  
  304. 6.5  Auto Logon File Chaining
  305.  
  306. The execution of a new auto logon file may be  started  from
  307. an  already-executing  auto logon file.  This feature allows
  308. you to create an auto logon sequence in multiple files.   To
  309. change a part of the sequence, re-create the file containing
  310. that part.  The other files do not need  to  be  re-created.
  311. When  the  CTRL-X  is  executed from an auto logon file, the
  312. current file is  closed  and  the  file  specified  is  then
  313. executed.   The  contents  of  the auto logon file after the
  314. "CTRL-XEfilename<RETURN>" is ignored.
  315.  
  316.  
  317.  
  318. 6.6  Auto Logon Examples
  319.  
  320. A  sample  auto  logon  creation  sequence  to  log  on   to
  321. CompuServe is shown below.
  322.  
  323.      Creating New Auto Logon
  324.      Enter file name: cpusrv.ato       Select the file
  325.      Prompt: <ESC>                     Don't wait for prompt,
  326.                                        transmit immediately
  327.      Response: ^C<ESC>                 (<Carat><C>)
  328.                                        Transmit a CTRL-C
  329.                                        with no carriage return
  330.      Prompt: ID:                       Wait for 'USER ID:'
  331.      Response: 70000,1                 Then send '70000,1'
  332.      Prompt: word:                     Wait for 'PASSWORD:'
  333.      Response: SECRET                  Then send 'SECRET'
  334.      Prompt: !                         Wait until DISPLA
  335.                                        prompts for input
  336.      Response: GO HOM-1                Transmit 'GO HOM-1'
  337.      Prompt: <ESC>                     Terminate the input
  338.      Response: <ESC>                   sequence by entering
  339.                                        null prompt and null
  340.                                        response
  341.                                                       Page 7
  342.  
  343.  
  344. A  sample  auto  logon  creation  sequence  to  log  on   to
  345. CompuServe through TYMNET is shown below.
  346.  
  347.      Creating New Auto Logon
  348.      Enter file name: tymnet.ato       Select the file
  349.      Prompt: FIER                      Wait for 'PLEASE
  350.                                        TYPE YOUR TERMINAL
  351.                                        IDENTIFIER' from
  352.                                        TYMNET
  353.      Response: A<ESC>                  Transmit an 'A'
  354.                                        without a carriage
  355.                                        return
  356.      Prompt: IN:                       Wait for TYMNET login
  357.                                        message
  358.      Response: CIS02                   Request connection
  359.                                        to CompuServe
  360.      Prompt: ID:                       Wait for 'USER ID:'
  361.      Response: 70000,1                 Then send '70000,1'
  362.      Prompt: word:                     Wait for 'PASSWORD:'
  363.      Response: SECRET                  Then send 'SECRET'
  364.      Prompt: !                         Wait until DISPLA
  365.  
  366.                                        prompts for input
  367.      Response: GO HOM-1                Transmit 'GO HOM-1'
  368.      Prompt: <ESC>                     Terminate the input
  369.      Response: <ESC>                   sequence by entering
  370.                                        null prompt and null
  371.                                        response
  372.                                                       Page 8
  373.  
  374.  
  375. The following example shows how the autolog feature could be
  376. used  to  automatically  dial and login with the D. C. Hayes
  377. Smartmodem.  This example programs the  Smartmodem  to  dial
  378. '555-1234'  using  tone  dialing.   Refer  to the Smartmodem
  379. manual for instructions on creating a programming string.
  380.  
  381.      Creating New Auto Logon
  382.      Enter file name: smart.ato        Select the file
  383.      Prompt: <ESC>                     Don't wait for prompt,
  384.                                        transmit immediately
  385.      Response: AT DT555-1234           Program the Smartmodem
  386.                                        to dial 555-1234
  387.                                        using tone dialing
  388.      Prompt: CONNECT                   Wait for connection
  389.      Response: ^%^C<ESC>               Delay for two seconds
  390.                                        and transmit a
  391.                                        CTRL-C with no
  392.                                        carriage return
  393.      Prompt: ID:                       Wait for 'USER ID:'
  394.      Response: 70000,1                 Then send '70000,1'
  395.      Prompt: word:                     Wait for 'PASSWORD:'
  396.      Response: SECRET                  Then send 'SECRET'
  397.      Prompt: !                         Wait until DISPLA
  398.                                        prompts for input
  399.      Response: GO HOM-1                Transmit 'GO HOM-1'
  400.      Prompt: <ESC>                     Terminate the input
  401.      Response: <ESC>                   sequence by entering
  402.                                        null prompt and null
  403.                                        response
  404.                                                       Page 9
  405.  
  406.  
  407. The following auto logon could be used  to  get  to  the  CB
  408. simulator  program  from  most any other menu on CompuServe.
  409. HOM-21 is used for illustration only  and  may  not  be  the
  410. actual page number of CB on the system.
  411.  
  412.      Creating New Auto Logon
  413.      Enter file name: cb.ato           Select the file
  414.      Prompt: <ESC>                     Don't wait for prompt
  415.      Response: T                       Send T for TOP
  416.      Prompt: !                         Wait until top menu
  417.                                        is displayed
  418.      Response: GO HOM-21               Transmit 'GO HOM-21'
  419.      Prompt: ?                         Wait until CB prompts
  420.                                        for handle
  421.      Response: (Your handle)           Transmit handle
  422.      Prompt: <ESC>                     Terminate the input
  423.      Response: <ESC>                   sequence by entering
  424.                                        null prompt and null
  425.                                        response
  426.  
  427. The following shows how the auto logon might execute.  It is
  428. initiated  by  typing  a CTRL-X and responding with 'E' (for
  429. Execute) at the menu, then typing 'cb.ato' at the file  name
  430. prompt.
  431.  
  432.      T
  433.      
  434.      CompuServe            Page CIS-1
  435.      CompuServe Information Service
  436.      1 Home Services
  437.      2 Business & Financial
  438.      3 Personal Computing
  439.      4 Services for Professionals
  440.      5 User Information
  441.      6 Index
  442.      Enter your selection number,
  443.      or H for more information.
  444.      !GO HOM-21
  445.      CompuServe           Page HOM-21
  446.      
  447.      Request Recorded,
  448.      One Moment, Please
  449.      Thank You for Waiting
  450.      CB Simulator Ver 3(45)
  451.      What's your handle? (Your handle)
  452.      (Channel) users tuned in
  453.      Which channel: 1
  454.      (1,Susana) Hi, CB'er
  455.                                                      Page 10
  456.  
  457.  
  458. 7.0  FILE TRANSFER USING CSEXEC
  459.  
  460. Most of CompuServe's CSEXEC programs contain the ability  to
  461. transfer a file from the microcomputer's disk to CompuServe.
  462. While this  is  a  feature  found  in  many  other  terminal
  463. programs,  most  of them merely transmit the contents of the
  464. file or write exactly what  is  received.   CSEXEC  uses  an
  465. error-free communications protocol to perform file transfer.
  466. This means that if noise occurs on the communications  line,
  467. the  error  will  be  detected  and  the  data block will be
  468. retransmitted.
  469.  
  470. The procedure for performing a file transfer  on  CompuServe
  471. is  relatively  simple  and is described below.  A few terms
  472. must first be defined in order to  explain  file  transfers.
  473. The  process  of  transferring  a  file from CompuServe to a
  474. microcomputer  is  called  DOWNLOADing.   The   process   of
  475. transferring  a  file  from a microcomputer to CompuServe is
  476. called UPLOADing.   The  CompuServe  mainframe  computer  is
  477. referred   to   as   the   HOST  computer  system  and  your
  478. microcomputer is referred to as the REMOTE computer.
  479.  
  480. There are three types of file transfers:  text, binary,  and
  481. machine specific.
  482.  
  483. A text transfer is used to transfer ASCII text files such as
  484. untokenized  BASIC  programs and text files produced by word
  485. processing programs.
  486.  
  487. A binary transfer is used to transfer eight-bit  files  such
  488. as  tokenized  BASIC programs and machine language programs.
  489. This can also be used to transfer most microcomputer's BASIC
  490. data  files.  CSEXEC does not alter any data during a binary
  491. file transfer.
  492.  
  493. A   machine-specific   transfer   is   used   to    transfer
  494. machine-dependent files.  CSEXEC inserts all the information
  495. it needs to recreate  the  file  exactly  as  it  originally
  496. existed.    If   an   attempt   is   made   to   download  a
  497. machine-specific file to  a  microcomputer  which  is  of  a
  498. different  type  than  the microcomputer from which the file
  499. was  uploaded,  CSEXEC  will  issue   a   warning   message.
  500. Machine-specific  transfers  can  be  used to transfer files
  501. that have information kept outside of the file  (usually  in
  502. the  disk  directory) that is essential to the file (such as
  503. file type, record length).
  504.  
  505. For both an upload  and  a  download,  the  CompuServe  file
  506. extension  determines  the  type  of  transfer  that will be
  507. performed.  The valid extensions and the transfer types are:
  508.  
  509.      BIN     Binary transfer
  510.      CMP     Reserved for CompuServe
  511.      IMG     Machine-specific (image) transfer
  512.      TXT     Text transfer
  513.                                                      Page 11
  514.  
  515.  
  516. If any other extension or no extension at  all  is  used,  a
  517. text  transfer  will  be  performed.   To  initiate  a  file
  518. transfer, at the 'OK' prompt, enter:
  519.  
  520.      R FILTRN
  521.  
  522. CompuServe will respond with:
  523.  
  524.      CompuServe File Transfer Program
  525.  
  526. Your machine will then be interrogated to  see  if  you  are
  527. running  a  version of CSEXEC which supports file transfers.
  528. If you are not running a CSEXEC program or if  your  version
  529. of  CSEXEC does not support file transfers, an error message
  530. will be printed and you will be returned to the 'OK' prompt.
  531. If  you  are running a version of CSEXEC which supports file
  532. transfer, you  will  be  asked  for  the  direction  of  the
  533. transfer:
  534.  
  535.      Select direction-
  536.           D if to your computer
  537.           U if to CompuServe
  538.      :
  539.  
  540. Enter a 'U' to transfer a file from  your  microcomputer  to
  541. CompuServe  (upload)  or  a  'D'  to  transfer  a  file from
  542. CompuServe to  your  microcomputer  (download)  at  the  ':'
  543. prompt.
  544.  
  545. You will then be prompted with:
  546.  
  547.      Enter the CompuServe file name:
  548.  
  549. Enter an appropriate file name and extension.  Remember that
  550. the   file   extension   determines  the  type  of  transfer
  551. performed.  For a download this is the name of the  existing
  552. file to be transferred to your microcomputer.  For an upload
  553. this is the name of the file which will be created  in  your
  554. Programming Area.  You will then be prompted with:
  555.  
  556.      Enter a file name for your computer:
  557.  
  558. You may specify any file following the naming rules of CP/M.
  559. This   might  include  a  drive  designation,  a  file  name
  560. extension, or punctuation.  The remote file  name  does  not
  561. affect the type of transfer performed.  For an upload, enter
  562. the name of the file to be transferred to CompuServe.  For a
  563. download,  enter  the  name of the new file to be created on
  564. your diskette.  If the file already exists on your diskette,
  565. you  will  be asked if you would like it to be replaced.  If
  566. so, CSEXEC will erase the existing file and download the new
  567. contents.  If not, the file transfer will be aborted and you
  568. will be returned to the 'OK' prompt.  The original file will
  569. not  be erased from the diskette.  As a transfer proceeds, a
  570. series of digits will be displayed on your screen,  one  for
  571.                                                      Page 12
  572.  
  573.  
  574. each  block  of data.  For each 32 bytes of data transferred
  575. within each block, a plus sign (+) will be displayed between
  576. these digits.
  577.  
  578. When the transfer is completed, the message:
  579.  
  580.      *** File Transfer Completed!  ***
  581.  
  582. will appear and you will be returned to the 'OK' prompt.
  583.  
  584. To signal CSEXEC to abort a file transfer, hold CTRL-X until
  585. the next digit appears on the screen.
  586.  
  587.  
  588.  
  589. 8.0  TECHNICAL INFORMATION
  590.  
  591. The  following  information  is  provided  for   determining
  592. compatibility with hosts other than the CompuServe network.
  593.  
  594.  
  595.  
  596. 8.1  Flow Control
  597.  
  598. CSEXEC  recognizes   the   standard   ASCII   flow   control
  599. characters,  <X-OFF>  (CTRL-S  or DC3) and <X-ON> (CTRL-Q or
  600. DC1).  If CSEXEC receives an <X-OFF> from the host, it  will
  601. halt   transmission.   If  an  <X-ON>  is  not  received  in
  602. approximately five seconds, transmission will be resumed.
  603.  
  604. CSEXEC expects the host  to  observe  the  same  rules.   An
  605. <X-OFF> is sent to stop transmission from the host while the
  606. menu is being used.  An <X-ON> is sent when transmission can
  607. be  resumed.   If the host does not respond to flow control,
  608. characters may be dropped.
  609.  
  610.  
  611.  
  612. 8.2  ESCAPE Sequences
  613.  
  614. CSEXEC responds to certain ESCAPE  sequences  when  received
  615. from the host computer.  These sequences cannot be performed
  616. locally;  they must be received from the host.
  617.  
  618.  
  619.  
  620. 8.2.1  Keyboard Lock And Unlock
  621.  
  622. When an <ESC><b> sequence is received, CSEXEC will lock  the
  623. keyboard  and  not transmit any more characters typed.  This
  624. condition  is  reset  when  CSEXEC  receives   an   <ESC><c>
  625. sequence.   These  sequences  can  be used by a host program
  626. which does  not  want  to  be  interrupted  during  critical
  627. processing.
  628.                                                      Page 13
  629.  
  630.  
  631. 8.2.2  Video Enable And Disable
  632.  
  633. When an <ESC><e> sequence is received, the video is disabled
  634. and  subsequent  characters are not displayed.  The video is
  635. enabled again when an <ESC><f> sequence is received.
  636.  
  637.  
  638.  
  639. 8.3  The Protocol
  640.  
  641. CSEXEC contains a data communications protocol which  allows
  642. error-free   data   transfer  between  CompuServe  and  your
  643. computer.  The details of this protocol are  copyrighted  by
  644. CompuServe,  Inc.  and can only be disclosed under a special
  645. license (not included with this software).
  646.  
  647.  
  648.  
  649. 8.4  CompuServe Control Characters
  650.  
  651. This  section  is  provided  to  demonstrate   how   control
  652. characters  are  used  on a host computer.  In the following
  653. table, "^x" means to hold the the CTRL  key  and  press  the
  654. letter "x".
  655.  
  656.           Transmitted Control Characters
  657.  
  658.      ^A   Suspends output being displayed by  CompuServe  at
  659.           the end of the current line.  Repeated issuance of
  660.           ^A  causes  successive  lines  of  output  to   be
  661.           displayed,  one line at a time.  Running output is
  662.           turned back on with a ^Q.  ^A is not typed out.
  663.  
  664.      ^S   Suspends output immediately.
  665.  
  666.      ^Q   Restores the running  display  of  output  at  the
  667.           point where it had been interrupted by a ^A or ^S.
  668.  
  669.      ^C   Interrupts display or  a  program's  execution  so
  670.           that  you  can  enter  another  menu  selection or
  671.           command.
  672.  
  673.      ^B   Used as a type ahead ^C, forcing an interrupt when
  674.           CompuServe requests input.
  675.                                                      Page 14
  676.  
  677.  
  678.      ^P   Interrupt display or a program's execution so that
  679.           you can enter another command to the program.
  680.  
  681.      ^H   Backspaces, deleting the character that was there.
  682.           Same as BACKSPACE key.
  683.  
  684.      ^U   Deletes the line currently being typed.
  685.  
  686.      ^V   View current line;  redisplays the  line  you  are
  687.           currently typing.
  688.  
  689.      ^O   Tells host to  turn  off  output  currently  being
  690.           displayed.
  691.  
  692.  
  693.  
  694. 8.5  The ASCII Character Set
  695.  
  696.               0   1   2   3   4   5   6   7
  697.           0  NUL DLE SPC  0   @   P   `   p
  698.           1  SOH DC1  !   1   A   Q   a   q
  699.           2  STX DC2  "   2   B   R   b   r
  700.           3  ETX DC3  #   3   C   S   c   s
  701.           4  EOT DC4  $   4   D   T   d   t
  702.           5  ENQ NAK  %   5   E   U   e   u
  703.           6  ACK SYN  &   6   F   V   f   v
  704.           7  BEL ETB  '   7   G   W   g   w
  705.           8  BS  CAN  (   8   H   X   h   x
  706.           9  HT  EM   )   9   I   Y   i   y
  707.           A  LF  SUB  *   :   J   Z   j   z
  708.           B  VT  ESC  +   ;   K   [   k   {
  709.           C  FF  FS   ,   <   L   \   l   |
  710.           D  CR  GS   -   =   M   ]   m   }
  711.           E  SO  RS   .   >   N   ^   n   ~
  712.           F  SI  US   /   ?   O   _   o
  713.  
  714.  
  715.  
  716. 9.0  CSEXEC ERROR MESSAGES
  717.  
  718.  
  719. Typical Errors:
  720.  
  721.  
  722.      % VTXFAE - That file already exists on your disk.
  723.        Do you wish to replace it (Y or N)?
  724.  
  725.           The file you specified for your system to download
  726.           to  is  already  on your diskette.  If you want to
  727.           overwrite it, reply "Y";  if not,  reply  "N"  and
  728.           the file transfer will be aborted.
  729.  
  730.  
  731.                                                      Page 15
  732.  
  733.  
  734.      % VTXPNR - Printer not ready!  
  735.  
  736.           The printer is not ready.   Make  sure  the  power
  737.           switch is on and the printer is online.
  738.  
  739.  
  740.      ? VTXDKF - Diskette is full!
  741.  
  742.           The diskette has run out of storage  space  during
  743.           file   transfer.    CSEXEC  erases  the  partially
  744.           downloaded file from the diskette and  aborts  the
  745.           file transfer.
  746.  
  747.  
  748.      ? VTXNEF - That file is not on your diskette!
  749.  
  750.           The file you specified  for  upload  to  the  host
  751.           doesn't exist on your diskette.  The file transfer
  752.           is aborted.  
  753.  
  754.  
  755.      % VTXFNC - This file may not be  compatible  with  your
  756.           computer.
  757.        Do you still want to receive it?  (Y or N)
  758.  
  759.           This message signifies that you are attempting  to
  760.           download  an  image file which was uploaded from a
  761.           different  microcomputer  than   yours.    A   "Y"
  762.           response  will cause the host to download the file
  763.           anyway,  and  an  "N"  response  will  abort   the
  764.           transfer.
  765.                                                      Page 16
  766.  
  767.  
  768. 10.0  GLOSSARY
  769.  
  770. This glossary defines some of the more frequently used terms
  771. associated with the CompuServe Information Service.
  772.  
  773. database
  774.      is a collection of information which is stored  on  the
  775.      computer.
  776.  
  777. defaults 
  778.      are settings telling your  terminal  specific  ways  to
  779.      respond.   For  example, how many lines on a screen you
  780.      want to have displayed while scrolling, the first  page
  781.      to  see  after logon, the number of characters to delay
  782.      after issuing a command, etc.   These  default  setting
  783.      can  be  made  permanent  or  can  be in effect for the
  784.      current session only.
  785.  
  786. disk 
  787.      storage refers to the storing or saving of data in  the
  788.      Programming Area on a device called disk.  The data can
  789.      then be retrieved for use.   Each  Standard  and  Prime
  790.      Service  customer  is  allocated  128,000 characters of
  791.      disk space at no extra charge.  Additional storage  can
  792.      be requested through Feedback for an extra charge.
  793.  
  794. DISPLAY 
  795.      is the program which accesses the  Videotex  Area  from
  796.      the Programming Area.
  797.  
  798. download 
  799.      is the process of transferring a file of data from your
  800.      on-line  disk  storage  to  your  own personal computer
  801.      system.
  802.  
  803. EMAIL 
  804.      is the CompuServe Information Service  Electronic  Mail
  805.      program.
  806.  
  807. ENTER 
  808.      is the specific key on the keyboard  which  enters  the
  809.      current  line  into the computer;  acts like a carriage
  810.      return on a typewriter.
  811.  
  812. Executive 
  813.      See CSEXEC.
  814.                                                      Page 17
  815.  
  816.  
  817. FEEDBK 
  818.      is the  program  which  enables  you  to  provide  your
  819.      comments, ask questions or get help with a problem from
  820.      Customer Service.  You may also order documentation and
  821.      CompuServe  Information  Service  products while in the
  822.      Feedback program.
  823. file 
  824.      is a collection of data, uniquely identified by a  name
  825.      up  to 6 characters long and optionally an extension of
  826.      up to 3 characters (for example, TEST.DAT).
  827.  
  828. Filge 
  829.      is CompuServe's File Generator and Editor which is used
  830.      for creating and modifying files, for use in EMAIL, the
  831.      Bulletin Board, and the Programming area files.
  832.  
  833. hardcopy 
  834.      is a printout or a paper copy of computer data.
  835.  
  836. host 
  837.      is the CompuServe computer to which you are connected.
  838.  
  839. initial page
  840.      is the first page of  information  which  is  displayed
  841.      after logon.
  842.  
  843. job 
  844.      is a user's individual session while  logged  onto  the
  845.      CompuServe computer.
  846.  
  847. logoff 
  848.      is the sequence of events which  disconnects  you  from
  849.      the CompuServe computer.
  850.  
  851. logon 
  852.      is the sequence of events which connects you  with  the
  853.      CompuServe computer.
  854.  
  855. menu 
  856.      refers to the item choices from which you may select  a
  857.      page to be displayed in the Videotex Area.
  858.                                                      Page 18
  859.  
  860.  
  861. network 
  862.      is the communications link equipment that  enables  you
  863.      to connect to CompuServe's computers in Columbus, Ohio.
  864.      CompuServe operates  its  own  network  in  most  major
  865.      cities in the 48 contiguous United States.  Access from
  866.      other cities in  the  U.S.   and  Canada  is  available
  867.      through  a  supplemental  network  (such  as  TYMNET or
  868.      DataPac) at an additional communications surcharge.
  869. node 
  870.      is a specialized communications computer  which  allows
  871.      many  terminals to communicate through the same line to
  872.      CompuServe's large computer complex in Columbus, Ohio.
  873.  
  874. OK 
  875.      is the prompt which is used in the Programming Area  to
  876.      indicate readiness to accept a command.
  877.  
  878. page 
  879.      is any one of the 16-line displays which appear on your
  880.      terminal.
  881.  
  882. password 
  883.      is a unique set of characters that secures  entry  into
  884.      the  service  for  a  unique User ID.  Your password is
  885.      your key to safeguarding your data and  usage  charges.
  886.      You are responsible for all usage of your User ID.  The
  887.      CompuServe Information Service strongly recommends that
  888.      you  keep your password in a secure place separate from
  889.      your User ID and never give it to anyone,  verbally  or
  890.      through the service.  The most secure password consists
  891.      of two non-related words connected with a symbol.
  892.  
  893. program 
  894.      is a set of machine  instructions  which  the  computer
  895.      uses  to  perform  a  defined  function.  References to
  896.      particular programs used on the CompuServe  Information
  897.      Service  are  made  by  program  name,  such  as EMAIL,
  898.      FEEDBK, DISPLAY.  When  a  program  is  requested,  the
  899.      computer loads and executes (runs) the specified set of
  900.      instructions (program).
  901.  
  902. prompt 
  903.      is the message which is displayed to alert you that the
  904.      computer  is waiting for input.  For example, Key M for
  905.      menu!  in the Videotex Area, or OK in  the  Programming
  906.      Area.
  907.  
  908. Screen 
  909.      refers to one page of information.
  910.  
  911. SIGS 
  912.      is the program  which  accesses  the  Special  Interest
  913.      Groups  area.   The  SIGS offering contains many groups
  914.      with mutual special interests which have been  given  a
  915.      unique  area  to allow members to communicate with each
  916.                                                      Page 19
  917.  
  918.  
  919.      other.
  920.  
  921. SOFTEX 
  922.      is the name for the  Software  Exchange  program  which
  923.      allows  a  user who is equipped with the proper version
  924.      of the Executive to purchase programs on-line that  can
  925.      be  run  on  his/her personal computer.  These programs
  926.      can be downloaded to the personal computer system  upon
  927.      purchase.
  928.  
  929. terminal 
  930.      is a keyboard and printing or display mechanism used to
  931.      enter data into a computer and to display output from a
  932.      computer.  A microcomputer which  is  running  terminal
  933.      emulation software is considered to be a terminal.
  934.  
  935. upload 
  936.      is  the  process  of  transferring  a  file  from  your
  937.      personal   computer  system  to  your  CompuServe  disk
  938.      storage area.
  939.  
  940. User ID
  941.      is a unique number assigned to your account that,  when
  942.      used  with  the  correct  password,  allows  access  to
  943.      CompuServe   Information   Service.     For    example,
  944.      77777,777.
  945.  
  946. Videotex 
  947.      is an easy to use interactive menu formatted system for
  948.      accessing remote databases or programs.  On CompuServe,
  949.      the Videotex format is in pages of text.
  950.  
  951. CSEXEC(TM) 
  952.      is a terminal emulator program  which  is  specifically
  953.      designed   for  use  with  the  CompuServe  Information
  954.      Service and which is in the CompuServe Videotex format.
  955.      CSEXEC(TM)  software  is  sold through computer dealers
  956.      and through the CompuServe Information Service  on-line
  957.      product ordering area found in Feedback.
  958.  
  959.  
  960.  
  961.                      Table of Contents
  962.  
  963. Introduction  . . . . . . . . . . . . . . . . . . . . . . . 1
  964.    Hardware Required  . . . . . . . . . . . . . . . . . . . 1
  965. Customizing the Executive to Your System  . . . . . . . . . 1
  966.    The Input/Output Overlay . . . . . . . . . . . . . . . . 1
  967.    Creating CSEXEC for Your System  . . . . . . . . . . . . 2
  968.    Future Versions of the Executive . . . . . . . . . . . . 3
  969. Using A Printer With CSEXEC . . . . . . . . . . . . . . . . 3
  970.    Copying Data to the Printer  . . . . . . . . . . . . . . 3
  971. Running CSEXEC  . . . . . . . . . . . . . . . . . . . . . . 3
  972. Exiting CSEXEC  . . . . . . . . . . . . . . . . . . . . . . 3
  973. Auto Logon  . . . . . . . . . . . . . . . . . . . . . . . . 4
  974.    Auto Logon Control . . . . . . . . . . . . . . . . . . . 4
  975.    Creating Auto Logon File . . . . . . . . . . . . . . . . 4
  976.    Executing An Auto Logon  . . . . . . . . . . . . . . . . 5
  977.    Additional Auto Logon Features . . . . . . . . . . . . . 5
  978.    Auto Logon File Chaining . . . . . . . . . . . . . . . . 6
  979.    Auto Logon Examples  . . . . . . . . . . . . . . . . . . 6
  980. File Transfer Using CSEXEC . . . . . . . . . . . . . . . . 10
  981. Technical Information  . . . . . . . . . . . . . . . . . . 12
  982.    Flow Control  . . . . . . . . . . . . . . . . . . . . . 12
  983.    ESCAPE Sequences  . . . . . . . . . . . . . . . . . . . 12
  984.       Keyboard Lock and Unlock . . . . . . . . . . . . . . 12
  985.       Video Enable and Disable . . . . . . . . . . . . . . 13
  986.    The Protocol  . . . . . . . . . . . . . . . . . . . . . 13
  987.    CompuServe Control Characters . . . . . . . . . . . . . 13
  988.    The ASCII Character Set . . . . . . . . . . . . . . . . 14
  989. CSEXEC Error Messages  . . . . . . . . . . . . . . . . . . 14
  990. Glossary . . . . . . . . . . . . . . . . . . . . . . . . . 16
  991. CSEXEC Er