Debug and Profile 4GL (ttadv1123m000)
Use this session to test software components that are checked out to an LN Studio activity.
Session usage
When you test a component, you must specify the activity to which the component belongs and the corresponding activity context. You must also specify the application to which this activity belongs. If LN Studio is running, the user's current activity is automatically filled in as default value in the Activity Name field. The Application Name and Context fields are also automatically filled in.
In some situations, you must specify multiple activities. The source code of a component can call several other components that are checked out to different activities. When you test the component, you must specify these activities and the corresponding activity context. You must also specify the applications to which these activities belong. The session searches for the components in the corresponding VRCs. For details on applications, activities, and activity context, see the LN Studio documentation.
Optionally, use the Enable Call Graph Profiler group to specify profiling parameters. Profiling is used to show performance statistics for a session. See "The Call Graph Profiler" in the Infor ES Programmer's Guide.
Example
A session is checked out to activity A. Activity A belongs to application 1. The session calls these components:
- Component X, checked out to activity B. Activity B belongs to application 2.
- Component Y, checked out to activity C. Activity C belongs to application 3.
To test the session, you must specify this information:
- Application 1, activity A and its context.
- Application 2, activity B and its context.
- Application 3, activity C and its context.
Buttons
These buttons are available:
- Clear Debug State
- Removes the debug model. All breakpoints, expressions, and preselected sources are removed. This can be required if a new debug model version is introduced.
- Clear Settings
- Click this button to remove the present profile options for the user. The debug options are also removed.
- Clear Context
- Resets the context settings to their default values. The data on the screen is unchanged. When you restart the session, the default values are displayed.
- Download Profile Zip
- Click this button to download the profile files of the current bshell in a zip
file. Only files of the current bshell are included. Files of parallel bshells are
not included.
You can only download a zip file if you have selected the Enable Call Graph Profiler check box and then opened and closed at least one session.
Field Information
- General
-
- Package Combination
-
Your current package combination.
- Debug Mode
-
Select this check box if you want to debug sessions.
You can only select this check box if there is an active connection with LN Studio.
- Debug UI
-
Select the debug UI in which you want to run the debug mode:
- LN Studio
-
Debug Workbench
For details, see the Infor LN Debugger Workbench User Guide.
- Activities
-
- Application Name
-
An LN Studio application.
For details on the applications you must specify, see Session usage.
- Activity Name
-
An LN Studio activity.
For details on the activities you must specify, see Session usage.
- Context
-
The context of a selected activity.
See Session usage.
Default value
The activity context specified in LN Studio.
- Debug level
-
- Debug level
-
You can select the Debug level to use for debugging. This applies to both: LN Studio and Debugger Workbench.
These levels are available:
-
Extension
This is the lowest debug level. The debugger stops only in sources that are owned by the user, such as Extensions, Document Types and Exchange Scripts. Everyone has authorization for this level.
-
LN Application
In addition to everything the Extension level does, this level also shows debug information of the LN Application.
In debugger workbench, only Infor engineers and support engineers have authorization.
In LN Studio, all Infor engineers can debug at this level.
-
ES Application
In addition to everything the LN Application level does, this level also shows debug information for components of the Enterprise Server application.
In debugger workbench, only Infor engineers and support engineers have this level after being Authorized by Azure.
In LN Studio, all Infor Tools engineers can debug at this level.
-
ES 4GL Engine
This is the highest debug level, showing debug information for components of the ES 4GL Engine. This is for Infor engineers only.
In debugger workbench, only Infor engineers and support engineers have this level after being Authorized by Azure.
In LN Studio, all Infor Tools engineers can debug at this level.
Levels are incremental, so if you have authorization for ES 4GL Engine, you have also authorization for all other levels.
-
- Enable Call Graph Profiler
-
- Enable Call Graph Profiler
-
If this check box is selected, you can specify profiling parameters. When you run and exit the session, a Call Graph Profile is generated.
- Filter
-
If this check box is selected, you can specify a filter in the next field.
This field corresponds with the value of the PROFILE_ALL variable. See "The Call Graph Profiler" in the Infor ES Programmers Guide (Infor Support Portal KB 22924522).
- Filter
-
Use this field to specify a filter. You can, for example, specify the name of an object. The generated profile contains only statistics for the specified object.
- Add Listed Bshell Functions to Profile
-
Use this field to specify bshell functions which are normally not traced. You can, for example, specify a comma-separated list of bshell functions.
An asterisk at the end of the string can be used to profile multiple functions. For example:
alloc.mem, dal.*
This field corresponds with the value of the PROFILE_TRAMPOLINE.
- Alternative Directory on Infor LN Server
-
If this check box is selected, you can specify a directory on the LN server to store the Call Graph Profile files.
- Alternative Directory on Infor LN Server
-
The directory on the LN server to store the Call Graph Profile files.
The default value is $BSE_TMP.
This field corresponds with the PROF_DIR variable. See "The Call Graph Profiler" in the Infor ES Programmers Guide (Infor Support Portal KB 22924522).
- Start Options for Other Bshells
-
- Keep Profile Options for next Login
-
If this check box is selected, the profile options are saved for the user on save and exit. New Bshells for the user are started with the profile options.
- Clear Settings
-
If this check box is selected, new Bshells for the user are started with profile or debug options. The debug bshell uses the same functionality.
- Profiler Options for Another User
-
- User
-
Select a user.
With this option you can activate Call Graph Profile for, for example an ION user (ion_ln), who cannot login to set the profile options.
- Save Setting User
-
If this check box is selected, the button becomes active to save the Bshell profile settings.
- Clear Setting User
-
If this check box is selected, the button becomes active to remove the present Profile options for the user.
- Expiry Time of Start Options
-
- Expires After
-
Specify the expiry time for the user start options to add to the User Option File.
- Expired On
-
Specify the expiry date and time for the start options to add to the User Option File.