+

Search Tips   |   Advanced Search

RecordOrientedDataSetWriterPattern

The RecordOrientedDataSetWriterPattern pattern is used to write data to a z/OS data set.


Support classes


Required properties

The following properties are required for the pattern.

properties. The table includes the name, value, and description
Property name Value Description
PATTERN_IMPL_CLASS Java class name Class implementing RecordOrientedDatasetWriterPattern interface
DSNAME Data set name For example, USER216.BATCH.RECORD.OUTPUT


Optional properties

The following properties are optional for the pattern.

properties. The table includes the name, value, and description
Property name Value Description
ds_parameters Parameters used to open the data set. Default for ZFileRecordOrientedDataWriter is wb,recfm=fb,type=record,lrecl=80 and

Default for ZFileStreamOrientedByteWriter and ZFileStreamOrientedTextWriter are wt

debug true or false (default is false) Enables detailed tracing on this batch datastream.
EnablePerformanceMeasurement true or false (default is false) Calculates the total time spent in the batch data-streams and the processRecord method, if you are using the GenericXDBatchStep.
EnableDetailedPerformanceMeasurement true or false (default is false) Provides a more detailed breakdown of time spent in each method of the batch data-streams.
file.encoding Encoding of the file. For example, CP1047


Interface definition

/**
 *   * This pattern is used to write data to z/OS dataset using  * jzos apis
 */
public interface RecordOrientedDatasetWriterPattern {
  /**
  * This method is called during the job setup phase allowing   * the user to do initialization.
  * The properties are the ones passed in the xJCL   * @param props
  */
 public void initialize(Properties props);
   /**
  * This method should be used to write the given   * object into the dataset
  * @param out   * @param record   * @throws IOException
  */
 public void writeRecord(ZFile out, Object record) throws IOException;
   /**
  * This method should be used to write header information   * if any   * @param out   * @throws IOException
  */
 public void writeHeader(ZFile out) throws IOException;
   /**
  * This method can be optionally called during process step to explicity    * initialize and write the header.    * @param header   */
 public void writeHeader(ZFile out, Object header);
  }


xJCL example

<batch-data-streams>
<bds>
<logical-name>outputStream</logical-name>
<props>
<prop name="PATTERN_IMPL_CLASS" value="com.ibm.websphere.batch.samples.tests.bds.EchoWriter"/>
<prop name="DSNAME" value="USER216.BATCH.RECORD.OUTPUT"/>
<prop name="ds_parameters" value="wt"/>
<prop name="file.encoding" value="CP1047"/>
<prop name="debug" value="${debug}"/>
</props>
<impl-class>com.ibm.websphere.batch.devframework.datastreams.patterns.ZFileStreamOrientedByteWriter</impl-class>
</bds>
</batch-data-streams>


Related concepts

  • Batch data stream framework and patterns


    Related tasks

  • Use the batch data stream framework

  • JDBCReaderPattern
  • JDBCWriterPattern
  • ByteReaderPattern
  • ByteWriterPattern
  • FileReaderPattern
  • FileWriterPattern

    (zos) RecordOrientedDatasetReaderPattern

  • JPAReaderPattern