Red Book for AIX Release 7.0 and 8.
Legal Notices © 2006 Intuit Inc. All rights reserved. Unauthorized reproduction is a violation of applicable laws. Intuit and the Intuit logo are registered trademarks and/or registered service marks of Intuit Inc. in the United States and other countries. Intuit Eclipse is a trademark and/or service mark of Intuit Inc. All other trademarks or service marks are the property of their respective owners and should be treated as such. Intuit® Eclipse™ 7.0 and 8.
Table Of Contents Chapter 1: Intuit Eclipse Support Introduction ........................................................................ 1 Systems ....................................................................................................................................... 1 Applications ................................................................................................................................ 1 Intuit Eclipse Phone Numbers .....................................................
Red Book for AIX Performing System and Data Backups ......................................................................................... 15 Backing Up the Operating System............................................................................................ 15 Backing Up Eclipse Data .......................................................................................................... 15 Cleaning Backup Tape Devices .............................................................................
Table Of Contents Installing and Using Eterm for DOS and Dumb Terminals...................................................... 41 Installing Eterm for Windows....................................................................................................... 42 Un-Installing Eterm from Windows ............................................................................................. 43 Configuring Eterm for Windows ........................................................................................
Red Book for AIX Using a Serial Connection ............................................................................................................ 69 Configuring DOS for Eterm for a Modem Connection ................................................................ 70 Using a Modem Connection ......................................................................................................... 72 Minimum Configuration for Eterm for DOS ..................................................................
Table Of Contents Setting Up Ethernet Printers in Release 8................................................................................... 100 Configuring Extended Systems (ESI) Devices ........................................................................... 106 Configuring an ESI Device from Windows Using ExtendView for TCP/IP.......................... 106 Configuring an ESI Device from AIX-Unix...........................................................................
Red Book for AIX Chapter 10: Online Glossaries................................................................................................. 139 Basic Glossaries ...................................................................................................................... 139 Advanced Glossaries............................................................................................................... 139 Search Engines...........................................................................
Chapter 1: Intuit Eclipse Support Introduction The goal of Intuit Eclipse Support is to provide quality customer service in an effective, efficient manner. Our primary focus is the support of the Eclipse core application, while also attempting to meet other computing needs of our client base. In keeping up with rapidly changing computing environments, we are constantly re-evaluating and adding to our support staff.
Red Book for AIX Rel. 7.0 and 8.0 Intuit Eclipse Phone Numbers Your monthly maintenance fee provides weekday 8AM to 5PM coverage in your local time zone. We provide after-hours, published holiday, and weekend emergency and system services for an additional fee. To receive emergency support, call the regular Intuit Eclipse Support number (508-778-9151) and follow the instructions of the after-hours automated attendant. When leaving a message, provide the following information: • Your name.
Rel. 7.0 and 8.0 Red Book for AIX Intuit Eclipse Support Hours and Service Intuit Eclipse offers extensive support hours and services. Charges for these services keep Intuit Eclipse competitive and allow us to continue providing quality support to our clients. Support Policy During Normal Business Hours Your support contract with Intuit Eclipse provides customer support Monday through Friday, from 8:00 AM to 5:00 PM, in your local time zone. Note: Refer to the Customer Support web site at http://www.
Red Book for AIX Rel. 7.0 and 8.0 If you suspect that you have a hardware problem, call Intuit Eclipse System Support immediately. Do not call IBM. When you call, give us a description of the problem and your hardware model type and serial number. We will contact IBM and arrange an on-site visit, if necessary. Important: We want the opportunity to work with the IBM representative on site so there is no confusion about the configuration of your system.
Rel. 7.0 and 8.0 Red Book for AIX AIX & UniVerse Software Upgrades and Services On occasion, IBM charges for upgrades and services to the following software: • AIX operating system software. • UniVerse database software. Intuit Eclipse passes IBM's charges on to our customers. Implementation of the upgrades, if done during normal business hours, is covered by your Support contract. After-hours charges might apply to scheduled after-hours upgrades.
Red Book for AIX Rel. 7.0 and 8.0 Intuit Eclipse Education Services Contact Educational Services at 508-778-9151 or log onto the support web site at http://www.eclipse.intuit.com/support/. You will need a login ID and password. If you do not have one, call your account manager or the Educational Services Department to obtain one. The Eclipse University Home page provides all detailed information regarding Internet training, classroom training, and special Web Based Events offerings.
Rel. 7.0 and 8.0 Red Book for AIX Computer Based Training Intuit Eclipse offers computer based training (CBT) modules in the following key areas: • Sales order entry. • Accounts receivable. • Accounts payable. These training modules allow users to learn at their own pace. Note: Intuit Eclipse is currently updating the CBT modules, which will be available for purchase in April of 2006. © 2006 Intuit Inc. All rights reserved.
Red Book for AIX 8 Rel. 7.0 and 8.0 © 2006 Intuit Inc. All rights reserved.
Rel. 7.0 and 8.0 Red Book for AIX Chapter 2: Site Accountability Your site is responsible for administering the hardware and software components of the Eclipse system with help from Eclipse Support. For us to be able to help, you must have a telephone in the location of your hardware. Further, we ask that you keep this manual, all reference and installation CDs, and authorizations readily available.
Red Book for AIX Rel. 7.0 and 8.0 Minimum Hardware Requirements We recommend that the system administrator keep an updated site map, and label all cables, ports, and devices. Contact Intuit Eclipse System Support to familiarize yourself with the system’s hardware. Following are the minimum hardware requirements for running the Eclipse system.
Rel. 7.0 and 8.0 Red Book for AIX Diagnostic Modem In order to effectively assist you in maintaining your system, it is imperative that Intuit Eclipse Support has a dedicated modem for its exclusive use. Ecomm, Intuit Eclipse’s automated dial up application, checks your system on a daily basis for file system sizes and errors. We also use Ecomm for downloading Intuit Eclipse upgrades and fixes.
Red Book for AIX Rel. 7.0 and 8.0 Rebooting the Unix System Intuit Eclipse recommends rebooting your Unix system a minimum of once a month. Once a week is not too often! This process flushes RAM, cleans temporary files, selects lists, and removes any errant processes. The following procedures explain how to do the following: • Shut down and reboot your system in a single step. • Shut down your system without rebooting. • Reboot a previously shut down system. To shut down and reboot your system: 1.
Rel. 7.0 and 8.0 Red Book for AIX To power on your system: 1. If the console screen is black or shows the screen saver, press Enter to display the Main Menu, as shown below: MAIN MENU 1. Service Processor Setup Menu 2. System Power Control Menu 3. System Information Menu 4. Language Selection Menu 5. Call-In / Call-out Setup Menu 6. Set System Name 99. Exit from Menus > 2. At the > prompt, type 2 and press Enter to display the System Power Control Menu, as shown below: System Power Control Menu 1.
Red Book for AIX Rel. 7.0 and 8.0 Using UPS and PowerChute Software Personnel in the Intuit Eclipse Unix department install the Uninterrupted Power Supply (UPS) and PowerChute software prior to going live on the system. Use the instructions in the following procedures to do the following: • Verify that the UPS is communicating with the server. • Verify the actual process. To verify that the UPS is communicating with the server: 1.
Rel. 7.0 and 8.0 Red Book for AIX Performing System and Data Backups The system administrator is responsible for making system and data backups. This person is also responsible for maintaining the tapes and tape drives on which the backups are created. Backing Up the Operating System Back up your Operating System (OS) before making any system upgrade. It is the responsibility of the on-site system administrator to periodically create a backup of the operating system (OS).
Red Book for AIX 16 Rel. 7.0 and 8.0 © 2006 Intuit Inc. All rights reserved.
Rel. 7.0 and 8.0 Red Book for AIX Chapter 3: Disaster Preparedness The system administrator is responsible for making system and database backups. This person is also responsible for storing the backup tapes off site. In case of disaster, the system administrator can use the backup tapes to recreate the entire operating system and database. The system administrator is also responsible for maintaining the tape and tape drives on which the backups are created.
Red Book for AIX Rel. 7.0 and 8.0 Backing Up the Operating System Overview Use the "smitty mksysb" command to create a backup of the operating system before making changes to your system, such as adding users, devices, or OS upgrades. The command creates an installable image of the [root volume group] operating system either in a file or on a bootable tape. You can use this backup to reinstall a system to its original state after it has been corrupted.
Rel. 7.0 and 8.0 Red Book for AIX Creating a mksysb for AIX 4.3.x and 5.x After completing the preliminaries, you are ready to create a mksysb tape for your AIX 4.3.x or 5.x system. This can be run from the console or from Eterm while logged in as root. To create a mksysb for AIX 4.3.X and 5.X: 1. At the system console, log on to the operating system as the root user. 2.
Red Book for AIX Rel. 7.0 and 8.0 3. Use the defaults for the above settings, with the following exceptions: • Backup DEVICE or File – Access the appropriate tape drive as determined above. • Create MAP Files – Toggle this field to “yes,” unless the intent is to use this tape to load another system. As this process is instructive of disaster recovery the answer should be “yes.” • AIX v5.2 - Verify readability if tape device – If you do not wish to do a separate verify toggle to yes. • AIX v5.
Rel. 7.0 and 8.0 Red Book for AIX Verifying the mksysb Tape Verify your mksysb tape before you reboot your system. To verify the mksysb tape: 1. On the system console, return to the Unix command prompt (#) in one of the following ways: • Press F3 to step back through the previous menus. • Hold and press Ctrl-C. 2. At the command prompt (#), enter the following command: # smit lsmksysb Note: Use a lower case l in the lsmksysb command, not the number 1. 3.
Red Book for AIX Rel. 7.0 and 8.0 Backing Up the Database Overview Use the System Backup Maintenance program to back up the Eclipse software and all associated data, including UniVerse, VSI-FAX, and PowerChute to tape. The program backs up all files residing under the /u2 directory. The program creates a complete data backup, not an incremental backup of only changed data.
Rel. 7.0 and 8.0 Red Book for AIX Running the System Backup Maintenance Program Use the System Backup Maintenance program to back up your Eclipse database files. Schedule the database backup program to run nightly, during a quiet period on the server, when no order entry transactions or data changes are occurring. Your installer will help you set this up.
Red Book for AIX Rel. 7.0 and 8.0 A variance of greater than or less than the percentage entered in the System Backup Variance % control maintenance record generates a message similar to the following example: The backup started at 03:52pm on 05/25/1999 completed after 0.02 hours. 24520 blocks were backed up with a variance of 16246.67%, which is greater than the allowed variance.
Rel. 7.0 and 8.0 Red Book for AIX Setting System Backup Control Maintenance Records For the system backup program to work, the three following control maintenance records must be set. System Backup Administrator Enter the name of the user or message group, such as BACKUP, to receive the system backup messages each morning. Use a message group to send the message to more than one person. System Backup Check Time Enter the time when the system backup program confirms whether the backup was successful.
Red Book for AIX Rel. 7.0 and 8.0 Verifying Your Backup Tapes Use the Backup Table of Contents Readback function to verify that a backup of a file was successful. When a file backup is successful, the system updates the file's backup time and date in the tape's table of contents. After you load the backup tape in the drive, the function reads back the table of contents. You can then check the time and date of the last backup for the file in question.
Rel. 7.0 and 8.0 Red Book for AIX 5. When you are finished, enter Q following the colon on the screen to quit. It will take a moment to stop the process. The tape rewinds and must finish before you can exit the screen. The system displays a message when it completes the process and ejects the tape from the tape drive, which prevents someone from inadvertently writing on top of last night’s save. 6. Remove the tape from the tape drive. © 2006 Intuit Inc. All rights reserved.
Red Book for AIX Rel. 7.0 and 8.0 Backup Tape Maintenance Overview Included in your system hardware is a tape drive for making backups of your operating system and the Eclipse database. In addition to making tape backups of the operating system and the database, the system administrator is also responsible for purchasing new tapes and cleaning the tape drives.
Rel. 7.0 and 8.0 Red Book for AIX Cleaning Your Tape Drives Intuit Eclipse Support recommends cleaning your tape drive at least once a month, or more frequently if your system is located in a dusty environment. Cleaning cartridges are shipped with your hardware. Determining If Your Tape Drive Needs Cleaning The system has three ways of indicating that a tape drive needs cleaning: • The amber light on the lightning bolt symbol is flashing. • The LED on the tape drive displays the message "Clean soon.
Red Book for AIX Rel. 7.0 and 8.0 Recommended Media for Backup Tapes We recommend using the following media for backup tapes for IBM tape drives. These media are usually available from your local computer supply or office supply store, such as Office Depot or Staples. To buy name brand tapes we suggest using IBM. Half Inch Cartridge • Part number: 08L9120 (100Gb native Capacity) LTO Ultrium Data Cartridge QIC (Quarter Inch Cartridge) • Model 7207-012 (1.2Gb Capacity) 3M Magnus 1.
Rel. 7.0 and 8.0 Red Book for AIX Chapter 4: Network Administration This chapter contains information about the following subjects: • Ethernet PC connections • Troubleshooting a hung TTY port • Programming an Eclipse MultiTech Support modem © 2006 Intuit Inc. All rights reserved.
Red Book for AIX Rel. 7.0 and 8.0 Ethernet PC Connection After installing and configuring your Network Interface Card (NIC) and have a good physical connection between your computer and the hub, you need to configure the NIC for your operating system. Use one of the following procedures: • Windows 95, 98, and NT PCs. • Windows 3.11 PCs.
Rel. 7.0 and 8.0 • Red Book for AIX If your NIC is not on the device list, click on the Cancel button to return to the Control Panel. Double-click the Add New Hardware icon to start the Add New Hardware Wizard, which you can use to detect new hardware, including the NIC. After detecting and installing the NIC, reboot your PC and repeat steps 1 through 4 to check for problems. 5. In the Control Panel, double-click the Network icon to display the Network dialog box. 6.
Red Book for AIX Rel. 7.0 and 8.0 Ethernet Configuration for Windows 3.11 PCs Before starting the following procedure, have your original Windows 3.11 software on hand, and any diskettes provided by the manufacturer of your NIC, as they might be required by your computer during this setup. Note: Windows 3.1 cannot run an Ethernet environment using TCP/IP protocol. You must use Windows 3.11. To configure your network interface card for Windows 3.11: 1. Install Eterm on your Windows 3.11 PC. 2.
Rel. 7.0 and 8.0 • Red Book for AIX Click Add Adapter... to open the Add Network Adapter dialog box and do one of the following: Click Detect to make Windows automatically detect your adapter. Windows steps you through the process of finding the adapter and installing the necessary drivers. Select the appropriate adapter from the list and then click OK. Windows returns you to the Network Drivers dialog box. • Click Add Protocol... to open the Add Protocol dialog box.
Red Book for AIX Rel. 7.0 and 8.0 Troubleshooting a Hung TTY Port for AIX 4.x or 5.x If your PC loses power and you cannot reestablish the serial connection to the Eclipse system, you may have a hung TTY port. Note: Information in this document is correct to the best of our knowledge at the time of this writing. Please send feedback by fax to AIXServ Information at (512) 823-4009. Please use this information with care. IBM will not be responsible for damages of any kind resulting from its use.
Rel. 7.0 and 8.0 Red Book for AIX 3. If the tty is still unusable, detach and re-attach the cable from the hung port. AIX uses the DCD (Data Carrier Detect) signal to determine the presence of a device attached to the port. Detaching and re-attaching the cable in many cases clears hung processes. To determine the location of the port for which the tty is configured, use the following command: lsdev -Cl tty0 The third column of the output of this command indicates the address of the tty.
Red Book for AIX Rel. 7.0 and 8.0 8. If the tty is still unusable, consider moving the device, such as the terminal or modem, to another port and configuring a tty at that location until the system can be rebooted. 9. If a reboot does not clear the port, a hardware problem is indicated. To check the error report for port hardware problems, enter the following command: errpt -a | pg 38 © 2006 Intuit Inc. All rights reserved.
Rel. 7.0 and 8.0 Red Book for AIX Programming an Eclipse MultiTech Support Modem You can program an Eclipse MultiTech support modem in one of the following two ways: • While attached to your PC. • While dialing in to your RISC. To program a MultiTech modem while attached to your PC: 1. Physically connect the modem to your PC with a null modem cable. 2. From the Eterm menu bar, click Configure and select Communications to open the Eterm Configure Communications dialog box.
Red Book for AIX Rel. 7.0 and 8.0 To program a MultiTech modem while dialing in to your RISC system: 1. Dial the number of the modem you want to reprogram. If you do not connect—the modem does not answer and the call just rings—have the power cycled on the remote modem (turn the modem off and then back on) before trying again. Note: MultiTech modems need to have the “TR” light on to answer a call. 2. Type %%%at as soon as you see CONNECTED on your screen.
Rel. 7.0 and 8.0 Red Book for AIX Chapter 5: Eclipse Terminal Emulator Each Intuit Eclipse customer receives a CD-ROM containing the Intuit Eclipse terminal emulator software, Eterm for Windows. Visit our website at http://www.eclipse.intuit.com/ for the latest Eterm or Dterm for DOS. Before You Begin Before installing and configuring Eterm, make certain that your PC is set up correctly for your network. Refer to “Network Administration” for information on setting up network connections.
Red Book for AIX Rel. 7.0 and 8.0 Installing Eterm for Windows Intuit Eclipse ships the Eterm for Windows installation program on two diskettes. The installation program works for Windows 95, Windows 98, 2000, XP or Windows NT computers. To install Eterm for Windows: 1. Close all other programs before installing Eterm for Windows. 2. Insert the first Eterm for Windows diskette into your floppy drive (usually drive A:). 3. From the Windows taskbar, click Start to display the Start menu. 4.
Rel. 7.0 and 8.0 Red Book for AIX Un-Installing Eterm from Windows The program that un-installs Eterm works for Windows 95, Windows 98, 2000, XP or Windows NT computers. To un-install Eterm from Windows: 1. From the Windows taskbar, click Start to display the Start menu. 2. From the Start > Settings menu, select Control Panel to display the Control Panel window. 3. Double-click Add or Remove Programs to display the Add or Remove Programs window. 4. Double-click the Eclipse Terminal Emulator entry.
Red Book for AIX Rel. 7.0 and 8.0 Configuring Eterm for Windows The first time you run Eterm, you must enter configuration data. You can change your configuration setup at any time. This topic includes the following information: • Starting Eterm. • Configuring Eterm for an Ethernet connection. • Configuring Eterm for a Serial connection. Starting Eterm Depending on how you installed Eterm for Windows, you can run the program in the following ways: • Double-click the Eterm shortcut on your desktop.
Rel. 7.0 and 8.0 Red Book for AIX • Check that you have selected the Network - Telnet network connection. • Check that the entry in the Host box is valid. • Check the integrity of all cable connections between your computer and the host computer. • If you still encounter problems, please contact your System Administrator, or Intuit Eclipse Support.
Red Book for AIX Rel. 7.0 and 8.0 4. In the Connect String field, enter the modem commands and the host modem telephone number that you want to use to connect. For example, if the telephone number of the host system is 1-800-555-1234, you might type in ATDT18005551234. See the online instructions for more details on using the Connect String field. 5. Click OK. The modem dials the host system and attempts to connect.
Rel. 7.0 and 8.0 Red Book for AIX Minimum Configuration for Eterm for Windows The minimum configuration required for Eterm for Windows to operate correctly varies depending on how your PC is connected to the host. When Connecting Through a TCP/IP Network Connection For Eterm for Windows to operate correctly when connecting through a TCP/IP Ethernet connection, you must have the following options set: • Communications Port – In the Communications Port field, choose the Network Telnet network connection.
Red Book for AIX Rel. 7.0 and 8.0 Configuration Options for Eterm for Windows From the Eterm menu bar, click Configure to display the following configuration options: Communications Opens the Configure Communications dialog box, where you can specify how Eterm will communicate with the host system for modem, serial, and network connections. If Enable Configuration Password is selected, you must enter the correct password before being able to make changes.
Rel. 7.0 and 8.0 Red Book for AIX • Enable Edit – Select this option to click Edit from the Eterm menu bar. Clicking Edit allows you to activate the different selection, copy, and paste commands. • Select one of the following: • Auto Connect – Causes Eterm to attempt to connect with the host automatically whenever Eterm is run. Select this option, except when utilizing Auto Dial. • Auto Dial – Causes Eterm to display the Dial dialog box automatically whenever Eterm is run.
Red Book for AIX Rel. 7.0 and 8.0 Printing Opens the Configure Printing dialog box, where you can specify how Eterm processes the printer data stream for Eclipse data and screen prints. Dialing Opens the Dialing Configuration dialog box, where you can configure Eterm dialing information.
Rel. 7.0 and 8.0 Red Book for AIX Window Placement Select whether you want Eterm to remember its last location on the Windows desktop after you quit. Select from the following options: • Save current placement. • Remember last placement. • Use default placement. © 2006 Intuit Inc. All rights reserved.
Red Book for AIX Rel. 7.0 and 8.0 Additional Features for Eterm for Windows In addition to the configuration menu, Eterm contains menu options for the following additional features. Connect Click Connect to open a connection with the host system using the current configuration settings. Dial Click Dial to open the Dial dialog box, where you can select a telephone number from either the global or the local dialing directory.
Rel. 7.0 and 8.0 Red Book for AIX Debug Select the Debug menu option to toggle between the normal screen and the debugging screen. Eclipse Support Personnel use this feature to diagnose problems. Note: Select Enable Debug in the Configure Communications dialog box to use the Eterm debugging screen. Help Opens a standard Windows help file dialog box, where you can access the Eterm for Windows online help files. © 2006 Intuit Inc. All rights reserved.
Red Book for AIX Rel. 7.0 and 8.0 Troubleshooting Eterm for Windows Review the following troubleshooting issues if problems arise. Assigned User Defined Screens Box Appears When Pressing Alt Key From the Configure > Display Options menu, select Show User Defined Options to set Eterm to display the names of user-defined options associated with the current screen whenever you press the Alt key. This is the same as using Alt-F11 to show user-defined options.
Rel. 7.0 and 8.0 Red Book for AIX Line Breaks Appear in Intuit Eclipse Screens Because the Eclipse and Eclipse Bold fonts are scalable fixed width fonts, occasionally your screen will display breaks between line drawing characters. This does not affect screen prints. Messaging Will Be Disabled for This Session Eterm does not support multiple messaging configurations. You can only have messaging enabled for one Eterm session at a time.
Red Book for AIX Rel. 7.0 and 8.0 Transparent printing was originally developed under Windows 3.1.1 and subsequently used under Windows 3.1.1, Windows 95, Windows 98, and Windows NT. However, some printer drivers (often those written before the release of Windows 95) do not support transparent printing. Contact your printer manufacturer to verify that your printer drivers support transparent printing.
Rel. 7.0 and 8.0 Red Book for AIX Still Running Intuit Eclipse? If you click Disconnect in the Eterm taskbar while you are stilled logged in to Eclipse or in the process of logging in to Eclipse, Eterm prompts Still running Eclipse? and asks for confirmation. To log off properly, from the System menu select LogOff. This logs you off Eclipse and disconnects you from the host system.
Red Book for AIX Rel. 7.0 and 8.0 Eterm for DOS Overview Eterm for DOS is designed to run under the MS-DOS environment. It is meant for those PCs that either boot from a floppy diskette (dumb terminals) or that run MS-DOS from their hard drive. You need to make one copy of the Eterm for DOS diskette for each PC that boots from its floppy diskette and then modify each boot disk so that it correctly identifies the PC on your network.
Rel. 7.0 and 8.0 Red Book for AIX Copying the Eterm for DOS Diskette Before using Eterm for DOS on your computer, make copies of the original source diskettes from Intuit Eclipse. Keep these diskettes in a safe place. Only make changes to copies of the original diskettes. To copy the Eterm for DOS diskette: 1. Before continuing with this procedure, write-protect your Eterm for DOS diskette to ensure that you do not accidentally over-write your source diskette. 2.
Red Book for AIX Rel. 7.0 and 8.0 Installing Eterm for DOS with an Ethernet Connection Before using Eterm for DOS on your computer, you might need to make changes to some files on the diskettes. Make these changes to copies of the original Eterm for DOS diskettes only. This topic includes instructions for the following tasks: • Installing Eterm on computers connected to a network. • Using a network connection.
Rel. 7.0 and 8.0 Red Book for AIX 7. Save AUTOEXEC.BAT and exit the MS-DOS Editor, as follows: • Hold down the Alt key and press the letter x. The DOS Editor asks if you want to save your changes. • Press Enter to accept the default Yes to save the AUTOEXEC.BAT file. Note: Whenever making changes to a diskette, always allow the diskette drive (A) to come to a complete halt before removing the diskette. Failure to this can result in corrupted files. To make copies of the NET.
Red Book for AIX Rel. 7.0 and 8.0 8. Reboot your computer with the Eterm for DOS diskette in the floppy drive. Note: Eterm for DOS running in a DOS emulation windows under the Windows 3.1.1 and Windows 95 and Windows 98 environments cannot utilize a TCP/IP network connection. Use a serial or modem connection instead. 62 © 2006 Intuit Inc. All rights reserved.
Rel. 7.0 and 8.0 Red Book for AIX Configuring Eterm for DOS with an Ethernet Connection The first time you run Eterm, the Eterm for DOS main menu appears and you must enter configuration data. You can change your configuration setup at any time. Note: From the emulator screen, press Ctrl-Print Screen to access the main menu. The following options are available on the main menu: • Quit – Eterm for DOS. • Continue – Close the main menu and continue using Eterm for DOS.
Red Book for AIX Rel. 7.0 and 8.0 5. To enable or disable HPCL PRINTING, choose ON or OFF, respectively. • If PRINTER is set to a valid LPT port and HPCL PRINTING is set to ON, using the Shift-Print Screen key sequence causes Eterm to send line HPCL commands to the printer to draw the screen. • If PRINTER is set to a valid LPT port and HPCL PRINTING is set to OFF, using the Shift-Print Screen key sequence causes Eterm to send line-drawing characters to the printer to draw the screen.
Rel. 7.0 and 8.0 Red Book for AIX Using a Network Connection When you run Eterm for DOS using a network interface card (NIC) and connection, Eterm communicates with the host system using the current network settings. Click Connect to open an Eterm session. If Eterm for DOS is unable to connect, it displays one of the following error messages: • Host Name Invalid • Network Unavailable • Connection Refused • Connection Lost Use the Arrow keys to select an option from the menu, and press Enter.
Red Book for AIX Rel. 7.0 and 8.0 Installing Eterm for DOS with a Serial Connection If you install Eterm for DOS on serial computers, you need to do the following: • Make copies of the original source Eterm for DOS diskettes. Keep these diskettes in a safe place. Only make changes to copies of the original diskettes. • 66 Configure each computer to use a serial connection to the Host server, either by means of a direct cable connection to the TTY port, or by dialing in to the port using a modem.
Rel. 7.0 and 8.0 Red Book for AIX Configuring Eterm for DOS for a TTY Port Connection The first time you run Eterm, the Eterm for DOS main menu appears and you must enter configuration data. You can change your configuration setup at any time. Note: From the emulator screen, press Ctrl-Print Screen to access the main menu. The following options are available on the main menu: • Quit – Quit Eterm for DOS. • Continue – Close the main menu and continue using Eterm for DOS.
Red Book for AIX Rel. 7.0 and 8.0 • If PRINTER is set to a valid LPT port and HPCL PRINTING is set to OFF, using the Shift-Print Screen key sequence causes Eterm to send line-drawing characters to the printer to draw the screen. If your printer does not support the line-drawing character set, you will get less than desirable results. • If PRINTER is set to NONE, Eterm disables screen printing, regardless of the value of HPCL PRINTING. 7. Leave the TERM ID field blank. 8.
Rel. 7.0 and 8.0 Red Book for AIX Using a Serial Connection When you run Eterm for DOS using a serial connection, Eterm communicates with the host system using the current port and speed settings. Click Connect to open an Eterm session. If the serial connection is interrupted or lost, Eterm for DOS will hang. You will need to exit Eterm by using the Ctrl-Print Screen key sequence and selecting Quit. Check the integrity of the serial connection before restarting Eterm for DOS. © 2006 Intuit Inc.
Red Book for AIX Rel. 7.0 and 8.0 Configuring DOS for Eterm for a Modem Connection The first time you run Eterm, the Eterm for DOS main menu appears and you must enter configuration data. You can change your configuration setup at any time. Note: From the emulator screen, press Ctrl-Print Screen to access the main menu. The following options are available on the main menu: • Quit – Quit Eterm for DOS. • Continue – Close the main menu and continue using Eterm for DOS.
Rel. 7.0 and 8.0 Red Book for AIX 6. To enable or disable HPCL PRINTING choose ON or OFF, respectively. • If PRINTER is set to a valid LPT port and HPCL PRINTING is set to ON, using the Shift-Print Screen key sequence causes Eterm to send line HPCL commands to the printer to draw the screen. • If PRINTER is set to a valid LPT port and HPCL PRINTING is set to OFF, using the Shift-Print Screen key sequence causes Eterm to send line-drawing characters to the printer to draw the screen.
Red Book for AIX Rel. 7.0 and 8.0 Using a Modem Connection When you run Eterm for DOS using a modem connection, Eterm sends the contents of the CONNECT STRING field to the modem. The field must contain the proper modem commands and host system telephone number. If the connect string uses ^M, Eterm for DOS performs a carriage return, effectively causing the connect string to auto-dial. Otherwise, press Enter to process the connect string as it appears on the screen.
Rel. 7.0 and 8.0 Red Book for AIX Minimum Configuration for Eterm for DOS The minimum configuration required for Eterm for DOS to operate correctly varies depending on how your PC is connected to the host. When Connecting Through a TCP/IP Network Connection For Eterm for DOS to operate correctly when connecting through a TCP/IP Ethernet connection, you must have the following options set: • Port – Choose Network-Telnet. • Host – Enter the IP address of the host system.
Red Book for AIX Rel. 7.0 and 8.0 Configuration Options for Eterm for DOS From the Eterm menu bar, click Configure to display the Configure Communications dialog box, where you specify how Eterm will communicate with the host system for modem, serial, and network connections. If Enable Configuration Password has been selected, you must type in the correct password before being able to make changes.
Rel. 7.0 and 8.0 Red Book for AIX • Enable Debug – Select this option to allow you to click Debug from the Eterm menu bar. Clicking Debug toggles between the normal Eterm terminal emulation screen and a screen of communication codes. Intuit Eclipse Support personnel use these codes for diagnostics. • Enable UD – Select this option to display a list of user-defined screens whenever you press the Alt key. This feature is useful for new users becoming accustomed to new userdefined screens.
Red Book for AIX Rel. 7.0 and 8.0 Running Eterm for DOS Under Windows Eterm for DOS also runs in DOS emulation windows under the Windows 3.1.1 and Windows 95 and Windows 98 environments, providing that Eterm for DOS is using serial or modem connections to communicate with the host. To run Eterm for DOS in a Windows environment: 1. At the DOS prompt, type dterm1 and press Enter. C:\> dterm1 76 © 2006 Intuit Inc. All rights reserved.
Rel. 7.0 and 8.0 Red Book for AIX Troubleshooting Eterm for DOS Review the following troubleshooting issues if problems arise. Accessing the Main Eterm for DOS Menu If Eterm for DOS hangs, try accessing the main menu by using Ctrl-Prt Scrn. Changing Settings and Reconnecting From the main Eterm for DOS menu, use the Arrow keys to select CONFIGURE and press Enter to display the Configure screen. In the Configure screen, use the Arrow keys to move between the fields.
Red Book for AIX 78 Rel. 7.0 and 8.0 © 2006 Intuit Inc. All rights reserved.
Rel. 7.0 and 8.0 Red Book for AIX Chapter 6: Solar Eclipse Each Intuit Eclipse customer receives a CD-ROM containing the Solar Eclipse client software. You can also download the software from our website at http://www.eclipse.intuit.com/. Before You Begin Before installing Solar Eclipse on a PC, make certain that your PC is set up correctly for your network. Refer to Network Administration for information on setting up network connections.
Red Book for AIX Rel. 7.0 and 8.0 Verifying Solar Class Files Before installing Solar Eclipse client software on a PC, verify the following two things: • The Solar class files exist and are in the correct location. The release engineering team puts the classes on your system. • The PC on which you plan to install the Solar client software can see the Solar class files. To verify that Solar class files exist: 1. Log in to AIX as root. 2.
Rel. 7.0 and 8.0 Red Book for AIX Installing the Solar Eclipse Client Software Intuit Eclipse ships the Solar Eclipse Client installation program on a CD-ROM. The installation program works for Windows 95, Windows 98, 2000, XP or Windows NT computers. To install the Solar Eclipse client software: 1. Close all other programs. 2. Insert the install disk into the CD-ROM drive or download the executable from the Eclipse Support web site. 3.
Red Book for AIX 82 Rel. 7.0 and 8.0 © 2006 Intuit Inc. All rights reserved.
Rel. 7.0 and 8.0 Red Book for AIX Chapter 7: Pinouts This chapter contains information on the following subjects: • Adapters for devises local to the Eclipse server. • Service processor firmware. © 2006 Intuit Inc. All rights reserved.
Red Book for AIX Rel. 7.0 and 8.0 Adapters for Devices Local to the Eclipse Server The following pinouts are for the connectors required for attaching PCs, printers, and modems locally to 16 port concentrators attached to the IBM RS/6000 using 128 port controllers. Connector Usage Notes These connectors assume the installation of 4 pair, category 3 or above wiring from each device to the Host location. If new wiring is required, we recommend the installation of 4 pair, category 5.
Rel. 7.0 and 8.0 Red Book for AIX RJ45 to DB-25M (Serial Printer) CPU (Concentrator) RJ45 Serial Printer (Dot Matrix and HP5Si) DB-25M 1 - Blue 20 2 - Orange 7 - Brown 5 4 3 - Black 1 4 - Red 3 5 - Green 2 6 - Yellow 7 8 - White 6 8 RJ45 to DB-25M (Modem) CPU (Concentrator) RJ45 Mode DB-25F 1 - Blue 8 2 - Orange 4 3 - Black 1 4 - Red 2 5 - Green 3 6 - Yellow 7 7 - Brown 5 8 - White 20 © 2006 Intuit Inc. All rights reserved.
Red Book for AIX Rel. 7.0 and 8.0 Service Processor Firmware When severe system problems cause a computer to completely stop responding, use your service processor firmware to power on the system. Service processors operate independently of the processors in the computer. To power on the system: 1. If the console screen is black or shows the screen saver, press Enter to display the Main Menu, as shown below: MAIN MENU 1. Service Processor Setup Menu 2. System Power Control Menu 3.
Rel. 7.0 and 8.0 Red Book for AIX Chapter 8: Printers and Queues Printer characteristics define the types of printers your system uses. Printer characteristics are pre-defined. Your installer and system administrator can make necessary additions or adjustments for your system. Define printer escape sequences within Eterm, logged into Eclipse, on the System > System Files > Printer Setup > Printer Characteristics screen shown below.
Red Book for AIX Rel. 7.0 and 8.0 Printer Characteristics/Control Panel Overview This topic includes printer characteristics and control panel overview information for the following printer series: • HP 5Si/5MX, 4000 and 5000 Series • HP LaserJet 8000 Series • Okidata 320 Printer • HP LaserJet 5Si Mopier • Okidata ML320/ML321 Turbo • Okidata ML520/ML521 HP 5Si/5MX, 4000 and 5000 Series Escape Sequence CPI LPI Escape Sequence 10.00 6.00 !(8U!(s0p10.00h12.00v0s0b3T!&l1e6D 12.00 8.
Rel. 7.0 and 8.0 Red Book for AIX HP LaserJet 8000 Series Note: The HP 8000 series printer characteristics described below might be different for your HP 8000 printer, depending on the EXACT model that you are using. Contact Eclipse Support for assistance. Escape Sequence CPI LPI Escape Sequence 10.00 6.00 !(8U!(s0p10.00h12.00v0s0b3T!&l1e6D 12.00 8.00 !(8U!(s0p12.00h10.0v0s0b3T!&l1e8D 16.67 8.00 !(8U!(s0p16.67h8.5v0s0b0T!&l1e8D 20.00 8.00 !(8U!(s0p16.
Red Book for AIX Rel. 7.0 and 8.
Rel. 7.0 and 8.0 Red Book for AIX On Line Switches the state of communication between computer and Mopier ON (on line) or OFF (off line). Switching from online to off line stops printing as soon as possible. Select* Selects a desired menu item choice. Control Panel Display The control panel displays messages in one or two lines of the character display. • Ready indicates that the Mopier is ready to accept data. • Status messages tell you what the HP LaserJet 5Si Mopier is doing at a given time.
Red Book for AIX Rel. 7.0 and 8.0 Okidata ML320/ML321 Turbo The following information regarding the Okidata ML320/ML321 Turbo was obtained from the Okidata web site (www.okidata.com). Using the Control Panel Use the front panel buttons, as illustrated below, to operate various printer functions. Following are descriptions of the panel buttons: SEL Select/deselect the printer. Press SEL while pressing SHIFT to enter Menu mode.
Rel. 7.0 and 8.0 Red Book for AIX Remember that Settings apply to Items in Groups that are found on different Menus. EXIT Press SEL while pressing SHIFT to exit Menu mode. GROUP Prints the next Group in the Menu. Press GROUP while pressing SHIFT to print the previous Group. ITEM Prints the next Item in the Group. Press ITEM while pressing SHIFT to print the previous Item in the Item in the Group. SET Prints the next Setting for an Item.
Red Book for AIX Rel. 7.0 and 8.0 Setting Up Ethernet Printers in Release 7 Setting up an Ethernet network printer requires you to make changes at the Eclipse application level and the AIX-Unix level. To prevent duplication of network printers, review the currently defined printer IDs before setting up the new printer. The following procedures describe how to: • Identify the currently defined network printers. • Define a printer and assign loadable forms. • Add the printer to printer locations.
Rel. 7.0 and 8.0 Red Book for AIX Most HP LaserJet printers use a printer type prefixed with HPLJ, while most dot matrix printers use either the PRINTRONIX or GENERIC printer type. Zebra label printers use ZEBRA or GENERIC. 5. In the Printer/Fax field, press F10 and select Printer. 6. In the Description field, enter a description of the printer. 7. In the Macro Enabled (Y/N) field, indicate whether to enable macro logic for this printer. 8.
Red Book for AIX Rel. 7.0 and 8.0 5. Depending on the printer characteristics, the printer may have more than one tray. Load forms for all available trays. 6. Press Esc until you to return to the System menu. To add the IP address of the printer to the /etc/hosts file: 1. Display the AIX system prompt (#) in one of the following ways: • Log out of Eclipse and log in to AIX-Unix as root. The system displays the Welcome to AIX login banner.
Rel. 7.0 and 8.0 Red Book for AIX 4. Select Standard Processing and press Enter. 5. In the Name of Queue to add field, type lp# (where # is the number of the printer). 6. In the Hostname of remote server field, type lp# (where # is the number of the printer). © 2006 Intuit Inc. All rights reserved.
Red Book for AIX Rel. 7.0 and 8.0 In the Name of Queue on remote server field, select the name, depending on the device: • pcl1 – Extended Systems Devices on port 1. • pcl2 – Extended Systems Devices on port 2. • lp# – Jet Direct Card (where # is the number of the printer). • pclnf1 – Dot Matrix printer not form feeding. 8. In the Description of printer on remote server field, enter lp#. 9. In the Backend TIME OUT period (minutes) field, enter 999.
Rel. 7.0 and 8.0 Red Book for AIX To create the printer driver: 1. At the system prompt (#), enter the following command: cd /usr/spool/uv 2. Enter the following command to confirm you are in the /usr/spool/uv directory: pwd 3. Enter the following command to display the VI editor: vi lp#.dvr (where # is the number of the printer) 4. Enter the following command to enter the VI editor input mode: i Note: The i will not be visible. 5.
Red Book for AIX Rel. 7.0 and 8.0 Setting Up Ethernet Printers in Release 8 Setting up an Ethernet network printer requires you to make changes at the Eclipse application level and the AIX-Unix level. To prevent duplication of network printers, review the currently defined printer IDs before setting up the new printer. The following procedures describe how to: • Identify the currently defined network printers. • Define a printer and assign loadable forms. • Add the printer to printer locations.
Rel. 7.0 and 8.0 Red Book for AIX 4. In the Printer Type field, press F10 and select from the displayed list the printer type that most resembles your printer. Most HP LaserJet printers use a printer type prefixed with HPLJ, while most dot matrix printers use either the PRINTRONIX or GENERIC printer type. Zebra label printers use ZEBRA or GENERIC. 5. Leave the Printer/Fax field set to the default Printer. 6. In the Description field, enter a description of the printer. 7.
Red Book for AIX Rel. 7.0 and 8.0 To assign forms to the printer trays: 1. Change the printer location to which your terminal is assigned to the location to which you added the new printer as follows: • From the System menu, select Change Location. • At the prompt, select the printer location to which you assigned the new printer. 2. From the System > Printers menu, select Forms Loaded to display the Forms Loaded screen. 3.
Rel. 7.0 and 8.0 • Red Book for AIX Press Enter to submit your changes and return to the previous menu. 5. Confirm that the printer was added, as follows: • Select List All Hosts and press Enter. • Press 0 while holding down the Esc key (Esc+0) to return to the system prompt. To create a print queue: 1. At the system prompt (#), enter smit queue to display the Print Spooling screen. 2. Select Add a Print Queue and press Enter to display the Add a Print Queue screen. 3.
Red Book for AIX Rel. 7.0 and 8.0 5. In the Driver field, enter lp#.dvr (where # is the number of the printer). Select Yes when prompted that the driver does not exist. 6. In the Lock file 1 field, enter lock.lp# (where # is the number of the printer). 7. Answer appropriately when prompted “Do you wish to go back and change any of your answers?” 8. Select Yes when prompted “Do you wish to save your changes?” 9. Select Yes when prompted “Do you want to Reread the Spooler Configuration files?” 10.
Rel. 7.0 and 8.0 Red Book for AIX 8. At the system prompt (#), enter the following command to verify that the driver was written properly. cat lp#.dvr The system should display what you just typed in step 5 above. If you do not see lp -dlp# (with no extra spaces or lines), enter the following command: rm lp#.dvr and then re-create the driver. 9. Enter the following command to write the driver's permissions: chmod 777 lp#.dvr 10. Enter the following command to confirm the permissions are –rwxrwxrwx.
Red Book for AIX Rel. 7.0 and 8.0 Configuring Extended Systems (ESI) Devices Intuit Eclipse supports the ESI Pocket Print Server and ESI Card. The following procedures describe how to: • Configure an ESI device from Windows. • Configure an ESI Device from AIX-Unix. • Change ESI Print Server Configuration Settings. • Restore the ESI Pocket Print Server to Factory Defaults.
Rel. 7.0 and 8.0 • Red Book for AIX Match the hardware address of the ESI device with the information in the H/W Address field. 2. At the ExtendView prompt, enter an IP address for the device. 3. Enter the IP address for the print server and click OK. The IP address must follow the format nnn.nnn.nnn.nnn, where nnn is a number between 0 and 255. Configuring an ESI Device from AIX-Unix Use the following procedure to configure an ESI device from AIX-Unix. To configure an ESI Device from AIX-Unix: 1.
Red Book for AIX Rel. 7.0 and 8.0 7. At the system prompt (#), enter the following command: ping XXX.XXX.XXX.XXX (where XXX.XXX.XXX.XXX is the printer IP address) • If you get a response, the printer is on the network. Press Ctrl-Break to stop the ping command and skip to step 8. • If you do not get a response, press Ctrl-Break and return to the system prompt (#). Check the physical connection between the ESI device, the network hub, and the printer, then repeat step 7.
Rel. 7.0 and 8.0 Red Book for AIX Changing Settings for the ESI Print Server Use this procedure to review the configuration settings for the ESI print server. To change configuration settings for the ESI print server of the currently selected device: 1. From the Print Server pull-down menu, select Configuration. ExtendView displays the Print Server Configuration dialog box. The following table displays the minimum configuration settings.
Red Book for AIX Rel. 7.0 and 8.0 Restoring the ESI Pocket Print Server to Factory Defaults In most cases, the best way to restore the Pocket Print Server to factory defaults is by using Telnet. However, if you are unable to connect to the device because of a configuration error, use the following method, which does not require a network connection. To restore the ESI Pocket Print Server to factory defaults without a network connection: 1.
Rel. 7.0 and 8.0 Red Book for AIX Configuring HP JetDirect Devices Note: Some of the information contained in this section was obtained from Hewlett-Packard’s web site (www.hp.com). This topic includes information about configuring TCP/IP parameters for HP JetDirect devices in the following ways: • Through the printer control panels. • Using HP JetAdmin Windows Software. Printer Self-Test The printer or HP JetDirect device self-test will show all the TCP/IP parameters.
Red Book for AIX Rel. 7.0 and 8.0 Parameter Description TCP Connection Timeout (in seconds) We recommend setting this to the maximum setting of 999. To configure TCP/IP parameters on HP LaserJet 5SI/5SI MX, 4000, 5000, or 8000 Series printers: Note: Unlike the HP LaserJet 4Si / 4Si MX printers, the HP LaserJet 5Si / 5Si MX printer does not have a minus (-) key or an Enter key. The 5Si, 4000, 5000, and 8000 printers have a Select button instead of an Enter button. 1.
Rel. 7.0 and 8.0 Red Book for AIX To configure TCP/IP parameters on HP LaserJet 4, 4 Plus, 4V, 4Si, 5 Series, and HP Color LaserJet printers: 1. Press Menu repeatedly until one of the following messages displays on the control panel: HP LaserJet Printer Type Control Panel Message HP LaserJet 4 and 4M printers AUX IO Menu HP LaserJet 4 Plus, 4M Plus, 4V, 4MV, 5/5N/5M and Color LaserJet printers MIO Menu HP LaserJet 4Si/4Si MX MIO Menu 1 or MIO Menu 2 2. Press Item, CFG NETWORK=NO* will appear. 3.
Red Book for AIX Rel. 7.0 and 8.0 Configuring TCP/IP Parameters Using HP JetAdmin Windows Software The following procedure includes general configuration instructions. To configure TCP/IP parameters using HP JetAdmin Windows software: Note: The following information is provided as a general overview. 1. Run HP JetAdmin. 2. Be sure TCP/IP is set as the default protocol in HP JetAdmin. Select Options > Preferences > Default Protocol and choose TCP/IP. 3. Press F5 on the keyboard to refresh HP JetAdmin. 4.
Rel. 7.0 and 8.0 Red Book for AIX Setting Up Slave Printers Assigning a slave printer to a terminal tells the system to send print jobs from that terminal to the Windows default printer. The slave printer is connected to the terminal, and is considered the terminal's default printer. When you assign a slave printer to a terminal, select the terminal from the Terminal Setup screen and assign the printer to that terminal. You can also set up a receipt slave printer for a selected user or group terminal.
Red Book for AIX • ON, if your slave is a laser printer. • OFF, if your slave is a dot matrix printer. Rel. 7.0 and 8.0 • Select Continue and press Enter to save your changes. • Select Reconnect and press Enter. 3. For Ethernet Connections using IP addressing, do the following: • In the Term ID field, enter your ID as it appears on the Terminal Setup screen in Eclipse.
Rel. 7.0 and 8.0 Red Book for AIX Setting Up Serial Printers Use the following instructions to set up a serial printer. These instructions assume you have the number of an available tty and the number of the LP that the end user wants to create. The following examples use tty25 and LP4. Insert your own tty and LP numbers as you step through these instructions for your system. The following procedures describe how to: • Set up a serial printer in AIX. • Set up a serial printer in UniVerse.
Red Book for AIX Rel. 7.0 and 8.0 4. In the Pathname field, type /dev/tty# (where # is the tty number). For example, enter tty25. 5. Press Enter to accept the defaults for the remaining fields until you are prompted to go back and make changes. 6. Select Yes when prompted “Do you wish to save your changes?” 7. Select Yes when prompted “Do you want to Reread the Spooler Configuration files?” 8. Press Enter to close when prompted “Spooler Configuration files have been reread.” 9.
Rel. 7.0 and 8.0 Red Book for AIX configuration in Unix and UniVerse. Also check that you have set the correct Serial I/F settings internally in the printer. • If the printer is still not printing after troubleshooting the tty, check your adapter and cable to ensure that they are working properly. An easy way to do this is to move them to another serial printer that is working correctly, and see if the other printer stops printing.
Red Book for AIX Rel. 7.0 and 8.0 Troubleshooting Individual Printers This topic includes information about troubleshooting the following types of printers: • Serial printers. • Ethernet printers. • Slave printers. Serial Printers Use the following procedure to troubleshoot serial printers. To troubleshoot a serial printer: 1. Get a status on the problem printer in one of the following ways: • In Unix, log on as the root user.
Rel. 7.0 and 8.0 • Red Book for AIX If the printer still does not print, continue troubleshooting with step 3. 3. If nothing printed, try to print a page using the tty#: • Shell out to the system prompt (#) in Unix, or log in as the root user. • Enter su - uv to access UniVerse. • If you are at a > prompt, type login. The UniVerse System Administration menu displays. • Enter S to display the Spooler menu. • Enter D to display the Device menu.
Red Book for AIX Rel. 7.0 and 8.0 Ethernet Printers Use the following procedure to troubleshoot an Ethernet printer. Troubleshooting is all done from the Unix system prompt (#). To troubleshoot an Ethernet printer: 1. At the system prompt (#), enter the following command to determine if the problem printer is on the network. ping lp# (where # is the number of the printer) • If you get a response similar to the response below, the printer is on the network.
Rel. 7.0 and 8.0 Red Book for AIX 5. Enter the following command to send the Welcome to AIX screen to the printer: lp -dlp# /etc/motd 6. Check your results, as follows: • If the system prompt (#) displays, the system believes it is printing. Go into Eclipse and confirm you can print from there as well. If you cannot print from Eclipse, the problem is within the setup of the printer in the Eclipse layer. • If nothing printed, you have a physical problem.
Red Book for AIX Rel. 7.0 and 8.0 Troubleshooting Tip from Customer Newsletter If you are using an AIX RS6000 and have Ethernet/network printers that are going down regularly, it is likely that you have not set the printer timeout period. This timeout factor keeps the printer online for a specified period of time while a physical problem with the printer is corrected.
Rel. 7.0 and 8.0 Red Book for AIX Printer Commands Use the following commands with Ethernet and Serial printers. ENQ Commands for Network/Ethernet Printers Only The enq command is a general-purpose utility for enqueuing requests to a shared resource, typically a printer device. Use the enq command to enqueue requests, cancel requests, alter the priority of a request, and display the status of queues and devices.
Red Book for AIX 126 Rel. 7.0 and 8.0 © 2006 Intuit Inc. All rights reserved.
Rel. 7.0 and 8.0 Red Book for AIX Chapter 9: VSI-FAX Gold Use the VSI-FAX Gold software to connect to modems and transmit documents and messages as faxes. VSI-FAX Gold is a Unix-based fax server which interfaces directly to the Eclipse menu and to networked Windows PCs set up as clients. It is security driven by branch, by user, and by document. You can append documents, such as credit applications, to the cover sheet and create company logos on the cover sheet.
Red Book for AIX Rel. 7.0 and 8.0 Installing VSI-FAX Gold This section details the VSI-FAX Gold installation. Intuit Eclipse may have configured your Eclipse server prior to shipping. Please contact Eclipse System Support with any questions or concerns you might have. Note: The installation instructions below use a MultiTech modem. Consult your modem documentation if you are using a different modem and experience modem problems. To install VSI-FAX: 1.
Rel. 7.0 and 8.0 Red Book for AIX 8. Enter the following command to remove any locks on the tt: # rm /etc/locks/LCK_ttyx (where x is the port number) 9. Enter the following command to kill the processes listed as a result of step 6. You can concatenate multiple PIDs on the same command line. # kill x y z (where x y z are the PIDs of the processes to kill) The system indicates that the process has been terminated. 10.
Red Book for AIX Rel. 7.0 and 8.0 This command sets up default class fax1 and adds device modem1 to it. Note that fax1 is the value you will insert in the Printer/Fax # field on the System > System Files > Printer Setup > Assign Printer/Fax screen. For every geographic location (branch) that has its own VSI-FAX modem, set up a default class. For example, use classes fax2 and fax3 for the additional locations. Within each class you can set up several modem devices, such as modem1, modem2, and modem3. 15.
Rel. 7.0 and 8.0 Red Book for AIX Testing the VSI-FAX Installation Once you have installed VSI-FAX, test that it has been installed correctly. To test that VSI-FAX has been installed correctly: 1. Shell out of Eclipse to the Unix prompt, as follows: • From the Systems menu, select TCL. • At the ; prompt, type sh and press Enter. ; sh • At the $ prompt, type su and press Enter. $ su • At the # prompt, type in your root password and press Enter. root's Password: # ________ 2.
Red Book for AIX Rel. 7.0 and 8.0 Installing the VSI-WIN Client The VSI-WIN Client installation software is provided on a CD-ROM. If you have some users with network connectivity, but no CD-ROM drive, you can install VSI-WIN over the network. You can also copy the installation files to diskettes and install VSI-WIN from the diskettes. The following procedures explain how to install VSI-WIN from the following sources: • • • CD-ROM Network Diskettes To install VSI_WIN from a CD-ROM: 1.
Rel. 7.0 and 8.0 • Red Book for AIX Password – The password can be the same as your Eclipse password. If you use a different password, be certain to commit it to memory! The system prompts you to enter the password a second time for confirmation. 8. Select the time zone. 9. If you get an error indicating that a license is not available, then the client licenses you have purchased have already been assigned to other users. You must either remove another user’s license or buy more licenses.
Red Book for AIX Rel. 7.0 and 8.0 Registering VSI-WIN Client Users In order to send faxes from the VSI-WIN client, every VSI-WIN client user must be registered on the VSI-FAX server with a unique login name and password. The VSIFAX login name and password can be the same as the user's Eclipse login name, but does not have to be. VSI-WIN client users are automatically registered when the VSI-WIN client is installed on the user's PC. A license will automatically be used if one is available.
Rel. 7.0 and 8.0 Red Book for AIX VSI-FAX Administrator Server Commands Use the following additional server commands, as needed. • vfxadmin license -l Determines the number of VSI-WIN client licenses purchased. Client licenses are listed under the “License 2” section as “num users = #.” • vfxadmin license _pfxclient Updates the number of client licenses after purchasing additional licenses: Follow the on-screen instructions to enter new license and key information.
Red Book for AIX Rel. 7.0 and 8.0 Setting Up the Fax System After VSI-FAX is installed on your system, you need to set authorization keys and control maintenance records, assign fax devices, and create fax logos. You can also set up documents to append to faxes. Authorization Keys The following authorization keys apply to the fax system. • FAX.ALLOWED • FAX.APPEND.DOC • FAX.PRIORITY • FAX.RESET • FAX.
Rel. 7.0 and 8.0 Red Book for AIX Creating a Logo for a VSI-FAX Document For information about creating a logo for a fax device, do one of the following: • In Release 7, see the "Incoming Fax Status Queue" section in the Fax System document. You can also select a document on the System > Printers > Incoming Fax Status Queue screen, use the Make Logo hot key, and then press F11 to access help topics. • In Release 8, see the "Creating Fax Logos" topic in the online help.
Red Book for AIX 138 Rel. 7.0 and 8.0 © 2006 Intuit Inc. All rights reserved.
Rel. 7.0 and 8.0 Red Book for AIX Chapter 10: Online Glossaries Eclipse Support notes a number of web pages that contain good online glossaries of computing, internet, and networking terms. We hope you will find these URLs helpful in expanding your understanding of frequently used technological acronyms, protocols, words, and phrases.
Red Book for AIX • Rel. 7.0 and 8.0 http://www.cisco.com/univercd/cc/td/doc/cisintwk/ita/itaintro.htm Cisco Systems provides an online glossary, which you can also download as a PDF file. • http://www.rirr.cnuce.cnr.it/Glossario/butterfly_glossary.html The Butterfly glossary of terms is maintained by CNUCE-CNR, Pisa (Italy). • http://www0.delphi.com/navnet/glossary/ A glossary of terms developed by Walt Howe and Delphi Internet Services Corporation.
Chapter 11: Command Reference © 2006 Intuit Inc. All rights reserved.
Red Book for AIX Rel. 7.0 and 8.0 AIX System Commands The following tables describe common commands that the system administrator can use at the AIX operating system, UniVerse database, and Eclipse application levels. AIX Command Prompts The following table describes how to display the common prompts for the AIX operating system, UniVerse database, and Eclipse application. Symbol Prompt $ or # AIX command prompt. To display this prompt, do one of the following: • Log in to AIX as root.
Index Command Description and Example who –uH Displays logged on users, their devices, PID’s, IP addresses. Example: Name Line Time Activity PID Hostname root tty0 Jan 13 15:58 old 11614 repstein pts/0 Feb 05 07:11 1:22 26330 (192.0.0.0) jortiz pts/2 Feb 03 16:53 17:31 34790 (192.0.0.17) eknight pts/3 Feb 05 05:57 . 42988 (ga-warehouse) jlindqui pts/4 Feb 05 06:18 0:01 35020 (192.0.0.24) bmadison pts/5 Feb 05 06:25 0:57 40006 (192.0.0.49) qestrieby pts/6 Feb 05 06:46 2:33 24826 (192.0.0.
Red Book for AIX Rel. 7.0 and 8.0 Command Description and Example usa Displays all UniVerse print queues. Example: Printer: LP1 Q: on P: on Form: no entries. Printer: lp3 Q: on P: on Form: no entries. Printer: LP4 Q: on P: on Form: usa –p LPn Displays LPn UniVerse print queue. lpstat Displays all AIX print queues. lpstat –plpn Displays all AIX print queues. rmdev –l ttyn Puts ttyn in a defined state.
Index Command Description and Example lspv Displays all available physical volumes their assigned volume group. Example: root:/# lspv hdisk0 0002906f76154417 rootvg hdisk1 0002906fd8f48aba rootvg hdisk2 0002906fd902a2c7 datavg hdisk3 0002906fd902ad28 datavg hdisk4 0002906fd902ae58 datavg hdisk5 0002906fd902af7d datavg hdisk6 0002906fd902b0a4 datavg hdisk7 0002906fd902b1cf datavg lsvg Displays all volume groups. Example: root:/# lsvg rootvg datavg lsvg vgname Displays detail of vgname.
Red Book for AIX Rel. 7.0 and 8.0 System Management Commands The following table describes common AIX system management commands. Command Description and Example pwd Displays your current directory path. Example: root:/# pwd root:/u2/eclipse# who –b Displays the last reboot date. Example: root:/# who -b system boot Jan 06 20:09 shutdown –Fr Reboots the system. shutdown –F Halts the system. oslevel Displays the AIX version. Example: root:/# oslevel 4.3.3.
Index Command Description and Example df -k Displays file system statistics (file system names may vary). Example: root:/# df -k Filesystem /dev/hd4 /dev/hd2 /dev/hd9var /dev/hd3 /dev/hd1 /dev/lv00 1024-blocks Free %Used Iused %Iused Mounted on 49152 35056 29% 1267 6% / 311296 51412 84% 10949 15% /usr 212992 201976 6% 294 1% /var 212992 205792 4% 74 1% /tmp 16384 15808 4% 44 2% /home 5451776 1806472 67% 32762 3% /u2 echo $TERM Displays your console terminal emulation. For 3153, should be wyse50.
Red Book for AIX Rel. 7.0 and 8.0 Command Description and Example iostat 2 7 Issue the iostat every 2 seconds for a total of 7 times. tty: in 123.0 " Disk history since boot not available." tout avg-cpu: % user % sys % idle % iowait 4772.8 32.9 20.4 1.4 45.3 Disks: % tm_act Kbps tps Kb_read Kb_wrtn hdisk1 13.6 69.5 17.4 0 148 hdisk0 14.6 71.4 17.8 4 148 hdisk2 24.4 113.1 26.3 192 49 hdisk3 17.8 85.0 19.7 108 73 hdisk4 27.7 119.7 26.3 120 135 hdisk5 25.4 105.6 25.8 136 89 hdisk6 23.9 91.1 24.
Index Command Description and Example >CONFIG Displays licensing information. Example: >CONFIG Configuration data for license number 4nnnnn: User limit = 48 Expiry date= 1/1/2500 -UCI package is installed. User limit = 48. Expiry date = 1/1/2500 -UVADM package is installed. User limit = 48. Expiry date = 1/1/2500 Eclipse TCL The following table describes a common Eclipse application command. Command Description ;kill.ph Prompts to kill all running phantoms. © 2006 Intuit Inc. All rights reserved.
Red Book for AIX Rel. 7.0 and 8.0 Index A using............................................ 81, 84 adapters ..................................................... 96 Eterm for Windows B additional features................................. 64 backing up configuration options ............................ 60 database................................................. 33 configuring............................................ 56 operating system ................................... 26 installing.......
Index backups PowerChute software ................................ 14 control maintenance records ............. 36 printer characteristics...................................... 100 performing......................................... 15 commands ........................................... 137 rebooting Unix ...................................... 12 configuring T ESI devices...................................... 118 tape drives, cleaning.................................. 40 HP jet direct devices ..
