MAI COMPANY CONFIDENTIAL FIELD INFORMATION BULLETIN SERVICE GROUP(S): MINI MFG: BASIC FOUR NACS TYPE(S): N017 MFG. MODEL(S): ATP INTERSYSTEM CATEGORY: SOFTWARE DESC: TRANSPORT PACKAGE *** TABLE OF CONTENTS AS OF 07/31/91 *** FIB 00001.ATP Level 3 now available for DS-1500 data transfer.........05/04/87 FIB 00002.ATP is now added to the 8.6-9.8B1*54 O.S. tape..............12/02/87 FIB 00003.8-Way modification for Data Transfer 13xx to 2/3/4000.......09/28/88 FIB 00004.ATP 4.0 Software Announcement [ WPSS 150 ].................04/18/89 FIB 00005.Data Transfer Problems with ATP 4.0 - DS1500 [ WPSF 549 ]..07/27/89 FIB 00006.ATP 4.0 Corrupting String Files on 7.5B [ WPSF 564 ].......11/22/89 FIB 00007.BASIC.programs corrupted transferring from GPx to SPx [ WPSF06/19/91 SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------Table Of Contents Pg01 of 01 FIB 00001 05/04/87 *** ATP Level 3 now available for DS-1500 data transfer *** A new version of the ATP Intersystem Transport Package, Level 3, is now available. This new version contains performance improvements, but its main intent is for situations where there is an immediate need to port programs and data to the MAI 1500. Please read this announcement before ordering the software to ensure the prerequisites can be met. In addition to this announcement you will need a copy of the 'Intersystems Transport Package User Guide', BFISD 6354C. TABLE OF CONTENTS 1.0 Introduction 2.0 New Features and Enhancements 3.0 Hardware and Software Requirements 4.0 Installation and Using the New ATP Package 4.1 Installing the ATP package 4.1.1 Installing on the 13xx Systems 4.1.2 Installing on the MAI 1500 4.1.3 Installing on the MAI 2000 4.1.4 Installing on the MPx Series 4.2 Using the New ATP Package 4.2.1 Using the package on the 13xx Systems, MAI 2000, and MPx Series. 4.2.2 Using the New ATP Package on the MAI 1500 5.0 For Your Information This version of ATP will move program and data files between any two MAI Basic Four systems that can host an ATP module. These systems are the MAI 1500, MAI 2000, MPx Series, and 13xx Systems. Performance improvements and features have caused the new release of ATP to be incompatible with previous versions of ATP. For this reason it is solely intended for situations where there is a need to port programs and data to the MAI 1500. The ATP products are being offered at minimal cost (plus media). Since this release is intended as a temporary solution only, it is being sold as an "AS IS" product and thus there is no commitment to update or improve it. There will, however be a fully supported successor product with additional features announced late this year. It is recommended that if communicating with the MAI 1500 is not an immediate need you wait for the successor products. 2.0 New Features and Enhancements This new version of ATP is mainly intended for situations where there is a need to port programs and data to/from the MAI 1500. In addition to this added support the asynchronous protocol has been modified for a faster turn-around, thus making the transport process faster. SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB001 Pg001 3.0 Hardware and Software Requirements The following is a list of hardware and software requirements for the ATP transport. These requirements have not changed from the requirements for the other levels of ATP. o Following are the lowest supported and certified Operating Systems for this release of the ATP package: o MPx Series - 8.5C/9.5C/8.4E o MAI 2000 - 7.2A/B o MAI 1500 - 6.2A o 13xx Systems - 4.5B o A serial asynchronous port on each system which will connect the systems together. These ports should be configured as asynchronous comm ports. o A terminal task to run the program on each system. These ports should be configured as standard terminal ports. o A cable that will connect to the asynchronous port of each system with the following configuration: 3-----2 2-----3 7-----7 20----20 NOTE: This cabling can be built by making an adapter cable that has a female 25 pin RS-232 connector at each end with pins 3 to 2, 2 to 3, 7 to 7 and 20 to 20. With this cable the standard terminal to CCA cable from each system can be plugged into this adapter for any system, avoiding the problem of coming up with a cable that has the same I/O ends for each system. o For best results it is recommended that when transporting to a 13xx system that your input buffering be set for 256. If input buffering is not at 256, program modification may be required to avoid input buffering overflow. o On the 13XX system, a GHOST task started with 96 pages of memory is required for the program conversion. 4.0 Installation and Using The New ATP Package This section details the steps required to install this new version of the ATP package. It also provides the details of the differences, if any, between the steps outlined in the 'Intersystem Transport Package User Guide', BFISD 6354C, and this version of the ATP package. For this reason, it is recommended that you get a copy of this manual and read it before using this transport package. 4.1 Installing the ATP package Below are the steps required to install the ATP package on various systems. NOTE: Remember, this new ATP package is not compatible with older versions of ATP because of performance and protocol changes. This new ATP must be installed on SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB001 Pg002 all systems performing data interchange. It is recommended the older versions be archived before installing the new version. This enables transport to systems that are not going to be updated. For example, if an MAI 2000 is going to interchange data between a 13xx system and a MAI 1500, the older version can interface with the 13xx system, and the new version can be used to interface the MAI 1500. Only the two ATP versions would have to be swapped in and out as required, since they use the same BQR, converter and translator. The files that are affected are: ARP, ATP, ATP1, ATRCV and ATXMT. 4.1.1 Installing on the 13xx Systems The new ATP package for the 13xx Systems is distributed on either 1/4 inch MTC tape or 1/2 inch MTR/MTS tape, and includes the following programs: ARP, ATP, ATP1, ATRCV, ATXMT, BQR, BQR1, BQR1A, BQR2, BQR3, BQR4, BQRLOG, BQRS, CNVTR, CNVTR2, CNVTR3, FLAGIT, and XSEPGM. To install the package from either media source use the '*MTC' utilities. Use the predefined procedure 'RESTALL' to install all the programs on your system. 4.1.2 Installing on the MAI 1500 The new ATP package for the MAI 1500 is distributed on diskette only and includes the programs, ARP, ATP, ATP1, ATRCV, ATXMT, BQR, BQR1, BQR1A, BQR2, BQR3, BQR4, and FLAGIT and the indexed file *EXCEPT*. To install the package, first enable the ITP diskette by the use of the "*U" utility. Next use the "*S" utility to transfer the programs from the diskette to the hard disk by selecting the following options: TYPE: Programs ASK, REPLACE, SKIP EXISTING FILES: REPLACE ENTER FILENAME OR MASK: @ NOTE: If you do not wish to install the package onto the hard disk, it can be run by inserting the ITP diskette into the floppy diskette drive and running the "*U" to enable the diskette. You can then run the packages from the diskette. 4.1.3 Installing on the MAI 2000 The ATP package is distributed on 1/4 inch MCS tape which also contains the complete Intersystem Transport package. This includes the transport packages for MCS, FTF, ATP, 27xx/37xx and the BQR utility. The only package on the tape that has been modified is the ATP package. To install the package from the 'admin>' prompt enter 'install cs EIT' . 4.1.4 Installing on the MPx Series The ATP package for the MPx Series is distributed on SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB001 Pg003 1/2 inch MTS media and includes the following programs: ARP, ATP, ATP1, ATRCV, ATXMT, BQR, BQR1, BQR1A, BQR2, BQR3, BQR3A, BQR4, BQRS, CNVTR, CNVTR2, CNVTR3, FTFIT, SKEMA, SKEMD, SKEMF, SKEML, SKFIT, and SKFIT2. To install this tape use 'SAVERESTORE' and restore to your system node '.Rxxxx.SYS.'. 4.2 Using the new ATP package The following are the steps for using the new ATP package. WARNING: This version of the ATP package is not compatible with the older version. For this reason, before running the transport, ensure that you have the newest release. This can be verified by loading the following programs and listing line 10, which will have an '86' date and the characters SJC at the end of the line. The programs are ARP, ATP, ATP1, ATRCV, and ATXMT. 4.2.1 Using the package on the 13xx Systems, MAI 2000, and MPx Series The steps for using the new ATP package on the 13xx Systems, MAI 2000 and MPx Series are the same as outlined in the 'Intersystem Transfer Package Users Guide', BFISD 6354C, with the following exceptions: o The schema feature is no longer supported. If you have data files that contain both text and binary data you will need to transport it as text and modify it the on receiving system. (See "For Your Information Section" for a program to do this.) o When porting to an MAI 1500, serial files can not be ported, as the MAI 1500 does not support serial files. (See "For Your Information Section" for a workaround.) 4.2.2 Using the new ATP package on the MAI 1500 The steps for using the ATP package on the MAI 1500 are the same as those outlined in the 'Intersystem Transport Package User Guide', BFISD 6354C. This system uses the same steps for the 13xx type systems with the following exceptions: o ATP is the only transporter available for the MAI 1500. For this reason when defining a BQR filelist you are not given a transport media option. o Programs and data files are converted during the transport. Therefore, no option for data conversion is given; that option has been replaced with an option for listing transport and conversion considerations to a printer. o Since the use of schemas for mixed data-type files is not supported on the 1500, there is no option for schema generation. The only schemas you can use are text or binary type. (For details on how to handle this type of file see "For Your SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB001 Pg004 Information Section".) 5.0 For Your Information Following is a list of known problems with this version of the ATP transport with a work-around for each, if one exists: o This version of ATP is not compatible with any other versions of ATP. For this reason care should be taken when using this package to ensure that the two systems that will be communicating have the same version of ATP. Since this new version of ATP uses a new protocol if you try to transport from any other version of ATP to this version you will not get communications successfully started. If you are transporting from this version to another version the results will be unknown. o Serial files are not supported on the MAI 1500. Transporting this type of file to the MAI 1500 will cause an error. Workaround: If you need to transport this type of file, write them to an index file on the sending system. o The MAI 1500 will change the number of records received on an indexed file, as the MAI 1500 fills up a whole disk sector. This will cause extra records to be added to the end of the file. Workaround: On the MAI 1500 side write the index file to a new index file with the correct number of records. o The schema generation and use of mixed data-type files is not supported. Workaround: On the receiving system, after the transport, use the following program to convert the binary fields back to the proper data: This will require that you define a file with the same parameters as the file you wish to modify. It will be called 'NEW_FILE'. You may use this procedure. 10 OPEN(1)"FILE TO CHANGE" 20 OPEN(2)"NEW FILE" 30 READ (1,KEY="",ERR=40)* 40 LET K$=KEY(1,END=100) 50 READ (1,KEY=K$)A$,B$,C$; REM"ENTER AS MAY FIELDS AS THERE ARE IN YOUR FILE. FOR THIS EXAMPLE ONLY FIELD B$ WILL BE CONVERTED, BUT AS MANY FIELDS AS YOU WISH CAN BE MODIFIED." 60 DIM Z$(LEN(B$),$80$) 70 LET B$=XOR(B$,Z$); REM "THIS WILL CAUSE THE HIGH BIT TO BE FLIPPED. TO CONVERT MORE FIELDS ADD LINES TO DO THE STEPS IN STATEMENTS 60 AND 70. 80 WRITE (2,KEY=K$)A$,B$,C$ 90 GOTO 40 100 PRINT "CONVERSION COMPLETE. ERASE THE OLD FILE AND RENAME THE NEW TO THE OLD!" ORIGINATOR: MBF SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB001 Pg005 FIB 00002 12/02/87 *** ATP is now added to the 8.6-9.8B1*54 O.S. tape *** The recently released ATP 4.0 is now being appended to the end of the 9/8.6B *54 O.S. tapes. The labels on these new tapes will say "9/8.6B1 *54". The market codes and part numbers for this release have not changed. Shipment of these 9/8.6B1 O.S. tapes will begin on 11/12/87. The ATP files will reside in the .R6B54.SYS. node. The files are: ARP ATPSCH ATDIAL ATPTIM ATP ATPTM1 ATP0 ATRCV ATP1 ATXMT ATPSC1 INSTALLATP ATPSC2 ORIGINATOR: Nancy Prentiss SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB002 Pg001 FIB 00003 09/28/88 *** 8-Way modification for Data Transfer 13xx to 2/3/4000 *** SYMPTOM/TEXT: When transfering data between a 13xx system and an SPx system The 8-way PCBA in the 13xx system must be modified in order to support the correct character transmission. The port must provide an 8-bit data character with no parity and one stop bit. Certain jumpers must be cut on the board. CAUTION: Modification of the port dedicates the port for the sole usage by ATP. No standard MBF serial devices will function properly if connected to this port due to the 8 bit data format. FIX: Make the etch cuts and jumper changes as shown below: NOTE: The configuration jumpers are labeled Ax (A1, A2, etc.) in the chart below which represents channel 0, for other channels substitute the correct designation from the following list: Ax = channel 0 Bx = channel 1 Cx = channel 2 Dx = channel 3 Hx = channel 4 Kx = CHANNEL 5 Mx = CHANNEL 6 Nx = CHANNEL 7 UART Configuration Jumpers OPTION | A1 to | A2 to | A3 to | A4 to | A5 to | USE ----------------------|-------|-------|-------|-------|-------|------------ No Parity check.......|.open..|...X...|...X...|...X...|...X...|.ATP Even Parity check.....|..GND..|...X...|...X...|...X...|.open..| Odd parity check......|..GND..|...X...|...X...|...X...|..GND..|.NORMAL 6 bits/character......|...X...|...X...|..GND..|.open..|...X...| 7 bits/character......|...X...|...X...|.open..|..GND..|...X...|.NORMAL 8 bits/character......|...X...|...X...|.open..|.open..|...X...|.ATP One stop bit..........|...X...|..GND..|...X...|...X...|...X...|.NORMAL/ATP Two stop bits.........|...X...|.open..|...X...|...X...|...X...| 5 bits/character with | | | | | | one stop bit.........|...X...|..GND..|..GND..|..GND..|...X...| 5 bits/character with | | | | | | 1.5 stop bits........|...X...|.open..|..GND..|..GND..|...X...| --------------------------------------------------------------| Refer to Worldwide Product Support Software Bulletin #150 for information on the Asynchronous Transport Package (ATP). ORIGINATOR: Bob Berard SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB003 Pg001 FIB 00004 04/18/89 *** ATP 4.0 Software Announcement [ WPSS 150 ] *** Asynchronous Transport Package (ATP~) 4.0 is now available. This new version contains performance enhancements and added features: o Line turnaround allows transmit and receive functions within the same session. o Autodial supports automatic session calling to remote sites using either Hayes/compatible or UDS 224 A/D modems. o ATP scheduler provides unattended startup of ATP sessions. o ATP performs automatic data coversion and translation during file transfer. ATP 4.0 provides intersystem file transfers between the following MBF systems: o 13xx systems on minimum 4.5B O/S release o 1500 systems on minimum 6.3A O/S release o 1800 systems on minimum 7.2N O/S release o 2000/3000 systems on minimum 7.3A O/S release o MPx systems on minimum 8.6B/9.6B O/S release ATP 4.0 is not compatible with any ATP release prior to level 4. ATP 4.0 requires a minimum operating system level in order to function properly. Reference the Intersystem Transport Package User Guide, M6354D, for detailed instructions. Copyright^ 1987 by MAI Basic Four, Inc. All rights reserved. TABLE OF CONTENTS 1.0 Introduction 2.0 System 13xx Installation 2.1 Hardware Configuration 2.2 Software Configuration 2.3 Loading Instructions 3.0 System 1500 Installation 3.1 Hardware Configuration 3.1.1 Serial/Parallel Adapter Board 3.1.2 Multi-Port Controller Board 3.2 Software Configuration 3.3 Loading Instructions 4.0 System 1800 Installation 4.1 Hardware Configuration SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg001 4.1.1 Serial/Parallel Adapter Board 4.1.2 Intellegent Serial Controller (Eight-Way Board) 4.2 Software Configuration 4.3 Loading Instructions 5.0 System 2000/3000 Installation 5.1 Hardware Configuration 5.1.1 CMB (2000) PN 903441-001 5.1.2 CMB (2000) PN 903441-002 5.1.3 CMB (3000) 5.1.4 Four-Way Controller PN 903390-001 (PCB 904741) 5.1.5 Four-Way Controller PN 903390-001 (PCB 904943) 5.1.6 Eight-Way Controller (3000) 5.2 Software Configuration 5.3 Loading Instructions 6.0 System MPx Installation 6.1 Hardware Configuration 6.2 Software Configuration 6.3 Loading Instructions TABLE OF CONTENTS 7.0 Cable Support 8.0 Modem Support 9.0 Problems and Workarounds 9.1 All Systems 9.2 System 13xx 9.3 System 1500 9.4 System 1800 9.5 System 2000/3000 9.6 System MPx 10.0 Documentation 1.0 INTRODUCTION ATP~ 4.0 provides full data transfer between the 13xx, 1500, 1800, 2000/ 3000 and MPx (7000, 7100, 8000, 9000, 9100 and 9500) systems over asynchronous lines. The systems may be connected either directly, system to system, or by modems over switched or leased lines. Together with the Intersystem Transport Package application, filelists are created in BQR to send data using ATP between MAI systems. The ATP package is certified to run from 1200 baud up to a maximum of 9600 baud on directly connected systems. Modem rates of 1200 and 2400 baud are supported. ATP 4.0 includes performance enhancements, general utility enhancements, line turn around, autodial support and scheduling for those systems with the proper hardware controls. Descriptions of the new features are included below. SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg002 o ATP 4.0 now provides automatic conversion and translation of the data files. o ATP 4.0 optimizes the protocol and polling method between systems resulting in a performance improvement of data transfer over previous ATP products. o Utilities such as ATP and BQR have incorporated some functional changes in order to support the added features. o BQR supports STRING files on 1800/2000/3000 systems where the transport media is ATP. o Line turn-around allows a system to relinquish control of the line after sending a set of files so the other system can begin transferring its own set of files. Only one session is required in order to send data in both directions. If autodial is used, the connection is made only once. o Autoprompts provide a method to save phone numbers, session parameters and specific filelists for that session. Autoprompts may be used immediately or called up at a later date. o Autodialer provides automatic calling of a remote system using session parameters stored in an autoprompt. The autodialer commands supported by the application are HAYES and UDS compatible. o Scheduler provides a means to start a terminal task to run a list of pre-defined autoprompts at a specific time or date to establish communications with a remote system. Lock and Key provides revenue protection for the autodialer, line turn- around and scheduler features. If any of these options are ordered, a public key is provided and must be installed in order to access the proper utilities. The 13xx and 1500 systems currently do not support some of the hardware signals required for autodial; therefore, some of the above features are not fully supported. Refer to the appropriate system description included in this announcement for more detailed information. All previous levels of ATP are not compatible with this release of ATP 4.0. A base level of asynchronous transport (ATP) utilizing the optimized protocol is available with the Intersystem Transport Package and does not require a LOCK & KEY. The table below displays the various levels of ATP including 4.0. In order to verify the particular level installed on your current system, load the "ATP" program in BASIC and LIST statement 00010. ATP 1.0 - '84 date with SMO initials ATP 3.0 - '86 date with SJC initials ATP 4.0 - '87 date with SJC initials RUN "ATP" also provides the revision number at the header of the menu screens (only displayed on level 4). The SKEMA utilities are no longer supported. Only text or binary files can be transported by ATP 4.0. Only those files which are compatible between systems can be transferred. SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg003 The 1500 system does not support any serial files from other systems and string files are only allowed between systems running BOSS/IX operating systems. ATP cannot transport encrypted program files. __________________________________________________________________________. CAUTION: ATP 4.0 is not compatible with any other level of ATP (i.e., 1.0, 2.0 or 3.0). Both systems must be on ATP 4.0 in order to make initial connection. __________________________________________________________________________. 2.0 SYSTEM 13xx INSTALLATION ATP requires a minimum 4.5B O/S release level on the 13xx system. No public key is required on the 13xx systems to access any of the ATP 4.0 features. The 13xx version of ATP does not support the scheduler because there is no real time clock available on the system. The scheduler modules are not included. The autodial capability of ATP level 4 is not supported due to the lack of modem controls on the hardware of the 8-way. The inability to drop DTR signals on the RS-232 interface prevents the system from "hanging up" the phone line after a session is complete. The line turnaround feature is provided without revenue protection. MBF distributes the ATP software for 13xx on either 1/4 inch MTC tape or 1/2 inch MTR/MTS tape. The following programs are on the 13xx tape. ARP ATP1 BQR BQR3 CNVTR ATDIAL ATPPGM BQR1 BQR4 CNVTR2 ATP ATRCV BQR1A BQRLOG CNVTR3 ATP0 ATXMT BQR2 BQRS FLAGIT The basic program, XSEPGM, used to convert serial files to programs on past releases, is no longer required for ATP 4.0. The 8-way PCBA must be modified in order to support the correct character transmission. Refer to Section 2.1, HARDWARE CONFIGURATION, for details. 2.1 HARDWARE CONFIGURATION The 8-way controller that supplies the serial ports for ATP requires modification from standard configurations. The port must provide an. 8-bit data character with no parity and one stop bit. Certain jumpers must be cut on the board. Contact your hardware service representative in order to modify the controller. Refer to MBF 505003, General Specification Foreign Device System. _____________________________________________________________________ CAUTION: Modification of the port dedicates the port for the sole usage by ATP. No standard MBF serial devices will function properly if connected to this port due to the 8 bit data character format (standard MBF serial devices use 7-bit data, Odd Parity SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg004 and 1 stop bit). _____________________________________________________________________ Refer to Section 7.0, CABLE SUPPORT, for a description of cables used for ATP. 2.2 SOFTWARE CONFIGURATION To properly support ATP 4.0 on the 13xx system, the BOSS operating system must be properly configured for all serial ports using ATP. The serial ports to be used for ATP may be configured as standard VDT or as an SPE terminal with the following options. TYP OAIEXLIN DEL SPE VNYYY255 100 Option O: Output Type (V/N): V Option A: Auto CR/LF (Y/N): N Option I: Input Parity Disable (Y/N): Y Option E: Echo Suppression (Y/N): Y Option X: X-ON/X-OFF Disable (Y/N): Y Option LIN: Line Length (1-255): 255 Option DEL: Delay in Milliseconds (1-255): 100 Input buffering on the 13xx system must be set to 255 otherwise program modification may be required (depending on the particular system configuration) in order to avoid input buffer overflow. 2.3 LOADING INSTRUCTIONS Load the ATP programs from tape to disk by running the *MTC utilities and executing the predefined RESTALL procedures. o RUN "**" o Choose option 6, TAPE utilities. o In the MAGNETIC TAPE UTILITY SYSTEM menu, select option 1, EXECUTE A PROCEDURE. o Enter the procedure name, RESTALL, to download all the ATP programs to disk. o Enter the tape device name where the ATP tape is located (i.e., C0, R0 etc.). o Place tape into drive and press CR to continue. The system should display the appropriate information. TAPE-SET NAME: ITP4.0 TAPE-ID NAME: ITP4.0 To commence the procedures execute the following commands. o START 128 to allocate sufficient memory. o RUN "BQR" to set up filelists for ATP. o RUN "ATP" to either define, modify, save an auto prompt or run the asynchronous transport. SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg005 Refer to the ITP User Guide, M6354D for detailed operational instructions. 3.0 SYSTEM 1500 INSTALLATION Version 6.3A is the minimum software level required for the 1500. No public key is required on the 1500 systems to access any of the level 4 features. The scheduler and line turnaround are supported on this release without requiring any revenue protection. MBF distributes the ATP software on the 1500 on a 5-1/4 inch floppy diskette. The following programs are on the floppy. ARP ATP1 ATPTIM BQR BQR3 ATDIAL ATPSC1 ATPTM1 BQR1 BQR4 ATP ATPSC2 ATRCV BQR1A ATP0 ATPSCH ATXMT BQR2 FLAGIT The index file "*EXCEPT*" is also included. ATP runs on either the COM1 port of the parallel/serial adapter board or any port of the multi-port controller. Modem control signals are supplied by COM1 and P1 of the multi-port controller ONLY. 3.1 HARDWARE CONFIGURATION The parallel/serial adapter board and the multi-port controller board provide the serial ports required for proper ATP operation between directly-connected systems. If any configuration requires a modem connection, ONLY the COM1 port of the parallel/serial adapter board or the P1 port (first port of the remote panel box) of the multi-port controller board support all the necessary modem signals. For detailed illustrations refer to the recommended documentation. o MAI 1500 6.3A SOFTWARE ANNOUNCEMENT No. 147 04/07/87 Section 5.2.2 Serial/Parallel Port Controller, pp. 45-46 Section 5.2.5 Multi-Port Board, pp. 46-48 Section 5.3 Cabling, pp. 49-53 o MAI 1500 SERVICE MANUAL M8105B Section 2.3.1.2 Installing the Serial/Parallel Board, pp. 2-21 through 2-24 Section 3.4 Serial/Parallel Adapter, pp. 3-15 through 3-33 Appendix A BOSS Multi-Port Board o MAI 1500 INSTALLATION GUIDE M8109 Preparing the Serial/Parallel Board for Installation, pp. 2-23 through 2-26 Appendix A BOSS Multi-Port Board Refer to Section 7.0 CABLE SUPPORT for a description of cables used for ATP. 3.1.1 SERIAL/PARALLEL ADAPTER BOARD The jumper block at location 2E must be set to COM1 by placing the open connections of the block away from the cable connector side of the board. Normally the first board configured as COM1 will also configure SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg006 the parallel printer port as LPT1 defined by the jumper block at. location 2D (same jumper orientation as COM1). 3.1.2 MULTI-PORT CONTROLLER BOARD The multi-port controller board may function in either a 4, 6 or 8 port configuration depending on the PAL, the UARTs installed and the BOSS operating system configuration of 6, 8 or 10 user version. Switch SW1 sets the addressing for the board. _ _ 1 2 3 4 5 6 7 8 off on off off off off on on Switch SW2 controls the number of ports available to the system. Function SW2 _ 1 2 3 4 4 Way on on on on 6 Way off off on on 8 Way off off off off 3.2 SOFTWARE CONFIGURATION The ports running ATP must be set up properly to transmit in 8-bit transparent mode. This is accomplished by running the configuration utilities. Modify the terminal port supporting ATP communications by selecting the *NPSD BASIC configurator utility at the BOSS main menu. o Select the system disk for the configuration source (normally the hard disk). o Select the serial ports as the configuration type. o Enter the individual port to modify. o DO NOT delete the entry. o Specify the device code (i.e., T1, T2, etc.). Defaults are normally supplied by application. o Enter the baud rate to be used for communications. Both systems must run at the same speed in order to function properly. o Specify NO PARITY, 8 data bits and 1 stop bit. o Auto-start must be set to NO. o Press CR to return to the Configurator main menu. o Enter "Y" in order to save all the changes to the port parameters. For each of the ports modified above for ATP, the corresponding terminal/model code configuration must be modified. Select *NPSD SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg007 for the Basic Configurator Utility. o Start by choosing option 6 at the main configuration menu to select the terminal tables option. o Modify the terminal/model code configuration by choosing option 2. o Enter the terminal ID modified above (i.e., T1,T2 etc.). o DO NOT delete the entry. o Enter COMM for the model code name. o At option number 22, ENTER TERMINAL ID, enter "END" in order to exit the routine. o At the prompt line, SELECT OPTION (1 OR 2), enter "END" in order to exit the routine. o At the ENTER NUMBER OF CONFIGURATION TYPE prompt, enter "Y" to save all the current changes. Finally in order to ensure the proper translation tables are used specifically for ATP, the terminal tables must be modified. Re-enter the Basic Configurator. o Select option 6 to specify the Terminal Tables at the configuration type. o Select option 1 in order to modify the terminal tables. o Choose "M" to modify the tables. o Specify COMM for the specific terminal table to be modified. o Press the carriage return key until option 19 is displayed on the screen. Enter "LF" for the mnemonic code. o Enter NULL for the code to be transmitted. DO NOT use the character $00$. o Proceed to option 19 again by pressing the carriage return key several times. o Enter END to exit the routine o Save the new terminal table by entering "Y". o DO NOT modify any other terminal tables in order to exit routine.. o Enter "Y" to the ENTER NUMBER OF CONFIGURATION TYPE prompt in order to save all the changes. 3.3 LOADING INSTRUCTIONS Begin by recognizing the floppy on the system. o Place the ITP floppy in the floppy drive. o Enable the drive by using the *UPSD utility in the main BOSS menu. o Switch floppy diskettes by entering "CR" to the prompt. SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg008 o Enter "CR" to the INSERT DISKETTE prompt. o Status of menu should display F0 as ITP (assuming the first floppy drive is used for the ITP diskette). Copy the programs and files to the designated drive. (Transferring the ITP programs is not a requirement for operation. The ITP programs may be run directly from the floppy after enabling the drive.) o Choose the *SPSD utility in the main BOSS menu. o Designate the "FROM DISC #" as the source floppy containing ATP and the destination partition as the "TO DISC #". o Specifiy "A" to the TYPE prompt. o REPLACE existing files. o Enter "@" for all files. Dismount the floppy when all files have been copied by disabling the drive through the *UPSD utility. o Enter "CR" to switch floppy diskettes prompt. o Remove the diskette from the floppy drive. o Enter "CR" to the INSERT DISKETTE prompt. o A message is displayed when the floppy drive is disabled. Enter the BASIC environment by exiting the BOSS main menu system (press "CR") in order to execute any of the ITP programs. o RUN "BQR" creates filelists used by the ATP application. o RUN "ATP" sets the communication parameters and starts the session.. The parameters may be saved in an autoprompt for later use. o RUN "ATPTIM" sets up the scheduler parameters. This is required before the scheduler can start. o RUN "ATPSCH" begins the scheduler procedures and waits for its predetermined time and date to begin the communications session. Refer to the ITP user's manual for detailed operational instructions.. 4.0 SYSTEM 1800 INSTALLATION To properly support ATP 4.0 on the 1800 system, the minimum level operating system must be BOSS/IX 7.2N. A public key is required in order to access the autodialer, scheduler and line turnaround. The 1800 runs on the BOSS/IX operating system. MBF distributes one 5-1/4 inch flopppy diskette or a 1/4 inch MCS tape comprising the ITP package on the 1800 system. The media contains the following programs and files. /etc/level/ITP SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg009 /util/ARP /util/ATP1 /util/ATPTIM /util/ATDIAL /util/ATPSC1 /util/ATPTM1 /util/ATP /util/ATPSC2 /util/ATRCV /util/ATP0 /util/ATPSCH /util/ATXMT /util/BQR /util/BQR3 /util/CNVTR /util/BQR1 /util/BQR4 /util/CNVTR2 /util/BQR1A /util/BQRLOG /util/CNVTR3 /util/BQR2 /util/BQRS /util/FLAGIT ATP supports any terminal port supplied by the system. This includes the serial port on the serial/parallel adapter board and any of the serial ports from the Intellegent Serial Controller (Eight-way). 4.1 HARDWARE CONFIGURATION The Parallel/Serial adapter board and the Intellegent Serial Controller (Eight-Way board) provide the serial ports required for proper ATP operation between directly connected and modem connected systems. __________________________________________________________________ . NOTE: The ITC configures properly only on the 1800 system. Use of the 1500 multiport controller board will cause unpredictable results. __________________________________________________________________ . Refer to Section 7.0 CABLE SUPPORT for a description of cables used for ATP. 4.1.1 SERIAL/PARALLEL ADAPTER BOARD The jumper block at location 2E must be set to COM1 by placing the open connections of the block away from the cable connector side of the board. Normally the first board configured as COM1 will also configure the parallel printer port as LPT1 defined by the jumper block at. location 2D (same jumper orientation as COM1). 4.1.2 Intellegent Serial Controller (Eight-Way Board) Up to 2 Eight-ways may be placed into service in the 1800. The first addresses SW1 with 6 and 8 on. The second addresses SW1 with 6 on. All other switch possitions are off. 4.2 SOFTWARE CONFIGURATION Configure the serial port according to the following specifications. 1. Device type: terminal 2. Terminal type: other 3. Device name: /dev/ttx 4. Start process: 5. Comment: 6. Input baud rate: xxxx 7. Output baud rate: xxxx 8. Parity: none 9. Stop bits: 1 10. Character length: 8 11. Protocol: no protocol 12. Input translation file: no translation 13. Output translation file: no translation Where /dev/ttx is the logical terminal ID such as tty1, start process is blank, the input and output baud rate should be the same and agree with the remote system. SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg010 ____________________________________________________________________. Warning: DO NOT configure option 11, protocol, for modem control. For modem hardware connections, modems will function properly with "no protocol". ____________________________________________________________________. In order to modify the ports as described either run "configure" at the system prompt or use the menu options as follows. o In single user mode type "menu" at the system prompt "admin>". o Choose utility programs, option 1. o Choose system, option 8. o Select the port configuration, option 2. o Press carriage return to the WARNING message, "This program should be executed ONLY in single user mode". o Modify the parameters accordingly. o Save the paramters and exit the utility. o Go into multi-user mode. 4.3 LOADING INSTRUCTIONS For the floppy media, place the floppy labelled BASE 8 of 11 into the system drive. o install /dev/fd0 ITP For the 1/4 inch tape media follow the instructions below. o install cs ITP Install the public key by running the following command to enable autodialing, scheduling and line turnaround. o install_key /etc/level/ITP The ATP utilities cannot be accessed through the main system utilities. The programs need to be started manually. o basic o START 128 o RUN "/util/BQR" Creates filelists used by the ATP application. o RUN "/util/ATP" Sets the communication parameters and starts the session. The parameters may be saved in an autoprompt for later use. o RUN "/util/ATPTIM" Sets up the scheduler with autoprompts created in the ATP program and associated start times. This is required before the scheduler can start. SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg011 o RUN "/util/ATPSCH" begins the scheduler procedures and waits for its. predetermined time and date to begin the communications session. Refer to the ITP User Guide, M6354D, manual for detailed operational instructions. 5.0 SYSTEM 2000/3000 INSTALLATION The 2000/3000 system platform requires minimum O/S Level 7.3A BOSS/IX. A public key is required in order to access line turnaround, autodialer and. scheduler utilities. MBF distributes the EIT package on 1/4 inch MCS tape, 1/2 inch tape and 5- 1/4 inch floppies. This package includes the transport interface for MCS, FTF, ATP, 27xx/37xx. The BQR and ATP utilities are also included. The following programs and files are found on the EIT tape (the MCS related routines are not listed here). /etc/level/EIT /util/ATPTM1 /util/BQRS /util/BQRLOG /util/ARP /util/ATP /util/BQR /util/CNVTR /util/ATPSC1 /util/ATP0 /util/BQR1 /util/CNVTR2 /util/ATPSC2 /util/ATP1 /util/BQR1A /util/CNVTR3 /util/ATPSCH /util/ATDIAL /util/BQR2 /util/FLAGIT /util/ATPSET /util/ATRCV /util/BQR3 /util/FTFIT /util/ATPTIM /util/ATXMT /util/BQR4 /util/FTFITE Installing ATP 4.0 software will overwrite any information defined in a previous level of ATP except for skema files which are no longer used. No special memory requirements are necessary. ATP supports any terminal port supplied by the system. This includes CMB serial port B, the 4 way serial ports and the 8 way serial ports (3000 only). 5.1 HARDWARE CONFIGURATION The CMB, 4 WAY and 8 WAY controllers may be strapped for either terminal or modem control. If modems are used, then the port MUST be properly strapped for modem and the proper cable must be used. Only the 3000 hardware supports the 8 WAY controller. 5.1.1 CMB (2000) PN 903441-001 This CMB PCBA uses jumpers and pins in order to configure the. mode of the port. This is the first generation board available for the 2000. The correct strapping for CMB port B as a modem follows. o JMP B: 1-2, 3-4, 7-8, 9-10, 13-14, 15-16 o JMP G: 15-16, 17-18, 19-20, 23-24 o JMP H: 1-2 o JMP K: 1-2 The correct strapping for CMB port B as a terminal follows. SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg012 o JMP B: 1-3, 2-4, 5-6, 7-9, 8-10, 13-15, 14-16, 19-20 o JMP G: 15-16, 17-18, 23-24 o JMP H: 1-2 o JMP K: 1-2 5.1.2 CMB (2000) PN 903441-002 This particular revision level of the CMB board uses resistor packs to control the port characteristics. The orientation of the pack on its socket determines whether modem or terminal characteristics are implemented. The correct strapping for CMB port B as a modem requires the following strapping. o Pin 1 of the zero-ohm-pack must be placed into pin 1 of socket B. o Pin 1 of the zero-ohm-pack must be placed into pin 1 of socket K. o Sockets G and H contain nothing. The correct strapping for CMB port B as a terminal requires the following strapping. o Pin 9 of the zero-ohm-pack must be placed into pin 1 of socket B. o Pin 1 of the zero-ohm-pack must be placed into pin 1 of socket K. o Sockets G and H contain nothing. 5.1.3 CMB (3000) The following board also is used only on the 3000 hardware. It also uses resistor packs to configure the serial ports. The correct strapping for CMB port B as a modem requires the following configuration. o Pin 1 of the zero-ohm-pack must be placed into pin 1 of socket 26B. o Pin 1 of the zero-ohm-pack must be placed into pin 1 of socket 29C. o Socket 29B contains nothing. The correct strapping for CMB port B as a terminal requires the following configuration. o Pin 1 of the zero-ohm-pack must be placed into pin 1 of socket 26B. o Pin 1 of the zero-ohm-pack must be placed into pin 9 of socket 29C. SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg013 o Socket 29B contains nothing. 5.1.4 FOUR WAY CONTROLLER PN 903390-001 (PCB 904741) Any of the ports of the 4 Way controller may be strapped as a modem by setting the PGM jumpers for a particular port. PGM1 refers to port 1. o PGMx: 1-2, 3-4, 7-8, 9-10, 13-14, 15-16 The PGM jumpers may also be strapped for a terminal. o PGMx: 1-7, 2-8, 3-4, 9-10, 13-15, 14-16 5.1.5 FOUR WAY CONTROLLER PN 903390-001 (PCB 904943) Any of the ports of the 4 Way controller may be strapped as a modem by setting the PGM jumpers for a particular port. PGM1 refers to port 1. o PGMx: 1-2, 3-4, 9-10, 11-12, 13-14, 15-16 The PGM jumpers may also be strapped for a terminal. o PGMx: 1-3, 2-4, 9-11, 10-12, 13-15, 14-16 5.1.6 EIGHT WAY CONTROLLER (3000) Any of the ports on the 8 Way controller may be set up as a modem port. Modify the PGM jumpers for a particular port. PGM1 refers to port 1. o PGMx: 1-2, 3-4, 5-6, 7-8, 9-10, 11-12, 13-14, 15-16 To modify the port for terminal support change the jumpers. o PGMx: 1-3, 2-4, 5-6, 7-8, 9-11, 10-12, 13-15, 14-16 5.2 SOFTWARE CONFIGURATION Configure the serial port according to the following specifications. 1. Device type: terminal 2. Terminal type: other 3. Device name: /dev/ttx 4. Start process: 5. Comment: 6. Input baud rate: xxxx 7. Output baud rate: xxxx 8. Parity: none 9. Stop bits: 1 10. Character length: 8 11. Protocol: no protocol 12. Input translation file: no translation 13. Output translation file: no translation Where /dev/ttx is the logical terminal ID such as tty1, start process is blank, the input and output baud rate should be the same and agree with the remote system. _____________________________________________________________________ Warning: DO NOT configure option 11, protocol, for modem control. For modem hardware connections, modems will function properly with "no protocol". _____________________________________________________________________ SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg014 In order to modify the ports as described either run "configure" at the system prompt or use the menu options as follows. o In single user mode, type "menu" at the system prompt "admin>". o Choose utility programs, option 1. o Choose system, option 8. o Select the port configuration, option 2. o Press carriage return to the WARNING message, "This program should be executed ONLY in single user mode". o Modify the parameters accordingly. o Save and exit the utility. o Go into multi-user mode. 5.3 LOADING INSTRUCTIONS Load the ATP programs from tape to disk by running the install procedures. o For 1/4 inch MCS tape execute "install cs EIT". o For 1/2 inch tape execute "install ts EIT". Load the ATP programs from floppy to disk by running the install procedures. o Execute "install fd0 EIT". Install the public key using the following command in order to enable autodialing, scheduling and line turnaround. o install_key /etc/level/EIT Run the ATP applications by executing the menu command. This will start the systems main menu application where ATP communications may be accessed through option 9, the Intersystem Transfer option. The autoscheduler cannot be accessed through the menu. Alternately, the programs may be started manually. o basic o START 128 o RUN "/util/BQR" creates filelists used by the ATP application. o RUN "/util/ATP" sets the communication parameters and starts the session. The parameters may be saved in an autoprompt for later use. o RUN "/util/ATPTIM" sets up the scheduler parameters. This is required before the scheduler can start. o RUN "/util/ATPSCH" begins the scheduler procedures and waits for its predetermined time and date to begin the communications session. SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg015 Refer to the ITP user's manual for detailed operational instructions.. 6.0 SYSTEM MPx INSTALLATION The MPx family of systems includes the 7000, 7100, 8000, 9000, 9100 and 9500. The minimum O/S level must be 8.6B/9.6B BOSS/VS. A public key is required in order to access line turnaround, autodialer and scheduler utilities. ATP 4.0 software is distributed on the 8.6B/9.6B O/S tape. The following lists the ATP 4.0 programs and files. .ARP .ATPSC1 .ATPTM1 .ATDIAL .ATPSC2 .ATRCV .ATP .ATPSCH .ATXMT .ATP0 .ATPTIM .INSTALLATP .ATP1 Any of the serial ports on the 4 way (MCS controller), 8 way or 16 way support the proper controls for ATP. The 4 way does NOT provide modem signals and MUST not connect to a modem device. 6.1 HARDWARE CONFIGURATION Properly address the serial port controllers as ISDC devices. Refer to MPx service manuals for detailed instructions. 6.2 SOFTWARE CONFIGURATION The serial ports used for ATP must be set for transparent 8-bit data transmission. Configure the port properly through the TERM.CONFIG utility. o Update the TERM.CONFIG configuration, option 1. o Use the primary configuration file. o Specify the controller number of the port to be used. The system prompts for SHARED MEMORY CONTROLLER NUMBER. o Specify ISDC as the controller device type. o Configure the ATP port (LINE NUMBER as described by the utility) for ASYNC line device. o Define or SPE/MODEM for the line type. o Specify the baud rate for that port. o Line parity must be set to NONE in order to be compatible with other. ATP remote ports. o Set the BITS/CHARACTER to 8. o Set the STOP BITS to 1. At the ENTRIES CORRECT prompt, enter "X" to access the extended options menu. o Configure CR ON LF for "N". SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg016 o Configure X/ON-X/OFF for "N". o Configure DELIMITER for "8A". At the LINE NUMBER prompt, exit the utility by pressing MB-IV key and save the new configuration. Reboot the system in order to implement the new parameters. 6.3 LOADING INSTRUCTIONS The normal installation process of the O/S will restore the ATP modules to the ().R6Bxx.SYS. node. Refer to the 8.6B/9.6B Software Announcement for installation instructions. Install the key by running the INSTALLATP program in BASIC. This program sets security to enable autodialing, scheduling and line turnaround. The ATP applications may be run as long as the .R6Bxx. prefix has been set for the user. o RUN "BQR" creates filelists used by the ATP application. o RUN "ATP" sets the communication parameters and starts the session.. The parameters may be saved in an autoprompt for later use. o RUN "ATPTIM" sets up the scheduler parameters. This is required before the scheduler can start. o RUN "ATPSCH" begins the scheduler procedures and waits for its predetermined time and date to begin the communications session. Refer to the ITP User Guide, M6354D, detailed operational instructions. 7.0 CABLE SUPPORT 7.1 Direct connection (without using a modem) For direct connection support (i.e. connections not using modems) a female to female adapter cable that swaps pins 2 and 3 is sufficient support communications between two systems. The standard CCA to terminal cables connect directly to the adapter. 3 ------ 2 2 ------ 3 7 ------ 7 20 ------ 20 7.2 Modem connections 2000, 2500, 3000, & 4000 systems For Modem configurations, each pin from the serial port is supplied . to the modem without any changes. No pins are swapped. A ribbon cable is the best example attaching the appropriate connectors to the cable to support the required configuration. 1 ------ 1 2 ------ 2 3 ------ 3 4 ------ 4 SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg017 25 ------ 25 A minimum cable configuration may be supplied by the following. 2 ------ 2 3 ------ 3 7 ------ 7 20 ------ 20 The minimum cable configuration does not supply all the signals that may be required for connections to a modem. 7.3 Modem connections on 13xx, 1500, 1800, & MPx systems A standard modem cable for the appropriate system MUST be used with pins 2 & 3 swapped. 8.0 MODEM SUPPORT The following lists the modems certified by MAI Basic Four for use with ATP 4.0. o UDS 224 A/D - See notes 1, 2, 3 o UDS 212A, UDS 212 A/D - See note 2 o UDS FASTTALK "Hayes compatible" - See notes 2, 3. Note 1 applicable to FASTTALK 1200. o HAYES SM2400 "Smartmodem" - See notes 2, 3. NOTE 1: Modem configuration set via switch settings, manual operation. NOTE 2: Modems will function in auto-answer mode (receive incoming calls). NOTE 3: ATP 4.0 autodialer supports commands for this modem (generate and. initiate outgoing calls). 9.0 PROBLEMS AND WORKAROUNDS This section describes outstanding problems within the ATP package that a user may encounter. Where possible, solutions or workarounds are provided.. __________________________________________________________________________. Please read the problems and workarounds before proceeding with the use of ATP. This will help in alleviating lost time due to already known problems. __________________________________________________________________________. 9.1 ALL SYSTEMS Problem - Using a HAYES or compatible modem with autodial may not re-dial properly. If the first attempt at dialing produces no answer, the second re-dial may occur prior to the phone line supplying the dial tone. The phone line will only recognize those digits that are passed at the time after the presence of the dial tone. Workaround - None SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg018 Problem - The message, AUTOPROMPT FILE LOCKED..., displays on one or more terminals running ATP. Workaround - Starting the terminals simultaneously with ATP locks up one or more terminals. If concurrent ATP tasks are required, stagger the start of each ATP task to prevent task contention of the autoprompt file. Problem - Restarting autoprompt tasks does not process according to date and time. Workaround - None. If a task file contains unprocessed autoprompts using TIMER mode, starting the task through the RESTART option processes the outstanding autoprompts immediately. If the transmission of an autoprompt causes the sub- sequent scheduled autoprompts to become past due (i.e., the end of the first autoprompt occurs AFTER the specified date and time of the next scheduled transmission), the application will process the outstanding autoprompts immediately following the transmission in progress, regardless of the specified date or time. 9.2 SYSTEM 13xx - None 9.3 SYSTEM 1500 o Problem - Incoming data to the system always converts the high-order bit regardless if the data originated from another 1500 system. Workaround - Install ATP on DISK 1 in order to allow proper conversion of incoming data. o Problem - Invalid file type error occurs with the message "skipping file". The 1500 system cannot receive a serial file or a string file. Workaround - Do not send serial or string files to the 1500. The 1500 operating system does not support those file types. o Problem - 1500 performs conversion properly between one set of systems but not the other (i.e., data from 1800/2000/3000 converts properly but not from the MPx, or vice-versa). Workaround - The COMM terminal table contains $00$ for the mnemonic 'LF' character. It must be replaced by the word NULL. See the installation instructions. 9.4 SYSTEM 1800 o Problem - The file /etc/level/ATP no longer required. Workaround - Delete the file /etc/level/ATP. The new file used by the application is /etc/level/ITP. o Problem - Running ATP reports the error IMPROPER ACCESS CODE - PLEASE CALL YOUR SYSTEM SUPERVISOR; MAKE ENTRY TO TERMINATE. Workaround - The public key is not installed to allow SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg019 line-turnaround, autodial and scheduler. Install public key with the "install_key /etc/level/ITP" command. o Problem - Real time clock not stable on BOSS/IX release. Time lost at each end of the day (as much as 5 min/day). Workaround - None currently available. Be very careful when scheduling transfers through ATPTIM and ATPSCH. Reset the clock before beginning transmission if timing is a very big concern when communicating with other systems. 9.5 SYSTEM 2000/3000 o Problem - The file /etc/level/ATP is no longer requried. Workaround - Delete the file /etc/level/ATP. The new file used by the application is /etc/level/EIT. o Problem - Running ATP reports the error ACCESS CODE CANNOT BE VERIFIED. PLEASE CALL YOUR SYSTEM SUPERVISOR; MAKE ENTRY TO TERMINATE. Workaround - Public key is not installed to allow line turnaround, autodial and scheduler. Install public key with the "install_key /etc/level/EIT" command. o Problem - CRC framing error message appears during system boot for the port to be used for ATP. This port connects to a powered-on HAYES modem. Workaround - None. However, the message does not affect the functionality of ATP. 9.6 SYSTEM MPx o Problem - Running ATP reports the error ().R6xxx.SYS.ETC.LEVEL.ATP FILE IS UNDEFINED; ACCESS CODE CANNOT BE VERIFIED. PLEASE CALL YOUR SYSTEM SUPERVISOR; MAKE ENTRY TO TERMINATE. Workaround - Public key is not installed to allow line turnaround, autodial and scheduler. Install key with the INSTALLATP BASIC program. o Problem - Invalid file type error occurs with a message "skipping file". MPx systems do not support string files. Workaround - Do not transmit string file to MPx systems. 10.0 DOCUMENTATION The following includes all the information and procedures required to run any of the applications for transmitting information between systems. o MAI Intersystem Transport Package User Guide M6354D - May 1987 ORIGINATOR: MBF SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB004 Pg020 FIB 00005 07/27/89 *** Data Transfer Problems with ATP 4.0 - DS1500 [ WPSF 549 ] *** PROBLEM: ATP 4.0 on the MAI 1500 is not transporting data properly between my other MBF systems. It looks as though its working, but the transferred data is corrupted. CAUSE: ATP 4.0 was not installed onto directory 1 of 'H0'. SOLUTION: Install ATP onto directory 1 of 'H0'. 1. Select option "8. *ESPD - ERASE PROGRAMS /FILES" and erase all ATP programs and data files from directory 0 on 'H0'. - Enter '0' for DISK ID: - Enter 'ATP@' for file names to erase. 2. Select option "3. *4PSD - ADD/CHANGE DIRECTORY NAME" from the name utility menu and create a new directory. You can use any name except for "ATP". 3. Select option "13. *JPSD - SELECT DIST ENVIRONMENT" and add this name to directory 1 of 'H0'. Enter disk '1' for the disk number to change and then select your new directory name. 4. Select option "22. *SPSD - TRANSFER PROGRAMS/FILES" and transfer . your ATP 4.0 programs into your new directory. ORIGINATOR: T. Tiangco SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB005 Pg001 FIB 00006 11/22/89 *** ATP 4.0 Corrupting String Files on 7.5B [ WPSF 564 ] *** PROBLEM: String files which contain nonprintable characters get corrupted when using ATP. This will usually show up when running ATP from SPx to SPx and may occur between SPx to MPx systems. MPx systems do not support string files. CAUSE: Currently ATP uses a "READ" and "WRITE" in the pro- cess of file transfer. This will result in the re- ceiving file being corrupted if the string file sent contained non-printable characters. WORKAROUND: Two ATP program files should be modified. The "READ" and "WRITE" directives are to change to "READ RECORD" and "WRITE RECORD". Change the statements to appear as follows: 1. LOAD "ARP" 4205 IF<>7 THEN GOTO 4210 ELSE LET R9=0; IF S1=1 4205:THEN WRITE RECORD(6,TBL=6900,ERR=4500) R0$ 4205:(3,S9-2) ELSE WRITE RECORD(6,ERR=4500) R0$ 4205:(3,S9-2) SAVE 2. LOAD "ATP1" 5135 IF F4=7 THEN LET R9=0; READ RECORD(6,ERR= 5135:6000,END=5700) X9$; GOTO 5150 SAVE ORIGINATOR: Frank Csete SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB006 Pg001 FIB 00007 06/19/91 *** BASIC programs corrupted transferring from GPx to SPx [ WPSF 718 ] *** Author: Frank C. Csete BOSS/IX/VX ATP iles Type: Problem Notify the field of a problem with ATP corrupting BASIC program files. This problem is limited to ATP transfers from GPx systems to SPx systems. Error 20s, syntax errors, will be observed after an ATP transfer of BASIC program files from a GPx to an SPx system. The release levels effected are all those prior to 7.5B*22. The BASIC programs transferred to an SPx system may have spaces removed by ATP during the transfer causing the program listing to be corrupted, i.e. "GOTO999" instead of "GOTO 999". Error 20s result when the program is recompiled on the SPx system. Make the following changes to the ATP program "ARP" on the SPx system only: 1. Enter BASIC and load programs: ADMIN>basic s=256 >Load "/util/ARP" 2. Change the following lines as indicated: 2380 SERIAL F3$,N7,R7,0,0,ERR=2480; GOTO 2425 ------ --------- 2530 IF F4=4 OR F4=1 THEN LOCK (6,ERR=2550) ------------ 4070 ON F4 GOTO 4100,4180,4250,4310,4180,4180,2430,4180,2430 ---- 5020 MAKE PROGRAM F3$,F4$,ERR=5023 ----------------------------- 3. Delete the following lines: 4440,4450,5004 4. Save the changes. ORIGINATOR: Frank Csete SOFTWARE-BASIC FOUR-ATP INTERSYSTEM-----------------FIB007 Pg001