Windows C User Exits › Windows Blockmode User Exits › TIRSECR—Security Check Interface Exit › Purpose

Purpose

The Dialog Manager calls the Security Check Interface Exit when a transaction is started and before execution of a dialog flow. This allows transaction-level security checking to be implemented. The following data is provided by the dialog manager of each load module for use in checking security authorization:

• System ID (as provided by the System ID Exit, TIRSYSID)
• User ID (as provided by the User ID Exit, TIRUSRID)
• Trancode
• Terminal ID
• Load module name
• Procedure step name

If the user defined security check passes, TIRSECR should move a value of spaces to the return code. If the security check fails, a non-blank value should be moved to the return code with a message describing the violation inserted into the tirsecr_failure_msg buffer. The current dialect in effect on the client is passed in using tirsecr_dialect.

When the dialog manager receives control, it proceeds with the transaction if the return code is spaces, or issues an error if it is not.