Generic VSAM Cluster data
This reference lists the configuration values that you can update for Generic VSAM Cluster data. Currently, the Data Collector doesn’t support collecting paired VSAM data sets in one VSAM gather at the same time. If the paired data sets exist, you need to define two gathers to collect the log data from both VSAM data sets. Only the VSAM ESDS data set is supported.
- Data source
- You can define the specific data source that you want to collect in the
Add/Edit data resource
window. In this case, select VSAM. - Data source type
- A value that the subscriber can use to uniquely identify the type and format of the streamed data. The value for VSAM Cluster data is zOS-DATA-SET.
- VSAM instance name
- The name to specify a VSAM gather instance.
- Data set name
- The name of the entry-sequenced VSAM cluster that contains the data to be gathered. This name
must be in the format x.y.z.Tip: If you want to delete and redefine a VSAM ESDS data set from which the data is gathered by the Data Collector, after deleting the old data set, wait at least 60 seconds (1 minute) before redefining and writing data to the new data set, so that the Data Collector can collect all the records in the new data set.
- RLS Access
- A specification of whether the monitored VSAM ESDS data set is accessed through RLS or not. The
default value is
No, which represents that the data set is not accessed through RLS. If the monitored VSAM data set is accessed through RLS, selectYesso that Z Common Data Provider can monitor the data in the correct way.Tip: For non-RLS ESDS, if there is an application which has a long open connection to it (for example CICS®), theSHAREOPTIONSmust be (4,4) or (4,3) to make sure that Z Common Data Provider can continue collecting data after the data size reaches the CI. Otherwise, the remaining data can only be collected after the application performs aCLOSEcommand to the VSAM data set due to the read/write integrity identified by DFSMS. For RLS ESDS, there is no such requirement. For more information onSHAREOPTIONS, see https://www.ibm.com/docs/en/zos/2.5.0?topic=sharing-cross-region-share-options. - Topic Name
- The topic name for Generic VSAM Cluster data collection. The default value is IBM-CDP-DASHBOARDS-{dataSourceType}, of which, dataSourceType will be parsed to the VSAM data type zOS-DATA-SET.
- Output format
- The output format of Generic VSAM Cluster data collection. The value can be
key-valueorcsv. The default value iscsv.