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.
After starting the first session, while debug or profile options are still present from a previous login, you are asked whether the options must remain.

If you click Yes, the options and settings are removed. You must continue in a new connection.

If you click No, you can continue with the started session and the Bshell profile or debug settings.

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.