The Data Index

The Data Index (DI) shows you the data sets that are available throughout the sysplex.

The Data Index provides information about the data that is currently available for your reporter session. The data that it contains is either:

Current data from all active Monitor III data gatherers in the sysplex. The current data represents all available data from every system that can be found in the sysplex.
Previously stored data from a Monitor III gatherer session (so called preallocated data sets).

The Data Index displays the list of systems in alphabetical order by system ID of the RMF Monitor III data gatherer that recorded the data. You can also see if data is missing, or could not be retrieved due to one of the following reasons:

No data is available for the requested system
The system does not respond to a request for data
The gatherer for the system is not active
RMF is not active on a system
The preallocated data set is empty or has an error

Thus the Data Index provides a compact overview of information about all systems belonging to the sysplex regardless of whether RMF is active or not.

How to request the Data Index

Select S on the Primary menu, and then D on the Sysplex Report menu, or you can enter the following command:

DI

Contents of the Data Index

Read the following information about the Data Index:

If you are using active Monitor III gatherers in the sysplex

For each active Monitor III gatherer in the sysplex, the following will be displayed on the Data Index:

The RMF in-storage buffer; and
If the Monitor III gatherer has been started with data set support, all data sets used by the Monitor III gatherer for recording data.

Rows with data that are available on the local system are displayed in turquoise. All other rows are displayed in dark blue.

Figure 1 shows a sample Data Index that is using data from active Monitor III data gatherers in a sysplex.

Figure 1. Data Index

                         RMF V2R1  Data Index - RMFPLEX1          Line 1 of 22
 Command ===>                                                  Scroll ===> HALF

 Samples: 118     System: MVS2  Date: 11/27/13  Time: 10.12.00  Range: 120   Sec

        ----Begin/End----
 System --Date-- --Time-- -DDNAME- ---------------Data Set Name-----------

 MVS1   11/27/13 10.03.20
                 10.12.00             * * *      In-storage buffer     * * *
 MVS1                     SYS00002 RMF.MONITOR3.DATASET1.MVS3
                                      * * *    Data from system MVS3   * * *
 MVS1                     SYS00001 RMF.MONITOR3.DATASET2.MVS3
                                      * * *    Data from system MVS3   * * *

 MVS2   11/27/13 09.11.00 SYS00002 RMF.MONITOR3.DATASET1.MVS2
                 09.14.00
 MVS2   11/27/13 10.03.00 SYS00003 RMF.MONITOR3.DATASET2.MVS2
                 10.12.00             * * *      Currently active      * * *
 MVS2   11/27/13 10.03.00
                 10.12.00             * * *      In-storage buffer     * * *

 MVS3   11/27/13 09.11.00 SYS00002 RMF.MONITOR3.DATASET1.MVS3
                 09.14.00
 MVS3   11/27/13 10.03.00 SYS00003 RMF.MONITOR3.DATASET2.MVS3
                 10.12.00             * * *      Currently active      * * *
 MVS3   11/27/13 10.03.00
                 10.12.00             * * *      In-storage buffer     * * *
 TEST
                                      * * *      No response        * * *

If you are using preallocated data sets

If a local session has had data sets preallocated to it before the RMF reporter is started, the Data Index will only display data from those data sets. This is independent of the active Monitor III gatherers in the sysplex. For information about how to preallocate data sets to the local session, refer to the z/OS RMF User's Guide.

All rows will be shown in dark blue.

Note: It is possible to preallocate data sets from different systems, but only one sysplex can be represented by the data in those data sets. If the data represents more than one sysplex, the Data Index is displayed, and no other report can be generated. To resolve the problem, end the session, deallocate any data sets with a different sysplex ID, and start a new session.

Figure 2 shows a sample Data Index that is using data from preallocated data sets to a reporter session.

Figure 2. Data Index with Preallocated Data Sets - Detailed View

                         RMF V2R1  Data Index - RMFPLEX           Line 1 of 18
 Command ===>                                                  Scroll ===> HALF

 Samples: 37      System: RMFB  Date: 09/28/13  Time: 13.09.00  Range: 60    Sec

        ----Begin/End----
 System --Date-- --Time-- -DDNAME- ---------------Data Set Name-----------------

 RMFA   09/28/13 04.17.00 RMFDS01  RMF.RMFA.RMFDS01
                 06.26.00
 RMFA   09/28/13 04.20.00 RMFDS00  RMF.RMFA.RMFDS00
                 06.28.00
 RMFA   09/28/13 11.28.00 RMFDS02  RMF.RMFA.RMFDS02
                 13.07.00
 RMFB   09/28/13 04.16.00 RMFDS04  RMF.RMFB.RMFDS01
                 06.24.00
 RMFB   09/28/13 04.26.00 RMFDS05  RMF.RMFB.RMFDS00
                 06.36.00
 RMFB   09/28/13 11.58.00 RMFDS03  RMF.RMFB.RMFDS02
                 13.10.00
 RMFC   09/28/13 04.17.00 RMFDS07  RMF.RMFC.RMFDS01
                 06.26.00
 RMFC   09/28/13 04.27.00 RMFDS06  RMF.RMFC.RMFDS00
                 06.37.00
 RMFC                     RMFDS07  RMF.RMFC.RMFDS02
                                        * * *          Empty         * * *

