Module com.blackhillsoftware.easysmf.je
Package com.blackhillsoftware.smf.readerbuilder

Class ZosmfReaderBuilder<T extends ZosmfReaderBuilder<T>>

java.lang.Object
com.blackhillsoftware.smf.SmfRecordReaderBuilder
com.blackhillsoftware.smf.readerbuilder.ZosmfReaderBuilder<T>
public class ZosmfReaderBuilder<T extends ZosmfReaderBuilder<T>> extends SmfRecordReaderBuilder
Build a SmfRecordReader to read SMF data from z/OSMF using the dataset and files REST API.

Obtain a ZosmfReaderBuilder from SmfRecordReader.zosmfBuilder(String), supplying a z/OSMF URL. The URL may take one of the following forms:

  • https://host:port
  • https://host:port/zosmf
  • https://host:port/zosmf/restfiles/ds
  • https://host:port/DATASET.NAME
  • https://host:port/zosmf/DATASET.NAME
  • https://host:port/zosmf/restfiles/ds/DATASET.NAME
The ZosmfReaderBuilder normalizes the URL to the form https://host:port/zosmf/restfiles/ds/DATASET.NAME.

If the dataset name is not present in the URL it must be supplied using dataset(String).

Examples: 


 // Full URL including dataset name
 SmfRecordReader reader =
     SmfRecordReader.zosmfBuilder("https://zosmf.example.com:10443/zosmf/restfiles/ds/SMF.DATA")
                    .build();

 // Base URL only, dataset specified separately
 SmfRecordReader reader =
     SmfRecordReader.zosmfBuilder("https://zosmf.example.com:10443")
                    .dataset("SMF.DATA")
                    .build();

 // Base /zosmf URL, dataset specified separately
 SmfRecordReader reader =
     SmfRecordReader.zosmfBuilder("https://zosmf.example.com:10443/zosmf")
                    .dataset("SMF.DATA(ACCOUNT)")
                    .build();

 // URL with dataset name only, REST path added automatically
 SmfRecordReader reader =
     SmfRecordReader.zosmfBuilder("https://zosmf.example.com:10443/SMF.DATA")
                    .build();

TLS Certificate Validation

TLS certificates are validated by default. To disable certificate validation e.g. if the name doesn't match or the CA certificate is unavailable, specify the insecure() option.

Example: 


 SmfRecordReader reader =
     SmfRecordReader.zosmfBuilder("https://zosmf.example.com:10443/zosmf/restfiles/ds/SMF.DATA")
                    .insecure()
                    .build();