Change Server Function Rule

How to Get There

From the Security Configuration Menu, select option 1, Work with Security by Server. Enter option 7 next to a server.

What it Does

The Change Server Function Rule panel allows you to change one or more of the properties for a selected server. To change a server property, type over the existing value and press Enter. Server Function Rules provide processing control to Powertech's exit programs and also act as defaults for server function values.

Options

The server name and description display at the top of the window and cannot be changed.

Enforce Server Rules

The Powertech rules defined for this server are enforced. (This value is referenced under the "Rules Active" column in the Work with Security by Server panel. This value is also referenced under the "Rules Active" column of the Product Configuration panel in the Insite web UI.)

The possible values are:

Y Enter Y to activate the Powertech rules defined for this server.
N Warning message interval (Hours) Enter N if you do not want to enforce the Powertech rules for this server. If this value is used, by default, a warning message is sent, in the interval specified, that indicates the rule is not being enforced and all transactions requested through the server are being allowed. The warning message is sent to the message queue specified on the Work with Powertech Exit Point Manager for IBM i System Values panel. Press Enter to specify the number of hours.
interval  The default interval is every 12 hours, which can be changed as needed. The valid range of values is 1-72.
*NONE Enter *NONE to disable the warning message.
Authority

The authority assigned to the server. The value you enter is used when *SERVER authority is placed on a server function.

The possible values are:

*SYSTEM Use the authority defined for the system.
*ALLOW Allow the transaction without taking any action.
*REJECT Reject all requests for the transaction.
*SWITCH Switch the job to run as the user profile specified in the switch profile field. A switch profile entry is required.
*MEMALLOW Check Memorized Transactions (MTR) for authority. If no MTR authority is found, allow the transaction.
*MEMREJECT Check Memorized Transactions (MTR) for authority. If no MTR authority is found, reject requests for the server.
*MEMSWITCH Check Memorized Transactions (MTR) for authority. If no MTR authority is found, use the authority of the switch profile for the server. A switch profile entry is required.
*MEMOBJ Check Memorized Transactions (MTR) for authority. If no MTR authority is found, check the transaction against the object rules.
Audit

Controls the type of requests Powertech Exit Point Manager for IBM i will log.

The possible values are:

Y Log all requests to the server.
N Log only authority failures for the server.
* Use the default system value for the system.
Message

Specifies if Powertech Exit Point Manager for IBM i sends a message to the message queue specified in Powertech's System Values.

The possible values are:

Y A message is sent to the specified queue.
N No message is sent.
* Use the default system value for the system.
Capture

Capture transactions for Memorized Transaction Request (MTR).

The possible values are:

Y Capture transactions.
N Do not capture transactions.
* Use the default system value for the system.
Switch Profile

The name of a switch profile for this server. If you enter a profile name, processing is swapped to run under this profile's authority. This is only valid for authorities *SWITCH and *MEMSWITCH.

The possible values are:

*NONE No switch profile is being used.
switch-profile The switch profile to process under. It must be an active profile on the IBM i system.
*SYSTEM Use the switch profile defined for the system.
Supplemental Exit Program

The exit program to run after Powertech's exit program has processed a request successfully. The supplemental exit program is called only for authorities *ALLOW, *MEMALLOW, *SWITCH, and *MEMSWITCH if the transaction has not been rejected by Powertech Exit Point Manager for IBM i rules. Powertech Exit Point Manager for IBM i's rules must be enforced for a supplemental exit program to run.

The possible values are:

*NONE No supplemental exit program is to run.
exit-program-name The name of the supplemental exit program to run after Powertech's exit program completes normally. It must be a valid object name and exist on the IBM i system.
Library

Enter the name of the library where the supplemental exit program is found. It must be a valid object name and exist on the IBM i system.

Command Keys

F3 (Exit): Exit the program without processing any pending changes.

F4 (Prompt): Displays a list of values from which you may select one.

F5 (Refresh): Refreshes the panel and resets all available text fields.

F12 (Cancel): Exit the panel without processing any pending changes.