5. MICF Administration › 5.1 Tasks Performed During Installation › 5.1.3 Shared MICF Options
5.1.3 Shared MICF Options
---------------------------- MICF Administration ----------------------------
Option ===>
0 - Shared MICF Options
Review/modify shared MICF parameters and default options.
1 - Shared Inquiry Output Catalog Administration
Add or delete entries in the shared inquiry output catalog.
2 - Shared Inquiry Catalog Administration
Add or delete entries in the shared inquiry catalog.
3 - Production Reporting Administration
Add, modify, execute, or delete MICF inquiry production jobs
X - Exit
-------------------------------------------------------------------------------
Figure 5-1. MICF Administration Panel
The shared MICF options are the parameters that control
information retrieval and reporting under MICF and the
default values for execution, reporting, and retrieval. MICF
is distributed with an operational set of default parameter
values. As the CA MICS Administrator, you should tailor
these defaults according to your data center's requirements.
To update the shared MICF options, select option 4, MICF
Administration Facility, from the primary MICF panel. You
will see the MICF Administration Panel, which is shown in
Figure 5-1.
Next select option 0, Shared MICF Options, from the MICF
Administration menu. You will then see the Shared MICF
Options panel (Figure 5-2).
---------------------------- Shared MICF Options ----------------------------
Option ===>
0 - MICF System Parameters
Specify system wide MICF parameters.
1 - User Profile Parameters
Specify defaults for general MICF parameters.
2 - Foreground Execution Parameters
Specify defaults for foreground MICF inquiry execution.
3 - Batch Execution Parameters
Specify defaults for batch MICF inquiry execution.
4 - Printer Format Parameters
Specify defaults for printed report and printer graphics formats.
5 - Color Graphics Format Parameters
Specify defaults for color graphic outputs.
6 - Data Set Allocation Parameters
Shared data set allocation parameters are updated via the CA MICS
Administrator Facility Options menu
-------------------------------------------------------------------------------
Figure 5-2. Shared MICF Options Panel
The parameters available from this menu are, with four
exceptions, the same parameters that are available to other
users of MICF and they are updated in the same manner. Once
these parameters have been updated on the Shared MICF Options
panel, they become the defaults for all MICF users who have
not overridden them from their own MICF options menus.
The one option that is available from this menu that is not
available to other users is the MICF System Parameters.
These are parameters that apply to all MICF users and cannot
be overridden by individual users. There are four MICF
System Parameters.
The shared data set allocation parameters are updated through
the CA MICS Administrator Facility Options menu and cannot be
accessed via the Shared MICF Options menu. The SAS Libraries
for ISPF Applications and Additional Data Set Allocations
options available on the MICF Options menu apply only at the
user level and do NOT have shared (or common) counterparts.
Therefore, these two options are not available on the Shared
MICF Options menu.
When installing MICF, review the distributed defaults and
tailor them to your data center's requirements. The
remainder of this section discusses parameters that are
especially important for local tailoring. Each of the
following categories of parameters is discussed below:
o MICF System Parameters
o User Profile Parameters
o Foreground Execution Parameters and Batch Execution
Parameters
o Printer Format Parameters
o Color Graphics Format Parameters
o Data Set Allocation Parameters
See Chapter 2 for details relating to these parameters and
valid values (except for the MICF System Parameters that are
fully described below).
MICF SYSTEM PARAMETERS
ADMDEFS DDNAME - GDDM ADMDEFS file allocation DDNAME
(defaults to ADMDEFS).
Specify DDNAME for allocating your data center's GDDM
definitions (ADMDEFS) file. The default, ADMDEFS, is
valid for most data centers. If your data center does
NOT use IBM's GDDM facility, then specify the default
value (ADMDEFS).
ADMDEFS DSNAME - GDDM ADMDEFS file DSNAME (fully qualified
DSNAME in quotes).
Specify the fully-qualified data set name, in quotes, for
your data center's GDDM definitions (ADMDEFS) file.
MICF allocates the ADMDEFS file for color graphics
processing, when requested by the user (see the ADMDEFS
parameter in Foreground/Batch Execution Parameters
below.)
If your data center does not use IBM's GDDM facility,
then leave this parameter blank.
Batch Allocation/Execution User Exit - Specify ISPF skeleton
name.
LEAVE THIS PARAMETER BLANK UNLESS YOU HAVE EXCEPTIONAL
DATA SET ALLOCATION REQUIREMENTS FOR MICF INQUIRY
EXECUTION AND/OR COLOR GRAPHICS REPLAY.
PLEASE DISCUSS YOUR REQUIREMENTS WITH CA TECHNICAL
SUPPORT BEFORE ATTEMPTING TO USE THIS EXIT FACILITY.
Specify the name of an ISPF skeleton member to activate
the batch allocation/execution user exit. You can use
this exit to insert additional JCL statements at the end
of the generated MICF inquiry job stream.
Foreground Allocation/Execution User Exit - ISPF SELECT
service operand.
LEAVE THIS PARAMETER BLANK UNLESS YOU HAVE EXCEPTIONAL
DATA SET ALLOCATION REQUIREMENTS FOR MICF INQUIRY
EXECUTION AND/OR COLOR GRAPHICS REPLAY.
PLEASE DISCUSS YOUR REQUIREMENTS WITH CA TECHNICAL
SUPPORT BEFORE ATTEMPTING TO USE THIS EXIT FACILITY.
Specify an ISPF SELECT service operand to activate the
foreground allocation/execution user exit. For example,
specify CMD(%USEREXIT) to invoke the CLIST named USEREXIT
from a data set in the current SYSPROC concatenation. Do
NOT specify the SELECT service statement. MICF will
issue the SELECT service with the specified value. You
can use this exit for special data set allocation
requirements not supported by standard MICF facilities.
Remember that the CA MICS online facility has NO control
over your SYSPROC concatenation and it is YOUR
responsibility to ensure that the user exit CLIST is
available to ALL CA MICS users.
Number of minutes (total) batch processing will wait for
unavailable data sets.
When MICF Production Reporting or other related batch
processing is unable to allocate a data set because the
data set is allocated to another batch job or TSO user,
processing will wait until the data set is available. If
the data set does not become available within the maximum
time limit you specify, processing will terminate due to
the data set allocation error.
Specify the maximum number of minutes (1 - 999) you want
batch processing to wait for data sets that are allocated
to another batch job or TSO user.
Specify 0 if you do NOT want batch processing to wait for
data sets.
Number of seconds between batch allocation retries for
unavailable data sets.
When MICF Production Reporting or other related batch
processing is unable to allocate a data set because the
data set is allocated to another batch job or TSO user,
processing will wait the number of seconds you specify
and then retry the failing data set allocation. If the
data set is still not available, then the wait/retry
cycle will be repeated until the allocation is successful
or the maximum wait time limit you specify is exceeded.
Specify the number of seconds (1 - 9999) you want batch
processing to wait before retrying failed data set
allocations.
USER PROFILE PARAMETERS
Color Graphics User - Do you normally use a color graphics
device (YES/NO)?
Specify YES if ALL users normally access MICF via a color
graphics terminal. Otherwise, specify NO.
Database ID - Specify the database ID (x) of the default
inquiry database.
Specify the ID of the unit database your users are most
likely to be using.
Execution Mode - Default inquiry execution mode
(BATCH/FOREGROUND).
Specify the execution mode you want your users to use
most of the time.
Execution Mode - Display execution mode before executing
inquiry (YES/NO)?
Specify NO if you do NOT want your users to alter the
execution mode you specified. This saves users one panel
interaction when executing inquiries.
File Mgmt. - Keep track of file contents and prime panel
entry fields (YES/NO)?
Specify YES for this parameter.
Function Selection Mode - Specify function selection path
(MENU/CATALOG).
Specify MENU. This provides the most help to your users.
Hold Inq. Output Save/CSV - Hold batch inquiry output for
replay (YES/NO).
Specify YES if ALL users should default to saving output
from batch inquiry execution for online review.
Job Card n - Default Job statement #n for ALL MICF batch
processing.
where n = 1 to 4.
Tailor this default JOB statement to agree with your
data center standards.
Local Printer - Default local printer name for printed report
routing.
If you use DSPRINT services and your users are likely to
use the Print Output to Local 3270 Printer option of the
Print Inquiry Output panel, specify the local 3270
printer used by the majority of your users.
Print Inquiry Output - Print all output or limit to report/
log (ALL/RPT/LOG)?
This parameter applies to the inquiry output replay Print
Inquiry Output option. Specify RPT to default to
printing just reports. Specify ALL to default to
printing both reports and CA MICS/SAS logs.
Production Reporting Hardcopy - Default additional SYSOUT
parameters.
This option provides the default for the MICF production
reporting Hardcopy Reports and Logs panel.
Specify this parameter if you normally specify additional
JES SYSOUT parameters such as CHARS, COPIES, FCB, FLASH,
HOLD, or UCS on SYSOUT DD statements for production
reporting.
Production Reporting Hardcopy - Default SYSOUT class (A-Z or
0-9).
This option provides the default for the MICF production
reporting Hardcopy Reports and Logs panel.
Specify the SYSOUT class used most often for production
reporting.
Production Reporting Hardcopy - Default SYSOUT destination.
This option provides the default for the MICF production
reporting Hardcopy Reports and Logs panel.
Specify this parameter if you normally specify a DEST=
parameter on SYSOUT DD statements for production
reporting. Specify the destination used most often for
production reporting.
Production Reporting Hardcopy - Default SYSOUT external
writer.
This option provides the default for the MICF production
reporting Hardcopy Reports and Logs panel.
Specify this parameter if you normally specify a writer
on SYSOUT DD statements for production reporting.
Specify the writer used most often for production
reporting.
Production Reporting Hardcopy - Default SYSOUT form code.
This option provides the default for the MICF production
reporting Hardcopy Reports and Logs panel.
Specify this parameter if you normally specify a form
number on SYSOUT DD statements for production reporting.
Specify the form number used most often for production
reporting.
Recovery - Provide automatic inquiry recovery during
composition (YES/NO)?
Specify YES. This protects your users from losing work
due to system failures.
Region size for batch job execution (for example, enter 4096
for REGION=4096K).
Specify this parameter to override your data center
default batch job region size. Leave this parameter
blank to use the data center default OR the region size
that is specified on the JOB statement.
Reports and Graphics - Automatically select report or
graphics option (YES/NO)?
Specify YES if you want MICF to automatically replay
color graphics or browse printed reports when your users
select an inquiry output for review. Color Graphics
replay is NOT selected automatically if you specify NO
for the Color Graphics User parameter.
Saved Files - Save ALL intermediate files generated by MICF
inquiries (YES/NO)?
Specify NO. Very few, if any, users will want to save
ALL intermediate files.
SAS Syntax Validation - Test panel entries for valid SAS
syntax (YES/NO)?
Specify YES for this parameter.
SYSOUT Class - Default SYSOUT class for printed report
routing (A-Z or 0-9).
Specify the SYSOUT class used by most users at your
data center.
SYSOUT Destination - Default SYSOUT destination for printed
report routing.
Specify this parameter if your users normally specify a
DEST= parameter on SYSOUT DD statements. Specify the
destination used by most of your users.
SYSOUT Form - Default SYSOUT form code for printed report
routing.
Specify this parameter if your users normally specify a
form number on SYSOUT DD statements. Specify the form
number used by most of your users.
SYSOUT Parameters - Additional, JCL format SYSOUT parameters
(for example, CHARS=).
Specify this parameter if your users normally specify
additional JES SYSOUT parameters such as CHARS, COPIES,
FCB, FLASH, HOLD, or UCS on SYSOUT DD statements.
SYSOUT Writer - Default SYSOUT external writer for printed
report routing.
Specify this parameter if your users normally specify a
writer on SYSOUT DD statements. Specify the writer used
by most of your users.
Test MICS - Allow access to test databases & test level
libraries (YES/NO)?
Specify NO for this parameter. Most of your users should
not access your test database. This also reduces the
number of unit databases from which they must select.
Keeping the number of choices small makes it easier for
your users to use MICF.
Validate panel entries against CA MICS file contents
descriptions (YES/NO)?
Specify YES for this parameter.
FOREGROUND EXECUTION PARAMETERS & BATCH EXECUTION PARAMETERS
The most important factors to consider for foreground and
batch execution are the default values for the parameters
required to use your color graphics devices. You would
normally specify parameters for your most common terminal
type color graphics device for the Foreground Execution
Parameters and your most common hardcopy color graphics
device (pen plotter or color printer) for the Batch Execution
Parameters. The specific parameters depend on the specific
device you are using. Refer to the SAS/GRAPH documentation
for more information.
Basically, MICF must know the same things that you would
specify to use the color graphics device with a stand-alone
SAS program. If you have never used a device with SAS, the
parameters used to access the device with other graphics
facilities can provide a starting point for using the SAS
documentation. The following color graphics parameters are
available.
Color Graphics - Display color graphics during inquiry
execution (YES/NO)?
Specify NO for foreground and YES for batch.
When your users execute inquiries in batch mode with
color graphics saved for later online review, they will
probably want to override the default and specify NO.
Color Graphics - Replay color graphics during inquiry
execution (YES/NO)?
Specify YES for foreground. This parameter does not
apply to batch execution.
Color Graphics ADMDEFS File - Allocate GDDM ADMDEFS file
(YES/NO)?
Specify YES if you use IBM's GDDM facility and you
specified ADMDEFS DSNAME in CA MICS System Parameters.
Color Graphics Device - Specify the default color graphics
device name.
This parameter is required. It must be one of the color
graphics device drivers listed in the SAS/GRAPH
documentation.
Color Graphics DDNAME - Output DDNAME for graphics stream
processing.
This parameter is required.
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.
Otherwise, specify the default, ICFGRAPH.
Color Graphics DISP - Color graphics output data set
disposition (OLD/MOD).
Specify color graphics data set disposition if you
specify color graphics DSNAME below.
Color Graphics DSNAME - Color graphics output data set name.
Specify this parameter to write the color graphics output
to a cataloged DASD data set.
Color Graphics Format Set - Specify the default color
graphics format set name.
This parameter is required. Specify the color graphics
format set that corresponds to the type of device (for
example, specify PENPLOT for a pen plotter).
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 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 (for example, 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 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.
Specify this parameter to write the color graphics output
to JES spool.
Color Graphics SYSOUT Destination - SYSOUT destination for
graphics output.
Specify this parameter to write the color graphics output
to JES spool with a DEST= SYSOUT allocation parameter.
Color Graphics SYSOUT Form Code - SYSOUT form code for
graphics output.
Specify this parameter to write the color graphics output
to JES spool for processing with a specific form code.
Color Graphics SYSOUT Parms. - Additional, JCL format SYSOUT
parameters.
Specify this parameter if you need additional JES SYSOUT
allocation parameters such as CHARS, COPIES, FCB, FLASH,
HOLD, or UCS to process the color graphics output.
Color Graphics SYSOUT Writer - SYSOUT external writer for
graphics output.
Specify this parameter to write the color graphics output
to JES spool for processing by a SYSOUT external writer.
Color Graphics User DD Stmt. n (only used when GSF Option is
NONE).
where n is 1 to 3.
Specify this parameter if the SAS/GRAPH device driver
being used requires additional user-specified DD
statements. This parameter applies only to batch inquiry
execution.
Color List n - Specify the "color list" for the graphics
device.
where n is 1 to 3.
The SAS system provides a default color list for each
device driver. The SAS list is usually valid. Only
specify the color list parameter if you must override the
SAS default.
GOPTIONS Parameters n - Specify GOPTIONS parameters for the
graphics device.
where n is 1 to 3.
This parameter is required for most color graphics
devices. The values specified depend on the device and
how you have installed the device at your data center.
See the SAS/GRAPH documentation for details.
PRINTER FORMAT PARAMETERS
The primary changes you may want to make to the printer
format parameters relate to tailoring the default report
title. The distributed defaults are:
o The first title line is the inquiry title (or long
name).
o The second title line is the data center name.
o The third title line is the report time frame, if the
inquiry includes time frame selection. It is blank if
time frame selection is not used.
o The fourth title line is the six-character inquiry
name and the execution date.
o Page numbers are included on reports.
The following parameters are available and can be used to
establish an alternative default title structure.
Date - Print the current date on the first title line of each
page (YES/NO)?
Specify NO unless you do not include the execution date
on the fourth title line.
Page Numbers - Print page numbers on first title line of each
page (YES/NO)?
Title 1 - Alternate default title line 1 (if not inquiry
title).
Title 1 - Use inquiry title as the default report title line
1 (YES/NO)?
Title 2 - Alternate default title line 2 (if not data center
name).
Title 2 - Use data center name as the default report title
line 2 (YES/NO)?
Title 3 - Alternate default title line 3 (if not time frame
specification).
Title 3 - Use time frame specification as the default title
line 3 (YES/NO)?
Title 4 - Alternate default title line 4 (if not inquiry name
and/or run date).
Title 4 - Use inquiry name and/or run date as title line 4
(BOTH/INQ/DATE/NONE)
COLOR GRAPHICS FORMAT PARAMETERS
The primary changes you may want to make to the color
graphics format parameters relate to tailoring the default
color graphics title. The distributed defaults are:
o The first title line is the inquiry title (or long
name).
o The second title line is the data center name.
o The third title line is the report time frame, if the
inquiry includes time frame selection. It is blank if
time frame selection is not used.
o The color graphics footnote is the six-character
inquiry name and the execution date.
The following parameters are available and can be used to
establish an alternative default title structure. If you
alter these parameters, remember to alter each of the
distributed color graphics format sets. Each color graphics
format set is independent and could define a unique default
title structure if you so desire.
Title 1 - Alternate default title line 1 (if not inquiry
title).
Title 1 - Use inquiry title as the default report title line
1 (YES/NO)?
Title 2 - Alternate default title line 2 (if not data center
name).
Title 2 - Use data center name as the default report title
line 2 (YES/NO)?
Title 3 - Alternate default title line 3 (if not time frame
specification).
Title 3 - Use time frame specification as the default title
line 3 (YES/NO)?
Title 4 - Alternate default title line 4 (if not inquiry name
and/or run date).
Title 4 - Use inquiry name and/or run date as title line 4
(BOTH/INQ/DATE/NONE)
Beyond altering the title, you may want to tailor the color
graphics format sets for your specific color graphics
devices. The following are examples of potential tailoring
situations:
o The TERMINAL color graphics format set is based on the IBM
3279. If you have a color graphics terminal that supports
more colors, you can alter the pattern and line color
specifications to use more of the available colors.
o The PENPLOT color graphics format set is based on an
eight-pen plotter. If your pen plotter has only four
pens, then you would want to alter the specifications to
use only four colors.
You might also want to change the colors used for titles,
text, and axes according to data center preferences.
DATA SET ALLOCATION PARAMETERS
You can tailor the data set allocation parameters to meet
your data center standards.
o You may want to alter the data set names per data center
standards. Any changes to the data set name should be
made before the first MICF user executes an inquiry. If
the data set name parameter is altered after a user has
executed an inquiry in foreground mode, the user will lose
access to saved inquiry output and saved intermediate
files.
o You may want to specify a specific unit type for MICF data
sets, or even a specific volume for MICF users.
o You may want to alter the space allocations for the type
of DASD devices at your data center.
Select the Data Set Allocations option from the CA MICS
Administrator Facility Parameters menu to specify data set
allocation parameters for MICF-related data sets. See
Section 5.1.1.4 for more information.
