v1.23 aXes Getting Started Guide - HelpSystems · Any iSeries or AS/400 model running OS/400 V4R4M0...

aXes Getting Started Guide

aXes is developed and licensed by

© Copyright 1996-2004 LINOMA SOFTWARE LINOMA SOFTWARE is a division of LINOMA GROUP, Inc.

Version 1.23 01.26.05

Table of Contents

Topic Page

INTRODUCTION ........................................................................................3 FEATURES .................................................................................................3 HOW IT WORKS ........................................................................................3 SUMMARY .................................................................................................3 PREREQUISITES........................................................................................4 WEBSERVER..............................................................................................5 TERMINAL SERVER....................................................................................6 WEB SPOOLER ..........................................................................................7 DATA EXPLORER .......................................................................................8 ADMINISTRATION ....................................................................................9 INSTALLATION .........................................................................................9 INSTALLATION .......................................................................................10 CURRENT AXES PTF'S..............................................................................12 INITIAL LOGIN .......................................................................................13 TUTORIAL & SAMPLE INSTALLATION PROCEDURES................................14

Customer Maintenance Application ............................................................................. 15 Item List Application (HTML Keyword Support) .......................................................... 15

AXES ADMINISTRATOR...........................................................................16 Login to aXes Administrator ........................................................................................ 16 TS Statistics ................................................................................................................ 16 TS Sessions ................................................................................................................. 16

ADVANCE 5250 KEYWORDS ....................................................................17 UNINSTALLING AXES..............................................................................19 ABOUT LINOMA SOFTWARE ....................................................................20

Linoma Logic ............................................................................................................... 20 Contact Us................................................................................................................... 20


Version 1.23 01.26.05

Introduction aXes will immediately web-enable your iSeries (AS/400) host screens with no programmer intervention required. With its high-performance web server and innovative method of capturing host screen data, aXes serves iSeries applications to the browser at incredible speeds.

Features • Immediate web-enablement of host screens without programmer intervention

• Host data is captured and dynamically transformed into XML at the program I/O level

• Source code is not required for programs and display files

• Supports advanced 5250 display features, UIM help text and IBM panels

• aXes sessions can run without consuming interactive CPW

• Includes a powerful and lightweight web server for serving host screens - WebSphere is not required

• Minimizes bandwidth through advanced compression methods

• Supports SSL and OS/400 security level 50

• Provides access to Spooled Files and Messages

• Powerful development tool set is included for creating new web-based applications

How it Works On the iSeries server, aXes uses innovative methods to capture screen data directly from the program I/O and transforms it into lightweight XML and style sheets for delivery to the browser. With the standard functionality already built into Internet Explorer 6.0, the browser automatically applies the style sheet to the XML and transforms it into an elegant web presentation.

The style sheets can be customized for further enhancing the look-and-feel of the screens. For example, you could create style sheets to add your own custom skins, menus, hyperlinks, images and corporate logos.

Host screens can be served to the browser either through the high-performance aXes web server (included) or via an existing iSeries HTTP server. With this new and unique approach to screen transformation, aXes will take your iSeries applications to the web in record time.

Summary aXes immediately Web-enables the enterprise while providing browser-based, Web-to-host connectivity with full security for browser-based sessions. aXes Web-to-host connectivity integrates, extends and re-engineers enterprise applications with easy to use XML enabled graphical interfaces, eliminating client deployment costs and minimizing administration, upgrade and training costs. aXes is real-time, automated and dynamic.

aXes features single point (true zero-client) installation and centralized management, which gives the administrator a high level of control and reduces the organization’s total cost of ownership (TCO). Single point (true zero-client) installation minimizes user training and support costs. Web-to-host technology minimizes the costs associated with software distribution, installation and configuration. Open Internet-standards and aXes N-Tier architecture provides unlimited presentation scalability.


Version 1.23 01.26.05

Prerequisites Hardware Requirements

Host System Hardware

