Digital PDFs

DEC-XV-UUPDA-A-D-1

December 1975

34 pages

Original

9.2MB

Document:	Update XVM Utility Manual
Order Number:	DEC-XV-UUPDA-A-D
Revision:	1
Pages:	34
Original Filename:	http://bitsavers.org/pdf/dec/pdp15/XVM/DEC_XV_UUPDA-A-D-UPDATE_XVM_UTILITY_MANUAL.pdf

OCR Text

UPDATEXVM
UTILITY MANUAL
DEC-XV-UUPDA-A-D

digital equipment corporation • maynard. massachusetts

First Printing, December 1975

The information in this document is subject to change without notice
and should not be construed as a commitment by Digital Equipment
Corporation. Digital Equipment Corporation assumes no responsibility
for any errors that may appear in this document.
The software described in this document is furnished under a license
and may be used or copied only in accordance with the terms of such
license.
Digital Equipment Corporation assumes no responsibility for the use or
reliability of its software on equipment that is not supplied by
DIGITAL.

(S) 1975 by Digital Equipment Corporation

The postage prepaid READER'S COMMENTS form on the last page of this
document requests the user's critical evaluation to assist us in preparing future documentation.

The following are trademarks of Digital Equipment Corporation:

DIGITAL
DEC
PDP
DECUS
UNIBUS
COMPUTER LABS
COMTEX
DDT
DECCOMM

DECsystem-10
DEC tape
DIBOL
EDUSYSTEM
FLIP CHIP
FOCAL
INDAC
LAB-8

MASSBUS
OMNIBUS
OS/8
PHA
RSTS
RSX
TYPESET-8
TYPESET-10
TYPESET-ll

CONTENTS

PREFACE

vii

CHAPTER 1

INTRODUCTION

1-1

1.1

GENERAL DESCRIPTION

1-1

1.2

REFERENCE MATERIAL

1-2

1.3

SPECIAL SYMBOLS

1-2

UPDATE COMMANDS AND OPERATIONS

2-1

2.1
2.1.1
2.1. 2
2.1. 3

LOADING PROCEDURE
I/O Device Assignments
Calling UPDATE
CTRL Character Commands

2-1
2-1
2-1
2-2

2.2
2.2.1
2.2.1.1
2.2.1.2
2.2.1.3
2.2.2
2.2.2.1
2.2.2.2
2.2.2.3
2.2.2.4
2.2.2.5
2.2.3
2.2.3.1
2.2.3.2

COMMAND DESCRIPTIONS
File Specification Commands
Options
Filename
Command Terminator
Manipulative Commands
DELETE (D) Command
REPLACE (R) Command
INSERT (I) Command
FREE (F) Command
END (E) Command
UPDATE Termination Commands
CLOSE (C) Command
KILL (K) Command

2-2
2-2
2-2
2-5
2-5
2-5
2-5
2-6
2-6
2-6
2-7
2-7
2-7
2-7

CHAPTER 3

ERROR CONDITIONS AND RECOVERY

3-1

CHAPTER 4

EXAMPLES USING UPDATE

4-1

CHAPTER 2

INDEX-1

INDEX

iii

FIGURES

Page
Figure 1-1
2-1

UPDATE'S I/O Devices and Files
Format of Listing File Output

1-2
2-4

TABLES
Page
Table

2-1
3-1

Legal Option/Command Combinations
Update Error Messages

2-3
3-2

LIST OF ALL XVM MANUALS

The following is a list of all XVM manuals and their DEC numbers, including the latest version available.

Within this manual, other XVM

manuals are referenced by title only.

Refer to this list for the

DEC numbers of these referenced manuals.
BOSS XVM USER'S MANUAL

DEC-XV-OBUAA-A-D

CHAIN XVM/EXECUTE XVM UTILITY MANUAL

DEC-XV-UCHNA-A-D

DDT XVM UTILITY MANUAL

DEC-XV-UDDTA-A-D

EDIT/EDITVP/EDITVT XVM UTILITY MANUAL

DEC-XV-UETUA-A-D

