DEC 11 UPPA A D_PIP_Aug73 D PIP Aug73

DEC-11-UPPA-A-D_PIP_Aug73 DEC-11-UPPA-A-D_PIP_Aug73

User Manual: DEC-11-UPPA-A-D_PIP_Aug73

Open the PDF directly: View PDF .
Page Count: 72

Download
Open PDF In Browser	View PDF

DEC-ll-UPPAA-A-D

DOS/BATCH
File Utility Package (PIP)
Programmer's Manual

FOR THE DOS/BATCH OPERATING SYSTEM
Monitor Version

V~9

August 1973

For additional copies, order No. DEC-ll-UPPAA-A-D from Digital Equipment
Corporation, Software Distribution Center, Maynard, Massachusetts 01754.

First Printing, May
Second Printing September
Revised, October
Revised, January
Revised, July

1971
1971
1972
1973
1973

Your attention is invited to the last two pages of
this document. The "How to Obtain Software Information" page tells you how to keep up-to-date with
DEC's software. The "Reader's Comments" page, when
filled in and mailed, is beneficial to both you and
DEC; all conwents received are considered when documenting subsequent manuals.

Copyright

0

1971, 1972, 1973 by Digital Equipment Corporation

Associated Document:s:
DOS/BATCH Monitor
Programmer's Manual, DEC-II-OMPMA-A-D
DOS/BATCH User's Guide, DEC-II-OBUGA-A-D
DOS/BATCH Assembler (MACRO-II)
Programmer's Manual, DEC-II-LASMA-A-D
DOS/BATCH FORTRAN Compiler and Object Time System
Programmer's Manual, DEC-II-LFRTA-A-D
DOS/BATCH System Manager's Guide, DEC-II-OSMGA-A-D
DOS/BATCH Debugging Program (ODT-IIR)
Programmer's Manual, DEC-II-UDEBA-A-D
DOS/BATCH Linker (LINK)
Programmer's Manual, DEC-II-ULKAA-A-D
DOS/BATCH Librarian (LIBR)
Programmer's Manual, DEC-II-ULBAA-A-D
DOS/BATCH Text Editor (EDIT-II)
Programmer's Manual, DEC-II-UEDAA-A-D
DOS/BATCH File Compare Program (FILCOM)
Programmer's Manual, DEC-II-UFCAA-A-D
DOS/BATCH File Dump Program (FILDMP)
Progranmer's Manual, DEC-II-UFLDA-A-D
DOS/BATCH Verification Program (VERIFY)
Programmer's Manual, DEC-II-UVERA-A-D
DOS/BATCH Disk Initializer (DSKINT)
Progranmer's Manual, DEC-II-UDKIA-A-D
The following are trademarks of Digital Equipment Corporation, Maynard,
Massachusetts:
CDP
COMPUTER LAB
COMTEX
COMSYST
DDT
DEC
DECCOMM

DECTAPE
DIBOL
DIGITAL
DNC
EDGRIN
EDUSYSTEM
FLIP CHIP

FOCAL
GLC-8
IDAC
IDACS
INDAC
KAID
LAB-8

LAB-8/e
LAB-K
OMNIBUS
OS/8
PDP
PHA

PS/8
ii

QUICKPOINT
RAD-8
RSTS
RSX
RTM
SABR
TYPESET 8
UNIBUS

PREFACE

This manual describes the

~eatures

and operation of version

of the File utility Package (PIP) for DOS/BATCH.

V~~9

The manual assumes

familiarity with the DOS/BATCH Monitor.
The file utility Package is called PIP (Peripheral Interchange
Program) for compatibility with similar programs on other DEC systems.
Features provided by PIP include file transfers from one device to
another, file deletions, file renaming, and directory listings.
Appendix B, "Helpful Hints", contain valuable information on
possible solutions to problems that can arise while becoming familiar
with PIP.
This software is furnished to purchaser under a license for use
on a single computer system and can be copied (with inclusion of DEC's
copyright notice) only for use in such system, except as may otherwise
be provided in writing by DEC.
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 manual.
Digital assumes no responsibility for the use or reliability of
its software on equipment that is not supplied by DIGITAL.

iii

CONTENTS
CHAPTER 1

INTRODUCTION

1.1

CALLING PIP

1-1

1.2

RECOVERING FROM ERRORS

1-2

1.3

RETURNING TO THE DOS MONITOR