Any iSeries or AS/400 model running OS/400 V4R4M0 or later

Any communication hardware supported by the TCP/IP protocol stack

Disk Space

The base component of the aXes product requires 8 MB of storage

The aXes Terminal Server component requires 2.5 MB of storage

The aXes Web Server component requires 3 MB of storage

The aXes Web Spooler component requires 1 MB of storage

The aXes examples component requires 4.2 MB of storage

Client System

aXesTS requires Windows Internet Explorer 5.5 or greater with MSXML 3 installed. Best results will be achieved with Internet Explorer 6.0 Service Pack 1.

500 Mhz CPU with 128 MB RAM. A faster CPU and more RAM will result in better performance.

Software Requirements

Use the GO LICPGM command to check for the installation of the following licensed programs.

OS/400 Version V4R4M0 or greater

TCP/IP Connectivity Utilities for the AS/400

A FastCGI enabled HTTP Server. Supported HTTP Servers are : > aXesW3 Web Server > IBM HTTP Server > Apache HTTP Server with FastCGI module support installed

If you plan to use the aXes Web Server, you must have OS/400 Host Servers installed.

To use SSL, one of the following IBM Cryptographic Access Provider Products must be installed: > Crypto Access Provider 40-bit for AS/400 > Crypto Access Provider 56-bit for AS/400 > Cryptographic Access Provider 128 bit

To use the aXes Terminal Server, you need an XML capable web browser that supports HTTP 1.1 protocol, frames and JavaScript.

To use the Configuration and Administration forms, you need a web browser that supports HTTP 1.0 or 1.1 protocol, frames and JavaScript. Browsers such as Netscape will work with the Configuration and Administration forms browser interface.

If you are install on OS/400 V5R2, you must have the following PTFs installed: > SI09459


Version 1.23 01.26.05

Webserver The aXes Web Server is a fast, secure, non-blocking, multiplexing 4th generation HTTP 1.1 server for the IBM iSeries (AS/400) with integrated Website acceleration technology.

aXes Web Server acceleration technology is built on the simple principle of sending less data and preserving information integrity across the network. This technique enhances existing bandwidth capacity by transmitting compressed data streams using less bandwidth, which enables data to arrive faster. The aXesW3 Website acceleration technology is designed to provide affordable and flexible Website acceleration and load balancing for static and dynamic sites. By using the aXes Web Server, loads will be reduced, Web responsiveness improved and site quality of service can be more easily predicted and managed. The aXes Web Server delivers a dual advantage to clients by conserving limited “bandwidth” resource while simultaneously enhancing the retention and satisfaction of Web users.


Version 1.23 01.26.05

Terminal Server The aXes Terminal Server is an effective host access solution that is managed from a standard Web server. Offering all of the advanced features found in desktop-based solutions within the framework of a browser-based interface, the aXes Terminal Server lowers your Total Cost of Ownership (TCO) for host access by exploiting the infrastructure of the Web and internet-based protocols.

The aXes Terminal Server provides unprecedented control over host connectivity combined with centralized configuration, license management and security. The aXes Terminal Server is an advanced host based solution that provides access to enterprise applications via an industry standard Web browser interface in XML format over the Web or company intranet. Using a browser, users simply access an URL-eliminating the need to install software and user configurations on individual desktops.

Users access their host-based applications in a variety of styles, with a click of the mouse via their Web browser. The aXes Terminal Server uses open standards to ensure host access is quickly, efficiently and securely managed between browser-based client and host application, resulting in lower network traffic than native terminal protocols. You get reduced telecommunication, administration and client management costs with decreased complexity.


Version 1.23 01.26.05

Web Spooler The aXes Web Spooler provides convenient, high speed access to iSeries Output Queues and spooled data using the HTTP protocol. Spooled content can be displayed or dispatched in a variety of user selectable and defined formats:

• Automatically deliver spooled content in a variety of formats via your browser

