Copybook Snap Pack

 

Overview

You can use this Snap Pack to consume one or more COBOL Copybooks and a data stream to produce a JSON formatted message containing the structured payload.

Prerequisites

None.

Supported Versions

  • Cobol Mainframe - All versions.

  • Cobol Open Systems - All versions.

Supported Copybook Structures and Payloads

  • Copybooks contain multiple 01 records, and payloads contain multiple record types.

  • Payloads with the following characteristics:

    • Fixed length

    • CRLF delimited

    • LF delimited

    • Continuous stream (no delimiter)

    • Mainframe variable record length file (4-byte length field with a 2-byte length, which is the length of the payload plus the 4-byte RDW followed by 2 bytes of hex ‘00’s).
      A variation on the mainframe variable record length file where:

      • A 4-byte length consisting of a 2-byte length field that is byte-swapped for intel systems. This does not include the length of the 4-byte word. To be specific, it contains the length of the payload following the 4-byte length field.

      • The last two bytes of the length field are hex ‘00’s.

  • Big-Endian or Little-Endian payload.

  • All standard COBOL types including packed and zoned decimal.

  • COBOL array constructs such as ‘occurs’ and ‘occurs depending on'.

  • COBOL Redefines.

  • Payload encoded in EBCDIC (Extended Binary Coded Decimal Interchange Code) or any encoding supported by Java.

Snap Pack History

Release

Snap Pack Version

Date

Type

Updates

February 2024

main171

14 Mar 2024

Latest

  • Fixed a null pointer error in all the Copybook Snaps.

  • Fixed an issue with the structure options in the COBOL Copybook Parser Snap.

February 2024

main168

14 Feb 2024

Stable

Updated and certified against the current SnapLogic Platform release.

November 2023

main167

05 Feb 2024

Latest

Fixed an issue with the COBOL Copybook Formatter Snap to ensure that output data is written as a single binary output.

November 2023

main165

10 Jan 2024

Latest

The Compatibility field is now set to false by default in the Copybook Parser Snap and it does not display in the UI for new instances of the Snap.

November 2023

main163

03 Jan 2024

Latest

Fixed backward compatibility for Snap instances with missing debug configuration.

November 2023

main155

08 Nov 2023

Stable

Updated and certified against the current SnapLogic Platform release.

September 2023

main141

20 Sep 2023

Latest

The Copybook Parser Snap now supports configuring fields from subsequent copybooks using fully qualified names.

August 2023

main138

16 Aug 2023

Stable

Updated and certified against the current SnapLogic Platform release.

June 2023

main134

23 Jun 2023

Latest

Fixed an issue with the Cobol Copybook Parser Snap for structures with more than two fields. The Snap now correctly establishes if the fields exist in the structure.

May 2023

main132

06 Jun 2023

Latest

The COBOL Copybook Parser Snap is enhanced to improve performance, data validation, and error handling.

May 2023

main131

19 May 2023

Latest

Fixed the compatibility mode of the COBOL Copybook Parser Snap that caused a working pipeline to fail. With this update, the performance of the Copybook Parser Snap is optimized.

May 2023

main130

10 May 2023

Stable

Upgraded with the latest SnapLogic Platform release.

February 2023

develop124

17 Apr 2023

Latest

Improved the performance of the Cobol Copybook Parser Snap when parsing large Cobol copybook files.

August 2022

main111

11 Aug 2022

Stable

Upgraded with the latest SnapLogic Platform release.

4.29

main108

14 May 2022  

Stable

Upgraded with the latest SnapLogic Platform release.

4.28

main100

12 Feb 2022

Stable

Upgraded with the latest SnapLogic Platform release.

4.27

main97

06 Jan 2022

Latest

Fixed an issue with the Cobol Copybook Parser Snap where the Snap now correctly closes the input stream.

4.27

main93

13 Nov 2021

Stable

Upgraded with the latest SnapLogic Platform release.

4.26

main88

14 Aug 2021

Stable

Introduced the Copybook Snap Pack, which enables you to consume one or more COBOL Copybooks and a data stream to produce a JSON formatted message containing the structured payload. This Snap Pack contains the following Snap: