home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / p / ps2a68-1.zip / PS2ASST.TXT < prev    next >
Text File  |  1993-02-02  |  23KB  |  439 lines
  1.  
  2.                          IBM PS ASSISTANT (TM)
  3.                       Developed by Mark T. Chapman
  4.    IBM PC Company Personal Systems HelpCenter Technical Support Group |
  5.                     Copyright (C) IBM Corp. 1989-1993 |
  6.                                ───  ─── 
  7.  
  8. The intent of this file is to explain what the IBM PS Assistant is, how to
  9. install it, how to obtain future upgrades, and what problems or limitations you
  10. might run into while installing or using it.  (Note: Change Bars (|) indicate
  11. new or modified information since the last release of this file.)
  12.  
  13. A complete list of the files that you should have is as follows:
  14.                           PS2ASST.TXT  (This File)
  15.                           PS2A_GEN.INF
  16.                           PS2A_MKT.INF
  17.                           PS2A_SVC.INF
  18.                           PS2A_TEC.INF
  19.                           PS1A_TSP.INF
  20.                           PS2A_TSP.INF
  21.                           PS2A_TTL.INF
  22. The purpose of these files is described below.
  23.  
  24.  
  25. OVERVIEW
  26. --------
  27. There are many sources of information available from IBM, including announcement
  28. letters, service manuals, programming and technical reference manuals, how-to
  29. "cookbooks," electronic bulletin boards (both public and IBM-use only), and
  30. others.  The IBM PS Assistant is an attempt to bring much disparate and often
  31. difficult to find information together into one easy-to-use "electronic book."
  32.  
  33. The IBM PS Assistant is an online help tool composed of PS/2 and OS/2-related
  34. marketing, service, technical and general information.  The books include the:
  35.  
  36. IBM PS Marketing Assistant (filename PS2A_MKT.INF), which contains:
  37.  IBM hardware and software pricing part number lists and descriptions.
  38.  IBM publication ordering information.
  39.  Feature Code/Part Number cross-reference.
  40.  PCradio-PS/1-PS/2-PS/VP-ThinkPad features cross-reference. |
  41.  Promotional and upgrade information. |
  42.  Marketing Qs &. As, and more.
  43.  
  44. IBM PS Service Assistant (PS2A_SVC.INF), which contains:
  45.  Hardware and OS/2 error code information.
  46.  Latest DOS and OS/2 CSD information.
  47.  Latest Reference and Diagnostic Diskettes list. |
  48.  ADF file cross-reference.
  49.  Hardware and software service tips and Qs &. As, and more.
  50.  
  51. IBM PS Technical Assistant (PS2A_TEC.INF), which contains:
  52.  Tutorials on Micro Channel Advantages, and Expanded vs. Extended Memory,
  53.  Hundreds of hardware and software technical tips and Qs &. As.
  54.  
  55. IBM PS Technical Specifications Assistant #1 (PS1A_TSP.INF), which contains:
  56.  Lengthy technical specifications documents for all PS/1, PS/VP, and |
  57.   non-Micro Channel PS/2 systems and related displays, past and present. |
  58.  
  59. IBM PS Technical Specifications Assistant #2 (PS2A_TSP.INF), which contains:
  60.  Lengthy technical specifications documents for all Micro Channel PS/2 and 
  61.   ThinkPad systems and related displays, past and present. |
  62.  
  63. IBM PS General Information Assistant (PS2A_GEN.INF), which contains:
  64.  IBM and non-IBM telephone numbers.
  65.  A list of OS/2-related BBSes. |
  66.  A list of OS/2-related PC User Groups. |
  67.  An acronyms and abbreviations list.
  68.  
  69.  
  70. The reason for having a number of different books instead of just one large one
  71. is two-fold.  First, there is so much information provided that it might be
  72. awkward to use, and would take longer to search through than smaller books.  And
  73. second, by dividing up all of this information into related subject matter,
  74. those who don't need certain categories of information (such as service tips,
  75. for example), can delete entire books to save disk space.  Besides, these files
  76. may be logically linked together and viewed or searched as one large book, at
  77. your preference.  (This procedure is explained in the accompanying PS2ASST.TXT
  78. file.)  For convenience, the files will be collectively called the "PS Assistant"
  79. throughout the rest of this document.
  80.  
  81. Not only is the information more "centrally located" this way than distributed
  82. across all the individual documents, but due to its electronic nature, the
  83. specific information you seek can be found more quickly and easily.  The source
  84. information is compiled into binary files that take roughly half as much disk
  85. space as ASCII files would.  And since the compiler also creates a "data
  86. dictionary" of all words and numbers anywhere in the files, all occurrences can
  87. be found and displayed on-screen in only a few seconds via the search facility
  88. provided.  In addition, :hp2.hypertext links:ehp2. (hyperlinks) allow you to jump
  89. from section to section within a book without ever having to return to the Table
  90. of Contents.  Hyperlinks are :hp1.also:ehp1. used to display popup footnote
  91. windows at the point of the footnote reference, rather than making you have to
  92. scroll down to the bottom of a page, or the end of a chapter, to find the
  93. footnoted information.
  94.  
  95. The PS Assistant is created by compiling scripted ASCII text files, using the
  96. Information Presentation Facility (IPF) Tag Language and Compiler.  They are
  97. included in the OS/2 V1.2 and 1.3 Programming Tools and Information toolkits
  98. (P/Ns 6024929 or 85F1671), as well as the OS/2 2.0 Developer's Toolkit (P/N
  99. 10G3355-3.5"; 10G4335-5.25").  The PS Assistant requires OS/2 1.2 or later to
  100. operate, because it uses the OS/2 VIEW.EXE command to access the files.  This is
  101. the same command used to display the online OS/2 Command Reference.  Since both
  102. files were created with the same compiler, and are displayed by the same
  103. command, they look and act very much alike.  So if you know how to use one, you
  104. also know how to use the other.
  105.  
  106. Note: The PS Assistant was tested, and does work, across an OS/2 LAN Server
  107. V1.2-V3.0 network, relieving the need for disk space on the requester, not to
  108. mention not having to keep all those requesters updated with the latest versions
  109. of the PS Assistant books.  (For instructions on Setting Up an OS/2 LAN Server
  110. to Share Online Books, see the document by the same name in the Networking Tips
  111. section of the PS Technical Assistant.)
  112.  
  113. Features include:
  114.  - A Table of Contents listing a number of sections containing PS/1-PS/2-PS/VP,
  115.    OS/2, DOS, and AIX Marketing information; PS and OS/2 Service information;
  116.    and PS and OS/2 Technical information, as well as PS Assistant
  117.    overview and usage instructions (About PS Assistant - Tutorial).
  118.  - A keyword Search capability, which highlights all occurrences of a word or
  119.    phrase, anywhere in the PS Assistant, and displays all sections containing
  120.    that string in a selection window.
  121.  - A Print feature allowing you to print the Table of Contents, any section
  122.    or group of marked sections, or the entire document(over 1500 pages worth!).
  123.  - A Copy-to-clipboard function for copy/paste use.
  124.  - A Copy/Append-to-ASCII-File capability to save to disk for future use.
  125.  - A Bookmark feature to save a list of the frequently-referred-to sections
  126.    for quicker access.
  127.  - Contextual online Help for general usage information.
  128.  
  129. INSTALLING AND STARTING THE PS ASSISTANT
  130. ------------------------------------------
  131. For performance reasons I strongly recommend that you copy the files to a hard
  132. drive.  You may wish to add the PS Assistant to the C:\OS2\BOOK directory,
  133. which already contains the online OS/2 Command Reference (and perhaps other |
  134. online OS/2 books, depending on what you have installed).  If you prefer to |
  135. create a separate directory for the Assistant, you should also change the     
  136. SET BOOKSHELF= statement in CONFIG.SYS.  For example, if you create a directory
  137. called PS2ASST, change SET BOOKSHELF=  from:
  138.  
  139. SET BOOKSHELF=C:\OS2\BOOK 
  140.  
  141.           to       
  142.  
  143. SET BOOKSHELF=C:\OS2\BOOK;C:\PS2ASST
  144. This tells OS/2 where to look for online books.)                                                                       
  145.  
  146. Then on an OS/2 1.x system either:
  147.          --------
  148. 1) Create a menu option (using Program...New from the Group action bar)
  149. containing the following information:
  150.  
  151.      Program Title:  PS Marketing Assistant
  152.      Path:           C:\OS2\VIEW.EXE
  153.      Parameters:     PS2A_MKT          
  154.                      (Note: The .INF file extension is NOT necessary here.) |
  155.  
  156. and simply click on the PS Assistant menu option to run the program.
  157.  
  158.                                    or,
  159.  
  160. 2) Type:  VIEW PS2A_MKT
  161.  
  162. to run the program directly from the command prompt.
  163.  
  164. Finally, you may wish to create a new Group specifically for the PS
  165. Assistant, or for all online books, including the OS/2 and LAN command
  166. references.  To do this, simply go to the Desktop Manager and select Group.
  167.  
  168. Then select New, and type in a Group Name (say PS Assistant, or Online
  169. Books).  After deciding whether to have the menu auto-start when you boot up
  170. (under 1.3 or later), and whether to start minimized or "normalized", click on
  171. Add, and you are done.  Once the group has been added, you can set up the menu
  172. to include the Assistant books, by using Program...New, and filling in the
  173. fields, as described above.
  174.  
  175. For OS/2 2.0 users:
  176.     --------
  177. 1) Open the Information object on the desktop, and use Create Another (or hold
  178.    down the Ctrl key and drag a book icon elsewhere in the folder and then drop
  179.    it) to duplicate an existing book object
  180. 2) Open the icon Settings and change the Parameter field to the name of one PS
  181.    Assistant book; then change the icon title and parameters. |
  182. 3) Repeat steps 1) and 2) for the other books
  183.  
  184. Or, use the VIEW command as in OS/2 1.x.
  185.  
  186. Finally, you may wish to create a new Folder specifically for the PS |
  187. Assistant, or for all online books, including the OS/2 and LAN command |
  188. references.  To do this, simply go to the Templates folder and drag/drop the |
  189. Folder template onto your desktop (or inside another folder)  The folder will |
  190. be created with the name "Folder".  You can change this by either going into |
  191. the folder Settings ("General" tab), or by simply pressing the Alt-Leftmouse |
  192. button combination. |
  193.  
  194.  
  195. To install the other PS Assistant books, simply repeat the process, |
  196. substituting the other titles and file names in the above example.
  197.  
  198.  
  199. AUTOSTARTING THE ASSISTANT |
  200. -------------------------- |
  201. If you would like to automatically start the PS Marketing Assistant when you
  202. boot up your system, add the following statement to your OS/2 1.x STARTUP.CMD 
  203. batch file:
  204.  
  205.    START C:\OS2\VIEW.EXE PS2A_MKT.INF
  206.  
  207. Or, OS/2 2.0 users can add the book icon to the Startup folder.
  208.  
  209.  
  210. LINKING BOOKS TOGETHER |
  211. ---------------------- |
  212. If you would like to logically link the some or all of the books together (to |
  213. simplify keyword searches of all the information in all of the files) into one |
  214. big menu, you can type from a command line (or put in a batch file or
  215. CONFIG.SYS):
  216.  
  217. SET PS2ASST=PS2A_MKT.INF+PS2A_SVC.INF+PS2A_TEC.INF+PS2A_TSP.INF+PS2A_GEN.INF+...
  218. (Note: The .INF file extension IS necessary here.) |
  219.  
  220. This will create one "virtual" book called PS2ASST (or any other name you     
  221. choose to assign).  To see the data, just VIEW PS2ASST as you would with one  
  222. of the component files, or use PS2ASST as the parameter in a group setup.     
  223.  
  224. OR, create a menu option containing the following information (the file names
  225. can be in whatever order you prefer):
  226.  
  227.    Program Title:  PS Assistant
  228.    Path:           C:\OS2\VIEW.EXE
  229.    Parameter:      PS2A_MKT+PS2A_SVC+PS2A_TEC+PS1A_TSP+PS2A_TSP+PS2A_GEN+...
  230.                    (Note: The .INF file extension is NOT necessary here.) |
  231.  
  232. (The disadvantage to these approaches is that the "About PS Assistant" menu
  233. heading will appear six times each on the combined menu, because it exists in
  234. all files.  This makes the menu a bit more cluttered, but nothing more.) |
  235. In the above examples, the title of the combined book would be "IBM PS
  236. Marketing Assistant" because that is the title of the first file in the SET 
  237. command.  If another file were first, its title would be used instead. 
  238.  
  239. For this reason there is one additional .INF file (named PS2A_TTL.INF, |
  240. 896 bytes) on the diskette, which is merely a title header.  If you precede the
  241. other file names in the examples above with this file name, your title will show
  242. "IBM PS Assistant" as the title, instead of "IBM PS Marketing Assistant."  This
  243. may be less confusing when you sometimes look at just one section of the PS
  244. Assistant, and other times link several sections together.
  245.  
  246. (NOTE: In case you are wondering why the .INF extension was used in some of
  247. the examples above, but not others, the answer is that it is optional when
  248. using the VIEW command directly, as in VIEW xxxx; however when the START
  249. command is used to launch a program, or the SET command is used to link files
  250. together, the fully-qualified program and file names are required.  Not using
  251. the .INF extension in these cases will cause a "Cannot Open Input File"
  252. error.)
  253.  
  254. *** TIP ***
  255. If you already have the Assistant installed in a group/folder, and want to move|
  256. the entries to their own group/folder, you can simply drag and drop (using the |
  257. "alternate" [right for right-handed users) mouse button) from one window to |
  258. another.  This will save a lot of typing (in the new group/folder) and deleting|
  259. (from the old location).  This "trick" works with any Group menu items. |
  260.  
  261.  
  262. USAGE INSTRUCTIONS
  263. ------------------
  264. Information on using the PS Assistant is available by double-clicking on the
  265. first option (About PS Assistant - Tutorial) on the Contents menu.  If
  266. you are familiar with using the OS/2 Online Command Reference, then you already
  267. know how to use the PS Assistant; however there is some information specific
  268. to the PS Assistant contained in this section that should be read before
  269. using the first time.
  270.  
  271. *** HOT TIP ***                                                               
  272. If you know the name of the section you will be looking in first, you can jump
  273. directly to that section from the command line.  For example, if you want to  
  274. look up a phone number, rather than typing VIEW PS2A_GEN, and then selecting  
  275. the IBM Phone Number list, and then the IBM Voice Phone Numbers, you could    
  276. type:                                                                         
  277.                         VIEW PS2A_GEN VOICE                                   
  278.  
  279. and jump directly to that section.  This technique works only for the FIRST   
  280. menu topic containing that keyword.  If, for example, you searched on PHONE,  
  281. you would get the IBM Phone Number header.                                    
  282.  
  283. This trick won't always get you where you want to go on the first try, but it 
  284. can be a time-saver once you get the hang of it.                              
  285.  
  286. ******************************************************************************
  287.  
  288. UPDATES
  289. -------
  290. The PS Assistant is updated every 2-3 weeks, and released via the IBM NSC BBS |
  291. (see below) for end-users (PS2ASST.EXE), or the MKTTOOLS  and PCWIN tools disks|
  292. (PS2ASST PACKAGE) for IBMers.  IBM Developer Assistance Program (IDAP) members,|
  293. and customersregistered as Technical Coordinators, who have access to IBMLINK |
  294. also may download the PS Assistant, using the instructions provided (from the |
  295. Software Mall).  IBMers may type in the following command from the VM command |
  296. line to get the latest copy of the PS Assistant:
  297.  
  298.          TOOLCAT MKTTOOLS GET PS2ASST PACKAGE
  299.  
  300. If this doesn't work, use the following:
  301.  
  302.          TOOLS SENDTO USDIST TOOLS MKTTOOLS GET PS2ASST PACKAGE |
  303.  
  304. To subscribe to the PS Assistant (and receive future updates automatically),
  305. type: 
  306.  
  307.          TOOLCAT MKTTOOLS SUB PS2ASST PACKAGE
  308.  
  309.                           - or -
  310.  
  311.          TOOLS SENDTO USDIST TOOLS MKTTOOLS SUB PS2ASST PACKAGE |
  312.  
  313. A newer disk than MKTTOOLS opened for use in January, 1993.  It too contains |
  314. the PS Assistant.  To access the PS Assistant from the PCWIN tolls disk, |
  315. substitute "PCWIN" for "MKTTOOLS", and "BCRVMMS1" for "USDIST" in the |
  316. examples above. |
  317.  
  318. IMPORTANT NOTE:
  319. ---------------
  320. Due to some technical problems with MKTTOOLS, some long-time subscribers have |
  321. had trouble receiving the PS Assistant from MKTTOOLS lately.  Those users |
  322. should try subscribing via the PCWIN disk as an alternative. |
  323.  
  324.  
  325. FEEDBACK
  326. --------
  327. If you have any comments, suggestions, or find any errors, please let me know.
  328. I can be reached through the IBM PC Company National Support Center BBS. |
  329. Dealers registered with the IBM Technical Advisor program may use the 800 # to
  330. call the Technical Advisor BBS (TA BBS) set up for them.  Others may call
  331. 404-835-6600 for USR Dual Standard 9600 bps modems, or the first available |
  332. modem line; or 404-835-5578 for only IBM 7855 modem lines; or 404-835-6296 for|
  333. only Hayes V-Series or Ultra Smartmodems.  Communication parameters supported |
  334. are 300-9600 bps,N,8,1).
  335.  
  336. IBMers can reach me internally at T/L 269-6432 or MCHAPMAN @ DAYVM2.  There is
  337. also a PS2ASST FORUM available on the IBMPC disk.
  338.  
  339. Prodigy users may leave a message for JPJS05A.
  340.  
  341. ******************************************************************************
  342.  
  343. KNOWN PROBLEMS AND LIMITATIONS
  344. ------------------------------
  345. 1) If you are using SE 1.2 ship-level (ie. without the November 1989 Update),
  346. the IBM PS Assistant will not work ("Cannot Open Input File" message).  This
  347. is due to my switching to the updated IPF compiler (which fixed some bugs in
  348. the original compiler) that requires the SE 1.2 update.  Only SE 1.2 copies
  349. with a SYSLEVEL of less than XR04020 are affected.  EE 1.2 users already |
  350. have the update incorporated into the ship-level code, which has a minimum |
  351. SYSLEVEL of 4053 or later.) |
  352.  
  353. 2) It appears that you cannot print from the Assistant if the OS/2 Spooler is
  354. disabled. If you receive printing errors, check to be sure the spooler is
  355. enabled, or type SPOOL at a command prompt to enable it.
  356.  
  357. 3) In some instances (such as searching through fixed-pitch text, such as the |
  358. price list, and some tables) a multi-part search string (for example, |
  359. MATH COPROCESSOR) may not return all valid matches.  This is a limitation of
  360. the VIEW.EXE command, and thus outside my control.  If you do not get as many
  361. "hits" as you expect, try a shorter search string (such as COPROCESSOR), or use
  362. wildcards (MATH *PRO*).  Single-word searches appear to work correctly.  This |
  363. is still a problem as of OS/2 2.0. |
  364.  
  365. 4) If you try to use STARTUP.CMD to start more than one .INF file (whether    
  366. PS Assistant, CMDREF.INF, or other online help file) you may receive an OS/2 
  367. error message for each attempt after the first.  This is due to a  
  368. timing problem (the second copy trying to load before the first finishes) in
  369. OS/2 1.2 and 1.3.  The fix for this bug is in OS/2 V1.30.1 (also called CSD
  370. 5015), and later versions. |
  371.  
  372. 5) If you accidentally (or intentionally) delete the OS/2 1.2 Courier font from
  373. the system, IPF (under which the PS Assistant runs) may incorrectly |
  374. substitute a proportional font instead of the system monospace font.  This has
  375. the effect of messing up the alignment of text in all the monospaced documents
  376. (such as the price list and some technical specs documents!).  This has been
  377. corrected in the latest 1.2 CSD |.
  378.  
  379. 6) There seems to be an intermittent problem using the PS Assistant on an
  380. OS/2 LAN Server V1.2 network.  Occasionally, the first time the PS Assistant
  381. is started a Protection Violation error will be encountered when the first menu
  382. option is selected.  If a Search is attempted before a menu option is selected,
  383. Search ignores the search request.  It doesn't appear to be a serious problem.
  384. It happens only sporadically, and only once.  If you start the Assistant again,
  385. immediately after the PV error, it will work correctly the second time, and
  386. every time after that until the next time you reboot.
  387.  
  388. 7) When using OS/2 V1.3, the fixed-pitch font (such as in the price list) used 
  389. by OS/2 is larger than that used in V1.2.  Therefore less text will fit on the 
  390. screen than before, both horizontally and vertically.  This is not a problem   
  391. vertically, since you can just scroll up and down to see all the information;  
  392. but some data may be cut off on the right side of the screen.  There is no way 
  393. to see this information currently.  I have no control over this limitation, and
  394. there are too many lines of fixed pitch text (10-15,000 lines) to change
  395. manually.  OS/2 2.0 gives the user the ability to scroll horizontally to see
  396. any text that is too wide for the screen.
  397.  
  398. 8) There may be a problem trying to print (from VIEW.EXE) INF file information
  399. on a PostScript printer.  If you encounter strange wrapping problems on a PS
  400. printer, try changing your printer into IBM Proprinter (or other ASCII printer)
  401. emulation mode if your printer has such a mode (or any other emulation mode
  402. that is known to work with the PS Assistant).  Then set the Print Manager
  403. Application Default (from Setup) to use an OS/2 driver compatible with this
  404. printer mode.  (If this works, don't forget to reset your printer mode and OS/2
  405. driver back to their original settings when done printing from the Assistant.
  406. If your printer is capable of printing ASCII files, another approach is to use
  407. the Copy to File pulldown option.  This will save the selected sections to a
  408. file called TEXT.TMP, in the same directory as the INF file you are copying
  409. from.  Then simply use the File Manager to drag-and-drop the file to the Print
  410. Manager icon.  Then answer the prompt for the device driver to use, and when
  411. prompted whether the data is Graphics or Text, specify Text.  (The reason for 
  412. doing it this way, rather than using the Print command, is that many PS 
  413. printers do not automatically switch from PS mode to ASCII mode, and tend to 
  414. "eat" the ASCII file instead of printing it.  The drag/drop method forces the
  415. printer into ASCII mode, if the printer has an ASCII mode.)
  416.  
  417. 9) If you are using the Assistant on a network, make sure that all INF files
  418. are set up with read-only attributes, otherwise all users trying to share a
  419. file that is already open will receive "access denied" error messages.  This
  420. is true of any INF files you might be sharing (command reference, etc.).
  421.  
  422. 10) The 2.0 ServicePack introduced a bug that renders wildcard (*) searches |
  423. inoperative, and the 2.1 beta code (as of December 1992) continues this bug. |
  424. It has been reported, but no work on when/if it will be fixed.  In the meantime|
  425. don't use wildcard searches, which will always return "Cannot find Search |
  426. Text" messages. |
  427.  
  428. I hope you find this tool to be useful.  Good luck!
  429.  
  430.                                Mark Chapman
  431.                 Advisory Marketing Support Representative
  432.    IBM PC Company Personal Systems HelpCenter Technical Support Group |
  433.  
  434. NOTE: The information contained in the IBM PS Assistant is copyrighted by IBM  |
  435. and may not be modified in any manner, or for any reason. In addition, the name|
  436. "PS Assistant" and derivatives thereof have been trademarked. See the "About PS|
  437. Assistant" menu option in the PS Assistant for trademark information and
  438. additional disclaimers.
  439.