You are here:

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 can be used.

*SWITCH

The user named in the RUNFOR parameter is the user profile to which the switch was made. Alternately, an S can be used.

*INTPARTY

The user named in the RUNFOR parameter is the Interested Party. Alternately, an 'I' can 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 can 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' can 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 can 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 can 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 can also use a Y.)

*NO

Select all commands and programs. (You can 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 can also use a Y.)

*NO

Do not print the report. (You can 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 can also use a Y.)

*NO

Do not send the output to a database file. (You can 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 can also use a Y.)

*NO

Do not send the output to a directory file. (You can also use an N.)