1

IBM i Access Client Solutions for OSX

MaddenCo Inc. March 2014

Copyright © 2014 by MaddenCo, Inc

All rights reserved.

2

Please understand that MaddenCo has expended substantial sums in developing and maintaining its software, systems and related materials, and as a result, it has and will continue to have substantial proprietary interest and valuable trade secrets therein. Also understand that MaddenCo's software, systems, related materials and the "ideas" represented by software, as well as the physical materials, are valuable trade secrets and are strictly confidential material, and important, and that its confidentiality gravely affects the successful conduct of the business of MaddenCo.

3

Table of Contents

Introduction ........................................................................................................................................................4

Installation and Setup ........................................................................................................................................5

ACQUIRING THE SOFTWARE .................................................................................................................................5 INSTALLATION .....................................................................................................................................................5 CONFIGURATION .................................................................................................................................................7

OSX Keyboard Configuration ........................................................................................................................ 10

Features of the Client ..................................................................................................................................... 13

PRINTER OUTPUT ............................................................................................................................................ 13 DATA TRANSFER .............................................................................................................................................. 14

4

Introduction IBM i Access Client Solutions is the newest member of the IBM i Access family of products. It provides a Java based platform-independent interface which runs on most operating systems that support Java including Linux, Mac and Windows. IBM i Access Client Solutions consolidate the most commonly used tasks for working within the MaddenCo software into one simplified location.

Prerequisites IBM i Access Client Solutions will run on most operating systems that support Java 6.0 or higher including various versions of Linux, Mac and Windows. One way to check the version of Java installed on your system is to bring up aprompt where a command may be entered (Command Prompt, Shell, Terminal, etc) and then type the command: >java –version The following output indicates version 6.0 is installed: >java version "1.6.0_31" The 31 in this example refers to the update level. The following output indicates version 7.0 is installed: >java version "1.7.0" Here are some web sites of Java providers. Make sure you are running with the most up-to-date version of Java for your platform.

http://www.oracle.com/technetwork/java/javase/downloads/index.html http://www.oracle.com/technetwork/java/javase/index-137561.html http://java.com/en/download/manual.jsp http://support.apple.com/downloads http://support.apple.com/downloads/#macosandsoftware http://support.apple.com/downloads#Java http://openjdk.java.net/install

5

Installation and Setup

Acquiring the Software IBM i Access Client Solutions is available for download from the MaddenCo website. Click on Client Login in the upper right-hand corner of the website and enter your company’s login credentials. The download is under the Download Client Access option. If you do not have login credentials or have forgotten them, please contact MaddenCo Support for assistance.

Installation After downloading the software from the MaddenCo website, locate the file MaddenCo.app.zip in the downloads folder or the alternate location if you chose one.

Double click the file MaddenCo.app.zip to extract the file.

6

Drag and drop the newly extracted MaddenCo application to the Applications folder.

Click on the MaddenCo application in the Applications directory to launch the software. A warning may appear regarding the downloaded application. Click Open to proceed.

The software is now installed and you will be presented with start screen.

7

Configuration The first step in configuring the software to access the MaddenCo environment is to add the system it will need to connect to. Click on System Configurations to add the MaddenCo server to the software.

Click on New and add 10.0.0.9 to the System Name and IP address fields and then click Close. The value of 10.0.0.9 is the most common ip address used by our customers to access the MaddenCo software but it is not used by all locations. If you are unsure of the value used here contact MaddenCo support to verify the settings.

8

Next, select the newly created system from the System drop-down menu.

Select 5250 Emulator and sign in using your MaddenCo username and password to being setting up the workstation session. Following your login, you will be presented a blank session.

9

Select the Communications menu and click on Configure. Enter your workstation ID in the Workstation ID field. Workstation ID’s start with WXXX or GXXX where the XXX is your companies customer number. Once the ID is entered, click OK.

Click on the File menu and select Save to save the session configuration.

10

Save the session information with the name of the workstation ID utilized for ease of identification in the future.

OSX Keyboard Configuration Most Apple Computers running OSX have alternate functions assigned to the function keys (F1-F12). In order to use the Client Solutions software, these alternate functions will need to be disabled. Access the Keyboard Preferences by clicking on the small apple icon in the upper left-hand corner of your screen and select System Preferences.

11

Select Keyboard from the System Preferences screen.

12

Click on Display and uncheck the Decrease Brightness and Increase Brightness options.

Click on Mission Control and uncheck Show Desktop and Show Dashboard.

13

Features of the Client

Printer Output Printer Output provides an interface that allows you to view files in the IBM i output queues and also provides the capability to download these files to your client system.

When printing in MaddenCo you are often presented with the option to put a particular print job on hold. Files held or awaiting print are accessible from the printer output feature. Using this feature you can find the print job you are interested in and right click to reveal options.

Selecting the download and view option will open the file locally and allow for printing to any printer installed on the local system.

14

Data Transfer Data Transfer provides the ability to transfer data from/to your MaddenCo library to/from various file types on your workstation such as OpenDocument spreadsheet (*.ods), Excel Workbook (*.xlsx) and other file formats.