SUPRTOOL Version 4.2 Database Handyman for the HP 3000 Pre-Release Change Notice Installation Instructions Addendum to 4.2 User Manual Suprtool 4.2 Dbedit 4.2 Suprlink 4.2 STExport 4.2 Speed Demon 4.2 Suprtool2 4.8 Robelle Consulting Ltd. Unit 201, 15399-102A Ave. Surrey, B.C. Canada V3R 7K1 Toll-free: 1-888-ROBELLE (1-888-762-3553) Phone: (604) 582-1700 Fax: (604) 582-1799 E-mail: support@robelle.com Web: www.robelle.com March 1999 Program and Manual Copyright Robelle Consulting Ltd. 1981-2002 Permission is granted to reprint this document (but not for profit), provided that copyright notice is given. QEDIT and SUPRTOOL are trademarks of Robelle Consulting Ltd. Other product and company names mentioned herein may be the trademarks of their respective owners. Introducing Suprtool Version 4.2 ü Highlights ü Compatibility ü CPU Serial Number ü Compatibility Mode vs. Native Mode ü Documentation ü Documentation in WinHelp Format Suprtool provides fast access to your data on the HP 3000. With Suprtool, you can perform many necessary DP functions easily, with just a few simple commands. At Robelle we are constantly working on your enhancement requests so that we can include them every year when we release an updated version of Suprtool. This change notice provides you with detailed installation steps and a description of Suprtool's new features. Highlights in Version 4.2 More Date and Data Manipulation ü With the new $stddate function, you can use the popular "date windowing" Y2K technique in the If and Extract commands. ü You can compare dates with dissimilar formats or data-types by using the new $stddate function. ü The If and Extract commands now support the Mod arithmetic operator, allowing more flexible manipulation of numeric data, especially numeric date data. New Date Formats ü Suprtool now supports more new date formats: mmyyyy, yyyymm, yyddd, ccyyddd, aamm, mddaa, ddmmaa and HPCalendar. The ddd date component is a count of the "day of the year," which is sometimes referred to as a Julian date. ü The $date function now permits you to enter a date without a month or day, depending on your date format. Staying Current with MPE ü Suprtool, Speed Demon and HowMessy now support 80 GB Jumbo datasets that became available in C.07.14 version of IMAGE on MPE/iX Powerpatch 5. Compatibility Suprtool, Speed Demon, and Suprlink are compatible with Q-Delta-2, R-MIT, T-MIT, U-MIT, V-MIT, MPE XL, and MPE/iX, including MPE/iX 5.5. Item Command and Date Format In earlier versions of Suprtool, the Item command default allowed an abbreviated name of the date format. Now this default expects the full mnemonic for the date format. To change the default, you can use the new Set ItemAbbreviateDate On command. For example, >def a,1,4,double >item a,date,hpcal Error: The Item command did not recognize HPCAL as a valid date keyword >set itemabbreviatedate on >do item >item a,date,hpcal To enable this feature globally for all Suprtool tasks, add >set itemabbreviatedate on to the Suprmgr.Pub.Sys file. CPU Serial Number (HPSUSAN) This program runs only on CPUs whose serial numbers have been encoded ("showvar hpsusan" on MPE/iX). If it fails to run and you get an "invalid HPSUSAN" error message, call Robelle for assistance. Compatibility Mode vs. Native Mode Throughout this change notice and in all of the Suprtool documentation, there are references to compatibility mode and native mode. If you are on a Classic HP 3000 (i.e., not MPE/iX), you can use the compatibility-mode version of Suprtool. Our job streams automatically install the correct version for your machine. We use the terms MPE XL and MPE/iX interchangeably in our documentation. Documentation This release includes updated user manuals for Suprtool and its components. To print these manuals, use the Printdoc program. :run printdoc.pub.robelle This is the list of documentation files for Suprtool: suprtool.doc.robelle {Suprtool user manual} stexport.doc.robelle {STExport user manual} suprlink.doc.robelle {Suprlink user manual} dbedit.doc.robelle {Dbedit user manual} demon.doc.robelle {Speed Demon user manual} suprcall.doc.robelle {Calling Suprtool user manual} suprtool.docchg.robelle {this change notice} If you know the file names of other Robelle documents, you can print them with Printdoc or you can include the file name in the :Run command. For example, to print this change notice, type :run printdoc.pub.robelle;info="suprtool.docchg.robelle" Documentation in WinHelp Format The user manuals for Suprtool and its components are all available in the popular WinHelp file format of Microsoft Windows. Your tape includes a WinHelp file, which is a self-extracting compressed file that contains all five Help files and a Setup program. Use the installation instructions in this change notice to install the WinHelp files on your PC. Installation of 4.2 If you need to install this upgrade in an account other than the Robelle account, use the installation instructions in the appendix at the end of this change notice. The following installation instructions are for existing Suprtool users who are installing a new version in the Robelle account. Please use the instructions from this change notice instead of the user manual because the change notice always has the latest version. The whole process should take about 30 minutes, assuming that no one uses Suprtool or its components during the installation. To install this update of Suprtool, follow these steps: 1. Restore the new files from tape. 2. Upgrade the structure of the Robelle account. 3. Install the proper program files (NM or Classic). 4. Install Speed Demon in the system SL (only Classic). 5. Install the Suprtool2 interface in the system SL (only Classic). 6. Limit Suprtool's run time priority (optional). 7. Install WinHelp documentation files (optional). 8. Install QLIB and Bonus programs. 9. Purge the installation files (optional). Replace Any Pre-Release If you are currently running a pre-release version of Suprtool, you should replace it with this new official release. Pre-release versions expire within two years of their creation date, whereas this new release has no expiry date. You can easily recognize a pre-release by the words "Pre-Release" next to the version number. Installation Assistance If you have any questions or run into any problems, please call us. Technical support is available on weekdays from 7 a.m. to 4 p.m. Pacific time at 1-888-ROBELLE (1-888-762-3553). You can also receive emergency support outside of these hours by calling our regular phone number and asking the operator to page a support person for you. Important Note About Passwords None of the jobs that we supply have passwords in them. Before streaming a job, you might have to add your system's passwords to the first line. Users of MPE XL 3.0 and later do not have to do this because the operating system prompts for missing passwords. The same is true for some MPE V users who have security software that inserts passwords. Most MPE V users have to edit the jobs. For example, if the system manager logon password is Qwerty, you would do the following: :editor HP32201A.07.22 EDIT/3000 /text robelle.pub.sys FILE UNNUMBERED /modify 1 MODIFY 1 !job robelle,manager.sys,pub;hipri;jobq=SUPRTOOL i/qwerty !job robelle,manager.sys/qwerty,pub;hipri;jobq=SUPRTOOL /keep robtemp /exit END OF SUBSYSTEM :stream robtemp :purge robtemp STREAMX Users Users of STREAMX, a part of SECURITY/3000 from VESOFT Inc., must set a Job Control Word before streaming jobs. This prevents STREAMX from generating an error if the Robelle account does not yet exist. For example, :setjcw streamxtempnonest 1 :stream robelle.pub.sys Step 1: Restore the Files You begin by restoring all the files from the tape. :hello manager.sys :file rtape; dev=tape {use appropriate device} :restore *rtape; @.@.robelle; create {restore everything} The files on the tape require approximately 80,000 sectors. If you are upgrading Suprtool, most of these files will replace existing files because the new version of Suprtool does not take up much more space than the old version. The Suprtool program files are located in the Pub group of the Robelle account. At this point in the installation process, the files do not have the correct names. The next step assigns the proper names to the program files. Step 2: Set Up the Robelle Account Even if you already have the Robelle account, you must stream the Robelle job to ensure that the Robelle account and all its groups have the proper security and capabilities. :stream robelle.job.robelle When the job stream is finished, it will send you a message. The job removes the password from the Robelle account. Stay logged on as Manager.Sys and put a password on the Robelle account. If you are upgrading your Robelle account, use the old password. :altacct robelle;pass=hardpass {hard to guess} Please note that during installation we add OP capability to the Robelle account. When the Suprtool installation is finished, you have the option to remove OP capability. Step 3: Install Suprtool into Production Our installation job installs Suprtool, STExport, Suprlink, Speed Demon, and the Suprtool2 interface. No one can use these programs during the installation. Before you stream this installation job, warn people not to use these programs for a while. :hello mgr.robelle :warn @;please exit from Suprtool and Suprlink NOW! :stream install.Suprjob Once Suprtool has been installed, check the installation job $stdlist. If anyone was either using Suprtool, STExport, Suprlink, or Speed Demon, or attempting to back them up, the installation job will fail. Chase away any users and ensure that a backup is not in progress, then stream the installation job again. The installation job renames your current versions of Suprtool and its components to the PubOld group of the Robelle account. If you need to move these versions back into production, use the Previous.Suprjob job stream. You can now access Suprtool by entering :run suprtool.pub.robelle Optional Installation Steps On MPE/iX your installation should be complete. If you have a copy of Speed Demon or the Suprtool2 interface in your own XL files, you will have to update them with the new versions (use the instructions in the Speed Demon and Calling Suprtool user manuals). To use the new versions on MPE V, you still need to install Speed Demon and Suprtool2 in the system SL. MPE/iX users must also do this if they are calling Speed Demon or Suprtool2 from compatibility-mode programs. With so few changes to Speed Demon and Suprtool2, you can safely ignore them for this version of Suprtool. If you have a Windows PC, you can install all the Suprtool documentation in the popular WinHelp format of Microsoft Windows. Step 4: Speed Demon/V Installation (optional) To use the new features of Speed Demon/V, you must install the latest version in the system SL. You should follow the installation instructions in the Speed Demon user manual. These instructions assume that you have used the Install.Suprjob job stream to move Suprtool and its components into the Pub group of the Robelle account. :stream demon.Suprjob.robelle Step 5: Suprtool2 Interface Installation (only Classic) The Suprtool2 interface has been revised. On MPE V you must re-install the interface. If you do not have the latest Suprtool2 interface, programs that attempt to use totals from Suprtool2 will fail. You can install this interface without recompiling any of your existing programs. System SL Installation To install the latest Suprtool2 interface in the system SL, use our standard installation job: :stream suprcall.Suprjob.robelle User SL or XL Files If you have a copy of the Suprtool2 interface in your own SL or XL, you will need to update it. For instructions on how to do this, consult the user manual for Calling Suprtool. Step 6: Limit Suprtool's Run Time Priority (optional) Some system managers like to restrict the amount of resources that Suprtool consumes. One way to do this is by running Suprtool in the D queue, which lets you use HP's Linkedit program. :linkedit >altprog suprtool;maxpri=ds >exit By forcing Suprtool to always run in the lower queue (even when Suprtool runs on-line), it competes less with on-line users because most users run in the C queue. System managers should only restrict the priority of Suprtool if they are familiar with MPE process queues and the Tune command. Step 7: Install WinHelp Documentation Files (optional) The Suprtool documentation for both MPE and HP-UX is now available in the WinHelp file format of Microsoft Windows. You can use these files only if you have Windows 3.1 or later. To install the WinHelp files on a PC, follow these instructions. Make a Temporary Directory for the Setup Program Create a directory for the installation file on your PC. You can remove this directory after installing the WinHelp files. At the DOS prompt, for example, type mkdir \robtemp Download the Compressed File If you use the floppy diskette that is included in the Suprtool User Manual to copy the Help files to your hard drive, proceed to "Run the Setup Program" below. Otherwise, use Reflection to download the self-extracting Zip file to your PC and continue with these steps. This Zip file on the HP 3000 is called Suprhelp.Whelp.Robelle. Log on as Mgr.Robelle and press Alt-Y to go to the Reflection Command Line window. Then download the file as a binary transfer. receive c:\robtemp\suprhelp.exe from suprhelp.whelp.robelle binary Expand the Compressed Files You only need the following commands to extract the files because we provide both the Setup program and the Help files in one self-extracting Zip file. From the DOS prompt, type the following commands: cd \robtemp {go to the new Robtemp directory} suprhelp.exe {extract the Help files} Run the Setup Program From the Program Manager, run the Setup program by choosing the Run option from the File menu. Then enter C:\Robtemp\Setup in the Command Line window and follow the instructions in the Setup program. You can now access all of the Suprtool documentation by selecting any of the icons in the "Robelle Help" Program Manager Group. Remove the Robtemp Directory Before you remove the WinHelp files, you can copy them to a diskette and distribute them to other Suprtool users. To delete all the WinHelp files and remove the Robtemp directory, use either the File Manager or the following DOS commands: cd \robtemp del *.* {delete all the files in Robtemp} cd .. rmdir robtemp {remove the Robtemp directory} Step 8: Install QLIB and Bonus Programs Suprtool comes with an array of contributed software in the QLIB library (in the QLIB groups of the Robelle account). QLIB programs may be used on any CPU and may be given away freely. Your Robelle license may also entitle you to receive our Bonus programs: Compare/iX, HowMessy, Select, Spell, and Xpedit. These programs reside in the Pub group of the Robelle account. Bonus programs can only be used on authorized machines, and you may not distribute them to anyone. If you received Bonus programs with this version of Suprtool, use the job stream called Bonus.Job.Robelle to install both the QLIB and Bonus programs. If you did not receive Bonus programs, use the job stream Qlib.Job.Robelle to install the QLIB programs. :hello mgr.robelle :stream bonus.job.robelle {or Qlib.Job.Robelle} If you skip this step, you might end up running old versions of these programs. Step 9: Purge Installation Files (optional) The easiest way to clean up after an installation is to stream the Cleanup.Purgejob.Robelle job. This job saves you disc space by purging the installation files. It does not purge the files that are necessary to run the software. Enhancements Every year we provide Suprtool users with new features. This year the major enhancements include more date control functions in the If and Extract commands, more date formats for the Item command and a new Mod arithmetic operator. The following sections describe the new enhancements to Suprtool since the last major release. Decimal Command - STExport Use the Decimal command to specify the symbol for the decimal place in STExport. DECimal PERIOD | COMMA (Default: Period) The Decimal command specifies what separator will be used to indicate the decimal place in numeric fields. In North America, the custom is to indicate the decimal place in numbers with a period (.). Outside North America, the custom is to indicate the decimal place with a comma (,). If the decimal place indicator is incorrect, it is harder to import files into other applications. The Decimal command does not apply to floating-point fields. If Command - $Stddate Suprtool now has a new $stddate function available in the If and Extract commands. This function can compare dates of dissimilar formats or data-types by converting any date format in nearly any data-type container and internally converting it to the ccyymmdd format in a double-integer container. For example, > get order-detail > item order-date,date,ccyymmdd > item bill-date,date,mmddyyyy > if $stddate(bill-date) <= order-date > output badords,link > xeq This feature is also available for those dates that have two-digit years. The century portion of the date is applied to $stddate by using the normal cutoff rules that use the value in Set Date Cutoff. > get invoice-detail > set date cutoff 20 > item invoice-date,date,yymmdd > item close-date,date,mmddyyyy > if $stddate(close-date) <= $stddate(invoice-date) > out badinvs,link > xeq In this case all invoice-date values with a yy portion between 20 and 99 will have 19 as the century. All invoice-date values with a yy portion of less than 20 will have 20 in the date generated by the $stddate function. Invalid Dates A date must be valid before $stddate can convert it to the ccyymmdd format. Otherwise, a value of 0 will be returned for any invalid dates. An invalid date is a number in a date format whose date equivalent cannot be found on a calendar. This includes dates selected by the $invalid function. We can eliminate the invalid dates from the above task by changing the If command slightly. > get invoice-detail > set date cutoff 20 > item invoice-date,date,yymmdd > item close-date,date,mmddyyyy > if (not $invalid(close-date) & or not $invalid(invoice-date)) & and $stddate(close-date) <= $stddate(invoice-date) > out badinvs,link > xeq In this example, if either the close-date or the invoice-date are invalid, then they will not be evaluated by the $stddate function and will not be selected. Although your requirements may be different, you need to remember that invalid dates evaluated by the $stddate function will return a 0 value. Extract Command - $Stddate Similar to the If command, the Extract command is also capable of utilizing the $stddate function, which can convert any of the supported Suprtool date formats into the ccyymmdd format in a double-integer container. For example, > get sales-detail > def new-ship-date,1,4,double > item ship-date,date,mmddyyyy > ext order-no / sales-amount > ext new-ship-date = $stddate(ship-date) > out salesinfo,link > xeq Invalid Dates A date must be valid before $stddate can convert it to the ccyymmdd format. Otherwise, a value of 0 will be returned for any invalid dates. An invalid date is a number in a date format whose date equivalent cannot be found on a calendar. If you use the $stddate function to extract a value that is not a valid date, the extracted value will be 0. $Date Function The $date function for the If and Extract commands has been enhanced to have more flexible parsing of the year, month and day portions for the yymm, yyyymm, ccyymm, ccyy, aamm, mmyyyy and ccyymm date formats. For example, in earlier versions the ccyy date format had to specify all three components (year, month and day). Now the $date function needs only the relevant portion of the date. >item year-date,date,ccyy >if year-date = $date(*) For compatibility reasons, we also accept all three portions of the date in the $date function. >item year-date,date,ccyy >if year-date = $date(*/*/*) Item Command - Date Format In earlier versions of Suprtool, the Item command default allowed an abbreviated name of the date format. Now this default expects the full mnemonic for the date format. To change the default, you can use the new Set ItemAbbreviateDate On command. For example, >def a,1,4,double >item a,date,hpcal Error: The Item command did not recognize HPCAL as a valid date keyword >set itemabbreviatedate on >do item >item a,date,hpcal To enable this feature globally for all Suprtool tasks, add >set itemabbreviatedate on to the Suprmgr.Pub.Sys file. Item Command - mmyyyy The Item command now supports the date format of mmyyyy in X6, Z6, J2, K2 and P8 or greater data-types. Item Command - yyddd The Item command now supports the date format of yyddd in X5, Z5, J2, K2 and P8 or greater data-types. Because you cannot have uneven byte fields in IMAGE databases, you may need to redefine your date field for these types of dates, depending on where your date is padded with spaces. If your date is an X6 field, you can redefine your date field. This particular date pads a yyddd-type date with a space at the end of the field. >def newdate,date-field[1],5 >item newdate,date,yyddd >if newdate <= $today Item Command - ccyyddd The Item command now supports the date format of ccyyddd in X7, Z7, J2, K2 and P10 or greater data-types. Because you cannot have uneven byte fields in IMAGE databases, you may need to redefine your date field for these types of dates, depending on where your date is padded with spaces. If your date is an X8 field, you can redefine your date field. This particular date pads a ccyyddd-type date with a space at the beginning of the field. >def newdate,date-field[2],7 >item newdate,date,ccyyddd >if newdate <= $today Item Command - HPCalendar The Item command now supports the date format of HPCalendar in J2 and K2 data-types. Item Command - yyyymm The Item command now supports the date format of yyyymm in X6, Z6, J2, K2 and P8 or greater data-types. Item Command - aamm The Item command now supports the date format of aamm in an X4 data-type. The Item command also supports mmddaa and ddmmaa date formats in an X6 data-type. Jumbo Datasets 80 GB An enhancement in TurboIMAGE/SQL version C.07.14 allows Jumbo datasets to be up to 80 GB in size, which is twice as large as the previous limit. This change to IMAGE/SQL is now supported in Suprtool, HowMessy and SpeedDemon. If Command - Mod Operator Suprtool now has a new Mod arithmetic operator that returns the remainder between a dividend and a divisor. Practical uses of the Mod operator allow for extractions of the rightmost numbers from numeric fields. You can use the Mod operator to do a comparison on the rightmost numbers of a given numeric field. For example you could compare the dd portion of a ccyymmdd date against another field or constant. > get order-detail > item order-date,date,ccyymmdd > if order-date mod 100 <= 15 > out ordbegin > xeq Using the same concept and data, you can also compare the month portion of a given date by using divide (/) and Mod together. > get order-detail > item order-date,date,ccyymmdd > if order-date / 100 mod 100 <= 02 > out ordbegin > xeq The Mod operator has the same precedence in the order of operations as multiply and divide. Extract Command - Mod Operator The Mod operator is also available to the Extract command. It returns the remainder between a dividend and a divisor. Practical uses of the Mod operator allow for extractions of the rightmost numbers from numeric fields. > get order-detail > item order-date,date,ccyymmdd > def order-date-day,1,4,double > ext order-no > ext order-date-day = order-date mod 100 > out ordday,link > xeq Using the same concept and data, you can also extract the month portion of a given date by using divide (/) and Mod together. > get order-detail > item order-date,date,ccyymmdd > def order-date-day,1,4,double > ext order-no > ext order-date-day = order-date / 100 mod 100 > out ordmonth,link > xeq The Mod operator has the same precedence in the order of operations as multiply and divide. Output Command - Suprlink Suprlink's Output command now supports the Link option. Although it was already the default output file, some users found themselves typing the Link option on the Output command. This would cause an error, even though linked files can be written by Suprlink. We now allow the Link option to be specified. Bugs Fixed Edit Command. Dbedit now recognizes fields with Item commands. Form Command. The Form dataset command no longer fails with certain versions of Superdex on detail datasets with no search path. Get Command. The Get command by record range on a Jumbo dataset now reads the next chunk of the Jumbo dataset. Get Command. Suprtool reads beyond the calculated EOF on Jumbo master datasets. If Command. The If command no longer reports "Error: Missing symbol" when using the $date function for ccyymm, yyyymm, and ccyy date formats. If Command. The If command's $invalid function now reports yymmdd and yymm dates as invalid in numeric containers such as J2. If Command. Suprtool no longer incorrectly evaluates an expression with two constants. List Command. The List command and the time 2 format in Set List no longer incorrectly report a.m. when the time is between 12:00 to 12:59 p.m. List Command. The List command no longer aborts when listing odd-length integers in Hex. Suprtool Extracts. Suprtool no longer fails with a "Prefetch'read'fail- ure" on some systems with large amounts of memory. Set Command. The NM version of Suprtool no longer reports an incorrect dataset number if an IMAGE error occurred and Set DumpOnError was enabled. STExport Command. STExport now supports ASK dates in all cases. Verify Command. The Verify item command now always prints the date type. QLIB and Bonus Enhancements Suprtool comes with an array of contributed tools in the QLIB library. Your Robelle license may also entitle you to receive our five Bonus programs. All of these tools are updated throughout the year, not necessarily in sync with Suprtool or any other Robelle product. If you have the Bonus programs, you may use them only on appropriately licensed CPUs. The QLIB programs, however, may be used on any CPU and given away freely. The most recently released Bonus and QLIB tools are as follows: Bonus Contributed Compare/iX 2.6 Helpcomp 2.2 HowMessy 2.6 Printdoc 1.7 Select 3.9 Prose 4.2 Spell 1.8 Pscreen 89C Xpedit 1.7 Qcopy 4.6 Qhelp 2.2 Bonus Programs Since the last major release of Suprtool, the following Bonus programs have been enhanced with these new features: Compare/iX 2.6 The NM Compare program compares two text files and prints out the differences for you. Compare works with both Qedit workfiles and regular Keep files. The input file names can be specified in the Info= string. See Compare.Docchg.Robelle for a detailed change notice for Compare. HowMessy 2.6 HowMessy provides fast reports on the internal efficiency of your database. Now use HowMessy to report statistics on IMAGE/SQL datasets up to 80 gigabytes. See HowMessy.Docchg.Robelle for a detailed change notice for HowMessy. Select 3.9 Select is a menu front-end that works on any terminal, allowing people to select tasks from a list of choices. User commands (and UDCs) support 32 parameters and :Escape. Variable-length and Qedit-type command files are allowed. See Select.Docchg.Robelle for a detailed change notice for Select. Spell 1.8 Spell is a fast spelling checker for the HP 3000 that reads both Qedit and EDIT/3000 files. Spell can read Qedit's Jumbo files. Xpedit 1.7 Xpedit is a simple screen editor that is handy for editing small files using VPLUS block-mode. Inverse video was added to some error messages to make them stand out more prominently. See the file Xpedit.Docchg.Robelle for a complete description of Xpedit's changes. QLIB Programs Since the last major release of Suprtool, the following QLIB programs have been enhanced with these new features: Printdoc 1.7 Printdoc is an easy-to-use utility for printing Robelle manuals and other documentation. Printdoc now supports LaserJet 4 and 5 printers. Prose 4.2 Prose is the text formatter that we use for all our documentation, from user manuals to on-line help. Prose can now read Jumbo text files that are wider than 256 characters. Prose can also generate RTF output with the .out (rtf) command. See the Prose.Docchg. Robelle file for a detailed change notice for Prose. Qcopy 4.6 Qcopy is a contributed program that reads and writes Qedit files. Its Qeditaccess routine decodes the files for Qcopy. Although Qeditaccess can read Qedit's new Jumbo files, it cannot write them. Qhelp 2.2 Qhelp is an on-line user Help facility that you can tie into your own software. We use it ourselves in all our software products. Appendix: Non-Robelle Installation Suprtool is usually installed on your HP 3000 in the Robelle account (see the installation instructions earlier in this change notice). However, you can easily install Suprtool into another account by following these general steps: 1. Create or upgrade the structure of your account. 2. Restore the files into your account. 3. Alter any installation jobs to log on to your account. 4. Stream the installation jobs. For example, to install Suprtool into an account called Tools and into the same groups as Suprtool would have used in the Robelle account (Pub, Doc, Help, etc.), follow these steps. Step 1: Upgrade Account Structure With a text editor, change all account references in the Robelle.Pub.Sys job from "robelle" to "tools." Don't worry about changes to some of the comments in the job. Note that this job will change the capabilities, access flags, and logon password of the Tools account. Examine the job carefully to ensure that the changes do not cause problems for other software in the Robelle account. :run qedit.pub.robelle /text robelle.job.robelle /change "robelle"(upshift) "tools" all Step 2: Restore Files Restore the files into your account, which is Tools in this example. :restore *rtape;@.@.@;account=tools Steps 3 and 4: Alter and Stream Installation Jobs Now log on to the Tools account instead of the Robelle account. :hello mgr.tools :run qedit.pub.robelle Before streaming any jobs, you must alter them so that they log on to the Tools account instead of the Robelle account. Make the following change to each job in the Suprjob, Job, and Purgejob groups: /text install.suprjob /change "robelle"(upshift smart) "tools" all /keep /exit :stream install.suprjob We have used Robelle's Qedit text editor to make the required changes to the account name in this example, but you can use any editor. Just make sure that all occurrences of "robelle" are changed, regardless of whether "robelle" is in uppercase, lowercase, or mixed case. Only change "robelle" when it is a separate word, not when it is embedded in a longer word.