ÉÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ» º º º CID Utility - PC/3270 V3.0 for WIN-OS/2 2.0 (PCSWOCID) º º º ºDeveloped by Barry Cunningham, IBM Personal Systems Competency Center, Dallasº º (c) Copyright IBM Corporation 1992,1993. All Rights Reserved. º º º ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͹ º º º Who should keep reading about this utility program? someone who... º º º º ...has IBM Operating System/2 Version 2.0 (*1) º º º º ...has IBM Personal Communications/3270 Version 3.0 for Windows(TM) º º and wants to run it in the WIN-OS/2 environment of OS/2 2.0 º º º º ...has IBM Network Transport Services/2 (*2) º º º º ...would like to use either NetView Distribution Manager/2 V2.0 or º º the LAN CID(*3) Utility of NTS/2 to install, configure, and distribute º º PC/3270 V3.0 Windows mode from a code server to multiple OS/2 2.0 º º workstations º º º º (TM) Windows is a trademark of the Microsoft Corporation º º º º (*1) OS/2 ServicePak REXX is a prerequisite on the CID code server. º º º º (*2) NTS/2 provides the 802.2 Virtual Device Driver required to support º º the 802.2 configuration of PC/3270 for Windows V3.0 under WIN-OS/2. º º º º (*3) CID = Configuration, Installation, and Distribution º ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͹ º º º What's a brief summary of the PCSWOCID utility? º º º º ...PCSWOCID supports the unattended configuration, installation, and º º distribution of Personal Communications/3270 V3.0 for Windows from º º a local or redirected drive when running under WIN-OS/2 of OS/2 2.0. º º Instead of adding multiple icons to the Program Manager of WIN-OS/2, º º PCSWOCID adds a single icon to the Desktop of OS/2's Workplace Shell, º º even allowing control over WIN-OS/2 settings via keywords placed in the º º specific response file. PC/3270's actual install program generates º º parameter files in flat ASCII format (.WS extension), which may then º º serve as general response files. Another program module of PC/3270 º º (PCSBAT.EXE) creates files (.BCH extension) that may be manually edited º º for use as specific response files. PCSWOCID stores progress information º º in local history and error logs in the CID client target directory, º º PCSWOCID.HST and PCSWOCID.ERR respectively. If and as specified in the º º /L1: and /L2: parameters of PCSWOCID, remote copies of these history and º º error log files are also updated. PCSWOCID generally conforms to the º º specifications outlined in the "Configuration, Installation and º º Distribution (CID) Product Enablement Guidelines" document to be included º º in ITSC Bulletin GG24-3781, including return code support to the software º º distribution manager. º ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͹ º º º What added function do I gain by using PCSWOCID instead of the PC/3270 V3.0 º º Windows mode installation program? º º º º ...automatic configuration of poll buffer size for standard mode WIN-OS/2 º º in PCSTSR.BAT of PC/3270 V3.0 Windows mode, running PCSSETUP.EXE is not º º necessary º º º º ...unattended installation PC/3270 V3.0 Windows mode using general º º response files, filename.WS workstation profiles, natively generated by º º PC/3270 V3.0 Windows mode º º º º ...automatic creation and update of a single icon on the Desktop of º º OS/2's Workplace Shell instead of the addition of multiple icons to the º º Program Manager of WIN-OS/2 (*1) º º º º ...automatic tuning of WIN-OS/2 Settings for link types selected in º º PC/3270 V3.0 windows mode workstation profiles (filename.WS) º º º º ...optional control of WIN-OS/2 Settings through the specific response º º file [WIN-OS/2_Settings] section (*2) (*3) º º º º ...automatic configuration of multiple 802.2 link stations at least to º º the number of unique 802.2 gateway addresses encountered in general º º response files (filename.WS) referenced in a specific response file º º (filename.RSP) º º º º ...deletion of unwanted local PC/3270 V3.0 Windows mode files through the º º specific response file [Delete_Unwanted_Files] section (see PCSWOCID.RSP º º and PC/3270's INSTALL.TXT for more information) º º º º ...unattended support of the PC/3270 V3.0 Windows mode "INSTALL /N" º º installation option allowing installations with a small disk space º º requirement (*4) º º º º (*1) User must add icons to WIN-OS/2 full screen program manager manually. º º º º (*2) The first OS/2 ServicePak level of PMWP.DLL module is required on º º the CID client to support manual control of WIN-OS/2 Settings because º º SysCreateObject's setup string is limited to 255 characters with the º º 3/30/92 level of PMWP.DLL. º º º º (*3) WIN-OS/2 Setting DOS_SHELL is reserved by PCSWOCID. º º º º (*4) The network runtime path is not verified since a LAN requester may º º not be installed yet. º ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͹ º º º What function do I loose by using PCSWOCID instead of the PC/3270 V3.0 º º Windows mode installation program? º º º º ...PCSWOCID does not migrate existing PC/3270W V2.0 configurations. º º º º ...PCSWOCID does not add any icons to the WIN-OS/2 full screen Program º º Manager, but only adds a single Workplace Shell program object to the º º OS/2 Desktop. º ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͹ º º º Where is all the documentation for PCSWOCID? º º Where are the Keyword=Value pairs documented? º º º º ...PCSWOCID.TXT is the file you are reading now. º º º º ...PCSWOCID.RSP is a sample specific response file documenting PCSWOCID º º Keyword=Value pairs; note that PC/3270 V3.0 Windows mode Keyword=Value º º pairs from filename.WS workstation profiles are used but not documented. º ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͹ º º º What is the NTS/2 suggested directory structure assumed for the CID server º º throughout the rest of this "README" file? º º º º :\CID\ÄÄÄÄ¿ º º ³ º º ÃÄÄIMGÄÄ¿ º º ³ ³ º º ÃÄÄEXE ÃÄÄPCSWINV3 º º ³ ³ º º ÃÄÄDLL ÃÄÄPRODUCTX º º ³ ³ º º ÃÄÄLOG ÀÄÄ... º º ³ º º ÃÄÄRSP º º ³ º º ÀÄÄ... º ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͹ º º º At what "level" of CID does PCSWOCID run? º º º º ...PCSWOCID has only been tested in a production level CID environment º º as opposed to a maintenance system CID environment. In other words, the º º OS/2 Workplace Shell must be active. To date, PCSWOCID only works with º º WIN-OS/2 and not with Microsoft (R) Windows (TM). Also, PC/3270 V3.0 for º º Windows must not be active during execution of PCSWOCID. º º º º (R) Microsoft is a registered trademark of the Microsoft Corporation. º º º º (TM) Windows is a trademark of the Microsoft Corporation. º ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͹ º º º Where do I place PCSWOCID files on the CID server? º º º º ...PCSWOCID.EXE belongs in the \CID\IMG\PCSWINV3 directory º º º º ...PCSWOCID.TXT belongs in the \CID\IMG\PCSWINV3 directory º º º º ...COMMENTS.TXT belongs in the \CID\IMG\PCSWINV3 directory º º º º ...PCSWOCID.MAC belongs in the \CID\DLL directory (OS/2 DPATH of client) º º º º ...PCSWOCID.DLL belongs in the \CID\DLL directory (OS/2 LIBPATH of client)º º º º ...PCSWOCID.PRF belongs in the \CID\CLIENT directory º º º º ...PCSWOLCU.CMD belongs in the \CID\CLIENT directory º º º º ...EMPTY.FIL belongs in the \CID\LOG\PCSWINV3 directory (see NOTE:) º º º º ...PCSWOCID.RSP belongs in the \CID\RSP\PCSWINV3 directory º º º º ...LAN8022.WS belongs in the \CID\RSP\PCSWINV3 directory º º º º ...SDLC.WS belongs in the \CID\RSP\PCSWINV3 directory º º º º ...SNADFT.WS belongs in the \CID\RSP\PCSWINV3 directory º º º º NOTE: These files and associated sub-directories are created automatically º º by running "pkunzip -d pcswocid.zip" from within the \CID directory on the º º CID code server. The EMPTY.FIL enables the automatic creation of the º º sub-directory \CID\LOG\PCSWINV3. º ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͹ º º º What other directories or files must be prepared before running PCSWOCID? º º How do I prepare the PC/3270W V3.0 image directory on the CID server? º º How do I build my general and specific response files? º º º º ...run "INSTALL /A" of PC/3270 V3.0 Windows mode (see PC/3270's º º INSTALL.TXT) to create an image directory on the CID server such as º º \CID\IMG\PCSWINV3 (CID clients need read-only access to this directory) º º º º ...filename.WS workstation profiles serve as general response files, º º belong in the \CID\RSP\PCSWINV3 directory on the CID server, and are º º created using PC/3270 V3.0 Windows mode (PCSWS.EXE). Sample general º º response files SDLC.WS, LAN8022.WS, and SNADFT.WS referenced in the º º sample specific response file PCSWOCID.RSP were created in this manner. º º º º ...filename.RSP files serve as specific response files, belong in the º º \CID\RSP\PCSWINV3 directory on the CID server, and are prepared by... º º º º 1) creating filename.BCH batch profiles using the PC/3270 V3.0 Windows º º mode PCSBAT.EXE utility º º º º 2) copying these filename.BCH batch profiles to new filename.RSP º º specific response files; mandatory file extension of .RSP º º º º 3) adding any desired sections from the PCSWOCID.RSP sample specific º º response file to your filename.RSP specific response files º º º º 4) adding any desired Keyword=Values to override those referenced in º º your general response files, filename.WS workstation profiles º º º º ...when using the NetView Distribution Manager/2 V2.0 as the software º º distribution manager, use the sample change control profile º º \CID\CLIENT\PCSWINV3\PCSWOCID.PRF to a build change control file. º º º º ...when using the NTS/2 LAN CID Utility (LCU) as the software º º distribution manager, use to sample LCU command file º º \CID\CLIENT\PCSWOLCU.CMD or incorporate appropriate portions into your º º own LCU command file. Your own LCU command file might be named º º \CID\CLIENT\DEFAULT.CMD or \CID\CLIENT\xxxxxxxx.CMD where "xxxxxxxx" is º º the NETBIOS name of a particular CID client workstation. º ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͹ º º º Where are all the PCSWOCID command line parameters documented? º º º º ...Invoke PCSWOCID without any parameters to see descriptions of the º º supported command line parameters as follows: º º º ºPCSWOCID - PC/3270 V3.0 for WIN-OS/2 2.0 CID Utility - "Revision Date" º ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ PCSWOCID[.EXE] /R:[] ³ ³ [/G:[]] ³ ³ [/S:[]] ³ ³ [/T:[]] ³ ³ [/N:] ³ ³ [/L1:[]] ³ ³ [/L2:[]] ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³ [] defaults to the current ³ ÃÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³ /R: ³ Specific Response File, based on filename.BCH and PCSWOCID.RSP ³ ³ /G: ³ General Response File Path, filename.WS workstation profiles ³ ³ /S: ³ Source Path, "INSTALL /A" PC/3270 V3.0 for Windows disk images ³ ³ /T: ³ Target Path, new or existing PC/3270 V3.0 for Windows installation ³ ³ /N: ³ Network Runtime Path, "INSTALL /A" PC/3270 V3.0 Windows disk images ³ ³ /L1:³ Remote History Log, duplicate of Target Path PCSWOCID.HST log file ³ ³ /L2:³ Remote Error Log, duplicate of Target Path PCSWOCID.ERR log file ³ ÀÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ºDeveloped by Barry Cunningham, IBM Personal Systems Competency Center, Dallasº º (c) Copyright IBM Corporation 1992. All Rights Reserved. º ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͹ º º º How can I get suggestions or comments about this utility to the º º Personal Systems Competency Center(PSCC) or inquire about other º º offerings? º º º º ...Print out the COMMENTS.TXT file in the \CID\IMG\PCSWINV3 directory º º and return it to the PSCC according to instructions given on the form. º º º º Where can I address technical questions about this utility to other users º º or to the author? º º º º ...Utilize the OS2INST CFORUM on the IBM OS/2 BBS (on IBMPC internally). º º Call 1-800-547-1283 for more information regarding the IBM OS/2 BBS. º º º ÌÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͹ º º º What are some PCSWOCID special tips and techniques? º º º º ...Invalid program invocation errors will not be recorded in the remote º º error log unless a valid /L2: is specified as the first parameter. º ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