RAMP-NL Guide
Table of contents
- RAMP-NL Guide
- How to Get Started with RAMP
- Prerequisite Skills
- What is RAMP? - 9 minutes
- 5250 Application before using RAMP - 2 minutes
- 5250 Application after using RAMP - 4 minutes
- Stage 1: Creating a Modernization Framework - 8 minutes
- Stage 2: Snapping the 5250 Application in the Framework - 11 minutes
- Stage 3: Enrichment and Re-engineering - 5 minutes
- What's New
- New features in EPC 831 Version of RAMP
- Dynamic Naming of Newlook Screens and Fields
- Using Dynamic Naming
- Dynamic Naming Dialog Details
- Frequently Asked Questions
- Backing Up Screen Definitions
- New IIPs for Windows
- New features in EPC 826 Version of RAMP
- New features in EPC 804 Version of RAMP
- New features in EPC 793 Version of RAMP
- New features in EPC 785 Version of RAMP
- Licensing Requirements
- Complete Licensing Details
- More About Newlook Licensing
- Installation and Configuration
- Installation
- Install RAMP
- Install newlook
- Configuration
- Verify newlook Installation
- Verify Internet Explorer Security Settings
- Configure newlook
- Merge Shipped Macros into newlook
- VF_XP.nlg
- VF_MACRO.sid
- Configure newlook for a Windows Look and Feel
- Change the Scheme
- Change the Background
- Ensure newlook uses the Windows Themes
- Suppress newlook Sounds
- Configure RAMP
- Specify Server Details
- Set up Super-Server Session
- Optionally Set up Framework Users and Security
- Optionally Configure newlook User Profile and Password in the Framework
- Starting the Framework on the Web
- When Many Developers Work on the Same Application
- Handle Multiple Framework Versions
- Multiple Developers Using newlook
- Script Naming Convention
- Starting RAMP
- Start LANSA
- Start the Framework
- Start RAMP
- Start newlook
- Start the Instant Prototyping Assistant
- Start the Program Coding Assistant
- Concepts
- Steps Involved in Using RAMP
- Framework Window
- RAMP Window
- Message Area
- Screen Tracking Area
- newlook Emulator Session
- Screen and Script List
- Organizing Screens and Scripts
- Details Area
- Session Details
- Hide screen titles in RAMP Screens
- Two Ways to Hide the Title
- Destination Screen Details
- Script Details
- Types of Screens
- Destination Screen
- Junction Screen
- Special Screen
- OBJECT-ACTION User Interfaces
- Modernization Issues
- The most important and complex 5250 program in an application can become a modernization trap
- How long will it take to RAMP my application?
- Tutorials
- Modernizing a Complete Application
- Application before Modernization - 2.5 minutes
- Movie Summary
- Modernized Application - 2 minutes
- Movie Summary
- Identify your business objects - 1 minute
- Movie Summary
- Create a prototype of your application - 3 minutes
- Movie Summary
- Create a filter and snap it in - 4 minutes
- Movie Summary
- Make a plan of the 5250 screens you will need to use - 2.5 minutes
- Movie Summary
- Identify the relevant screens and fields to newlook - 4 minutes
- Movie Summary
- Define the screens to the VLF and build a navigation script (New Employee) - 7.5 minutes
- Movie Summary
- Define the screens to the VLF and build a navigation script (Employee Details) - 5 minutes
- Movie Summary
- Link the Selected Employee in the Instance List with the Display Employee Screen - 4 minutes
- Movie Summary
- Make Function Keys Go Somewhere Different - 4.5 minutes
- Movie Summary
- Handle Unexpected Stops in Navigation and Messages - 3 minutes
- Movie Summary
- Update the Instance List from 5250 Screens - 4 minutes
- Movie Summary
- Modernizing Application Navigation
- Modernized Navigation - 5 minutes
- Movie Summary
- Create a Prototype of Your Application - 9.5 minutes
- Movie Summary
- Identify Your 5250 Entry Point Screens Using newlook - 13 minutes
- Movie Summary
- Script the Screens and Snap them in the Framework - 16 minutes
- Movie Summary
- Scripting Tutorials
- Scripting
- Learning
- Introduction to Scripts - 6.5 minutes
- Movie Summary
- Types of Scripts in RAMP
- Scripts in a Classic Details Display
- Invoke Script
- Return Script
- Button Script
- Navigate Script
- Eliminate Script
- Generate Scripts Automatically
- Reading, Writing and Storing Values in Scripts - 4 minutes
- Movie Summary
- Javascript Essentials
- External JavaScript Documentation
- Alert()
- Converting Numbers to Strings
- Converting String to Numbers
- String Manipulation Functions
- Is This Variable Number or String?
- Using the objGlobal Object
- Getting Organized
- Using objGlobal to pass optional parameters
- Using objGlobal to pass optional parameters to an INVOKE script
- Using objGlobal to define commonly used functions
- Using
- Interacting with Instance Lists in Scripts
- The List Manager
- Visual and Programmatic Identifiers
- Working with All Selected Entries
- Using the Scripting Pop-up Menu
- Replacing Hardcoded User Name with Current Framework User
- Replacing Hardcoded Employee Number with Current Instance List Entry
- Adding Your Own Options to the Scripting Pop-Up Menu
- Updating the Instance List from RAMP screens
- Filter Code which Automatically Handles Changes to Instance List
- Subfiles/Browselists
- Not Using a Datagrid Control - 1 minute
- Movie Summary
- Using Subfile Accessor - 5 minutes
- Movie Summary
- Subfile Direct Access - 2 minutes
- Movie Summary
- Locating and Selecting an Entry in a System i Subfile/LANSA Browselist
- Script for Locating an Entry in a Subfile/Browselist
- Script for Locating and Selecting an Entry in a Browselist or Subfile by Positioning the Cursor
- Script for Locating an Entry when no Positioning is Available
- Script for Locating an Entry when no Positioning is Available and the List has more than One Page
- Handling Pop-Ups
- During Navigation
- Pop-up as Destination
- When Triggered by Button Click or Function Key Press
- Forcing a Pop-Up to Front
- How to Turn Pop-Ups into Full Screens
- Script Functions
- SETFOCUS Function
- GETFOCUS Function
- MAKESUBFILEINTOSTRING Function
- COPYTOCLIPBOARD Function
- FATAL_MESSAGE_TYPE Function
- SET_UNKNOWN_LOCKING Function
- SETKEYENABLED Function
- SETVALUE Function
- GETVALUE Function
- SENDKEY Function
- CHECK_CURRENT_FORM Function
- AVCLOSEFORM Function
- HIDE_CURRENT_FORM Function
- CURRENT_FORM Function
- SETCURSOR Function
- ALERT_MESSAGE Function
- CLEAR_MESSAGES Function
- FATAL_MESSAGE Function
- MESSAGE Function
- AVSIGNALEVENT Function
- TRACE Function
- RUNMACRO Function
- NAVIGATE_TO_JUNCTION Function
- HANDLE_PROMPT Function
- NAVIGATE_TO_DESTINATION Function
- NAVIGATE_TO_PREV_DESTINATION Function
- GET_MENU_OPTION_NUMBER Function
- STRIP_LEADING_NUMBERS Function
- ADD_STRING Function
- STRING Function
- OVERRIDE_BUTTONS_UNDEFINED_SCREENS Function
- OVERRIDE_KEY_CAPTION_SCREEN Function
- OVERRIDE_KEY_CAPTION_ALL Function
- AVSAVEVALUE Function
- AVRESTOREAVALUE and AVRESTORENVALUE Function
- SET_LOCK_MESSAGE Function
- ADD_UNKNOWN_FORM_GUESS Function
- FORCE_POPUP_REFRESH Function
- SET_HANDLER_CAPTION Function
- Framework Objects that Scripts Can Refer To
- objGlobal
- objFramework
- objApplication
- objBusinessObject
- objCommand
- objListManager
- objUser
- SUBFILE_ACCESSOR Object
- Function Key Names for SENDKEY Function
- User-defined script functions
- Switching Off Recursion Checking
- Debugging
- Debug and Diagnostics - 2.5 minutes
- Movie Summary
- Common Scripting Errors
- NAVIGATE_TO_JUNCTION request failed
- Unable to display form
- Script with identifier XYZ not found
- Could not complete the operation due to error 80020101
- Object expected
- Strange behavior in scripts
- Your script does not execute at all
- Tracing
- Using ALERT_MESSAGE in Your Scripts
- Screen Wrappers
- When to Use 5250 Screen Wrappers?
- Screen Wrapper Fundamentals
- Events
- RampMessage Event
- RampAvailable Event
- Methods
- MakeRampAvailable Method
- NavigateToScreen Method
- SetValue Method
- GetValue Method
- SendKey Method
- Current_Form Method
- SetCursor Method
- Examples
- Example 1: Show Employee Details.
- Example 2: Show Employee Details and Skills
- Example 3: Show the System i Disk Usage
- Programming Techniques
- Handling a Single Screen which Shows Multiple Modes
- Handling Multi-5250 Screen Data Entry
- Short-circuiting Navigation
- A Command Handler Tab with Many 5250 Destinations
- A User Controlled Command Tab with Many Destinations
- A Program Controlled Command Tab with Many Destinations
- Using this Approach in other Situations
- Advanced Prompting
- Using Prompter Forms
- Are any Examples Provided to Learn More about this Topic?
- A RAMP Design Approach Using a Single Junction Point (SJP)
- How does an SJP work?
- Is an SJP really that simple in a real application?
- Can SJP do the other useful things?
- Does SJP have to be CL (Control Language) program?
- What other issues might impact the use on an SJP approach?
- Using HIDE_CURRENT_FORM to manage access to command handler tabs
- Multilingual RAMP Applications
- Troubleshooting
- An unexpected database error has occurred
- xxxxxxx is an orphan script and should be deleted
- Navigation is Incorrect, but there is no error message
- Keystroke is ignored
- RAMP does not recognise the name of forms that I have defined recently or any other newlook definition changes
- The connection to <newlook server name> has not been defined
- Script cannot be generated at this time
- TCP/IP timeout has occurred
- TCP/IP host was not found
- Screen does not react when selection is changed in instance list
- A Screen is not recognized
- newlook cannot be started in the RAMP Window
- Subfile accessor only reads the first page
- Error running RAMP in end-user mode (UF_EXEC) but not in design mode (UF_DESGN)
- RAMP Choreographer does not recognize a screen that has a name in newlook Designer
- Frequently Asked Questions
- How is my newlook license type determined when starting newlook?
- How can I use web browser windows from RAMP scripts?
- How can I get the message from the bottom of the current 5250 screen into my RAMP script?
- How do I handle RA (Auto Record Advance) fields?
- Why does my newlook session have a message "Press SPACEBAR or ENTER to activate and use this control"?
- What is the difference between newlook Designer and newlook Emulator Session?
- Why should the F12=Cancel and F3=Exit buttons and function keys be disabled on every 5250 screen?
- I have defined a screen as a junction, but it should be destination. How do I change it?
- Do I have to identify and script every 5250 screen in my application to modernize it?
- How can I get the RAMP tool to assign a fixed session?
- How do I make my scripts work in multiple partitions?
- How can I change the background color of RAMP screens?
- How can I suppress the action of Alt + F4 inside Newlook?
- Movie Index