(Text prepared with OS/2 System Editor: Font = System Monospaced, Size = 10)

PASSWORD PACKAGE Version 1.1, 16 April 1996 (public domain).
 
Designed for single-system, multi-user environments, this package establishes
an "open" DeskTop giving password-protected access to multiple WorkAreas or
"pseudo DeskTops".  Only standard OS/2 facilities and simple REXX scripts are
used.  Although not absolute, the password protection should be adequate for
most non-critical environments.  A step-by-step procedure for creating this
password protection is provided.

Author:	John Seitz, CompuServe 100424,3215 (100424.3215@compuserve.com).

The code and techniques in this package are NOT copyrighted, and may be
freely	used, copied, modified, or redistributed by anyone.  The author
accepts NO responsibility for the package, but would appreciate bug reports,
suggestions for improvement, comments, etc.

Changes in 1.1:	STARTUP.CMD and PASSWORD.CMD are unchanged.  GETWRK01.CMD
		entirely replaces both OPNWRK01.CMD and CPWWRK01.CMD.
		README.TXT has been modified to reflect changes in procedure
		and for clarification.  PASSWORD.DIZ has been added as
		additional documentation.		          
		
The package consists of a set of five files:

	README.TXT	(This file.)  A step-by-step procedure for
			establishing an open DeskTop with multiple
			password-protected WorkAreas.

	STARTUP.CMD	A REXX script which loads REXX functions and, using
			ASCII ESC sequences, initialises the OS/2 screen.
			(One per system, may be added to an existing
			STARTUP.CMD file or used without modification.)

	GETWRK01.CMD	A REXX script which, from an open OS/2 DeskTop, calls
			the main password script to initialise or check a
			password and, if successful, to open a protected
			WorkArea, or, from within a protected WorkArea, to
			change a password.  (Use as a model, one per
			WorkArea.)

	PASSWORD.CMD	A REXX script which initialises, checks, or changes
			the password for a protected WorkArea.  (One per
			system, may be used without modification.)

	PASSWORD.DIZ	A file of ASCII text in lines of 40 characters or
			less, containing a brief description of the package,
			designed for use by BBS filemanager programs.

*** PROCEDURE FOLLOWS ***

Note:  	C:\ is assumed throughout to be the root directory of the boot
	partition.  DESKTOP is assumed throughout to be the name of the
	DeskTop directory.  If not, amend the procedure and REXX scripts
	accordingly.

01	Copy STARTUP.CMD into C:\.  If such a file already exists, copy the
	contents of STARTUP.CMD, less the 'EXIT', into that file.  (The REXX
	functions MUST be loaded and ASCII ESC sequences enabled BEFORE the
	various password scripts are run.)

02	Copy PASSWORD.CMD into C:\.

03	Using GETWRK01.CMD as a model, make as many copies as there are to be
	WorkAreas and store them in C:\, giving each a unique name, i.e.,
	GETWRK01.CMD, GETWRK02.CMD, ... GETWRKnn.CMD.  In each: change
	GETWRK01 in the title comment to GETWRKnn, change GETWRK01 in the
	CALL 'C:\PASSWORD.CMD' to GETWRKnn, and change WRK01 in the CALL
	SysSetObjectData to WRKnn, where 'nn' is the unique portion of the
	file name (and will form a unique WorkArea title). 

(At this point STARTUP.CMD and PASSWORD.CMD should have been stored in C:\,
together with one unique modified version of GETWRK01.CMD for each WorkArea
to be created.  NONE of these should (yet) appear on the DeskTop.)

04	For each intended WorkArea, from the OS/2 Templates drag the Program
	template to the DeskTop to create a Program Reference Object to
 	access the WorkArea.  Open its Settings, and modify them as follows:

		Path and File Name:  Enter C:\GETWRKnn.CMD, where 'nn' is the
		unique portion of the file name.

		Optional Parameters:  Enter CHK.

		Session:  Select OS/2 Full Screen.

		Association:  Select OS/2 Command File.

		General:  Create a unique Title and Icon.  Make a note of the
		title for use in step 10 below.

	Note:	Alternatively, use the Program object to create a template,
		and then use that template to create the rest.

05	Drag a shadow of each "WorkArea access" Program Reference Object into
	the LaunchPad, creating a bar button (only shadows can be placed in
	the LaunchPad).  (Some temporary overcrowding of the LaunchPad may
	result.  Later, all but the new "WorkArea access" Program Reference
	Object shadows will be	removed from the LaunchPad.)