8TRAN XVM UTILITY MANUAL

DEC-XV-UTRNA-A-D

FOCAL XVM LANGUAGE MANUAL

DEC-XV-LFLGA-A-D

FORTRAN IV XVM LANGUAGE MANUAL

DEC-XV-LF4MA-A-D

FORTRAN IV XVM OPERATING ENVIRONMENT MANUAL

DEC-XV-LF4EA-A-D

LINKING LOADER XVM UTILITY MANUAL

DEC-XV-ULLUA-A-D

MACll XVM ASSEMBLER LANGUAGE MANUAL

DEC-XV-LMLAA-A-D

MACRO XVM ASSEMBLER LANGUAGE MANUAL

DEC-XV-LMALA-A-D

MTDUMP XVM UTILITY MANUAL

DEC-XV-UMTUA-A-D

PATCH XVM UTILITY MANUAL

DEC-XV-UPUMA-A-D

PIP XVM UTILITY MANUAL

DEC-XV-UPPUA-A-D

SGEN XVM UTILITY MANUAL

DEC-XV-USUTA-A-D

SRCCOM XVM UTILITY MANUAL
UPDATE XVM UTILITY MANUAL
VP15A XVM GRAPHICS SOFTWARE MANUAL

DEC-XV-USRCA-A-D
DEC-XV-UUPDA-A-D
DEC-XV-GVPAA-A-D

VT15 XVM GRAPHICS SOFTWARE MANUAL

DEC-XV-GVTAA-A-D

XVM/DOS KEYBOARD COMMAND GUIDE
XVM/DOS READER'S GUIDE AND MASTER INDEX

DEC-XV-ODGIA-A-D

XVM/DOS SYSTEM MANUAL

DEC-XV-ODSAA-A-D

XVM/DOS USERS MANUAL

DEC-XV-ODMAA-A-D

XVM/DOS VIA SYSTEM INSTALLATION GUIDE

DEC-XV-ODSIA-A-D

XVM/RSX SYSTEM MANUAL

DEC-XV-IRSMA-A-D

XVM UNICHANNEL SOFTWARE MANUAL

DEC-XV-XUSMA-A-D

DEC-XV-ODKBA-A-D

PREFACE
This manual describes the operation and use of the UPDATE XVM (UPDATE)
Utility Program.
In this manual, it is assumed that the reader is familiar with the
XVM/DOS system and the contents of the XVM/DOS User's Manual.
Applicable XVM/DOS manuals useful in understanding and using UPDATE
are the following:
XVM/DOS Users Manual
XVM/DOS Keyboard Command Guide
Linking Loader XVM Utility Program Manual
MACRO XVM Assembly Language Manual

vii

CHAPTER 1
INTRODUCTION

1.1

GENERAL DESCRIPTION

The UPDATE XVM (UPDATE) Program provides users with the ability to
create, examine and revise the binary library files of the XVM/DOS
Monitor System.

A library file is defined as any file containing one

or more relocatable binary programs.

The XVM/DOS Monitor's .LIBR BIN

files, which contain the FORTRAN IV Qbject !ime ~ystem (OTS) routines,
reside in the BNK and PAG System User File Directory (UFD).
UPDATE alters files by performing replacement, deletion, or insertion
operations.

It can also be used to create new library files, list

the contents of libraries, and copy programs out of libraries for use
as individual files.

Figure 1-1 shows the functional relationship of

UPDATE to its input and output files.

Library creating and updating

functions are performed by the creation of a new file from programs
copied, on command, from either primary (original file) or secondary
(new programs) input devices to the output device.
on the primary input device is never altered.
of programs contained in the library

1-1

The original file

A listing of the names

can also be obtained.

Introduction

.DAT -14

.DAT -2 & -3

.DAT -10

Primary input
(library to
be altered)

Console teleprinter (command input
and response)

Secondary input
(programs for
insertion or
replacement)

Listing
output

Library File
Output

.DAT -12

.DAT -15

Figure 1-1
UPDATE's I/O Devices and Files

1.2

