P.O. Box 125
Las Pied ras, Puerto Rico 00671
(809) 733-3030 / 746-8080 / 746-8484 TELEX 325 2574
Intel Puerto Rico Inc.
July 25, 1984
Dear iRMXT" 86 Customer:
You have just received the diskettes and reference manuals for iRHX 86 Release 6, Intel's newest release of the iRMX 86 16-bit Operating System.
This letler describes the package cont.ents, support, new release differences, and installation of Release 6.
PACKAGE CONTENTS
The diskettes in this package are formatted to be compatible with the floppy diskette drive in your system. The media-type used by your system
dete~ines the actual items you have received; media E for single-sided, double density 8 inch iRKX 86 format. (Used on the SYP 86/33~, Syp 86/38~,
and Syp 286/380 products) and media J for dOUble-sided, double density 5.25 inch, 48 tracks-·per-inch iRMX 86 format (Used on SYP 86/31~ and SYP 286/31fl) pt'oductg) . This package contains the following items:
1. Nine Disket14~s for Media Types E or J.
a. iRMX 86 Nucleus, Te~inal Handler and Dynamic Debugger.
b. iRHX 86 1/0 Systems and Device Drivers.
c. iRKX 86 Human Interface, Applicat.ion Loader, System Debugger, and Bootstrap Loader.
d. iRKX 86 Human Interface Commands.
e. iRKX 86 Intera(~tive Configuration utility (Part 1 of 2), Files utility and Patch utility.
f. iRHX 86 Interactive Configuration utility (Part 2 of 2), Universal Development Interface and Crash Analyzer.
g. iRMX 86 Include Files, Interface Libraries and Interactive Configuration utility System Definition Files.
h. iRMX 86 Installation Diskette for iAPX 86-Based Systems.
i. iRMX 86 Installation Diskette for iAPX 286-Based Systems.
2. Seven Binders Containing iRKr"86 Operating System and Language Reference Manuals.
a. iRHX 86 Introduction and Operator's Reference Kanual.
b. iRMX 86 Programmer's Reference Manual, Part I.
c. iRMX 86 Programmer's Reference Manual, Part II.
d. iRKX 86 Installation and Configuration Guide.
e. iRHX 86 Assembler User Kanulll.
f. iBMX 86 utilities User Manulll.
g. iRHX 86 Compiler User Manual.
1352'. Rev. A Sheet 1 of 9
3. A Software Pr.oblem Report (SPR) Form.
4. An Intel Software Registration Certificate (this should be completed and returned prompt.ly to ensure eligibility for Intel Software Support Services).
If any of these items are not included in this package, please contact your local Intel sales office immediately.
Before you incorporate RelE~ase 6 of the iRHX 86 Operating System into your application, you should read this entire letter. The iRKX 86 Introduction and Operator's Reference Manual and iRHX 86 Installation and Configuration Guide should also be consulted to help you incorporate Release 6 efficiently.
The iRHX 86 Operating SystE~m is an Intel licensed software product. Use of this system in. any derived product requires the payment of incorporation fees. You must report the number of "derivative works" you produce with your payment schedule for incorporation fees at least semi-annually using an Intel Incorporation Fee Certificate. A "derivative work" is defined in the Intel Master OEM Software License Agreement as a software program developed by you, which incorporates portions of the iRHX 86 Operating System through
compilation and/or linking the system with programs developed by you. Contact your local Intel sales office to obtain an incorporation fee certificate.
SUPPORT
All purchasers of the iRKX 86 Operating System are eligible for Intel's software support level B if they are within their warranty period. Level B support entitles each iRKX 86 cust.omer to field support f sof tware update.
service, and Software Problem Report (SPR) service. To ensure that you are eligible for these Iotel services, the enclosed Intel Software Regist.ration Certificate must be completed pt:"omptly. Indicate the name, title, and correct address for the contact per.son within yo.ur organization who should receive each iRMX 86 technical report, software updates, and other infocrnation.
REMEMBER . . . NO INTEL SUPPORT IS PROVIDED UNLESS THIS REGISTRATION CERTIFICATE IS COMPLETED ABO RECEIVED BY INTEL!
iRKX 86 Operatin& System users have the opportunity to join an active,
growing, international organization of other iRKX 86 users. This organization is called the iRKX 86 Users Group (iRUG~:). It was formed to enable users of iRHX 86 to share programs, information, and ideas. To learn more about iRUG activities, contact an iRUG representati.ve at (212) 86flJ-·flJ3flJ0, or write to the following address:
iRtJG
Lifeboat Associsltes 1651 Third Avenue Rew York, BY 1~028
1352.4 Rev. A Sheet 2 of 9
Intel offers many training workshops rellited to the iRHX 86 Operating System, the PL/K high-level programming language, and other microcomputer topics.
Group rates and on-site workshops are alBo available. For further information on our workshops, contact your local Int(~l sales office or contact the Intel Training Center for your area at the number listed below:
Boston, MA: (617) 256-1374 Chicago, IL: (312) 981-7250 Dallas, TX: (214) 241-8087
San Francisco, CA: (415) 940-780~
Washington, D.C.: (3~1) ~74-2878
Swindon, U.K.: 44-793-488-388 Munich, wEST GERMANY: 49-89-5389-1 Paris, FRANCE: 33-1-687-22-21 Tokyo, JAPAN: 03-4'37-6611
In addition to programs available through the iRUG organization'i several iRMX 86-compatible programs are included in Intel's Insite'" Program Library.
To become a member of the Insile group c:~lll one of the Intel Training Centers listed above.
RELEASE 5_TO RELEASE 6 DIFFERENCES
Release 6 of the iRHX 86 Operating Systern contains many new features not available in Release 5. Users presently using Release 5 should be able to incorporate Release 6 into their systems easily. The following section highlights most of the new features in R,~lease 6 and the major objectives of the product.
*- iRUG is a trademark of thc~ iRHX 86 Users Group.
Release 6 Objectives
The overall objectives of the iRHX 86 Release 6 Operating System are the following:
1. To support Intel t s new iAPX 186-·based single board computers.
2. To integrate the iRKX 286R Operating System product into iRHX 86 Release 6.
3. To correct most of the problems ~Ldentified in iRHX 86 Release 5.
4. Tv integrate iRMX 86 support for the Intel iAPX 86/88/186/188/286 products.
1352,4 Rev. A Sheet 3 of 9
Kajor Release 6 Features
The major features of Release 6 are the following:
1. Support of the Intel iAPX 186 and iAPX 286 products.
The iRKX 86 Operating System has been modified to execute on Intel iAPX l86/188-based single board computers, as well as Intel
components.
iAPX 186/188 systems are supported using either 80130-compatible support circuits or the on-CPU-chip interrupt controller and interval timers. The iAPX 286 support features that currently exist in the Intel iRKX 286R product have been integrated into iRHX 86 Release 6.
A single ICU provides configuration capability for iAPX
86/88/186/188/286-based systems. Device drivers have been added or modified to support the serial and parallel interfaces of the new iAP!
l86/188-based single! board computers. Seria 1 support f or the
iSBC~188/48 as a peripheral device (i.e. iSBC~ 544 replacement) is not included in iRHX 86 Release 6.
2. Support of 186/03 SASI/SCSI Interface.
The Intel iSBC™186/03 single board computer has a unique general-purpose SASI/SCSI interface. This interface allows peripherals stich as disks to be used without a MULTIBUS or iSBXT"
device controller. Support is provided for 5 1/4" and S" Winchester disk drives.
3. Incorporation of iRK}{ 86 Release .5 Addendum Manual.
Information in the iRHX 86 Releasle 5 Addendum Manual has been integrated int.o the iRKX 86 Release 6 manuals in this package.
4. Addition of iSBX~251 Bubble Memory Driver.
The iSBX~ 251 Bubble Memory Multimodule driver is included in iRHX 86 Release 6. ICU support for this driver is also included in Release 6.
5 . Improved Backup Vo lume Format SUP1Port.
A new backup format standard for information on standard media has been implemented in iRHX 86 Relealse 6. This allows transportability between Intel ISIS, TAPS, and SYSTEM
300
Series microcomputers.6. Rew Basic I/O System Exception Codes.
The use of the E$CONTEXT exception code has been removed from the Basic I/O system. Sixteen new erl~or codes have been lidded, which make error conditions easier to understand.
1352f. Rev. A Sheet. of 9
7. leu System Definition Files.
System definition files for the iSBC 186/~3, iSBC 186/51, and iSBC 188/48 single board computers are also supplied.
INSTALLATION
There are two start-up systmns included on the Installation Diskettes in this package. Each system contains a pre-configured multi-user iRHX 86 Operating System. Application programs executed on either of ±hese systems can access operating system services using the Universal Development Interface (UDI) and other iRMX 86 system ealls. The Installation Diskette labeled "Pre-·conf igured System for iAPX 86" is used on SYP 86/310, SYP 86/33~, and SYP 86/38~
systems. The diskette labeled "Pre-configured System for iAPX 286ft is used on the Syp 286/310 and SYP 286/380 systems.
Inst~ctions for installing the iRHX 86 Operating System on your SYP 86/3~0 or SYP 286/300 Family Mic.rocomputer System are provided in Chapter 11'6 of the iRHX 86 Installation Guide. PLEASE NOTE THA.T THE INSTALLATION PROCESS FORMATS THE HARD DISK ON YOUR SYSTEM. IF YOU HAV!!: A SYSTEM THAT WAS RUNNING A PREVIOUS VERSION OF iRHX 86, YOU MUST USE THE BACKUP COMMAND TO SAVE ANY DATA YOU HAVE STORED ON THE SYSTEM DISK PRIOR TO BEGINNING THE INSTALLATION PROCESS.
The following provides furt.her information to aid you in the process of installing iRHX on your system.
File Names
Intel has adopted a file naming convention for files supplied on Release 6 diskettes which can be read by a developmf~nt system but are intended for execution under the iRHX 86 Human Interfa(~e. This development sysbem can be either the Intellec Development System, or a SYSTEM 3~f6 Series microcomputer, accompanied by correct softw.are development tools. All these files are Human Interface commands and are named with an .~xtensi.on of ... R86tt• The iliHX 86 Human Interface Commands diskette (as with the other Release 6 diskettes) contains a SUBMIT file (called instal.csd) which you can use to copy Human Interface Commands from the Release 6 dislcette to your iRKX 86 System. This submit file will automatically rename the commands to the standard iRKX 86 command ~ames.
Device Names
Table 1~-1, Start-up System I)evice Hames of Winchester Drives, in the iRKX 86 Installation Guide should be expanded to l.nclude the following two devices:
1352 •• Rev. A Sheet 5 of 9
Deviee
Priam 8" 6., HB Winchester (formatted)
Quantum 5 1/4" 36 HB Winchester (formatted)
Device Hame iwbiJ, iwbl
qmaiJ, qmal
Be sure to check the 1type of drive in your system before installing iRKX 86 Release 6.
Include Files
Figure E-l in the iRHX 86 Installation Guide shows the hierarchical directory structure on your hard disk with two exceptions:
1. The iRMX 86 system call interface libraries have been copied into the directory Irmx86/lib which is required to use the Intel-·supplied lCU definition files. They have not been copied into the directory Ilib/rmx86 as indicclted in the figure.
2. The iRMX 86 Exception Code Literal files and the System Call External Declaration files hElve been copied into the directory Innx86/inc as is required. They have not been copied into the directory
Ilib/rmx86 as indicated in the figure.
To copy the interface libraries into the directory indicated in Figure E-l of the iRHX 86 Installation Guide, type:
Super- copy Irmx86/lib/* to Ilib/rmx86
To copy the exception code literal files and external declaration files into the directory indicated in the figure, type:
Super- createdir linc/rmx86
Super- copy Irmx86/inc/* to linc/rmx86
Hote that this will create two copies of these files on your hard disk. If disk space is a concern, YOll may wish to access these files from the
directories into which they were originally installed.
Version Numbers
The iRKX 86 Installation Guide lists the version numbers for each part of the iRHX 86 Operating Sys'tem supplied in this package. Intel has also included a special file for each part of the system that identifies the version number supplied on the diskette. For example, on the diskette which contains the iRHX 86 Nucleus, there is a file called ttNUCLUS.060" that identifies the Bucleus as Version 6.~. A Human Interface Command VERSION, is provided that will display the version number of a particular object file containing encoded version information. ,All Human Interface Commands contain this information.
135204 Rev. A Sheet 6 of 9
The following caution list applies to tbe Assembler and utilities package which is included with the SYR 86 product:
1. ED
a. Editing files more than 25X lines long or greater than 128K bytes in total. length will cause information in the files to be
destroyed. Avoid creating files of this size.
b. The EDIT Reference Manual does not describe how ED responds after an X, W, artd E: command when the specified file is more than 64X bytes long. If the user edits a file that is longer than 64K bytes, ED responds with:
[filename):x lines, y + z bytes where:
y
=
number of 64K segmentsz = number of last segment in bytes
c. If ED encounters a non-existent macro it makes· no attempt to sUbstitute the: macro and does not report that the macro is undefined.
d. TAB characters are not echoed on the terminal screen when they are entered on the: keyboard. However, They are correctly entered into the edit file.
2. LINK86, LOC86 , LIB86
a. Before locating programs, it is necessary to include the INITCODE option on the LINK86 statement during the LINK step. Failure to do so may result in the production of an unreported bad Object module by the LOCATE program.
3. All Product~s in the Assembler/Utilities Package:
a. Specification of an existin.g directory as the output file in a PRINT or OBJECT control, following the TO preposition on your conunand line, will result in an un-named temporary f'ile being created in the specified directory. Upon completion of the job this file wil,lbe automatically deleted by the operating system. Do not spec.ify di.rectories as the final component in output pathnames.
4. The following caution list applies to the PL/H-86 Compiler included with the SYR 86 product:
1352.4 Rev. A Sbeet 7 of 9
B. When a word operation is performed, and its result is assigned to an integer (using the SIGHED function), an immediate test of the integer against zero will use the flag setting from the previous operation. This causes the result of the test to be wrong. Example:
DECLARE (1I,1,w2) WORD, i1 INTEGER, P BYTE;
w1=8001H; w2= 7F'FEH; P=f6;
il=SIGNED(wl-w2); /* result = 3 */
IF i1 = f6 THEN P=1;
ELSE P = 2; /* P is set to 2 '~hich is wrong
* /
Note that pulting a label in front of the integer comparison will result in proper operation.
b. If the user has a program error at compile time such that helshe has a hard coded divide-by-zero, (such as X/~ or 17/~), the compiler uses the value zero for the expression with no error message being issued. Note thlit cases such as X/0 have gone undetected since Release 1.0 of the product. Cases of constant divided by zero did produce Er.ror 19 before and now go undetec.ted.
c. If the data segment size is exceeded, the error message gives a line number at which the overflow occurred, and a symbol on the line at which the overf low oc(~urred. The 1 ine number is wrong and points to the end of the module. The symbol, however, is correct.
d. In an INTEGER DO LOOP with a BY clause, 2 temporaries are used to hold the limit and step values invariant at the two tests at the beginning and end of the loop,. If this construct is used in a REENTRANT procedure, the temp()raries are not put on the stack.
e. Filenames of 40 characters sh()uld be supported as per UDI standard. Only 14 are supported (inclusive of extension).
f. Using lhe .. ~ .. operator to get the address of a list that contains a REAL number does not work correctly. The space is not allocated properly, and the location contains invalid information.
Status updates on a.l.l report.ed problems lire available in publications from Intel's CUstomer Service Operation. Ple~ise use the Software Problp~ Report form to report any problems you encounter with the SYR 86 product.
1352'. Rev. A Sheet 8 of 9
Thank you for •• lecti", t.he iBm 86 Opelratil\l Sy.t_. We look forward to • continuin& relationship with you throulh hiab quality products and aervicas from Intel.
a;2~~
Pablo R Rodriguez Genera Manager
1352 •• Rev. A Sheet 9 of 9
