⟦7189b0c91⟧

TextFile

RELEASE NOTE and INSTALLATION PROCEDURE

Training Software

Date:   19 February 1991

This is a release of all available training software for current
courses.  It includes software for the following courses:

Rational Environment Training: System Management
Rational Environment Training: Fundamentals
Rational Environment Training: Advanced Topics
Rational Environment Training: Subsystems and Configuration Management
Rational Environment Training: Project Development Methods
Rational Environment Training: Toolsmithing
Rational Network Training
Rational Design Facility Training: DOD-STD-2167
Rational Design Facility Training: DOD-STD-2167 Product Customization
Rational Design Facility Training: Fundamentals and DOD-STD-2167A
Rational Design Facility Training: Toolsmithing and DOD-STD-2167A
    Customization
Rational Universal Host Training: MC68020/Bare Cross-Development
    Facility
Rational Universal Host Training: MC68020/OS-2000 Cross-Development
    Facility

The training software for the following course is not available now.
(The plan is for it to be included in the next release.)

Rational Universal Host Training: MC68020/UNIX Cross-Development
    Facility

Most of the training software in this release is unchanged from the
Delta 1 release.  Most of the release world names and file names still
refer to Delta 1.  This software works correctly under Delta 2.  This
release note and installation procedure includes the information you
need to install the software and build training users.

Because this release of the training software is intended to be included
in an environment release, all links to layered software have been
removed.  (This does not effect training user accounts, which must be
built after the layered software is installed.)  The procedures
describing preparing to build training user accounts for individual
courses included later in this document tell you how to add links when
needed.


INSTALLING THE TRAINING SOFTWARE FROM TAPE

If this training software has not been installed as part of an
Environment installation, restore it from tape using

    Archive.Restore (Options => "Changed_Objects, Promote");


LOCATING THE TRAINING SOFTWARE FOR A COURSE

The following list gives the directory or directories in
!Training.Software_Releases that contains the training software for each
course:

Rational Environment Training: System Management
        System_Management

Rational Environment Training: Fundamentals
        Fundamentals

Rational Environment Training: Advanced Topics
        Advanced_Topics

Rational Environment Training: Subsystems and Configuration Management
        Subsystems_Cmvc

Rational Environment Training: Project Development Methods
        Pdm

Rational Environment Training: Toolsmithing
        Toolsmithing

Rational Network Training
        Networking

Rational Design Facility Training: DOD-STD-2167
        Design_Facility_User_Training

Rational Design Facility Training: DOD-STD-2167 Product Customization
        Design_Facility_Customization_Training

Rational Design Facility Training: Fundamentals and DOD-STD-2167A
        Design_Facility_Fundamentals
        Design_Facility_2167a_User

Rational Design Facility Training: Toolsmithing and DOD-STD-2167A
    Customization
        Design_Facility_Toolsmithing
        Design_Facility_2167a_Customization

Rational Universal Host Training: MC68020/Bare Cross-Development
    Facility
        Cdf_Mc68020_Bare

Rational Universal Host Training: MC68020/OS-2000 Cross-Development
    Facility
        Cdf_Mc68020_Os2000

Each of these directories contains a release world with the procedure to
build training user accounts.  The release world also contains the data
and index files that are the archive of the master training user home
world that the procedure uses to create the home world for each training
user.  The release world may also contain additional notes to the
instructor and other software required for training.  Some directories
also contain utility worlds with units used by the training software.


PREPARING TO BUILD TRAINING USER ACCOUNTS

Read the preface to the course's instructor's notes, if any.  Also read
relevant files in !Training.Notes.Release_Notes and in the course's
training software world(s), if any.  Review relevant instructor notes,
including those for the introductory course material and the exercises.

Assure that the correct layered software is installed and running.

The Design Facility user courses require additional preparation.

For Rational Design Facility Training: DOD-STD-2167, add a link for the
release world as follows:

    Links.Add  
       (Source   => "!Tools.Design.Release.Rational_2167" &
                       ".Pdl_Commands.Rev6_0_Spec.Units.Design",
        Link     => "#",
        World    => "!Training.Software_Releases" &
                       ".Design_Facility_2167_User_Training.Delta1_Rev6",
        Response => "<PROFILE>");

Now code the body of Build_Design_Facility_User_Training_Users in the
release world.

For Rational Design Facility Training: Fundamentals and DOD-STD-2167A,
copy links for the nested world that contains the implementation of the
simple Design Facility instance used in the Fundamentals part of the
course.

    Links.Copy  
       (Source_World => "!Model.R1000_Pdl",
        Target_World =>  
           "!Training.Software_Releases.Design_Facility_Fundamentals" &
              ".Rev1.Simple_Instance",
        Link         => "@",
        Source       => "[!Tools.Design?,!Tools.Lrm?]",
        Kind         => Links.Any,
        Response     => "<PROFILE>");

Now code all units in the world.

    Compilation.Promote  
       (Unit  =>  
           "!Training.Software_Releases.Design_Facility_Fundamentals" &
              ".Rev1.Simple_Instance??",
        Scope => Compilation.All_Parts,
        Goal  => Compilation.Coded,
        Limit => "<WORLDS>");

Finally, run the Register_Pdl procedure in this world.


BUILDING TRAINING USER ACCOUNTS

Run the Build_Training_Users (or Build_..._Training_Users) procedure in
the release world.  (If you need to destroy existing training users
before you build new ones, use the Destroy_Users procedure in 
!Training.Tools.Utilities.)  Some Build_..._Training_Users procedures
take over 30 minutes, so be sure to allocate enough time to build all
users before the class.  Some release worlds contain Log text files with
typical build logs or lists of acceptable errors and warnings.


USING SCRIPT TOOLS

If you will use the scripts tools for Rational Environment Training:
Fundamentals, see !Training.Notes.Instructor_Notes.


OVERRIDING SESSION LIMITS

If you need to run more sessions for training than your customer has
authorized, get a training authorization code from SMSE and run the
Training_Authorization procedure in !Training.Tools.  Send mail to
SMSE_Req requesting the code.  You must include the date you will
execute the Training_Authorization procedure and the ID of the machine
you will execute it on.  SMSE will reply with an Authorization_Code and
an Expiration_Date.  You must run the Training_Authorization procedure
on that date with that code.

When training is over, reboot the machine or run Training_Authorization
with the Enable parameter False to reinstitute the session limits.
Destroy codes after use.  Do not disclose authorization codes to
customers.  Do not draw the customer's attention to the the existence of
the Training_Authorization procedure.
DataMuseum.dk

Rational R1000/400

⟦7189b0c91⟧ TextFile

Derivation

TextFile