1-3

1.3.1

Interactive Environment

1-3

1.3.2

Batch Stream

1-3

CHAPTER 2

COMMAND STRINGS

2.1

GENERAL COMMAND STRING FORMATS

2-1

2.2

DEVICE SPECIFICATION

2-2

2.3

FILENAME SPECIFICATION

2-3

2.4

FILENAME EXTENSION SPECIFICATION

2-3

2.5

ASTERISK FEATURE

2-4

2.6

USER IDENTIFICATION CODE SPECIFICATION

2-5

SWITCH SPECIFICATIONS
FILE MANIPULATION
FILE TRANSFERS
File Copy Operation
Fast Copy and/or Verify Operations
File Merge Operation
File Transfer Modes
Contiguous Files
Transfers from the Teleprinter

2-5

3.2

RENAMING FILES

3-8

3.3

DELETING FILES

3-9

3.4

INSPECTING FILES

3-10

3.5

SUPERSEDE OPERATION

3-10

3.6

FILE PROTECTION CODES

3-11

3.7

ALLOCATING A CONTIGUOUS FILE

3-13

2.7
CHAPTER 3
3.1
3.1.1
3.1.2
3.1.3
3.1.4
3.1.5
3.1.6

CHAPTER 4

3-1
3-1
3-2
3-3
3-4
3-5
3-7

DIRECTORY MANIPULATION

4.1

ENTERING USER IDENTIFICATION INTO DIRECTORY

4-1

4.2
4.2.1
4.2.2

DIRECTORY LISTINGS
Full Directories
Brief Directory Listings

4-2
4-2

4.3

FREE BLOCKS

4-9

v

4-6

4.4
4.4.1
4.4.2

DECTAPE AND RKII DISK INITIALIZATION
DECtape
RK11 Disk

4-9
4-9
4-10

4.5

RECOVERING FILES

4-11

CHAPTER 5

MAGTAPE OPERATION

5.1

GENERAL MAGTAPE INFORMATION

5-1

5.2

REWIND

5-2

5.3

REWIND/UNLOAD

5-3

5.4

ZERO (INITIALIZATION)

5-3

5.5

MAGNETIC TAPE FORMAT

5-3

CHAPTER 6

CASSETTE TAPE OPERATION

6.1

GENERAL CASSETTE TAPE INFORMATION

6.2

REWIND

6-1

6.3

ZERO (INITIALIZATION)

6-2

6.4

CASSETTE TAPE FORMAT

6-2

6.5

READ-AFTER-WRITE VERIFICATION

6-2

CHAPTER 7

ERROR MESSAGES

7-1

APPENDIX A

SUMMARIES

A-I

APPENDIX B

HELPFUL HINTS

B-1

APPENDIX C

PROGRAMMING CAUTIONS

C-l

INDEX

6-1

X-I

vi

CHAPTER 1
INTRODUCTION

The File Utility Package performs transfers of data files
from standard PDP-II I/O devices to other standard PDP-II I/O devices
and performs simple editing and control functions as well.
~eripheral

Interchange

~rogram,

PIP,

handles all standard data formats

used in the DOS/BATCH system.
The major features provided by PIP are as follows:
•

Transfer a file or group of files from one device to another
with output being either linked or contiguous (refer to
section 3.l.5);

•

Merge a group of input files into a single (new) output file;

•

Allocate a contiguous file on disk or DECtape;

•

Rename an existing file;

•

Cause an input file having the same name as a file on the output
device to replace that output file - also a switch to turn this
mode on or off;

•

Delete a file or group of files;

•

Selectively perform an operation on each file of a group of
files;

•

Change the protection code on a file;

•

Print filename, file size, creation date, and protection code of
each file in a disk, DECtape, cassette, or magtape directory.

•

Print a listing of the filenames on disk, DECtape, cassette, or
magtape directory.

•

List the number of free blocks remaining on the device specified;

•

Zero (initialize) a disk (except RP~3), DECtape, cassette, or magtape;

•

Perform fast copy and/or verify operations for DECtape.

•
1.1

Perform read-after-write verification for cassette tape.
CALLING PIP
The user must be logged into the Operating System before run-

ning PIP.

Any previous program in core must be removed with the

KILL command.

(The user should be familiar with the Operating System

1-1

before attempting to use PIP; particularly the RUN, LOGIN,
KIIIL, and FINISH commands.)