REFERENCE MATERIAL

The following manuals also contain information useful in understanding
and using UPDATE:
XVM/DOS Users Manual
XVM/DOS Keyboard Command Guide
Linking Loader XVM Utility Program Manual
MACRO XVM Assembler Language Manual
1.3

SPECIAL SYMBOLS

Special symbols, when used in this manual, are defined as follows:
SYMBOL

REPRESENTS
Carriage RETURN - LINE FEED operation
TAB
SPACE

[ ]

Optional Command String elements

1-2

CHAPTER 2
UPDATE COMMANDS AND OPERATIONS
2.1

LOADING PROCEDURE

2.1.1

I/O Device Assignments

As shown in Figure I-I, UPDATE uses up to six .DAT slots.

.DAT slots

-2 and -3 are used by the console teleprinter and cannot be reassigned.
The .DAT slots required by UPDATE vary with the type of operation being
performed.

For example, if a new library is to be created, only .DAT

slots -10 (secondary input) and -15 (library file output) need be
assigned.

If a listing is also desired, then .DAT -12 must also be

assigned.

Similarly, if an update operation is to be performed where

no programs are added and no listing is desired, then only .DAT -14
(primary input) and .DAT -15 (library file output) need be considered.
Because UPDATE uses the system macro .FSTAT to determine the existence
or nonexistence of a named file, it is generally required that the
A- version device handler be used, e.g., DTA.

If only one file is to

be open on DECtape, DTE or DTD may be used instead of DTA.
2.1.2

Calling UPDATE

Once the proper .DAT slot assignments have been made, UPDATE can be
called by typing UPDATE) after the Monitor's $.

When loaded, UPDATE

identifies itself on the console teleprinter as follows:
UPDATE XVM Vnxnnn
>

and waits for a command from the user as described below.

2-1

UPDATE Commands and Operations

2.1.3

CTRL Character Commands

UPDATE can be restarted at any time by typing CTRL/P. The current
operation, of course, is aborted.
CTRL/C also unconditionally
terminates UPDATE operations but returns the user to Monitor control.
2.2

COMMAND DESCRIPTIONS

UPDATE's keyboard commands are divided into three functional categories
as follows:
a.

File Specification Commands

Manipulative Commands

Termination Commands

2.2.1

File Specification Commands

The first command to UPDATE each time it is loaded or restarted must
be a file specification command.

These commands specify the type of

operations to be performed and the name of the file to be examined,
modified, or created.
is:

The general form of the Command String format

OPTION + - FILENAME
DESIGNATOR

TERMINATOR

Sections 2.2.1.1, 2.2.1.2 and 2.2.1.3 describe the command string
elements.
2.2.1.1

Options - The following paragraphs describe the options

provided by UPDATE.

Each option is specified in the command string

by a single letter designator:

Table 2-1 shows legal Option/Command

combinations.

2-2

UPDATE Commands and Operations

Table 2-1
Legal Option/Command Combinations

COMMANDS
Options 1

INSERT

DELETE

REPLACE

U[LS]

N[LS]

FREE

G[LS]

END

KILL

IThe S command is not logically useful by itself.

U Option

This option permits the updating of an existing
library file by the deletion, insertion and replacement of the programs within it.

The file to be

upated resides on the device assigned to .DAT -14;
programs to be inserted must be on .DAT -10; and the
updated file is output to .DAT -15.
N Option

This option permits a new library file to be created
The
from programs residing on the • OAT -10 device.
new library is output to . OAT -15 •

s Option

The S Option causes UPDATE to remove the local
symbol table from each program placed in the output
file.

This process shortens the length of a file by

as much as 40 %, thus conserving storage space and
reducing library search time during loading.

Non-

library programs will occupy less memory when loaded
with DDT XVM, since there will be no symbol table to
load.

