home *** CD-ROM | disk | FTP | other *** search
/ ftp.robelle3000.ai 2014 / 2014.06.ftp.robelle3000.ai.tar / ftp.robelle3000.ai / newsletter / 1998 / w1998-03.txt < prev    next >
Text File  |  1998-07-05  |  26KB  |  668 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:  June 1998
  16.  
  17. From:  Robert M. Green, CEO
  18.        David J. Greer, President
  19.        Ken Robertson, Editor pro tem
  20.  
  21. To:    Users of Robelle Software
  22.  
  23. Re:    News of the HP 3000 and of HP-UX, 1998 #3
  24.  
  25.    What You Will Find in This News Memo:
  26.  
  27.    Robelle Freebies at HP World '98 
  28.    Training Opportunities
  29.    SmartDate to the Rescue
  30.    What's New in Qedit for Windows
  31.    Just Ask Robelle-L
  32.    Visiting Our European Customers
  33.    From The Truth Is Stranger Than Fiction Department
  34.    Exciting New Enhancement in Suprtool
  35.    Suprtool Tips and Tricks
  36.      Converting Positive-Signed Packed and Display Fields to Neutral-Signed
  37.      Suprtool and PowerHouse Data-Types
  38.    Bug Alert: Suprtool/iX v. 4.1.01
  39.    We're Listening
  40.  
  41.  
  42. Robelle Freebies at HP World '98
  43. ================================
  44.  
  45. As HP World '98 quickly approaches, we look forward once again to seeing you 
  46. at the conference. This year Robelle will be conducting short training 
  47. sessions on Suprtool, Qedit, and Qedit for Windows everyday at our booth 
  48. (#843). Each session will be about 10-15 minutes followed by lots of 
  49. opportunity to ask questions and get a one-on-one personalized demo. We will 
  50. give away a free T-shirt to anyone who attends our in-booth training. Please 
  51. see the enclosed schedule for specific topics. 
  52.  
  53. Win Great Prizes
  54.  
  55. Make sure you get a ticket for our prize draw on Wednesday, August 5th at 
  56. 4:30 p.m. We have three great prizes to give away: the Palm Pilot 
  57. Professional (first prize); "The Snappy" video for high-quality snapshots 
  58. (second prize); and MasterPhotos Studio for customizing photos (third prize). 
  59. During the draw, we will be serving cake and coffee--come and join the 
  60. festivities!
  61.  
  62. Book Signing by Bob Green
  63.  
  64. Following the prize draw, Robelle's founder, Bob Green, will be available to 
  65. autograph your personal copy of Robelle's popular SMUG VII (Seldom Met Users 
  66. Group) book. So bring your SMUG book to the conference and turn it into a 
  67. collector's item! If you don't have one already, a limited supply of our 
  68. remaining stock will be available.
  69.  
  70. Last Chance for Lowest Price on Upgrade
  71.  
  72. HP World '98 marks the end of our introductory upgrade pricing for Qedit for 
  73. Windows. Since we unveiled the beta copy at last year's conference, a lot of 
  74. functionality has been added to Qedit for Windows.  If you already have 
  75. Qedit, this is your last chance to get the Qedit for Windows server upgrade 
  76. with two free clients for US$500. If you would like to take advantage of this 
  77. lowest-ever price, please contact Nicky at 1-888-ROBELLE.
  78.  
  79.  
  80. Training Opportunities
  81. ----------------------
  82. Suprtool
  83. ========
  84.  
  85. Learn to make the most out of your Suprtool product and invest in a course 
  86. from Robelle. The two-day configurable course will be offered at Robelle 
  87. located near lovely Vancouver, British Columbia on
  88.  
  89.     October 15 - 16, 1998
  90.  
  91. You can also have us come out to your shop to give the training locally. For 
  92. more details, please contact Mike Shumko at 1-888-ROBELLE.
  93.  
  94. Free Training at HP World '98
  95. =============================
  96.  
  97. Robelle will present 10-15 minute training sessions on Suprtool, Qedit, and 
  98. Qedit for Windows in Booth #843 at HP World '98. See the enclosed schedule 
  99. for details.
  100.  
  101.  
  102. SmartDate to the Rescue
  103. =======================
  104.  
  105. A few weeks ago, a colleague issued an enhancement request for an HP 3000 
  106. terminal-based in-house system. "Do you realize," she wrote, "that you can 
  107. enter 50 Jan 99 in the call-back date field?"
  108.  
  109. "Yes." I responded, "As you had previously requested, there are no rules on 
  110. entering data into that field. You can enter anything you want there."  As it 
  111. turns out, the person was no longer entering free-form data in that 
  112. particular field and wanted to limit the format of the input. In fact, her 
  113. other date fields also did not have edit rules. This was about to change.
  114.  
  115. The first step to solving this problem was to fire the user. Whoops, just 
  116. kidding! The first step was to validate all of the existing dates in the 
  117. database. All the non-standard and invalid dates were corrected with a few 
  118. passes of Suprtool. 
  119.  
  120. The next step was to implement some date-editing rules. The user didn't want 
  121. to restrict the format to a fixed date, so we agreed to implement these basic 
  122. rules for entering a date:
  123.  
  124. - Day Month Year format
  125.  
  126. - Year Month Day format
  127.  
  128. I used the SmartDate constants from the SmartDate Windows Help file. (You can 
  129. download the Help file installation to your PC from sdate.whelp.robelle on 
  130. your HP 3000.) I decided to use 1950 as the cutoff year. This allows a date 
  131. like 980506 to be treated as 19980506 after the year 2000. I did this by 
  132. setting a JCW before program execution.
  133.  
  134.     SETVAR ROBELLECUTOFFYEAR = 50
  135.  
  136. The input format can contain alphabetic months. (This is really cool.)  This 
  137. allows the user to enter dates such as "6 Jul99", "990706" or "060799." As 
  138. long as the date is not ambiguous, SmartDate will convert it. Below is a 
  139. portion of the program that does the date conversion. If the conversion is 
  140. unsuccessful because the input date has an invalid format, then lnk-error-
  141. message will not be equal to spaces. The whole Datefix subprogram is 
  142. available from our Web site at 
  143. http://www.robelle.com/support/smartdate/datefix.cob.
  144.  
  145.     check-date.
  146.     ***** Is it in day month year format?
  147.       add RdtXnDDMMCCYY to RdtAllowZero giving rdt-from-type
  148.       move RdtX8CCYYMMDD                  to rdt-to-type
  149.       perform rdtconvert.
  150.       if rdt-status <> zeros
  151.     *****  Maybe it is year month day format 
  152.         add RdtXnCCYYMMDD to RdtAllowZero giving rdt-from-type
  153.         move RdtX8CCYYMMDD                  to rdt-to-type
  154.         perform rdtconvert.
  155.  
  156.       if new-date <> spaces
  157.     *****   If we had a successful conversion, then convert to 
  158.     *****   output format of  dd mmm yy
  159.         add RdtX8CCYYMMDD to RdtAllowZero giving rdt-from-type
  160.         move RdtX8DDMMMYY                to rdt-to-type
  161.         move 0                           to rdt-aux-result
  162.         move 0                           to rdt-status
  163.         move 0                           to lnk-return-status
  164.         move spaces                      to lnk-error-message
  165.  
  166.             call "RDTCONVERT" using new-date
  167.                                     lnk-to-date
  168.                                     rdt-control
  169.             if rdt-status of rdt-control <> 0 then
  170.                perform rdterror.
  171.     rdtconvert.
  172.          move 0                          to rdt-aux-result
  173.          move 0                          to rdt-status.
  174.          move 0                          to lnk-return-status.
  175.          move spaces                     to lnk-error-message
  176.          move spaces                     to new-date.
  177.          call "RDTCONVERT" using lnk-from-date
  178.                                  new-date
  179.                                  rdt-control
  180.          if rdt-status of rdt-control <> 0 then
  181.             perform rdterror.
  182.     rdterror.
  183.             move rdt-aux-result to lnk-aux-result
  184.             move rdt-status     to lnk-status
  185.             move spaces         to out-buf
  186.             move zeros          to out-buflen
  187.             call "RDTERROR" using rdt-control
  188.                                   out-buf
  189.                                   out-buflen
  190.             move out-buflen to lnk-error-len
  191.             move out-buf    to lnk-error-buff.
  192.  
  193. [Ken Robertson]
  194.  
  195.  
  196. What's New in Qedit for Windows
  197. ===============================
  198.  
  199. Despite the fact that we're still working hard on generating test suites and 
  200. making the Qedit client as robust as possible, we've managed to add some new 
  201. functionality to Qedit for Windows. Here's a list of what's new for version 
  202. 4.6.10:
  203.  
  204. - Help buttons in all of the dialogs
  205.  
  206. - Open selection can use a connection name
  207.  
  208. - Accepts long passwords on HP-UX trusted systems
  209.  
  210. - Allows you to open files in an "unnumbered" state. This is particularly 
  211.   useful when your file contains numbers in the last eight or first seven 
  212.   columns. Qedit may get confused and think that your data is a source file 
  213.   for some programming language.
  214.  
  215. Qedit for Windows will be shown at HP World in San Diego. The absolute latest 
  216. and greatest enhancements will be on display, and you'll get a chance to chat 
  217. with the developers. Hope to see you there!
  218.  
  219.  
  220. Just Ask Robelle-L
  221. ==================
  222.  
  223. Do you sometimes wish that you could have direct access to the developers of 
  224. Robelle software? Now you can! Robelle hosts a mailing list about Robelle 
  225. products called Robelle-L. Similar in functionality to the popular HP3000-L, 
  226. e-mail messages submitted to the list are read and commented on by Robelle 
  227. techies, developers and other Robelle customers.  
  228.  
  229. Internet mailing lists work the same as hanging out at a university lounge. 
  230. When a question is directed toward someone, you can't help but hear both the 
  231. question and answer. You can even add your own remarks. Internet mailing 
  232. lists do all of this through the magic of e-mail. If you would like to 
  233. subscribe to Robelle-L, just point your Web browser to 
  234. http://www.robelle.com/support/robelle-l.html and follow the directions.
  235.  
  236. Here are some samples messages from the list:
  237.  
  238. Q:  I have a menu system that keeps my users away from the MPE prompt. It is 
  239.     invoked as they log on, and controls what they can access. One of the 
  240.     menu  choices is Suprtool. I see that users can type MPE commands from 
  241.     within Suprtool. How can I prevent this? I don't want this to apply to 
  242.     all Suprtool processes, just those launched from the menu system.
  243.  
  244. A:  Configure your Suprtool menu choice so that it runs Suprtool with an 
  245.     initial command of Set Limits Mpe Off in the Info string. Remember to 
  246.     run Suprtool with Parm=4 so that it will look at the Info string. For 
  247.     example:
  248.  
  249.     :run suprtool.pub.robelle;parm=4;info="set limits mpe off"
  250.  
  251.     If you also want to restrict those users to read-only database access, 
  252.     and you have the 4.1 release of Suprtool, add the command Set Limits 
  253.     Readonly On to the command line:
  254.  
  255.     :run suprtool.pub.robelle;parm=4;  &
  256.         info="set limits mpe off;set limits readonly on"
  257.  
  258. Q:  Using Qedit/iX v. 4.6.02, how do I append 2-3-4 files together? They are 
  259.     source program files that I want to scan through from time to time 
  260.     looking for strings.
  261.  
  262. A:  Well, you can
  263.  
  264.     /text file1               {the biggest file}
  265.     /addq last  = file2
  266.     /addq last  = file3
  267.  
  268.     But you may run out of lines and need to set the work size high  before 
  269.     starting. An easier approach, if all you want to do is search the files, 
  270.     is to set up another file that contains include statements for your three 
  271.     files, then use the List $incl command.  
  272.  
  273.     My three files are called Adager, Alfredo and Ares. I create a file 
  274.     called Myinc to contain the names of the files.
  275.  
  276.     /list myincl
  277.          1    $include alfredo
  278.          2    $include adager
  279.          3    $include ares
  280.  
  281.     Using the List command, you can search the list of files. It will 
  282.     display the file names plus the lines that the string occurs on:
  283.  
  284.     /list $inc myincl "paul"
  285.       ALFREDO.PAUL.TECHSUP
  286.        503.11  /paul
  287.      ADAGER.PAUL.TECHSUP
  288.         19    Database STORE.PAUL.TECHSUP.  Adager command 
  289.         92    Database STORE.PAUL.TECHSUP.  Adager command 
  290.        103    Paul's dataset D-SALES of the STORE database.
  291.      ARES.PAUL.TECHSUP
  292.          3    FROM:     Paul Gobes  / Robelle Consulting 
  293.         18    /paul
  294.         33    | Paul Gobes, Tech Support Mgr.  | Robelle 
  295.         34    | paul@robelle.com               | 
  296.         35    | http://www.robelle.com/~paul   | Fax:  
  297.     9 lines found
  298.  
  299.  
  300. Visiting Our European Customers
  301. ===============================
  302.  
  303. In an effort to increase Robelle's  understanding of customer problems, we 
  304. have been visiting our customer sites. Last May I spent three weeks with 
  305. eleven different European customers. I do not have space to thank each of you 
  306. individually, but I want to thank everyone for making time available to me. 
  307.  
  308. These visits were arranged by our long-time distributors: Robelle UK (London, 
  309. England), Ole Nord AB (Stockholm), SWS Software Systems AG (Bern, 
  310. Switzerland), ARES (Paris, France), and Samco Automation b.v. (Oisterwijk, 
  311. Holland). I also had the opportunity to spend some time with each 
  312. distributor, which allowed me to gain a lot of knowledge from each of them. 
  313. Thank you for hosting me and arranging the customer visits.
  314.  
  315. These are the broad trends that I observed during my visits to our 
  316. distributors and customers:
  317.  
  318. 1. The HP 3000 is still used to run critical applications.
  319.  
  320. 2. The system managers and developers should be regarded as super heroes. 
  321.    They have less time to do more things with less training. Many of these 
  322.    people yearn for simpler management that is usually available on the HP 
  323.    3000, but is often not found in other platforms.
  324.  
  325. 3. People see the future of applications in Windows NT, not UNIX. This is 
  326.    somewhat surprising because UNIX, with a rich set of applications, has 
  327.    been very strong in Europe for many years.
  328.  
  329. 4. Many sites are focusing their development effort on issues related to Year 
  330.    2000 projects. After the year 2000, many of these sites will focus their 
  331.    development efforts on supporting the new Euro currency.
  332.  
  333. 5. At large sites, Common Operating Environments (COE) for desktops are 
  334.    becoming more common. A COE specifies both the hardware and software 
  335.    configuration for each desktop. Every user in the organization has the 
  336.    same COE, resulting in fewer support calls and less desktop management.
  337.  
  338. I was impressed by the knowledge and management of the critical business and 
  339. IT processes that these customers showed to me. I learned many new things as 
  340. well as many new ways in which people creatively manage their systems.
  341.  
  342. [David Greer]
  343.  
  344.  
  345. From The Truth Is Stranger Than Fiction Department
  346. ==================================================
  347.  
  348. UPN will bring Scott Adams' Dilbert, the comic strip hero of the workplace 
  349. with 150 million fans world wide, to primetime television in the animated 
  350. series Dilbert. The 13-episode series will kick off in the 1998-99 season.
  351.  
  352. Dilbert's creator, Scott Adams, and Emmy award-winning producer Larry Charles 
  353. (Mad About You, Seinfeld) are executive producers of the series from Columbia 
  354. TriStar Television.
  355.  
  356. Regarding the project, Mr. Adams commented, "Dilbert is a perfect fit for 
  357. primetime animation. The readers have been begging me to bring it to TV. It's 
  358. exciting to find the talent and resources to make it happen."
  359.  
  360. Set in the same environment as the daily Dilbert comic strip, the animated 
  361. series will chronicle the absurdities of the '90s workplace and the foibles 
  362. of the hapless hero and lowly cubicle-dwelling engineer, Dilbert. The series 
  363. will go on to explore the surreal subculture of the corporate world, with its 
  364. rigid rules, rituals, languages and customs, thereby revealing the absurdity 
  365. of society at large.
  366.  
  367. Dilbert's modest home will be seen in the series along with familiar 
  368. characters from the comic strip, including Dogbert, Ratbert, Catbert, Wally, 
  369. Alice and, of course, the pointy-haired boss.
  370.  
  371. Gee, I wonder what it's like to work at a large corporation like UPN?   ;-)
  372.  
  373.  
  374. Exciting New Enhancement
  375. ========================
  376.  
  377. Suprtool now has a new function available to the If and Extract commands. The 
  378. $stddate function internally converts any date format in nearly any data-type 
  379. container to the ccyymmdd format in a double integer container.
  380.  
  381. This allows comparison between dates of dissimilar formats and data-types. 
  382. For example:
  383.  
  384.     > get order-detail
  385.     > item order-date,date,ccyymmdd
  386.     > item bill-date,date,mmddyyyy
  387.     > if $stddate(bill-date) <= order-date
  388.     > output badords,link
  389.     > xeq
  390.  
  391. This feature is also available for dates that have two-digit years. The 
  392. century component of the date will be applied to the $stddate with the normal 
  393. cutoff rules, which use the Set Date Cutoff value:
  394.  
  395.     > get invoice-detail
  396.     > set date cutoff 20
  397.     > item invoice-date,date,yymmdd
  398.     > item close-date,date,mmddyyyy
  399.     > if $stddate(close-date) <= $stddate(invoice-date)
  400.     > out badinvs,link
  401.     > xeq
  402.  
  403. In this case all invoice dates with a yy value between 20 and 99 will have 19 
  404. as the century. All invoice dates with a yy value of less than 20 will have 
  405. 20 as the date generated by the $stddate function.
  406.  
  407. Please call Robelle or send e-mail to support@robelle.com if you want the 
  408. Suprtool pre-release with this new feature.
  409.  
  410.  
  411. Suprtool Tips and Tricks
  412. ------------------------
  413. Converting Positive-Signed Packed and Display Fields to Neutral-Signed
  414. ======================================================================
  415.  
  416. When using tables for data lookup or linking data together with Suprlink, it 
  417. is important to get an exact match of data for the operation to work 
  418. correctly. It is possible that one field has signed positives and another has 
  419. neutral positive values (i.e. the linkage is logical rather than physically 
  420. maintained by IMAGE). In the real world, the concept of plus one (+1) is the 
  421. same as one (1), but to a computer the values are different.
  422.  
  423. Occasionally Packed (Pn) and Display (Zn) data-type fields in IMAGE/SQL 
  424. datasets hold positive-signed numbers. To get Suprtool to convert these 
  425. fields to neutral-signed data, you can use an arithmetic operation on the 
  426. Extract command. In the following example, we have a Zoned Display field that 
  427. was entered with a positive sign. Notice the List command shows the sign and 
  428. the Output command shows it with an alphabetic "E" overpunch.
  429.  
  430.     Item:
  431.        CUST-ACCOUNT          Z8
  432.     >get d-sales 
  433.     >extract cust-account
  434.     >list
  435.     >output *
  436.     >xeq
  437.     CUST-ACCOUNT    = +5
  438.      0000000E
  439.      IN=5, OUT=1. CPU-Sec=1. Wall-Sec=1.
  440.  
  441. Now let's try the same task with an arithmetic operation on the Extract 
  442. command:
  443.  
  444.     >get d-sales
  445.     >extract cust-account = cust-account * 1
  446.     >list
  447.     >output*
  448.     >xeq
  449.       CUST-ACCOUNT    = 5
  450.       00000005
  451.       IN=5, OUT=1. CPU-Sec=1. Wall-Sec=1.
  452.  
  453. Suprtool and PowerHouse Data-Types
  454. ==================================
  455.  
  456. One of the recurring themes in our Tech Support calls is that of identifying 
  457. data-types when defining fields in Suprtool. This is particularly true of 
  458. PowerHouse sites, because PowerHouse views the data through its Dictionary 
  459. definitions, while Suprtool's vocabulary is based on IMAGE terminology. Both 
  460. products read the same underlying data structures, so the problem is only one 
  461. of semantics. This article shows how to correctly declare data structures 
  462. when they are being passed between Suprtool and PowerHouse processes. 
  463.  
  464. Translation Table of Data-Types
  465.  
  466.     IMAGE Type       PowerHouse Type       Suprtool Type
  467.     U or X           Character             Byte (Character for NLS)
  468.     R                Float (non-IEEE)*     Real or Long
  469.     E                Float (IEEE)*         IEEE
  470.     K                Integer Unsigned      Logical
  471.     I or J           Integer Signed        Integer or Double
  472.     P                Packed                Packed
  473.     Z                Zoned                 Display
  474.  
  475. * IEEE or Non-IEEE depends on whether Float IEEE or Float NONIEEE was 
  476. declared under System Options in your system Dictionary.
  477.  
  478. Tip 1: Use Qshow to Examine PowerHouse Data Structures
  479.  
  480. Many users are familiar with the Show Items command in Quiz:
  481.  
  482.     run Quiz
  483.     > access d-sales
  484.     > show items
  485.                                    INPUT OUTPUT
  486.     D-SALES                   TYPE SCALE SCALE  DEC PICTURE
  487.     * CUST-ACCOUNT            NUM     0     0    0  ^^^^^^^^
  488.       DELIV-DATE              NUM     0     0    0  ^^^^^^^^^^
  489.     * PRODUCT-NO              NUM     0     0    0  ^^^^^^^^
  490.       PRODUCT-PRICE           NUM     0     0    0  ^^^^^^^^^^
  491.       PURCH-DATE              NUM     0     0    0  ^^^^^^^^^^
  492.       SALES-QTY               NUM     0     0    0  ^^^^^
  493.       SALES-TAX               NUM     0     0    0  ^^^^^^^^^^
  494.       SALES-TOTAL             NUM     0     0    0  ^^^^^^^^^^
  495.  
  496. This listing shows you the attributes and sequence of the fields, but doesn't 
  497. describe their storage format. The Qshow program gives a much more useful 
  498. listing: 
  499.  
  500.     run Qshow
  501.     > show subfile salesub
  502.     98/05/13                    SUBFILE DICTIONARY              Page    1
  503.                                SUBFILE RECORD REPORT
  504.     Subfile:            SALESUB
  505.         Type:               Permanent
  506.         Organization:       Direct
  507.         Format:             7
  508.         Record Size:        38 Bytes
  509.  
  510.      Item                           Type            Offset Size  Occurs
  511.     CUST-ACCOUNT                   ZONED UNSIGNED   0      8
  512.      DELIV-DATE                    INTEGER SIGNED   8      4
  513.      PRODUCT-NO                    ZONED UNSIGNED   12     8
  514.      PRODUCT-PRICE                 INTEGER SIGNED   20     4
  515.      PURCH-DATE                    INTEGER SIGNED   24     4
  516.      SALES-QTY                     INTEGER SIGNED   28     2
  517.      SALES-TAX                     INTEGER SIGNED   30     4
  518.      SALES-TOTAL                   INTEGER SIGNED   34     4
  519.  
  520. Notice that this example shows the offset of the fields within the record 
  521. (the first field starts at offset 0), the length (size) of the fields, as 
  522. well as the storage data-type. In most cases, these map directly onto the 
  523. IMAGE/Suprtool data-types. (See the Translation Table above for mappings.) 
  524. For example, the above subfile can be defined in Suprtool as follows: 
  525.  
  526.     > define cust-account,1,8,display
  527.     > define deliv-date,9,4,integer
  528.     > define product-no,13,8,display
  529.     > define product-price,21,4,integer
  530.     > define purch-date,25,4,integer
  531.     > define sales-qty,29,2,integer
  532.     > define sales-tax,31,4,integer
  533.     > define sales-total,35,4,integer
  534.  
  535. Note that PowerHouse's Zoned Unsigned data-type is equivalent to Suprtool's 
  536. Display data-type, and that Suprtool's Define offset starts at one (1), which 
  537. is one higher than the offset in the Qshow listing. 
  538.  
  539. Tip 2: Where Is the Data Coming From?
  540.  
  541. When a PowerHouse subfile contains complete records from an IMAGE dataset, 
  542. you can have Suprtool read the record structure directly from the IMAGE root 
  543. file: 
  544.  
  545.     >base store,1,WRITER
  546.     >input salesub = d-sales
  547.     >form
  548.     Database: STORE.DEMO.ROBELLE
  549.     D-SALES          Detail                  Set# 5
  550.            Entry:                     Offset
  551.               CUST-ACCOUNT         Z8      1  (!M-CUSTOMER)
  552.               DELIV-DATE           J2      9
  553.               PRODUCT-NO           Z8     13  (M-PRODUCT)
  554.               PRODUCT-PRICE        J2     21
  555.               PURCH-DATE           J2     25
  556.               SALES-QTY            J1     29
  557.               SALES-TAX            J2     31
  558.              SALES-TOTAL          J2     35
  559.        Capacity: 602 (14)  Entries: 8  Highwater: 8  Bytes: 38
  560.  
  561. Of course, if the subfile contains only some of the fields, then you'll need 
  562. to define them individually. But you can still use Suprtool's Form command to 
  563. examine their storage structure in the datasets from which they've been 
  564. extracted.
  565.  
  566. Tip 3: Defined Fields' Data-Types
  567.  
  568. In some cases, subfiles may contain fields that were created within a 
  569. previous Quiz task, namely: 
  570.  
  571. - Defined fields 
  572.  
  573. - Results of summary functions (Count, Subtotal, etc.) 
  574.  
  575. Defined fields have whatever storage type is specified when they are created. 
  576. If a Numeric storage type is specified, PowerHouse creates a Float size 8 
  577. field by default. It is also important to note that if the Define is not 
  578. explicit about the field size, PowerHouse assumes a size based on the 
  579. requested number of digits. 
  580.  
  581. For example,
  582.  
  583.     define D-PRICE integer*4 = 25
  584.  
  585. creates a field capable of storing 4 digits  (i.e., a 2-byte integer), while 
  586.  
  587.     define D-PRICE integer size4 = 25
  588.  
  589. guarantees a 4-byte integer field. When in doubt, use Qshow to examine the 
  590. structure of the subfile. 
  591.  
  592. Tip 4: Fields Created by Summary Operations
  593.  
  594. Here is a list of data-types for PowerHouse summary functions written to 
  595. subfiles: 
  596.  
  597.   Count       Integer size 4
  598.   Subtotal    Float size 8
  599.   Minimum     Float size 8 for numerics, Character size nn for char fields
  600.   Maximum     Float size 8 for numerics, Character size nn for char fields
  601.   Average     Float size 8 subtotal, Integer size 4 count, and an Integer 
  602.               size 4 filler of binary zeros.
  603.   Percent     Two Float size 8 subtotals
  604.   Ratio       Two Float size 8 subtotals
  605.   Sysname     Character size 40
  606.   Sysdate     Phdate integer size 2 or 4 (if century included)
  607.   Systime     Integer size 2 (HHMM format)
  608.  
  609. [Hans Hendriks]
  610.  
  611.  
  612. Bug Alert: Suprtool/iX v. 4.1.01
  613. ================================
  614.  
  615. We have discovered a potentially serious problem in the current version of 
  616. Suprtool for MPE/iX 4.1.01.
  617.  
  618. The problem is that a Reset All command sometimes fails with an error  
  619. message of  "Error: Unable to reset table space." The root cause of this  
  620. problem may cause other serious problems within Suprtool.
  621.  
  622. We have developed the following patch to fix the problem, and we will send 
  623. you a new tape if you request one. This fix is only for version 4.1.01 of 
  624. Suprtool for MPE/iX. The problem does not affect the MPE/V or HP-UX versions. 
  625. The underlined text is entered by the user.
  626.  
  627.     hello mgr.robelle
  628.     -----------------
  629.     copy  suprtool.pub,suprnm.pub
  630.     -----------------------------
  631.     run sompatch.pub.sys
  632.     --------------------
  633.     sp> op suprnm.pub
  634.         -------------
  635.     sp> modify init_suprtool$2$heap_table_allo+28
  636.         -----------------------------------------
  637.     init_suprtool$2$heap_table_allo + 28 34161a48
  638.  
  639.     34163490
  640.     --------
  641.     34161a48|34163490
  642.              --------  
  643.     sp> exit
  644.         ----
  645.     Total number of patches being applied 1
  646.  
  647.     copy suprnm.pub,suprtool.pub
  648.     ----------------------------
  649.  
  650. We apologize for any inconvenience this may cause you. If you have any 
  651. questions, please give us a call.
  652.  
  653.  
  654. We're Listening!
  655. ================
  656.  
  657. Thank you to all those who returned our What's Up, DOCumentation? 
  658. survey. As requested, future articles of our newsletter will have a more 
  659. technical slant. Stay tuned!
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.