• Spooled files can be manipulated with commands run directly from the browser

• Upon obtaining spooled content in the selected format, output can be seamlessly integrated with desktop applications; email, Excel etc.

• Management functions are provided for Output Queues and spooled content

• Server side script can be tailored (eg. allow for page range selection of print, insert corresponding pictures based on product codes etc.)

• Zero-client configuration and deployment.

The aXes Web Spooler directly integrates with aXes Terminal Server when the user has an established host session. Conversion of spooled data to XML, combined with event driven dispatching provides a very fast and effective e-business delivery mechanism.

Print ready documents are delivered automatically in the following formats:

XML - Publish spooled data using XSL transformations for speed and flexibility;

PDF - Deliver print ready PDF files; Example: using a customers letterhead;

HTML - Format spooled data into customizable web ready documents; and

Text - Super fast access for large spooled files.


Version 1.23 01.26.05

Data Explorer The aXes Data Explorer provides convenient, high speed access to iSeries and other data bases using the HTTP protocol and a web browser.

• Easy to use, you can create your first data query in minutes, no programming is required

• Create distributed SQL data base queries for any accessible data source

• Support any browser for query definition and web publication

• Query output can be easily integrated with desktop business applications such as Word, Excel etc.

• Launch saved queries from any web page with a standard URL reference

• Zero-client configuration and deployment, server side script can be tailored

• SQL knowledge and client side configuration are not required

• Improve web site functionality and data accessibility saving time and money.

Data Explorer directly integrates with aXes Web Server to publish live business data enabling effective e-business delivery.

Web ready database content is delivered for a wide variety of everyday e-business uses:

Data transfer - Query results can be saved or printed locally on your PC or anywhere in a network;

Web publication - Deliver real-time, web ready query results when and where they are needed

Desktop integration - Query results can be seamlessly integrated with desktop applications like Excel without writing macros.


Version 1.23 01.26.05

Administration The aXes server can be installed onto the iSeries in about 30 minutes and requires only 12 Mb of disk space. Once installed, there is a wide array of configuration and security settings available for providing a high level of control and flexibility. For instance, you can set up multiple instances of aXes at different ports, enable SSL for encrypting transmissions, establish inactive time-out settings, apply IP masks to restrict access, configure named devices and much more.

aXes includes a web-based console for allowing an administrator to view all the sessions connected through the aXes server. The console will display valuable information about each session, including its user id, source IP and connection time. An authorized administrator can additionally view a session’s screen for remote support purposes.

The console also provides real-time statistics about the aXes environment, such as the number of active sessions, average screen packet sizes, average response times, number of transactions processed, etc. aXesTS is centrally installed and configured by the system administrator for all users or groups of users. Centralized configuration and administration saves time, reduces costs and increases worker and system efficiency. aXesTS architecture provides unlimited scalability for any size business.


Version 1.23 01.26.05

Installation The aXes software consists of four save files that will be downloaded from the Linoma website. Installed, aXes will only use approximately 12 MB of disk space and should not require any additional hardware or software to use aXes.

Special Note for International Installations:

aXes provides support for different national languages. If a product language exists on the installation media that is the same as the installed primary language then the installation program will install the language-specific objects into the product library.

However, if no product language matches the primary language then you must specify a secondary language on the LNG keyword of the RSTLICPGM command. Secondary languages are installed in a library called AXESnnnn where "nnnn" indicates the language identifier. You can override the name of the language library by specifying a library of your choice on the LNGLIB keyword of the RSTLICPGM command but be aware of the caveats described above.

The following national language versions are available for aXes: Language ID Language 2924 English Uppercase and Lowercase

2938 English Uppercase Support for Double-Byte Character Set (DCBS)

2950 English Uppercase

2984 English Uppercase and Lowercase for Double-Byte Character Set (DCBS)

Please follow the steps outlined below for installing aXes.

