mirror of
https://github.com/PDP-10/stacken.git
synced 2026-02-18 13:26:56 +00:00
232 lines
6.1 KiB
Plaintext
232 lines
6.1 KiB
Plaintext
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
Guide to Useing the "FE" Device
|
||
|
||
|
||
|
||
|
||
|
||
File: USEFE.RNO
|
||
Date: 15-Mar-77
|
||
|
||
|
||
|
||
|
||
|
||
|
||
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY ONLY BE USED
|
||
OR COPIED IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE.
|
||
|
||
COPYRIGHT (c) DIGITAL EQUIPMENT CORPORATION 1977,1986.
|
||
ALL RIGHTS RESERVED.
|
||
Guide to Using the "FE" Device Page 2
|
||
|
||
|
||
*** CAUTION ***
|
||
|
||
The "FE" device is intended for use only
|
||
in software updating and development
|
||
procedures by knowledgeable people. Use
|
||
without proper caution may produce
|
||
unpredictable results.
|
||
|
||
|
||
|
||
OVERVIEW
|
||
|
||
The "FE" device is used from the -11 to transfer files to and from the
|
||
TOPS-10 file system. Usually it is accessed through the use of -11
|
||
PIP, using device "FE:" as if it were a FILES-11 device.
|
||
|
||
|
||
FILE FORMAT
|
||
|
||
Two file formats on the TOPS-10 file system are supported: 16-bit
|
||
binary files (in 18-bit bytes) and 7-bit ASCII files. The format of a
|
||
particular file is determined by the file mode and/or the file type.
|
||
If the file mode is 10(.IOIMG) the file is assumed to be in 16-bit
|
||
binary format. If the byte-size is neither 18 nor 7, the file type is
|
||
checked to determine the format. File types .ABS, .BIN, .EXB, .LDA,
|
||
.MCB, .OBJ, .OLB, .SML, .STB, .SYS, and .TSK are assumed to be 16-bit
|
||
binary format, all others are taken to be 7-bit ASCII files and the
|
||
proper swapping of bytes is performed during transfers.
|
||
|
||
|
||
RSX FORMAT FILE CONVERSION
|
||
|
||
Files used by the standard RSX tasks are required to be
|
||
record-formatted, while their counterparts on the TOPS-10 file system
|
||
do not. This applies to all ASCII text files (which must be in
|
||
formatted ASCII) and to formatted binary files, notably .EXB, .MCB,
|
||
.OBJ, .OLB, .SML, and .STB types. A program called "RSXT10" was
|
||
developed to do the necessary conversions, both to RSX format and back
|
||
to DOS/TOPS-10 format. RSXT10 prompts by typing "RSXT10>" to which
|
||
the user responds with the desired command. All commands to REST10
|
||
are described in RSXFMT.HLP, which can be invoked by the HELP command
|
||
to RSXT10.
|
||
|
||
The default conversion mode for the file is determined from the file
|
||
type and the first data word in the file. Note that RSX formatted
|
||
files and binary files are written in file mode 10(.IOIMG) to insure
|
||
binary transfer mode. Also note that all files read by KLDCP are not
|
||
read in record mode, and thereby do not require conversion. An
|
||
example of converting a group of files to RSX format:
|
||
|
||
.R RSXT10
|
||
RSXFMT>CONVERT DEV:[P,PN]INPUT.FIL DEV:[P,PN]OUTPUT.FIL
|
||
DEV:[P,PN]INPUT.FIL[7-BIT-ASCII]==>DEV:[P,PN]OUTPUT.FIL[RSX-ASCII]
|
||
RSXFMT>
|
||
Guide to Using the "FE" Device Page 3
|
||
|
||
|
||
GETTING THE SYSTEM STARTED
|
||
|
||
The program "FE" must be running on the TOPS-10 system. If it is not
|
||
already running, it can be started by typing the following under [1,2]
|
||
(probably under OPSER):
|
||
|
||
.R FE
|
||
|
||
The "FE" program should now be running and is waiting for a request
|
||
from the "FE" device from the -11. The next step is to mount the "FE"
|
||
device from the -11 such that files can be accessed using it. This
|
||
requires that the file "T20ACP.TSK" be present on the -11 file system.
|
||
"FE" can be mounted using the Consol Command Parser at the console
|
||
terminal by typing:
|
||
|
||
^ (Control-Backslash)
|
||
PAR>MCR MOU
|
||
MOU>FE:
|
||
MOU -- MOUNT COMPLETE
|
||
MOU>^Z (Control-Z)
|
||
|
||
|
||
ADDRESSING TOPS-10 FILES
|
||
|
||
All files on the TOPS-10 file system may be accessed from the -11.
|
||
|
||
The FE program reads a file called FEUIC.TXT when it is started which
|
||
determines the mapping from TOPS-10 directories to UIC's on the -11.
|
||
The format of each line of this file is as follows:
|
||
|
||
[grp,usr]=str:[p,pn,sfd1,sfd2...]
|
||
|
||
where:
|
||
|
||
[grp,usr] is the UIC on the -11.
|
||
|
||
str: is a file structure name, or "DSK:" for the search list for the
|
||
job running the FE program. If this field is absent, all
|
||
structures will be searched.
|
||
|
||
[p,pn,sfd1,sfd2...] is the TOPS-10 directory name.
|
||
|
||
FEUIC.TXT may exist on DSK: or SYS:.
|
||
|
||
Files are merely referenced by file name. Note that generation
|
||
numbers on the -11 are in octal, and are punctuated by a ";".
|
||
|
||
|
||
USING -11 PIP
|
||
|
||
-11 PIP is used in almost all transfers through the "FE" device. PIP
|
||
can be requested through the Console Command Language using the "MCR
|
||
PIP" command. The following basic commands can be used to list and
|
||
transfer files:
|
||
Guide to Using the "FE" Device Page 4
|
||
|
||
|
||
To list a TOPS-10 directory on device DEV:
|
||
|
||
PIP>dev:FE:[uic]file.typ;nnn/LI (or /BR or /FU)
|
||
|
||
Example:
|
||
|
||
PIP>FE:[5,5]/BR
|
||
|
||
DIRECTORY FE0:[5,5]
|
||
4-JAN-75 00:35
|
||
|
||
QFC.LST
|
||
QFC.MAC
|
||
QFC.MAC
|
||
QFC.MAC
|
||
QFC.OBJ
|
||
QFC.OBJ
|
||
QFC.OBJ
|
||
|
||
PIP>
|
||
|
||
To copy a file to the -11 file system:
|
||
|
||
PIP>dev:[uic]*FE:[uic]file.typ;nnn/NV
|
||
|
||
Example:
|
||
|
||
PIP>DT1:FE=:[10,20]QFC.*/NV
|
||
PIP>
|
||
|
||
To copy a file from the -11 file system:
|
||
|
||
PIP>FE:[uic]=dev:[uic]file.typ
|
||
|
||
Example:
|
||
|
||
PIP>FE:[10,20]*.NEW=[120,10]*.BIN
|
||
PIP>
|
||
|
||
To delete a file:
|
||
|
||
PIP>dev:[uic]file.typ;nnn/DE
|
||
|
||
Example:
|
||
|
||
PIP>DB0:QFC.MAC;*/DE
|
||
PIP>FE:[10,20]*.*/DE
|
||
PIP>
|
||
|
||
dev- is an -11 device which is mounted. If absent, SY: the (system
|
||
device) is assumed for files, TT: (the control terminal) for
|
||
directory listings. [uic] is optional and defaults to [5,5]. /NV
|
||
(New Version) is recommended in transferring files. To exit from PIP,
|
||
type ^Z (Control-Z).
|
||
Guide to Using the "FE" Device Page 5
|
||
|
||
|
||
TERMINATION OF "FE" DEVICE
|
||
|
||
When all the desired files have been transferred, the "FE" device
|
||
should be dismounted to free up system resources in use. Dismounting
|
||
the "FE" device is done by typing at the console terminal:
|
||
|
||
^ (Control-Backslash)
|
||
PAR>MCR DMO
|
||
DMO>FE:
|
||
DMO -- DISMOUNT COMPLETE
|
||
DMO>^Z (Control-Z)
|
||
|
||
|
||
|
||
[End of USEFE.MEM]
|