.CENTER
  
.SKIP 10
.CENTER
^^FILE UTILITY PACKAGE (PIP)
.SKIP 3
INTRODUCTION\\
.SKIP 1
.PARAGRAPH
.INDEX ^PERIPHERAL ^INTERCHANGE ^PROGRAM (^P^I^P)
^THE FILE UTILITY PACKAGE PERFORMS TRANSFERS OF 
DATA FILES FROM STANDARD ^^FILES-11 I/O\\ DEVICES TO OTHER STANDARD 
^^FILES-11\\
^I/^O DEVICES AND PERFORMS SIMPLE EDITING AND CONTROL FUNCTIONS AS WELL.
^THE ^PERIPHERAL ^INTERCHANGE ^PROGRAM (^^PIP\\) HANDLES ALL STANDARD DATA FORMATS
USED IN THE ^^RSX-11M\\ ^SYSTEM.
.SKIP 4

.PAGE
.CENTER
^^PIP USAGE SUMMARY
.SKIP 3
INITIATING PIP\\
.INDEX INITIATING ^P^I^P
.SKIP 1
.PARAGRAPH
^A USER MUST BE LOGGED ON BEFORE USING ^P^I^P.
.PARAGRAPH
.INDEX ^^CUSP\\S
^LIKE ALL ^^RSX-11M\\ ^^CUSP\\S (^COMMONLY ^USED ^SYSTEM ^PROGRAMS)
^P^I^P MAY BE INITIATED
IN SEVERAL WAYS. ^THE COMMON METHODS ARE:
.SKIP 1
.INDENT 5
A) ^SINGLE COMMAND:
.SKIP 1
.INDENT 20
^^PIP\\ COMMAND STRING <^^CR\\>
.INDEX COMMAND STRING
.SKIP 1
.LEFT MARGIN 8
^^PIP\\ WILL EXECUTE THE COMMAND STRING, AND
WHEN COMPLETED, WILL RETURN TO ^^MCR.\\
.INDEX ^^MCR\\
.SKIP 1
.LEFT MARGIN 0
.INDENT 5
B) ^MULTIPLE COMMAND:
.SKIP 1
.INDENT 10
^^PIP <CR>\\
.LEFT MARGIN 8
.SKIP 1
AFTER WHICH A PROMPT IS GIVEN:
.INDEX PROMPT
.SKIP 1
.INDENT 2
^^PIP>\\
.SKIP 1
^THIS PROMPT INDICATES THAT ^P^I^P IS READY TO
ACCEPT A COMMAND STRING.
^^PIP\\ WILL EXECUTE THE COMMAND STRING AND RETURN
WITH ANOTHER PROMPT.
.LEFT MARGIN 0
.SKIP 4
^L^E^A^V^I^N^G ^P^I^P
.PARAGRAPH
.INDEX LEAVING ^P^I^P
^TO LEAVE ^P^I^P AFTER USING METHOD B) ABOVE,
THE USER MUST ENTER AN END-OF-FILE, INSTEAD OF A
.INDEX END-OF-FILE
COMMAND STRING (I.E. FOLLOWING A PROMPT STRING).
^THIS IS DONE BY TYPING
^C^T^R^L/^Z (DEPRESSING THE ^C^R^T^L AND "^Z"
.INDEX ^^CTRL/Z\\
KEYS SIMULTANEOUSLY).
^EXECUTION OF ^^PIP\\ WILL THEN BE TERMINATED.
.SKIP 2

