documentation
.HELP!
RAMP-NL Documentation
Installation
RAMP-NL
previous page
next page
Installation
Install RAMP
Install newlook
previous page
start
next page
Menu
Homepage
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
Get in touch
Submit feedback about this site to:
[email protected]