(This is irrelevant for library programs

because the Linking Loader and DDT do not load their
local symbol tables.

The single disadvantage of this

option is that the removal of the symbol table precludes symbolic debugging with DDT and DDT's operation is then similar to DDTNS.

2-3

UPDATE Commands and Operations

L Option

This option lists the contents of the new or updated
library output to .DAT -15 on the device assigned
to .DAT -12.

If no other options are selected, a

listing of the named library residing on the primary
input device (.DAT -14) can be obtained.
of the listing is shown in Figure 2-1.

The format
The first

column of the listing contains the program name.

The

second column contains the source extension and is
output only for programs assembled under the MACRO
XVM Assembler (which outputs loader code 338 for this
purpose).

The third column specifies the size (in

octal) of each program.

The last column contains the

command line echo of all Manipulative Commands
issued, thus providing a complete log of the current
updating operations.
G Option

This option primes UPDATE to accept the FREE Manipulative Command, which allows individual programs
to be extracted from libraries as separate files.

PAGE n

LIBRARY FILE LISTING FOR file name
PROGRAM
NAME

SOURCE
EXTENSION

PROGRAM
SIZE

NAME 2

EXT2

NAME 2

EXT2

104

EXT4

423

ACTION
REPLACE NAMEl,NAME2

INSERT NAME4

Figure 2-1
Format of Listing File Output

2-4

UPDATE Commands and Operations

2.2.1.2

Filename - A filename consists of any combination of from 1

to 6 alphanumeric characters.

The filename extension is always assumed

to be BIN.
If no filename is specified, the name .LIBR BIN is assumed
by the program.
Command Terminator - Either a Carriage RETURN (.J) or an

2.2.1.3

ALT MODE keyboard entry is used to terminate the file specification
command.

If a

~ terminator is used, control is returned to the

UPDATE program when work on the named file is complete.

If an ALT

MODE terminator is used, control is returned to the Monitor when
updating of the named file is complete.
2.2.2

Manipulative Commands

After acceptance of a file specification command, UPDATE indicates its
readiness to accept commands for the manipulation of the contents of
the named file by typing a

> •

In responding to the commands described below, UPDATE operates on
library files in a sequential, program-by-program manner.
always begins at the beginning of the file
the first manipulative command).

Processing