.PAGE
.CENTER
^^COMMAND STRINGS\\
.INDEX COMMAND STRING
.SKIP 2
^^GENERAL COMMAND STRING FORMAT\\
.INDEX COMMAND STRING FORMAT
.PARAGRAPH
^COMMANDS TO ^P^I^P ARE PROCESSED BY THE  STANDARD ^^RSX\\
^COMMAND ^LINE ^INTERPRETER (^C^L^I). ^THE  GENERAL FORMAT
OF A ^P^I^P COMMAND IS:
.INDEX ^COMMAND ^LINE ^INTERPRETER (^C^L^I)
.SKIP 1
.CENTER
^OUTFILE=^INFILE1,^INFILE2,...,^INFILE^N
.SKIP 1
^EACH OF THE FILE SPECIFIERS IS ENTERED IN THE FOLLOWING FORMAT:
.CENTER
DEV:[G,M]FILENAME.TYP;VER
.SKIP 1
.NOFILL
###########E.G.  ^^DK1:[231,11]PROGRAM1.FTN;32\\
.SKIP 1
WHERE:
.TAB STOPS 12 52
.LEFT MARGIN 12
.NOFILL
.INDENT -10
.INDEX DEV: (DEVICE)
DEV:	IS THE  PHYSICAL DEVICE ON  WHICH  THE  	##^^DK1:\\
.RIGHT MARGIN 50
.FILL
VOLUME CONTAINING THE
DESIRED FILE IS MOUNTED.
^THE NAME CONSISTS OF TWO CHARACTERS FOLLOWED BY A ONE OR TWO DIGIT
(OCTAL) UNIT NUMBER AND A COLON.
^NOTE THAT THE COLON IS PART OF THE DEVICE NAME.
(SEE ^APPENDIX ^D FOR A LIST OF DEVICES ON THIS SYSTEM.)
^IF NO DEVICE IS SPECIFIED, ^^SY0:\\ IS ASSUMED.
^IF NO DIGIT IS SPECIFIED, "0" IS ASSUMED.
.SKIP 1
.NOFILL
.RIGHT MARGIN 60
.INDENT -10
[G,M]	IS THE USER IDENTIFICATION CODE (^^UIC\\),	[231,11]
.INDEX ^^UIC\\ (^USER ^IDENTIFICATION ^CODE)
.FILL
.RIGHT MARGIN 50
WHICH IDENTIFIES THE DIRECTORY CONTAINING THE FILE.
G AND M ARE OCTAL NUMBERS IN THE RANGE 1 TO 377,
IDENTIFYING THE GROUP AND THE MEMBER OF THE
GROUP, RESPECTIVELY.
^NOTE THAT THE SQUARE BRACKETS ARE PART OF THE ^^UIC\\.
.SKIP 1
.RIGHT MARGIN 60
.NOFILL
.INDENT -10
FILENAME	IS THE NAME OF THE FILE,  WHICH MAY BE 	^^PROGRAM1\\
.INDEX FILENAME
.FILL
.RIGHT MARGIN 50
UP TO NINE ALPHANUMERIC CHARACTERS IN LENGTH.
^ALL CHARACTERS IN EXCESS OF NINE ARE IGNORED.
.SKIP 1
.RIGHT MARGIN 60
.NOFILL
^FILENAME AND FILE TYPE ARE ALWAYS SEP- 	###.
.RIGHT MARGIN 50
.FILL
ARATED BY A PERIOD, WHICH IS NOT A PART OF
EITHER THE FILENAME OR THE TYPE.
.SKIP 1
.NOFILL
.RIGHT MARGIN 60
.INDENT -10
TYP	IS THE FILE TYPE, AND IS USED TO INDI-	##^^FTN\\
.INDEX TYPE
.INDEX FILE TYPE
.FILL
.RIGHT MARGIN 50
CATE THE FORM OF THE FILE.
^FILE TYPE MAY BE UP TO THREE ALPHANUMERIC CHARACTERS, AND
WHILE THERE ARE NO RESTRICTIONS ON THE TYPES A USER
MAY USE, THERE ARE CERTAIN RECOMMENDED SYSTEM DEFAULTS, FOR
EXAMPLE:
.SKIP 1
.LEFT MARGIN 20
.NOFILL
^^FTN - FORTRAN\\ SOURCE CODE.
^^OBJ\\ - OBJECT CODE.
^^TSK\\ - TASK IMAGE.
^^DAT\\ - DATA RECORDS.
^^CMD\\ - COMMANDS.
^^TMP\\ - TEMPORARY FILE.
.FILL
.LEFT MARGIN 12
.SKIP 1
^A COMPLETE LIST OF PREFERRED SYSTEM FILE TYPES IS INCLUDED
AS ^APPENDIX ^B.
.SKIP 1
.NOFILL
.RIGHT MARGIN 60
^FILE TYPE AND VERSION NUMBER ARE SEP- 	###;
.RIGHT MARGIN 50
.FILL
ARATED BY A SEMICOLON, WHICH IS NOT A PART OF
EITHER THE TYPE OR THE VERSION NUMBER.
.SKIP 1
.RIGHT MARGIN 60
.NOFILL
.INDENT -10
VER	IS AN OCTAL NUMBER USED TO DIFFERENTI-	##32
.INDEX VERSION NUMBER
.INDEX VERSION
.FILL
.RIGHT MARGIN 50
ATE AMONG VERSIONS
OF A FILE.
^FOR EXAMPLE, A FILE CREATED BY THE EDITOR WOULD HAVE A VERSION 
NUMBER OF 1.
^IF THE FILE IS EDITED AGAIN, THE ORIGINAL FILE WILL
BE KEPT FOR BACKUP, AND THE NEW FILE WILL HAVE THE SAME FILENAME
AND TYPE, BUT A VERSION NUMBER OF 2.
^THE LARGEST POSSIBLE VERSION NUMBER IS OCTAL
77777.
^IF THE VERSION NUMBER IS OMITTED,
THE LATEST VERSION OF A FILE IS IMPLIED.
.LEFT MARGIN 0
.RIGHT MARGIN 60
.PARAGRAPH
^A "WILD CARD" CHARACTER (*) CAN BE USED IN THE PLACE
.INDEX WILD CARD OPERATIONS
.INDEX DEV: (DEVICE)
OF ANY OF THE ABOVE FIELDS EXCEPT ^^DEV:\\. ^USE OF THE
ASTERISK IN A FILE SPECIFIER IMPLIES THAT THE FIELD
REPLACED WILL "MATCH" WITH ANY FILE. ^FOR 
EXAMPLE:
.SKIP 1
.LEFT MARGIN 20
.INDENT -15
^^DK2:FILE.*\\####REFERS TO
THE LATEST VERSION OF ALL FILES ON ^^DK2:\\
WITH THE FILE NAME ^^FILE\\ (ALL TYPES).
.SKIP 1
.INDENT -15
^^DK2:*.TMP;3\\###REFERS TO ALL FILES ON ^^DK2:\\
OF  TYPE ^^TMP\\, WITH THE VERSION NUMBER 3.
.SKIP 2

