(Who Should Run the UPDATE Program\bold) (unnumbered) If RT--11 distributes a remastered operating-system distribution kit to all customers, you do not need to run UPDATE. If you are an RT--11 customer and your distribution is on an RX50, RX01, RX02, TK50, or 1600 bits/inch magtape, you do not need to run the UPDATE program. Included in the update kit is a remastered RT--11 kit. If you are an RT--11 customer and your distribution is on an RL01 or RL02, you must run the UPDATE program. If you are a layered-product customer, you must run the UPDATE program.

(Chapter Outline\bold)

This chapter describes: (unnumbered) Contents of the RT--11 update-kit media. Definitions of update terms. A general procedure for updating your working system disk. The manual's other chapters focus primarily on Step 4 of that procedure, running the UPDATE program. Diagrams of UPDATE sessions, when running the UPDATE program. How to access the (RT--11 Update Release Notes). Hardware configurations the UPDATE program supports. (Contents of the RT--11 Update-Kit Media)

The RT--11 update-kit media contain the following: (unnumbered) (RT--11 Update Release Notes). UPDATE program---the software that copies updated modules from the update kit to RT--11 and/or layered-product distribution kits. Updated software modules for RT--11 layered products requiring updates. Updated software modules for RT--11 (only on RL01 and RL02 distribution media), unless RT--11 is releasing a new version. Remastered RT--11 operating-system distribution kit (for all distribution media except RL01s and RL02s).

A remastered operating-system distribution kit contains all the operating system files as revised to the current level. You do not run the UPDATE program on this kit.

The update modules contain corrections to software problems. The RT--11 UPDATE program automatically copies these update modules from the update kit to the RT--11 and layered-product distribution kits. (Definitions of Update Terms)

(terms_table) lists some of the terms used in this manual. (Update Terms\terms_table) (2\21) (Term\Definition) (Kit map\A directory listing of an update kit. If the kit is composed of more than one volume, the kit map shows where the files are located on each volume. ) (FIRST) (Layered product\An optional software product. Layered products are sold separately from the RT--11 operating system but will not run without the RT--11 environment. For example, FORTRAN IV/RT--11 and BASIC--PLUS/RT--11 are RT--11 layered products. ) (Layered-product distribution kit\The unaltered layered-product kit distributed by Digital. ) (Module\A unit of software that is part of the RT--11 operating system or a layered product. For example, the RT--11 device handlers DL.SYS and DX.SYS are modules. ) (RT--11 distribution kit\The unaltered RT--11 kit distributed by Digital or an updated version of the RT--11 kit containing a remastered RT--11. ) (System volume\The volume on which the operating system is stored. ) (Update data file\A data file included in the UPDATE program that specifies which modules are updated. RT--11 and its layered products have corresponding update data files. ) (Update kit\The UPDATE program, update modules, and update release notes distributed to users of RT--11 and its layered products. ) (Update module\Any module copied by the update kit that replaces distributed software. )(LAST) (UPDATE program\The software that copies updated modules from the update kit to RT--11 and/or layered-product distribution kits.) (Update system volume\The update volume containing the UPDATE system program. For multivolume kits, the update system volume is Volume 1. ) (Volume identification number\A number and owner name, each consisting of 1- to 12-alphanumeric characters that identify a volume. ) (A General Procedure for Updating Your Working System Disk\gen_sec)

The following general procedure is for updating your working system disk. This procedure includes steps you take both before and after you run the UPDATE program. Adapt the procedure to suit your situation. (numbered) Read the update cover letter and update release notes. Check your update kit to see if you have in it a remastered RT--11 distribution kit. (unnumbered) If you have received a remastered RT--11 distribution kit, go to Step 6. If you have not received a remastered RT--11 distribution kit, back up your current RT--11 distribution media and your unaltered layered-product distribution media (or make sure you have a backup copy of these). If you need to update your RT--11 distribution kit or your layered-product distribution kit, run the UPDATE program on the appropriate distribution media.

