2. MICF Options › 2.3 Batch Execution Parameters
2.3 Batch Execution Parameters
Batch execution parameters control parameters for MICF
inquiries composed and executed in batch, or background,
mode. There is a parallel set of execution parameters for
inquiries executed in foreground (or interactive) mode.
These specifications can be overridden when executing an
inquiry. Batch 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 batch 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. This is the normal mode of operation for
batch MICF inquiry execution.
Specify NO, or N, to bypass color graphics display. This
can be useful in testing inquiry execution against a
subset of the input data. Once execution is verified,
the inquiry could be rerun with the full set of input
data and a value of YES for this parameter.
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 one- to eight-character name of the color
graphics device on which color graphics outputs will be
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. If you do not enclose the
value in quotes, your TSO user PREFIX will be appended to
the front before allocating the data set. To allocate a
member of a partitioned data set, include the member name
in this parameter.
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. This will supply 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 one- to eight-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.
Specify NONE if the 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 1-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 Graphics User DD Stmt. n (only used when GSF option is
NONE), where n is 1 to 3.
This parameter is retained for compatibility with prior
versions of MICF inquiry execution and color graphics
replay facilities. Select the Additional Data Set
Allocations option from the MICF Options menu to specify
additional data sets you want allocated for inquiry
execution and color graphics replay processing.
This defines special, user DD statements that are
required for certain SAS/GRAPH color graphics device
drivers. Three lines of free-form DD statement
information are provided. These lines may define a
single, multiline DD statement, or up to three
individual DD statements. Each must begin with //
followed by a blank or a valid DDNAME. These user-
defined DD statements are included in the batch job
stream ONLY if you specify NONE for the GSF Option
parameter.
Note: This parameter is not supported for foreground
inquiry execution and is normally left blank. This
parameter is not validated, exposing batch inquiry
execution to possible JCL errors if you specify invalid
JCL statements.
Note: You CANNOT override this parameter when executing
a MICF inquiry in batch mode. It is specified only
through the MICF Options or Shared MICF Options
processes.
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 that
complete error messages will be printed. Specify a one-
to three-digit number (that is, 1-999). When this value
is exceeded, processing continues but messages will not
be 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 one- to six-digit
number (that is, 1 - 999999). MICF will stop 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).
MADMI - Use MADMI (Dialog Manager Interface) for SAS
execution (YES/NO)?
MADMI is not supported for batch inquiry execution at
this time. Specify NO, or N, for this parameter.
Overprint error messages in inquiry SAS log (YES/NO)?
Specify YES, or Y, to overprint error messages in the SAS
log. This will highlight 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. This is the normal mode of
operation for batch inquiry execution.
Specify NO, or N, for simple printing of error messages.
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).
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 or MAX.
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 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 will 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; however,
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.