(prior to the issuance of

All programs in a file, which are

not deleted or replaced, are copied into the output file automatically.
The input file is never altered.

The user should exercise care in

issuing these commands, since UPDATE has no provision for "backing
up" in a file to manipulate a program already passed by.

The user,

therefore, should first obtain a listing (L option followed by a CLOSE)
of the file before he attempts to modify it.
The five manipulative commands, DELETE, REPLACE, INSERT, FREE and
END, are described in Sections 2.2.2.1 through 2.2.2.5.
2.2.2.1

DELETE (D) Command - The D command causes the deletion of a

named routine or a series of routines from the specified file.

series is specified by typing the names of the first and last routines
of the series.

The deletion is carried out by copying all the routine

or file elements in the file up to the deleted routines into the output file and then positioning the input file just before the program
which follows the last routine deleted.
Form:

D[ELETE]~progl[,prog2]

2-5

UPDATE Commands and Operations

The DELETE command may be used only when the U option has been requested in a file specification command.
2.2.2.2

REPLACE (R) Command - The R command causes programs in the

original file to be replaced by new programs on the secondary input
device.

All of the programs in the original file, up to the element

or routine to be replaced, are copied onto the output device.
new program(s)

The

(replacement) is then copied onto the output file from

a secondary input device.

Upon completion, the output file is posi-

tioned immediately after the replaced routine.
If one program name is specified, UPDATE replaces the named program
with a new program having the same name.

If two program names are

specified, the program with "namel" is replaced by the program with
.--. ~.

"name2".
Form:

R[EPLACE]~namel[,name2]

The REPLACE (R) command may be used only when the U option has been
specified in a file specification command.
2.2.2.3

INSERT (I) Command - The I command directs UPDATE to insert

programs contained on the secondary input device, at any point, into
the original file as it is copied onto the output file device.

completion of an insert operation, the output file is positioned at a
point immediately after the inserted program.

If one name is used

in the command, the named program is inserted into the file at the
current position.

If two names are specified, the "namel" program

is inserted into the file after the program specified by "name2".
Form:

I[NSERT]~name[,name2]

The I command with two names is used only when the U option has been
previously specified in a file specification command.

The I command

with only one name can be used when either the U or N option has been
given.
2.2.2.4 FREE (F) Command - The F command directs UPDATE to free or
extract a named program from the library file named in a G option file
specification command.

The extracted program is transferred to the

output device as a file of the same name.

2-6

UPDATE Commands and Operations

Form:

F[REE]~name

The F command is legal only when a G option has been previously specified in a file specification command.
2.2.2.5

END (E) Command - The END command causes the output file to

be positioned at the end of the final routine of the original file.
All remaining programs in the original file, beginning at its current
position, are copied into the output file.

The END command is a con-

venient method of positioning the file to be modified in order that
new routines from the secondary input may be appended to the file
via the INSERT (I) command.
Form:

E[ND]

The END command is logically useful only when the U option has been
specified.
2.2.3

UPDATE Termination Commands

2.2.3.1

CLOSE (C) Command - The C command is the normal terminator

for any of UPDATE's operations.

When used with the U option, it

causes all of the remaining programs in the primary input file to be
copied onto the output file starting at the current position of the
file.

When used with the Nand L options, the C command closes the

output file and completes the output of the listing file.

If a file

name is not specified with this command, the output file is given the
name originally specified in the last file specification command.
Form:
2.2.3.2

C[LOSE] ~ [filname]
KILL (K) Command-The KILL command can be entered whenever

UPDATE is awaiting command input and a file has been opened.

When a

new library file is being created (N option) or an old one updated
(U option) and the KILL command is typed, the effect is as if all
transactions prior to opening the file had not happened.
tions, deletions, or replacements are nullified.

Any inser-

When a library file

is opened, using the G option, and files are created from it using
the FREE command, typing KILL does not delete the FREEd files, but
it does close the library input file.

2-7

To indicate that UPDATE has

UPDATE Commands and Operations

restarted after a KILL command, it re-identifies itself on the terminal,
i.e.,
UPDATE XVM Vnxnnn
>

and awaits further command input.
Form:

K[ILL]

2-8

CHAPTER 3
ERROR CONDITIONS AND RECOVERY
UPDATE performs comprehensive error checking to assure the integrity
of the input and output files as well as correctness of operator command strings.

The program contains a large repertoire of messages

to specifically identify the nature of the error.

Table

3-1

lists all of UPDATE's error messages accompanied by an explanation
of each and appropriate recovery procedures.

The general rule for

recovery, particularly when an incorrect option was selected or an
unintentional end of library file occurred, is to type CTRL/P to
restart UPDATE; then issue a new command string.
also be printed (e.g., IOPS4 for Line Printer).

3-1

lOPS messages may

Table 3-1
Update Error Messages
Message
FILE NOT FOUND
COMMAND IGNORED

END OF FILE FOUND
FILE POSITIONING COMPLET,
PGM UNIT NOT FOUND

Meaning
The file named in an R or I command
could not be found on the directoried
device assigned to .DAT -10.

The device assigned to .DAT -10 is
nondirectoried.
In attempting to
perform an R or I command, UPDATE
encountered either an end-of-file
or an end-of-medium indicator in
its first read to that device.

Recovery
Check that the device is
properly assigned and that
the desired file is contained
therein.
Check that the paper tape is
correctly positioned in the
input device. With paper
tape, this error can easily
occur if one forgets to load
the paper tape reader.

o
t-1

::l

1-'-

::l

I
tv

i:':I
t-1
t-1

EOF REACHED BY SEARCH
COMMAND IGNORED

The program named in an F command
was not found in the library.

Check that the name specified
in the F command is correct
and that the library does
indeed contain the desired
program (use L command to
examine library).

::l

n.
~

o
<:
CD

t-1

END OF FILE FOUND

The program named in an F command
did not contain a .END statement.
The library is contaminated.

Obtain another copy of the
library file and try again.

UNRECOVERABLE READ ERROR ON
.DAT -In - DYNAMIC KILL
where, n=~ or 4

A checksum, parity or buffer overflow error was detected (via the
logical record header word 1) while
reading from the specified input
device.

Obtain another version of the
offending file and try
again.

Table 3-1 (Cont.)
UPDATE Error Messages
Message
NAMED FILE ALREADY ON OUTPUT
DEVICE
DO YOU WISH TO CONTINUE (yiN)

Meaning
The program name specified in an
F or C command is the same as that
of a file residing on the .DAT -15
(output) device.

w
I

Recovery
If a Y is typed, UPDATE
replaces the file on the
current file.
If Y is not
typed, UPDATE will respond
with COMMAND IGNORED. The
user may then type any other
command, presumably a CLOSE
command with another filename, or abort execution of
UPDATE and return control
to the Monitor.
If the
latter is done, the updated
file will be present on the
output device with the filename extension WRK.

t!l
11
11

n
o

::l

0..

f-' -

r!1-' -

::l

C1l

NOT A COMMAND

unrecognizable command.

Retype the command.

::l

0..

::tI

A DELETE or REPLACE or an INSERT
command (with 2 arguments) was
issued prior to selecting the
U option.

Issue a new command string
and select the U option.

VALID ONLY WITH U OR N MODE
COMMAND IGNORED

An INSERT command was issued but
neither the U nor the N option had
been selected.

Issue a ne'l,l7 command string
and select either the U or the
N option as desired.

VALID ONLY IN GET MODE
COMMAND IGNORED

A FREE command was issued but the
G option had not been selected.

Issue a new command string and
select the G option.

VALID ONLY IN U ~10DE
COMMAND IGNORED

()

o
<:

Table 3-1 (Cont.)
UPDATE Error Messages
Message

Meaning

-+-------

Recovery

BUFFER OVERFLOW - DYNAMIC
KILL

The current operation caused an
overflow of UPDATE's internal
(free memory) buffer.

Return to the Monitor and
assign smaller device handlers to provide more free
memory.

ILLEGAL CO~lliAND STRUCTURE
COMMAND IGNORED

No program name specified
after INSERT, DELETE, REPLACE,
or FREE command.

Retype command using program
name.

BAD SECONDARY INPUT -DYNAMICKILLI A data error was detected during
input from .DAT -10.

tz:I

11
11

Locate and correct the error;
then try again.

n
o
::sp.

.....
.....

rt
W
I

BAD DATA - NO PROGRAM NAME

"'"

The file being read from the .DAT
-10 device does not contain a
program name (loader code 23).

Check that the .DAT -10 device is the correct device
and that the desired input
file is there.
If the above
checks correctly, the file
must be reassembled.

o
::s
rn

III

::sp.
~

o
o
<:

(J)

PROGRAM NAME MISSING - DYNAMIC
KILL

In performing a search through the
library on the .DAT -14 device,
the end of file was reached but no
program name (loader code 23) could
be found.

Check that the .DAT -14 device is correctly assigned and
that the desired input file is
there.
If the above checks
correctly, then the library
file is contaminated and
must be reconstructed.

Table 3-1 (Cont.)
UPDATE Error Messages

Message
PROGRAM NAME DISCREPANCY
FILENAME -- filename
PROGRAM NAME -- program name
SOURCE EXT -- source extension
DO YOU WISH TO CHANGE INPUT (yiN)

Meaning
The file named in an I or R command,
when the secondary input is from a
nondirectoried device, is not the
same as the program name (loader
code 23).

I
VI

Recovery
If a "Y" is typed, UPDATE
responds with "CHANGE INPUT
AND tp lI •
If N is typed,
UPDATE responds with: "DO
YOU WISH TO USE FILENAME
(Y I N)".
If Y is typed, the
filename is used, otherwise
the program name is used.
In
either case, UPDATE will type
SOURCE EXT WANTED and expect
the user to respond by typing
in a filename extension.
If,
instead, the user types only
a Carriage RETURN, the extension will be omitted from
the program unit.

tIJ
Ii
Ii

::l
p,
1-'rT
1-'-

::l
III

::l

:::0

PROGRAM NAME DISCREPANCY
FILENAME -- filename
PROGRAM NAME -- program name
SOURCE EXT -- source extension
DO YOU WISH TO ACCEPT COMMAND
(yiN)

The file named in an I or R command
when the secondary input is from a
directoried device, is not the same
as the program name (loader code 23).

If anything other than Y is
typed, UPDATE responds:
"COMMAND IGNORED".
If Y is
typed, UPDATE replies:
"DO
YOU WISH TO USE FILENAME (YIN)".
If a Y is typed the filename
is used, otherwise the program
name is used.
In either case,
UPDATE asks:
"SOURCE EXT
WANTED".
The user may then
type a filename extension
followed by a Carriage RETURN.
If the user types only a Carriage RETURN, the extension will
be omi tted from the program uni t.

0
0

<:
m

CHAPTER 4
EXAMPLES USING UPDATE
The following examples demonstrate typical command sequences using
the various options and commands provided by UPDATE.

User responses

are underlined.
Example 1
To update a user created library called USRLIB:

UPDATE XVM V1A000
::'-UtUSRLIS.)

::.- I NAt'1E2.,NFlt'1E:: ~
)1': NAt'iE4 .• NFlt1E5...)
-'~:'. c I'I(H'
,. - t1E·-r.:1~)
I

