Previous Topic: 5.1.6.7.5 Usage NotesNext Topic: 5.1.6.8.1 Prerequisites


5.1.6.8 Q&R Integration


 The Q&R Integration feature writes MICF inquiry output
 generated from a production or user reporting job stream to a
 HFS/zFS directory structure compatible with the CA MICS Q&R
 Workstation.
 
 This feature utilizes IBM's NFS (Network File System) and
 Microsoft Windows' CIFS (Common Internet File System) to
 share UNIX files between the two operating systems.  These
 remote z/OS UNIX files are mounted from the mainframe to
 appear as local directories or files on the client system.
 
 The NFS uses the communication services provided by TCP/IP,
 a suite of protocols that includes the remote procedure
 call (RPC) and External Data Representation (XDR) protocols.
 RPC allows a program on one machine to start a procedure on
 another machine, as if the procedure is local. XDR resolves
 the differences in data representation of different machines.
 The NFS, then, can be used for file sharing between platforms
 and file serving (as a data repository).
 
 The Q&R directory structure, coupled with the ability to map
 the Q&R HFS/zFS directory as an additional drive to the Q&R
 distributed server, allows the RMWSLOAD utility to read
 directly from the HFS/zFS directory without moving the data
 to the distributed server for publication of chart and report
 output.
 
 For more information on RMWSLOAD, see the Q&R Workstation
 Administration Guide.
 
 Additional benefits include direct viewing of the directory
 from Q&R Output Retrieval (see the next section for more
 information on Output Retrieval.)  You do not have to run
 RMWSLOAD to access job stream output unless you are ready to
 publish to your web server.  This lets you generate View
 Definition Files to perfect the look of the chart prior to
 publication.
 
 Finally, sharing the HFS/zFS directory between your z/OS UNIX
 (USS) environment and Microsoft Windows lets you publish all
 your CA MICS output (either MWP or Q&R) to one web server,
 Microsoft Internet Information Services (IIS).
 
 Below is a general overview of the job stream processing.


 
 *********************
 * Execute reporting *
 *    job stream     *
 *********************
           |
 +------------------+
 | Deletes oldest   |
 | cycles of PDS    |
 | MWP if requested |
 +------------------+
           |
 +------------------+
 | MICF Inquiry     |
 |  executes        |
 +------------------+
           |
    /------------\   no    +-------------+
   < MWP active?  >------->| do not write|
    \------------/         | CSV/log o/p,|
           |               | write to PDS|
           |               | only        |
           |               +-------------+
          yes
           |
 +------------------+
 | Create HFS/zFS   |
 | directory, create|
 | HTML output      |
 +------------------+
           |
    /------------\   no    +-------------+
   < MWP CSV yes? >------->| do not write|
    \------------/         | CSV/log o/p |
           |               | to HFS/zFS  |
           |               +-------------+
          yes
           |
           |
 +-------------------+
 | After inquiry ends|
 | write csv/micslog |
 | saslog            |
 +-------------------+
           |
    /----------------\   no    +-------------+
   < Q&R Integration?>-------->| Execute next|
    \----------------/         | inquiry     |
           |                   +-------------+
          yes
           |
   +-------------------+
   | Write all output  |
   | to Q&R directory  |
   | structure         |
   +-------------------+
           |
    /----------------\         +--------------+
   < hh-mm directory >   no    | Create dir,  |
   < already exists? >-------->| write output |
    \----------------/         | files        |
           |                   +--------------+
          yes
           |
   +-----------------+
   | Create new      |
   | hh-mm dir with  |
   | execution order |
   | appended to time|
   | dir: hh-mm(n)   |
   +-----------------+
           |
    /----------------\   no    +---------------+
   < More inquiries? >-------->| Return max CC,|
    \----------------/         | end job       |
           |                   +---------------+
          yes                         |
           |                          |
   +---------------------+     /------------------\ no
   | Execute next inquiry|     <Initiate RMWSLOAD?>------->+------+
   +---------------------+     \------------------/        | Done |
                                      |                    +------+
                                     yes
                                      |
                               +---------------------+
                               | Execute MQRNOTIF    |
                               | program as last step|
                               +---------------------+

 The MQRNOTIF program notifies the Q&R mainframe server that
 the job stream has completed.  The mainframe server notifies
 the distributed server to begin executing the corresponding
 RMWSLOAD job.
 
 o If you are using the Q&R directory structure, RMWSLOAD is
   scheduled and publishes the output to your web server.
 
 o If you are using the DTF index as the interface to
   RMWSLOAD, RMWSLOAD downloads your reporting job stream
   output and then publishes the output to your web server.

 Review all of these topics before using this feature.
 
 1 - Prerequisites
 2 - Setup
 3 - Directory Structure
 4 - Usage Notes
 5 - Q&R RMWSLOAD