				PDP HELP

PDP is a librarian utility to transfer source programs to and from the 
library account and the user's account.  

To copy a program from the library account to your account enter either:

PDP program/CO <CR>
OR
PDP <CR>
> program/CO <CR>

This will take the "program" specified from the library to your account.
It will also prevent anyone else from also taking a copy.  If someone 
already has a program taken from the library, a message containing the 
account, date, and time that program was taken will be displayed.

If the switch "/RO" (READ ONLY) is also appended after "/CO" the file is 
copied, but it cannot be replaced into the library since the intent is to 
only look at the program listing.


------------------------------------------------------------------------------
 THIS IS THE ONLY METHOD AVAILABLE TO OBTAIN PROGRAM SOURCES FROM THE LIBRARY!
------------------------------------------------------------------------------

You cannot replace a source taken with the "/RO" switch.
To replace an unmodifed source that was taken without the "/RO" switch enter 
either:

PDP program/NOCHANGE
OR
PDP <CR>
> program/NOCHANGE

This will not replace the program, command file nor the overlay description
files but will remove the lock flag that has been set to prevent others to 
extract the program.

This will however delete all the "program" name files in your account.
----------------------------------------------------------------------------

To replace a modifed source (.B2S), task (.TSK), command file (.CMD), and 
overlay description file (.ODL) enter the following command line with the 
appropriate switches.

PLEASE NOTE:	THE PROGRAM MUST BE COMIPLED TO A TASK BEFORE REPLACING

PDP program/RE
OR
PDP <CR>
> program/RE

When replacing a modifed version of the program the normal defaults are:

	/TSK	- save current task as ".TSV" and install new one
	/CMD	- save current command file as ".CSV" and install new one
	/ODL	- save current overlay description file as ".OSV" and
		  install new one

	a valid prefix on these three switches are "NO" which inhibits the
	save - install sequence and lets the existing module remain unchanged

Also this will remove the lock flag to allow the program to be extracted.

This will delete all the "program" name files in your account.

------------------------------------------------------------------------------
THIS IS THE ONLY METHOD OF REPLACING MODULES BACK INTO PRODUCTION AND LIBRARY!
------------------------------------------------------------------------------

******************************************************************************
	NOTE:	If (when) a new compiled version of a program is replaced,
		and at 2:00 AM you get a call, there is an easy way to
		have the operator move the 'TSV' version of the program
		back into production, and move the current task to a 'BAD'
		file.  The '/EXCHANGE' switch will do this for you.
		This is only a temporary fix since it does not move the
		source or any other files around.  The bad source is still
		the current one you will get when you '/CO' out of the
		library!!!
*******************************************************************************

When working with "MAP" or "SUBROUTINE" files you must append special 
switches to allow the librarian to know not to look for CMD or ODL files 
when both copying and replacing these modules.

	/NOBLD		- B2S's with out CMD or ODL files (no BLD file)
	/MAP		- maps or common statements 
	/SUBROUTINE	- subroutines only


For /MAP option only a source is required to be in your account when 
replacing that module.  For /SUBROUTINE there must be a source and an 
OBJ file.  A similar way to replace a MAP or OBJ without changing the 
current production source or OBJ is to append one or the other of the 
following switches:

	/NOOBJ		- does not replace object but will replace source 
	/NOCHANGE	- does not replace either source or object 

------------------------------------------------------------------------------
	COMPETE LIST OF SWITCHES 
------------------------------------------------------------------------------

	/COPY		- copies source (CMD and ODL if applicable) to
			  current  user's account
	/RO		- used with /COPY, copies file(s) but file(s) 
			  cannot be replaced


	/MAP		- used only when source is file map, copies and
			  replaces only the .B2S
	/SUBROUTINE	- used only when source is a subroutine, copies 
			  only .B2S, but will replace .B2S and .OBJ
	/BAS		- looks for a BASIC program source when /CO,
			  looks for a .BAS and .BAC when /RE
	/B2S		- DEFAULT, looks for a BASIC PLUS TWO source, .CMD 
			  and .ODL for /COPY, .B2S, .CMD, .ODL and .TSK
			  when /REPLACING
	/NOBA		- not a BASIC program
	/NOB2S		- not a BASIC PLUS TWO program
	/NOBLD		- does not look for a BLD file which contains
			  the CMD and ODL files


	/EXCHANGE	- moves the current task to a 'BAD' file and 
			  puts in its place the 'TSV' version of the
			  program (moves only the tasks, nothing else)

	/NOCHANGE	- when copied program, but no changes were made 
			  use this switch NOT '/REPLACE' when putting 
			  program back into library


	/REPLACE	- take modified file(s), and put them back into 
			  library, after saving current versions to a 
			  'saved' version
	/TSK		- DEFAULT, when replacing "DO" replace the
			  production task
	/CMD		- DEFAULT, when replacing "DO" replace the
			  production .CMD file
	/ODL		- DEFAULT, when replacing "DO" replace the
			  production .ODL file
	/NOTSK		- when replacing "DO NOT" replace production task
	/NOCMD		- when replacing "DO NOT" replace production .CMD
	/NOODL		- when replacing "DO NOT" replace production .ODL
	/REX		- when replacing, replace only production files,
			  "DO NOT" not save current production files to a
			  'save' file
	/NEW		- new program being added to library, must have
			  all defaults unless correct "NO" switch(es)
			  is/are specified

	/WA		- watch progression of file transfers
	/LO		- watch progression of file transfers


	/LI		- list only those programs that are checked out 
			  (privileged)
	/FU		- list all programs, all history (privileged)
	/UP		- manual update of PDPLBR.IND file (privileged)