.TEST PAGE 30
.LEFT MARGIN 0
^^SWITCH SPECIFICATIONS\\
.INDEX SWITCHES
.INDEX SWITCH SPECIFICATION
.INDEX SWITCH VALUE
.PARAGRAPH
^EITHER AN INPUT OR AN OUTPUT FILE SPECIFIER
CAN BE MODIFIED BY A SWITCH IN THE
COMMAND STRING.
^A SWITCH SPECIFICATION INDICATES THAT SOME SPECIAL
^P^I^P ACTION IS TO BE PERFORMED.
.PARAGRAPH
^SWITCH SPECIFICATIONS ARE OF TWO FORMS:
.SKIP 1

.INDENT 10
.NOFILL
/^S^W   OR   /^S^W:N
.SKIP 1
.INDENT 5
WHERE:   /   SIGNALS A SWITCH SPECIFICATION.
.INDENT 14
^S^W   INDICATES THE TWO LETTER SWITCH 
.INDENT 25
CODE.
.INDENT 14
:N   INDICATES A DECIMAL OR OCTAL VALUE
.INDENT 20
(AS REQUIRED BY SOME SWITCHES).
.FILL
.SKIP 1
AND IN GENERAL CAN BE GROUPED INTO TWO
CATEGORIES:
.SKIP 2
.TEST PAGE 15
.NOFILL
.INDENT 10
^^ACTION SWITCHES         QUALIFYING SWITCHES\\
.INDEX SWITCHES (QUALIFYING)
.INDEX SWITCHES (ACTION)
.SKIP 1
.INDENT 10
.INDEX SWITCHES
.INDEX APPEND /^^AP\\
.INDEX BRIEF DIRECTORY /^^BR\\
.INDEX DELETE /^^DE\\
.INDEX FULL DIRECTORY /^^FU\\
.INDEX LIST DIRECTORY /^^LI\\
.INDEX DIRECTORY /^^LI\\
.INDEX PURGE /^^PU\\
.INDEX RENAME /^^RE\\
.INDEX SPOOL /^^SP\\
.INDEX UNLOCK /^^UN\\
.INDEX CONTIGUOUS /^^CO\\
.INDEX NEW VERSION /^^NV\\
.INDEX SUPERCEDE /^^SU\\
^^/AP  APPEND                 /CO  CONTIGUOUS
.INDENT 10
/BR  BRIEF DIRECTORY        /NV  NEW VERSION
.INDENT 10
/DE  DELETE                 /SU  SUPERSEDE
.INDENT 10
/FU  FULL DIRECTORY
.INDENT 10
/LI  LIST DIRECTORY
.INDENT 10
/PU  PURGE OLD VERSIONS
.INDENT 10
/RE  RENAME
.INDENT 10
/SP  SPOOL
.INDENT 10
/UN  UNLOCK
.FILL
.SKIP 1
\\^EXAMPLES OF THE SWITCHES USED TO PERFORM SIMPLE
^P^I^P OPERATIONS ARE GIVEN IN THE FOLLOWING SECTIONS.
.PARAGRAPH
^THE ^P^I^P SWITCH OPTIONS AND THEIR OPERATIONS ARE
LISTED BRIEFLY IN ^^APPENDIX A\\,
AND A FULL DESCRIPTION CAN BE FOUND IN THE
^^RSX-11M\\ ^UTILITIES MANUAL.
.PAGE
.CENTER 
^^FILE AND DIRECTORY MANIPULATION\\
.INDEX FILE MANIPULATION
.INDEX DIRECTORY MANIPULATION
.SKIP 1
.LEFT MARGIN 0
.PARAGRAPH
^FILE AND DIRECTORY MANIPULATIONS ARE THE PRIMARY
FUNCTIONS OF ^P^I^P. ^THE REMAINDER OF THIS SUMMARY
WILL EXPLAIN THE GENERAL INSTRUCTIONS OF ^P^I^P
AND GIVE EXAMPLES OF THEIR USE.
.SKIP 1
.LEFT MARGIN 5
.PARAGRAPH
.INDENT -5
^^FILE TRANSFERS
.SKIP 1
.INDENT -3
1. FILE COPY\\: ^IN THE SIMPLEST CASE , ^P^I^P CAN TRANSFER A
.INDEX FILE TRANSFERS
.INDEX FILE COPY
.INDEX ^^TI:\\
FILE FROM ONE PERIPHERAL ONTO ANOTHER.
^FOR EXAMPLE, TO LIST A FILE ON THE TERMINAL,
SPECIFY "^T^I:"  AS THE OUTPUT AND
THE FILENAME AS THE INPUT (WITH DEVICE IF NECESSARY):
.SKIP 1
.INDENT 10
^T^I:=^D^K0:^F^I^L^E
.PARAGRAPH
^ALTHOUGH THERE CAN ONLY BE ONE OUTPUT FILE
DESIGNATED, THERE CAN BE ANY NUMBER OF INPUT FILES,
SO IT IS POSSIBLE  TO COPY THREE
FILES FROM ONE DISK TO ANOTHER:
.SKIP 1
.INDENT 10
^^DK2:=DK0:FILE1,FILE2,FILE3\\
.PARAGRAPH
^THIS WOULD CREATE THREE FILES ON ^^DK2:\\
WITH THE SAME NAMES AS THE THREE INPUT FILES.
.PARAGRAPH
.INDENT -3
2. ^^FILE MERGE:\\ ^IN THE PRECEDING EXAMPLE,
.INDEX FILE MERGE
SEVERAL FILES WERE DESIGNATED AS INPUT,
AND WERE COPIED TO THE OUTPUT DEVICE AS SEPARATE FILES WITH THE
SAME FILE NAMES. ^HOWEVER, IF A FILENAME WERE SPECIFIED
AS OUTPUT, THEN THE INPUT FILES BECOME
MERGED UNDER THAT FILENAME. ^FOR EXAMPLE:
.SKIP 1
.INDENT 10
^^DK2:FILE0=DK0:FILE1,FILE2,FILE3\\
.SKIP 1
WILL COMBINE THE THREE FILES INTO A SINGLE FILE
NAMED ^^FILE0\\ ON ^^DK2:\\.
.SKIP 1
.PARAGRAPH
^THERE ARE FOUR SWITCHES AVAILABLE FOR USE WITH
THE ABOVE MODES OF FILE TRANSFER:
.SKIP 1
.LEFT MARGIN 10
.INDENT -3
A)#^^/CO\\ CAUSES THE OUTPUT FILE(S) TO WHICH THE
.INDEX SWITCHES
.INDEX CONTIGUOUS /^^CO\\
.INDEX CONTIGUOUS FILES
SWITCH IS ATTACHED TO BECOME CONTIGUOUS FILES. (^DEFAULT
IS: ^^/NOCO\\).
.SKIP 1
.INDENT -3
B)#^^/NV\\ CAUSES THE OUTPUT FILE(S) TO ACQUIRE THE NEXT AVAILABLE
.INDEX NEW VERSION /^^NV\\
VERSION NUMBER, IF NOT EXPLICITLY GIVEN. (^DEFAULT IS: ^^/NV\\).
.SKIP 1
.INDENT -3
.INDEX SUPERCEDE /^^SU\\
C)#^^/SU\\ CAUSES THE SPECIFIED OUTPUT FILE(S) TO SUPERCEDE
EXISTING FILES; THAT IS, IF THE SPECIFIED OUTPUT FILE ALREADY
EXISTS, ^^/SU\\ WILL FORCE THE OVERWRITING OF THAT OUTPUT FILE.
(^DEFAULT IS: ^^/NOSU\\).
.SKIP 1
.INDENT -3
.INDEX APPEND /^^AP\\
D)#^^/AP\\ CAUSES THE SPECIFIED INPUT FILE(S) TO BE APPENDED
TO AN ALREADY EXISTING OUTPUT FILE. (^DEFAULT IS: ^^/NOAP\\).
.SKIP 2
.TEST PAGE 25
.LEFT MARGIN 5
.INDENT -5
^^TRANSFERS FROM THE TERMINAL\\
.SKIP 1
^OCCASIONALLY THE USER MAY WISH TO
.INDEX ENTERING A FILE
ENTER A FILE THROUGH THE TERMINAL KEYBOARD
TO ANOTHER DEVICE. ^THIS IS ACCOMPLISHED AS 
FOLLOWS:
.SKIP 1
.INDENT 10
.INDEX ^^TI:\\
^^DK0:FILE=TI:\\
.PARAGRAPH
^SUBSEQUENT CHARACTERS TYPED ON THE KEYBOARD
ARE OUTPUT TO THE FILE ON DISK. ^TO INDICATE AN
.INDEX END-OF-FILE
.INDEX ^^CTRL/Z\\
END-OF-FILE DURING SUCH AN OPERATION, TYPE
^C^T^R^L/^Z, WHICH WILL CLOSE THE OUTPUT
FILE AND ALLOW THE KEYBOARD TO ACCEPT FURTHER
COMMANDS.
.SKIP 2
.PARAGRAPH
.INDENT -5
^^SPOOLING FILES\\
.SKIP 1
^IT IS OFTEN DESIRABLE TO HAVE A LINE PRINTER LISTING
OF A FILE. ^IN ORDER TO OBTAIN SUCH A LISTING, THE
USER SHOULD ^^NOT\\ TRANSFER A FILE TO THE LINE
PRINTER. ^FOR EXAMPLE,
.SKIP 1
.INDENT 10
^^LP1:=FILE.LST\\
.SKIP 1
^^IS NOT RECOMMENDED PRACTICE.\\ THE USER SHOULD
.INDEX SPOOL /^^SP\\
INSTEAD "SPOOL" THE FILE TO THE LINE PRINTER
WITH THE USE OF THE ^^/SP\\ SWITCH:
.SKIP 1
.INDENT 10
^^FILE.LST/SP\\
.SKIP 1
^IN THIS WAY, ^P^I^P WILL RETURN TO THE USER ALMOST
IMMEDIATELY, WHEREAS THE FORMER METHOD
FORCES THE USER TO WAIT UNTIL THE TRANSFER HAS
COMPLETED.
.PARAGRAPH
^IN SPOOLING, ALL FILES WITH THE FILENAME ^^LP\\,
AND ALL FILES OF THE TYPE ^^DMP\\ ARE DELETED 
AFTER THEY HAVE BEEN PRINTED. ^THEREFORE:
.SKIP 1
.INDENT 10
^^DK2:LIST.DMP;1/SP\\
.SKIP 1
CAUSES THE FILE ^^LIST.DMP;1\\ ON ^D^K2: TO BE PRINTED 
ON THE LINE PRINTER, AND DELETED;
.SKIP 1
.INDENT 10
^^DK1:LIST.LST;2/SP\\
.SKIP 1
CAUSES THE FILE ^^LIST.LST;2\\ ON ^D^K1: TO 
BE PRINTED ON THE LINE PRINTER, BUT NOT DELETED.
.PARAGRAPH
.INDENT -5
^^RENAMING FILES\\
.SKIP 1
.INDEX RENAMING FILES
.INDEX RENAME /^^RE\\
.INDEX SWITCHES
^THE RENAME SWITCH IS PROVIDED TO ALLOW THE 
USER A MEANS OF CHANGING THE NAME OF A FILE ON DISK.
^THE GENERAL FORM OF THE COMMAND IS:
.SKIP 1
.INDENT 10
^^NEW FILENAME = OLD FILENAME\\
.SKIP 1
WITH THE /^R^E ON EITHER SIDE OF THE "EQUALS"
(=) SIGN. ^FOR EXAMPLE:
.SKIP 1
.INDENT 10
^^DK0:FILE/RE=DK0:ALICE\\
.PARAGRAPH
^THE FILES MUST RESIDE ON THE SAME DEVICE,
SINCE NOTHING IS MOVED, ONLY THE NAME
IS CHANGED.
.SKIP 1
.TEST PAGE 10
.PARAGRAPH
.INDENT -5
^^DELETING FILES\\
.INDEX DELETING FILES
.INDEX DELETE /^^DE\\
.INDEX SWITCHES
.SKIP 1
^THE DELETE SWITCH IS PROVIDED TO ALLOW THE
USER A MEANS OF DELETING ONE OR MORE FILES FROM DISK.
^THE SIMPLE FORM OF THE COMMAND CONSISTS OF 
A ^^COMPLETE\\ FILE
SPECIFIER FOLLOWED BY THE /^^DE\\ SWITCH. ^FOR
EXAMPLE:
.SKIP 1
.INDENT 10
^^DK0:FILE.TMP;3/DE\\
.SKIP 1
WILL DELETE THE FILE NAMED "^^FILE.TMP;3"\\.
.PARAGRAPH
^^NOTE:\\ ^THE VERSION NUMBER ^^MUST\\
BE SPECIFIED EITHER AS THE CORRECT NUMBER TO DELETE ONE
FILE, OR AS AN ASTERISK TO DELETE ALL FILES
OF THE SAME NAME AND TYPE.
.INDEX TYPE
.INDEX FILE TYPE

