Managing service entry points in the Remote Systems view

The Remote Systems view allows you to navigate your IBM® i programs and objects, and set and remove service entry points.

About this task

Note: All the instructions on this page apply equally to the Object Table view.

Setting and removing service entry points on program objects

About this task

A service entry point is set on an entry. An entry can be a program or service program, in which case you are setting a service entry point on all procedures in the program. Or an entry can be a module, which means that you are setting a service entry point on all procedures in the module. Or, an entry can be an individual procedure.

Procedure

  1. To set a service entry point on a program object in the Remote Systems view:
    1. Expand the Objects node and locate the program or service program in which you want to set the service entry point. You can set a service entry point on the entire program or service program, or you can set it on one of the program's modules or procedures. To set a service entry point on a module, expand the program or service program to list its modules, and then select the appropriate module. To set a service entry point on a procedure, expand a module and then select the appropriate procedure.
    2. When you have located the object in which you want to set the service entry point, right-click the object and choose Debug (Service Entry) > Set Service Entry Point from the pop-up menu.
  2. To remove a service entry point on a program object:
    1. Open the IBM i Service Entry Points view. In the toolbar, click the Remove service entry points icon (Remove service entry points icon (flat box)). (You can also remove service entry points by following the instructions in step 1 and selecting Debug(Service Entry) > Remove Service Entry Point

Results

Setting and removing service entry points on source files

Procedure

  1. In the Remote Systems view, you can set a service entry point from a source member in the Objects subsystem or from some specific file types in IFS (files with extensions .c, .cpp, .rpgle, .cblle, .clle). Right-click the source file and select Debug(Service Entry) > Set Service Entry Point from the pop-up menu. A dialog opens. The Connection, Library, Program or Service Program, Module, Procedure, and User ID fields are pre-filled. You can change any of these settings. In the case of IFS files, the program field is not filled. You have to fill in the name of the program.
  2. Click OK to set the service entry point.

Results

After setting a service entry point, the IBM i Service Entry Points view will automatically open, if it is not already open.

Trying to set a service entry point can result in a conflict with another service entry point that is already set. If you attempt to do this, you will be given an option to remove the existing service entry point. For further information about conflicts when setting service entry points, see the related topic below.

Setting a service entry point causes a refresh of the existing service entry points. This might result in the removal of one or more service entry points, if they turn out to be invalid. See the related topic below.

What to do next

To remove a service entry point which was set on the source:
  1. Open the IBM i Service Entry Points view. Select the service entry point set from the source file. In the toolbar, click the Remove service entry points icon (Remove service entry points icon (flat box)).

Working with multiple selections in the Remote Systems view

About this task

In the Remote Systems view, you can select multiple programs, service programs, modules, or procedures by using the Ctrl or Shift keyboard selection actions. When you right-click this multiple selection, the following will occur, assuming the objects selected are valid for setting service entry points on:

Procedure


Feedback