RecordOrientedDataSetWriterPattern
El patrón RecordOrientedDataSetWriterPattern se utiliza para grabar datos en un conjunto de datos de z/OS.
Clases de soporte
- ZFileStreamOrientedTextWriter: graba datos de texto
- ZFileStreamOrientedByteWriter: graba datos de bytes
- ZFileRecordOrientedDataWriter: graba datos secuenciales
Propiedades obligatorias
Las propiedades siguientes son necesarias para el patrón.
Nombre de propiedad | Value | Descripción |
---|---|---|
PATTERN_IMPL_CLASS | Nombre de la clase Java™ | Clase que implementa la interfaz RecordOrientedDatasetWriterPattern |
DSNAME | Nombre del conjunto de datos | Por ejemplo, USER216.BATCH.RECORD.OUTPUT |
Propiedades opcionales
Para el patrón las propiedades siguientes son opcionales.
Nombre de propiedad | Value | Descripción |
---|---|---|
ds_parameters | Parámetros utilizados para abrir el conjunto de datos. | El valor predeterminado de ZFileRecordOrientedDataWriter
es wb,recfm=fb,type=record,lrecl=80 y los valores predeterminados para ZFileStreamOrientedByteWriter y ZFileStreamOrientedTextWriter son wt |
debug | true o false (el valor predeterminado es false) | Habilita el rastreo detallado en esta secuencia de datos por lotes. |
EnablePerformanceMeasurement | true o false (el valor predeterminado es false) | Calcula el tiempo total invertido en las secuencias de datos por lotes y el método processRecord, si se utiliza GenericXDBatchStep. |
EnableDetailedPerformanceMeasurement | true o false (el valor predeterminado es false) | Proporciona un desglose más detallado del tiempo invertido en cada método de las secuencias de datos por lotes. |
file.encoding | Codificación del archivo. | Por ejemplo, CP1047 |
Definición de interfaz
/**
*
* Este patrón se utiliza para grabar datos en un conjunto de datos de z/OS
* mediante APIS de jzos
*/
public interface RecordOrientedDatasetWriterPattern {
/**
* Este método se invoca durante la fase de configuración de trabajo
* permitiendo que el usuario realice la inicialización.
* Las propiedades son las pasadas en el xJCL
* @parámetro props
*/
public void initialize(Properties props);
/**
* Este método debe utilizarse para grabar el objeto
* dado en el conjunto de datos
* @parámetro out
* @parámetro record
* @emite una excepción IOException
*/
public void writeRecord(ZFile out, Object record) throws IOException;
/**
* Este método debe utilizarse para grabar información
* de cabecera, si hay alguna
* @parámetro out
* @emite una excepción IOException
*/
public void writeHeader(ZFile out) throws IOException;
/**
* Este método se puede invocar opcionalmente durante el paso de proceso para
* inicializar y grabar de forma explícita la cabecera.
* @parámetro header
*/
public void writeHeader(ZFile out, Object header);
}
Ejemplo xJCL
<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>