.SKIP 1
.PARAGRAPH
^IN ADDITION TO THE ^^/DE\\ SWITCH, THERE IS A SWITCH
.INDEX DELETE /^^DE\\
WHICH ENABLES THE USER TO PURGE HIS DIRECTORY, DELETING
OBSOLETE VERSIONS OF FILES. ^THE FORMAT OF THE SWITCH IS:
.SKIP 1
.INDENT 15
.INDEX PURGE /^^PU\\
.INDEX SWITCHES
.INDEX PURGING FILES
^^/PU[:\\N]
.SKIP 1
WHERE N INDICATES THE NUMBER OF VERSIONS
TO BE RETAINED. ^FOR EXAMPLE:
.SKIP 1
.LEFT MARGIN 23
.INDENT -18
^^DK0:FILE.TMP/PU\\###  WILL DELETE ALL BUT THE MOST
RECENT VERSION OF FILE ^^FILE.TMP\\ ON ^^DK0:.\\
.SKIP 1
.INDENT -18
^^DK1:FILE.TMP/PU:2\\# WILL DELETE ALL BUT THE LAST TWO
VERSIONS OF ^^FILE.TMP\\ ON ^^DK1:\\.
.SKIP 1
.INDENT -18
^^DK2:FILES.*/PU\\#### WILL DELETE ALL BUT THE LATEST VERSION
OF ALL FILES ON ^^DK2:\\ WHOSE NAMES ARE ^^FILES\\.
.SKIP 1
.LEFT MARGIN 5
^USERS ARE ENCOURAGED TO PURGE THEIR FILES AT
THE END OF EACH TERMINAL SESSION.
.SKIP 2
.LEFT MARGIN 5
.TEST PAGE 20
.PARAGRAPH
.INDENT -5
^^DIRECTORY LISTINGS\\
.INDEX DIRECTORY LISTINGS
.SKIP 1
^A LISTING OF THE DIRECTORY OF ALL OR CERTAIN
SELECTED FILES ON ANY FILE STRUCTURED DEVICE
CAN BE PRINTED ON THE TERMINAL OR STORED
IN A FILE (^P^I^P ASSUMES
THE TERMINAL AS THE DIECTORY OUTPUT DEVICE
UNLESS ANOTHER DEVICE IS
SPECIFIED):
.LEFT MARGIN 15
.PARAGRAPH
.INDENT -3
1. ^DIRECTORIES CAN BE OBTAINED BY TYPING
.SKIP 1
.INDENT 10
.INDEX SWITCHES
.INDEX DIRECTORY /^^LI\\
.INDEX LIST DIRECTORY /^^LI\\
^^/LI\\
.PARAGRAPH
^THE RESULTING DIRECTORY LISTING CONTAINS:
TWO TITLE LINES TO IDENTIFY THE DEVICE,
.INDEX ^^UIC\\ (^USER ^IDENTIFICATION ^CODE)
^U^I^C, AND THE DATE; FOLLOWED BY
ALL FILES IN THE DIRECTORY, WITH
THE NUMBER OF BLOCKS PER FILE (FOLLOWED
.INDEX CONTIGUOUS FILES
BY A ^C IF THE FILE IS CONTIGUOUS,
.INDEX LOCKED FILES
OR AN ^L IF THE FILE IS LOCKED),
AND THE FILE CREATION DATE; FOLLOWED BY THE
TOTAL NUMBER OF
BLOCKS AND FILES FOR THAT ^U^I^C.
.PARAGRAPH
^DIRECTORIES OF SPECIFIED DEVICES
CAN BE OBTAINED AS WELL AS DIRECTORIES
FOR OTHER USERS' FILES:
.SKIP 1
.INDENT 10
^^DK1:/LI
.INDENT 10
DK0:[30,50]/LI\\
AND DIRECTORY INFORMATION CAN BE OBTAINED
ABOUT ONE OR MORE FILES BY SPECIFYING 
ONE OR MORE FILES WITH THE /^L^I SWITCH:
.SKIP 1
.INDENT 10
^^DK0:FILE/LI
.INDENT 10
^^DK0:FILE1,FILE2,DK1:FILE3/LI
.INDENT 10
^^DK2:*.OBJ/LI\\
.PARAGRAPH
^THE LAST EXAMPLE WILL GIVE DIRECTORY INFORMATION
ON ALL FILES ON ^D^K2: UNDER THE CURRENT DIRECTORY
WITH TYPE ".^O^B^J".
.SKIP 1
.TEST PAGE 5
.PARAGRAPH
.INDENT -3
.INDEX BRIEF DIRECTORY /^^BR\\
2. ^BRIEF DIRECTORIES CAN BE OBTAINED USING THE
SWITCH "/^B^R" RATHER THEN "/^L^I".
^FOR BRIEF DIRECTORIES, ONLY THE FILENAMES
AND TYPES ARE LISTED.
.SKIP 1
.PARAGRAPH
.INDENT -3
.INDEX FULL DIRECTORY /^^FU\\
3. ^FULL DIRECTORY LISTINGS CAN BE OBTAINED
USING THE SWITCH "^^/FU\\" RATHER THAN "/^L^I"\\.
^FULL DIRECTORIES LIST THE FILE NAME, TYPE AND 
VERSION NUMBER, THE FILE IDENTIFICATION CODE, THE
SIZE OF THE FILE AND THE NUMBER OF BLOCKS USED, THE
.INDEX ^^UIC\\ (^USER ^IDENTIFICATION ^CODE)
.INDEX FILE PROTECTION CODE
.INDEX FILE IDENTIFICATION CODE
CREATION DATE AND TIME, THE FILE OWNER ^^UIC\\, AND
THE FILE PROTECTION CODE.

