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.
About this task
To set a service entry point in the IBM® i Service Entry Points view, do the following:
Procedure
- Ensure that the IBM i Service
Entry Points view is open. Instructions for opening this view can be found
in Managing service entry points in the IBM i Service Entry Points view.
- In the IBM i Service
Entry Points view, select the Set service entry point push
button (
) or right-click in the view and choose Set from
the pop-up menu. This will invoke the Set Service Entry Point dialog,
from which you will complete all other steps.
- In the Connection field, select the connection
which contains the program or service program in which you want to set the
service entry point. If the connection has not yet been created, select the
New push button to create the connection.
- In the Library field, select, enter, or
browse for the library which contains the program or service program in which
you want to set the service entry point. To choose the library that is specified
as current library in the Remote Systems view, select *CURLIB in
this field.
Note: The selection lists in this dialog can be modified
by clicking the up arrow next to the field. Choosing this opens the Work
With History dialog, which allows you to remove items in or modify
the order of the selection list.
- Select the Program or Service
Program radio button, depending on the type of program in which
you want to set the service entry point. In the appropriate radio button area,
select, enter or browse for the program or service program name.
- If you want the service entry point to apply to the entire program
or service program, leave the default Module field
entry at *ALL. If you want to set the service
entry point on a module in the program, select, enter, or browse for the module
in this field.
Note: When you set a
service entry point on a program or service program, you are setting a service
entry point on every user-defined procedure in every module of that program
or service program. When you set a service entry point on a module, you are
setting a service entry point on every user-defined procedure in that module.
- If you specified a module in the Module field,
you can specify a procedure in which to set the service entry point (the procedure
must be in the specified module). To do this, select, enter, or browse for
the procedure in which you want to set the service entry point.
- In the User ID field, enter the user ID
whose job will trigger the service entry point. For further information about
user ID profile considerations, see the related topic below.
- Click OK to set the service entry point.
Results
Tip: If an object is selected in the Remote Systems view
when you launch the Set Service Entry Point dialog,
the dialog will pre-fill with information about the selected object, allowing
you to easily complete the dialog.
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 prompted via dialog 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
that are set on the same program. 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.