Selecting a control statement
When you enter an IS Edit line command or select Option 5 (List Control Statements) from the CMF Analyzer JCL Builder—Main Menu, the CMF Analyzer JCL Builder—Control Statement List panel is displayed.
You can select a control statement from the list.
Command ===> Scroll: CSR
Line Commands: S - Select V - View
Sel Name Type Description
--- -------- ------- --------------------------------------------------
CYCLE General Names a unique time-date range
DATETIME General Overall date/time range for data selection
DMSS General Data Management Subsystem Controls
HEADERS General Optional Report Heading Information
PERIOD General Associate reports with date/time periods
RECTYPE General Characteristics of input data set
REPORTS General Report grouping and output DD and Class
SEVERITY General Max error level to be tolerated
SHIFT General Data selection intervals by time and day
SUBTITLE General Content of fourth report heading line
SYSPLEX General Select data by SYSNAME/SYSID and DDNAME
AUXSTOR Report Auxiliary Storage Report
CACHEACT Report Cache Subsystem and Device Reports
Analyzer control statement list primary commands
The following primary commands are available from the Analyzer control statement list:
- EXCLUDE {GENERAL|REPORT} excludes from the displayed list all control statements of the type specified in the command. EXCLUDE is the opposite of the SHOW command.
- FIND string searches the statement names and descriptions for the first statement in which the specified string occurs.
- LOCATE statementName positions the list so that the first statement name that is equal to or immediately prior to the entered argument appears at the top of the list.
- REFRESH refreshes the control statement list to show all statements.
SELECT name constructs the designated control statement and returns it to the EDIT session.
- SHOW {GENERAL|REPORT|ALL} modifies the control statement list to display only statements of the type specified. SHOW is the opposite of the EXCLUDE command.
SORT {NAME|TYPE} sorts the control statement list by the type specified in the command.
The SORT command operands are TYPE and NAME. The operand that is not specified is used as the secondary sort key. Thus, SORT TYPE displays the TYPES in ascending order and displays the NAMES within each TYPE in ascending order.
- VIEW statementName displays the control statement name and its description, followed by a list of its parameters and their descriptions.
Analyzer control statement list line commands
The following line commands are available from the Analyzer control statement list:
- S (Select) constructs and returns the selected control statement to the EDIT session if the SELECT function is enabled. If the SELECT function is disabled, an error message is displayed.
- V (View) displays a control statement parameter list, which includes the name, format, and description of each available parameter.
Control statement parameter list
The Control Statement Parameter List panel is displayed in response to one of the following commands:
- a VIEW primary or line command on the control statement list
- an EDIT session IP line command
The CMF Analyzer JCL Builder—Parameter List panel displays the control statement name, description, and available parameters. The name, format, and description of each parameter are also displayed. The following figure displays a sample of a Control Statement Parameter List panel.
Command ===> Scroll: CSR
Statement: CACHEACT - Cache Subsystem and Device Reports
Line Commands: S - Select V - View
Sel Name Form and Description
--- -------- ------------------------------------------------------------
REPORT REPORT=<keyword>, Type of report to generate
MODEL MODEL=<keyword>, Select Subsystems by Model
ORDER ORDER=<keyword>, Specify order of report
SUBSYS SUBSYS=<group>, Subsystems to include in report
DEVICE DEVICE=<group>, Devices to include in report
EXCLUDE EXCLUDE=<group>, Devices to exclude from report
THRESHLD THRESHLD=<integer> Device omission threshold
***************************** Bottom of data ******************************
The panel’s columns are as follows:
- Select is used to enter line commands.
- Name displays the parameter name.
- Form and Description displays the parameter’s form and description.
If the parameter is a keyword parameter, the keyword is shown in the form expression. The form of the parameter value is displayed followed by the parameter’s description. If the parameter is required, the expression '(R)' follows the description.
The format types displayed are as follows:
- <integer> means the parameter’s value must be an integer. Depending on the parameter, the integer might be a minimum value, a maximum value, a maximum length, a list of allowable values, or a default value if there is one.
- <keyword> means the parameter’s value must be a keyword from a list of valid keywords.
<date> means the parameter’s value is specified in one of the following formats:
- ddMMMyy or ddMMMccyy (Gregorian date format)
- ccyyddd or yyddd (Julian date format)
The variables represent the following values:
- dd represents the day of the month.
- ddd represents the day of the year. Thus, if the date is February 1, the value of ddd would be 032.
- MMM is a three-character abbreviation of the month.
- yy represents the year. Unless the century is specified, yy is assumed to be within the range of 1950 through 2049. Thus, if the yy value is 11, the year is assumed to be 2011.
- cc represents the century. Thus, if the cc value is 20, ccyy represents a year between 2000 and 2099.
- <time> means the parameter’s value is specified in the format hhmmss.
- <datetime> means the parameter’s value is specified in the format <date>[:<time>]. The colon is required only if a time value is specified. If the time is omitted, the time value ‘000000’ is assumed.
- <string> means the parameter’s value is a character string. If you include a space character, you must enclose the entire string in single quotation marks (‘).
- <group> means the parameter is actually a group of parameters (either all the same type, or different types). For more information, see Group Parameter panel.