2. MICF Options › 2.2 Foreground Execution Parameters
2.2 Foreground Execution Parameters
Foreground execution parameters control defaults for MICF
inquiries that are composed and executed in foreground.
There is a parallel set of execution parameters for those
inquiries executed in batch mode. These specifications can
be overridden when executing an inquiry. Foreground
execution parameters include the following:
o Default SAS parameters such as those controlling
printing of generated source statements in the SAS log.
o Default page width (characters) and length (lines) for
printed reports and the width (characters) of color
graphics titles.
o The default color graphics format set to be used for
graphics inquiries.
o Parameters defining the color graphics device for
graphics inquiries and whether to display graphics
during inquiry execution or just catalog graphics for
later replay. These parameters include the color
graphics device name and information required to route
outputs to or directly allocate the device.
The foreground execution parameters are:
ABEND inquiry execution when SAS detects ANY errors (YES/NO)?
Specify YES, or Y, to terminate inquiry execution with an
ABEND whenever SAS detects an error.
Specify NO, or N, to continue execution so that SAS can
flag ALL errors in the inquiry. This is the normal MICF
processing mode.
Color Graphics - Display color graphics during inquiry
execution (YES/NO)?
Specify YES, or Y, to display color graphics on the
specified color graphics device while the inquiry is
executing. The graphics procedure directly performs
display, causing each graph to be displayed sequentially
as the inquiry executes. See the following replay option
for an alternate method of reviewing graphics during
inquiry execution.
Specify NO, or N, to defer color graphics display until
you specifically request color graphics replay from the
Inquiry Output Replay panel after the inquiry has
executed. This is the normal mode of operation for
foreground MICF inquiry execution.
Color Graphics - Replay color graphics after inquiry
execution (YES/NO)?
Specify YES, or Y, to replay color graphics on the
specified color graphics device before the inquiry
terminates. The graphics catalog that was created during
inquiry execution is used, permitting random or selective
display of the graphs. This is the normal mode of
operation for foreground MICF inquiry execution.
Specify NO, or N, to defer color graphics display until
you specifically request color graphics replay from the
Inquiry Output Replay panel after the inquiry executes.
Color Graphics ADMDEFS File - Allocate GDDM ADMDEFS file
(YES/NO)?
Specify YES, or Y, to allocate your data center's GDDM
definitions (ADMDEFS) file for color graphics processing.
Specify NO, or N, to bypass ADMDEFS allocation.
Color Graphics Device - Specify the default color graphics
device name.
This is the 1-8 character name of the color graphics
device on which color graphics outputs are displayed.
This must be a valid SAS/GRAPH device (that is, it must
be valid for the SAS/GRAPH GOPTIONS DEVICE= parameter).
Note: This parameter is not validated, but execution
fails if an invalid device is specified. See the
SAS/GRAPH User's Guide for a list of valid color graphics
device specifications.
Color Graphics DDNAME - Output DDNAME for graphics stream
processing.
The default DDNAME for the color graphics output file.
Specify GSASFILE if GSF Option is GACCESS.
Specify ADMGDF if GSF Option is ADMGDF.
Other specific values (for example, FT14F001) may be
required for specific devices. See the SAS/GRAPH Guide
to Hardware Interfaces for more information.
Color Graphics DISP - Color graphics output data set
disposition (OLD/MOD).
The default color graphics output data set disposition.
This parameter is required if you specify the Color
Graphics DSNAME parameter.
Specify MOD, or M, to append color graphics outputs to
the current contents of color graphics DSNAME (that is,
DISP=MOD).
Specify OLD, or O, to replace the current contents of
color graphics DSNAME (that is, DISP=OLD).
Color Graphics DSNAME - Color graphics output data set name.
The default color graphics output data set name. Specify
this parameter to write the color graphics stream to a
cataloged DASD data set. Code this parameter as you
would any other data set name. To allocate a member of a
partitioned data set, include the member name in this
parameter.
Note: If you do not enclose the value in quotes, your TSO
user PREFIX is appended to the front before allocating
the data set.
If you specify this parameter, the color graphics SYSOUT
parameters are ignored.
Color Graphics Format Set - Specify the default color
graphics format set name.
This is the default color graphics format set for MICF
inquiry execution. It supplies color graphics format
parameter specifications for inquiry steps that have not
specifically specified these parameters (for example,
filled area patterns, colors, and title font). Specify
the 1-8 character name of one of the color graphics
format sets defined to MICF (either a shared format set
or one you have defined in your private options).
Color Graphics Page Width - No. Characters available for
centering title text.
This is the width, in characters, of your color graphics
outputs. It is used in centering the title for color
graphics reports. Increase this value to spread the
titles over more of the page. Reduce this value to
condense the title width.
Color Graphics Stream - GSF option
(NONE/GSF/GACCESS/ADMGDF/DISPLAY).
Use this parameter to define the type of color graphics
output file (that is, graphics stream file) processing
you want MICF to perform for you.
Specify NONE if Color Graphics Device is a TSO terminal
(for example, DEVICE=IBM3279) or other device that does
not require graphics stream processing (for example,
DEVICE=IBM3279). MICF will include GSFMODE=NONE in the
color graphics options (GOPTIONS) statement.
Specify GSF for standard graphics stream file processing.
MICF will include GSFMODE=REPLACE/APPEND in the generated
color graphics options (GOPTIONS) statement. You must
also specify color graphics DDNAME and either SYSOUT
allocation parameters or color graphics DSNAME for GSF
access.
Specify GACCESS for special protocol conversion
processing. MICF will include GSFMODE=NONE and
GACCESS=GSASFILE/GSASFILA in the generated color graphics
options (GOPTIONS) statement. You must also specify
GSASFILE for color graphics DDNAME and specify either
SYSOUT allocation parameters or color graphics DSNAME for
graphics output.
Specify ADMGDF to generate GDDM ADMGDF files. MICF will
include ADMGDF, GSFMODE=REPLACE/APPEND, and GSFNAME=GnPn
(where Gn is the color graphics catalog name and Pn is
the plot number) in the generated color graphics options
(GOPTIONS) statement. You must also specify ADMGDF for
color graphics DDNAME and specify color graphics DSNAME
for ADMGDF output (that is, SYSOUT is not valid for
ADMGDF output).
Specify DISPLAY to allocate a graphics output file
without any special parameters (for example, for a GDDM
ADMIMAGE file or for a linkable driver). MICF will
allocate the graphics output file (either color graphics
DSNAME or a sysout data set) to the DDNAME you specify in
the color graphics DDNAME parameter.
Color Graphics SYSOUT Class - SYSOUT class (A-Z or 0-9) for
graphics output.
Default JES SYSOUT class for the color graphics output
data set. This parameter corresponds to the class
subparameter of the DD statement SYSOUT= parameter (that
is, SYSOUT=(class,writer,form)). Specify a one-character
JES SYSOUT class (A-Z or 0-9) to route the color graphics
stream to the JES spool.
Note: SYSOUT=* is not valid for dynamic allocation and
cannot be specified for the default color graphics SYSOUT
class.
Color Graphics SYSOUT Destination - SYSOUT destination for
graphics output.
The default JES SYSOUT destination, a 1-8 character name
or (node,userid), for the color graphics output data set.
This parameter corresponds to the DD statement DEST=
parameter. Specify the remote name (for example, R15)
for a color graphics device accessed as a JES remote RJE
printer. Leave this parameter blank if your color
graphics device is accessed through JES without a SYSOUT
destination. You can use the optional (node,userid)
format to route output to a VM/CMS user through JES and
RSCS facilities. Node and userid are 1-8 character
names; node is required for this destination parameter
format. If your (node,userid) format destination is
longer than 17 characters, leave this parameter blank and
specify DEST=(node,userid) in the free-form SYSOUT
parameters data entry area below.
Color Graphics SYSOUT Form Code - SYSOUT form code for
graphics output.
The default JES SYSOUT form code for the color graphics
output data set. This parameter corresponds to the form
subparameter of the DD statement SYSOUT= parameter (that
is, SYSOUT=(class,writer,form)). Specify a 1-4 character
form number to route color graphics to JES spool for
plotting on the specified form. Leave this parameter
blank if your color graphics device is accessed through
JES without a SYSOUT form number.
Color Graphics SYSOUT Parms - Additional JCL format SYSOUT
parameters.
Default JES SYSOUT parameters your data center requires
for color graphics processing via JES SYSOUT data set
allocations (for example, CHARS, COPIES, FCB, FLASH,
HOLD, UCS). Specify these parameters in JCL statement
format, separated by commas.
Color Graphics SYSOUT Writer - SYSOUT external writer for
graphics output.
The default JES SYSOUT external writer module for the
color graphics output data set. This parameter
corresponds to the writer subparameter of the DD
statement SYSOUT parameter (that is,
SYSOUT=(class,writer,form)). Specify a 1-8 character
name to route color graphics to the JES spool for
processing by the specified external writer module.
Leave this parameter blank if your color graphics device
is accessed through JES without a SYSOUT writer
specification.
Color List n - Specify the "color list" for the graphics
device, where n is 1 to 3.
This specification appears in the SAS/GRAPH GOPTIONS
statement COLORS= parameter. Three lines of color list
information are provided. Specify a list of SAS/GRAPH
color names separated by blanks.
Note: Do NOT put parentheses around the list.
This is the list of colors supported by the graphics
device. For pen plotters, this parameter establishes the
correspondence between colors and pen positions (that is,
the first color in the color list corresponds to the
first pen).
Note: This parameter is not validated, but execution
fails if invalid colors are specified.
Leave this parameter blank to accept the default
established by your data center. See the SAS/GRAPH
User's Guide for more information and default values for
each device.
Expand SAS macros in inquiry SAS log (YES/NO)?
Specify YES, or Y, to include the SAS statements
generated for the macros used by the inquiry in the SAS
log. This can be useful in researching problems in MICF
inquiry execution.
Specify NO, or N, to omit the macro expansions from the
log. This is the normal status for this parameter.
GOPTIONS Parameters n - Specify GOPTIONS parameters for the
graphics device, where n is 1 to 3.
This specification appears in the SAS/GRAPH GOPTIONS
statement. Three lines of GOPTIONS parameters are
provided. Specify a list of SAS/GRAPH GOPTIONS statement
parameters separated by blanks. This is used for special
color graphics device parameters that are not supported
by MICF data entry panels.
Note: This parameter is not validated, but execution
fails if invalid values are specified. See the SAS/GRAPH
User's Guide for more information on the GOPTIONS
statement.
Maximum number of error messages to be printed for an inquiry
(nnn or blank).
This is the maximum number of input file records for
which complete error messages are printed. Specify a 1-3
digit number (that is, 1-999). When this value is
exceeded, processing continues but messages are not
printed for additional errors. Leave this parameter
blank to use the default established when SAS was
installed.
Maximum Observations - Stop after processing (nn, blank, or
MAX) observations.
This limits MICF inquiry execution to the specified
number of file observations. Specify a 1-6 digit number
(that is, 1 - 999999). MICF stops accepting input file
observations after reading the number of observations you
specify in this parameter. This parameter can be useful
to limit the number of input file records for inquiry
testing. Leave this parameter blank to use the default
limit established by your data center. Specify MAX, or
M, to disable your data center's limit (that is, operate
without an observation limit).
MICF Web Publishing - HFS Directory
The directory where reporting job stream output is stored
when the MICF Web Publishing feature is activated for a
job stream.
Q&R Integration - zFS Root for Q&R Directory
The HFS/zFS directory in which to store MICF reporting
job stream inquiry output for access by the Q&R
Workstation. It is required only when "Use Q&R
Compatible Directory Structure" is set to Y. If left
blank, each new reporting job stream definition defaults
to the MICF Web Publishing.
Q&R Integration - Q&R Mainframe Server Name (MQRMSN)
Enter the application name of the CA MICS Q&R Workstation
Mainframe Server. This is defined in the Q&R Mainframe Server
parameter file (sharedprefix.MICS.PARMS member MQRPARMS) as
the MQRMSN parameter. The MQRMSN value is used as the first
directory level after "Server" when building the Q&R directory
structure. It is required if the "Use Q&R Compatible
Directory Structure" is Y (Yes). No default.
Q&R Integration - Use Q&R Directory Structure (YES/NO)
Specify Y (Yes) to write the inquiry output to the
hfs/zfs in a directory structure compatible with CA MICS
Q&R Workstation. Use of this feature facilitates mapping
the HFS/zFS as an additional drive to the Q&R Distributed
Server MS Windows machine, enabling the CA MICS Q&R
Workstation RMWSLOAD utility to read the CSVs directly
without the need to move the data files to the
distributed server for subsequent publication. The
default is N (No).
Overprint error messages in inquiry SAS log (YES/NO)?
Specify YES, or Y, to overprint error messages in the SAS
log. This highlights error conditions if the log is
printed on a device that supports overprinting (for
example, most line printers), but it has no effect on
most laser printers.
Specify NO, or N, for simple printing of error messages.
This is the normal mode of operation for foreground
execution.
Page Length - Specify the number of lines per printed page
for inquiry outputs.
This is the number of lines available for each printed
report or SAS log page. Specify a number between 20 and
500. Values matching your terminal characteristics are
recommended for inquiry outputs that will be browsed
online. This avoids having to scroll the display to view
the entire page.
Page Width - Specify the number of columns per printed page
for inquiry outputs.
This is the number of columns available for each printed
report or SAS log page. Specify a number between 64 and
256. Specifying a value larger than the actual device
could cause truncation of print lines (that is, could
result in lost information). Values matching your
terminal characteristics are recommended for inquiry
outputs that will be browsed online. This avoids having
to scroll the display to view the entire page.
Print SAS "notes" in inquiry SAS log (YES/NO)?
Specify YES, or Y, to include notes in the SAS log that
describe inquiry processing. These include reporting the
number of records in each intermediate file and the CPU
time consumed by the various stages of inquiry execution.
This is the normal MICF processing mode.
Specify NO, or N, to omit these notes for the SAS log.
Print SAS source code in inquiry SAS log (YES/NO)?
Specify YES, or Y, to include the SAS statements
generated for the inquiry in the SAS log. This is the
normal MICF processing mode.
Specify NO, or N, to omit the source statements from the
SAS log.
PARMS Allocation - Specify DDNAME for allocating prefix.PARMS
concatenation.
Specify a DDNAME if you want MICF to allocate the
prefix.MICS.PARMS data set for inquiry execution. If
your inquiry references multiple CA MICS unit databases,
MICF will concatenate each unit's prefix.MICS.PARMS data
set to the DDNAME you specify.
Leave this parameter blank to bypass prefix.MICS.PARMS
allocation.
You normally want to leave this parameter blank and
bypass prefix.MICS.PARMS allocation.
Sort Work - No. of sort work data sets allocated for inquiry
execution (0-6).
Specify 0 (Zero) if you want SAS to allocate sort work
data sets dynamically.
Otherwise, specify the number of sort work data sets (1
to 6) you want MICF to allocate for inquiry execution.
SAS Invocation Options - Enter special SAS start-up options
(for example, REMOTE=xxx).
Additional SAS options you require for SAS invocations.
Use this data entry area for parameters that cannot be
specified in an OPTIONS statement (for example, the
REMOTE= option). You can override this default
specification prior to MICF inquiry execution; but the
default SAS invocation options are applied to color
graphics replay and other SAS utility processing without
your having an opportunity to override the default value.
Uppercase - Translate all inquiry outputs to capital letters
(YES/NO)?
Specify YES, or Y, for this parameter to translate all
printed reports and SAS log messages to uppercase. This
option is useful if your hard-copy printers do not
support lowercase characters. This parameter has no
effect on color graphics outputs or on SAS statements
printed in the SAS log; lowercase text in SAS statements
will still print in lowercase.
Specify NO, or N, to allow lowercase text in printed
reports and SAS log messages.
