home *** CD-ROM | disk | FTP | other *** search
/ The Developer Connection…ice Driver Kit for OS/2 3 / DEV3-D1.ISO / docs / overview.inf (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1993-08-15  |  99.8 KB  |  3,277 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Introduction ΓòÉΓòÉΓòÉ
  3.  
  4. Communications Manager provides services that your workstation can use to 
  5. communicate with a host computer or another workstation.  You can use 
  6. Communications Manager applications to exchange information or use resources 
  7. from the host or from other workstations.  These resources include programs, 
  8. files, databases, and printers. 
  9.  
  10. Communications Manager allows your workstation to: 
  11.  
  12. o Communicate with host computers or other workstations either directly or 
  13.   through any of the following kinds of networks: 
  14.  
  15.    - Local area networks (LANs) 
  16.  
  17.    - Systems Network Architecture-conforming networks 
  18.  
  19.    - Integrated services digital network (ISDN) 
  20.  
  21.    - X.25 networks 
  22.  
  23. o Control the method of data exchange between your workstation and a host 
  24.   computer or another workstation that uses different kinds of communications 
  25.   protocols or techniques, such as Synchronous Data Link Control (SDLC), X.25, 
  26.   or asynchronous communications 
  27.  
  28. o Be configured remotely by any computer running Communications Manager over a 
  29.   network 
  30.  
  31. o Emulate, or perform like, a 3270 or 5250 display terminal when communicating 
  32.   with a host computer 
  33.  
  34. o Use the services of the Presentation Manager interface, such as the 
  35.   clipboard, online help, and emulator help 
  36.  
  37. o Transfer files to and from a host computer or another workstation 
  38.  
  39. o Use host-directed printing features 
  40.  
  41. o Remap, or change, keyboard definitions for the OS/2 3270/5250 emulator. 
  42.  
  43.  
  44. ΓòÉΓòÉΓòÉ 2. What's New ΓòÉΓòÉΓòÉ
  45.  
  46. Communications Manager/2 Version 1.1 contains the following new functions: 
  47.  
  48. o An enhanced OS/2 3270/5250 emulator, including: 
  49.  
  50.    - A Menu Bar to access emulator functions 
  51.  
  52.    - Hide/Show and Popup Menu Bar options on the System Menu 
  53.  
  54.    - New emulator functions, including: 
  55.  
  56.       o New file transfer functions permitting multiple file transfers and host 
  57.         selection with pull-down menus. 
  58.  
  59.       o Automatic Font Selection 
  60.  
  61.       o Hotspots for host mouse functions 
  62.  
  63.       o Popup Keypad 
  64.  
  65.       o Numeric Lock Field 
  66.  
  67. o Double-byte character set support for the OS/2 3270/5250 emulator. 
  68.  
  69. o A Workgroup Client Support feature that allows you to run Communications 
  70.   Manager from a redirected drive. 
  71.  
  72. o The capability to support transactions in full-duplex mode in an LU 6.2 
  73.   environment. 
  74.  
  75. o Support for ISDN Data Link Control (IDLC) 
  76.  
  77. o Support for SNA session level data compression 
  78.  
  79. o The capability of connecting to an unlimited number of hosts concurrently 
  80.  
  81. o The capability of having all workstations running OS/2 on a LAN segment be 
  82.   accessible to NetView. 
  83.  
  84. o The capablity for downstream NetWare users to use Communications Manager as a 
  85.   gateway to exchange network management data between themselves and NetView 
  86.   running on the host. 
  87.  
  88. o The capability to issue Communications Manager system management commands 
  89.   from the OS/2 command line to obtain and display information about links, 
  90.   data-link control, and APPC transactions. 
  91.  
  92. o The capability to route RUNCMDs from an OS/2 service point to an OS/2 
  93.   workstation. 
  94.  
  95. o Expanded use of First Failure Support Technology (FFST/2) to perform problem 
  96.   determination functions. 
  97.  
  98. o Expanded formatted trace service, to include more APIs, such as SRPI, 
  99.   EHLLAPI, LUA, and ACDI. 
  100.  
  101.  
  102. ΓòÉΓòÉΓòÉ 2.1. Workgroup Client Support Feature ΓòÉΓòÉΓòÉ
  103.  
  104. The Workgroup Client Support feature has the capability to share a common set 
  105. of files among multiple users. This requires only a small amount of 
  106. Communications Manager product files to be stored on your workstation. 
  107. Workgroup Client Support feature applies if the workstation uses Communications 
  108. Manager product files that are stored on a file server on its local area 
  109. network. 
  110.  
  111. Following are some of the services the Workgroup Client Support feature 
  112. supports: 
  113.  
  114. o 3270 and 5250 emulation over LAN connections 
  115. o APPC, CPIC, and LUA APIs over LAN connections 
  116. o ACDI redirection over LAN connections 
  117. o ACDI API over an asynchronous connection 
  118.  
  119. Following are some of the services the Workgroup Client Support feature does 
  120. not support: 
  121.  
  122. o Synchronous data link control (SDLC) 
  123. o ISDN Data Link Control (IDLC) 
  124. o Twinaxial data link control (TDLC) 
  125. o X.25 data link control (DLC) 
  126. o Gateway feature 
  127. o Network node feature 
  128. o Ability to create and maintain configurations. 
  129.  
  130. See the Planning and Administration for Networks for more information on the 
  131. Workgroup Client Support feature. 
  132.  
  133.  
  134. ΓòÉΓòÉΓòÉ 3. Services and Connections ΓòÉΓòÉΓòÉ
  135.  
  136. Communications Manager supports a variety of services and connections 
  137. including: 
  138.  
  139. Services 
  140.  
  141. o Advanced Peer-to-Peer Networking (APPN) 
  142.  
  143. o Advanced program-to-program communications (APPC) 
  144.  
  145. o Asynchronous communications device interface (ACDI) 
  146.  
  147. o Subsystem management 
  148.  
  149. o Systems application architecture* (SAA*) common communications support 
  150.   architectures 
  151.  
  152. o Systems network architecture (SNA) gateway 
  153.  
  154. o User Profile Management 
  155.  
  156. o Novell NetWare support 
  157.  
  158. o FFST/2 support 
  159.  
  160. Connections 
  161.  
  162. o Local Area Network (LAN) Support Services 
  163.  
  164. o Integrated services digital network (ISDN) 
  165.  
  166. o X.25 network 
  167.  
  168. o Coaxial distributed function terminal (DFT) 
  169.  
  170. o Synchronous data link control (SDLC) nonswitched and switched line support 
  171.  
  172. o Twinaxial data link control (TDLC) 
  173.  
  174.  
  175. ΓòÉΓòÉΓòÉ 3.1. Advanced Peer-to-Peer Networking (APPN)* ΓòÉΓòÉΓòÉ
  176.  
  177. Communications Manager provides Advanced Peer-to-Peer Networking (APPN) 
  178. end-node and network-node support for workstations, allowing them more 
  179. flexibility communicating with other systems in the network. Some of the 
  180. important capabilities that APPN provides are: 
  181.  
  182. o End-node capability, which allows the local node, such as a workstation, to 
  183.   connect as an end node to a serving network node for directory and routing 
  184.   services. 
  185.  
  186. o Network-node capability, which provides network services on behalf of 
  187.   connected end nodes. 
  188.  
  189. o Connection network services for the LAN, which workstations use to obtain LAN 
  190.   destination addresses without having to be configured for them.  This 
  191.   capability allows a node to establish a link connection directly to another 
  192.   node with no LAN destination address configured. 
  193.  
  194. * Trademark of IBM 
  195.  
  196.  
  197. ΓòÉΓòÉΓòÉ 3.2. Advanced Program-to-Program Communications (APPC) ΓòÉΓòÉΓòÉ
  198.  
  199. Communications Manager supports APPC between SNA applications, allowing 
  200. workstations to share programs, files, and other data.  Communications Manager 
  201. also supplies an APPC API for writing application programs. 
  202.  
  203. APPC supports conversation and session security between communicating programs. 
  204. You can manage this security through User Profile Management Services. 
  205.  
  206. Communications Manager also supports data compression for APPC communications. 
  207.  
  208.  
  209. ΓòÉΓòÉΓòÉ 3.3. Asynchronous Communications Device Interface (ACDI) ΓòÉΓòÉΓòÉ
  210.  
  211. Communications Manager supports asynchronous communication for applications 
  212. written to the ACDI or ACDI Redirection API. This includes: 
  213.  
  214. o Direct asynchronous communications from the workstation 
  215.  
  216. o Redirected asynchronous communications through a LAN server that has the IBM* 
  217.   Local Area Network Asynchronous Connection Server (LANACS) installed. 
  218.  
  219. *Trademark of IBM. 
  220.  
  221.  
  222. ΓòÉΓòÉΓòÉ 3.4. Coaxial Distributed Function Terminal (DFT) ΓòÉΓòÉΓòÉ
  223.  
  224. Communications Manager supports coaxial DFT, which is the protocol used for 
  225. communication through an IBM 3274 or IBM 3174 control unit. 
  226.  
  227. Communications Manager also supports the 3270 credit card adapter. 
  228.  
  229.  
  230. ΓòÉΓòÉΓòÉ <hidden> 3270 Credit Card Adapter ΓòÉΓòÉΓòÉ
  231.  
  232. The 3270 emulation credit card adapter is a credit card size adapter that 
  233. provides an interface between computer systems and 3270 networks. The 3270 
  234. credit card emulates a 3270 session in DFT and is designed for use with 
  235. Personal Computer Memory Card International Association (PCMCIA) version 2.0, 
  236. type 2 slots. 
  237.  
  238. When you choose to use this option, the 3270 emulation is configured to use a 
  239. 3270 credit card for communication.  If a 3270 credit card is not installed, 
  240. the 3270 emulator looks for a 3270 connection adapter, a 3278/79 emulation 
  241. adapter, or an advanced 3278/79 emulation adapter for communication. 
  242.  
  243. Note:  There is no support for LAN over Coaxial (DFT).  The existing DFT 
  244.        limitation of 5 sesssions remains unchanged.  This support is for OS/2 
  245.        V2.1 and higher. 
  246.  
  247.  
  248. ΓòÉΓòÉΓòÉ 3.5. Integrated Services Digital Network (ISDN) ΓòÉΓòÉΓòÉ
  249.  
  250. ISDN is a technology for transferring data over telephone lines. This ability 
  251. provides a fast and inexpensive way for transferring or sharing information. 
  252.  
  253. ISDN uses normal digital telephone lines.  ISDN telephone line usage is charged 
  254. the same as voice calls. You are charged for the length of time you use the 
  255. line, regardless of whether you are transferring voice or data. X.25 over ISDN 
  256. can use the D-channel or B-channel for data transfer using packet-switched 
  257. data.  With X.25 over ISDN, you are charged only for the number of packets sent 
  258. on the D-channels, but not for the time you are connected. 
  259.  
  260.  
  261. ΓòÉΓòÉΓòÉ 3.6. Local Area Network (LAN) Support ΓòÉΓòÉΓòÉ
  262.  
  263. LAN Adapter and Protocol Support (LAPS) is a prerequisite for Communications 
  264. Manager.  IBM Network Transport Services/2 (NTS/2) provides the support for IBM 
  265. LAN adapters and a range of certified non-IBM LAN adapters for the following 
  266. types of LANs: 
  267.  
  268. o IBM Token-Ring Network 
  269.  
  270. o IBM PC Network 
  271.  
  272. o Ethernet (ETHERAND) Network 
  273.  
  274. o IBM 3174 Peer Communications Network 
  275.  
  276.  
  277. ΓòÉΓòÉΓòÉ 3.7. NetWare Support ΓòÉΓòÉΓòÉ
  278.  
  279. Communications Manager allows downstream Netware users to use Communications 
  280. Manager as a gateway to exchange network management data between themselves and 
  281. NetView running on a host. This requires that you have a Communications Manager 
  282. gateway and a Novell NetWare for SAA gateway on a LAN.  With this 
  283. configuration, Communications Manager supports SNA Management Services 
  284. transport between: 
  285.  
  286. o A Communications Manager station and NetView through an intermediary NetWare 
  287.   for SAA gateway 
  288.  
  289. o A NetWare for SAA station and NetView through an intermediary Communications 
  290.   Manager gateway. 
  291.  
  292.  
  293. ΓòÉΓòÉΓòÉ 3.8. Subsystem Management ΓòÉΓòÉΓòÉ
  294.  
  295. Communications Manager provides subsystem management to allow you to display 
  296. and control the running status of the links, sessions, and transaction programs 
  297. (TPs) operating on your system.  You can fine-tune the operation of your 
  298. network by displaying the status of these resources and using subsystem 
  299. management functions to alter communication session operations. As you take 
  300. these actions, subsystem management continues to monitor the real-time activity 
  301. of your sessions and the links on which they are operating.  As a result, you 
  302. can immediately see how an action you take on one resource affects the 
  303. operation of others. 
  304.  
  305. In the Subsystem Management window you can: 
  306.  
  307. o View the status of the Communications Manager services that are listed in the 
  308.   window. 
  309.  
  310. o Viewing the status of Communications Manager services 
  311.  
  312. o Use the menu bar in the window to start or stop many of the listed services. 
  313.  
  314. o Starting and stopping Communications Manager services 
  315.  
  316. o Use the menu bar to display the status of your network resources (links, data 
  317.   link controls (DLCs), and sessions). When you open the display windows, you 
  318.   can start or stop activity on many of the displayed resources. 
  319.  
  320. o Displaying and controlling sessions and links 
  321.  
  322.  
  323. ΓòÉΓòÉΓòÉ <hidden> Viewing the Status of Communications Manager Services ΓòÉΓòÉΓòÉ
  324.  
  325. The Subsystem Management window displays a list of the names of the services 
  326. that can be displayed or controlled within subsystem management. The status 
  327. field next to the name of a service tells you whether the service is currently 
  328. Starting, Started, Stopping, or Stopped within the active configuration. 
  329.  
  330. The fields at the top of the window display the names of the active 
  331. configuration (the configuration that is currently running) and the default 
  332. configuration (the configuration that Communications Manager uses when you 
  333. first start the program on your workstation). 
  334.  
  335.  
  336. ΓòÉΓòÉΓòÉ <hidden> Starting and Stopping Communications Manager Services ΓòÉΓòÉΓòÉ
  337.  
  338. You can use the pull-down menu in the Subsystem Management window to start and 
  339. stop the following services: 
  340.  
  341. o APPC (advanced program-to-program communication) attach manager 
  342.  
  343. o Communications Manager kernel 
  344.  
  345. o SNA (systems network architecture) subsystem 
  346.  
  347. Note:  Some of these services may not appear in the Subsystem Management window 
  348. on your workstation.  The services displayed in the window vary by the type of 
  349. workstation configuration you are using. 
  350.  
  351.  
  352. ΓòÉΓòÉΓòÉ <hidden> Keylock ΓòÉΓòÉΓòÉ
  353.  
  354. The Communications Manager keylock is a software security function that serves 
  355. two purposes: 
  356.  
  357. o Protects confidential information that could be exposed by some 
  358.   Communications Manager functions, such as trace and configuration. 
  359.  
  360. o Prevents unauthorized or accidental changes to a configuration. 
  361.  
  362. If you need access to keylocked functions, your system administrator can give 
  363. you the password. 
  364.  
  365.  
  366. ΓòÉΓòÉΓòÉ <hidden> Displaying and Controlling Sessions and Links ΓòÉΓòÉΓòÉ
  367.  
  368. You can use the Subsystem Management window to display the status of individual 
  369. communication sessions and the links on which they operate. 
  370.  
  371. SNA Networks 
  372.  
  373. To display the status of sessions and links on a Systems Network Architecture 
  374. (SNA) network, select SNA subsystem; and then select Service from the menu bar. 
  375. Select Details from the Service pull-down menu.  The SNA Subsystem window 
  376. appears, from which you can choose which resources you want to display or 
  377. control. 
  378.  
  379. In many cases, when you open a display window, you can use the pull-down menu 
  380. on the window to start, stop, or modify the activity of the individual 
  381. resources displayed. 
  382.  
  383. X.25 Networks 
  384.  
  385. To display the status of physical links or SNA virtual circuits on an X.25 
  386. network, select your choice on this window; and then select Service from the 
  387. menu bar.  Select Details from the Service pull-down menu. 
  388.  
  389. When you open a display window, you can use the menu bar on the window to 
  390. start, stop, or modify the activity of the individual resources displayed. 
  391.  
  392. Note:  X.25 selections appear only when X.25 physical links and SNA virtual 
  393. circuits are defined in your configuration. 
  394.  
  395.  
  396. ΓòÉΓòÉΓòÉ 3.9. SAA Common Communications Support Architectures ΓòÉΓòÉΓòÉ
  397.  
  398. Communications Manager implements Systems Network Architecture/Management 
  399. Services (SNA/MS). This architecture defines the approach to managing 
  400. communications networks. The protocols used offer a vehicle for monitoring 
  401. network operations from a central location. 
  402.  
  403.  
  404. ΓòÉΓòÉΓòÉ 3.10. Synchronous Data Link Control (SDLC) Nonswitched and Switched Line Support ΓòÉΓòÉΓòÉ
  405.  
  406. Communications Manager supports SDLC nonswitched line support, which is a 
  407. communications protocol for managing information transfer over a 
  408. telecommunications line that does not require dialing to establish the 
  409. connection. 
  410.  
  411. Communications Manager also supports SDLC switched, which does require dialing 
  412. to establish the connection. 
  413.  
  414.  
  415. ΓòÉΓòÉΓòÉ 3.11. Systems Network Architecture (SNA) Gateway ΓòÉΓòÉΓòÉ
  416.  
  417. Communications Manager allows multiple users on a LAN, an SDLC switched or 
  418. leased link, an X.25 network, or ISDN network to access a System/370* (S/370) 
  419. architecture host through an SNA gateway. Up to 254 workstations can be 
  420. configured on the LAN supported by the SNA gateway. 
  421.  
  422. A gateway permits communication between hosts that support PU 2.0 workstations 
  423. and workstations that use different DLC types.  An SNA gateway can do the 
  424. following: 
  425.  
  426. o Act as a protocol converter between workstations that use DLCs on their links 
  427.   that are different from the DLC that is used on the host link 
  428.  
  429. o Reduce the amount of system definition at the host and workstations 
  430.  
  431. o Allow you to dynamically change network definitions and add workstations 
  432.  
  433. o Reduce host resources by using pooled LUs, and by automatically logging off 
  434.   unused sessions 
  435.  
  436. * Trademark of IBM Corporation 
  437.  
  438.  
  439. ΓòÉΓòÉΓòÉ 3.12. Twinaxial Data Link Control (TDLC) ΓòÉΓòÉΓòÉ
  440.  
  441. Communications Manager supports twinaxial data link control (TDLC), which is a 
  442. communications function that allows workstations attached to a workstation 
  443. controller by way of twinaxial cable to use 5250 emulation and APPC. 
  444.  
  445. Note:  5250 emulation for twinaxial connection is for an IBM Applications 
  446. System/400* (AS/400) only. 
  447.  
  448. *  Trademark of IBM. 
  449.  
  450.  
  451. ΓòÉΓòÉΓòÉ 3.13. User Profile Management (UPM) Services ΓòÉΓòÉΓòÉ
  452.  
  453. User Profile Management lets you control access to shared resources, such as 
  454. file systems and databases. You can use UPM to create, manage, and view 
  455. individual and group user IDs as well as to set authority levels. 
  456.  
  457. In Communications Manager, advanced program-to-program communications (APPC) 
  458. and 5250 emulation use UPM to control access to remote computers by requiring 
  459. users to log on at the UPM logon window. 
  460.  
  461. The User's Desk Reference contains information about administering and using 
  462. UPM.  In addition, the Command Reference contains descriptions and syntax for 
  463. UPM commands that you can type from the OS/2 command line. 
  464.  
  465.  
  466. ΓòÉΓòÉΓòÉ 3.14. X.25 Network Support ΓòÉΓòÉΓòÉ
  467.  
  468. Communications Manager supports communications over X.25 packet switching data 
  469. networks (PSDNs) using either permanent or switched virtual circuits.  SNA 
  470. applications can use this connection through the qualified logical link control 
  471. (QLLC). The complete data traffic from all the sessions on an SNA link can be 
  472. carried over a single virtual circuit. 
  473.  
  474. In addition, an API for non-SNA communications is provided so that a single 
  475. X.25 link can carry a mixture of multiple SNA and non-SNA virtual circuits 
  476. concurrently. X.25 is supported within SAA common communications protocol. 
  477.  
  478.  
  479. ΓòÉΓòÉΓòÉ <hidden> Connecting to Multiple Hosts ΓòÉΓòÉΓòÉ
  480.  
  481. Communications Manager provides the ability to communicate to multiple hosts 
  482. (SSCPs) on separate logical links through unique PU connections.  This can be 
  483. useful in the following situations: 
  484.  
  485. o LU 6.2 access to public networks (for example, X.25) of hosts that have not 
  486.   installed VTAM* 3.2 or later, and that cannot establish cross-domain links 
  487.  
  488. o LU 0, 1, 2, or 3 access to hosts in different domains, where cross-domain 
  489.   configuration is not possible 
  490.  
  491. o Direct routes to multiple hosts when this is more efficient than a route 
  492.   through cross-domain links 
  493.  
  494. o Multiple links to the same host for gateway configurations that require more 
  495.   than 254 dependent host LUs 
  496.  
  497. * Trademark of IBM 
  498.  
  499.  
  500. ΓòÉΓòÉΓòÉ <hidden> Managing 3270 and 5250 Sessions ΓòÉΓòÉΓòÉ
  501.  
  502. Communications Manager provides a way for you to view a list of configured 
  503. emulator sessions and to start and stop those sessions. 
  504.  
  505.  
  506. ΓòÉΓòÉΓòÉ 4. Emulation ΓòÉΓòÉΓòÉ
  507.  
  508. Communications Manager allows your workstation to emulate, or perform like, a 
  509. 3270 or 5250 host display terminal, and to establish host printer sessions with 
  510. a workstation printer. The type of emulation (3270 or 5250) depends on the type 
  511. of host computer you are communicating with.  An individual workstation can be 
  512. connected to multiple hosts and perform both types of emulation. 
  513.  
  514. These connections, called emulation sessions, allow you to have access to host 
  515. computer functions as if you were using a 3270 or 5250 host display terminal. 
  516.  
  517. Note:  5250 emulation does not support the IBM System/36* (S/36). 
  518.  
  519. 3270 and 5250 emulation sessions are managed through Presentation Manager 
  520. windows.  As a result, you can change the color, size, and location of an 
  521. emulator session window on your screen.  You make these changes either during 
  522. configuration, or during runtime through the Menu Bar. 
  523.  
  524. The Menu Bar gives you access to a variety of emulator user functions, 
  525. including: 
  526.  
  527. o File transfer to and from host systems 
  528.  
  529. o Host graphics capabilities 
  530.  
  531. o Keyboard remapping 
  532.  
  533. o Color customizing of emulator session screens 
  534.  
  535. o Font size customizing 
  536.  
  537. o Pop-up Keypad function 
  538.  
  539. o Hotspots for mouse usage in emulation sessions 
  540.  
  541. o Numeric Lock function 
  542.  
  543.  In addition, the Menu Bar gives you access to a number of OS/2 features such 
  544. as Clipboard and print screen functions. Each emulation session appears in its 
  545. own window. All printer sessions appear in a print control window. 
  546.  
  547. Depending on the connections configured for your workstation, you can start: 
  548.  
  549. o 5 coaxial terminal or printer 3270 sessions 
  550. o 16 active display sessions for 3270 (For OS/2 2.1, the limit of active 
  551.   display sessions is increased to 26.) 
  552. o 15 terminal or printer 5250 sessions 
  553.  
  554. You can start up to 26 sessions concurrently, combining 3270 and 5250 terminal 
  555. emulations and printer sessions. 
  556.  
  557. Communications Manager supports data compression for 3270 and 5250 emulation 
  558. session communications. 
  559.  
  560. The types of connections used for your sessions are shown in the 3270/5250 
  561. Session Management window.  Your system administrator can tell you about the 
  562. configuration of your workstation and about the session types available to you. 
  563.  
  564. *  Trademark of IBM. 
  565.  
  566.  
  567. ΓòÉΓòÉΓòÉ 4.1. Menu Bar ΓòÉΓòÉΓòÉ
  568.  
  569. The Menu Bar, at the top of your emulator session window, gives you access to a 
  570. variety of emulator user functions.  The Menu Bar selections are File, Edit, 
  571. Transfer, Settings, Keyboard, and Help.  Help is provided for each selection 
  572. and for each of the choices they contain. 
  573.  
  574. The System Menu, in the upper left corner of the emulator screen, contains a 
  575. Hide/Show Menu Bar option, and a Popup Menu Bar option. 
  576.  
  577.  
  578. ΓòÉΓòÉΓòÉ 4.2. File Transfer ΓòÉΓòÉΓòÉ
  579.  
  580. You can send files to a host computer or receive files from a host computer 
  581. using 3270 terminal emulation.  This is called a file transfer.  IBM host 
  582. computers that use VM, TSO, or CICS system software and have the required file 
  583. transfer program installed, support file transfer using 3270 terminal 
  584. emulation. 
  585.  
  586. File transfer uses an emulator session to transfer a file. You must be logged 
  587. on to the emulator session you want to use for the file transfer.  File 
  588. transfer has exclusive use of the session and you cannot interact with the host 
  589. application while file transfer is running. 
  590.  
  591. You can send or receive files either of two ways: 
  592.  
  593. o Using the Transfer function, accessible through the Menu Bar 
  594. o From the OS/2 command prompt 
  595.  
  596. When you transfer files using Send file or Receive file from the Transfer menu 
  597. on the Menu Bar, you specify the file transfer options to be used for the 
  598. transfer.  You can name and save sets of options so that you can use them for 
  599. other file transfer sessions. 
  600.  
  601. You can also transfer multiple files at once by specifying the name of a file 
  602. list you have created.  Even during multiple file transfer each individual file 
  603. can have its own set of file transfer options. 
  604.  
  605. Also, by using the asterisk (*) as a wildcard character, you can transfer 
  606. multiple files with the same request.  For example, 
  607.  
  608. * EXEC * 
  609.    All EXEC files 
  610.  
  611. CON* * * 
  612.    All files having names beginning with "CON" 
  613.  
  614. The 5250 emulator does not support file transfer between the PC and the host 
  615. computer.  However, file transfer is available when you use the PC Support 
  616. programs on AS/400. 
  617.  
  618.  
  619. ΓòÉΓòÉΓòÉ 4.3. Host Graphics ΓòÉΓòÉΓòÉ
  620.  
  621. You can use the Graphical Data Display Manager (GDDM) host graphics support in 
  622. a 3270 emulation session.  GDDM-OS/2 Link file must be installed on your host 
  623. to allow you to download the necessary files to your workstation. 
  624.  
  625. To customize Host Graphics, select Host Graphics from the Settings menu on the 
  626. Menu Bar. 
  627.  
  628. For more information, refer to the Graphical Data Display Manager publications. 
  629.  
  630.  
  631. ΓòÉΓòÉΓòÉ 4.4. Keyboard Remapping ΓòÉΓòÉΓòÉ
  632.  
  633. The Communications Manager keyboard utility enables you to change key 
  634. assignments on the keyboard you use in terminal emulation.  You can customize 
  635. key operations to match the keyboard layout you are accustomed to using. 
  636.  
  637. A keyboard layout is the physical arrangement of the keyboard.  In that layout, 
  638. functions are assigned, or mapped, to keys.  These key assignments are called 
  639. the keyboard mapping.  They are contained in a keyboard profile within a 
  640. Communications Manager configuration file. 
  641.  
  642. Communications Manager provides default keyboard mappings for workstations that 
  643. use terminal emulation.  You can use these defaults or use the keyboard utility 
  644. to change them. 
  645.  
  646. There are two ways to start the keyboard utility program: 
  647.  
  648. o From the Keyboard menu on the Menu Bar 
  649.  
  650. o From the 3270/5250 emulation configuration windows in CMSETUP 
  651.  
  652. Using the keyboard utility, you can: 
  653.  
  654. o Move a definition from a source key to a target key 
  655.  
  656. o Copy a definition from a source key to a target key 
  657.  
  658. o Swap the definitions of a source key and a target key 
  659.  
  660. o Print a copy of the keyboard layout 
  661.  
  662. o Locate keys assigned to a specified function 
  663.  
  664. o Display the current keyboard definitions 
  665.  
  666. o Remap a selected key 
  667.  
  668. A browse function enables you to view the current definitions for each key. 
  669.  
  670.  
  671. ΓòÉΓòÉΓòÉ 4.5. Color Customizing ΓòÉΓòÉΓòÉ
  672.  
  673. The foreground and background colors of the 3270 and 5250 emulation sessions 
  674. are specified during configuration.  You can accept these default colors or 
  675. choose your own. 
  676.  
  677. To choose your own, use the Settings option on the Menu Bar and select Color. 
  678.  
  679. As you select new colors the change is immediately made to the current 
  680. emulation session window. This lets you view the effect of your color changes 
  681. before you save them. 
  682.  
  683.  
  684. ΓòÉΓòÉΓòÉ 4.6. Font Size ΓòÉΓòÉΓòÉ
  685.  
  686. You can change the font size by selecting Settings from the Menu Bar, then 
  687. selecting font size.  The font size you select remains active until it is 
  688. changed. 
  689.  
  690. The Font Size window allows you to perform the following tasks: 
  691.  
  692. o Accept a font size automatically determined by the emulator program 
  693.  
  694. o Select a font size from the list 
  695.  
  696. The fields and buttons specific to this window are: 
  697.  
  698. o Automatic font selection 
  699. o Fixed size 
  700.  
  701. Automatic font selection lets the emulator program automatically assign the 
  702. font size according to the window size. 
  703.  
  704. Fixed size allows you to change the font for data displayed in the emulator 
  705. session window. 
  706.  
  707.  
  708. ΓòÉΓòÉΓòÉ 4.7. Pop-up Keypad ΓòÉΓòÉΓòÉ
  709.  
  710. A popup keypad is a small window containing push buttons, or keys, so that you 
  711. can use your mouse to perform keyboard operations.  Communications Manager lets 
  712. you define two popup keypads, each with eight push buttons. 
  713.  
  714. To display a popup keypad, place your mouse pointer anywhere in the emulator 
  715. session window and click once with mouse button 2. The keypad pops up at the 
  716. mouse pointer position. 
  717.  
  718. The push buttons have default assignments, but you can customize your keypads 
  719. using the Popup Keypad Setup window, which is accessed from the Menu Bar under 
  720. Keyboard. 
  721.  
  722. Use the Popup Keypad Setup window to customize the popup keypads in the 
  723. following ways: 
  724.  
  725. o Change a key assignment on a popup keypad 
  726. o Display the current settings of a popup keypad 
  727. o Select the mode of operation for a popup keypad 
  728.  
  729. You can define a popup keypad to be either sticky or a non-sticky.  A sticky 
  730. popup keypad will remain displayed on your screen after an action is completed. 
  731. A non-sticky popup keypad will disappear after an action is complete. 
  732.  
  733.  
  734. ΓòÉΓòÉΓòÉ 4.8. Hotspots ΓòÉΓòÉΓòÉ
  735.  
  736. A hotspot is the area on a host screen that allows you to use your mouse to 
  737. execute a host function or host command without pressing a function key or 
  738. typing a command. 
  739.  
  740. The Hotspots Setup window allows you to select the function keys and host 
  741. commands that can be activated by using a mouse. 
  742.  
  743. You can access the Hotspots Setup window from the Settings menu on the Menu 
  744. Bar. 
  745.  
  746.  
  747. ΓòÉΓòÉΓòÉ 4.9. Numeric Lock ΓòÉΓòÉΓòÉ
  748.  
  749. The Numeric Lock window allows you to activate a numeric lock field in a host 
  750. application that is running on your 3270 emulator session. If you are working 
  751. in a host application containing protected fields that only accept certain 
  752. numbers and characters, this feature allows you to "turn off" the rest of the 
  753. keyboard while your cursor is in the protected field and minimize the chance 
  754. for errors. 
  755.  
  756. This feature is only available for 3270 emulator sessions. 
  757.  
  758.  
  759. ΓòÉΓòÉΓòÉ 4.10. Data Compression ΓòÉΓòÉΓòÉ
  760.  
  761. Data compression is the process of compressing repeated characters or repeated 
  762. data strings to shorten the length of records or blocks, thus reducing transfer 
  763. time for communications. 
  764.  
  765. Communications Manager supports SNA session level data compression with the Run 
  766. Length Encoding (RLE) and Limpel-Ziv 9-bit (LZ9) compression algorithms. 
  767.  
  768. With Communications Manager you can specify the use of data compression for 
  769. communications over 3270 and 5250 emulation sessions, APPC/APPN sessions, and 
  770. LUA sessions. 
  771.  
  772. Note:  3270 emulation supports only LZ9 for outbound data streams and RLE for 
  773. inbound data streams. 
  774.  
  775.  
  776. ΓòÉΓòÉΓòÉ 4.11. Double-Byte Character Set Support ΓòÉΓòÉΓòÉ
  777.  
  778. The Communications Manager OS/2 3270/5250 emulator now has both single-byte 
  779. character set (SBCS) and double-byte character set (DBCS) capability, making 
  780. Communications Manager fully-enabled for DBCS. 
  781.  
  782.  
  783. ΓòÉΓòÉΓòÉ 5. Installation and Configuration ΓòÉΓòÉΓòÉ
  784.  
  785. When you install Communications Manager, you indicate the directory where you 
  786. want the base files to be installed. The next step is to install a 
  787. configuration. 
  788.  
  789. Many customers require a program called LAN Adapter and Protocol Support (LAPS) 
  790. to make use of Communications Manager. You must install and configure LAPS 
  791. before you install Communications Manager in the following situations: 
  792.  
  793. o When you are going to upgrade a Communications Manager configuration that was 
  794.   established using OS/2 Extended Edition for use with local area network (LAN) 
  795.   Transport. 
  796.  
  797. o When you are going to use Communications Manager to establish connections on 
  798.   an integrated services digital network (ISDN). 
  799.  
  800. When you establish a configuration definition, you supply information about the 
  801. workstation and your network, and you make selections that indicate how you 
  802. want a feature or application to work on the workstation. 
  803.  
  804. Features and Applications That You Can Configure 
  805.  
  806. When you configure one or more of the features or applications for use with 
  807. Communications Manager, your workstation can perform the following functions: 
  808.  
  809. o 3270 emulation 
  810.  
  811. o 5250 emulation 
  812.  
  813. o ACDI APIs 
  814.  
  815. o ACDI redirection 
  816.  
  817. o APPC APIs 
  818.  
  819. o CPI Communications 
  820.  
  821. o LUA APIs 
  822.  
  823. o X.25 APIs 
  824.  
  825. o Gateway 
  826.  
  827. Communications Manager Configuration Methods 
  828.  
  829. For 3270 and 5250 emulation, Communications Manager offers two configuration 
  830. methods: 
  831.  
  832. o Default Configuration 
  833.  
  834. o Advanced Configuration 
  835.  
  836. When you configure features and applications other than emulation, 
  837. Communications Manager automatically uses the advanced configuration method. 
  838.  
  839. After your configuration is created, you can use Keylock to lock or unlock a 
  840. configuration. 
  841.  
  842.  
  843. ΓòÉΓòÉΓòÉ 5.1. Install a Configuration ΓòÉΓòÉΓòÉ
  844.  
  845. The setup process consists of creating or changing a configuration for your own 
  846. workstation or someone else's workstation. 
  847.  
  848. A configuration is a description of the devices, optional features, and 
  849. communications settings on your workstation. Communications Manager uses the 
  850. information stored in your configuration to establish and manage your network 
  851. communications. 
  852.  
  853. o You can use Communications Manager to create your configuration, and then 
  854.   install it. 
  855.  
  856. o You can install a configuration created for you by someone else. You must use 
  857.   this option if you are running the Workgroup Client Support feature. 
  858.  
  859. o You can install a configuration created for your workstation with an earlier 
  860.   version of Communications Manager. 
  861.  
  862. If you are creating a new configuration, Communications Manager will guide you 
  863. through the setup process.  When you finish creating your configuration, you 
  864. have the option to install it or to save it to install at a later time. 
  865.  
  866. If you are installing an existing configuration, Communications Manager will 
  867. guide you through the installation process. Configurations created with an 
  868. earlier version of Communications Manager are automatically upgraded. 
  869.  
  870.  
  871. ΓòÉΓòÉΓòÉ 5.2. 3270 Emulation ΓòÉΓòÉΓòÉ
  872.  
  873. Your workstation functions as a 3270 terminal when communicating with an IBM 
  874. System/370* host computer. You can configure 3270 emulation for all workstation 
  875. connection types except asynchronous. 
  876.  
  877. * Trademark of IBM 
  878.  
  879.  
  880. ΓòÉΓòÉΓòÉ 5.3. 5250 Emulation ΓòÉΓòÉΓòÉ
  881.  
  882. Your workstation functions as a 5250 terminal when communicating with an IBM 
  883. Applications System/400* or an IBM System/36* host computer. You can configure 
  884. 5250 emulation for all workstation connection types except asynchronous and 
  885. DFT. 
  886.  
  887. Note:  5250 emulation does not support the System/36. 
  888.  
  889. * Trademark of IBM 
  890.  
  891.  
  892. ΓòÉΓòÉΓòÉ 5.4. ACDI APIs ΓòÉΓòÉΓòÉ
  893.  
  894. Your workstation with an asynchronous connection uses custom applications that 
  895. interact with the functions of the asynchronous communications device interface 
  896. (ACDI) provided by Communications Manager.  For example, the Softerm Custom 
  897. Plus ASCII Emulator uses the ACDI API to connect to various networks, such as 
  898. the IBM Information network. 
  899.  
  900.  
  901. ΓòÉΓòÉΓòÉ 5.5. ACDI Redirection ΓòÉΓòÉΓòÉ
  902.  
  903. Asynchronous communications device interface (ACDI) redirection is a 
  904. Communications Manager function that allows you to reassign the serial 
  905. communication ports on your workstation to asynchronous devices, such as 
  906. modems, at a Local Area Network Asynchronous Connection Server (LANACS) 
  907. gateway.  By reassigning ports, you can direct data to different destinations, 
  908. without changing your hardware configuration. 
  909.  
  910. Your Communications Manager workstation that is connected to a PC Network, 
  911. Ethernet (ETHERAND), token ring, or other LAN network, communicates with 
  912. asynchronous terminals and other devices by redirecting your serial port to a 
  913. LANACS server. You can configure ACDI redirection for all LAN workstation 
  914. connection types. 
  915.  
  916.  
  917. ΓòÉΓòÉΓòÉ 5.6. APPC APIs ΓòÉΓòÉΓòÉ
  918.  
  919. Your workstation uses the advanced program-to-program communications (APPC) 
  920. protocol to communicate with other network stations and to share programs with 
  921. those stations. You can configure APPC APIs for all workstation connection 
  922. types except asynchronous and DFT. 
  923.  
  924.  
  925. ΓòÉΓòÉΓòÉ 5.7. CPI Communications ΓòÉΓòÉΓòÉ
  926.  
  927. Your workstation uses the common programming interface communications (CPI-C) 
  928. protocols and conventions to communicate with other network stations.  CPI-C is 
  929. the application program interface (API) provided with advanced peer-to-peer 
  930. networking (APPN).  You can configure CPI-C for all workstation connection 
  931. types except asynchronous and DFT. 
  932.  
  933.  
  934. ΓòÉΓòÉΓòÉ 5.8. LUA APIs ΓòÉΓòÉΓòÉ
  935.  
  936. Your workstation uses custom applications that interface with and use the 
  937. functions of logical unit (LU) programming. You can configure LUA APIs for all 
  938. workstation connection types except asynchronous and DFT. 
  939.  
  940.  
  941. ΓòÉΓòÉΓòÉ 5.9. X.25 APIs ΓòÉΓòÉΓòÉ
  942.  
  943. Your workstation uses custom applications that use the functions of the X.25 
  944. network protocol. 
  945.  
  946.  
  947. ΓòÉΓòÉΓòÉ 5.10. Default Configuration ΓòÉΓòÉΓòÉ
  948.  
  949. This is the standard method that you use to configure 3270 or 5250 emulation on 
  950. the following workstation connection types: 
  951.  
  952. o Ethernet (ETHERAND) network 
  953.  
  954. o PC Network 
  955.  
  956. o SDLC (synchronous data link control) 
  957.  
  958. o Token ring or other LAN types 
  959.  
  960. o Twinaxial. 
  961.  
  962. With default configuration, Communications Manager relies on a set of assumed 
  963. defaults to set up the configuration definitions.  You have to supply only the 
  964. information that is unique to your workstation and your network, such as the 
  965. destination address and the local node name. 
  966.  
  967. You can set up your workstation quickly for emulation, without having to make a 
  968. lot of decisions, by using the assumed defaults. 
  969.  
  970.  
  971. ΓòÉΓòÉΓòÉ 5.11. Advanced Configuration ΓòÉΓòÉΓòÉ
  972.  
  973. When you use this method, you complete a set of profiles in which you select 
  974. and supply information to make the emulation perform efficiently for your 
  975. communication needs. 
  976.  
  977. When you want to tailor Communications Manager emulation operations to the 
  978. special needs of your workstation or your network, advanced configuration is 
  979. the best method. 
  980.  
  981. Note:  Communications Manager automatically uses the advanced configuration 
  982. method if you select several features or applications in one configuration. 
  983.  
  984.  
  985. ΓòÉΓòÉΓòÉ 5.12. Gateway ΓòÉΓòÉΓòÉ
  986.  
  987. This choice displays a list of the profiles you use to configure the 
  988. workstation as a gateway. A gateway is a workstation that translates addresses 
  989. between the network host computer and the workstations on your network. 
  990.  
  991.  
  992. ΓòÉΓòÉΓòÉ 6. Application Programming Interfaces ΓòÉΓòÉΓòÉ
  993.  
  994. Communications Manager provides a number of application program interfaces 
  995. (APIs) to address the communication needs for connections to both IBM and 
  996. non-IBM computers. All of the APIs are accessible from both full-screen and 
  997. windowed applications. 
  998.  
  999. o Emulator High-Level Language Application Programming Interface (EHLLAPI) 
  1000.  
  1001. o Server-Requester programming interface (SRPI) 
  1002.  
  1003. o Conventional LU application (LUA) 
  1004.  
  1005. o Advanced program-to-program communications (APPC) 
  1006.  
  1007. o SAA common programming interface (CPI) for communications 
  1008.  
  1009. o System management 
  1010.  
  1011. o Asynchronous communications device interface (ACDI) and ACDI Redirection APIs 
  1012.  
  1013. o X.25 
  1014.  
  1015. o Communications Manager Kernel 
  1016.  
  1017. o Common services 
  1018.  
  1019. o Service Point Application Router/Remote Operations Service (SPAR/ROPS) 
  1020.  
  1021. o ISDN Connection manager interface (CMI) 
  1022.  
  1023. o ISDN Port Connection Manager (PCM) 
  1024.  
  1025. o IBM Realtime Interface CoProcessor Device Driver Programming Interface 
  1026.  
  1027.  
  1028. ΓòÉΓòÉΓòÉ 6.1. Communications Manager Kernel ΓòÉΓòÉΓòÉ
  1029.  
  1030. The Communications Manager kernel is the main component of Communications 
  1031. Manager.  The kernel stops and starts other Communications Manager components 
  1032. and provides services that the components need.  The kernel provides 
  1033. Communications Manager status reporting services. 
  1034.  
  1035. The kernel API allows application programs to use kernel services.  The kernel 
  1036. API calls perform the following tasks: 
  1037.  
  1038. o Loading and unloading the kernel 
  1039.  
  1040. o Activating and deactivating service requests 
  1041.  
  1042. o Querying Communications Manager status 
  1043.  
  1044. o Retrieving an active directory name from the Communications Manager 
  1045.   environment. 
  1046.  
  1047.  
  1048. ΓòÉΓòÉΓòÉ <hidden> Asynchronous Communications Device Interface (ACDI) and ACDI Redirection APIs ΓòÉΓòÉΓòÉ
  1049.  
  1050. Communications Manager provides a programming interface for asynchronous 
  1051. communications and provides ACDI functions that do the following: 
  1052.  
  1053. o Provide device independence and support a variety of asynchronous 
  1054.   communications devices and connection types such as: 
  1055.  
  1056.    - Switched and non-switched lines 
  1057.  
  1058.    - Modems (auto-dial, auto-answer, manual dial, manual answer) 
  1059.  
  1060.    - Direct connections 
  1061.  
  1062. o Support asynchronous communications device command sets: 
  1063.  
  1064.    - Attention command set (an IBM-supplied and user-edited device command set 
  1065.      that supports Hayes** Smartmodem** and compatibles) 
  1066.  
  1067.    - CCITT V.25bis command set (an IBM-supplied and user-edited device command 
  1068.      set that supports V.25bis) 
  1069.  
  1070.    - No command set (a user-supplied device command set that supports circuits 
  1071.      that adhere to CCITT V.24) 
  1072.  
  1073. o Support traditional asynchronous communication protocols such as: 
  1074.  
  1075.    - Flow control 
  1076.  
  1077.    - Break processing 
  1078.  
  1079. o Support two dissimilar external devices attached through an A/B switch 
  1080.  
  1081. o Provide ports for resource management: 
  1082.  
  1083.    - Three asynchronous ports for computers with MicroChannel* buses (COM1, 
  1084.      COM2, COM3) 
  1085.  
  1086.    - Two asynchronous ports for computers with AT type buses (COM1, COM2) 
  1087.  
  1088. o Provide communications and system management (C & SM) support 
  1089.  
  1090. o Provide flexible input and output interfaces for data transfers 
  1091.  
  1092. o Manage application buffers for transmitted and received data 
  1093.  
  1094. o Provide asynchronous port sharing where auto-answer and auto-dial are 
  1095.   allocated to the same port 
  1096.  
  1097. o Assist country requirements for connecting computers to telephone networks. 
  1098.  
  1099. Communications Manager enables users to access a range of computers, including 
  1100. IBM and non-IBM host computer systems. In addition, several connections can be 
  1101. active concurrently, giving users rapid access to information from any point in 
  1102. a network. 
  1103.  
  1104. The Asynchronous Communications Device Interface (ACDI) can be redirected to an 
  1105. IBM Local Area Network Asynchronous Connection Server (LANACS) Version 2.0. 
  1106. LANACS is an IBM DOS product that provides asynchronous connection server 
  1107. capability to a LAN.  The server that runs the LANACS program provides 
  1108. asynchronous resources-serial ports, asynchronous connection equipment, and 
  1109. telephone lines-that can be shared by workstations on a LAN.  An Operating 
  1110. System/2* (OS/2*) workstation on the LAN can use serial ports on the 
  1111. asynchronous connection server as if the serial ports were located at the 
  1112. workstation. 
  1113.  
  1114. ACDI is the programming interface that provides support for those who want to 
  1115. use the serial ports for asynchronous communications in a multitasking 
  1116. environment.  ACDI interacts with the serial ports through the base operating 
  1117. system and ensures that interrupts are handled and data is buffered for 
  1118. applications as required. 
  1119.  
  1120.  
  1121. ΓòÉΓòÉΓòÉ 6.2. Advanced Program-To-Program Communications (APPC) ΓòÉΓòÉΓòÉ
  1122.  
  1123. Communications Manager provides advanced peer-to-peer networking (APPN) end 
  1124. node and network node support for workstations, allowing them to communicate 
  1125. more flexibly with other systems in the network. 
  1126.  
  1127. Communications Manager provides advanced program-to-program communications 
  1128. (APPC) to support communications between distributed processing programs, 
  1129. called transaction programs (TPs).  APPN extends this capability to a 
  1130. networking environment.  The TPs can be located at any node in the network that 
  1131. provides APPC. 
  1132.  
  1133. Communications Manager improves APPC throughput in performance-critical local 
  1134. area network (LAN) environments. If you plan to install Communications Manager 
  1135. on a LAN, LAN adapter and protocol support (LAPS) is required. 
  1136.  
  1137. The level of LAPS shipped with Network Transport Services/2 (NTS/2) Version 1.0 
  1138. or LAN Server Version 3.0 is recommended; however, Communications Manager also 
  1139. supports the levels of LAPS available with LAN Server Version 2.0 and Extended 
  1140. Services for OS/2. Communications Manager supports the following protocols for 
  1141. APPC: 
  1142.  
  1143. o IBM Token-Ring Network 
  1144.  
  1145. o 3174 Peer Communications 
  1146.  
  1147. o Token-Ring Bus Master 
  1148.  
  1149. o Synchronous Data Link Control (SDLC) 
  1150.  
  1151. o IBM PC Network* 
  1152.  
  1153. o Twinaxial 
  1154.  
  1155. o Ethernet (ETHERAND) 
  1156.  
  1157. o X.25 
  1158.  
  1159.  
  1160. ΓòÉΓòÉΓòÉ 6.3. System Management ΓòÉΓòÉΓòÉ
  1161.  
  1162. System management allows a system administrator to control and obtain status 
  1163. information about the SNA communication resources maintained by Communications 
  1164. Manager. It allows activation and deactivation of sessions and data link 
  1165. controls. 
  1166.  
  1167. System management provides verbs that perform display, subsystem management, 
  1168. configuration, management services, and node definition functions. The 
  1169. following list provides a brief description of the system management verbs: 
  1170.  
  1171. o Display verbs 
  1172.  
  1173.   Display verbs allow you to display general configuration information and 
  1174.   current operating values for SNA node. 
  1175.  
  1176. o Subsystem management verbs 
  1177.  
  1178.   The subsystem management verbs provide programs with a method for managing 
  1179.   sessions, links, and the APPC attach manager. 
  1180.  
  1181. o Configuration verbs 
  1182.  
  1183.   Configuration verbs allow authorized programs to configure resources such as 
  1184.   LUs and TPs. 
  1185.  
  1186. o Management services verbs 
  1187.  
  1188.   Management services verbs provide programs with a method of reporting 
  1189.   potential problems to management services focal points. 
  1190.  
  1191.  
  1192. ΓòÉΓòÉΓòÉ 6.4. ISDN Connection Manager Interface (CMI) ΓòÉΓòÉΓòÉ
  1193.  
  1194. Communications Manager provides a switched-network connection management 
  1195. environment and call control capabilities within the CMI to establish 
  1196. connections over the switched network. 
  1197.  
  1198. Your workstation can use Communications Manager to do the following: 
  1199.  
  1200. o Communicate with host computers or other workstations through: 
  1201.  
  1202.    - Cables for locally attached machines 
  1203.  
  1204.    - Networks for remotely located machines such as: 
  1205.  
  1206.       o Local area networks (LANs) 
  1207.  
  1208.       o Networks conforming to systems network architecture (SNA) 
  1209.  
  1210.       o X.25 networks 
  1211.  
  1212. o Control the method of data exchange between your workstation and a host 
  1213.   computer or another workstation by using various communications protocols or 
  1214.   techniques, such as: 
  1215.  
  1216.    - Synchronous data link control (SDLC) 
  1217.  
  1218.    - X.25 protocol 
  1219.  
  1220.    - Asynchronous communications 
  1221.  
  1222. o Emulate a 3270 display terminal or an ASCII terminal when communicating with 
  1223.   a host computer or workstation 
  1224.  
  1225. o Emulate a 5250 display terminal when communicating with an IBM Application 
  1226.   Systems/400* (AS/400*) or IBM System/36* (S/36) host computer. 
  1227.  
  1228. o Use Remote Data Services to communicate with databases that reside on other 
  1229.   workstations or host computers. 
  1230.  
  1231. Note:  5250 emulation does not support System/36. 
  1232.  
  1233.  
  1234. ΓòÉΓòÉΓòÉ 6.5. Common Services ΓòÉΓòÉΓòÉ
  1235.  
  1236. The common services programming interface verbs are available to all 
  1237. application programs that use the Communications Manager APIs. 
  1238.  
  1239. The common services verbs perform the following tasks: 
  1240.  
  1241. o Enable and disable X.25 physical links 
  1242.  
  1243. o Provide American National Standard Code for Information Interchange (ASCII) 
  1244.   to extended binary-coded decimal interchange code (EBCDIC), EBCDIC to ASCII, 
  1245.   and user-defined conversions on data streams 
  1246.  
  1247. o Format data in the trace storage buffer and copy the data to a specified file 
  1248.  
  1249. o Provide dumping for user-selected components and provide specification of the 
  1250.   file to which dump data is written 
  1251.  
  1252. o Trace API verbs and data 
  1253.  
  1254. o Display configuration information and operating values for active SNA nodes 
  1255.  
  1256. o Produce the translation table for specified code pages so user programs can 
  1257.   perform table lookup on characters to convert character strings 
  1258.  
  1259. o Record messages in the FFST/2 message log 
  1260.  
  1261. o Send message and error logs to a user-supplied queue 
  1262.  
  1263. o Send network management services messages to a network management services 
  1264.   control point. 
  1265.  
  1266.  
  1267. ΓòÉΓòÉΓòÉ 6.6. Conventional LU Application (LUA) ΓòÉΓòÉΓòÉ
  1268.  
  1269. LUA shares a physical unit with the 3270 emulator, the gateway function, and 
  1270. the advanced program-to-program communications APPC API.  LUA extends the 
  1271. capabilities of Communications Manager by supplying two APIs: 
  1272.  
  1273. o Request-unit interface, a basic interface 
  1274.  
  1275. o Session-level interface, a higher-level interface. 
  1276.  
  1277. LUA provides secondary support only for BIND LU types 0, 1, 2, or 3. The type 
  1278. of SNA BIND profiles that are supported for LU-LU sessions depends on the 
  1279. access method used. 
  1280.  
  1281. The services that LUA provides to application programs include only those 
  1282. supporting data communications. LUA does not provide any device emulation 
  1283. facilities. However, LUA does provide a unique subset of presentation services 
  1284. (PS) functions. 
  1285.  
  1286. LUA communications-connectivity requirements include the following IBM host 
  1287. systems: 
  1288.  
  1289. o AS/400 
  1290. o S/36 
  1291. o S/38 
  1292. o S/370 
  1293.  
  1294. Note:  5250 emulation does not support System/36. 
  1295.  
  1296. LUA permits host attachment by the following: 
  1297.  
  1298. o Synchronous data link control (SDLC) 
  1299. o Token-ring network 
  1300. o X.25 
  1301. o IBM PC network protocol (using a gateway) 
  1302. o Ethernet (ETHERAND) network protocol (using a gateway) 
  1303. o 3174 Peer Communications 
  1304. o Token-ring bus master 
  1305. o Integrated services digital network (ISDN) 
  1306.  
  1307.    - SDLC 
  1308.    - X.25 
  1309.  
  1310.  
  1311. ΓòÉΓòÉΓòÉ 6.7. Emulator High-Level Language Application Programming Interface (EHLLAPI) ΓòÉΓòÉΓòÉ
  1312.  
  1313. The Emulator High-Level Language API (EHLLAPI) is an application programming 
  1314. interface that allows workstation programs to interact with a host using 3270 
  1315. or 5250 emulation. 
  1316.  
  1317. An EHLLAPI application program acts as a programmed operator (a program that 
  1318. performs and monitors activities in a workstation that are usually done by a 
  1319. human).  An EHLLAPI application program can perform some or all of the 
  1320. following functions: 
  1321.  
  1322. o Automate repetitive tasks 
  1323.  
  1324. o Mask complete applications from the user 
  1325.  
  1326. o Consolidate several complicated tasks into one simple task 
  1327.  
  1328. o Simplify existing host applications 
  1329.  
  1330. o Monitor response time and availability 
  1331.  
  1332. o Monitor events that are diverse in nature 
  1333.  
  1334. o Automate console operations 
  1335.  
  1336. In addition, EHLLAPI facilitates communication from workstation application 
  1337. programs to host application programs using the 3270 data stream structured 
  1338. fields.  This allows for the generation of programs such as the file transfer 
  1339. applications used to transfer files between host and workstation environments. 
  1340.  
  1341.  
  1342. ΓòÉΓòÉΓòÉ 6.8. ISDN Port Connection Manager (PCM) ΓòÉΓòÉΓòÉ
  1343.  
  1344. The ISDN Port Connection Manager (PCM is a call control module that performs 
  1345. the functions required to connect and disconnect to, or through, a switched 
  1346. telephone network that supports ISDN. Each PCM manages one port on the network, 
  1347. establishing and disconnecting calls and controlling hardware resources. 
  1348.  
  1349.  
  1350. ΓòÉΓòÉΓòÉ 6.9. IBM Realtime Interface CoProcessor Device Driver Programming Interface ΓòÉΓòÉΓòÉ
  1351.  
  1352. The IBM Realtime Interface Co-Processor device driver is used by the base 
  1353. operating system to support the Realtime Interface Co-Processor family of 
  1354. communication adapters, including the following adapters: 
  1355.  
  1356. o Realtime Interface Co-Processor 2 Port 
  1357.  
  1358. o Multiport 
  1359.  
  1360. o Multiport Model 2 
  1361.  
  1362. o Multiport/2 
  1363.  
  1364. o PortMaster 
  1365.  
  1366. o X.25 
  1367.  
  1368. The device driver programming interface is available with Communications 
  1369. Manager for users who want to provide their own programming support for the 
  1370. co-processor adapter.  The main functions of the device driver are to: 
  1371.  
  1372. o Handle interrupts from the co-processor adapter 
  1373.  
  1374. o Determine which task on which co-processor adapter interrupted the system 
  1375.   unit, and signal the appropriate system unit processes 
  1376.  
  1377. o Read the parameter file and configure the co-processor adapter accordingly 
  1378.  
  1379. o Provide a programming interface to the co-processor adapter through the 
  1380.   generic input/output control (IOCtl) interface or through a set of dynamic 
  1381.   link libraries (DLL) 
  1382.  
  1383.  
  1384. ΓòÉΓòÉΓòÉ 6.10. SAA Common Programming Interface (CPI) for Communications ΓòÉΓòÉΓòÉ
  1385.  
  1386. The Systems Application Architecture (SAA) Common Programming Interface for 
  1387. Communications (CPI Communications) provides an alternative method of 
  1388. program-to-program communications that uses SNA LU 6.2 facilities. 
  1389.  
  1390. SAA describes a set of software interfaces, conventions, and protocols that 
  1391. provide a framework for designing and developing portable applications. 
  1392. Applications that follow SAA guidelines are easily integrated and will run on 
  1393. any hardware and software platform that provides an SAA environment. 
  1394.  
  1395. Both advanced program-to-program communications (APPC) and CPI Communications 
  1396. support transaction programs (TPs) that use Communications Manager APPC 
  1397. support. CPI Communications TPs, however, call SAA CPI Communications functions 
  1398. rather than issue APPC verbs. 
  1399.  
  1400. The CPI Communications functions and APPC verbs provide similar services. 
  1401. However, CPI Communications provides an API that is portable across multiple 
  1402. SAA platforms. 
  1403.  
  1404. CPI Communications provides calls for applications that require 
  1405. program-to-program communication. It makes use of SNA LU 6.2 facilities that 
  1406. include: 
  1407.  
  1408. o Starting a partner TP on a remote system 
  1409.  
  1410. o Sending or receiving data with a partner TP 
  1411.  
  1412. o Notifying a partner TP that an error has been detected 
  1413.  
  1414. o Synchronizing partner TPs 
  1415.  
  1416.  
  1417. ΓòÉΓòÉΓòÉ 6.11. Server-Requester Programming Interface (SRPI) ΓòÉΓòÉΓòÉ
  1418.  
  1419. The SRPI is a high-level API that allows programmers to write SRPI requester 
  1420. programs that request servers to perform tasks.  The SRPI API also supports 
  1421. ECF. 
  1422.  
  1423. ECF is a set of programs for interconnecting IBM workstations and IBM 
  1424. System/370 host computers operating in the MVS/XA or VM/SP environment. 
  1425.  
  1426. IBM ECF simplifies the way different systems use services over a connection. 
  1427. ECF provides a single interface that allows application programmers to write 
  1428. workstation and host applications that run on a variety of communication 
  1429. connections. 
  1430.  
  1431. SRPI has the following characteristics: 
  1432.  
  1433. o An interface for application programs in a workstation to request services, 
  1434.   data, or both from a host.  The requesting program is referred to as the SRPI 
  1435.   requester. 
  1436.  
  1437. o An interface for programs in a host to reply to requests for services, data, 
  1438.   or both from workstations.  The program that services the request is referred 
  1439.   to as the server. 
  1440.  
  1441. The SRPI requester and server programs operate in pairs, with the SRPI 
  1442. requester in the workstation and the server in the host computer. 
  1443.  
  1444. The SRPI router is a Communications Manager facility that uses information 
  1445. defined in the SRPI server profiles to route send requests to server programs 
  1446. using the appropriate 3270 sessions. 
  1447.  
  1448.  
  1449. ΓòÉΓòÉΓòÉ 6.12. Service Point Application Router/Remote Operations Service (SPAR/ROPS) ΓòÉΓòÉΓòÉ
  1450.  
  1451. A network management API allows you to initiate the processing of host NetView 
  1452. program commands from OS/2 programs. 
  1453.  
  1454. Communications Manager lets you initiate workstation commands from the host 
  1455. NetView program. The standard output of the commands is returned to the host 
  1456. NetView program. 
  1457.  
  1458. Two Communications Manager components provide this network management 
  1459. capability:  Service Point Application Router (SPA Router) and Remote 
  1460. Operations Service (ROP Service). SPA Router and ROP Service provide the 
  1461. following features: 
  1462.  
  1463. o Support for multiple LANs and multiple physical units (PUs) 
  1464.  
  1465. o Administration of wide area networks 
  1466.  
  1467. o System administration functions 
  1468.  
  1469. o Administration of different domains 
  1470.  
  1471. SPA Router is an OS/2 program that receives commands from the host NetView 
  1472. program and sends them to the specified application programs.  SPA Router can 
  1473. receive commands for multiple OS/2 applications concurrently. 
  1474.  
  1475. ROP Service processes, on the workstation, commands that the host NetView 
  1476. program sends through SPA Router.  ROP Services can process any OS/2 command 
  1477. that has a command line interface and that does not require operator input. 
  1478.  
  1479.  
  1480. ΓòÉΓòÉΓòÉ 6.13. X.25 ΓòÉΓòÉΓòÉ
  1481.  
  1482. The X.25 API enables non-SNA application programs to communicate with 
  1483. workstations, IBM hosts, and non-IBM hosts, using X.25 networks. 
  1484.  
  1485. X.25 packet switching data networks (PSDNs) are wide area networks (WANs) that 
  1486. usually connect workstations and computers over large geographical distances. 
  1487. An X.25 network subscriber can make calls to other subscribers and can have 
  1488. many calls in operation at the same time. Most public X.25 networks are 
  1489. interconnected, enabling world-wide international calling. Many corporations 
  1490. have their own private networks, while some are connected to public networks. 
  1491.  
  1492. Data is transmitted over an X.25 network in discrete, independent units called 
  1493. packets. Packets are sent over virtual circuits set up through the X.25 
  1494. network. Because virtual circuits are duplex, packets can be flowing in both 
  1495. directions at the same time. 
  1496.  
  1497. The placing of data in packets and the use of virtual circuits instead of real 
  1498. circuits enables a PSDN to dynamically and optimally manage its real resources. 
  1499. Packets from different virtual circuits can be multiplexed on the same 
  1500. communication line by the PSDN. However, to a network subscriber, a virtual 
  1501. circuit appears to be a dedicated line. A workstation may only need one 
  1502. physical link to communicate with many other workstations and computers because 
  1503. the link can carry many virtual circuits concurrently. 
  1504.  
  1505. This optimal use of resources can result in communications equipment savings 
  1506. which can, in turn, result in cheaper communications costs for the X.25 network 
  1507. subscriber. 
  1508.  
  1509.  
  1510. ΓòÉΓòÉΓòÉ 7. Problem Diagnosis ΓòÉΓòÉΓòÉ
  1511.  
  1512. Communications Manager provides the following information to assist in problem 
  1513. diagnosis: 
  1514.  
  1515. o Messages 
  1516. o Errors 
  1517. o Alerts 
  1518. o Traces 
  1519. o Dumps 
  1520.  
  1521. Communications Manager provides the following problem diagnosis facilities to 
  1522. display and interpret problem diagnosis information: 
  1523.  
  1524. o FFST/2 
  1525. o Problem Determination Aids 
  1526. o Common Services Application Programming Interface 
  1527.  
  1528.  
  1529. ΓòÉΓòÉΓòÉ 7.1. Messages ΓòÉΓòÉΓòÉ
  1530.  
  1531. Messages are displayed during Communications Manager sessions.  The appearance 
  1532. of a message does not always mean an error occurred.  For example, a message 
  1533. may tell you that an operation is in progress or complete. 
  1534.  
  1535. Online help is available for Communications Manager messages. In addition, 
  1536. detailed descriptions of all Communications Manager messages, their causes, and 
  1537. actions you should take are available in the Message Reference.  You can access 
  1538. this reference online by selecting it from the Communications Manager folder. 
  1539.  
  1540. Communications Manager message types and the actions you should take to respond 
  1541. to them are: 
  1542.  
  1543. o Information message 
  1544. o Warning message 
  1545. o Action message 
  1546. o File transfer message (TRANS prefix) 
  1547. o OIA message 
  1548. o Device driver message 
  1549.  
  1550. Messages and message helps are logged and displayed in the following ways: 
  1551.  
  1552. o Pop-up Window 
  1553. o Message Console 
  1554. o Message Log Formatter 
  1555.  
  1556.  
  1557. ΓòÉΓòÉΓòÉ <hidden> Information Message ΓòÉΓòÉΓòÉ
  1558.  
  1559. An information message appears if a situation occurs and there is no action you 
  1560. must take in response to the situation. 
  1561.  
  1562.  
  1563. ΓòÉΓòÉΓòÉ <hidden> Warning Message ΓòÉΓòÉΓòÉ
  1564.  
  1565. A warning message appears if a situation exists that you should be made aware 
  1566. of. Some warning messages include corrective actions you can take if you decide 
  1567. to modify the situation. 
  1568.  
  1569.  
  1570. ΓòÉΓòÉΓòÉ <hidden> Action Message ΓòÉΓòÉΓòÉ
  1571.  
  1572. An action message appears if a situation arises in which you must take some 
  1573. explicit action to correct the situation, or choose an alternative action. 
  1574. Correct the situation by taking the action provided with the message.  If 
  1575. instructions are not provided, select Help to view an explanation of the 
  1576. situation and the corrective action you can take for it. 
  1577.  
  1578.  
  1579. ΓòÉΓòÉΓòÉ <hidden> File Transfer Message (TRANS prefix) ΓòÉΓòÉΓòÉ
  1580.  
  1581. A file transfer message appears during file transfer with a 3270 host to report 
  1582. the current status of the transfer. 
  1583.  
  1584.  
  1585. ΓòÉΓòÉΓòÉ <hidden> OIA Message ΓòÉΓòÉΓòÉ
  1586.  
  1587. OIA messages appear on the operator information area (OIA) line at the bottom 
  1588. of the 3270 or 5250 session window. This area provides information about 
  1589. sessions and presentation space printing, including status and error messages. 
  1590. Host application programs also use this line to display messages that explain 
  1591. keystroke errors (although some programs may use a different line). 
  1592.  
  1593. You can use the online help information provided during a session to determine 
  1594. the causes and actions for those messages: 
  1595.  
  1596. o If your host computer is an AS/400, the host automatically displays help 
  1597.   information when you make a keystroke error. 
  1598.  
  1599. o If your host computer is an IBM System/36* (S/36), press the Help key to 
  1600.   display help information about an error code. 
  1601.  
  1602. o Select OIA message from the menu bar for additional OIA message information. 
  1603.  
  1604. Press the Error Reset key to return to the OIA display for 5250 sessions. 
  1605.  
  1606. Note:  5250 emulation does not support System/36. 
  1607.  
  1608. *  Trademark of IBM. 
  1609.  
  1610.  
  1611. ΓòÉΓòÉΓòÉ <hidden> Device Driver Message ΓòÉΓòÉΓòÉ
  1612.  
  1613. Device driver messages appear during startup of the workstation. 
  1614.  
  1615.  
  1616. ΓòÉΓòÉΓòÉ 7.2. Errors ΓòÉΓòÉΓòÉ
  1617.  
  1618. Errors are unexpected results that occur during a Communications Manager 
  1619. operation which require more detailed information than can be provided in a 
  1620. message.  Errors are logged in the system error log. 
  1621.  
  1622.  
  1623. ΓòÉΓòÉΓòÉ 7.3. Alerts ΓòÉΓòÉΓòÉ
  1624.  
  1625. Alerts are information units sent to a management services focal point in a 
  1626. network to identify problems or impending problems. Alerts are logged in 
  1627. EPWALERT.DMP, which you can view by using the FFST/2 dump formatter. 
  1628.  
  1629. See the Problem Determination Guide for more information about alerts. 
  1630.  
  1631.  
  1632. ΓòÉΓòÉΓòÉ 7.4. Traces ΓòÉΓòÉΓòÉ
  1633.  
  1634. Traces are records of data that provide a history of events that occurred 
  1635. during communications.  Select Problem determination aids in the Communications 
  1636. Manager/2 folder to obtain trace information. 
  1637.  
  1638. See the Problem Determination Guide for more information about traces. 
  1639.  
  1640.  
  1641. ΓòÉΓòÉΓòÉ 7.5. Dumps ΓòÉΓòÉΓòÉ
  1642.  
  1643. Dumps are copies of data stored in a portion of memory being used by 
  1644. Communications Manager components. Select Problem determination aids in the 
  1645. Communications Manager/2 folder to obtain dump information. 
  1646.  
  1647. See the Problem Determination Guide for more information about dumps. 
  1648.  
  1649.  
  1650. ΓòÉΓòÉΓòÉ <hidden> Pop-Up Window ΓòÉΓòÉΓòÉ
  1651.  
  1652. Usually the first indication of a problem is when a message appears in a pop-up 
  1653. window to let you know that a situation has occurred which may require your 
  1654. attention.  In most cases, help is available from this window. 
  1655.  
  1656.  
  1657. ΓòÉΓòÉΓòÉ <hidden> Message Console ΓòÉΓòÉΓòÉ
  1658.  
  1659. The message console is a window that you can activate to view messages as they 
  1660. are logged.  This service provides a similar function to the message log; 
  1661. however, no help is provided for the messages and the window's contents are 
  1662. erased when closed. 
  1663.  
  1664. For Communications Manager, use the message log formatter as the focal point 
  1665. for problem diagnosis and use the message console for configuring FFST/2. 
  1666.  
  1667.  
  1668. ΓòÉΓòÉΓòÉ <hidden> Message Log Formatter ΓòÉΓòÉΓòÉ
  1669.  
  1670. The message log formatter provides access to the Communications Manager 
  1671. messages that are stored in the default FFST/2 message log (OS2MLOG.DAT) and in 
  1672. other message logs defined by Communications Manager. 
  1673.  
  1674. When you receive a message, view the message in the message log formatter. 
  1675. Read the entire message and the message help and perform the actions indicated. 
  1676. If the message instructs you to look in the system error log or the FFST/2 dump 
  1677. formatter, note the time of the message and the problem ID to help you access 
  1678. the appropriate entries in the system error log and the dump formatter. 
  1679.  
  1680.  
  1681. ΓòÉΓòÉΓòÉ <hidden> FFST/2 ΓòÉΓòÉΓòÉ
  1682.  
  1683. First Failure Support Technology/2 (FFST/2) is a software problem diagnosis 
  1684. tool for OS/2 system software and applications.  It is designed to facilitate 
  1685. the capture of problem diagnosis information when a problem occurs. 
  1686.  
  1687. The following FFST/2 facilities are in the FFST/2 folder: 
  1688.  
  1689. o Start FFST/2 
  1690. o Stop FFST/2 
  1691. o Message Console 
  1692. o System Error Log 
  1693. o Dump Formatter 
  1694. o Message Log Formatter 
  1695.  
  1696. Unless you are an advanced user, your primary use of FFST/2 will be the system 
  1697. error log and the message log formatter choices. Refer to the Problem 
  1698. Determination Guide for a complete description of the tasks you can perform 
  1699. with FFST/2. 
  1700.  
  1701.  
  1702. ΓòÉΓòÉΓòÉ <hidden> Start FFST/2 ΓòÉΓòÉΓòÉ
  1703.  
  1704. Select the Start FFST/2 icon in the FFST/2 folder to start the FFST/2 process. 
  1705. Add RUN=EPW to CONFIG.SYS file to start this process at system startup. 
  1706.  
  1707.  
  1708. ΓòÉΓòÉΓòÉ <hidden> Stop FFST/2 ΓòÉΓòÉΓòÉ
  1709.  
  1710. Select the Stop FFST/2 icon in the FFST/2 folder to stop the FFST/2 process. 
  1711.  
  1712. Note:  This is not recommended because problem diagnosis information may not be 
  1713. processed.  However, in many cases, Communications Manager will restart FFST/2 
  1714. if a problem occurs. 
  1715.  
  1716.  
  1717. ΓòÉΓòÉΓòÉ <hidden> System Error Log ΓòÉΓòÉΓòÉ
  1718.  
  1719. The system error log is an OS/2 facility that contains information about the 
  1720. problem and the environment in which the problem occurred. Messages logged to 
  1721. the message log formatter often describe how to extract information from the 
  1722. system error log; therefore, always check the message log formatter before 
  1723. checking the system error log. 
  1724.  
  1725. Note:  If you are using OS/2 Version 2.0 or higher, you must install the OS/2 
  1726. Serviceability and Diagnostic Aids to enable Communications Manager system 
  1727. error logging. 
  1728.  
  1729.  
  1730. ΓòÉΓòÉΓòÉ <hidden> Dump Formatter ΓòÉΓòÉΓòÉ
  1731.  
  1732. The dump formatter is a customized dump facility that can contain detailed 
  1733. information about a failure and the environment in which it occurred. 
  1734. Communications Manager uses this facility to supply and format detailed 
  1735. information about alerts. 
  1736.  
  1737.  
  1738. ΓòÉΓòÉΓòÉ <hidden> Problem Determination Aids ΓòÉΓòÉΓòÉ
  1739.  
  1740. Problem Determination Aids is a problem diagnosis facility in Communications 
  1741. Manager that provides trace and dump services. 
  1742.  
  1743. Use trace services to trace application programming interfaces (APIs) and data 
  1744. transmitted on communication links. 
  1745.  
  1746. Use dump services to make copies (or a dump) of the data stored in portions of 
  1747. memory used by Communications Manager for analysis by IBM. 
  1748.  
  1749. Problem Determination Aids is installed as additional function. 
  1750.  
  1751.  
  1752. ΓòÉΓòÉΓòÉ 8. Hints and Tips ΓòÉΓòÉΓòÉ
  1753.  
  1754. You can use these hints and tips when using Communications Manager. Refer also 
  1755. to the README file for more hints and tips. 
  1756.  
  1757. Select one of the following for more information: 
  1758.  
  1759. o Installation 
  1760.  
  1761. o CMSETUP Options 
  1762.  
  1763. o Virtual device driver support 
  1764.  
  1765. o Sample Programs 
  1766.  
  1767. o Configuration 
  1768.  
  1769. o Configuration, Installation, and Distribution (CID) 
  1770.  
  1771. o Gateway and multiple PU support 
  1772.  
  1773. o Command Enhancements 
  1774.  
  1775.  
  1776. ΓòÉΓòÉΓòÉ 8.1. Installation ΓòÉΓòÉΓòÉ
  1777.  
  1778. For additional installation information, read the README file on the 
  1779. installation diskettes (or in the redirected installation directory).  This 
  1780. file contains any last-minute documentation updates. 
  1781.  
  1782. For more hints and tips about installation, select one of the following: 
  1783.  
  1784. o LAPS installation 
  1785.  
  1786. o Upgrade from a previous version 
  1787.  
  1788.  
  1789. ΓòÉΓòÉΓòÉ 8.1.1. LAPS Installation ΓòÉΓòÉΓòÉ
  1790.  
  1791. LAN Adapter and Protocol Support (LAPS) is a component that allows you to 
  1792. configure and make changes to your network adapters and protocols for the 
  1793. purpose of enhancing network performance. 
  1794.  
  1795. Communications Manager installation verifies that LAPS is installed, but it 
  1796. does not verify that LAPS is properly configured. 
  1797.  
  1798. If one of the following products has been installed on your workstation, an 
  1799. acceptable version of LAPS may already be available; however, only NTS/2 
  1800. provides the level of LAPS support necessary for using ISDN. 
  1801.  
  1802. o IBM Extended Services for OS/2 
  1803.  
  1804. o IBM TCP/IP for OS/2 
  1805.  
  1806. o IBM LAN Server (or LAN Requester) 
  1807.  
  1808. o IBM Network Transport Services/2 
  1809.  
  1810.  
  1811. ΓòÉΓòÉΓòÉ 8.1.2. Upgrade from a Previous Version ΓòÉΓòÉΓòÉ
  1812.  
  1813. If you are migrating from a previous version of Communications Manager, and you 
  1814. are planning to install on a different drive: 
  1815.  
  1816. o Remove the previous version using the REINST command. If this is not done, 
  1817.   the files from the previous version remain on the drive although they are not 
  1818.   usable. 
  1819.  
  1820. o Remove any Communications Manager-dependent products such as GDDM-OS/2 Link. 
  1821.   The HGREMOVE command erases the GDDM-OS/2 Link files. 
  1822.  
  1823. o Remove any references to the former product from the LIBPATH, PATH and DPATH 
  1824.   statements in your CONFIG.SYS file. 
  1825.  
  1826. o Back up data files, such as the configuration files. They can be migrated and 
  1827.   used by this release of OS/2 Communications Manager/2. 
  1828.  
  1829. Note:  It is advisable to back up your CONFIG.SYS before modifying it. 
  1830.  
  1831.  
  1832. ΓòÉΓòÉΓòÉ 8.2. CMSETUP Options ΓòÉΓòÉΓòÉ
  1833.  
  1834. CMSETUP and CMREDIR provide the following options from the menu bar. Select any 
  1835. option for additional information. 
  1836.  
  1837. o Install additional functions... 
  1838.  
  1839. o Remove additional features... 
  1840.  
  1841. o Reinstall... 
  1842.  
  1843. o Remove Communications Manager... 
  1844.  
  1845. o Remove communications features... 
  1846.  
  1847. o View system information... 
  1848.  
  1849. o View audit trail... 
  1850.  
  1851. o Recreate folders... 
  1852.  
  1853.  
  1854. ΓòÉΓòÉΓòÉ 8.2.1. Install Additional Functions ΓòÉΓòÉΓòÉ
  1855.  
  1856. Install additional functions... allows you to add a variety of functions and 
  1857. online documents. 
  1858.  
  1859. As you select the items you want to install, the required disk space and the 
  1860. space you have available display in the Install Additional Functions window. 
  1861.  
  1862. For information on these functions, refer to the Installation and Configuration 
  1863. Guide 
  1864.  
  1865.  
  1866. ΓòÉΓòÉΓòÉ 8.2.2. Remove additional functions ΓòÉΓòÉΓòÉ
  1867.  
  1868. Remove additional features... allows you to remove any of the functions or 
  1869. online documents that were previously installed.  You can select the functions 
  1870. or online documents to remove from a displayed list. 
  1871.  
  1872.  
  1873. ΓòÉΓòÉΓòÉ 8.2.3. Reinstall ΓòÉΓòÉΓòÉ
  1874.  
  1875. Reinstall reinstalls the base Communications Manager/2 product and any 
  1876. components necessary for the selected functions.  This option is used when 
  1877. Communications manager files have been erased or damaged. 
  1878.  
  1879.  
  1880. ΓòÉΓòÉΓòÉ 8.2.4. Remove Communications Manager ΓòÉΓòÉΓòÉ
  1881.  
  1882. Remove Communications Manager... removes the product from your workstation. 
  1883. First failure support technology (FFST) and user profile management (UPM) are 
  1884. not removed.  The \CMLIB directory remains on the target drive with any other 
  1885. files that you have added, such as configuration files for the Graphical Data 
  1886. Display Manager-OS2 (GDDM-OS2) Link files. 
  1887.  
  1888. As a final step in the removal process, the \CMLIB\CM.LOG which contains the 
  1889. audit trail is reset to indicate that the product has been removed.  All prior 
  1890. installation history is erased. 
  1891.  
  1892.  
  1893. ΓòÉΓòÉΓòÉ 8.2.5. Remove Communications Features ΓòÉΓòÉΓòÉ
  1894.  
  1895. Remove communications features... removes all files associated with 
  1896. configuration files other than your default configuration.  Features are major 
  1897. components of Communications Manager such as 3270 emulation, 5250 emulation, or 
  1898. the gateway. 
  1899.  
  1900. Choosing this options also allows you to remove any statements in CONFIG.SYS 
  1901. that are specific to removed configurations.  The actual configuration files 
  1902. remain untouched and can be reloaded at any time by selecting Installation in 
  1903. the CM Setup window. 
  1904.  
  1905. Warning: All of the new network graphic images are held in the \CMLIB\*.MET 
  1906. files.  In general, it is not advisable to remove Communications Manager 
  1907. configurations by doing an ERASE\CMLIB\cfgname.* as this could destroy files 
  1908. not related to your configuration.  This is particularly true now as many of 
  1909. the MET files have relatively common names such as 5250X25.MET.  If you happen 
  1910. to have a 5250X25.CFG and you erase it with the above command, then you would 
  1911. lose the 5250 over X.25 image also.  It is safer to use a file utility, such as 
  1912. the OS/2 File Manager, to identify each file to be erased. 
  1913.  
  1914.  
  1915. ΓòÉΓòÉΓòÉ 8.2.6. View System Information ΓòÉΓòÉΓòÉ
  1916.  
  1917. View system information... displays the: 
  1918.  
  1919. o Communications Manager version number 
  1920. o Workstation type 
  1921. o Default configuration 
  1922. o Configuration path 
  1923.  
  1924.  
  1925. ΓòÉΓòÉΓòÉ 8.2.7. View Audit Trail ΓòÉΓòÉΓòÉ
  1926.  
  1927. View audit trail... displays a record of every Communications Manager feature 
  1928. that is installed.  The audit trail is a specific Communications Manager file 
  1929. called \CMLIB\CM.LOG.  Error messages are also logged here during the initial 
  1930. installation steps before FFST/2 is available. 
  1931.  
  1932.  
  1933. ΓòÉΓòÉΓòÉ 8.2.8. Recreate folders ΓòÉΓòÉΓòÉ
  1934.  
  1935. Recreate folders... allows you to recreate a folder and objects in the folder. 
  1936. This is useful if you have accidentally deleted the objects. 
  1937.  
  1938.  
  1939. ΓòÉΓòÉΓòÉ 8.3. Virtual Device Driver Support ΓòÉΓòÉΓòÉ
  1940.  
  1941. When you use OS/2 Version 2.0 and Communications Manager/2, support is 
  1942. available for virtual device drivers.  This allows a DOS program to 
  1943. simultaneously use a device driver with an OS/2 program.  This support is 
  1944. currently available for the following interfaces: 
  1945.  
  1946. o Emulator high level language application programming interface (EHLLAPI) 
  1947.  
  1948. o 802.2 
  1949.  
  1950. o Local area network basic input/output system (NetBIOS) 
  1951.  
  1952. The support for the virtual 802.2 and NetBIOS interfaces is supplied by IBM 
  1953. network transport services/2 (NTS/2). 
  1954.  
  1955. Communications Manager provides the virtual EHLLAPI interface. Installation 
  1956. consists of typing VHAPINST from a windowed or fullscreen OS/2 session. 
  1957.  
  1958.  
  1959. ΓòÉΓòÉΓòÉ 8.4. Sample Programs ΓòÉΓòÉΓòÉ
  1960.  
  1961. The sample programs are provided on the API Support Diskette which is 
  1962. distributed with the Application Programming Guide. This publication is ordered 
  1963. separately. 
  1964.  
  1965. The sample programs are provided as a tool to aid in the development of 
  1966. programs that use Communications Manager application programming interfaces 
  1967. (APIs). 
  1968.  
  1969. The sample programs are installed by decompressing the ZIP files. Refer to the 
  1970. README.DOC file on the API Support Diskette for additional information. 
  1971.  
  1972.  
  1973. ΓòÉΓòÉΓòÉ 8.5. Configuration ΓòÉΓòÉΓòÉ
  1974.  
  1975. There are three methods to create or change a Communications Manager 
  1976. configuration.  For more information on any of these methods, select one of the 
  1977. items below. 
  1978.  
  1979. o Using interactive configuration (CMSETUP) 
  1980. o Using CID Response Files 
  1981. o Editing the .NDF file 
  1982.  
  1983. Note:  IBM Extended Services for OS/2 Programmable Configuration has been 
  1984. replaced by CID. 
  1985.  
  1986. Select an item below for additional configuration information. 
  1987.  
  1988. o Using the configuration program 
  1989. o Verifying configuration files 
  1990. o Copying configuration profiles 
  1991. o Other configuration concerns 
  1992.  
  1993.  
  1994. ΓòÉΓòÉΓòÉ 8.5.1. Gateway and Multiple PU Support ΓòÉΓòÉΓòÉ
  1995.  
  1996. Some benefits of a gateway are: 
  1997.  
  1998. o Reducing the host PU definitions 
  1999.  
  2000. o Eliminating communications links 
  2001.  
  2002. o Reducing the host system load due to less PU polling. 
  2003.  
  2004. o Allowing for protocol conversion between the host and the dependent 
  2005.   workstations 
  2006.  
  2007. Communications Manager/2 has made a number of changes in the gateway support: 
  2008.  
  2009. o Gateway configuration is easier and less error-prone due to the OS/2 
  2010.   Presentation Manager configuration interface (CMSETUP). 
  2011.  
  2012. o Downstream workstations can now be defined using models. 
  2013.  
  2014. o Several host systems can now be defined with multiple PU support. 
  2015.  
  2016. o The SNA gateway supports up to 254 concurrently active workstations (logical 
  2017.   units) per host on the LAN.  Communications Manager/2 supports up to five 
  2018.   concurrent physical host connections. 
  2019.  
  2020. o Host and workstation definitions can now be done directly in the .NDF file. 
  2021.  
  2022. o Host and client workstation definitions can be changed dynamically. 
  2023.  
  2024. For information on gateway restrictions, refer to the Restrictions chapter of 
  2025. this Overview, and the README file. 
  2026.  
  2027. Select one of the following items for additional gateway information. 
  2028.  
  2029. o The CMGWSESS Utility 
  2030. o Suggestions 
  2031.  
  2032.  
  2033. ΓòÉΓòÉΓòÉ 8.5.2. The CMGWSESS Utility ΓòÉΓòÉΓòÉ
  2034.  
  2035. The CMGWSESS utility is available for downstream dependent workstations on a 
  2036. gateway.  CMGWSESS is executed on the dependent workstation and it displays 
  2037. information concerning all sessions with the gateway node. 
  2038.  
  2039. All of the information returned by CMGWSESS is available on the gateway 
  2040. machine.  It could be useful for the user on the dependent workstation, 
  2041. however, if the gateway machine is not physically accessible.  It allows the 
  2042. user to get information concerning the LUs and host system which might be 
  2043. helpful to identify network problems. 
  2044.  
  2045. CMGWSESS relies upon the ability to initiate an LU6.2 conversation with the 
  2046. (Remote Display Server) program on the gateway machine. The LU6.2 sessions in 
  2047. fact show up in the data produced by CMGWSESS.  This implies that the gateway 
  2048. machine must be appropriately customized for accepting an APPC conversation. 
  2049.  
  2050.  
  2051. ΓòÉΓòÉΓòÉ 8.5.3. Suggestions ΓòÉΓòÉΓòÉ
  2052.  
  2053. Gateway host LU pool selection 
  2054.  
  2055. You assign a name when you create a new pool.  It is advisable to include an 
  2056. indication of the host name within the eight character pool identification. 
  2057. This is recommended because of the gateway session information displayed within 
  2058. the subsystem management application. 
  2059.  
  2060.  
  2061. ΓòÉΓòÉΓòÉ 8.5.4. Using Interactive Configuration (CMSETUP) ΓòÉΓòÉΓòÉ
  2062.  
  2063. You can create or change a Communications Manager configuration using 
  2064. interactive configuration, which is the CMSETUP command.  Information is 
  2065. entered using a series of Presentation Manager windows.  When you complete a 
  2066. configuration, an automatic verification step examines the configuration files 
  2067. you created and if no conflicts exist, creates the required configuration 
  2068. files.  If there are conflicts, errors are saved in a log file.  You can then 
  2069. choose to correct the errors in the configuration. 
  2070.  
  2071. Most workstation configuration can be created using CMSETUP; however, a few 
  2072. verbs and some parameters of other verbs are not supported by CMSETUP.  Refer 
  2073. to Planning and Administration for Networks for a list of these verbs and 
  2074. parameters. 
  2075.  
  2076.  
  2077. ΓòÉΓòÉΓòÉ 8.5.5. Using CID Response Files ΓòÉΓòÉΓòÉ
  2078.  
  2079. You can create or change a Communications Manager configuration using the 
  2080. Configuration, Installation, and Distribution (CID) response files. You can use 
  2081. the response files to configure almost all of the Communications Manager 
  2082. configuration parameters.  The CMRECORD utility creates a response file from a 
  2083. configuration.  The model configuration can be a configuration that you want to 
  2084. upgrade or a configuration that was created with CMSETUP.  You can 
  2085. automatically create a configuration on a workstation with CMSETUP using the 
  2086. response files. 
  2087.  
  2088. Creating configurations with CID is generally the responsibility of the network 
  2089. administrator. 
  2090.  
  2091.  
  2092. ΓòÉΓòÉΓòÉ 8.5.6. Editing the .NDF File ΓòÉΓòÉΓòÉ
  2093.  
  2094. The node definitions file (.NDF) allows you to change your node configuration 
  2095. using an ASCII text editor.    This is useful when you want to: 
  2096.  
  2097. o Make a quick change to a verb parameter 
  2098.  
  2099. o Duplicate an .NDF file quickly 
  2100.  
  2101. o View the configuration verbs 
  2102.  
  2103. o Specify configuration verbs and parameters not supported by CMSETUP 
  2104.  
  2105.   Note:  Only experienced Communications Manager users should modify the .NDF 
  2106.   file. 
  2107.  
  2108.  
  2109. ΓòÉΓòÉΓòÉ 8.5.7. Using the Configuration Program ΓòÉΓòÉΓòÉ
  2110.  
  2111. There are three ways to use the Communications Manager configuration windows. 
  2112. Select one of the following items for more information about using these 
  2113. windows. 
  2114.  
  2115. o Default configuration 
  2116. o Advanced configuration 
  2117. o Communications Manager configuration list 
  2118.  
  2119.  
  2120. ΓòÉΓòÉΓòÉ 8.5.8. Default Configuration ΓòÉΓòÉΓòÉ
  2121.  
  2122. Default configuration is limited to configuring the following frequently-used 
  2123. scenarios: 
  2124.  
  2125. o 3270 emulation with LAN, SDLC or coaxial connection 
  2126. o 5250 emulation with LAN, SDLC or twinaxial connection 
  2127.  
  2128. When you use default configuration, you are required to enter the minimum 
  2129. number of parameters in each window; Communications Manager supplies defaults 
  2130. for all other values. 
  2131.  
  2132.  
  2133. ΓòÉΓòÉΓòÉ 8.5.9. Advanced Configuration ΓòÉΓòÉΓòÉ
  2134.  
  2135. Advanced configuration allows you to configure using all of the Communications 
  2136. Manager configuration windows.  If you use advanced configuration, you will 
  2137. have access to virtually all of the Communications Manager configuration 
  2138. parameters. 
  2139.  
  2140.  
  2141. ΓòÉΓòÉΓòÉ 8.5.10. Communications Manager Configuration List ΓòÉΓòÉΓòÉ
  2142.  
  2143. The Communications Manager configuration list is a list of all Communications 
  2144. Manager profiles and features.  If you are familiar with the configuration 
  2145. process, you can use this list to save time; however, Communications Manager 
  2146. does not direct you to the menus that are necessary for your particular 
  2147. scenario. 
  2148.  
  2149.  
  2150. ΓòÉΓòÉΓòÉ 8.5.11. Verifying Configuration Files ΓòÉΓòÉΓòÉ
  2151.  
  2152. When you close the Configuration Definition window, a configuration 
  2153. verification is performed.  The Options choice on the menu bar provides an 
  2154. option to turn automatic verification off; however, if the configuration is not 
  2155. verified, Communications Manager will not be able to use it at a later time. 
  2156.  
  2157. Bypassing automatic verification could be useful if, for example, you find that 
  2158. you do not have all of the necessary information to configure all the required 
  2159. profiles at that time.  When the information is available, you can restart the 
  2160. configuration program, make the appropriate modifications, and then perform the 
  2161. verification. 
  2162.  
  2163.  
  2164. ΓòÉΓòÉΓòÉ 8.5.12. Copying Configuration Profiles ΓòÉΓòÉΓòÉ
  2165.  
  2166. Communications Manager/2 does not provide a facility to copy profiles 
  2167. selectively from one configuration to another. Instead, you can generate CID 
  2168. response files and combine their feature definitions. 
  2169.  
  2170.  
  2171. ΓòÉΓòÉΓòÉ 8.5.13. Other Configuration Concerns ΓòÉΓòÉΓòÉ
  2172.  
  2173. Be careful when specifying the LU local/NAU address for terminal emulators. 
  2174. Communications Manager in Extended Services and Extended Edition ensured a 
  2175. unique address for this field; this is no longer the case because of enhanced 
  2176. multiple PU support. 
  2177.  
  2178. Because you can now have multiple host links, you can also have multiples of 
  2179. the same NAU address.  Communications Manager does not reject multiples of the 
  2180. same NAU address, even for the same host link, and only one emulator session 
  2181. can be active for one NAU address for any host. 
  2182.  
  2183.  
  2184. ΓòÉΓòÉΓòÉ 8.6. Configuration, Installation, and Distribution (CID) ΓòÉΓòÉΓòÉ
  2185.  
  2186. Configuration, Installation, and Distribution (CID) allows several forms of 
  2187. user involvement in the CID process.  They are: 
  2188.  
  2189. Attended installation 
  2190.    Someone with product knowledge is present and can respond to various prompts 
  2191.    during installation and configuration. 
  2192.  
  2193. Lightly attended installation 
  2194.    Someone is present, but is only required to start the installation, insert 
  2195.    diskettes, and respond to simple prompts. 
  2196.  
  2197. Unattended installation 
  2198.    No user involvement is required. 
  2199. For more information on CID, refer to the Response File Reference online 
  2200. document. 
  2201.  
  2202. Select an item below for more CID information. 
  2203.  
  2204. o Model configuration 
  2205. o User response files 
  2206. o Functions not provided by CID 
  2207. o General comments 
  2208.  
  2209.  
  2210. ΓòÉΓòÉΓòÉ 8.6.1. Model Configuration ΓòÉΓòÉΓòÉ
  2211.  
  2212. To create a Communications Manager model configuration on the server, do one of 
  2213. the following: 
  2214.  
  2215. o Copy a configuration from one of the client workstations 
  2216.  
  2217. o Create a new configuration on the server 
  2218.  
  2219. If you are creating the configuration on the server, then proceed with 
  2220. configuration of a 3270 emulation session over a token ring network.  Use 
  2221. exactly the same setups as if you were on the client workstation, except for 
  2222. the following: 
  2223.  
  2224. o Select a suitable name for the configuration; for example: 
  2225.  
  2226.           MYMODEL or MOD3270
  2227.  
  2228. o When prompted by CMSETUP with the pop-up window, "Will this configuration be 
  2229.   used for this workstation (ACS2110), select NO.  This causes CMSETUP to skip 
  2230.   the steps related to installing components, using this configuration, on the 
  2231.   server. 
  2232.  
  2233. o During the configuration, when you are required to provide values such as 
  2234.   LOCAL_CP_NAME, enter the values for one. 
  2235.  
  2236.  
  2237. ΓòÉΓòÉΓòÉ 8.6.2. User Response Files ΓòÉΓòÉΓòÉ
  2238.  
  2239. The following methods can be used to create user response files: 
  2240.  
  2241. o Edit the sample new installation response file provided with Communications 
  2242.   Manager.  You can find this sample on the Network Administrator Sample 
  2243.   Program Diskette. 
  2244.  
  2245. o Use the Communications Manager CMRECORD function to convert a configuration 
  2246.   into a response file, then edit the result to customize the file. 
  2247.  
  2248. o Use an editor to create a response file from scratch. This is not 
  2249.   recommended, as the other options create files with records in the correct 
  2250.   syntax, which saves time and increases the probability of the file being 
  2251.   error free. 
  2252.  
  2253.  
  2254. ΓòÉΓòÉΓòÉ 8.6.3. General Comments ΓòÉΓòÉΓòÉ
  2255.  
  2256. Use of a model configuration versus response file only 
  2257.  
  2258. Network Administrators can provide almost all configuration information in 
  2259. either a response file, a configuration file set or a mixture of both. 
  2260.  
  2261. For example, a network administrator may wish to consider using only response 
  2262. files to define configuration information.  This is possible except for the 
  2263. following function, which cannot be specified in a response file: 
  2264.  
  2265. o Keyboard remapping 
  2266.  
  2267. Note:  The Keyboard remapping must be configured on an individual workstation 
  2268. by copying onto the workstation the appropriate configuration files. 
  2269.  
  2270. o Creating keyboard definitions in a response file requires care. 
  2271.  
  2272.   A keyboard record in a configuration file is not directly linked to a COUNTRY 
  2273.   profile.  Therefore, CMRECORD cannot automatically create correct values for 
  2274.   the AT_KEYBOARD and ENHANCED_KEYBOARD records. 
  2275.  
  2276.   To overcome this, CMRECORD outputs the keyboard records without any COUNTRY 
  2277.   fields.  The response file processor (CMSETUP /R) considers COUNTRY to be an 
  2278.   optional field. When CMSETUP /R is processing a response file, if the COUNTRY 
  2279.   field is not specified, CMSETUP /R will examine the NAME filed and take the 
  2280.   following action: 
  2281.  
  2282.    - If the NAME is a known name, for example ACSCENUS, then Communications 
  2283.      Manager will use the appropriate model keyboard. 
  2284.  
  2285.    - If the NAME is a user-defined name (for example, MYKEYBD), then 
  2286.      Communications Manager will determine what keyboard is defined to OS/2 via 
  2287.      CONFIG.SYS and use the appropriate country's model keyboard to create the 
  2288.      keyboard record. 
  2289.  
  2290.  
  2291. ΓòÉΓòÉΓòÉ 8.6.4. Functions not provided by CID ΓòÉΓòÉΓòÉ
  2292.  
  2293. The following functions are not provided by CID: 
  2294.  
  2295. o Keywords which install by feature, without configuration 
  2296.  
  2297.   It is not possible to specify just a record keyboard in a response file, with 
  2298.   no field values and have the CID process install that feature.  At a minimum, 
  2299.   a NAME field keyword must be specified on any record keyword 
  2300.  
  2301. o Keywords to add, remove or change keylock passwords 
  2302.  
  2303.   Keylock password is provided on the CMSETUP /R command via the /KL parameter 
  2304.  
  2305. o Updating multiple configurations in a single job 
  2306.  
  2307.   Only one configuration can be updated per CID installation. Multiple CID 
  2308.   installations with CMUPDATETYPE=4 (no installation) can be used to update 
  2309.   multiple configurations on a workstation 
  2310.  
  2311.  
  2312. ΓòÉΓòÉΓòÉ 8.7. Command Enhancements ΓòÉΓòÉΓòÉ
  2313.  
  2314. Several commands are available from an OS/2 window or full screen session.  In 
  2315. general, you do not need to use line commands for Communications Manager. 
  2316. Virtually all of the Communications Manager functions are now accessible from 
  2317. OS/2 Presentation Manager windows.  There are times, however, when it can be 
  2318. useful to perform a function under program control. 
  2319.  
  2320. For more information, refer to the Command Reference. 
  2321.  
  2322.  
  2323. ΓòÉΓòÉΓòÉ 9. Productivity Aids (Applets) ΓòÉΓòÉΓòÉ
  2324.  
  2325. A variety of productivity aids are included with Communications Manager. You 
  2326. should be aware, however, that these programs are not a formal part of 
  2327. Communications Manager and are not supported by IBM. 
  2328.  
  2329. A complete list of these productivity aids is contained on disk 1 of the 
  2330. Productivity Aids diskettes.  For information on accessing these productivity 
  2331. aids, refer to the online README file. 
  2332.  
  2333.  
  2334. ΓòÉΓòÉΓòÉ 10. Restrictions ΓòÉΓòÉΓòÉ
  2335.  
  2336. The following restrictions apply to this release of Communications Manager. 
  2337. Refer to the README file for the latest updates. 
  2338.  
  2339. Gateway Restrictions 
  2340.  
  2341. o Single focal point 
  2342.  
  2343.   Although Communications Manager can maintain multiple SSCP-PU sessions, only 
  2344.   one host system can be used as an active focal point for sending alerts.    This 
  2345.   link is specified with the HOST_FP_LINK_NAME parameter of the DEFINE_LOCAL_CP 
  2346.   record in the .NDF file.  The link for the focal point must be using the 
  2347.   implicit PU with the same name as the local CP. 
  2348.  
  2349. o Single host entry point 
  2350.  
  2351.   A Communications Manager node only accepts network management requests 
  2352.   (NMVTs) from a PU 2 host that are addressed to the PU with the same name as 
  2353.   the CP. 
  2354.  
  2355. o One PU per host/adapter/address 
  2356.  
  2357.   The Communications Manager node can only have one link to another partner 
  2358.   over a given source adapter/target address pair.  The only way to define an 
  2359.   additional PU is to define an additional link.  Therefore, it is not possible 
  2360.   to have multiple PUs to the same host unless a different local adapter or 
  2361.   remote address is specified. 
  2362.  
  2363.   Note:  In addition to the obvious solution of using multiple adapters, 
  2364.   another possibility is to define a different target SAP address.  VTAM allows 
  2365.   you to specify a source SAPADDR parameter on the PU definition if you are 
  2366.   connected by an ICA.  For Communications Manager, the target SAP can also be 
  2367.   specified on the DESTINATION_ADDRESS parameter of the DEFINE_LOGICAL_LINK 
  2368.   command: 
  2369.  
  2370.     DESTINATION-ADDRESS(X'40000003330208)
  2371.  
  2372.   Specifying the SAP is not permitted within the Communications Manager 
  2373.   configuration menus, nor can it be specified in any manner for the 
  2374.   Communications Manager local address.  The local SAP address is always 04. 
  2375.  
  2376.  
  2377. ΓòÉΓòÉΓòÉ 11. Bibliography ΓòÉΓòÉΓòÉ
  2378.  
  2379. The bibliography for Communications Manager/2 describes both online and printed 
  2380. sources of information that can be useful when planning for or using 
  2381. Communications Manager. 
  2382.  
  2383. o Communications Manager/2 Basic User Books 
  2384.  
  2385. o Communications Manager/2 Advanced User Books 
  2386.  
  2387. o Communications Manager/2 Programming Books 
  2388.  
  2389. o Related Local Area Network Publications 
  2390.  
  2391. o Related Base Operating System Publications 
  2392.  
  2393. o Related IBM AS/400 Host Publications 
  2394.  
  2395. o Related 3270 Host Communications Publications 
  2396.  
  2397. o Related Realtime Interface Co-Processor Publications 
  2398.  
  2399. o Related X.25 Packet-Switching Data Networks Publications 
  2400.  
  2401. o Systems Application Architecture (SAA) Publications 
  2402.  
  2403. o General Information 
  2404.  
  2405.  
  2406. ΓòÉΓòÉΓòÉ 11.1. Communications Manager/2 Basic User Books ΓòÉΓòÉΓòÉ
  2407.  
  2408. The following list encompasses all the basic user books in the Communications 
  2409. Manager library.  The words "IBM Communications Manager/2" are actually part of 
  2410. the title of each book; however, in this list, those words are omitted. 
  2411.  
  2412. The following books provide the basic information you need to get your system 
  2413. installed and operational: 
  2414.  
  2415. o Quick Installation, SX75-0085-01 
  2416.  
  2417. o Installation and Configuration Guide, SC31-7169-00 
  2418.  
  2419. o Host Print Guide, SC31-7145 
  2420.  
  2421. o User's Desk Reference, SC31-7103 
  2422.  
  2423. o Command Reference (online) 
  2424.  
  2425. o Glossary (online) 
  2426.  
  2427. o Overview (online) 
  2428.  
  2429.  
  2430. ΓòÉΓòÉΓòÉ 11.2. Communications Manager/2 Advanced User Books ΓòÉΓòÉΓòÉ
  2431.  
  2432. The following list encompasses all the advanced user books in the 
  2433. Communications Manager library.  The words "IBM Communications Manager/2" are 
  2434. actually part of the title of each book; however, in this list, those words are 
  2435. omitted. 
  2436.  
  2437. The following books provide advanced planning and installation information for 
  2438. Communications Manager: 
  2439.  
  2440. o Planning and Administration for Networks,               k. SC31-7144 
  2441.  
  2442. o Scenarios, SC31-6174-01 
  2443.  
  2444. o Host Connection Reference, SC31-6170-01 
  2445.  
  2446. o Service Point Application Router and Remote Operations Service Guide, 
  2447.   SC31-7006 
  2448.  
  2449. o Message Reference, SC31-6159 
  2450.  
  2451. o Problem Determination Guide (online) 
  2452.  
  2453.  
  2454. ΓòÉΓòÉΓòÉ 11.3. Communications Manager/2 Programming Books ΓòÉΓòÉΓòÉ
  2455.  
  2456. The following list encompasses all the programming books in the Communications 
  2457. Manager library.  The words "IBM Communications Manager/2" are actually part of 
  2458. the title of each book; however, in this list, those words are omitted. 
  2459.  
  2460. The following books provide Communications Manager application programming 
  2461. interface (API) programming information for creating and maintaining 
  2462. Communications Manager programs: 
  2463.  
  2464. o Application Programming Guide, SC31-7012 
  2465.  
  2466. o ACDI Programming Reference, SC31-6161 
  2467.  
  2468. o APPC Programming Guide and Reference, SC31-6160 
  2469.  
  2470. o Conventional LU Application Programming Reference, SC31-6166 
  2471.  
  2472. o ECF Server-Requester Programming Interface (SRPI) Reference, SC31-6165 
  2473.  
  2474. o EHLLAPI Programming Reference, SC31-6163 
  2475.  
  2476. o ISDN Connection Management Interface (CMI) Programming Reference, SC31-7010 
  2477.  
  2478. o ISDN Port Connection Manager (PCM) Programming Reference, SC31-7011 
  2479.  
  2480. o Realtime Interface Co-Processor Device Driver Programming Reference, 
  2481.   SC31-6164 
  2482.  
  2483. o System Management Programming Reference, SC31-6173 
  2484.  
  2485. o X.25 Programming Reference, SC31-6167 
  2486.  
  2487.  
  2488. ΓòÉΓòÉΓòÉ <hidden> Quick Installation, SX75-0085-01 ΓòÉΓòÉΓòÉ
  2489.  
  2490. Quick Installation, SX75-0085-01 
  2491.  
  2492. This card provides you with a very brief set of instructions on how to start 
  2493. the installation of Communications Manager.  It is intended primarily for those 
  2494. who want to accept most or all of the preselected choices during installation. 
  2495. Quick Installation provides only limited instructions to get you started.  If 
  2496. you want more detailed information about installing Communications Manager, 
  2497. refer to Workstation Installation Guide. 
  2498.  
  2499.  
  2500. ΓòÉΓòÉΓòÉ <hidden> User's Desk Reference, SC31-7068 ΓòÉΓòÉΓòÉ
  2501.  
  2502. User's Desk Reference, SC31-7068 
  2503.  
  2504. This book provides information necessary to accomplish basic communication 
  2505. tasks using Communications Manager. For example, this volume contains 
  2506. information and procedures for starting and stopping Communications Manager, 
  2507. using the clipboard to mark and copy data from one application to another, 
  2508. using 3270 and 5250 emulation, transferring files, and printing files, In 
  2509. addition, this book explains how to use keyboard remap for changing the 
  2510. functions of the keys on your terminal emulation keyboard.  It also explains 
  2511. how to use messages and the message log. 
  2512.  
  2513.  
  2514. ΓòÉΓòÉΓòÉ <hidden> Host Print Guide, SC31-7145 ΓòÉΓòÉΓòÉ
  2515.  
  2516. Host Print Guide, SC31-7145 
  2517.  
  2518. This book describes how to use the functions in Communications Manager 3270 
  2519. Host Print and AS/400 printing.  It includes descriptions of configuring 
  2520. printing, meeting special printing needs, and solving problems for both AS/400 
  2521. and 3270 printing with Communications Manager. 
  2522.  
  2523.  
  2524. ΓòÉΓòÉΓòÉ <hidden> Problem Determination Guide ΓòÉΓòÉΓòÉ
  2525.  
  2526. Problem Determination Guide 
  2527.  
  2528. This book provides online documentation for problem determination procedures 
  2529. using FFST/2, trace and dump services, diagnostic tools, sense data, and OS/2 
  2530. request codes. 
  2531.  
  2532.  
  2533. ΓòÉΓòÉΓòÉ <hidden> Command Reference ΓòÉΓòÉΓòÉ
  2534.  
  2535. Command Reference 
  2536.  
  2537. This online document lists the Communications Manager commands and their syntax 
  2538. diagrams. 
  2539.  
  2540.  
  2541. ΓòÉΓòÉΓòÉ <hidden> Glossary ΓòÉΓòÉΓòÉ
  2542.  
  2543. Glossary 
  2544.  
  2545. This book defines technical terms and acronyms that are used throughout the 
  2546. Communications Manager program and publications. 
  2547.  
  2548.  
  2549. ΓòÉΓòÉΓòÉ <hidden> Overview ΓòÉΓòÉΓòÉ
  2550.  
  2551. Overview 
  2552.  
  2553. This online document describes Communications Manager features and functions, 
  2554. along with useful tips for installing and using the program and its interface. 
  2555.  
  2556.  
  2557. ΓòÉΓòÉΓòÉ <hidden> Planning and Administration for Networks,              SC31-6168 ΓòÉΓòÉΓòÉ
  2558.  
  2559. SC31-7144 
  2560.  
  2561. Planning and Administration for Networks, SC31-7144 
  2562.  
  2563. This book defines concepts and planning procedures for configuration, 
  2564. installation, and OS/2 networking considerations. 
  2565.  
  2566.  
  2567. ΓòÉΓòÉΓòÉ <hidden> Scenarios, SC31-6174-01 ΓòÉΓòÉΓòÉ
  2568.  
  2569. Scenarios, SC31-6174-01 
  2570.  
  2571. This book contains sample scenarios with steps to install and configure several 
  2572. different kinds of networks with attached workstations. 
  2573.  
  2574.  
  2575. ΓòÉΓòÉΓòÉ <hidden> Installation and Configuration Guide, ΓòÉΓòÉΓòÉ
  2576.  
  2577. SC31-7169 
  2578.  
  2579. Installation and Configuration Guide, SC31-7169 
  2580.  
  2581. This book describes how to configure Communications Manager for various 
  2582. connections and features.  It provides stes and basic information to install 
  2583. Communications Manager.  It also describes advanced user tasks, such as how to 
  2584. prepare a response file and use the keylock function to protect configuration 
  2585. files. 
  2586.  
  2587.  
  2588. ΓòÉΓòÉΓòÉ <hidden> Host Connection Reference, SC31-6170-01 ΓòÉΓòÉΓòÉ
  2589.  
  2590. Host Connection Reference, SC31-6170-01 
  2591.  
  2592. This book contains parameter matching and sample system generations for OS/2 
  2593. connections to System/370* (S/370) and Application System/400* (AS/400*) hosts. 
  2594.  
  2595. * Trademark of IBM 
  2596.  
  2597.  
  2598. ΓòÉΓòÉΓòÉ <hidden> Service Point Application Router and Remote Operations Service Guide, SC31-7006 ΓòÉΓòÉΓòÉ
  2599.  
  2600. Service Point Application Router and Remote Operations Service Guide, SC31-7006 
  2601.  
  2602. This book contains guidance and reference information for using two 
  2603. Communications Manager functions, Service Point Application Router and Remote 
  2604. Operations Service, to handle network management commands directed to a 
  2605. workstation by a NetView operator or application program. 
  2606.  
  2607.  
  2608. ΓòÉΓòÉΓòÉ <hidden> Message Reference, SC31-6159 ΓòÉΓòÉΓòÉ
  2609.  
  2610. Message Reference, SC31-6159 
  2611.  
  2612. This book contains the text, explanations, and suggested actions for all 
  2613. Communications Manager messages.  This document is also available online. 
  2614.  
  2615.  
  2616. ΓòÉΓòÉΓòÉ <hidden> Application Programming Guide, SC31-7012 ΓòÉΓòÉΓòÉ
  2617.  
  2618. Application Programming Guide, SC31-7012 
  2619.  
  2620. This book describes application program development for Communications Manager. 
  2621. It is the starting point for writing application programs that use any of the 
  2622. Communications Manager application programming interfaces (APIs) and contains 
  2623. information common to all of the APIs. The Communications Manager/2 Sample 
  2624. Programs diskette, which contains sample programs, API data structures, and 
  2625. header files, is provided with this book. 
  2626.  
  2627.  
  2628. ΓòÉΓòÉΓòÉ <hidden> ACDI Programming Reference, SC31-6161 ΓòÉΓòÉΓòÉ
  2629.  
  2630. ACDI Programming Reference, SC31-6161 
  2631.  
  2632. This book introduces and defines the procedures for using the Asynchronous 
  2633. Communications Device Interface (ACDI). This book serves as a reference for 
  2634. programmers who want to use the asynchronous programming functions to create 
  2635. their own application programs using C and Macro Assembler languages. 
  2636.  
  2637.  
  2638. ΓòÉΓòÉΓòÉ <hidden> APPC Programming Guide and Reference, SC31-6160 ΓòÉΓòÉΓòÉ
  2639.  
  2640. APPC Programming Guide and Reference, SC31-6160 
  2641.  
  2642. This book provides information necessary to create application programs in the 
  2643. C, COBOL, or Macro Assembler programming languages that use the advanced 
  2644. program-to-program communications (APPC) programming interface functions. 
  2645.  
  2646.  
  2647. ΓòÉΓòÉΓòÉ <hidden> Conventional LU Application Programming Reference, SC31-6166 ΓòÉΓòÉΓòÉ
  2648.  
  2649. Conventional LU Application Programming Reference, SC31-6166 
  2650.  
  2651. This book provides information necessary to create application programs in the 
  2652. C, COBOL, or Macro Assembler programming languages that use the IBM OS/2 
  2653. Conventional LU Application (LUA) programming interface. 
  2654.  
  2655.  
  2656. ΓòÉΓòÉΓòÉ <hidden> ECF Server-Requester Programming Interface (SRPI) Reference, SC31-6165 ΓòÉΓòÉΓòÉ
  2657.  
  2658. ECF Server-Requester Programming Interface (SRPI) Reference, SC31-6165 
  2659.  
  2660. This book provides programmers with the information necessary to create 
  2661. requester application programs that use the Server-Requester Programming 
  2662. Interface (SRPI) functions in Communications Manager. 
  2663.  
  2664.  
  2665. ΓòÉΓòÉΓòÉ <hidden> EHLLAPI Programming Reference, SC31-6163 ΓòÉΓòÉΓòÉ
  2666.  
  2667. EHLLAPI Programming Reference, SC31-6163 
  2668.  
  2669. This book defines the Emulator High-Level Language Application Programming 
  2670. Interface (EHLLAPI). Applications written to this programming interface can 
  2671. access and control the 3270 and 5250 host presentation spaces. 
  2672.  
  2673.  
  2674. ΓòÉΓòÉΓòÉ <hidden> ISDN Connection Management Interface (CMI) Programming Reference, SC31-7010 ΓòÉΓòÉΓòÉ
  2675.  
  2676. ISDN Connection Management Interface (CMI) Programming Reference, SC31-7010 
  2677.  
  2678. This book describes how to use the integrated services digital network (ISDN) 
  2679. connection manager interface (CMI) to make a connection for user applications 
  2680. through a switched network. 
  2681.  
  2682.  
  2683. ΓòÉΓòÉΓòÉ <hidden> ISDN Port Connection Manager (PCM) Programming Reference, SC31-7011 ΓòÉΓòÉΓòÉ
  2684.  
  2685. ISDN Port Connection Manager (PCM) Programming Reference, SC31-7011 
  2686.  
  2687. This book describes how to develop and implement a call control module (a port 
  2688. connection manager) for use in Communications Manager's switched network 
  2689. environment. 
  2690.  
  2691.  
  2692. ΓòÉΓòÉΓòÉ <hidden> Realtime Interface Co-Processor Device Driver Programming Reference, SC31-6164 ΓòÉΓòÉΓòÉ
  2693.  
  2694. Realtime Interface Co-Processor Device Driver Programming Reference, SC31-6164 
  2695.  
  2696. This book provides information for writing programs that support the Realtime 
  2697. Interface Co-Processor adapters. The dynamic link libraries, the application 
  2698. loader, and the device driver interface are discussed. 
  2699.  
  2700.  
  2701. ΓòÉΓòÉΓòÉ <hidden> System Management Programming Reference, SC31-6173 ΓòÉΓòÉΓòÉ
  2702.  
  2703. System Management Programming Reference, SC31-6173 
  2704.  
  2705. This book provides detailed descriptions of the Advanced Peer-to-Peer 
  2706. Networking (APPN)* configuration and subsystem management verbs.  These verbs 
  2707. allow configuration and management of APPN nodes. 
  2708.  
  2709. * Trademark of IBM 
  2710.  
  2711.  
  2712. ΓòÉΓòÉΓòÉ <hidden> X.25 Programming Reference, SC31-6167 ΓòÉΓòÉΓòÉ
  2713.  
  2714. X.25 Programming Reference, SC31-6167 
  2715.  
  2716. This book provides the information necessary to create application programs in 
  2717. the C, COBOL, or Macro Assembler programming languages that use the X.25 API. 
  2718.  
  2719.  
  2720. ΓòÉΓòÉΓòÉ 11.4. Related Local Area Network Publications ΓòÉΓòÉΓòÉ
  2721.  
  2722. The following LAN publications can aid administrators in installing, 
  2723. configuring, and using LAN servers, requesters, and hardware: 
  2724.  
  2725. o IBM Local Area Network Technical Reference (25F7688, SC30-3383-03) provides 
  2726.   information for using IBM LAN adapters and software interfaces in IBM 
  2727.   Personal System/2* (PS/2*) and IBM Personal Computer AT* workstations. It is 
  2728.   intended for programmers who plan to use IBM LANs and for those who need 
  2729.   information about the correct adapters required for setting up an IBM LAN. 
  2730.  
  2731. o IBM LAN Asynchronous Connection Server Function and Connectivity Guidelines 
  2732.   (GA27-3917) provides guidelines for configuring a LAN asynchronous connection 
  2733.   server. 
  2734.  
  2735. o IBM Local Area Network Asynchronous Connection Server (SC30-3509-01) provides 
  2736.   information for network administrators who are planning and installing a LAN 
  2737.   asynchronous connection server. This book is provided with the LAN 
  2738.   asynchronous connection server product and cannot be purchased separately. 
  2739.  
  2740. o The LAN Server Version 2.0 product is described in the IBM Operating System/2 
  2741.   Local Area Network Server Version 2.0 Network Administrator Reference: 
  2742.  
  2743.    - Volume 1:  Planning and Installation (04G1032) 
  2744.    - Volume 2:  Performance Tuning (04G1033) 
  2745.    - Volume 3:  Network Administrator Tasks (04G1034) 
  2746.  
  2747. o IBM Token-Ring Network Introduction and Planning Guide (GA27-3677-03). 
  2748.  
  2749. o IBM Token-Ring Network Problem Determination Guide (SX27-3710-04). 
  2750.  
  2751. o IBM PC Network Hardware Maintenance and Service Manual (S68X-2240-03). 
  2752.  
  2753. o IBM 3174 Establishment Controller Peer Communication User's Guide 
  2754.   (GA27-3887-02). 
  2755.  
  2756. o IBM NETBIOS Application Development Guide (S68X-2270). 
  2757.  
  2758. o IEEE 802.2 Local Area Networks Standard, 802.2 Logical Link Control, 
  2759.   ANSI/IEEE Standard, October, 1985. 
  2760.  
  2761. o IEEE 802.2 Local Area Networks Standard, 802.3 Carrier Sense Multiple Access, 
  2762.   ANSI/IEEE Standard, October, 1985. 
  2763.  
  2764. o Microsoft/3Com LAN Manager Network Driver Interface Specification, Version 
  2765.   2.01, Microsoft Corporation, 3Com Corporation. 
  2766.  
  2767. o The Ethernet:  A Local Area Network, Data Link Layer and Physical Layer 
  2768.   Specifications, Digital, Intel, XEROX, Version 2.0, November 1982, Digital 
  2769.   Equipment Corporation, Intel Corporation, Xerox Corporation. 
  2770.  
  2771. * Trademark of IBM 
  2772.  
  2773.  
  2774. ΓòÉΓòÉΓòÉ 11.5. Related Base Operating System Publications ΓòÉΓòÉΓòÉ
  2775.  
  2776. If your operating system is OS/2, you can use the publications in the following 
  2777. sections. If your operating system is manufactured by someone other than IBM, 
  2778. you can use the documentation supplied with your base operating system. 
  2779.  
  2780. o OS/2 2.0 Publications 
  2781.  
  2782. o Other OS/2 Publications 
  2783.  
  2784. o Procedures Language 2/REXX Publications 
  2785.  
  2786. o General Information 
  2787.  
  2788.  
  2789. ΓòÉΓòÉΓòÉ <hidden> OS/2 2.0 Publications ΓòÉΓòÉΓòÉ
  2790.  
  2791. If your operating system is IBM OS/2 2.0, you can use the following related 
  2792. publications: 
  2793.  
  2794. o IBM OS/2 Technical Library (10G3356) 
  2795.  
  2796. o IBM OS/2 2.0 Command Reference (S10G-6313) 
  2797.  
  2798. o IBM Application Design Guide (10G6260) 
  2799.  
  2800. o IBM Programming Guide, Volume 1 (10G6261) 
  2801.  
  2802. o IBM Programming Guide, Volume 2 (10G6494) 
  2803.  
  2804. o IBM Programming Guide, Volume 3 (10G6495) 
  2805.  
  2806. o IBM Control Program Programming Reference (10G6263) 
  2807.  
  2808. o IBM Presentation Manager Programming Reference, Volume 1 (10G6264) 
  2809.  
  2810. o IBM Presentation Manager Programming Reference, Volume 2 (10G6265) 
  2811.  
  2812. o IBM Presentation Manager Programming Reference, Volume 3 (10G6272) 
  2813.  
  2814. o IBM Information Presentation Facility Guide and Reference (10G6262) 
  2815.  
  2816. o IBM System Object Model Guide and Reference (10G6309) 
  2817.  
  2818. o IBM Physical Device Driver Reference (10G6266) 
  2819.  
  2820. o IBM Virtual Device Driver Reference (10G6310) 
  2821.  
  2822. o IBM Presentation Driver Reference (10G6267) 
  2823.  
  2824.  
  2825. ΓòÉΓòÉΓòÉ <hidden> Other OS/2 Publications ΓòÉΓòÉΓòÉ
  2826.  
  2827. If your operating system is IBM OS/2 Version 1.30.2, you can use the following 
  2828. related publications: 
  2829.  
  2830. o IBM Operating System/2 Standard Edition Getting Started 
  2831.  
  2832. o IBM Operating System/2 Standard Edition Using Advanced Features 
  2833.  
  2834. o OS/2 Programming Tools and Information Version 1.3 (6024929) (referred to as 
  2835.   Programming Tools and Information) contains books which describe programming 
  2836.   concepts for developing applications for OS/2 Standard Edition. Code examples 
  2837.   and procedures are described to show the application developer how to use an 
  2838.   API for developing source code. An installation card is included to guide the 
  2839.   application developer in installing the toolkit. The following books are 
  2840.   included: 
  2841.  
  2842.    - Programming Overview (S91F9258) 
  2843.  
  2844.    - Programming Guide (S91F9259) 
  2845.  
  2846.    - Control Program Programming Reference (S91F9260) 
  2847.  
  2848.    - Presentation Manager Programming Reference, Vol. 1 (S91F9261) 
  2849.  
  2850.    - Presentation Manager Programming Reference, Vol. 2 (S91F9262) 
  2851.  
  2852.    - I/O Subsystems and Device Support, Vol. 1: Device Drivers (S91F9263) 
  2853.  
  2854.    - Building Programs (S91F9264) 
  2855.  
  2856.    - Presentation Manager C/2 Bindings Reference (S91F9265) 
  2857.  
  2858.    - I/O Subsystems and Device Support, Vol. 2: Driver Interfaces (S91F9266) 
  2859.  
  2860.    - FORTRAN/2 Bindings Reference (S91F9267) 
  2861.  
  2862.    - COBOL/2 Binding Reference (S91F9268) 
  2863.  
  2864.    - Presentation Manager Macro Assembler/2 Bindings Reference (S91F9269) 
  2865.  
  2866.    - Dialog Manager and Dialog Tag Summary Reference (S91F9270 ) 
  2867.  
  2868.    - Dialog Tag Language Guide and Reference (S91F9271) 
  2869.  
  2870.    - Procedures Language/2 REXX Programming Reference (S91F9272) 
  2871.  
  2872.    - Dialog Manager Guide and Reference (S91F9273) 
  2873.  
  2874.    - Master Index (S12F9826) 
  2875.  
  2876.  
  2877. ΓòÉΓòÉΓòÉ <hidden> Procedures Language 2/REXX Publications ΓòÉΓòÉΓòÉ
  2878.  
  2879. The following Procedures Language 2/REXX publications are available: 
  2880.  
  2881. o OS/2 2.0 Procedures Language 2/REXX Reference (S10G-6268) 
  2882.  
  2883. o OS/2 2.0 Procedures Language 2/REXX User's Guide (S10G-6269) 
  2884.  
  2885.  
  2886. ΓòÉΓòÉΓòÉ <hidden> General Information ΓòÉΓòÉΓòÉ
  2887.  
  2888. The following information sources can help you understand the products 
  2889. available from IBM: 
  2890.  
  2891. o Catalog of IBM Education (G320-1244-38, U.S. only; GN21-4412) 
  2892.  
  2893. o Software Directory (GB21-9949-28, U.S. only; GN20-3025) 
  2894.  
  2895.  
  2896. ΓòÉΓòÉΓòÉ 11.6. Related IBM AS/400 Host Publications ΓòÉΓòÉΓòÉ
  2897.  
  2898. The following information lists the related publications for Communications 
  2899. Manager communications with an AS/400 host. 
  2900.  
  2901. o AS/400 Publications 
  2902.  
  2903. o 5250 Emulation Publications 
  2904.  
  2905. o PC Support/400 Publications 
  2906.  
  2907.  
  2908. ΓòÉΓòÉΓòÉ <hidden> AS/400 Publications ΓòÉΓòÉΓòÉ
  2909.  
  2910. For information about the IBM AS/400 host library, refer to AS/400 Publications 
  2911. Guide (GC41-9678). 
  2912.  
  2913.  
  2914. ΓòÉΓòÉΓòÉ <hidden> 5250 Emulation Publications ΓòÉΓòÉΓòÉ
  2915.  
  2916. The following publications can help users understand 5250 emulation with 
  2917. Communications Manager/2: 
  2918.  
  2919. o IBM 5250 Information Display System Planning and Site Preparation Guide 
  2920.   (GA21-9337-08) 
  2921.  
  2922. o IBM 5251 Display Station Models 1 and 11 5252 Dual Display Station Operator's 
  2923.   Guide (GA21-9248-03) 
  2924.  
  2925. o IBM 5251 Display Station Models 2 and 12 Operator's Guide (GA21-9323-02) 
  2926.  
  2927. o IBM 5291 Display Station Operator's Guide (GA21-9409-02) 
  2928.  
  2929. o IBM 5292 Color Display Station Models 1 and 2 Operator's Guide (GA21-9416-01) 
  2930.  
  2931.  
  2932. ΓòÉΓòÉΓòÉ <hidden> PC Support/400 Publications ΓòÉΓòÉΓòÉ
  2933.  
  2934. The following publications can help you learn how to use PC Support/400 to 
  2935. communicate with an IBM AS/400 host: 
  2936.  
  2937. o AS/400 PC Support/400: OS/2 Installation and Administration Guide Version 2.2 
  2938.   (SC41-0007) 
  2939.  
  2940. o AS/400 PC Support/400:  OS/2 Installation and Administration (PS/55) Guide 
  2941.   Version 2.2 (SC41-0009) 
  2942.  
  2943. o AS/400 PC Support/400: DOS and OS/2 Technical Reference Version 2.2 
  2944.   (SC41-8091) 
  2945.  
  2946. o AS/400 PC Support/400:  Application Program Interface Reference Version 2.2 
  2947.   (SC41-8254) 
  2948.  
  2949. o AS/400 PC Support/400:  OS/2 User's Guide Version 2.2 (SC41-8200) 
  2950.  
  2951. o AS/400 PC Support/400:  OS/2 User's Guide (PS/55) Version 2.2 (SC41-2415) 
  2952.  
  2953.  
  2954. ΓòÉΓòÉΓòÉ 11.7. Related 3270 Host Communications Publications ΓòÉΓòÉΓòÉ
  2955.  
  2956. The following publications can be helpful to communications programmers: 
  2957.  
  2958. o IBM APPC for the Personal Computer Programming Guide (SC40-0100; P/N 75X1084) 
  2959.  
  2960. o IBM Programmer's Guide to the SRPI for the PC and the 3270-PC (SC23-0959-01) 
  2961.  
  2962. o IBM 3270 PC High Level Language Application Program Interface Programmer's 
  2963.   Guide (available only with the IBM 3270 PC HLLAPI program product, 75X1087) 
  2964.  
  2965. The following host references can aid a communications system administrator who 
  2966. is consulting with host personnel during configuration: 
  2967.  
  2968. o VTAM Installation and Resource Definition Version 3 (SC23-0111-05) 
  2969.  
  2970. o ACF/VTAM Version 3 Customization (SC23-0112-03) (a component of SBOF-1584 and 
  2971.   SBOF-1583) 
  2972.  
  2973. o Enhanced Connectivity Facilities TSO/E Servers-Requesters CMS 
  2974.   Servers-Requesters Introduction Version 1 (GC23-0957-04) 
  2975.  
  2976. o Network Program Products Planning (SC27-0658-02) 
  2977.  
  2978. o Network Program Product Samples (SC30-3352-07) 
  2979.  
  2980. o Synchronous Data Link Control General Information (GA27-3093-03) 
  2981.  
  2982. o Systems Network Architecture Guide to SNA Publications (GC30-3438) 
  2983.  
  2984. o Systems Network Architecture Concepts and Products (GC30-3072-04) 
  2985.  
  2986. o Systems Network Architecture Network Product Formats (LY43-0081-01) 
  2987.  
  2988. o Systems Network Architecture Format and Protocol Reference:  Architecture 
  2989.   Logic for LU Type 6.2 (SC30-3269-03) 
  2990.  
  2991. o Systems Network Architecture:  Sessions between Logical Units (GC20-1868-02) 
  2992.  
  2993. o Systems Network Architecture Technical Overview (GC30-3073-03) 
  2994.  
  2995. o System Control Statements VSE/AF (SC33-6198-02) 
  2996.  
  2997. o 3270 Information Display System 3274 Control Unit Description and 
  2998.   Programmer's Guide (GA23-0061-02) 
  2999.  
  3000. o MVS Host Publications 
  3001.  
  3002. o VM Host Publications 
  3003.  
  3004. o Graphical Data Display Manager Publications 
  3005.  
  3006.  
  3007. ΓòÉΓòÉΓòÉ <hidden> MVS Host Publications ΓòÉΓòÉΓòÉ
  3008.  
  3009. The following publications can be used for communicating with an MVS host: 
  3010.  
  3011. o CICS/DOS/VS Version 1 Installation and Operations Guide (SC33-0070-06) 
  3012.  
  3013. o CICS/DOS/VS Version 1 Release 7 Release Guide (GC33-0130-02) 
  3014.  
  3015. o TSO/E Version 2 Guide to the Server-Requester Programming Interface 
  3016.   (SC28-1877-03) 
  3017.  
  3018. o ECF/TSO/E Servers and CMS Servers Installation Planning and Programmer's 
  3019.   Guide (SK2T-0004) 
  3020.  
  3021. o ECF Installation, Planning, and Administration Guide (SH20-9677-02) 
  3022.  
  3023.  
  3024. ΓòÉΓòÉΓòÉ <hidden> VM Host Publications ΓòÉΓòÉΓòÉ
  3025.  
  3026. The following publications can be used for communicating with a VM host: 
  3027.  
  3028. o IBM Programmers Guide to the Server-Requester Programming Interface for VM/SP 
  3029.   (SC24-5291-02) 
  3030.  
  3031. o VM/SNA NPP Samples (SC30-3309) (a component of SBOF-1584) 
  3032.  
  3033. o VM/SP Planning Guide and Reference (SC19-6201-06) 
  3034.  
  3035.  
  3036. ΓòÉΓòÉΓòÉ <hidden> Graphical Data Display Manager Publications ΓòÉΓòÉΓòÉ
  3037.  
  3038. Communications system administrators and users of the 3270 host graphics 
  3039. program Graphical Data Display Manager (GDDM*) can use the following 
  3040. publications for additional information: 
  3041.  
  3042. o GDDM Version 2 Release Guide (GC33-0320-02) 
  3043.  
  3044. o GDDM Version 2 Library Guide and Master Index (GC33-0595-01) 
  3045.  
  3046. o Introducing GDDM (GBOF-0058). This package contains: 
  3047.  
  3048.    - GDDM Version 2 General Information (GC33-0319-02) 
  3049.  
  3050.    - GDDM If you make business presentations... (GC33-0455) 
  3051.  
  3052.    - GDDM If you're an engineer... (GC33-0456) 
  3053.  
  3054. o GDDM Version 2.2 Application Programming Guide GDDM/MVS, GDDM/VM, GDDM/VSE, 
  3055.   GDDM-IMD, GDDM-PGF (SC33-0337) 
  3056.  
  3057. o GDDM Version 2 Base Programming Reference Volume 1 and 2 (SC33-0332-02) 
  3058.  
  3059. o GDDM Version 2 Base Programming Reference Summary (SX33-6053-01) 
  3060.  
  3061. o GDDM-PGF Programming Reference (SC33-0333) 
  3062.  
  3063. o GDDM-PGF Interactive Chart Utility (SC33-0328) 
  3064.  
  3065. o GDDM Better Charts Poster (GC33-0529) 
  3066.  
  3067. o GDDM-PGF Vector Symbol Editor (SC33-0330) 
  3068.  
  3069. o GDDM-PGF Version 2 Programming Reference Summary (SX33-6054) 
  3070.  
  3071. o GDDM Version 2 Installation and System Management for MVS (GC33-0321-04) 
  3072.  
  3073. o GDDM Version 2 Installation and System Management for VSE (GC33-0322-03) 
  3074.  
  3075. o GDDM Version 2 Installation and System Management for VM (GC33-0323-03) 
  3076.  
  3077. o GDDM Version 2 Performance Guide (SC33-0324) 
  3078.  
  3079. o GDDM Version 2 Messages (SC33-0325-03) 
  3080.  
  3081. o GDDM Version 2 Diagnosis and Problem Determination Guide (SC33-0326-03) 
  3082.  
  3083. o GDDM Version 2 Guide for Users (SC33-0327-02) 
  3084.  
  3085. o GDDM Image Symbol Editor (SC33-0329) 
  3086.  
  3087. o GDDM Interactive Map Definition (SC33-0338) 
  3088.  
  3089. o GDDM-GKS Programming Guide and Reference (SC33-0334) 
  3090.  
  3091. o GDDM Image View Utility (SC33-0479) 
  3092.  
  3093. o GDDM-PCLK Reference Summary (SX33-6067-01) 
  3094.  
  3095. o GDDM 2.2 Typefaces and Shading Patterns (ST33-0554) 
  3096.  
  3097. o GDDM Version 2 Licensed Program Specifications (GC33-0423-06) 
  3098.  
  3099. * Trademark of IBM 
  3100.  
  3101.  
  3102. ΓòÉΓòÉΓòÉ 11.8. Related Realtime Interface Co-Processor Publications ΓòÉΓòÉΓòÉ
  3103.  
  3104. The library for the IBM Realtime Interface Co-Processor, the IBM Realtime 
  3105. Interface Co-Processor Multiport, and the IBM Realtime Interface Co-Processor 
  3106. Multiport/2 consists of the following publications: 
  3107.  
  3108. o Realtime Interface Co-Processor Technical Reference (SC28-8006) 
  3109.  
  3110. o Realtime Interface Co-Processor Technical Reference Supplement (S15F-8872) 
  3111.  
  3112. o Realtime Interface Co-Processor Firmware Technical Reference (S33F-5336) 
  3113.  
  3114. o Realtime Interface Co-Processor Portmaster Technical Reference (S33F-5337) 
  3115.  
  3116. o Realtime Interface Co-Processor Portmaster Technical Reference Supplement 
  3117.   (SC28-8271) 
  3118.  
  3119. o Realtime Interface Co-Processor Multiport Model 2 Technical Reference 
  3120.   (S57F-0632) 
  3121.  
  3122. o Realtime Interface Co-Processor Multiport Model 2 Technical Reference 
  3123.   Supplement (SC28-8273) 
  3124.  
  3125. o OS/2 Extended Edition Version 1 Realtime Interface Co-Processor Multiport/2 
  3126.   (S01F-0300) 
  3127.  
  3128. o Realtime Interface Co-Processor:  Developer's Kit (S16F-2020).  The 
  3129.   publication with this product provides tips and techniques for system 
  3130.   programmers who are creating applications for the IBM Realtime Interface 
  3131.   Co-Processor Multiport/2 and the IBM X.25 Interface Co-Processor/2 in the 
  3132.   OS/2 program.  It describes an assortment of productivity aids, including 
  3133.   samples and debugging tools. 
  3134.  
  3135. o Realtime Interface Co-Processor:  C Language Support (SC28-8014).  The 
  3136.   publication with this product documents C high-level interfaces for the IBM 
  3137.   Realtime Interface Co-Processor Multiport/2 and the IBM X.25 Interface 
  3138.   Co-Processor/2. 
  3139.  
  3140. o Realtime Interface Co-Processor AIX Support for RISC/6000 User's Guide 
  3141.   (SC28-9596) 
  3142.  
  3143. o Realtime Interface Co-Processor and Realtime Interface Co-Processor Multiport 
  3144.   Hardware Maintenance Library (SC28-8005) 
  3145.  
  3146. o Realtime Interface Co-Processor Multiport/2 Hardware Maintenance Library for 
  3147.   6 Port Synchronous Card (S15F-8855) 
  3148.  
  3149.  
  3150. ΓòÉΓòÉΓòÉ 11.9. Related X.25 Packet-Switching Data Networks Publications ΓòÉΓòÉΓòÉ
  3151.  
  3152. The definitive X.25 reference is the CCITT (International Telegraph and 
  3153. Telephone Consultative Committee) Recommendation X.25: 
  3154.  
  3155. o Interface between Data Terminal Equipment (DTE) and Data Circuit Terminating 
  3156.   Equipment (DCE) for Terminals Operating in the Packet Mode on Public Data 
  3157.   Networks, Volume VIII, Fascicle VIII.2, Rec. X.25, Geneva (November 1980) 
  3158.  
  3159. o Data Communications Networks Interfaces, Volume VIII, Fascicle VIII.3, Rec. 
  3160.   X.20-X.32, Malaga-Torremolinos (October 1984) 
  3161.  
  3162. IBM publications for X.25 are: 
  3163.  
  3164. o X.25 1984-1988 Interface for Attaching SNA Nodes to Packet-Switched Data 
  3165.   Networks General Information Network (GA27-3761) 
  3166.  
  3167. o X.25 1984-1988 Interface for Attaching SNA Nodes to Packet-Switched Data 
  3168.   Networks Architecture Reference (SC30-3409-01) 
  3169.  
  3170. o X.25 Interface for Attaching SNA Nodes to Packet-Switched Data Networks 
  3171.   General Information (GA27-3345-02) 
  3172.  
  3173. o Tuning Considerations for SNA X.25 DTE's (GG24-1746) 
  3174.  
  3175. In addition to the literature in the preceding list, you can refer to other 
  3176. published material about packet switching and X.25.  For example, network 
  3177. providers may publish introductory material or booklets of network-specific 
  3178. information. 
  3179.  
  3180. The following publications describe the X.25 Network Control Program Packet 
  3181. Switching Interface (NPSI), which offers SNA users the ability to use 
  3182. communications facilities that support the CCITT X.25 (1980 and 1984) 
  3183. recommendations: 
  3184.  
  3185. o X.25 NCP Packet Switching Interface General Information Version 3.4 
  3186.   (GC30-3469-04) 
  3187.  
  3188. o X.25 NCP Packet Switching Interface Planning and Installation Version 5.4 
  3189.   (SC30-3470-05) 
  3190.  
  3191. o X.25 Network Control Program (NCP) Packet Switching Interface Host 
  3192.   Programming Version 3.4 (SC30-3502-03) 
  3193.  
  3194. The following publications may be needed for reference: 
  3195.  
  3196. o X.25 Interface Co-Processor/2 Technical Reference (S16F-1879, U.S.; 07F3180) 
  3197.  
  3198. o X.25 Interface Co-Processor/2 Hardware Maintenance Library (S16F-1874, U.S.; 
  3199.   07F3190; 07F3193, France; 07F3196, Germany) 
  3200.  
  3201.  
  3202. ΓòÉΓòÉΓòÉ 11.10. Systems Applications Architecture (SAA) Publications ΓòÉΓòÉΓòÉ
  3203.  
  3204. The following publications describe the requirements for SAA and its 
  3205. advantages: 
  3206.  
  3207. o Systems Application Architecture Common Communications Support Primer 
  3208.   (GC24-3483) 
  3209.  
  3210. o Systems Application Architecture Common Programming Interface Query Reference 
  3211.   (SC26-4349-03) 
  3212.  
  3213. o SAA: Common Programming Interface C Reference (SC26-4353) 
  3214.  
  3215. o SAA: Common Programming Interface C Reference (SC26-4354-02) 
  3216.  
  3217. o Systems Application Architecture Common Programming Interface Application 
  3218.   Generator Reference (SC26-4355-03) 
  3219.  
  3220. o Systems Application Architecture Common Programming Interface Dialog 
  3221.   Reference (SC26-4356-02) 
  3222.  
  3223. o Systems Application Architecture Common Programming Interface FORTRAN 
  3224.   Reference (SC26-4357-02) 
  3225.  
  3226. o Systems Application Architecture (SAA) Common Programming Interface (CPI) 
  3227.   Procedures Language Reference (SC26-4358-03) 
  3228.  
  3229. o Systems Application Architecture Common Programming Interface Presentation 
  3230.   Reference (SC26-4359-02) 
  3231.  
  3232. o SAA Writing Applications:  A Design Guide (SC26-4362) 
  3233.  
  3234. o SAA:  Common Programming Interface Communications Reference (SC26-4399) 
  3235.  
  3236. o Systems Application Architecture:  Common User Access Guide to User Interface 
  3237.   Design (SC34-4289) 
  3238.  
  3239. o Systems Application Architecture:  Common User Access Advanced Interface 
  3240.   Design Reference (SC34-4290) 
  3241.  
  3242. o IBM Systems Application Architecture:  Common Communications Support Summary 
  3243.   (GC31-6810) 
  3244.  
  3245. o SAA Applications:  A Value Guide  (G320-9803) 
  3246.  
  3247.  
  3248. ΓòÉΓòÉΓòÉ 11.11. General Information ΓòÉΓòÉΓòÉ
  3249.  
  3250. Part numbers and order numbers for publications are presented in the following 
  3251. way: 
  3252.  
  3253. o If only one part number or order number follows a publication title, that 
  3254.   part number or order number is the worldwide part number; for example: IBM 
  3255.   LAN Asynchronous Connection Server Function and Connectivity Guidelines 
  3256.   (GA27-3917) 
  3257.  
  3258.    IBM 5250 Information Display System Planning and Site Preparation Guide 
  3259.    (GA21-9337) 
  3260.  
  3261. o If a publication has a U.S. version different from the worldwide English 
  3262.   version, two part numbers or order numbers are given in the following 
  3263.   example: 
  3264.  
  3265.    IBM X.25 Interface Co-Processor/2: Technical Reference (16F1879 (U.S.); 
  3266.    07F3180). 
  3267.  
  3268. o If a publication has both a part number and an order number, the numbers are 
  3269.   given as in the following example: 
  3270.  
  3271.    IBM Local Area Network Technical Reference (25F7688, SC30-3383-03). 
  3272.  
  3273. For more information about ordering publications, contact your IBM authorized 
  3274. dealer or your IBM marketing representative.  In the United States, you can 
  3275. call 800-426-7282 toll free. 
  3276.  
  3277. END OF DOCUMENT