Condensed information on the Data Index

The detailed version of the Data Index allows you to display all data sets that are available throughout the entire sysplex, or all data sets that are preallocated to one session. As this may be a long list, you can use the DDNAMES/DSNAMES option on the Report Options panel to compress the data set level information per system.

Figure 3 and Figure 4 show what the data displayed in Figure 1 and Figure 2, respectively, look like if the DDNAMES/DDNAMES option is used to condense the information displayed.

Figure 3. Data Index - Condensed Version

                         RMF V2R1  Data Index - RMFPLEX1           Line 1 of 4
 Command ===>                                                  Scroll ===> HALF

 Samples: 118     System: RMFE  Date: 11/27/13  Time: 10.12.00  Range: 120   Sec

        ------Begin------          -------End-------
 System --Date-- --Time--          --Date-- --Time--

 MVS1   11/27/13 10.03.20          11/27/13 10.12.00
 MVS2   11/27/13 09.11.00          11/27/13 10.12.00
 MVS3   11/27/13 09.11.00          11/27/13 10.12.00
 TEST                                    * * *   No response        * * *

Figure 4. Data Index with Preallocated Data Sets - Condensed Version

                         RMF V2R1  Data Index - RMFPLEX            Line 1 of 3
 Command ===>                                                  Scroll ===> HALF

 Samples: 37      System: RMFB  Date: 09/28/13   Time: 13.09.00  Range: 60    Sec

        ------Begin------          -------End-------
 System --Date-- --Time--          --Date-- --Time--

 RMFA   09/28/13 04.17.00          09/28/13 13.07.00
 RMFB   09/28/13 04.16.00          09/28/13 13.10.00
 RMFC   09/28/13 04.17.00          09/28/13 06.37.00

The condensed version of the Data Index displays information about data that is available throughout the sysplex. It shows at a glance, for which time ranges data is available on each system, or if no data is available at all or could not be retrieved due to special conditions.

Data Index — field descriptions

For a description of the report header area of the Data Index, refer to Header for single-system reports, and Header for sysplex reports, where the various header fields are described in more detail.

Note: The Data Index title line contains a sysplex ID field like in sysplex reports, but instead of a WLM Samples: field, it shows just the Samples: field as in single system reports. The sysplex ID field in the title line can be blank if you are using data from an old RMF gatherer or have preallocated data from a previous release of RMF.

Table 1. Fields in the Data Index
Field Heading	Meaning
System	The four-character SMF system identifier of the Monitor III gatherer that collected the data. If the identification of the system could not be determined, the field contains '????'.
Begin/End Date Time	These are the beginning and ending dates/times for the data in the usable and not-empty data sets or the in-storage buffers. If the beginning and ending dates are the same, RMF will only display the beginning date. If there is a problem with the data, the dates and times are left blank, and a message is shown.
DDNAME	For a Data Index using active gatherer's data, the DDNAME is the system generated DD name for the data set that has been dynamically allocated for the data gatherer's session. For a Data Index using preallocated data sets, this is the name that was specified in RMFDSxx on the ALLOCATE command issued before the reporter session was started. If there is a problem with the data, the field remains blank. Also, note that the field remains blank if this line is representing the gatherer's in-storage buffer.
Data Set Name	This field has two lines. The first line contains the name of the VSAM data set containing the data. The second line is either blank or contains a comment concerning the status of the data. (See Information and error messages on the Data Index.) Note that the first line is blank when the data represents a gatherer's in-storage buffer.
Begin Date Time	The begin date and time for which data is available on the respective system. This field is blank if there is no data to be represented for the system.
End Date Time	The end date and time for which data is available on the respective system. This field contains a comment about the status of the data if a problem was encountered.

Note: If you are using old data, the sysplex ID and other fields may be blank.

Information and error messages on the Data Index

The following messages can be shown in special cases:

*** Currently active ***

The currently active data set for the Monitor III data gatherer session (appears only on the Data Index for a reporter session without preallocated data sets)

*** In-storage buffer***

The local storage buffer entry of the Monitor III data gatherer

*** Empty ***

Data set with no usable data. For a session without preallocated data sets, data set recording might not be active and RMF cannot find the LRECL or CI SIZE for the data sets. For a session with preallocated data sets, the data set might be empty or contain other than sampled data gathered during a Monitor III data gatherer session.

*** No data available ***

There is no data available for the system listed in the System: field on this line.

*** No response ***

A system that is part of the sysplex, according to the XCF system name list, does not reply to the request for data

***Gatherer not active ***

RMF is active on a system, but the Monitor III gatherer is not started

*** RMF not active in xxxxxxxx ***

The RMF address space is not active on system xxxxxxxx. Therefore, no data can be reported for this system.