>;::~

IFILE SPECIFYING COMMAND MUST BE FIRST
IINSERT ROUTINE NAME2 AFTER NAME:
IREPLACE ROUTINE NAME4 WITH NAME5
IDELETE ROUTINE NAME6 FROM FILE
,,'CLOSE USF.:L. I E:

_0'-

Example 2
To create an updated version of the system library (.LIBR) by replacing the BCDIO routine:

IASSIGN PAPERTAPE READER TO
ISECONDARY INPUT
/Ci=ILL UF'NiTE
Ui:'DATE :;-::'·/t'l
)U+ ...J

ISPEC I F'T' "UP[:q=rrE:" OF" I ON
.... (NOTE: . L. I E;I,: E: I N F6::;Ut'1E[:O:/REPLACE SCDIO WITH NEW VERSION
IFROM PAPER

4-1

TAPE

~EADER

Examples Using UPDATE

,,'Cl.O:::E THE F I l.E (, l. I E:F.: E: I N:INEW , l.IBR ON ,OAT -15
UPDATE XVM Vnxnnn
:>

To complete the update of a library file, it is necessary to use the
PIP XVM Utility Program to delete the old library file from the .DAT
-14 device and to transfer the new library from the .DAT -15 device
to the .DAT -14 device.
Example 3
To remove all local symbols from the programs in an existing library
and also obtain a listing:

UPDATE XVM Vnxnnn

ISEl.ECT "LS· OPTIONS AND FILE MYNAM BIN
ICLOSE TO COMPl.ETE OPERRTIONS

)LS+t'1'T'NAt'1,.J
)C ...J