con~ands

In response to the System Monitor's dollar sign character, the
user can type the RUN PIP command. For example:
$RUN PIP
PIP Vxx

!

(xx is PIP version number)

Following the RUN command, PIP is called into core, prints its version
number and a number sign. The number sign indicates that PIP is ready
to accept a command string. Following completion of a command, PIP
prints another number sign and awaits further commands.
NOTE
A convention followed throughout this manual
is the underlining of all Monitor and system
program printout to differentiate it from
user-typed commands, which are not underlined. Large sections of system program
continuous output (such as directory listings)
are not underlined. All commands are terminated with the nonprinting RETURN key,
causing a carriage return/line feed operation.
1.2

RECOVERING FROM ERRORS

When using PIP, the user may receive an error message from time
to time.
An A error message issued by the Monitor indicates a need for
operator intervention.

In the event an A error occurs, the user should

consult the DOS/BATCH-ll Progrannner's Manual for a description of
the error and then correct the error condition and give the CONTINUE
command.

For example::
#DT1:ABC

3-13

Whenever it is necessary to create an empty, contiguous file,
the characters :E are appended to the command string.

For example:

!DF:FILE1/AL:l~:E

allocates 640 contiguous words of file storage on the RFll disk as
normally.

However, pointers are set in the UFO file entry such

that the space is apprently empty.

A file allocated in this manner

can accept partial sequential output (through a Monitor .OPENC call).
The pointers are updated to reflect the end of the actual data
entered in part of the allocated space.

The same file can subse-

quently be extended (through a Monitor .OPENE call) within the: unfilled, allocated space.

3-14

CHAPTER 4
DIRECTORY MANIPULATION
A significant number of PIP features center around the manipulation of files within directories and of the directories themselves.
4.1

ENTERING USER IDENTIFICATION INTO THE MASTER FILE DIRECTORY
The User Identification Code (UIC) must appear in the Master

File Directory (MFD) before a user is able to create his own files
on the disk or DECtape.

This code is generally entered into the MFD