Verify System Settings (DSPSYSVAL) a) QCCSID – Every stream file has a coded-character set identifier describing the encoding of the data contained in the stream file. The aXes web server will convert data sent to a browser to the codepage specified in the configuration file. Make sure that your QCCSID is set to a value appropriate for your system. A standard setting that is used is 37 or 65535. b) QALWOBJRST – Verify that allow object restore system value is set to *ALL or includes *ALPGMADP and *ALWSYSSTT before installing aXes. If it is set to *None, the installation will fail. After installation, reset the QALWOBJRST to its original setting to maintain system integrity. c) QVFYOBJRST – If your system is on OS/400 V5R1 or later, verify Object Restore (QVFYOBJRST) system value is set to ‘1’ before starting the installation. If set to anything other than ‘1’, the installation will fail. After installation, reset the QVFYOBJRST to its original setting to maintain system integrity. d) QAUTVRT – This system value controls automatic configuration of virtual devices. If the QAUTOVRT value is set to zero, then you must manually creat virtual devices that matches the devices that aXes needs. See the Default Workstation Type=directive in the Terminal Server Configuration section of the aXes User Guide.

Download the zip file from http://www.linomasoftware.com/products/axes/download.html to your desktop. Note: You will need to complete the aXes registration form before the savefiles can be downloaded.

Right-click on the zip file and choose Extract to…

Choose to have the savefiles extracted to your C:\ drive.

Click New Folder and name it ‘AXES_123’.

Start a Telnet session and create 5 empty savefiles using the following commands: CRTSAVF FILE(QGPL/AXES_12300) CRTSAVF FILE(QGPL/AXES_12301) CRTSAVF FILE(QGPL/AXES_12302) CRTSAVF FILE(QGPL/AXES_12303) CRTSAVF FILE(QGPL/AXES_12399)


Version 1.23 01.26.05

Start a Command Prompt window. FTP <host name> <user name> <password> lcd c:\axes_123 quote site namefmt 1 cd /qsys.lib/qgpl.lib bin put axes_12300.savf put axes_12301.savf put axes_12302.savf put axes_12303.savf put axes_12399.savf quit exit

