Before you can use the full-screen feature to run this report, you must select SMF files. See Selecting SMF Input Files in “The Reports” chapter for information about gathering the SMF files as input for this report.
Use the screen below to run the Selected Logonid List. It displays when you select option 6.2.C from the Primary Option Menu. See Running Reports Using the Full‑Screen Feature in “The Reports” chapter for basic information about using the full‑screen feature.
M9PA-62C0 SL - Selected Logonid List (6.2.C) CA ACF2 for z/VM COMMAND ===> __________________________________________________________ TIME 13:33 Enter Report Parameters: Logonid Mask ==> ________ Short or Full ==> SHORT Input Type (SMF/ACF2) ==> ACF2 Enter IF criteria ==> N Report Validation Updates ==> N Display DATE TIME & CHANGER ==> Y Fields to be included on SHORT report: ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ________ ----------------------------- Common Parameters ----------------------- User Title ==> ________________________________ System ID ==> ____ Output device ==> TERMINAL Line count ==> 60 Start Date ==> 01/01/78 End Date ==> 12/31/99 Start time ==> 0000 End time ==> 2359 Select ==> ___________ Job masks ==> _____________________ PF1=Help 2=Print 3=Quit 4=Return 5= 6= PF7= 8= 9= 10=Save 11= 12=Retrieve
After you have defined all fields, press the Enter key to execute the report.
The following list explains the various fields of the screen.
Enter Report Parameters:
Specify the mask for a particular logonid or group of logonids to use for this report.
You must specify the type of report format you want to run. If you do not specify a format, an error message is printed and ACFRPTSL terminates.
Short
Produces a one-line entry for each logonid, consisting of the logonid, name, date, time and changer (if you specified SMF for INPUT).
Full
Produces an exact replica of the ACF LIST command that fits on a 133-character print line.
You must specify the type of input to process. You must fill in a value for this field, or ACFRPTSL will print an error message and terminate the report processing.
SMF
Accepts input as CA ACF2 for z/VM logonid modification SMF records.
ACF2
Accepts input as unformatted records from the Logonid database. To use the CA ACF2 for z/VM Logonid database for input, the person executing the report must have the SECURITY, ACCOUNT, or AUDIT attribute. In addition, the report only includes those logonid records the person running the report has authority to access. If a user requested all logonids with the IMS attribute, but had a scope record that only allowed him to access logonid records for users in a specific department, the report output would only list those logonids for users in that department who had the IMS attribute.
Specify N (no) to indicate you do not need additional space. Enter field names here. CA ACF2 for z/VM uses only those logonids that match the logonid mask and have the attributes you specify here. If you need additional space, enter Y (yes) and CA ACF2 for z/VM will provide more. See Specifying Search Criteria to see the screen CA ACF2 for z/VM displays.
Specify Y (yes) to request a summary of logonid modifications, including JESx and logonid validation updates. Specify N (the default) to indicate you do want a report on only nonvalidation updates. You might want to use the default because of the volume of validation updates (one for every job and session). This field is only used if you specified INPUT as SMF.
Specify if the report is to display the date and time the logonid was last updated, and the logonid of the user that requested the change.
You can only use this field if you specified SHORT. These fields contain the external field names (as defined in the ACFFDR @CFDE macro) of the selected logonid record fields to be formatted with the basic short format fields.
Common Parameters:
Specify a character string that is added to the other title information at the top of the report. This character string can be up to 35 characters long. If you do not specify this parameter, the report generator uses the first 35 characters in the command parameters.
Specify the CA ACF2 for z/VM system ID or a mask for the systems that were active when the SMF records were generated. The default is all system.
Specify the type of output device for this report, TERMINAL, PRINTER, or DISK. TERMINAL is the default.
Specify the number of lines per page. The default is 60.
Specify the start date of the report data, in Julian or Gregorian days. The default is January 1, 1978.
Specify the end date of the report data, in Julian or Gregorian days. The default is December 31, 2069.
Specify the beginning of the time interval for selecting SMF records. This time is based on a 24-hour clock. The default is 0000 (12:00 a.m.).
Specify the end of the time interval for selecting SMF records. This time is based on a 24-hour clock. The default is 2359 (11:59 p.m.).
Specify the type of SMF record to be used for this report.
Specify the job name to limit records appearing on this report to those pertaining to the job or jobs indicated by the job name or job name mask. Use commas or blanks to separate multiple job names. The default is all jobs.
This screen displays if you enter Y in the ENTER IF criteria field of the Selected Logonid List screen.
M9PA-62C1 SL - Selected Logonid List (6.2.C.1) CA ACF2 for z/VM COMMAND ===> ________________________________________________________ TIME 17:12 Enter IF criteria: ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ PF1=Help 2=Print 3=Quit 4=Return 5= 6= PF7= 8= 9=Execute 10=Save 11= 12=Retrieve
Use this screen for IF arguments for the ACFRPTSL report. Press PF9 (Execute) to run the Selected Logonid List report.
This field is formatted similarly to a high-level programming language IF statement and lets you define flexible record selection criteria. The variables available for processing are the various logonid record field names or constants (defined below). The available operators are also defined below. The full IF expression is evaluated as an algebraic expression yielding a true (that is, select record) or false (bypass record) value. If the result of the IF expression is a quantity, nonzero is considered true (selected) and a zero value is considered false (not selected). Parentheses can group expressions to override the normal precedence order. An example is shown below:
PREFIX NE '********'
Press Enter to run the report.
The following examples show how to specify IF criteria.
Example 1
Select all logonid records for users whose system access count (ACC-CNT) is greater than 1000 and who are security officers or auditors. Specify the following for the IF criteria:
ACC-CNT > 1000 AND (SECURITY OR AUDIT)
Example 2
Select all logonid records with the NOSPOOL (Log, Allow, or Prevent) and SYNERR (Log, Allow, or Prevent) privileges. Specify one of the following for the IF criteria:
NOSPOOL = 'A' OR NOSPOOL = 'L' OR NOSPOOL = 'P' OR SYNERR = 'A' OR SYNERR = 'L' OR SYNERR = 'P' OR
Example 3
Specify IF criteria with the NOT symbol.
NOT CICS AND NOT VM
Valid IF expressions are the various logonid record field names (defined by the ACFFDR @CFDE macro entries) and constants (defined below). Available operators (that perform an action on a constant) are also defined below.
CA ACF2 for z/VM evaluates the full IF expression as an algebraic expression indicating a true or false value. If the result is true, CA ACF2 for z/VM selects the record. If it is false, CA ACF2 for z/VM bypasses the record. If the result of the IF expression is a quantity, CA ACF2 for z/VM considers a nonzero value as true and selects the result. If CA ACF2 for z/VM considers a zero value as false, it does not select the result. Use parentheses to group expressions to override the normal precedence order that defines the order CA ACF2 for z/VM evaluates the terms of the expression.
Use date constants in IF expressions for comparisons only. Using date constants in arithmetic expressions can produce unexpected results because CA ACF2 for z/VM evaluates the arithmetic expression after it converts the date constant to a Julian date. Shown below is an example of using date constants in arithmetic expressions:
D'01/01/01' - D'12/31/00'
CA ACF2 for z/VM changes the date of 01/01/01 to 101001 and the date of 12/31/00 to 100366. The value is therefore 635, not the expected value of 1.
When you need to specify a constant (specific value) in the IF statement, you can use the following formats:
|
Format |
Contents |
Type |
|---|---|---|
|
'aaaa' or C'aaaa' |
Alphanumerics |
Character fields |
|
nnnn |
Numerics |
Binary number fields |
|
X'xx' |
Hex numbers |
Hex fields |
|
B'n' |
1 or 0 |
Bit (flag) fields (1=on,0=off) |
|
P'nn' |
Numerics |
Packed decimal fields |
|
D'mm/dd/yy', D'dd/mm/yy', or D'yy/mm/dd' |
Numerics with dividing date field slashes (the format used is based on local system options) |
|
The date field could be a TOD clock field or stored as packed decimal in the logonid record that CA ACF2 for z/VM displays as a date, with or without a time. CA ACF2 for z/VM treats time-of-day fields as date fields only (they are not compared to the time).
|
Precedence |
Character |
Symbol |
Meaning |
|---|---|---|---|
|
1. |
NOT |
^ |
NOT |
|
2. |
OR |
| |
OR |
|
3. |
AND |
& |
AND |
|
4.a. |
EQ |
= |
EQUAL |
|
b. |
NE |
^= |
NOT EQUAL |
|
c. |
LE |
<= |
LESS THAN OR EQUAL TO |
|
d. |
GE |
>= |
GREATER THAN OR EQUAL TO |
|
e. |
LT |
< |
LESS THAN |
|
f. |
GT |
> |
GREATER THAN |
|
5. |
|
- |
Designates negative value |
|
6.a. |
|
* |
TIMES |
|
b. |
|
/ |
DIVIDED BY |
|
7.a. |
|
+ |
PLUS |
|
b. |
|
- |
MINUS |
|
8. |
|
|| |
Concatenated to (used between field names, in sequence, to show concatenation of fields). Can build a UID string since UID is not an actual field in the logonid record and cannot be directly referenced. |
Use the symbols above or the character abbreviation (where available) in the ACFRPTSL report.
|
Copyright © 2009 CA Technologies.
All rights reserved.
|
|