PIP.SAV	Peripheral Interchange Program

PIP has the following features and defaults:

Wild card specifications for file names and extensions:

	PIP  accepts  the  asterisk  (*)  in  place of either file name,
	extension, or both. It is used as follows:
		FILE.*		All  files  with  name  'FILE'  and  any
				extension.
		   *.EXT	All files with extension 'EXT'
		   *.*		All files
	PIP  accepts  the question mark (?) in place of any character in
	the name or extension.
		FILE.EX?	All files with name 'FILE' and  'EX'  as
				first  2 characters of extension and any
				character (or blank) as third
		FILE??.EXT	All files with  4,  5,  or  6  character
				names,  the first 4 of which are 'FILE',
				and with extension 'EXT'
		FILE??.E??	Same as above for name and with  'E'  as
				the first character of the extension
		AB?.EXT		All  files  with  2 or 3 character names
				starting with 'AB', and  with  extension
				'EXT'
	PIP accepts both * and ? in a file specification:
		FILE??.*	All  files  with  name matching 'FILE??'
				and with any extension
		     *.EX?	All files with  name  matching  '??????'
				and with extension matching 'EX?'
	In absence of a full file specification, the defaults are:
		Spec	Default		Meaning
		null	  *.*		All files
		 *	  *.*		All files
		*.	  *.		All files with null extensions
		 .	  *.		All files with null extensions
		.EXT	  *.EXT		All   files   with   extension
					matching  'EXT'  (may be wild)
					and any name
		FILE   FILE.*		All  files  with name matching
					'FILE' (may be wild)  and  any
					extension
	PIP does not accept  wild  cards  in  [ACCT]  fields  except  on
	specifications applying to DOS magtape.

Output default specifications are:

      If missing:	  PIP uses:
	[ACCT]		Current user account
	DEV:		Device 'DK:'
	NAME		Input file name (i.e. '*' assumed)
	.EXT		Input extension (i.e. '*' assumed)
	<PROT>		Input  protection  (if disk) or current assigned
			default
      Entire spec	Current terminal (KB:)

Input default specifications are:

      If missing:	  PIP uses:
      Entire spec	Skips this specification
	DEV:		Immediately  previous  specification.  If  none,
			'DK:' is used.  Note that  ':'  means the public
			structure.
	[ACCT]		Current user account
	NAME		All files
	.EXT		All matching files with any extension
			(To specify explicitly null extension, use '.')
	<PROT>		Currently assigned default protection
			(Relevant only for renames)

File operation switches (valid on copy,  delete,  rename,  and directory
    operations):

	/IN		Inspects eligible files; type 'Y' to transfer or
			anything not beginning with 'Y'  to  omit.  Type
			CTRL/Z to quit command.
	/LO		Log all operations on the terminal
	/NO or /RW:NO	Disable rewind of magtape
	/HA		Stop magtape wild  card  search  as  soon  as  a
			mismatch  is  found (rather than spinning to end
			of tape)
	/VE		Print current PIP.SAV version number

    For date switches,  omitting the '-yy' means this year; omitting the
    ':dd-mmm-yy' means today.  More than one date switch is the  AND  of
    conditions (nothing matches if high limit < low limit)

	/AF:dd-mmm-yy	Include files created after (not on) date
	/BE:dd-mmm-yy	Include files created before (not on) date
	/SI:dd-mmm-yy	Include files created since (on or after) date
	/UN:dd-mmm-yy	Include files created until (before or on) date
	/ON:dd-mmm-yy	Include files created on specified date
	/TO		Include files created today

    For privileged users only:

	/LOCK		Lock job into memory during command line
	/PRIO		Execute command line at special run priority

File transfer option specifications:

	No option	Normal copy mode transfer,  i.e. block by block,
			preserving attributes. ASCII or Formatted Binary
			conversion  is  automatic  when transferring RMS
			files to non-disk
	/BL		Block by block transfer (normal  default).  Used
			to  override  automatic  conversion when copying
			RMS files to non-disk.
	/CL:n		Set cluster size of output file to  n.  Must  be
			adjacent  to output file.  If absent on disk-to-
			disk, cluster size is preserved.
	/MO:n		Set mode for open.  Must appear adjacent to file
			name. (Note: /MO:16 is disk contiguous file.)
	/GO or /IG	Ignore 'USER DATA ERROR ON DEVICE' errors
	/HE		Used alone to print this help message
	/UP		Update file in place (create new file if none)
	/EX or /AP	Append input file to output file (extend file)
	/PR		Protect  any existing output file; give error if
			output file already exists
	/NE		For disk output,  create new file  with  today's
			date.  Default  is to preserve creation date and
			time.

    For conversion to and from RMS files with attributes:

	/RMS		On input file, force conversion from RMS  format
			to  either  formatted ASCII or formatted binary,
			determined automatically.   This  conversion  is
			automatic  when  transferring  to  non-disk.  On
			normal disk-to-disk  transfers,  attributes  are
			copied.  On  output file,  force conversion from
			formatted  ASCII  or  formatted  binary  to  RMS
			variable length record file.  Cannot  appear  on
			both input and output files.
	/RMS:FA		Like /RMS, but use formatted ASCII conversion
	/RMS:FB		Like /RMS, but use formatted binary conversion
	/RMS:IM		For  input,  like /RMS but do no data conversion
			(Remove  record  lengths  from  variable  length
			records; remove padding bytes)

File deletion options:

    File deletion is specified by including /DE in  the  command.  Rules
    for  forming  file  names  are  the  same as for the input side of a
    transfer operation.

    Using the /WO switch instead of or in conjunction  with  /DE  writes
    zeros  on  the file before deletion.  /WO applies to all files being
    deleted. (/ER and /WI are synonyms for /WO.)

File rename options:

    File rename is specified by including /RE in the command.  Rules for
    forming file names are the same as for the input side of a  transfer
    operation. The input files are renamed to have the output file name.

    For rename commands, device and account on input are used on output.
    If  input is null,  all files in current account on public structure
    are renamed.

    To simply change protection code,  include the new protection on the
    input file and omit the output file specification.
	(E.g. FILE.EXT<40>/RE  changes only the protection code)

Listing device directories:

    To  list device directories,  include either the /LI (or /DI) switch
    for full listing or the /BR switch for a brief listing.

    Either switch can be followed by any combination  of  the  following
    options:

	:W		Wide directory listing
	:DI		Normal listing (:NA:EX:SI:PR:DA:HD:SU)
	:S		Slow directory - all of the below
	:NA		Include file name
	:EX		Include file extension
	:SI		Include file size
	:PR		Include protection code
	:LA		Include date of last access
	:DA		Include creation date
	:TI		Include creation date and time
	:CL		Include clustersize
	:HD		Include headers
	:SU		Include (only) summary data

Zeroing device directories:

    To zero a device directory,  include the /ZE switch.  Do not specify
    a  file  name  (except for ANSI magtape,  where the file name is the
    volume label).  Only privileged users can zero  another  account  on
    disk.

General features:

	Only 6 input specifications can appear per command line.

	To execute PIP commands in an indirect command  file,  type  '@'
	and the file specification as follows:

		@[ACCT]DEV:FILE.EXT

	Defaults are current account and extension 'CMD'.  No nesting of
	indirect files is allowed. Use ; in file to denote comment line.

End of PIPSAV.TXT for PIP.SAV