How you run UPDATE depends on the devices you use and the product(s) you are updating. See Chapters 2, 3, and 4 of this manual for instructions on running the UPDATE program. Identify through the (RT--11 Update Release Notes) those updated layered-product modules that need rebuilding and rebuild those modules. See the appropriate layered-product manual for instructions and make a backup copy of the rebuilt modules. Back up your current working system disk. Or, if making a complete backup of your system disk is not feasible, carefully back up those files you want to preserve that are not part of the new RT--11 distribution; for example: (unnumbered) Logical disks (.DSK files) Customized start-up command files (STARTx.COM) User command-linkage data file (UCL.DAT)---if you have defined your own commands SYSGEN condition and answer files (*.CND and *.ANS files)---if you have used SYSGEN User or third-party programs/data you want to save Install the new (updated) version of RT--11. See the (ins_book) or the (aut_book) for directions. Follow the installation procedure that is suitable for you. If you want to create your own monitor and handlers (optional): (unnumbered) Restore to your system disk any customized SYSGEN answer files that you saved in Step 5. Run SYSGEN. See the (SYG_book) for directions. Run the configuration procedure (IND CONFIG) to delete unneeded system files. Restore to your system disk the files you saved in Step 2 that are not part of the RT--11 distribution and that you still need; for example, a customized start-up command file and logical disks. Install the layered products that were affected by the update. Make sure all your system and layered-product files are protected.

These files are distributed as protected. But, for example, if you have done a system generation, some files could now be unprotected. (Diagrams of UPDATE Sessions)

The following diagrams show the sequence of a complete UPDATE session.

(UPDATE Session Running in All Drive Units Except RX33 and TK50 Units) (\wide\nofloat) (POSTSCRIPT\MLO-003480.PS\48)

(UPDATE Session Running in RX33 Drive Unit) (\wide\nofloat) (POSTSCRIPT\MLO-003481.PS\48)

(UPDATE Session Running in TK50 Drive Unit) (\wide\nofloat) (POSTSCRIPT\MLO-003482.PS\48) (How to Access RT--11 Update Release Notes\notes_sec)

Each update kit includes the (RT--11 Update Release Notes), which provides the following information: (UNNUMBERED) A list of the contents of the update kit Space requirements for updating from logical disks A list of volume identification numbers for RT--11 distribution volumes A summary of the problems that have been corrected in the update A description of the workarounds for the problems not corrected in the update Kit maps for each type of update distribution medium Any extra postUPDATE procedures

You should be familiar with the release notes before performing an update. They are provided in a text file, UPDATE.TXT, in the RT--11 update kit. To read the release notes, follow these steps: (NUMBERED) Bootstrap the RT--11 system volume. Mount the RT--11 update kit (Volume 2 of a multivolume kit) in another drive unit that UPDATE supports; write-protect the update kit if possible. Read the release notes. You can print the release notes on a printer or hard-copy terminal or display them on a terminal screen.

To print the release notes on a printer, type: (.)(PRINT ddn:UPDATE.TXT (RET))

The device specification ddn represents the physical device name (dd) and drive unit number (n) of the device where the update kit is mounted.

To print the release notes on a hard-copy terminal or display them on a terminal screen, type: (.)(TYPE ddn:UPDATE.TXT (RET)) (Hardware Configurations the UPDATE Program Supports\hard_sec)

To run RT--11 UPDATE, your hardware configuration must include at least 32K bytes of memory.

To run in all drive units except the RX33 and TK50 units, you must have two drive units. To run in an RX33 or TK50 drive unit, you need only one drive unit.

(config_table) lists the physical device names and corresponding devices that RT--11 UPDATE supports.

(Hardware Configurations\ config_table) (\MULTIPAGE) (3\30\15) (Device\Physical Name\Drive Unit Number) (RK06, RK07 disk\DMn:\n = 0 or 1) (FIRST) (RL01, RL02 disk\DLn:\n = 0 or 1) (RX01 diskette\DXn:\n = 0 or 1) (RX02 diskette\DYn:\n = 0 or 1) (RX50 diskette\DUn:\n = 1, 2, or 3) (RX50 Professional series diskette\DZn:\n = 0 or 1) (RX50 diskette in RX33 drive\DUn:\n = 1, 2, or 3) (LAST) (TK50 magtape\MUn:\n = 0)