06	For each intended WorkArea, from the OS/2 Templates drag the Folder
	template to the DeskTop to create a WorkArea Object.  Open its
	Settings, and modify them as follows:

		View:		Icon View:	Non-Grid, Normal Size.
				Tree View:	Lines, Normal Size.
				(All Views):	Check Visible and Transparent
						Background on all pages where
						present.


		Background:	Check Color Only.

		File:		Physical Name:	Path:  C:\DESKTOP
						Name:	WRKnn, where 'nn' is
						the unique portion of the
						WorkArea name.

		General:	Title:		WRKnn, where 'nn' is the
						unique portion of the
 						WorkArea name.
				Icon:		Leave the default icon.

07	From the current DeskTop (or elsewhere, as needed), drag each
	non-password object or shadow to its appropriate WorkArea(s).  (This
	should include all objects in the LaunchPad other than its new
	"WorkArea access" Program Reference Objects shadows, and leaves the
	DeskTop empty, except for the LaunchPad, "WorkArea access" Program
	Reference Objects, and WorkAreas.

(Although not a necessary step, it has been found it useful to create a
folder entitled Resources, place ALL original non-password objects in it, and
then use only shadows of these objects to equip the WorkAreas.  Later, the
Resources folder itself can be hidden well inside a WorkArea.)

08	For each intended WorkArea, from the OS/2 Templates drag the Program
	template to the DeskTop and create a Program Reference Object to
 	change the password.  Open its Settings, and modify them as follows:

		Path and File Name:  Enter C:\GETWRKnn.CMD, where 'nn' is the
		unique portion of the file name.

		Optional Parameters:  Enter CHG.

		Session:  Select OS/2 Full Screen.

		Association:  Select OS/2 Command File.

		General:  Create a common Title, i.e., Change Password, and a
		common Icon for password changing, and use it for each
		"password changing" Program Reference Object.

	Note:	Alternatively, use the Program object to create a template,
		and then use that template to create the rest.

09	Drag each "password changing" Program Reference Object into its
	appropriate WorkArea folder on the DeskTop, i.e., the one with Path
	and Filename C:\GETWRK01.CMD to WRK01, C:\GETWRK02.CMD to WRK02, etc.

10	Open the DeskTop Settings, and modify them as follows:

		DeskTop:	Icon View:	Non-Grid, Normal Size.
				Tree View:	Lines, Normal Size.
				(All Views):	Check Visible and Transparent
						Background on all pages where
						present.

		Include:	In Criteria System, add one entry for each
				"WorkArea access" Program Reference Object
				and one entry for each WorkArea, as follows:

					Use:  E
					Attribute:  Object Title
					Comparison:  Is Equal To
					Value:  The unique WorkArea title,
						e.g., WRKnn, where 'nn' is
						the unique portion thereof
						(see Step 06 above) or the
						unique "WorkArea access"
						Program Reference Object
						title (see Step 04 above).
					Class:  Object

				In Criteria System, add one entry as follows:

					Use:  I
					Attribute:  Object Class
					Comparison:  Is Descended From
					Value:  WPFileSystem
					Class:  Object

		Background:	Tiled Image.

11	Open the LaunchPad Settings, and modify them as follows:

		Options:	Check Hide Frame Controls and Display Text
				on LaunchPad.  (Do NOT check any other
				Options.)

				If action buttons are NOT desired for LockUp,
				Find, ShutDown, and WindowList (the DeskTop
				pop-up menu can be used as an alternative),
				then select Do Not Display Action Buttons.

*** END OF PROCEDURE ***

If a non-protected WorkArea is desired, follow the procedure but: (1) edit
its GETWRKnn.CMD file to remove the ARG line, the 'CALL C:\PASSWORD.CMD'
line, and the 'IF parm' line and its 'THEN, leaving the remainder, i.e.,the
'CALL SysSetObjectData', and (2) do not create a "password changing" Program
Reference Object for it.

This procedure envisions each WorkArea having a single, password-protected
access from the DeskTop.  The same techniques can be adapted to provide for
multiple accesses, each with its own password.  The only non-obvious need
is for each such access to have an associated, unique password-changing
Program Reference Object in the WorkArea.

(Although not a necessary step, it has been found amusing to include the
System Clock and Pulse in the Startup Folder for display on the DeskTop.)

Note:	ASCII ESC sequences have been used in STARTUP.CMD and PASSWORD.CMD
	to effect more salubrious screen background/text colours.  These
	are cyan with black text for normal processing and red with white
	text for error messages.  With such sequences, the OS/2 'CLS'
	command MUST be used, as the REXX SysCls utility resets screen
	colours to the default.  Users desiring different colour combinations
	will find these (and many more useful and interesting topics) on
	CompuServe in "REXX Tips & Tricks, Version 2.10", an .INF file
	(RXTT21.EXE) in Library 15, REXX/Other Languages, OS/2 Developer
	Forum 1, GO OS2DF1.  The author is Bernd Schemmer, who also was kind
	enough to make several suggestions which resulted in the improved
	version of this package.
    

*** END OF TEXT ***
