Dec 052017
 
IBM's freely distributable WorkPlace Shell for Windows [Program Manager replacement]. Works on Win 3.1 and up [3.11, WFW 3.11, etc.].

Full Description of File


|File Description

JLA What can this thing do ?

=========================================
== ==
= WORKPLACE SHELL FOR WINDOWS 3 . 1 =
== ==
== V e r s i o n 1 . 0 ==
== ==
== ==
== Release Date : 01/05/95 ==
== ==
== ==
== Copyright IBM Corporation, 1994. ==
== All rights reserved ==
=========================================


File WPSWIN.ZIP from The Programmer’s Corner in
Category Recently Uploaded Files
IBM’s freely distributable WorkPlace Shell for Windows [Program Manager replacement]. Works on Win 3.1 and up [3.11, WFW 3.11, etc.].
File Name File Size Zip Size Zip Type
CNV_DUTC.DL_ 3385 3214 deflated
CNV_ENUS.DL_ 3385 3214 deflated
CNV_PORT.DL_ 3421 3242 deflated
CONVINI.EX_ 11252 10756 deflated
CTL3D.DL_ 11986 11617 deflated
FCLNBW.DL_ 27326 26450 deflated
FCLSPBW.DL_ 9974 9629 deflated
FILE_ID.DIZ 707 222 deflated
IBMWALL.BM_ 776 769 deflated
MSCOMSTF.DL_ 41320 39875 deflated
MSCUISTF.DL_ 12008 11574 deflated
MSDETECT.IN_ 4726 4487 deflated
MSDETSTF.DL_ 14949 14420 deflated
MSINSSTF.DL_ 40805 39262 deflated
MSSHLSTF.DL_ 9226 8914 deflated
MSUILSTF.DL_ 3970 3814 deflated
OS21ICON.DL_ 10064 9634 deflated
PMTOWP.EX_ 20945 20159 deflated
PTW_DUTC.DL_ 3644 3439 deflated
PTW_ENUS.DL_ 3644 3439 deflated
PTW_PORT.DL_ 3702 3499 deflated
README.1ST 17427 5650 deflated
SETUP.EXE 24624 13101 deflated
SETUP.LST 653 291 deflated
SETUPAPI.IN_ 13459 12756 deflated
WARPICON.DL_ 21743 20644 deflated
WNDLIST.EX_ 10906 10413 deflated
WPINST.IN_ 992 967 deflated
WPSHELL.EX_ 99900 96153 deflated
WPSHELL.HL_ 35953 34746 deflated
WPSINST.MS_ 8210 7872 deflated
WPS_DUTC.DL_ 7529 7219 deflated
WPS_ENUS.DL_ 7147 6844 deflated
WPS_PORT.DL_ 7503 7195 deflated
_MSSETUP.EX_ 7543 7125 deflated
_MSTEST.EX_ 55370 52520 deflated

Download File WPSWIN.ZIP Here

Contents of the README.1ST file


|File Description

JLA What can this thing do ?

=========================================
== ==
= WORKPLACE SHELL FOR WINDOWS 3 . 1 =
== ==
== V e r s i o n 1 . 0 ==
== ==
== ==
== Release Date : 01/05/95 ==
== ==
== ==
== Copyright IBM Corporation, 1994. ==
== All rights reserved ==
=========================================
========================================================================
== ==
== W O R K P L A C E S H E L L F O R W I N D O W S 3 . 1 ==
== ==
== V e r s i o n 1 . 0 ==
== ==
== ==
== Release Date : 01/05/95 ==
== ==
== ==
== Copyright IBM Corporation, 1994. All rights reserved ==
== ==
========================================================================

TABLE OF CONTENTS (in order of apperance):
==========================================

1) Minimum Program Requirements
2) Subscribing To Package
3) When You Encounter A Problem
4) Release File List
5) Installation (and Uninstallation) Instructions.
6) Editing Your SYSTEM.INI File
7) Editing Your WIN.INI File
8) Known Problems


------------------------------------------------------------------------
1) M I N I M U M P R O G R A M R E Q U I R E M E N T S
------------------------------------------------------------------------

Hardware:
Processor : Intel 80386SX (or compatible).
Memory : about 350K (when loaded and running).
Disk : about 650K after installation with all support files.
Video : Minimum of VGA (640x480 16 color).

Software:
DOS 5.x with Windows 3.1 or Windows for Workgroups 3.1 or higher.
-or-
OS/2 2.1x or higher (WPSFWIN is installed on Win-OS/2 full-screen session).