.PAGE
.CENTER
^^APPENDIX A
.SKIP 1
.CENTER
PIP SWITCH OPTIONS\\
.LEFT MARGIN 0
(^THIS IS ONLY A LIST OF THOSE SWITCHES
WHICH ARE COMMONLY USED)
.SKIP 1
.NOJUSTIFY
.NOFILL
^^SWITCH    SWITCH                OPERATION
 CODE      NAME
.SKIP 1
.LEFT MARGIN 1
.RIGHT MARGIN 80
^^/AP     APPEND      \\ ADD FILES TO THE END OF AN EXISTING FILE.
.SKIP 1
^^/BR     BRIEF       \\ LIST ONLY FILE NAMES AND TYPES IN THE
^^        DIRECTORY   \\ DIRECTORY OF THE DEVICE(S) SPECIFIED.
.SKIP 1
^^/CO     CONTIGUOUS  \\ CREATE A CONTIGUOUS FILE.
.SKIP 1
^^/DE     DELETE      \\ DELETE THE FILE(S) SPECIFIED.
.SKIP 1
^^/FU     FULL        \\ LIST A FULL DIRECTORY, GIVING THE FILE
^^        DIRECTORY   \\ NAME, TYPE AND VERSION NUMBER, FILE SIZE
                     AND NUMBER OF BLOCKS USED, CREATION DATE
                     AND TIME, FILE IDENTIFICATION CODE, THE
                     OWNER'S ^^UIC\\, AND THE FILE PROTECTION CODE
                     FOR EACH FILE.
