Running Reports from a Command Line
Powertech Authority Broker reports can also be started from a command line or from within a CL program.
To run a report from a command line, enter the following command:
LEVENTRPT
Press F4 (Prompt) to see the report options. The Event Reports (LEVENTRPT) screen displays. Make your selections and press Enter.
Options:
From Date & From Time
The From Date and Time fields specify the first (earliest) of the events to be included on the report. The From Date and Time must specify a time before that of the To Date and Time.
To Date & To Time
The To Date and Time fields specify the last (latest) of the events to be included on the report. The To Date and Time must specify a time after that of the From Date and Time.
Include Switches Based On
Specifies how profile switches are selected to be on the report.
- Start: Selecting Start will include profile switches that started during the selected date and time range.
- End: Selecting End will include profile switches that ended during the selected date and time range.
- Any: Selecting Any will include profile switches that had any activity during the selected date and time range.
Omit Activity Outside the Date/Time Range
This parameter specifies if detail activity that falls outside the selected date & time range should be omitted from the report.
- Yes. Detail activity that falls outside the requested date and time range will bes omitted from the report.
- No. Detail activity that falls outside the requested date and time range will be included on the report.
User Type
Specifies the user type for which the report is to run. The user name will be entered in the RUNFOR field.
Allowed values are:
- *SYSTEM: The user named in the RUNFOR parameter is the system user making the switch. Alternately, a U may be used.
- *SWITCH: The user named in the RUNFOR parameter is the user profile to which the switch was made. Alternately, an S may be used.
- *INTPARTY: The user named in the RUNFOR parameter is the Interested Party. Alternately, an 'I' may be used.
User
Specifies the user for which the report is run. This parameter is inter-dependent on USERTYPE. Allowed values are a user profile or the special value *ALL.
Report Type
Specifies the information type to appear on the report.
Allowed values are:
- *SUMMARY: Shows only the switch profile events generated via user profile switches with Powertech Authority Broker (Start Switch and Stop Switch). This option produces only summary-level information. Alternately, an S may be used.
- *COMMAND: Selecting Commands will limit the audit activity shown on the report to the switch profile events and the commands run while the switch was effective. The command information is based on 'CD' type entries in the IBM security audit journal (QAUDJRN). Alternately, a 'C' may be used.
- *ALL: Shows the switch profile events generated by user switches and all journal entries while the switch was effective. This option produces the most information of all options. Alternately, an A may be used.
- *ERRORS: Shows only the switch profile events generated by a rejected user switch attempt. These are shown in the other reports, but can be easier to examine in this report. Alternately, an E may be used.
Omi CL Program Commands
Select only those commands and programs that were run from a command line.
- *YES: Omit those commands and programs that were run from a command line such as QCMD or QCMDEXEC. (You may also use a Y.)
- *NO: Select all commands and programs. (You may also use an N.)
Omit registered programs
Includes or excludes from this report those programs that you have specified via Work with Program Exceptions.
Print Report
Specifies if the report output is to be printed. If selected, you must specify the output queue to which to send the report.
Allowed values for function are:
- *YES: Print the report. (You may also use a Y.)
- *NO: Do not print the report. (You may also use an N.)
Send report to DB file
Specifies if the report output is to be sent to a DB2/400 database file. If selected, you must specify the database file to which to send the report. If the file does not already exist, it will be created for you.
Allowed values for function are:
- *YES: Send the output to a database file. (You may also use a Y.)
- *NO: Do not send the output to a database file. (You may also use an N.)
Send report to directory file
Specifies if the report output is to be sent to a directory file. If selected, you must specify the directory file to which to send the report. If the file does not already exist, it will be created for you.
You must have sufficient access rights to the specified directory file, including all directories in the path, to create and to write to this file.
Allowed values for function are:
- *YES: Send the output to a directory file. (You may also use a Y.)
- *NO: Do not send the output to a directory file. (You may also use an N.)