Previous Topic: Information BlocksNext Topic: Security Exit Linkage Conventions


Security Events

CA‑PanAPT supports three types of security events: initialization, termination, and activity. Initialization and Termination Events are automatically invoked whenever the user enters or exits CA‑PanAPT once the CA‑PanAPT system administrator has activated the security exit. Activity events are invoked after all the information for a specific activity has been entered by the user.

INIT

The Initialization Event (INIT) is invoked as each user enters the CA‑PanAPT environment. At the INIT Event, the Move Request, Member, Approval, and Inventory Blocks do not contain any data. The only blocks containing information are the Event Block and the Environment Block.

Two Pass/Fail indicators are possible: Continue or Fail. The default is Continue. If the response is Continue, CA‑PanAPT continues normally. If the response is Fail, CA‑PanAPT displays an internal error message and returns to the ISPF Primary Option panel. The TERM event is not processed in this situation.

If the response is an unknown value, CA‑PanAPT returns to the ISPF Primary option and displays an internal error message.

TERM

Each time a user exits the CA‑PanAPT environment, the Termination Event (TERM) is invoked as a termination call for the exit program. The exit program performs any clean up procedures at this time.

At the TERM Event, the Move Request, Member, Approval, and Inventory Blocks do not contain any data. The only blocks containing information are the Event and Environment Blocks.

Pass/Fail indicators are ignored at this event because you are leaving the CA‑PanAPT environment.

ACTIVITY

If the Activity Event (ACTIVITY) is selected, CA‑PanAPT invokes the Exit Program after all information for a specific activity is entered by the user. The Activity event receives control after CA‑PanAPT user authorization has verified the activity.

For example, this Exit can enforce emergency Move Request approval procedures. The sample Exit allows certain User IDs approval/disapproval capabilities when the move type indicates that this is an emergency Move Request.

At the ACTIVITY Event, the Move Request Block, Member Block, Approval Block, and Inventory Block contain the member name, Move Request number, move type, Move-to-QA-Only flag, move date, first run date, service request, status, number of members, approvals required for current status, approvals-to-date for current status, and approvals-being-issued for current status. The data available varies depending on the activity.

Two Pass/Fail indicators are possible: Continue or Fail. CA‑PanAPT's built-in authorization determines the default. If the response is Continue, the activity continues normally. If the response is Fail, the current panel re-displays with a security violation error message supplied by the exit program. The user is not allowed to perform the requested activity, but the user can continue with other activities in CA‑PanAPT.

If the response is an unknown value, CA‑PanAPT returns to the ISPF Primary Option panel and displays an internal error message. Further information is in the ISPF log file.