Restore the base option of the licensed program. RSTLICPGM LICPGM(1AXES01) DEV(*SAVF) SAVF(QGPL/AXES_12300) Restore option 1 (aXesW3 Web Server) of the licensed program. RSTLICPGM LICPGM(1AXES01) DEV(*SAVF) OPTION(1) SAVF(QGPL/AXES_12301) Restore option 2 (aXesTS Terminal Server) of the licensed program. RSTLICPGM LICPGM(1AXES01) DEV(*SAVF) OPTION(2) SAVF(QGPL/AXES_12302) Restore option 3 (aXes Webspooler) of the licensed program. RSTLICPGM LICPGM(1AXES01) DEV(*SAVF) OPTION(3) SAVF(QGPL/AXES_12303) Restore option 99 (aXesTS Samples) of the licensed program. RSTLICPGM LICPGM(1AXES01) DEV(*SAVF) OPTION(99) SAVF(QGPL/AXES_12399) The installed objects will need to be decompressed: DCPOBJ OBJ(AXESDEMO/*ALL) OBJTYPE(*ALL) DCPOBJ OBJ(AXES/*ALL) OBJTYPE(*ALL) Note: If you installed the aXes components into a library different from the default AXES library you must specify that library name in the OBJ parameter. If the translatable components of aXes were installed into a secondary language library then decompress those objects: DCPOBJ OBJ(AXESnnnn/*ALL) OBJTYPE(*ALL) Where ‘nnnn’ is the language identifier. If you specified a secondary language library different from the default library you must specify that library name in the OBJ parameter.

Check the aXes User Profile to verify Job Control has been assigned to it. WRKUSRPRF AXES Verify that *JOBCTL & *ALLOBJ authorities are assigned.

Determine if Port 80 is being used by another application. From Command Line enter: NETSTAT OPTION(*CNN) Press F14 to display the port numbers. Check the local port column for Port 80.


Version 1.23 01.26.05

If Port 80 is being used, perform the following steps to change the port for aXes from the Command Line: WRKLNK ‘/AXES’ Place a 5 next to the Axes directory (press enter) Place a 5 next to the Configs directory (press enter) Place a 2 next to AXESW3.conf (press enter) Page down three times, look for "#PORT=80” Enter the Port Number that you wish to use and remove the # sign. Press F2 then Press F3 Place a 5 next to AXESW3.conf and page down three times to Port Number to confirm the change. Exit

From the command line enter: STRAXESW3 and press enter. Enter WRKACTJOB to verify that there are four (4) aXes jobs running under the aXes Subsystem.

Start an Internet Explorer browser session – Verify that a Proxy Server is not being used. If the aXesW3 server was started on Port 80, use the following URL: http://system/ Where ‘system’ is the iSeries host name or IP Address. If the aXesW3 server was started on a different port, use the following URL: http://system:port/ Where ‘port’ is the port number specified when starting the aXesW3 server.

Current aXes PTF's aXes has periodic fixes to correct defects in the product. You should check the Linoma Software site for the current set of PTFs, download them and aplly them after you have installed the product. The PTF instructions are on the webpage.

http://www.linomasoftware.com/products/axes/axesptfs.html

The instructions on how to apply them are located at the bottom of the web page. If you have any questions, please contact Linoma Software Support via e-mail at [email protected] or call 1-800-949-4696.


Version 1.23 01.26.05

Initial Login After entering the URL of the system name and port number (if required) click on 'Proceed to aXes Homepage' to get to the page shown below. The URL in the address bar is the default address that the aXes Administrator will want to save in their favorites to come right to this screen.

To launch your aXes session, click on Popup Window to get the iSeries signon page which will prompt for a valid iSeries User ID and Password.


Version 1.23 01.26.05

Tutorial & Sample Installation procedures

Loading Sample Applications - This can also be found beginning on page 61 of the aXes User Guide. The samples can run from our site too. http://linomasoftware.com/launch

Note: Loading the Tutorial and Samples is optional. It will not affect the performance of the software.

RUNSQLSTM SRCFILE(AXESDEMO/EXAMPLESRC) SRCMBR(REGSQLPROC) COMMIT(*NONE) NAMING(*SQL) ERRLVL(30) There are also four sample SQL stored procedures provided. These are contained in their own SQL script files and are created using the following commands: RUNSQLSTM SRCFILE(AXESDEMO/EXAMPLESRC) SRCMBR(XSQL_CUST) COMMIT(*NONE) NAMING(*SQL) DLYPRP(*YES) USRPRF(*USER) ERRLVL(30) RUNSQLSTM SRCFILE(AXESDEMO/EXAMPLESRC) SRCMBR(XSQL_EMP) COMMIT(*NONE) NAMING(*SQL) DLYPRP(*YES) USRPRF(*USER) ERRLVL(30) RUNSQLSTM SRCFILE(AXESDEMO/EXAMPLESRC) SRCMBR(XSQL_ITEM) COMMIT(*NONE) NAMING(*SQL) DLYPRP(*YES) USRPRF(*USER) ERRLVL(30) RUNSQLSTM SRCFILE(AXESDEMO/EXAMPLESRC) SRCMBR(XSQL_ORDER) COMMIT(*NONE) NAMING(*SQL) DLYPRP(*YES) USRPRF(*USER) ERRLVL(30) Add the aXes product library to your library list. For example: ADDLIBLE AXES Then use the AXCPYXMP program to copy the files for each example suite. This program accepts two parameters. The first parameter is the name of the example suite. The second parameter is the name of the installed aXes base directory.

For example, to copy the tutorials, run the following command: CALL AXESDEMO/AXCPYXMP (‘TUTORIALS’ ‘/aXes’) To copy the enquiry example, run the following command: CALL AXESDEMO/AXCPYXMP (‘ENQUIRY’ ‘/aXes’) To copy the soccer example, run the following command: CALL AXESDEMO/AXCPYXMP (‘SOCCER’ ‘/aXes’)

To copy the images for the Item List example, run the following command: CALL AXESDEMO/AXCPYXMP (‘IMAGES’ ‘/aXes’) Where /aXes is the name of the installed aXes base directory. Note: You must have write (*W) and execute (*X) authority to the target AGI and samples directories to successfully copy the files. The <base-dir>/agi directory which is where the Lua scripts are kept.


Version 1.23 01.26.05

Customer Maintenance Application aXes comes with a sample customer maintenance application that gives an example of keywords that can be used in the DDS to give an application a modern "Look and Feel" by adding Radio Buttons, Check Boxes, Scroll Bars, Dropdowns and Pushbuttons.

To access this application, add AXESDEMO to your library list. On the command line, enter

CALL CUSTMAINT. This is an interactive application where data can be added, edited and deleted.

The source for this application is included when you install aXes on your iSeries. To view the source, do a WRKMBRPDM. The File is EXAMPLESRC, the Library is AXESDEMO and the Member is CUSTMAINTD.

Item List Application (HTML Keyword Support) aXes comes with a sample item list application that gives an example of how the HTML Keyword can be Utilized. that can be used in the DDS to give an application a modern "Look and Feel" by adding Radio Buttons, Check Boxes, Scroll Bars, Dropdowns and Pushbuttons.

To access this application, add AXESDEMO to your library list. On the command line, enter

CALL ITEMLIST. This is an interactive application where data can be added, edited and deleted.

The source for this application is included when you install aXes on your iSeries. To view the source, do a WRKMBRPDM. The File is EXAMPLESRC, the Library is AXESDEMO and the Member is ITEMLISTD.


Version 1.23 01.26.05

aXes Administrator

Login to aXes Administrator

From the aXes homepage, under the TS Administration heading, click on TS Statistics or TS Sessions. A login box will appear prompting for an aXes Administrator User ID and Password. The default settings are admin for the User ID and Password. The default settings can be changed if needed. Please contact Linoma Software for the steps to change.

TS Statistics

When viewing the Terminal Server Statistics, the stats that you will want to take note of:

Terminal Connections - The number of users that are logged in through aXes

Transactions - The number of transactions that performed through aXes

Average Transaction Time (msecs) - The average time in milliseconds that it takes aXes to perform the transaction

Average Transaction (compressed) - The average size of the packet that aXes is serving to the web. Typically, the packet should be between 1 and 1.5 K.

Average Transaction (uncompressed) - The average size of the packet that aXes would be serving to the web if it were not compressed.

Compression Ratio - This shows the ratio at which aXes is compressing the packet to.

TS Sessions

The aXes TS Sessions page can be used for seeing what users are logged in through aXes as it will show the iSeries User ID. You will also be able to see what Device Name they are using as well as the type of CPW (B for Batch, I for Interactive), what IP Address the user connected from and what their status is.

If you left click on the User ID, a second window will open to show what screen the user is currently in. This tool can be effectively used for a Help Desk when needing to provide support for the user. The Administrator has the ability to log the user out of the session by clicking the Close User Session button on the bottom of the skin.


Version 1.23 01.26.05

Advance 5250 Keywords Here is a list of Advanced 5250 Keywords supported by IBM that may be used to change the Look & Feel of your applications by using these keywords. The keywords with an * denote usage in the Customer Maintenance applications:

CHCACCEL (Choice Accelerator Text) Specifies the text for the accelerator key on a single-choice selection field in a pull-down record.

**CHCAVAIL (Choice Color/Display Attribute when Available) Specifies the color or display attributes to be used when displaying the available choices in a menu bar or selection field.

**CHCCTL (Choice Control) Controls the availability of the choices for the field.

**CHCSLT (Choice Color/Display Attribute when Selected) Specifies the color or display attributes to be used when displaying a selected choice in a menu bar.

**CHCUNAVAIL (Choice Color/Display Attribute when Unavailable) Specifies the color or display attributes to be used when displaying the unavailable choices in a selection field.

**CHOICE (Selection Field Choice) Defines a choice for a selection field.

CNTFLD (Continued-Entry Field) Defines a field as a continued-entry field. Continued-entry fields are sets of associated entry fields that are treated by the work station controller as a single entry field during field data entry and editing.

EDTMSK (Edit Mask) Defines an edit mask for fields with EDTCDE or EDTWRD keywords.

**ENTFLDATR (Entry-Field Attribute) Defines the leading attribute of the field that changes to a specified attribute whenever the cursor enters the field. When defined at both the field- and record-level, the field-level specification is used for the field.

FLDCSRPRG (Cursor Progression Field) Defines the next field that the cursor moves to when exiting this field.

GRDATR (Grid Line Attribute) Defines the color and line-type attributes for grid line structures in the file or record.

GRDBOX (Grid Box) Defines the shape, positioning, and attributes of a box.

GRDCLR (Grid Clear) Defines a rectangular area on a display within which all grid structures are erased.

GRDLIN (Grid Line) Defines the shape, positioning, and attributes of a grid line.

GRDRCD (Grid Record) Specifies that this record defines grid structures. No other display fields are allowed on records with this keyword.

HLPID (Help Identifier) Specifies an identifier for the constant in the help for a field.

**MLTCHCFLD (Multiple-Choice Selection Field) |Defines a field as a multiple-choice selection field. A multiple-choice selection field is a field that contains a fixed number of choices from which a user can select multiple choices.

**MNUBAR (Menu Bar) Defines a menu bar. A menu bar is a horizontal list of choices that is followed by a separator line.

**MNUBARCHC (Menu-Bar Choice) Defines a choice for a menu-bar field. A menu-bar choice represents a group of related actions that the application user can select.


Version 1.23 01.26.05

**MNUBARDSP (Menu-Bar Display) Displays the menu bar.

MNUBARSEP (Menu-Bar Separator) Specifies the color, display attributes, or character used to form the menu-bar separator line.

**MNUBARSW (Menu-Bar Switch Key) Assigns a CA key to the Switch-to-menu-bar key.

**MNUCNL (Menu Cancel Key) Assigns a CA key to be the cancel key for menu bars or pull-down menus.

MOUBTN (Programmable Mouse Button) Allows an attention indicator (AID) to be associated with various pointer device events.

**PSHBTNCHC (Push Button Choice) Defines a push button within a push button field.

**PSHBTNFLD (Push Button Field) Defines a field as a push button field. A push button field is a field that contains a fixed number of push buttons.

**PULLDOWN (Pull-Down Menu) Defines a record as a pull-down menu for a menu bar.

SFLCSRPRG (Subfile Cursor Progression) Causes the cursor to move to the same input field in the next subfile record when exiting this field.

SFLCHCCTL (Subfile Choice Control) Controls the availability of the choices in a selection list.

SFLEND (Subfile End) Displays a plus sign (+) or text (More... or Bottom) in the lower right location of the subfile. It can also display a scroll bar.

SFLMLTCHC (Subfile Multiple-Choice Selection List) Defines a subfile as a multiple-choice selection list. A multiple-choice selection list is a potentially scrollable list from which the user can select one or more items.

SFLRCDNBR (Subfile Record Number) Displays the page of the subfile containing the record whose relative record number is in this field.

SFLRTNSEL (Subfile Return Selected Choice) Returns all selected choices in a selection list using the get-next-changed operation.

SFLSCROLL (Subfile Scroll) Returns the relative record number of the subfile record that is at the top of the subfile when control is given to the application.

SFLSIZ (Subfile Size) Specifies the number of records in the subfile.

**SFLSNGCHC (Subfile Single-Choice Selection List) Defines a subfile as a single-choice selection list. A single-choice selection list is a potentially scrollable list from which the user can select one item.

**SNGCHCFLD (Single-Choice Selection Field) Defines a field as a single-choice selection field. A single-choice selection field is a field that contains a fixed number of choices from which a user can select one choice.


Version 1.23 01.26.05

Uninstalling aXes Entire Removal

You can if you wish, remove aXes entirely, including all user data. If you do this, you should save your user data first. It will not be recoverable.

To perform this removal:

Sign on to your iSeries using a suitably authorized profile. We recommend you use the QSECOFR user profile to avoid any authorization problems although any user profile with *ALLOBJ should work.

End any active aXes server instances by entering: ENDAXESTS INSTANCE(*ALL) ENDAXESW3 INSTANCE(*ALL)

End the aXes Subsystem by entering: ENDSBS SBS(AXES)

Ensure that no locks are held on the library AXES. Use the Work with Object Locks command. For example: WRKOBJLCK OBJ(AXES) OBJTYPE(*LIB)

Use the Delete Licensed Program (DLTLICPGM) command to delete the base product and any installed options. To delete the base product and any installed options enter: DLTLICPGM LICPGM(1AXES01) OPTION(*ALL)

Identify all the users who may belong to the AXES_GROUP or AXES profiles. Use the Display User Profile (DSPUSRPRF) command to display a list of them. You must remove the AXES_GROUP and AXES profiles from these user profiles before you can delete the AXES_GROUP and AXES profiles. The format of the command is: DSPUSRPRF USRPRF(AXES_GROUP) TYPE(*GRPMBR) For each of the user profiles AXES_GROUP and AXES, use the Work with Object Owner (WRKOBJOWN) command to list all the objects owned by the profile. The format of the command is: WRKOBJOWN USRPRF(user-profile) You must alter the ownership or delete the objects.

Delete the AXES_GROUP and AXES user profiles. The format of the command is: DLTUSRPRF USRPRF(user-profile) Remove *JOBCTL special authority from the QTMHHTTP user profile. Note: You should not perform this step if your organization has specifically added *JOBCTL special authority to the QTMHHTTP user profile.

Delete any user copies you may have made of the aXes skins directories. Do this using the Edit File (EDTF) command and then use option 9 for the directory. Alternatively, you can remove the aXes skins directories by repeated use of the RMVLNK and RMVDIR commands.


Version 1.23 01.26.05

About Linoma Software

The Company Since our start in Omaha, Nebraska in 1994, we have built a large base of satisfied clients around the world. You are encouraged to review the many positive testimonials and product reviews on our web site at www.linomasoftware.com. Customer references can also be supplied upon request.

Linoma Software’s success has been built on being very responsive to our customer’s requests. If you have any suggestions on how we can improve our products to make your job easier, please let us know. An IBM Advanced Business Partner with a solid reputation, Linoma Software is recognized for creating innovative and cost-effective I.T. solutions.

Linoma Logic

Linoma Logic is our technology services division www.linomalogic.com. Linoma Logic’s skilled consultants are trained in the latest iSeries, Internet and Java technologies. Our goal is to help iSeries users take advantage of technologies and become more productive in their everyday work.

Contact Us

Electronic

Sales [email protected]

Support [email protected]

Website www.linomasoftware.com

Phone Numbers

Toll-free: 1-800-949-4696

Outside USA: (402) 944-4242

Fax: (402) 944-4243

Address

Linoma Software

1409 Silver Street

Ashland, NE 68003 USA

v1.23 aXes Getting Started Guide - HelpSystems · Any iSeries or AS/400 model running OS/400 V4R4M0...

Documents

Transcript of v1.23 aXes Getting Started Guide - HelpSystems · Any iSeries or AS/400 model running OS/400 V4R4M0...