UPDATE XVM Vnxnnn

Example 4
To create a new library called LIB13, delete all local symbols and
obtain a listing:

UI:'DATE

;<l)ivi I, )n>~nnn
)N L5+L r B1::£: ...J
:> I Pf;:OG1_)
:; I PROG2...J
) 1 PROG::;:...J
)C ...J

Uf :' DATE

X\)I"i

,.':::EL.ECi" i)FT ~ I::~~ ~'
: ', .... ,-

/ I N::;E:~: T
,..' I N:::i::RT

.~,

~,i i... ::: 14

FiNel F i L.E

.~ ,

r 1>;.U i~l.i.
P~G~2

AF1ER

F~OGl

P~OG:

AF~EP

F~ . O~~

1)1"1;'::1"11"11"1

4-2

'-. . . , .
C· L I""

Examples Using UPDATE

Example 5
To obtain copies of the BCDlO and AUXlO routines from the file .LlBRBlN:

UPDATE XVM Vnxnnn

)13 +- __)
)1=

BCDIO-.J

)F AU:": I 0 -.J

}£-.J

!SELECT "G" OPTION FOR FILE. LIBR BIN
·'E:<TI':fICT C:CC· I (;
/E:,<H:fICT FIU:-·: I I)

I CLOSE . LIBR BIN

