Previous Topic: 5.1.6.1 Controlling Access to Reports and Graphics

Next Topic: 5.1.6.2.1 MICF Inquiries for Reporting Job Stream

5.1.6.2 Defining a Production Reporting Job Stream



------------------------ Insert Reporting Jobstream -------------------------


Command ===>



Jobstream Name ===> IMSDAILY Title ===> IMS Daily Reports Catalog Table Data Set ===> 'SYSPROD.MICS.IMSDAILY.CATALOG'




Space units ===> TRK (BLK, TRK, or CYL) Primary quantity ===> 2 (In above units) Secondary quantity ===> 1 (In above units) Directory blocks ===> 1 (For partitioned data sets) Round block alloc. ===> NO (YES/NO) Block size ===> 9040 (Maximum block size) Record length : 80 Data set org. : PO Record format : FB Generic unit ===> 3380PROD (Generic group name or unit address) Volume serial ===> ______ (Blank for default volume) Expiration date ===> ________ (yyddd or yyyy/ddd) Retention period ===> ______ (Number of days) Additional allocation parameters: DCB ===> ___________________________________________________________ Other ===> ___________________________________________________________



. . . . . . . . . . . . . . . . . . . . . . . . . .


Figure 5-5.  Sample Insert Reporting Jobstream Panel


The Insert Reporting Jobstream panel (Figure 5-5) is
displayed when you enter the Insert (I) line command on the
Production Reporting Administration panel.  Enter job stream
name, title, and catalog data set allocation parameters and
then press END to initialize the new production reporting
job stream definition.

o  Jobstream Name is required.  This 1-8 character "short
   name" or key is used to save and reference the new
   production reporting job stream.  Jobstream Name must be
   unique and cannot be SHARED, PRIVATE, or BSTAGE.

o  Title is required.  The 1-40 character title is displayed
   on the Production Reporting Administration and on the
   Reports and Graphics panels.

o  Catalog Table Data Set is required.  Enter a fully
   qualified data set name (DSN) in quotes.  Do not enter a
   member name.  If you do not enclose the DSN in quotes,
   your TSO user PREFIX and the quotes will be added.

   Choose the catalog table DSN carefully.  You CANNOT change
   the DSN after you leave this panel.  The production
   reporting definition and the output catalog are stored in
   this data set.  Enter a DSN appropriate to the level of
   security you need for the associated reports and graphics.
   Users will allocate this data set to review production
   reports.  You will reference and update this data set
   through batch job JCL statements to execute the production
   reports.


---------------------- Reports and Graphics Jobstream -----------------------


Command ===>



Jobstream Name ===> IMSDAILY Title ===> IMS Daily Reports Maximum Report Retention ===> 15 (0-999 reporting cycles) Associated CA MICS Job ===> DAILY Database ID ===> I (IMSUNIT) Default File Cycle(s) ===> 01 - 00 (00-99) Catalog Table Data Set: 'SYSPROD.MICS.IMSDAILY.CATALOG' Permanent Data Sets (allocated for each job stream execution) Printed Reports DSN ===> 'SYSPROD.MICS.IMSDAILY.MWFPDS**.DATA' Color Graphics DSN ===> 'SYSPROD.MICS.IMSDAILY.MWFSAS**.DATA'



Temporary Work Data Sets (deleted after job stream execution) Report DSN ===> 'SYSPROD.MICS.IMSDAILY.REPORT' MICSLOG DSN ===> 'SYSPROD.MICS.IMSDAILY.LOG' Specify MICF Inquiries for Reporting Jobstream ===> N (Y/N) *** Specified *** Override Data Set Allocation Parameters ===> N (Y/N) Specify Execution and Hardcopy Output Options ===> N (Y/N)



. . . . . . . . . . . . . . . . . . . . . . . . . .

Figure 5-6.  Sample Reports and Graphics Jobstream Panel


o  The remainder of the panel provides data set allocation
   specifications for the catalog table data set.  Default
   values are taken from the PCATALOG entry in MICF Options,
   Data Set Allocation Parameters.  The catalog table data
   set contains two ISPF tables.  DASD space requirements
   will vary depending upon the number of inquiries in the
   production reporting job stream and the number of output
   cycles (or job stream executions) you retain.

When you press END (or enter the END primary command) on the
Insert Reporting Jobstream panel, MICF saves your
specifications, allocates the catalog table data set,
initializes the job stream definition and production catalog
tables, and then displays the Reports and Graphics Jobstream
panel (Figure 5-6) so you can complete the production
reporting job stream definition.

The Reports and Graphics Jobstream panel (Figure 5-6) is
displayed when you enter the Select (S) line command on the
Production Reporting Administration panel (Figure 5-4) or
when you enter END on the Insert Reporting Jobstream panel
(Figure 5-5).  Use this panel to complete and/or update the
production reporting definition.

You can change the job stream name and title on this panel.
Other parameters are discussed below.

