PIP	PERIPHERAL INTERCHANGE UTILITY PROGRAM

GENERAL COMMENTS ON PIP COMMANDS

1) ALL SPACES, TABS, AND THE COMMAND LINE DELIMITER ARE IGNORED.

2) INPUT SPECIFICATIONS ARE OF THE FORM:
	DEV:[ACCT]NAME.EXT

	DEFAULTS ARE:
	 NO SPECIFICATION	LAST SPECIFICATION IS USED
				(INITIAL DEFAULT IS 'DF:')
	 DEV:			DEVICE 'DF:'
	 [ACCT]			CURRENT USER'S ACCOUNT
	 NAME			NO DEFAULT POSSIBLE
	 EXT			EXTENSION '.BAS'
	NOTE THAT NON-FILE-STRUCTURED INPUT DEVICES
	(I.E. KB:, PR:, CR:) IGNORE THE 'NAME.EXT'

3) OUTPUT SPECIFICATIONS ARE OF THE FORM:
	DEV:[ACCT]NAME.EXT<PROT>

	DEFAULTS ARE:
	 NO SPECIFICATION	SPECIFICATION OF 'KB:'
	 DEV:			DEVICE 'DF:'
	 [ACCT]			CURRECT USER'S ACCOUNT
	 NAME			NO DEFAULT POSSIBLE
	 EXT			NO DEFAULT POSSIBLE
	 <PROT>			PROTECTION OF '<60>'
	NOTE THAT NON-FILE-STRUCTURED OUTPUT DEVICES
	(I.E. KB:, PP:, LP:) IGNORE THE 'NAME.EXT'

4) OPTION SPECIFICATIONS ARE OF THE FORM:
	/OPTION:ARGUMENT

	OPTIONS BEGIN WITH A SLASH (/) AND TERMINATE WITH
	A COMMA (,), A LESS THAN SIGN (<), ANOTHER SLASH (/),
	OR THE END-OF-LINE. A TERMINATOR OTHER THAN
	END-OF-LINE MEANS THAT THE TERMINATOR ALSO STARTS
	SOME MORE OF THE COMMAND LINE. FOR INSTANCE:

		LP:/FA<CR:
		LP:<CR:/FA

	ARE THE SAME IN MEANING.

	THE ARGUMENT FOR AN OPTION IS OPTIONAL, REQUIRED, OR
	MUST NOT APPEAR DEPENDING ON THE OPTION.

	THE DEFAULT OPTION IS A NORMAL MODE FILE TRANSFER.

5) EXIT FROM PIP WITH CONTROL/C OR CONTROL/Z AT COMMAND TIME.

THERE ARE FIVE MAJOR PIP COMMAND CATAGORIES:

1) FILE TRANSFERS INCLUDING MERGES

	* OUTPUT < INPUT0, INPUT1, ..., INPUTN /OPTION

	IF THERE ARE MULTIPLE INPUT SPECIFICATIONS THEY ARE MERGED
	INTO A SINGLE OUTPUT SPECIFICATION.

	THE OPTIONS ARE:

	NO OPTION	NORMAL (ASCII) FILE TRANSFER MODE

	/FA		FORMATTED ASCII MODE
			(NULLS, PARITY AND RUBOUTS ARE IGNORED)

	/BL		BLOCK MODE USING DEFAULT BLOCK SIZES

	/BL:N		BLOCK MODE USING BLOCK SIZE N (IN BYTES)

	/CO		CONTIGUOUS MODE WITH PARTIAL BUFFER NULL FILL

	/CO:T		CONTIGUOUS MODE WITH PARTIAL BUFFER LOST

	EXTRA OPTIONS ARE:

	/CL:N		SET CLUSTER SIZE TO N

	/GO		IGNORE 'USER DATA ERROR ON DEVICE' ERRORS

	/HE		APPENDS '$PIP.TXT' TO COMMAND LINE
			(FOR THE HELP MESSAGES)

	/UP		UPDATE FILE
			('OPEN AS FILE' USED FOR OUTPUT FILE)

2) FILE DELETIONS

	* INPUT0, INPUT1, ..., INPUTN /DE

	THE INPUT SPECIFICATIONS ARE DELETED.

3) FILE RENAMES

	* NEW = OLD, = OLD <PROT>, ... /RE

	NEW = OLD CASE:
	 'OLD' SPECIFIES AN EXISTING DEVICE/FILE AND 'NEW' SPECIFIES
	 WHAT NEW NAME, EXTENSION AND/OR PROTECTION TO SET THE
	 'OLD' FILE TO.

	= OLD <PROT> CASE:
	 'OLD' SPECIFIES AN EXISTING DEVICE/FILE AND '<PROT>' SPECIFIES
	 WHAT NEW PROTECTION TO SET THE 'OLD' FILE TO.

4) ZERO DEVICE DIRECTORIES

	* DEV:[ACCT], ... /ZE

	ZEROS (CLEARS) THE SPECIFIED DEVICE(S)/ACCOUNT(S).

5) LIST DEVICE DIRECTORIES

	* INPUT0, INPUT1, ..., INPUTN /OPTION

	OPTIONS ARE:

	/BR		BRIEF DIRECTORY LISTING
			(ONLY THE NAME AND EXTENSION IN A FOUR
			ACROSS THE PAGE FORMAT)

	/DI		NORMAL DIRECTORY LISTING
			(NAME, EXTENSION, LENGTH, PROTECTION,
			AND DATE OF CREATION)

	/DI:S		FULL DIRECTORY LISTING
			(FOR DISK: NAME, EXTENSION, LENGTH, PROTECTION,
			DATE OF CREATION, TIME OF CREATION, DATE OF
			LAST ACCESS, FILE CLUSTER SIZE)
			(FOR TAPE: NAME, EXTENSION, LENGTH, PROTECTION,
			DATE OF CREATION)

	THE INPUT SPECIFICATIONS ARE DECODED AS FOLLOWS:

	NO NAME.EXT	ALL FILES ON DEVICE
	*.*		ALL FILES ON DEVICE
	NAME.*		ALL FILES OF SAME NAME
	*.EXT		ALL FILES OF SAME EXTENSION
	NAME.EXT	ONLY FILE OF THAT NAME.EXT

	TO DIRECT THE LISTING TO ANOTHER DEVICE USE:

	* OUTPUT < INPUT0, INPUT1, ..., INPUTN /OPTION

END OF PIP.TXT

                                                                                                                                                                                                                                                                                                                                          