UPDATE XVM Vnxnnn
..

4-3

--- '.

INDEX

$ (Monitor response), 2-1
> (UPDATE response), 2-5

Keyboard commands, 2-2
KILL (K) command, 2-7

ALT MODE, 2-5

Library file (definition), 1-1
Library file processing, 2-5
List contents of library, 2-4
Listing file output, format of,
2-4
Loading procedure, 2-1
Log of current operations, 2-4
L option, 2-4

Calling UPDATE, 2-1
Carriage RETURN, 2-5
Carriage RETURN - LINE FEED, 1-2
CLOSE (C) command, 2-7
Command/Option combination, 2-3
Commands, 2-1
file specification, 2-2
keyboard, 2-2
manipulative, 2-5
termination, 2-7
Command string format, 2-2
Command terminator, 2-5
CTRL character commands, 2-2
CTRL/P, 3-1

Manipulative commands, 2-5
Memory conservation, 2-3

New library file creation, 2-3
N option, 2-3

.DAT slots, 2-1
DELETE (D) command, 2-5
Deleting programs, 2-3
Device assignments, 2-1

Object Time System (OTS) , 1-1
Operations, 2-1
Optional elements, 1-2
Option/Command combinations, 2-3
Options, 2-2

END (E) command, 2-7
Error conditions and recovery, 3-1
Error messages, 3-2
Examples, 4-1

Program deletion, insertion and
replacement, 2-3

Filename, 2-5
File specification commands, 2-2
Format of command string, 2-2
Format of listing file output,
2-4
FREE (F) command, 2-4, 2-6
.FSTAT, system macro, 2-1

G option, 2-4

INSERT (I) command, 2-6
Inserting programs, 2-3
I/O device assignments, 2-1
lOPS messages, 3-1

Reference material, 1-2
REPLACE (R) command, 2-6
Replacing programs, 2-3
Restarting, 2-2

S option, 2-3
Space, 1-2
Symbols used in manual, 1-2
Symbol table removal, 2-3
System macro, .FSTAT, 2-1
Tab, 1-2
Terminate a command, 2-5
Termination commands, 2-7
U option, 2-3
User File Directory (UFD), 1-1

INDEX-l

UPDATE XVM
Utility Manual
DEC-XV-UUPDA-A-D

READER'S COMMENTS
NOTE:

This form is for document corrments only. Problems
with software should be reported on a Software
Problem Repcrt (SPR) form.

Did you find errors in this manual?

If so, specify by page.

Did you find this manual understandable, usable, and well-organized?
Please make suggestions for improvement.

I~
ICII

I~
CII
1'0:

Is there sufficient documentation on associated system programs
required for use of the software described in this manual? If not,
what material is missing and where should it be placed?

1
1
1

Please indicate the type of user/reader that you most nearly represent.

o Assembly language programmer
o Higher-level language programmer

o Occasional programmer (experienced)
o User with little programming experience
o Student programmer
o Non-programmer interested in computer concepts and capabilities
Name

Date _ _ _ _ _ _ _ _ _ _ _ __

Organization _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ __
Street __________________________________________________________________
Ci ty ____________________ Sta te _____________ Zip Code _________

or
Country
If you require a written reply, please check here.

-------------------------------------------------------------Fold Jlere------------------------------------------------------_____ _

------------------------------------------------ Do Not Tear - Fold Here and Staple -----------------------------------------------

FIRST CLASS
PERMIT NO. 33
MAYNARD, MASS.
BUSINESS REPLY MAIL
NO POSTAGE STAMP NECESSARY IF MAILED IN THE UNITED STATES

Postage will be paid by:

momoomo
Software Communications
P. O. Box F
Maynard, Massachusetts 01754

digital equipment corporation

PRINTED IN U.S.A.