.SKIP 1
^^/LI     DIRECTORY   \\ LIST THE DIRECTORY OR A SUBSET THEREOF
                     FOR THE DEVICE(S) SPECIFIED. ^THIS INCLUDES:
                     FILENAMES, TYPES, FILE SIZE, AND CREATION
                     DATE AND TIME FOR EACH FILE.
.SKIP 1
^^/NV     NEW         \\ FORCE THE VERSION NUMBER OF THE OUTPUT
^^        VERSION     \\ FILE TO THE LATEST VERSION PLUS ONE.
.SKIP 1
^^/PU:\N   PURGE      \\  DELETE OBSOLETE VERSION(S) OF A FILE.
.SKIP 1
.SKIP 1
^^/RE     RENAME      \\ RENAME THE INPUT FILE TO THE NAME GIVEN
                     AS THE OUTPUT FILE (NO COPY OCCURS).
.SKIP 1
^^/SP:\N   SPOOL      \\  SPOOL FILE(S) TO THE LINE PRINTER.
.SKIP 1
^^/SU     SUPERSEDE   \\ CAUSE THE INPUT FILE HAVING THE SAME NAME
                     AS A FILE ON OUTPUT DEVICE
                     TO REPLACE THAT OUTPUT FILE.
.SKIP 1
^^/UN     UNLOCK      \\ UNLOCK THE USER FILE DIRECTORY TO
                     ALLOW ACCESS TO THE FILE SPECIFIED.