------------------------------------------------------------------------
2) S U B S C R I B I N G T O P A C K A G E
------------------------------------------------------------------------

Through OS/2 Developer Connection CD:

WPSFWIN will be updated quaterly through the OS/2 DEVCON CDs.
Call IBM to subscribe to this great CD product.


Through IBM VM:

Send requests for WPSHELL package to WPSFWIN at BCRVMPC2:

TOOLS SENDTO BCRVMPC2 WPSFWIN WPSFWIN GET WPSHELL PACKAGE


To subscribe to future updates of the package issue the command:

TOOLS SENDTO BCRVMPC2 WPSFWIN WPSFWIN SUBSCRIBE WPSHELL PACKAGE


------------------------------------------------------------------------
3) W H E N Y O U E N C O U N T E R A P R O B L E M
------------------------------------------------------------------------

To ask any questions, report any problems, or send any comments,
please append them to:

COMPUSERV : OS/2 Developers Connection forum.

IBM FORUM : WPSFWIN FORUM (in IBMPC conference disk).
and
WPSFWIN 941FORUM (archived appends from 3/94-6/94).

MAIL : WPS for Windows
IBM
Internal Zip 1211
1000 NW 51st Street
Boca Raton, FL 33431


NOTE: When sending a problem report please include the following
information in your note:
- Windows (3.1 or 3.11) and DOS (5.x or 6.x) versions.
- Computer manufacturer and model number.
- Video adapter manufacturer and resolution mode tested in.
- Amount of RAM memory.
- Processor type and clock speed.
- Any software that is automatically loaded by Windows.
(such as Adobe Type Manager (ATM), screen savers, ect...).


------------------------------------------------------------------------
4) R E L E A S E F I L E L I S T
------------------------------------------------------------------------

Files that make up this release of Workplace Shell for Windows are:

Run-time:
WPSHELL.EXE : Workplace Shell for Windows executable.
WNDLIST.EXE : Workplace Shell for Windows task manager replacement.
FCLNBW.DLL : IBM CUA Notebook control library.
FCLSPBW.DLL : IBM CUA Spin Button control library.
CTL3D.DLL : Microsoft 3-D controls library.
WARPICON.DLL : OS/2 WARP 3.0 icon library supplement.
OS21ICON.DLL : OS/2 2.1 icon library (old WPSHELL.EXE icon set).

Language-dependent:
WPS_XXXX.DLL : WPSHELL.EXE NLS resource library.
PTW_XXXX.DLL : PMTOWP.EXE NLS resource library.
CNV_XXXX.DLL : CONVINI.EXE NLS resource library.

Where "XXXX" is one of the following languages:
DANI : Danish.
DUTC : Dutch.
ENUS : English (US).
FREN : French (Canadian).
GRMN : German.
PORT : Portuguese (Brazilian).
SPAN : Spanish.
SWED : Sweeden.

Documentation:
README.1ST : (This file) "Read Me First" file containing basic
directions on what to do with this program.
WPSHELL.HLP : Workplace Shell for Windows help file.

Support Utilities:
CONVINI.EXE : Conversion utility for WPSHELL.INI files 0.5.x -> 1.0.
PMTOWP.EXE : Program Manager to Workplace Shell desktop migration
utility (always run from PROGMAN).
Optional:
IBMWALL.BMP : "IBM" Wallpaper for Windows (copy in \WINDOWS directory).



------------------------------------------------------------------------
5) I N S T A L L A T I O N I N S T R U C T I O N S
------------------------------------------------------------------------

First and foremost, If you receive a WPSHELL.ZIP file, uncompress it
using PKUNZIP (version 2.04e or above) into a diskette or directory.

(A) Automatic (recommended):
---------------------------

1) Run Workplace Shell for Windows installation program.
For example, if run from a diskette select "File" menu in
Program Manager and choose "Run...". Then, type "a:\setup.exe"
and press ENTER.

2) If this is an upgrade from a 0.5.x version, answer "Yes" when
asked if you want to upgrade. Then go to step (4).
If this is a new install, then answer "No". Then proceede
to step (3).

3) Choose Express setup (recommended).

4) After the installation has completed, it will restart Windows 3.1x
and the new shell will take effect. If you experience any problems
at this point, please refer to the "When You Encounter A Problem"
section above.


(B) Manual:
----------

1) Uncompress files listed in the "Release File List" above by using
EXPAND.EXE (in \DOS directory) and copy expanded files into a
destination directory (i.e. \WPSHELL).

