Visual LANSA Administrator's Guide
Last updated February 20, 2017
© LANSA
| 1. Planning a New Installation |
|
| 2. Getting Started with Administration |
|
| 2.1 Installing LANSA |
|
| 2.1.1 Installing Visual LANSA |
|
| 2.1.2 Upgrading Visual LANSA |
|
| 2.1.3 Applying EPCs |
|
| 2.1.4 Visual LANSA Administration |
|
| 2.2 Independent System Administration with a VCS Master |
|
| 2.3 Independent System Administration |
|
| 2.3.1 Maintaining System Definitions on Independent Systems |
|
| 2.3.2 Maintaining Partition Definitions on Independent Systems |
|
| 2.3.3 Maintaining Users and Tasks on Independent Systems |
|
| 2.4 Slave System Administration |
|
| 2.4.1 Maintaining System Definitions on Slave Systems |
|
| 2.4.2 Maintaining Partition Definitions on Slave Systems |
|
| 2.4.3 Maintaining Users and Tasks on Slave Systems |
|
| 2.4.4 Configure LANSA Communications Software |
|
| 2.5 Development Environment Administration |
|
| 2.5.1 Controlling How Developers Work |
|
| 2.5.2 Controlling What Developers Can Build |
|
| 2.5.3 Import/Export Operations |
|
| 2.5.4 Development Environment Settings |
|
| 2.5.5 Setting Systems Information |
|
| 3. Visual LANSA Logon |
|
| 3.1 Visual LANSA Logon without a VCS Master |
|
| 3.2 Visual LANSA Logon with a VCS Master |
|
| 3.3 Logon Parameters |
|
| 3.3.1 User ID |
|
| 3.3.2 Password |
|
| 3.3.3 Use Windows Credentials |
|
| 3.3.4 Partition |
|
| 3.3.5 Current Language |
|
| 3.3.6 Task ID |
|
| 3.3.7 Messages |
|
| 4. Visual LANSA Initialization |
|
| 4.1 VCS Master Setup for Vault VCS |
|
| 4.1.1 Considerations when Installing a New VCS Master for Vault VCS |
|
| 4.1.2 Migrating a Partition from a Slave to a VCS Master for Vault VCS |
|
| 4.1.3 Setting up 2nd and Subsequent Developers to use a VCS Master for Vault VCS |
|
| 4.1.4 Release Management with a VCS Master for Vault VCS |
|
| 4.1.5 Upgrading a VCS Master for Vault VCS |
|
| 4.2 VCS Master Setup for Git VCS in the Cloud |
|
| 4.2.1 Considerations when Installing a New VCS Master for Git in the Cloud |
|
| 4.2.2 Setting up a New VCS Master for Git in the Cloud |
|
| 4.2.3 Migrating a Partition from a Slave to a VCS Master for Git in the Cloud |
|
| 4.2.4 Sharing a Git Repository with GitLab |
|
| 4.2.5 Setting up 2nd and Subsequent Developers to use a VCS Master for Git in the Cloud |
|
| 4.2.6 Release Management with a VCS Master for Git in the Cloud |
|
| 4.2.7 Upgrading a VCS Master for Git in the Cloud |
|
| 4.3 System Initialization |
|
| 4.3.1 Restricted System Initialization when another user is logged into Visual LANSA |
|
| 4.3.2 LANSA System Type |
|
| 4.3.3 Connect to Master |
|
| 4.3.4 Location of Imports |
|
| 4.3.5 RDML Command Definitions |
|
| 4.3.6 Standard Application Templates |
|
| 4.3.7 Standard Built-in Function Definitions |
|
| 4.3.8 Standard System Message File |
|
| 4.3.9 Standard System Variables |
|
| 4.3.10 Example User/Task |
|
| 4.3.11 Example Partition Definition |
|
| 4.3.12 Enrolled PC Names |
|
| 4.3.13 Enrolled PC Users |
|
| 4.3.14 Current Task List |
|
| 4.3.15 Partition Definitions |
|
| 4.3.16 Master's LU Name |
|
| 4.3.17 Master's User Name |
|
| 4.3.18 Master's Password |
|
| 4.3.19 Use Windows credentials |
|
| 4.3.20 Client -> Server Translation Table |
|
| 4.3.21 Server -> Client Translation Table |
|
| 4.3.22 Show Last Log |
|
| 4.4 Partition Initialization |
|
| 4.4.1 Mandatory Partition Initialization |
|
| 4.4.2 Visual LANSA Framework (VLF) |
|
| 4.4.3 Include VLF WAM Development support |
|
| 4.4.4 WAM Development |
|
| 4.4.5 LANSA Client field and file definitions |
|
| 4.4.6 Demonstration Material |
|
| 4.4.7 Show Last Log Button |
|
| 4.5 Single Sign-On (SSO) |
|
| 4.5.1 How LANSA SSO Works |
|
| 5. Remote Systems |
|
| 5.1 Remote System Terms |
|
| 5.2 Host Monitor Concepts |
|
| 5.2.1 Connect Master and Slave Systems |
|
| 5.2.2 Host Monitor and Visual LANSA Slave Repositories |
|
| 5.2.3 Access the Master System |
|
| 5.2.4 Example Development Cycle (with Master) |
|
| 5.3 Deliver To Concepts |
|
| 5.3.1 Restrictions and Assumptions |
|
| 5.3.2 Linux Deployment System Development Cycle Example |
|
| 5.3.3 IBM i Deployment System Development Cycle Example |
|
| 5.4 Host Monitor |
|
| 5.5 Check Out |
|
| 5.5.1 Check Out Options |
|
| 5.6 Check In |
|
| 5.6.1 Check In Options |
|
| 5.6.2 Check In Joblog Viewer |
|
| 5.7 Copy file data from IBM i |
|
| 5.8 Propagation |
|
| 5.9 Start and Stop the Host Monitor |
|
| 5.10 Refresh Master Object List |
|
| 5.11 Other Remote System Monitors |
|
| 5.12 Define a Deployment System |
|
| 5.13 Refresh System Information from the Deployment System |
|
| 5.14 Select/Create a task for the Deliver To process |
|
| 5.15 Initialize the Partition on the Deployment System |
|
| 5.16 Deliver To |
|
| 5.16.1 Deliver To Options |
|
| 5.16.2 Deliver to Connection |
|
| 5.16.3 Deliver to Joblog Viewer |
|
| 5.17 Disconnect from a Remote System Monitor |
|
| 5.18 Job Status and Messages |
|
| 5.19 Detailed Messages |
|
| 6. Change Management |
|
| 6.1 Change Management Concepts |
|
| 6.1.1 Object Locking Concepts |
|
| 6.1.2 Task Tracking Concepts |
|
| 6.1.3 Impact Analysis Concepts |
|
| 6.1.4 Deployment Concepts |
|
| 6.1.5 Third Party Packages |
|
| 6.2 Using Task Tracking in LANSA |
|
| 6.2.1 Introduction to Task Tracking |
|
| Tracked Objects |
|
| Task Identifier Rules |
|
| 6.2.2 Approaches for using Task Tracking |
|
| Choose Your Task Tracking Approach |
|
| Full Task-Oriented Tracking |
|
| Tracking by Product |
|
| Tracking By Developer |
|
| Minimum Tracking |
|
| Combined Approaches |
|
| 6.2.3 Task Tracking Set up |
|
| Set Task Tracking System Options |
|
| Set Task Tracking Partition Options |
|
| Set Special Task ID |
|
| Define Task IDs |
|
| Share Task IDs |
|
| Change Current Task |
|
| Unlock Objects in Task Tracking |
|
| Process/Function Locking |
|
| Transfer Object Locks |
|
| Task Tracking and Repository Synchronization |
|
| Special Authorities and Task Tracking |
|
| Task Tracking Recommendations |
|
| Task Tracking in Master/Slave Systems |
|
| Task Tracking on Independent Systems |
|
| 6.2.4 What Happens When Task Tracking Is Active? |
|
| 6.2.5 Typical Development Cycle Example |
|
| 6.2.6 Task Tracking and Import/Export |
|
| 6.3 Repository Synchronization |
|
| 6.3.1 Repository Synchronization Concepts |
|
| 6.3.2 What Are Repository Groups? |
|
| 6.3.3 What are Work Groups? |
|
| 6.3.4 Rules for Repository Synchronization |
|
| 6.3.5 Synchronization Options in Visual LANSA |
|
| 6.3.6 PC Options on Server |
|
| 6.3.7 Repository Synchronization Tips & Techniques |
|
| 7. System Information |
|
| 7.1 System Definitions |
|
| 7.1.1 Export and Import Options |
|
| 7.1.2 Task tracking |
|
| 7.1.3 Field and File defaults |
|
| 7.1.4 Compile and Edit Options |
|
| 7.1.5 Execution and Security |
|
| 7.1.6 Display and Print controls |
|
| 7.1.7 General Information |
|
| 7.2 X_LANSA.PRO Maintenance |
|
| 7.3 Partitions |
|
| 7.3.1 RDML and RDMLX Partitions Concepts |
|
| LANSA RDML Object Types |
|
| LANSA RDMLX Object Types |
|
| RDML and RDMLX Object Deployment |
|
| 7.3.2 Partition Definition Tab |
|
| Partition Name |
|
| Partition Description |
|
| Unique Object Prefix |
|
| Partition Security Officer |
|
| Module library |
|
| Default file library name |
|
| Include in library list |
|
| Partition is Multilingual |
|
| Web Enabled |
|
| SAA/CUA standard apply |
|
| Enable Documentor |
|
| User access enforced |
|
| Perform checks before propagated |
|
| Ignore propagated deletes |
|
| *ENDWHERESQL |
|
| 7.3.3 Task Tracking Partition Settings |
|
| Enable task tracking |
|
| Task is required |
|
| Confirm Task required |
|
| Allow Task to be Changed |
|
| Disable Task "work with" security |
|
| Active Task Tracking on Imports |
|
| 7.3.4 RDMLX Partition Settings |
|
| Enable partition for full RDMLX |
|
| Create Fields as RDMLX |
|
| Create File as RDMLX |
|
| Create Component as RDMLX |
|
| Create Function as RDMLX |
|
| Enable Short Char |
|
| 7.3.5 Enable Existing Partitions for Full RDMLX |
|
| Update LANSA for i Partition Definition |
|
| Refresh Visual LANSA Systems |
|
| Initialize LANSA for i Partition |
|
| Deploying RDMLX Applications to an IBM i |
|
| 7.3.6 Available Field Types in Partition |
|
| Common and Specialized Field Types |
|
| Field Type Enabled in Partition |
|
| 7.3.7 Universal interface options |
|
| Process Menu style |
|
| Uppercase process title |
|
| Uppercase function title |
|
| Display process date and time |
|
| Display function date and time |
|
| Display panel ID |
|
| Function key lines |
|
| Message line number |
|
| Border fill - top corner |
|
| Border fill – top and bottom |
|
| Border fill - sides |
|
| Border fill - bottom corner |
|
| 7.3.8 Supported Database Products |
|
| 7.4 Language Settings |
|
| 7.4.1 Language Definition |
|
| Partition description |
|
| Partition language code |
|
| Partition language description |
|
| Character set code page |
|
| Default language |
|
| Development language |
|
| DBCS support required |
|
| RLTB support required |
|
| Locale uppercasing required |
|
| IGC conversion required |
|
| IGC Function key |
|
| IGC Conversion Description |
|
| IGC Conversion Line number |
|
| IBM i EBCDIC CCSID |
|
| Windows ANSI code page |
|
| ISO language code |
|
| User Message files |
|
| 7.4.2 Menu Option Text |
|
| Process Menu Prompt Line |
|
| Help Option |
|
| Return Prefix |
|
| Exit Option |
|
| 7.4.3 Function Keys |
|
| 7.5 Frameworks |
|
| 7.5.1 Identifier 1 |
|
| 7.5.2 Identifier 2 |
|
| 7.5.3 System framework |
|
| 7.5.4 Short name |
|
| 7.5.5 Long name |
|
| 7.6 Groups |
|
| 7.6.1 Identifier 1 |
|
| 7.6.2 Identifier 2 |
|
| 7.6.3 System group |
|
| 7.6.4 Short name |
|
| 7.6.5 Long name |
|
| 7.7 Primitives |
|
| 7.8 Remote System Details |
|
| 7.9 User and Security Maintenance |
|
| 7.9.1 LANSA User Profiles and Security |
|
| 7.9.2 Types of User Profiles |
|
| 7.9.3 Create a User |
|
| User ID |
|
| Password |
|
| Confirm Password |
|
| Group Profile |
|
| 7.9.4 Maintain a User's Definition |
|
| Supplementary Groups |
|
| Kerberos Principal Names |
|
| 7.9.5 Maintain a User's Privileges |
|
| Field Privileges |
|
| File Privileges |
|
| Function Privileges |
|
| Process and Component Privileges |
|
| Multilingual Variable Privileges |
|
| System Variable Privileges |
|
| System Information Privileges |
|
| Visual LANSA Specific Privileges |
|
| 7.10 Task Maintenance |
|
| 7.10.1 Task Identifier |
|
| 7.10.2 Task Description |
|
| 7.10.3 Task Status |
|
| 7.10.4 Authorized Users |
|
| 7.11 Object Maintenance |
|
| 7.11.1 Object Maintenance Concepts |
|
| 7.11.2 Object name |
|
| 7.11.3 User Id |
|
| 7.11.4 Authority to Object Definition |
|
| 7.11.5 Authority to Object Data |
|
| 7.12 Application Templates |
|
| 7.12.1 Template Name |
|
| 7.12.2 Template Description |
|
| 7.12.3 Display sequence |
|
| 7.12.4 Extended description |
|
| 7.12.5 Initial public access |
|
| 8. Environment Settings |
|
| 8.1 LANSA Editor Settings |
|
| 8.2 Design View Language |
|
| 8.3 Development Language |
|
| 8.4 Object Locking |
|
| 8.5 Workstation Locks |
|
| 8.6 Language Options |
|
| 8.6.1 Message File Name |
|
| 8.6.2 Field Prefix Character |
|
| 8.6.3 Substitution Character for the @ Character |
|
| 8.6.4 Substitution Character for the $ Character |
|
| 8.7 Message File Maintenance |
|
| 8.7.1 1st level text contains |
|
| 8.7.2 2nd level text contains |
|
| 8.7.3 ID from |
|
| 8.7.4 ID to |
|
| 8.7.5 Add/Change Message Text |
|
| Message ID |
|
| First Level Text |
|
| Second Level Text |
|
| Substitution Variables |
|
| Substitution Variable Type |
|
| Substitution Variable Length |
|
| Substitution Variable Decimals |
|
| 8.8 Export and Import |
|
| 8.8.1 Quick Export |
|
| 8.8.2 LANSA Import |
|
| 8.8.3 Import Considerations |
|
| 8.8.4 LIMPORT |
|
| 8.8.5 LIMPORT (from IBM i) |
|
| 9. Compiler Settings |
|
| 10. Troubleshooting |
|
| 10.1 Reporting Problems to LANSA Support |
|
| 10.1.1 Problem Analysis |
|
| 10.1.2 Problem Details Checklist |
|
| 10.1.3 Procedure for Reporting Application Failures and Exceptions |
|
| 10.1.4 Requesting new Product Features and Enhancements |
|
| 10.2 Gathering Information About LANSA |
|
| 10.2.1 About LANSA for i |
|
| 10.2.2 About Visual LANSA |
|
| 10.2.3 EPC Listings |
|
| 10.2.4 X_ERR.LOG Files |
|
| 10.2.5 Dump Files |
|
| 10.2.6 Producing Debug Symbols for Your LANSA Application |
|
| 10.2.7 x_tracennn.txt files |
|
| Appendix A. LANSA's Customer Services |
|
| Education Services |
|
| Conferences and User Groups |
|
| LANSA Customer Support |
|
| Consulting Services |
|