by using the ENTER switch in PIP, although the DOS system 'building
program creates a few fundamental User File Directories (UFD's).

Refer

to the DOS/BATCH System Manager's Guide for further details.
The UIC of the current user of the system is passed to the Operating System by the LOGIN command.

For example:

$LOGIN 11,11
sets the current UIC to [11,11].

In using the ENTER switch, the UIC

of the current user is obtained from the system and written into a
spare slot in the MFD.

The recommended sequence is then:

$LOGIN uie
$RUN PIP
PIP Vxxx

tLfEN
The LOGIN UIC code is now a valid UIC on the system disk.

In order

to enter a UIC onto the system disk other than the one used in the
LOGIN command, the UIC can be specified as follows:

PJ 200,213 J/EN
which enters the

UIC[2~~,2l3]

onto the system disk.

If no spare slots exist in the MFD1, PIP prints a fatal error
message, and no attempt is made to extend the MFD.

lSee Section C.2 for the number of UIC slots available on the UFD.

4-1

This procedure is not always necessary for DECtapes because the
ZERO switch enters the UIC of the current user when the directory is
initialized (see section 4.4.1).
If a user other than the one originally zeroing the DECtape
wishes to access files on the tape, he must enter his UIC on the
DECtape or explicitly reference the UIC field of the original user
during each reference. For example, if the DECtape on unit I had
been originally zeroed and filled by UIC [5~,5~], user UIC [2~~,2~~]
could reference those files by logging in under
giving the following command:

[2~~,2~~]

and

!DTl: lEN
In general, then, an ENTER operation performs one of two
services: for DECtapes it allows any user to access all files on
the DEC tape as though he had initialized the DECtape; and on the
disk it creates a UFD for the current (logged in) UIC (or the UIC
specified), allowing that user to store files on the system disk
with whatever protection is desired.
4.2

DIRECTORY LISTINGS
A listing of the directory of all or certain selective files on

any file structured device can be printed on the teleprinter or line
printer; (PIP assumes the teleprinter unless another device is specified
in the command string).

The information listed in a directory is a

subset of all the information in the UFD entry for each file.
4.2.1

Full Directories
A full directory (/DI) l·isting contains:

two title lines to

identify the device, UIC, and the data which are followed by all
filenames and extensions; the number of blocks per file (followed
by a C if the file is contiguous), file creation date, and file
protection code (enclosed within angle brackets); plus the total
number of blocks and file for that UIC.

4-2

For example:

#/DI
DIRECTORY DF0:

[50,50J

22-FEB-72
MONLIB
LINKll.OVR
PIP
.LDA
LINKOB.LDA
LINKll.LDA
EDITll.LDA
PALIIR.OVR
PALOB .LDA
ODTIIR.OBJ
PALIIR.LDA
FORTRN
LIBRll.LDA
FORTRN.OVR
FORCOM.DGN
FORRUN.DGN
FORLIB.OBJ
EAELIB.OBJ
ADD4B .PAL
DEFIN .OBJ
DVB07 .PAL
PALSYM.PAL
FORTOV.12K
FORTRN.12K
LINKOB.OBJ
LINK11.0BJ
EDIT11.0BJ
PALOB .OBJ
PALSYM.OBJ
PALIIR.OBJ

508c
72C
77
107
63
56
40C
107
53
65
90
35
204c
68c
40C
604
604
66
5
33
85
300C
118
154
94
85
138
17
77

TOTL BLKS:
TOTL FILES:

Notice that the system device
the user was logged in under

00-XXX-70
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72
22-FEB-72

< 377>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>

3965
29

(DF~:

in this case) was assumed and

UIC[5~,5~].

Whenever a file is transferred onto disk, ,cassette tape, or DECtape,
the date in the directory reflects the date on which the transfer took
place,

~

the date on which the file was created.

The full directories of multiple devices can be obtained:

4-3

!DF:,DTl:/DI
DIRECTORY DF0:

[50,50J

;~4-JUL-71

fllONLIB
LINKll.0VR
PIP
.LDA
ODTIIR.OBJ
F'ORTRN.OVL
FORTEN
LINKOB.LDA
LINK .LDA
EDIT .LDA
PALOB .LDA
PAL
.LDA
PAL11R.CVR
LIBR .LDA
FORCOM.DGN
EAELIB.LDA
EAELIB.OBJ

508c
36c
70
51
152C
118
96
58
56
107
65
40C
41
112C
555
555

TOTAL BLKS:
TOTL FILES:

2620
16

D-IREC1'ORY DTl:

00-xXX-70
17-JUL-71
17-JUL-7l
17-JUL-7l
24-JUL-7l
24-JUL-7l
17-JUL-7l
17-JUL-7l
17-JUL-7l
17-JUL-71
17-JUL-7l
17-JUL-7l
17-JUL-7l
17-JUL-7l
19-JUL-7l
19-JUL-7l

<377>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<00 >
<233>
<233>

01-JUL-7l
01-JUL-7l
01-JUL-7l
01-JUL-7l
01-JUL-7l

<233>
<233>
<233>
<233>
<233>

[l,lJ

24-JUL-71
FORLIB.OBJ
EAELIB.OBJ
IOL01 .OBJ
DEFIN .OBJ
DVTB06.PAL

135
136

FREE BLKS:
FREE FILES:

282
51

1
1

7

When a full DECtape or cassette tape directory is obtained, the
li.sting is concluded with the total number of free blocks and files,
whereas with a disk the number of used blocks and files. are reported.
The full directory listing can be limited to produce a partial
list of specified files on one or more devices.

The following

example illustrates the use of the asterisk to list only those files
with the extensions specified on the two devices specified:

4-4

!DF:*.OVR,*.OBJ,DTl:*.PAL/DI

DF.0:
LINKll.OVR
PALIIR.OVR
ODTIIR.OBJ
EAELIB.OBJ

36c
4.0c

17-JUL-71
17-JUL-71

<233>
<233>

51
555

17-JUL-71
19-JUL-71

<233>
<233>

7

.01-JUL-71

<233>

DT1:
DVTB.06.PAL

Notice that the UIC, date, and number of blocks and files for that
UIC are not reported in partial /DI listings.
Directory information about a particular file can be obtained
by specifying the filename and extension with the /OI switch.

For

example:

!FTN.0.0.0.0VL/DI

DK.0:
FTN.0.0.0.0VL

l.0C

15-JUL-71

This obtains all information about
directory.

-< 233 >

FTN~~~.OVL

if it is in the

DK~:

(If the file is not in the directory, there is no

listing, and no error message.)
Any UIC directory on any device can be listed by specifying
that UIC in the command to PIP.

For example, if a user is logged

in under UIC 2~~,2~~, he can give the following command (the results
are shown below) :

!DK1:[5.0,5.0J/DI

4-5

DIRECTORY.OK1:

[50,50J

21-JUL-71
FORCorl] . DGN
FORTHN.08K
IVK08K.LDA
OVL18K.LDA
OVL28K.LDA
OVL38K.LDA
OVL48K.LDA
OVL58K.LDA
OVLC8K.LDA
FORTRN.12K
OVL0 .LDA
OVL1 .LDA
OVL2 .LDA
OVL3 .LDA
OVL4 .LDA
OVL5 .LDA
OVL6 .LDA
TOTL ELKS:
'l'OTL FILES:

27C
23
27
26
23
26
28
28
25
23
27
26
23
26
28
28
25

01-JUL-71
01-JUL-71
01-JUL-71
01-JUL-71
01-JUL-71
01-JUL-71
01-JUL-71
01-JUL-71
01-JUL-71
01-JUL-71
01-JUL-71
01-JUL-71
01-JUL-71
01-JUL-71
01-JUL-71
01-JUL-71
01-JUL-71

<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>
<233>

123
39

If the user requests information on any particular file or uses the
asterisk feature where no such file exists, no error message is
given.

The directory is considered blank; and a blank line is

printed.

In the example below there is no *.OVR file on DT.0:

!DF:*.OVR,DT0:*.OVR/DI

DF0:
LINK11.0VR
PAL11R.OVR

36c
40C

21-JUL-71
21-JUL-71

<233>
<233>

DT0:
4.2.2

Brief Directory Listings
The BRIEF DIRECTORY (jBR) switch can be used to list only the

device name, filenames, and extensions.

The asterisk and specific

filenames can be used with the BRIEF DIRECTORY switch to obtain
partial brief directories.

4-6

The following PIP example demonstrates the correspondence
between /DI and /BR directory listings.

!*.OVL/DI

DK.0:
FTN.0.0.0.0VL
FTN.0.01.0VL
FTN.0.02.0VL
FTN.0.03.0VL
FTN.0.04.0VL
FTN.0.05.0VL
FTN.0.06.oVL

1.0.0
9C
7C
9C
l.0C
llC
8c

15-JUL-71
l5-JUL-71
15-JUL-71
15-JUL-71
15-JUL-71
15-JUL-71
15-JUL-71

<233>
<233>
<233>
<233>
<233>
<233>
<233>

!*.OVL/BR

DK.0:
FTN.0.0.0.0VL
FTN.0.01.0VL
FTN.0.02.0VL
FTN.0.03.0VL
FTN.0.04.0VL
FTN.0.05.0VL
FTN.0.06.oVL
An example of the /BR switch with the system device assumed
is shown below:

tt/BR
DF.0:
MONLIB
LINKll.0VR
PIP
.LDA
FCL
.PAL
PALIIR.OVR
PAL
LINK
Other examples of /BR switch usage are shown below:

!FOR.E/BR

DF.0:
FOR

.E

4-7

The asterisk (*) feature for filenames and extensions works
for directory listings, both full and brief form.

For example, the

command:

ff:...*.PAL/BR
gives a brief directory listing for all files on the user's disk
area with an extension of .PAL.

The asterisk can appear in the

filename field, the extension field, or both.

In addition, groups

of file specifiers can be arranged to provide sequential listings,
as in:

ff:. .DT.0:*.MAC,DF:FORTRN.*/DI

The asterisk feature can be used in the UIC field when obtaining
directory listings.

ff:...LP:
Source Exif Data: 
File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.3
Linearized                      : No
XMP Toolkit                     : Adobe XMP Core 4.2.1-c041 52.342996, 2008/05/07-21:37:19
Create Date                     : 2017:06:08 10:22:19-08:00
Modify Date                     : 2017:06:08 10:31:51-07:00
Metadata Date                   : 2017:06:08 10:31:51-07:00
Producer                        : Adobe Acrobat 9.0 Paper Capture Plug-in
Format                          : application/pdf
Document ID                     : uuid:48d57bb3-c5d4-094a-90e5-54e01a0347ab
Instance ID                     : uuid:f38c2030-379d-ec40-892a-a319ec62d4c4
Page Layout                     : SinglePage
Page Mode                       : UseNone
Page Count                      : 72

EXIF Metadata provided by EXIF.tools