Copy the following files in your \WINDOWS\SYSTEM directory:

FCLNBW.DLL : IBM CUA Notebook control library.
FCLSPBW.DLL : IBM CUA Spin Button control library.
CTL3D.DLL : Microsoft 3-D controls library.

Copy file WPSHELL.HLP into the \WINDOWS directory.

Copy NLS resource libraries that match the language you have installed
in Windows. Look in WIN.INI file "[Intl]" section, "sLanguage" key
and find out which language it is. Following are some of the language
codes used by Windows:

"sLanguage" Name Resource Library

dan Danish DANI
deu German GRMN
eng International English ENUS
enu U.S. English ENUS
esn Modern Spanish SPAN
esp Castilian Spanish SPAN
fin Finnish
fra French FREN
frc French Canadian FREN
isl Icelandic
ita Italian
nld Dutch DUTC
nor Norwegian
ptb Brazilian Portuguese PORT
ptg Portuguese PORT
sve Swedish SWED


2) Run PMTOWP.EXE from Program Manager's "File" -> "Run..." menu.

4) Manually change the following SYSTEM.INI entries in the [boot] section:

taskman.exe=taskman.exe (if any, most will not have this line)
shell=progman.exe

to

taskman.exe=\wndlist.exe (add if it does not exists)
shell=\wpshell.exe

(where is the directory where WPSHELL.EXE is stored).

5) Exit Windows and restart so that the new shell will take effect.
If you experience any problems at this point, please refer to the
"When You Encounter A Problem" section above.

Optional Step In Manual Installation:
------------------------------------

6) Copy IBMWALL.BMP to the \WINDOWS directory and using the
"Control Panel" -> "Desktop" application change the background bitmap
to it and check the "Tile" attribute.



(C) Uninstall Instructions:
--------------------------

1) If in Windows, exit Windows.

2) Edit SYSTEM.INI file in \WINDOWS directory and replace the following
lines:

taskman.exe=\wndlist.exe
shell=\wpshell.exe

with

taskman.exe=taskman.exe
shell=progman.exe

3) Restart Windows 3.1.

4) Remove the following files from your \WINDOWS\SYSTEM directory:

FCLNBW.DLL : IBM CUA Notebook control library.
FCLSPBW.DLL : IBM CUA Spin Button control library.


------------------------------------------------------------------------
6) E D I T I N G Y O U R S Y S T E M . I N I F I L E
------------------------------------------------------------------------

A "Workplace_Shell_for_Windows" section is created (and maintained)
automatically by WPSFWIN in your SYSTEM.INI file in the \WINDOWS directory.

The SYSTEM.INI file is where Windows 3.1 and other system-related
applications and drivers keep vital information that reflects or changes
the behavior of the system. This is a pure text file (ASCII-file) that
can be edited by any of your favorite ASCII editors (i.e. e, epm, edit).

WPSFWIN will create (if you edit the "System" settings notebook) a
Workplace Shell for Windows section in this file when you change any of
the "System" default settings. This section will look something like this
(and it will probably be at the end of the SYSTEM.INI file):

[Workplace_Shell_for_Windows]
DESKTOP_HorzIconIndent=23 (other values:0-32,000)
DESKTOP_VertIconIdent=5 (other values:0-32,000)
SYSTEM_ConfirmOnDelete=Yes (other values: No)
SYSTEM_ConfirmOnFolderDelete=Yes (other values: No)
SYSTEM_ButtonApperance=Minimize (other values: Hide)
SYSTEM_Animation=Enabled (other values: Disabled)
SYSTEM_MinBehavior=MinToViewer (other values: Hide and MinToDesktop)
SYSTEM_OpenBehavior=CreateNew (other values: DisplayExisting)
SYSTEM_SystemSetupFolderName=System Setup (depends on the language installed)
COLOR_ShadowText=00FF00 (other values: )

As you can see must of the entries in the section are self-explanatory.
The "ConfirmOnDelete" entry lets WPSFWIN know that you want to confirm
all delete operations done in the shell. "ConfirmOnFolderDelete" is
a sub-classed "ConfirmOnDelete", this means that if "ConfirmOnDelete" is
"No", the "ConfirmOnFolderDelete" will take precedence for delete operations
done on folder objects (recommened default settings is "Yes").

Also, The whole "Window" page in the "System" settings notebook is
listed. You can edit these entries manually if you want, but they won't
take effect until you restart Windows or open the "System" settings
notebook again and press "Default" on the "Windows" page.