.LEFT MARGIN 10
.RIGHT MARGIN 60

.PAGE
.CENTER
^^APPENDIX B
.CENTER 
STANDARD FILE TYPES
.SKIP 1
.LEFT MARGIN 14
TYPE        ATTRIBUTE
.SKIP 1
.LEFT MARGIN 14
BAS     BASIC SOURCE
BAT     BATCH COMMANDS
CIL     CORE IMAGE LIBRARY
CMD     INDIRECT COMMANDS 
CRF     INPUT TO CROSS-REFERENCING PROGRAM
DAT     DATA FOR FORTRAN PROGRAM
DGN     DIAGNOSTIC MESSAGES
DMP     DUMP
DOC     DOCUMENTATION
FCL     FOCAL SOURCE 
FLL     FLECS LISTING 
FLX     FLECS SOURCE 
FTN     FORTRAN SOURCE 
GLD     GT40 ABSOLUTE LOAD MODULE
LCL     LINKED CORE IMAGE LIBRARY
LDA     LOAD MODULE, ABSOLUTE
LDR     LOAD MODULE, RELOCATABLE
LOG     LOGGING INFORMATION
LSP     LISP SOURCE 
LST     LISTING 
MAC     MACRO ASSEMBLER SOURCE 
MAP     MAP (TKB OUTPUT)
MLB     LIBRARY OF MACROS
OBJ     OBJECT FILE
ODL     OVERLAY DESCRIPTION
OLB     LIBRARY OF OBJECT MODULES
PLT     PLOT DESCRIPTION (PDF)
RNO     RUNOFF SOURCE
RST     RASTER FILE
SML     SYSTEM MACRO LIBRARY
SPL     SPOOLER COMMANDS
STB     SYMBOL TABLE (TKB OUTPUT)
SYS     SYSTEM MANAGEMENT
TMP     TEMPORARY SCRATCH FILE
TSK     TASK IMAGE
\\
.LEFT MARGIN 0
.FILL

.PAGE
.SKIP 1
.INDENT 10
^^INDEX\\
.SKIP 3
.PRINT INDEX