Summary

The Summer Batch team

Summer.Batch.Team@bluage.com

Name	Target Framework	Version
SummerBatch	.NET 4.6.1	V1.2.6
SummerBatchCore	.NET Core 3.1	V3.0.4

Copyright © 2015-2021 Bluage Corporation, All Rights Reserved.

Copies of this document may be made for your own use and for distribution to others, provided that you do not charge any fee for such copies and further provided that each copy contains this Copyright Notice, whether distributed in print or electronically.

• 1.Introduction:

  • Summer Batch Introduction

  • Typical use cases

  • Architecture overview

  • Programming guidelines

• 2.Supported Features:

  • The JSR 352 as starting point

  • Main features

  • Additional Features

• 3.Summer batch vocabulary and mechanisms:

  • Summer batch vocabulary

  • Job

  • Step

  • Batchlet

  • Chunk handling

    • Item Reader

    • Item Processor

    • Item Writer

  • Repository

  • Operator and Batch Runtime

  • The batch mechanisms

    • Typical chunk oriented step behavior

    • The tasklet approach

• 4.Configuration:

  • Job Specification Language(JSL)

    • XSL Configuration

    • Job Configuration

    • Step Element

    • Flow Element

    • Split Element

    • Batch Control Flow

  • Unity Configuration:

    • Batch Configuration

    • Batch Artifacts

    • Additions to Unity

• 5.Running a Job:

  • Several ways to run a job

  • Using a JobStarter

    • JobStarter Methods

    • Fine grained control over job executions

• 6.Using Basic Features:

  • Reading and writing flat file

    • Using a flat file reader

    • Using a flat file writer

  • Reading from and writing to RDBMS

    • Reading from a database

    • Writing to a database

    • Database Support

• 7.Using Advanced Features:

  • Reading and writing EBCDIC files using COBOL copybooks

    • Using the EbcdicFileReader

    • Using the EbcdicFileWriter

  • FTP operations support

    • FTP put operations

    • FTP get operations

  • Email sending support

  • Empty file check support

  • Sql Script Runner support

  • Sort Tasklet

    • Supported DFSORT Features

  • Generation Data Groups(GDG)

  • Context Managers

    • ContextManager class

    • ContextManagerUnityLoader

    • AbstractExecutionListener and AbstractService

  • Process Adapters

  • Template facility

    • Controlling Template ID

  • Serialization

• A.Appendix:

  • Job File Format Xml schema

  • Ebcdic File Format Xml schema

  • Database Repository scripts per vendor

    • Sql Server scripts

    • Oracle scripts

    • IBM DB2 scripts

    • NOT OFFICIALLY SUPPORTED : PostgreSQL scripts

• Version History

  • SummerBatch:

    • V1.2.6 - July 19th 2021

    • V1.2.5 - July 2th 2021

    • V1.2.4 - July 23th 2020

    • V1.2 - April 4th 2020

    • V1.1.12 - December 2019

    • V1.1.2 - July 2016

    • V1.1.1 - June 2016

    • V1.1.0 - March 2016

    • V1.0.0 - November 2015

  • SummerBatchCore:

    • V3.0.4 - July 19th 2021

    • V3.0.3 - July 2th 2021

    • V3.0.2 - May 25th 2021

    • V3.0.0 - Sep 24 2020

• Index

• List of Figures:

  • 1.1. Summer Batch dependencies

  • 3.1. Chunk oriented step: basic transactional behavior

  • 3.2. Chunk oriented step: when transaction roll-back occurs

  • 7.1. EBCDIC File Format XML schema

  • 8.1. Setting properties for the appsettings.json configuration file

• List of Examples:

  • 3.1. XML Job Configuration

  • 3.2. XML Job Configuration

  • 4.1. XSL declaration configuration

  • 4.2. A Non Restartable Job

  • 4.3. Job Configuration

  • 4.4. XML Chunk Specification

  • 4.5. XML Batchlet Specification

  • 4.6. XML step configuration with listener

  • 4.7. XML Partition Specification

  • 4.8. XML Flow Specification

  • 4.9. XML Split Specification

  • 4.10. XML Two step Specification

  • 4.11. XML conditional step Specification

  • 4.12. XML conditional step Specification

  • 4.13. Setting Database Persistence of Job Explorer and Job Repository

  • 4.14. Creating a New Registration

  • 4.15. Registration of a List of Character Strings

  • 5.1. Sample entry point method using JobStarter

  • 6.1. FlatFileItemReader declaration in the job XML file

  • 6.2. Sample delimited flat file data

  • 6.3. Sample flat file target business object

  • 6.4. Sample flat file target business object field set mapper

  • 6.5. Delimited flat file reader - sample unity configuration

  • 6.6. FlatFileItemWriter declaration in the job XML file

  • 6.7. Sample flat file writer input business object

  • 6.8. Formatted flat file writer - sample unity configuration

  • 6.9. Query parameters supported syntax examples

  • 6.10. DataReaderItemReader target business object

  • 6.11. DataReaderItemReader target business object RowMapper

  • 6.12. DataReaderItemReader declaration in the job XML file

  • 6.13. Formatted flat file writer - sample unity configuration

  • 6.14. DatabaseBatchItemWriter target business object

  • 6.15. DatabaseBatchItemWriter declaration in the job XML file

  • 6.16. Database batch writer - sample unity configuration

  • 6.17. Adding support for other RDBMS : the PostgreSQL example

  • 7.1. Sample XML copybook export

  • 7.2. Sample business object to which EBCDIC records will be mapped

  • 7.3. Sample EBCDIC reader mapper

  • 7.4. EbcdicFileReader declaration in the job XML file

  • 7.5. EbcdicFileReader Unity configuration

  • 7.6. EbcdicFileWriter declaration in the job XML file

  • 7.7. EbcdicFileWriter Unity configuration

  • 7.8. FtpPutTasklet usage in the job XML file

  • 7.9. FtpPutTasklet Unity configuration

  • 7.10. FtpGetTasklet usage in the job XML file

  • 7.11. FtpGetTasklet Unity configuration

  • 7.12. EmailTasklet usage in the job XML file

  • 7.13. EmailTasklet Unity configuration

  • 7.14. Typical EmptyFileCheckTaskle usage in the job XML file

  • 7.15. Sample Unity configuration for a EmptyFileCheckTasklet

  • 7.16. Typical SqlScriptRunnerTasklet usage in the job XML file

  • 7.17. Sample Unity configuration for a SqlScriptRunnerTasklet

  • 7.18. Registration of the GDG Resource Loader

  • 7.19. GDG Configuration

  • 7.20. IContextManager interface contract

  • 7.21. Unity wiring example for ContextManager

  • 7.22. Example ProcessAdapter Wiring

  • 7.23. Example format file

  • 7.24. More advanced example format file

  • 7.25. Typical AbstractTemplateLineAggregator usage

  • 7.26. Typical TemplateLineAggregator class

  • 7.27. TemplateLineAggregator unity setup with a ProcessAdapter

  • 7.28. TemplateLineAggregator usage in a process

  • 7.29. GetParameters method for heterogeneous inputs

  • 7.30. Examples with and without wildcard in the appsettings.json