Notice the "other values" possible in each entry in the WPSFWIN section.
These values can be case-insensitive.

The "COLOR_ShadowText" is a BGR triplet mapped to 2-digit hexadecimal
values. Each primary color can be a hexadecimal value from 00 to FF.
Therefore, if you want bright cyan, for example, you would want the Blue and
Green primary colors full brightness (hex. FF). So, the final SYSTEM.INI
entry for COLOR_ShadowText would be FFFF00.

If you are not familiar with the meaning of these values, refer to any
OS/2 2.x user's manual.

Also, I would like to explain the other entries made and used by WPSFWIN
in SYSTEM.INI:

[boot]
taskman.exe=\wndlist.exe
shell=\wpshell.exe

These two entries are the core of how WPSFWIN is able to substitute
PROGMAN "seamlessly". Windows 3.1 uses these two key entries to figure
out who will be handling the task management for the user, and who will
become the default Windows GUI shell to the user.

The entry "taskman.exe=\wndlist.exe" makes the WPSFWIN "Window
List" the default task manager. If you ever want to switch to the
original "Task Manager" that comes with Windows 3.1, just manually edit
this line and make it: "taskman.exe=taskman.exe". Just that simple!

The entry "wpshell.exe=\wpshell.exe" makes WPSHELL.EXE become
the default GUI for Windows 3.1. If you ever decide that WPSFWIN is not
the "cola" for you... just edit that statement to "shell=progman.exe".
Easy huh!?, and you don't even need a bottle opener!!



------------------------------------------------------------------------
7) E D I T I N G Y O U R W I N . I N I F I L E
------------------------------------------------------------------------

The "WPSFWIN System Event Sounds", just like its OS/2 counterpart
(but to a lesser degree), registers 5 system events when installed.
These event registrations are just 5 more lines in your WIN.INI file.
Just look for the "[sounds]" section of the file, and you'll find many
system events and the sounds (WAV files) associated with them listed.
At the bottom of the list, there should be 5 entries of this form
(if no associations have been done):

WPBeginDrag=,Workplace Shell Begin Drag
WPEndDrag=,Workplace Shell End Drag
WPFolderClose=,Workplace Shell Folder Close
WPFolderOpen=,Workplace Shell Folder Open
WPShred=,Workplace Shell Shred

Notice that there are no *.WAV files associated with them. The
easiest way to do it is by selecting the "Control Panel"'s "Sounds" program.
It will read the events for you and let you associate sounds to them.

If you ever want to edit the name of the events, edit the text at the
END of the line. For example if I wanted to change the description of
the "Workplace Shell Folder Close" event to "Close'em up!", here is what
you'll need to edit:

:
WPFolderClose=,Workplace Shell Folder Close

:
WPFolderClose=,Close'em up!

If you ever want to delete all events from you Windows 3.1 system,
delete all 5 lines and voila! They're gone.


------------------------------------------------------------------------
8) K N O W N P R O B L E M S
------------------------------------------------------------------------

8.1) The "Disappearing-Desktop" problem (or ATM-bug) is caused by
the automatic loading of the Adobe Type Manager (ATM) drivers
in SYSTEM.INI. We have been able to isolate the problem to the
loading of the drivers while WPSFWIN is the default Windows shell.
To quickly fix this problem, manually edit your SYSTEM.INI file
and comment out the following lines by placing a ';' (semi-colon)
at the beginning of the line:

system.drv=atmsys.drv
atm.system.drv=system.drv



;system.drv=atmsys.drv
;atm.system.drv=system.drv


8.2) When running Program Manager AND Workplace Shell together, Program
Manager will respond to any "PROGMAN" and "SHELL" DDE services.
The "PROGMAN" DDE service is used by installation program to create
and query program groups and items.
The "SHELL" DDE service is used by Windows DOS applications and
DOS "boxes" to associate title text and icons to them.
Therefore, if installing a new software application, be aware that
you must run Workplace Shell alone for it to communicate correctly
with the installing application.


8.3) OS/2 Warp users installing under Win-OS/2 sessions will not get
their Windows session restarted after WPSFWIN installation completes.
You will see an error message like "Error loading USER.EXE" and
the OS/2 desktop will appear immediatedly after that.
The WPSFWIN installation program will work under native Windows 3.1x
without any problems.


------------------------------------------------------------------------
END OF 'README.1ST' FILE


 December 5, 2017  Add comments

Leave a Reply