o  Maximum Report Retention is required and defaults to 12.

   -  This parameter defines the number of output cycles (or
      job stream executions) retained in the production
      catalog.  The production job stream execution process
      deletes reporting cycles (beginning with the oldest)
      when the number of catalog cycles exceeds this value.

   -  Note:  The printed report and color graphics DSNs must
      contain one asterisk (*) for each digit in the
      parameter.

   -  If you are generating hardcopy reports and/or color
      graphics AND if you are not creating CSV files, then
      you can specify 0 for maximum report retention.  After
      execution completes, MICF will delete the printed
      report and color graphics data sets used to hold
      printed reports, color graphics, MICSLOG, and SAS log
      during execution processing.

o  Associated CA MICS Job is optional. Enter the name of a
   production CA MICS job (for example, DAILY, WEEKLY, or
   MONTHLY) to generate production reports and graphics with
   production CA MICS processing. Leave this parameter blank
   to control production report execution with your data
   center's batch job scheduling facilities.  If you have
   CA MICS Accounting and Chargeback installed, you can enter
   INVOICE or FINRECAP to associate the production reporting
   jobstream with the INVOICE or FINRECAP job.

o  Database (DB) ID is optional and provides the default DB
   ID for MICF inquiry execution and CA MICS production job
   association.  If your inquiries allow execution-time DB ID
   override and do NOT specify a default value, then you can
   provide the default here.  Remember that inquiry level
   execution-time parameter overrides will override this
   default.  If you specify DAILY, WEEKLY, or MONTHLY for
   Associated CA MICS Job, specify the DB ID to which the
   reporting applies.  Leave DB ID blank if you are defining
   complex-level production reporting.

o  Default File Cycle(s) is optional and provides the default
   CA MICS file cycle (specify first field) or cycle range
   (specify both fields) for inquiry execution.  If your
   inquiries allow execution-time cycle override and do NOT
   specify a default value, then you can provide the default
   here.  Remember that inquiry level execution-time
   parameter overrides will override this default.

You can specify DB ID and File Cycle(s) uniquely for each
inquiry through the execution-time parameter override
facility.  Select the "Specify MICF Inquiries for Reporting
Jobstream" extended option to override execution-time
parameters.

Two permanent data sets are allocated for each production job
stream execution.  Data entry fields are provided for Printed
Reports DSN and Color Graphics DSN.  Both are required.
Specify fully qualified data set names (DSN) in quotes.  Do
not enter a member name.  If you do not enclose a DSN in
quotes, your TSO user PREFIX and the quotes will be added.

o  Data entry fields are initialized from Catalog Table DSN,
   replacing the last DSN qualifier with MWFPDS**.DATA for
   Printed Reports DSN and MWFSAS**.DATA for Color Graphics
   DSN.  If Catalog Table DSN has only one DSN index, then
   MWFPDS**.DATA and MWFSAS**.DATA are appended to the end of
   Catalog Table DSN.  The  *s (asterisks) in the DSNs
   indicate where the generation (or logical cycle) number
   will appear.  You must include one asterisk (*) for each
   digit in the Maximum Report Retention value.

o  If an execution of the production reporting job stream
   does NOT generate any color graphics, then MICF will
   delete the color graphics data set after execution
   completes.

o  Printed Reports DSN and Color Graphics DSN apply only to
   new data set allocations (that is, new job stream
   executions).  You can change DSNs without impacting
   reports and graphics saved by previous executions (that
   is, you do not lose existing cycles when you change DSN).

o  If you specify 0 for Maximum Report Retention, then the
   printed reports and color graphics data sets are used as
   staging data sets to hold printed reports, color graphics,
   MICSLOG, and SAS log during execution processing.  MICF
   will delete the printed reports and color graphics data
   sets after execution completes.

Two inquiry output staging data sets are allocated for
reporting job stream execution and are deleted when
processing terminates normally.  Data entry fields are
provided for Report DSN and MICSLOG DSN. Both are
required.  Specify fully qualified data set names (DSN) in
quotes.  Do not enter a member name.  If you do not enclose a
DSN in quotes, your TSO user PREFIX and the quotes will be
added.  Data entry fields are initialized from Catalog Table
DSN, replacing the last DSN index with REPORT for Report DSN
and MICSLOG for MICSLOG DSN. If Catalog Table DSN has
only one DSN index, then REPORT and MICSLOG are appended to
the end of Catalog Table DSN.

Use the remaining data entry fields to access subordinate
options.  The MICF Inquiries for Reporting Jobstream option
is required.  All others are optional.  Specify Y (Yes) in
the data entry field following an option to invoke that
option panel.  Once you specify an option, a flag will appear
on the right side of the panel.  If you select multiple
options (that is, you enter a Y on more than one line), the
options are processed sequentially.

The extended options are discussed in the following sections.

1 - MICF Inquiries for Reporting Job Stream
2 - Data Set Allocation Parameters
3 - Execution and Hardcopy Output Options