Custom Alerts
When an alert is generated, Authority Broker administrators have the flexibility to call their own custom programs in place of the defaults that ship with Powertech Authority Broker (USERMSGQ, EXTERNALMSGQ, etc.).
On the Work with Alert Methods screen, you define the name of the program and the library where it is located. Authority Broker passes the following parameters to your program.
| Parameter | Used As | Data Type | Sequence | Description |
|---|---|---|---|---|
| Interested Party | Input | CHAR(10) | 1 | The User ID of individual with an interest in when this system user switches to the Application/Resource ID. |
| Client IP address | Input | CHAR(15) | 2 | The client IP address returned from IBM’s QUSRJOBI API in format JOBI0600. This is typically the IP address of a telnet terminal. |
| System Name | Input | CHAR(8) | 3 | The name of the system the profile switch took place on. This is the same name as shows in the “Current system name” parameter of IBM command DSPNETA. |
| Jon Environment Type | Input | CHAR(1) | 4 | The job’s environment type. 0 – A value - lf “0” indicates the job that performed the profile switch was running in batch mode. 1 – A value - lf “1” indicates the job that performed the profile switch was running in interactive mode. |
| System User | Input | CHAR(10) | 5 | The name of the user profile that switched to the application/resource ID. |
| Application/Resource ID | Input | CHAR(10) | 6 | The name of the user profile the system user switched to. |
| Notification | Input | CHAR(276) | 7 | The formatted data used when writing the switch audit journal entry. This contains the "reason" that the system user gave for performing the switch. The format is for Authority Broker message PID8001, as follows: System user requested to run under authority of Application/Resource ID for reason "reason entered for the profile switch" |
| FireCall Switch | Input | CHAR(1) | 8 | Specifies if the profile switch pair was created for FireCall. This parameter will always be “N” for Authority Broker 2.0 and earlier. |
| Call ticket number | Input | CHAR(20) | 9 | The Call number entered for this profile switch. It can be any combination of letters and numbers (up to 20 characters) that corresponds to a ticket number from a help desk system such as Remedy. |
Program processing requirements:
- All parameters are passed to the user-written alert program. None may be omitted.
- All parameters are passed by reference.
- If the alert program fails for any reason it will cause the entire alert process to fail.
- The Authority Broker administrator is responsible for handling library list manipulation. If a customer-written alert alters the job’s library list it is the responsibility of the customer’s alert program to reinstate the library list before giving processing control back to Authority Broker.