File Name
README.md


Jan 26, 1985
README.1ST

Table of Contents:

New Information for all users . . . . . . . . . . 1

Information for RT-11, Version 4 Users . . . . . 2

Information for RSTS Users . . . . . . . . . . . 3


NEW INFORMATION

At the end of each subdevice description, the number of
files and their sizes is given. The sizes of the subdevices
(which are generally 8 blocks larger to include the directory),
can be determined from the RT-11 directory of the whole tape.
Wherever possible, subdevices have been created with only one
directory segment, to reduce the size.

This RT-11 SIG swap tape, as the others done in the recent
past, has been built using a subdevice file system. The virtual-
device system allows an RT-11 file to be accessed as a separate
device. A virtual-device system was described in a paper by Jim
Crapuchettes on page 639 of the DECUS proceedings for Fall 1979.

This file will explain how the submissions contained on the
swap tape can be transferred to other host systems. Now that RT-
11, Version 5 has the LD (logical disk) handler, files may be
easily broken down after they have been copied from the tape.
This is done by typing the KMON command

MOUNT LDn FILE.DSK.

Files within the subdevice FILE.DSK can then be copied.


Page 2


RT VERSION 4 INFORMATION

If you are using RT-11, Version 4, you will need to use the
subdevice handler XD, which is on the front of this tape, or any
other subdevice handler you may have. If you have a system that
does not have error logging, and timeout support, you may use the
distributed versions of the XD subdevice handler. If you have any
of those SYSGEN options, then you will have to build the system to
suit your environment. The files to build a new version of XD are
contained in the file XD.DEV.

There are two ways to pull files from this tape. The tape
has been built so that each submission is no larger than a single
density floppy. The first way to pull off a submission is as fol-
lows:

COPY/DEV/FILE MT:XXXXXX.DSK DX:

The above command will transfer the submission XXXXXX.DSK from the
magnetic tape and place it on a single-density floppy. The floppy
will have a regular RT-11 directory and will be usable as an RT-11
device, except that if the subdevice file was smaller than 494
blocks, the floppy capacity will also appear to be less than 480
blocks.

If you do not have floppies, or you want to take advantage of
the virtual-device system, the procedure is a little more complic-
ated. If you cannot use the distributed system, you will have to
build the virtual-device system first.

INSTALLING THE VIRTUAL-DEVICE SYSTEM

The virtual-device system requires that two files be present
on your system device in order to operate. They may be installed
by typing:

COPY/SYS XD.SYS,XDATCH.SAV SY:
INSTALL XD
LOAD XD

Now we are ready to use the virtual-device system.

ATTACHING TO A VIRTUAL-DEVICE FROM THE SWAP TAPE

First of all you need to copy the virtual-device file from
the magnetic tape to a working disk using PIP.

COPY MT:XXXXXX.DSK DK:

Now we need to attach to the virtual-device using the program
XDATCH.


R XDATCH
*XXXXXX=XD0:
*^C

The virtual-device XD0: is now attached and can be accessed as a
disk device using regular RT-11 commands like DIR. DIR XD: will
print a directory of the virtual-device.

There is more complete documentation on the virtual-device
system in the file XD.DOC on the swap tape.


Page 3


RSTS/E USERS

The file VIRTUL.BAS on this tape (a submission of E. F.
Beadel, SUNY at Oswego, Oswego, NY), will allow subdevice files to
be read by RSTS systems. Needless to say, it is not located in a
subdevice file. It can be used to break down RT-11 subdevice
files after they have been copied from tape to disk. There is a
description and instruction section at the beginning of the
VIRTUL.BAS file.

If RSTS users have any trouble or questions about the usage
of this file, please direct your questions to Mr. Beadel.