The eight-character z/OS system name xxxxxxxx is defined in the SYS1.PARMLIB(IEASYSxx) parameter SYSNAME.

The four-character SMF system ID, defined in the SYS1.PARMLIB(SMFPRMxx) parameter SID(xxxx) cannot be determined, and is set to '????'.

The following messages occur when the data gatherer tried to use the data set.

*** Not Found ***: Uncataloged data set specified on the DATASET option of the Monitor III data gatherer session (the data set is unusable)
*** Invalid RECSIZE ***: Data set specified with an invalid record size (the data set is unusable)
*** Invalid CISIZE ***: Data set specified with an invalid control interval size (the data set is unusable)
*** Open Error RC=xx reason=xxx ***: Error in opening the data set (the data set is unusable)
*** Close Error RC=xx reason=xxx ***: Error in closing the data set (the data set is unusable)
*** VSAM error RC=xx reason=xxx ***: Error in reading the VSAM data set (the data set is unusable)
*** DYNALLOC RC=xx IRC=xxxx ERC=xxxx ***: Dynamic allocation error (the data set is unusable)
*** UNALLOC RC=xx IRC=xxxx ERC=xxxx ***: Data set unallocated (the data set is unusable)
*** Sample time exceeds current time ***: Data set with a sample time that is later than the current system time. The system time has probably been incorrectly set. (This message does not appear on the screen with preallocated data sets.)
*** Data from sysplex xxxxxxxx ***: For either preallocated data sets or gatherer data sets, a data set that is from a sysplex other that the one selected has been encountered. Only one sysplex can be represented by the data on the Data Index. No other reports can be shown as long as this error persists.
*** Data from system xxxx ***: The reporter cannot report data from gatherer data sets from another system. The gatherer marks the data sets as unusable if more than one system has written to a data set. The reporter cannot access the data in data sets that are marked unusable.
The reporter also cannot report data from different sysplexes in one session.

Cursor-sensitive control

Cursor sensitivity on the System field switches to the selected system, that means, data from the requested system is retrieved (if available), and the Data Index is redisplayed, with the selected system shown in the header System field, and the corresponding lines of the report shown in turquoise.

Data Index options

Figure 5. Data Index Options Panel

                         RMF Data Index Options
 Command ===>

 Change or verify parameters. Press END to save and end.

    DDNAMES/DSNAMES  ==> YES      Include DDNAMES / DSNAMES information (YES NO)
    Sort Order       ==> ASCEND   Sort data set names (ASCEND DESCEND)

The Data Index has two options:

The DDNAMES/DSNAMES option allows you to determine the amount of information that will be displayed. There are two valid values for the DDNAMES/DSNAMES option:
YES

This value gives you a more detailed Data Index. It contains, at a data-set level, the data that is used on other RMF reports. You can see if there are any specific problems with the available data. See Figure 1 and Figure 2 for example screens.

NO

This value gives you a condensed version of the Data Index. You can see what systems are available for reporting rather than the actual data that is available. See Figure 3 and Figure 4 for example screens.
The Sort Order is available on the Data Index Options panel, so that it can be accessed with the ROPTIONS command from the Data Index screen. If more than one row with the same system identification exist, the usable data sets that are not empty are listed first, then the empty data sets, and finally the unusable data sets. The usable data sets that are not empty are sorted according to the end time of the stored data.
The entire Data Index is sorted by system ID. The Sort Order option allows you to change the sorting of the individual data entries for each system. The two valid values for this option are:
ASCEND

This value causes the entries in the Data Index to be sorted with the oldest data at the top of the individual system lists. See Figure 1 for an example.

DESCEND

This value causes the entries in the Data Index to be sorted with the latest data first for each system. See Figure 6 for an example.

Figure 6. Data Index - Sort Order Descend

                     RMF V2R1  Data Index - RMFPLEX1              Line 1 of 14
 Command ===>                                                  Scroll ===> HALF

 Samples: 100     System: MVS1  Date: 09/28/13  Time: 10.31.40  Range: 100   Sec

        ----Begin/End----
 System --Date-- --Time--  -DDNAME- ---------------Data Set Name----------------

  MVS1  09/28/13 09.55.00
                 10.31.40                 * * *   In-storage buffer  * * *
  MVS1  09/28/13 05.53.20  SYS00003 SYS3.RMF.DS02
                 10.11.40                 * * *   Currently active   * * *
  MVS1  09/28/13 01.31.40  SYS00002 SYS3.RMF.DS01
                 05.53.20

  MVS2  09/28/13 09.55.00
                 10.31.40                 * * *   In-storage buffer  * * *
  MVS2  09/28/13 01.31.40  SYS00003 SYS3.RMF.DS01
                 10.11.40                 * * *   Currently active   * * *

  TEST
                                          * * *   No response        * * *

Note: Since the condensed version of the Data Index (DDNAMES/DSNAMES = NO) has only one entry per system, changing the Sort Order option will not have any effect on the condensed version of the Data Index.