home *** CD-ROM | disk | FTP | other *** search
/ ftp.robelle3000.ai 2014 / 2014.06.ftp.robelle3000.ai.tar / ftp.robelle3000.ai / newsletter / 1997 / w1997-03.txt < prev    next >
Text File  |  1997-05-26  |  21KB  |  521 lines

  1. What's Up, DOCumentation?
  2.  
  3.  
  4.  
  5.        Robelle Consulting Ltd.
  6.        Unit 201, 15399-102A Ave.
  7.        Surrey, B.C.  Canada  V3R 7K1
  8.        Toll-free:    1-888-ROBELLE
  9.                     (1-888-762-3553)
  10.        Phone:       (604) 582-1700
  11.        Fax:         (604) 582-1799
  12.        E-mail: support@robelle.com
  13.        Web: www.robelle.com
  14.  
  15. Date:  May 1997
  16.  
  17. From:  Robert M. Green, CEO
  18.        David J. Greer, President
  19.        Mike Shumko, Editor pro tem
  20.  
  21. To:    Users of Robelle Software
  22.  
  23. Re:    News of the HP 3000 and of HP-UX, 1997 #3
  24.  
  25.    What You Will Find in This News Memo:
  26.  
  27.    Qedit for Windows
  28.    IMAGE to Intranet
  29.    Suprtool Training
  30.    Technical Tips
  31.    FAQs
  32.    Special Deal on Manuals 
  33.    Choosing the Right Blocksize
  34.    Saving Files Across Accounts
  35.  
  36.  
  37. Suprtool 4.0 Hits the Streets
  38. =============================
  39.  
  40. Once again the developers at Robelle have put forward a new release of 
  41. Suprtool, the ever popular data access utility for the HP 3000 and HP 9000. 
  42. Version 4.0 offers some very important new features, which are available with 
  43. both the MPE/iX and HP-UX versions of Suprtool.
  44.  
  45. Suprtool is Year 2000 Compliant
  46.  
  47. Suprtool is already good at working with many date formats, including all the 
  48. popular 4-digit year formats. With version 4.0, Suprtool identifies incorrect 
  49. dates, such as flag values used in date fields, with the new $invalid 
  50. function of the If command. Once you have identified the incorrect dates, 
  51. update them easily with an Extract statement. Do you want more data-packaging 
  52. options? The Item command now supports four new date formats for greater 
  53. flexibility.
  54.  
  55. Easily Create Web Pages for the Internet or Intranet
  56.  
  57. Suprtool's new HTML command makes it easy to get your data onto the Web. 
  58. Suprtool retrieves the data and formats it into a file with the required HTML 
  59. commands. Choose either HTML Table or HTML Preformatted data options.
  60.  
  61. Access Allbase SQL Databases
  62.  
  63. With Suprtool 3.9 you could read Allbase tables and views. In version 4.0 
  64. this capability has been enhanced to support Native Char and Native VarChar 
  65. data-types. Also, the new Form command shows owner names for Allbase tables. 
  66. Call us for prices on the optional Allbase database access modules available 
  67. on MPE/iX and HP-UX, and the Oracle database access module available for 
  68. HP-UX systems.
  69.  
  70. When Will I Receive My Copy of Suprtool 4.0?
  71.  
  72. Suprtool 4.0 is currently being shipped to all users who have an active 
  73. support contract in Canada and the United States. Overseas sites on support 
  74. will soon receive their updated versions of Suprtool from their local Robelle 
  75. representative.
  76.  
  77. If you are not using Suprtool, join the thousands of users who benefit from 
  78. its reliability, speed, and flexibility. For more information or a free trial 
  79. of Suprtool, visit our Web site or call us toll-free.
  80. [Rosemary Van Poelgeest, Marketing and Sales]
  81.  
  82.  
  83. Qedit for Windows Upgrade -- Save Big, Win Big!
  84. ===============================================
  85.  
  86. By now you have heard that Robelle is preparing Qedit for Windows, the editor 
  87. that lets you edit local, MPE/iX, and HP-UX files from a single MS Windows 
  88. program.
  89.  
  90. What you may not have heard is that Robelle is having a prize draw in which 
  91. you can win one copy of the server software and two copies of the client 
  92. software. To enter the draw, visit the Robelle Web site and fill out the 
  93. Request for Quotation form, or fax us using the form below. We'll send you a 
  94. quotation for Qedit for Windows at the low introductory price, and enter you 
  95. in our draw. Good luck!
  96.  
  97. Request for Quotation Form:
  98.  
  99. Complete this form and you will automatically be entered to win one
  100. copy of Qedit for Windows (includes two clients and one server).
  101.  
  102. How many clients and how many servers will be running Qedit?
  103.    ___    HP 3000
  104.    ___    HP 9000
  105.    ___    Total number of users of Windows clients
  106.    ___    Approximate number of concurrent users
  107.  
  108. How do you plan to distribute the client software? Please check each
  109. box that applies.
  110.    ___    Via a PC file server
  111.    ___    Install on each PC
  112.    ___    Other, please specify
  113.  
  114. Do you already use Qedit?
  115.    ___    My company is already licensed to use Qedit for HP 3000.
  116.    ___    My company is already licensed to use Qedit for HP 9000.
  117.  
  118. Check each box that applies.
  119.    ___    Please send me more information.
  120.    ___    Let me know when I can order a free 30-day trial.
  121.    ___    I would like to be a pre-release site.
  122.  
  123. Address and contact information:
  124.    Company:______________________________
  125.    Attn:   ______________________________
  126.    Phone:  ______________________________
  127.    Fax:    ______________________________
  128.    E-mail: ______________________________
  129.  
  130.  
  131. Get SmartDate on the Web 
  132. ========================
  133.  
  134. We have started shipping SmartDate, the library of date and time routines for 
  135. programmers. You can get information about SmartDate or even download a trial 
  136. version from our Web site: http://www.robelle.com/products/smartdate/.
  137.  
  138.  
  139. Suprtool Training Schedule
  140. ==========================
  141.  
  142. Here is Robelle's in-house course schedule for Suprtool classes in 1997:
  143.  
  144.    August 7 - 8 
  145.    December 4 - 5
  146.  
  147. For more information about the schedule or to arrange a private session at 
  148. your site, call Rosemary Van Poelgeest or Fran Glasgow at 1-888-ROBELLE.
  149.  
  150.  
  151. Integrating IMAGE into Intranet
  152. ===============================
  153.  
  154. Every weekday at Robelle, the sales team prints a list of currently 
  155. outstanding sales calls. When the sales printer is turned on in the morning, 
  156. it happily spits out the daily reports, unless it's grumpy. Occasionally the 
  157. reports get lost and need to be regenerated.
  158.  
  159. The solution that I have developed for generating reports involves placing 
  160. the reports on Robelle's intranet, using a batch job that runs on the 
  161. HP 3000. The list of calls can be viewed using any Web browser, such as 
  162. Netscape Navigator or Microsoft Internet Explorer.
  163.  
  164. The CallList job runs at 4:30 in the morning. It runs Suprtool to generate 
  165. the report data, then converts this data to HyperText Markup Language (HTML). 
  166. This step is done by the STExport module, which comes with every version of 
  167. Suprtool. 
  168.  
  169. run suprtool.pub.robelle
  170. base etc... { Create data file in link format}
  171. output tdaylist link
  172. exit
  173.  
  174. run stexport.pub.robelle
  175. input tdaylist
  176. output tdayhtml
  177. html table title "Today's Call List" head "Today's Call List"
  178. heading fieldnames
  179. exit
  180.  
  181. IMAGE Names in Headings
  182.  
  183. The output file from STExport has all of the HTML commands for a self-
  184. contained document, as well as the table of data. The column headings are 
  185. taken from the IMAGE fieldnames.
  186.  
  187. <html>
  188. <head>
  189. <title>Today's Call List</title>
  190. </head>
  191. <body>
  192. <h1>Today's Call List</h1>
  193. <table border=1>
  194. <tr><th>ACCOUNT<th>PRODUCT<th>TYPE<th>PHONE-NO<th>NAME</tr>
  195. <tr><td>T4003<td>STLIC<td>TR<td>(410) 555-6373<td>Guy Schmidt</tr>
  196. <tr><td>T1661<td>LQLIC<td>TR<td>(408) 555-6525<td>Don Juan</tr>
  197. </table>
  198. </body>
  199. </html>
  200.  
  201. Customizing the HTML Output
  202.  
  203. I wanted some hypertext links in the document to aid in navigation, so I 
  204. replaced the Heading Fieldnames command with Heading "string" and Heading Add 
  205. "string" commands to include some custom HTML code. With this method, I have 
  206. to manually insert the appropriate HTML code. I wanted the table headings to 
  207. be left-justified, normal text (instead of the <th> default that makes the 
  208. headings bold and centered), so I added some <td> tags with text. This makes 
  209. the HTML browser format "my" headings as the first row in the data table. 
  210. Notice that I also added a string with "todaysdate" (see below). Adding all 
  211. of these strings creates a really long heading string. Of the 2,000 character 
  212. maximum in STExport, I used only about 300.
  213.  
  214. run stexport.pub.robelle
  215. input tdaylist
  216. output tdayhtml
  217. html table title "Today's Call List" head "Today's Call List"
  218. heading "<a href=http://internal/><img src=/icon/sm_home.gif></a>"
  219. heading add "<a href=index.html><img border=0 alt='Sales Main Menu' 
  220. src='/icon/back.gif'></a>"
  221. heading add "Go to: <a href=outslist.html>Outstanding Calls</a>"
  222. heading add "<hr>"
  223. heading add "todaysdate"
  224. heading add "<tr><td>Trial No<td>Product<td>Type<td>Phone"
  225. heading add "<td>Contact</tr>"
  226. exit
  227.  
  228. The result of this step looks like this:
  229.  
  230. <html>
  231. <head>
  232. <title>Today's Call List</title>
  233. </head>
  234. <body>
  235. <h1>Today's Call List</h1>
  236. <table border=1>
  237. <a href=http://internal/><img src=/icon/sm_home.gif></a><a 
  238. href=index.html><img border=0 alt='Sales Main Menu' 
  239. src='/icon/back.gif'></a>Go To: <a href=outslist.html>Outstanding 
  240. Calls</a><hr>todaysdate<tr><td>Trial 
  241. No<td>Product<td>Type<td>Phone<td>Contact</tr>
  242. <tr><td>T4003<td>STLIC<td>TR<td>(410) 555-6373<td>Guy Schmidt</tr>
  243. <tr><td>T1661<td>LQLIC<td>TR<td>(408) 555-6525<td>Don Juan</tr>
  244. </table>
  245. </body>
  246. </html>
  247.  
  248. Today's Date
  249.  
  250. I wanted the report to show the exact time it was created, in case it was 
  251. regenerated in the middle of the day. Qedit is my tool of choice to change 
  252. the "todaysdate" string in the HTML document file, but I could just as easily 
  253. have used Editor or perhaps some CI commands.
  254. !run qedit.pub.robelle
  255. text tdayhtml
  256. :/change "todaysdate"Table generated: !hpintrodate !hptimef" all
  257. keep,yes
  258. exit
  259.  
  260. Onto the Server
  261.  
  262. To put the HTML document file on our server, it must be moved from the 
  263. HP 3000 machine on which it was produced to a Windows NT machine that runs 
  264. our intranet server. I used FTP on the HP 3000 to move the file to the 
  265. directory of Sales pages on the intranet: 
  266.  
  267. !ftp intranet.server.name
  268. user webster
  269. <<secret password>>
  270. cd /www/sales
  271. put tdayhtml tdaylist.html
  272. exit
  273.  
  274. The Paperless Office
  275.  
  276. I thought that perhaps this process would help attain my personal goal of 
  277. converting Robelle into a paperless office, but alas, no. The sales team 
  278. actually uses the printed reports to write on. Sigh. Luckily, most browsers 
  279. have a print feature that lets people print what they see on the screen. 
  280. Those lost reports are now easily reproduced on a whim! Just point your 
  281. browser to the correct intranet page, click on that little icon that vaguely 
  282. resembles a printer, and your report just might make it to that happy little 
  283. LaserJet in the corner-if it's not feeling too grumpy.
  284. [Ken Robertson, MIS]
  285.  
  286.  
  287. Gone Fishing
  288. ============
  289.  
  290. As a Canadian company, Robelle has the following statutory holidays for the 
  291. next few months: July 1, August 4, and September 1. The general office will 
  292. be closed, but we will still be taking care of emergency support calls. Call 
  293. the regular 1-888-ROBELLE number, then dial 0 (zero) to get the answering 
  294. service operator, and ask to have the on-call support person paged.
  295.  
  296.  
  297.                             Technical Tips
  298.                             --------------
  299.  
  300. Windows 95 Tips
  301. ===============
  302.  
  303. Windows 95 comes with a helpful file called tips.txt in the Windows 
  304. directory. This file has a number of interesting tips and tricks for using 
  305. Windows 95. These are a couple of examples: 
  306.  
  307. - At the MS-DOS prompt you can use ".." to indicate the parent directory 
  308. (nothing new there), "..." to indicate the parent directory above that one, 
  309. and "...." to indicate the parent directory twice removed (e.g., cd....).
  310. - You can add any shortcut to the Send To menu, including printers and Windows 
  311. applications (e.g., Qedit for Windows). When you right click any document or 
  312. folder icon and select Send To, you will see a list of destinations.
  313.  
  314. Monkey See, Monkey Do
  315. =====================
  316.  
  317. Here is a productivity tip for the breakfast table: a banana will peel much 
  318. easier from the bottom end (the end away from the stem). User instructions: 
  319. pinch the hollow at the bottom end to break the skin, then peel and eat. 
  320.  
  321.  
  322. Just the FAQs, Ma'am
  323. ====================
  324.  
  325. Here are the answers to the most Frequently Asked Questions in the past few 
  326. months.
  327.  
  328. Q:  What is the charge for upgrading Robelle software from one CPU to another?
  329. A:  If you are upgrading a CPU from one model to another within the same 
  330. series (e.g., from one model to another within the HP 3000 series), there 
  331. is no charge. We do not charge based on how big or fast your computers 
  332. are, only on how many computers the software is installed on. You'll need 
  333. to let us know the HPSUSAN or CPU ID of the new computer, so we can 
  334. provide the authorization codes that let the software run on the new 
  335. computer. There is no charge for the codes. By the way, we don't get tired 
  336. of hearing our customers say they like our "no tiers, no tears" upgrade 
  337. policy.
  338.  
  339. Q:  When will Qedit for Windows be available, and how much will it cost?
  340. A:  The product release of Qedit for Windows is currently scheduled for the 
  341. end of July or beginning of August. We will keep you updated through 
  342. What's Up DOCumentation? and the Internet. If you have requested a trial, 
  343. you will be contacted as soon as trials are available.
  344. To find out how much it will cost to upgrade to Qedit for Windows, 
  345. complete the Request for Quotation form on page 2 of this newsletter or on 
  346. the Internet. You will receive a customized quote that reflects your 
  347. configuration and the special prices in our generous introductory offer.
  348.  
  349. Q:  What version of Qedit and Suprtool do I need for MPE/iX 5.5?
  350. A:  We recommend Qedit version 4.4 or later, and Suprtool version 3.8 or 
  351. later. Remember that when you upgrade your operating system you may need 
  352. to stream some Robelle jobs to integrate Qedit or Suprtool into the new 
  353. system. For example, stream Qcompxl.Qeditjob.Robelle to let your native 
  354. mode compilers read Qedit-format source files, or re-install the Speed 
  355. Demon or Suprtool2 routines if you need them in SL.Pub.Sys. See the 
  356. installation section of your user manuals for details.
  357.  
  358. Q:  Can I get more manuals?
  359. A:  Robelle software comes with one manual. You can, however, buy more 
  360. manuals from us (see Inventory Reduction Sale below). But do you really 
  361. need printed manuals? We provide the entire contents of the user manual 
  362. in a number of other forms:
  363. First of all, the product's Help command allows you to read all the 
  364. documentation on-line. You can get on-line help for a specific command  
  365. from either the manual (e.g., help add) or from the Quick Reference Guide 
  366. (e.g., helpQ add). 
  367. The complete user manual is also available as a Windows help file, 
  368. allowing a full-text search using the familiar WinHelp interface. The 
  369. WinHelp diskette is included with each product update. If you don't have 
  370. access to  the diskette, you can download the self-extracting file from 
  371. your Robelle account or directory. 
  372. Finally, you can print your own copies of the manual using the Printdoc 
  373. program (e.g., run printdoc.pub.robelle). Printdoc is available only on 
  374. the HP 3000.
  375.  
  376.  
  377. Inventory Reduction Sale on Suprtool 3.8 Manuals
  378. ==================================================
  379.  
  380. Now that Suprtool 4.0 is being shipped, we are selling our Suprtool 3.8 
  381. manuals at a very attractive price. The version 3.8 manuals cover almost 
  382. everything in the version 4.0 manuals, except for the new Allbase database 
  383. functions, the HTML functions for STExport, and the new $invalid date 
  384. function of the If command. If you need a large number of manuals, this may 
  385. be a cost-effective way of getting them. The new Suprtool 4.0 manuals are $20 
  386. each. You can have the version 3.8 manuals for the cost of shipping and 
  387. handling.  Call us for details.
  388.  
  389.  
  390. Suprtool Now Comes with Laundry Money!
  391. ========================================
  392.  
  393. A Suprtool user called from California asking why he received $10 worth of 
  394. quarters with his Suprtool 4.0 update package, which was distributed by 
  395. Southern Adventist University in Tennessee. The attached packing slip showed 
  396. it was sent from a company in Tennessee to a company in California, but these 
  397. two companies were neither the source nor the destination of the package. The 
  398. mystery has not been solved yet.
  399.  
  400.  
  401.         Robelle Products: Problems, Solutions and Suggestions
  402.         -----------------------------------------------------
  403.  
  404. Blocksize and Suprtool Performance
  405. ===================================
  406. A Suprtool user called with a deceptively simple question: "What blocksize 
  407. should I use in my files to maximize Suprtool performance?"
  408.  
  409. The general rule of thumb for most programs is to use larger blocksizes, in 
  410. order to reduce the number of disc accesses for programs that need to process 
  411. the file serially. But because of the way Suprtool works, bypassing much of 
  412. MPE's normal deblocking mechanisms, you don't need to make your blocks large. 
  413. In fact if you make a blocksize too big, Suprtool will give you this error 
  414. message:  Error: The input blocksize is greater than 14336 words.
  415.  
  416. Making your blocksizes as close to 14,336 words as possible will not give the 
  417. best Suprtool performance. The MPE/iX version of Suprtool can read or write 
  418. up to 24,576 words with every disc access, by reading or writing multiple 
  419. blocks at a time. This multiple-block ability (technically, MPE's MR 
  420. capability) is a major contributor to Suprtool's super speed. If your block 
  421. is 14,336 words, Suprtool can fit only one 14,336-word block into its 24,576-
  422. word buffer. The best blocksize would be one that fills Suprtool's 24,576-
  423. word buffer to its capacity by allowing Suprtool to read or write multiple 
  424. blocks at a time. So even though the maximum is 14,336, a blocksize of 12,288 
  425. words would be better than 14,336 because Suprtool could put two blocks in 
  426. its buffer with one disc access. A blocksize of 8,192 words would be just as 
  427. good for Suprtool because Suprtool could read or write three blocks per disc 
  428. access.
  429.  
  430. To come back to the original question, "What blocksize should I use in my 
  431. files to maximize Suprtool performance?", the answer is any blocksize that 
  432. permits Suprtool to most completely fill its 24,576-word buffer with a number 
  433. of your blocks.
  434.  
  435. Here is an example of a real situation:
  436.  
  437. ACCOUNT=  PROD        GROUP=  DATA    
  438. FILENAME  CODE  ------------LOGICAL RECORD-----------
  439.                   SIZE  TYP        EOF      LIMIT R/B
  440. FOO               159W  FB        3780       5500  20
  441.  
  442. File FOO has a record size of 159 words, blocked by 20, giving a blocksize of 
  443. 3,180 words. Suprtool can fit seven of these 3,180-word blocks in its 24,576-
  444. word buffer. Therefore, Suprtool can read or write 140 data records at a 
  445. time. But seven times 3,180 is only 22,260 words. Theoretically there should 
  446. still be space for fourteen more records in the buffer (that's (24,576 - 
  447. 22,260) / 159), if only we could find a blocksize that would fill the buffer 
  448. more completely. The theoretical maximum is 154 records (that's 24,576 / 
  449. 159). If Suprtool could access, say, two blocks of 77 records, it would get 
  450. the maximum performance. 
  451.  
  452. Would other blocking factors work just as well? Another blocking factor that 
  453. would fit nicely into 154 is 22. Suprtool's performance at accessing seven 
  454. blocks of 22 records would be identical to accessing two blocks of 77 
  455. records. Either way it is only one disc access for Suprtool. A blocking 
  456. factor of 51 would also allow Suprtool to fit three 8,109-word blocks into 
  457. its buffer, with almost no wasted space.
  458.  
  459. Note that on MPE V, or when using the compatibility mode version of Suprtool 
  460. on MPE/iX, the maximum buffer size is 14,336 words.
  461.  
  462.  
  463. Dereferencing MPE Variables in Qedit
  464. ====================================
  465.  
  466. You can use MPE/iX variables in Qedit commands by prefixing the Qedit command 
  467. with a colon and a slash (:/). The colon tells Qedit to send the command to 
  468. MPE, which knows how to dereference variables, then the slash tells Qedit 
  469. that it is really a Qedit command, not a MPE command.
  470.  
  471. For example, to change the string {insert date here} to the value of the 
  472. "mydate" variable in all lines,
  473.  
  474. run qedit.pub.robelle
  475. text myfile
  476. :/change "{insert date here}" "!mydate" all
  477.  
  478.  
  479. Warning About Saving Files Across Accounts
  480. ==========================================
  481.  
  482. There is a bug in MPE/iX 5.5 that may cause you some difficulty if you try to 
  483. keep files across account boundaries. Qedit (or EDIT/3000 for that matter) 
  484. may purge an existing file in another account, but not be able to keep the 
  485. new file. The end result is that you can end up losing your work. If you get 
  486. this error message with Qedit,
  487.  
  488.    Existing file apparently purged, but still cannot save new file.
  489.    Fclose Err: Security
  490.  
  491. save your file in the local account, then manually move it across to the 
  492. other account. HP is investigating this as SR 5003-356063. They have 
  493. classified it as a serious problem.
  494.  
  495.  
  496. Install Robelle Software Like a Pro
  497. ===================================
  498.  
  499. Here are a few tips and reminders about installing or upgrading Robelle 
  500. software products.
  501.  
  502. The software comes with a printed list of the HPSUSANs or CPU IDs that the 
  503. software is authorized to run on. Check the list before starting the 
  504. installation. The software will not install on an unauthorized CPU.
  505.  
  506. On HP 3000s, the prior version of the software is saved in the PubOld.Robelle 
  507. group, in case you need to go back to the previous version. Once you are sure 
  508. you don't need to go back, you can clean up the PubOld group by streaming the 
  509. Pubold.Purgejob.Robelle job. The Purgejob group has a number of cleanup jobs 
  510. you may find useful.
  511.  
  512. On HP 3000s, you can restore files from the Robelle tape during the day, but 
  513. delay the actual software installation until the evening when everybody is 
  514. off the system. For example,
  515.  
  516. :stream install.suprjob;at=23:00
  517.  
  518.  
  519.  
  520.  
  521.