Utility Programs Support for the Java Environment

Introduction

A Data File Conversion can be accomplished using a single program. This approach works well if the file and record structure is simple and the conversion process is a one-time event at a single geographical location.

WIP …

WIP …

Additional information about this program may be obtained by sending an e-mail to: helpdesk@simotime.com

We have made a significant effort to ensure the documents and software technologies are correct and accurate. We reserve the right to make changes without notice at any time. The function delivered in this version is based upon the enhancement requests from a specific group of users. The intent is to provide changes as the need arises and in a timeframe that is dependent upon the availability of resources.

Copyright © 1987-2025
SimoTime Technologies and Services
All Rights Reserved

Program Overview

This section provides the information that is needed to understand, configure and run the T112 File Conversion job.

Job Diagram

The following shows the executable members and data structures used within the T112 File Conversion Job.

Color Associations: The  light-green  boxes are unique to SIMOTIME Technologies using an IBM Mainframe System or Micro Focus Enterprise Developer. The  light-red  boxes are unique to the SIMOTIME Technologies using a Linux, UNIX or Windows System and COBOL Technologies such as Micro Focus. The  light-yellow  boxes are SIMOTIME Technologies, Third-party Technologies, decision points or program transitions in the processing logic or program generations. The  light-blue  boxes identify the input/output data structures such as Documents, Spreadsheets, Data Files, VSAM Data Sets, Partitioned Data Set Members (PDSM's) or Relational Tables. The  light-gray  boxes identify a system function or an informational item.

Program Functionality

The following describes the functionality provided by the T112 File Conversion Utility.

The T112 Conversion Program reads the EBCDIC-encoded file with vaiable-length records and writes to an ASCII/Text File. The original input file remains unchanged.

The System Environment

The following describes a System Environment that is required to run the T112 File Conversion Utility Program.

The primary development and testing environment at SIMOTIME is a Windows/7 System running Java JDK 8.

CMD Members

The following Windows Command Files are provided with the Array Management Programs.

Create an Array, x'00' to x'FF'

The following is the Windows Command file (JV00FFW8.cmd) that is required to run as a job on a Windows System.

WIP …

@echo OFF
rem  * *******************************************************************
rem  *               JV00FFW8.cmd - a Windows Command File               *
rem  *         This program is provided by SimoTime Technologies         *
rem  *           (C) Copyright 1987-2019 All Rights Reserved             *
rem  *             Web Site URL:   http://www.simotime.com               *
rem  *                   e-mail:   helpdesk@simotime.com                 *
rem  * *******************************************************************
rem  *
rem  * Text   - Table Management Program for Batch Processing.
rem  * Author - SimoTime Technologies
rem  * Date   - December 15, 2016
rem  *
rem  * *******************************************************************
rem  * Step 1, Prepare the Environment...
rem  *
     set CmdName=JV00FFW8
     call ..\ENV1BASE %CmdName%
     if "%SYSLOG%" == "" set syslog=c:\SimoLIBR\LOGS\SimoTime.LOG
     set JobStatus=0000
rem  *
     call SimoNOTE "*******************************************************%CmdName%"
     call SimoNOTE "Starting JobName %CmdName%"
     call SimoNOTE "CATALINA_HOME ... %CATALINA_HOME%"
     call SimoNOTE "JRE_HOME ........ %JRE_HOME%"
     call SimoNOTE "CLASSPATH ....... %CLASSPATH%"
rem  *
     set PBFLAGS=NNNNNNNN/NNNNNNNN
rem  *
     set SYS1L512=%BASELIB1%\DATA\TXT1\SIMOTIME.ACODE.XBYT00FF.txt
     set SYS1CNTL=%BASELIB1%\DATA\WRK1\SIMOTIME.T112.SYS1CNTL.dat
     set SYS1MSGS=%BASELIB1%\LOGS\SIMOTIME.ARRAY.SYS1MSGS.txt
     set SYS1R256=%BASELIB1%\DATA\WRK2\SIMOTIME.ARRAY.XBYT00FF.dat
rem  *
     if exist %SYS1R256% erase %SYS1R256%
rem  * *******************************************************************
rem  * Step 2, Execute the Java Program...
     call SimoNOTE "Continue JobName%CmdName% Table Management Program for Batch"
     java simpacks/jvx256e8
     if not ERRORLEVEL = 0 set JobStatus=0010
     if not %JobStatus% == 0000 goto :EojNok
rem  *
rem  * *******************************************************************
rem  * Step 3, End-of-Job Processing...
:EojAok
     call SimoNOTE "Finished JobName %CmdName%, Job Status is %JobStatus%"
     goto :End
:EojNok
     call SimoNOTE "ABENDING JobName %CmdName%, Job Status is %JobStatus%"
:End
     if not "%1" == "nopause" pause

WIP …

XBYT00FF Input

The following shows the input that will be used to create the XBYT00FF Array. The input is an ASCII/Text file.

00010203 04050607 08090A0B 0C0D0E0F
10111213 14151617 18191A1B 1C1D1E1F
20212223 24252627 28292A2B 2C2D2E2F
30313233 34353637 38393A3B 3C3D3E3F
40414243 44454647 48494A4B 4C4D4E4F
50515253 54555657 58595A5B 5C5D5E5F
60616263 64656667 68696A6B 6C6D6E6F
70717273 74757677 78797A7B 7C7D7E7F
80818283 84858687 88898A8B 8C8D8E8F
90919293 94959697 98999A9B 9C9D9E9F
A0A1A2A3 A4A5A6A7 A8A9AAAB ACADAEAF
B0B1B2B3 B4B5B6B7 B8B9BABB BCBDBEBF
C0C1C2C3 C4C5C6C7 C8C9CACB CCCDCECF
D0D1D2D3 D4D5D6D7 D8D9DADB DCDDDEDF
E0E1E2E3 E4E5E6E7 E8E9EAEB ECEDEEEF
F0F1F2F3 F4F5F6F7 F8F9FAFB FCFDFEFF

XBYT00FF Array Content

The following shows the content of the XBYT00FF Arrary member that is created.

Hex..... ........ ........ ........ EBCDIC.......... ASCII........... Offset
00010203 04050607 08090A0B 0C0D0E0F ................ ................ 0
10111213 14151617 18191A1B 1C1D1E1F ................ ................ 16
20212223 24252627 28292A2B 2C2D2E2F €...............  !"#$%&'()*+,-./ 32
30313233 34353637 38393A3B 3C3D3E3F ................ 0123456789:;<=>? 48
40414243 44454647 48494A4B 4C4D4E4F  .âäàáãåçñ¢.<(+| @ABCDEFGHIJKLMNO 64
50515253 54555657 58595A5B 5C5D5E5F &éêëèíîïìß!$*);¬ PQRSTUVWXYZ[\]^_ 80
60616263 64656667 68696A6B 6C6D6E6F -/ÂÄÀÁÃÅÇѦ,%_>? `abcdefghijklmno 96
70717273 74757677 78797A7B 7C7D7E7F øÉÊËÈÍÎÏÌ`:#@'=" pqrstuvwxyz{.}~. 112
80818283 84858687 88898A8B 8C8D8E8F Øabcdefghi...ý.+ €........©...... 128
90919293 94959697 98999A9B 9C9D9E9F .jklmnopqr.}Æ.æ. ...............Ÿ 144
A0A1A2A3 A4A5A6A7 A8A9AAAB ACADAEAF ..stuvwxyz...Ý.® ..¢£.¥¦.....¬.®. 160
B0B1B2B3 B4B5B6B7 B8B9BABB BCBDBEBF .£¥.©.....[].... ................ 176
C0C1C2C3 C4C5C6C7 C8C9CACB CCCDCECF {ABCDEFGHI.ôöòóõ ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏ 192
D0D1D2D3 D4D5D6D7 D8D9DADB DCDDDEDF }JKLMNOPQR.ûüùúÿ .ÑÒÓÔÕÖ.ØÙÚÛÜÝ.ß 208
E0E1E2E3 E4E5E6E7 E8E9EAEB ECEDEEEF ..STUVWXYZ.ÔÖÒÓÕ àáâãäåæçèéêëìíîï 224
F0F1F2F3 F4F5F6F7 F8F9FAFB FCFDFEFF 0123456789.ÛÜÙÚŸ .ñòóôõö.øùúûüý.ÿ 240

Create an Array, EBCDIC to ASCII

The following is the Windows Command file (JV0437W8.cmd) that is required to run as a job on a Windows System.

WIP …

@echo OFF
rem  * *******************************************************************
rem  *               JV0437W8.cmd - a Windows Command File               *
rem  *         This program is provided by SimoTime Technologies         *
rem  *           (C) Copyright 1987-2019 All Rights Reserved             *
rem  *             Web Site URL:   http://www.simotime.com               *
rem  *                   e-mail:   helpdesk@simotime.com                 *
rem  * *******************************************************************
rem  *
rem  * Text   - Table Management Program for Batch Processing.
rem  * Author - SimoTime Technologies
rem  * Date   - December 15, 2016
rem  *
rem  * *******************************************************************
rem  * Step 1, Prepare the Environment...
rem  *
     set CmdName=JV0437W8
     call ..\ENV1BASE %CmdName%
     if "%SYSLOG%" == "" set syslog=c:\SimoLIBR\LOGS\SimoTime.LOG
     set JobStatus=0000
rem  *
     call SimoNOTE "*******************************************************%CmdName%"
     call SimoNOTE "Starting JobName %CmdName%"
     call SimoNOTE "CATALINA_HOME ... %CATALINA_HOME%"
     call SimoNOTE "JRE_HOME ........ %JRE_HOME%"
     call SimoNOTE "CLASSPATH ....... %CLASSPATH%"
rem  *
     set PBFLAGS=NNNNNNNN/NNNNNNNN
rem  *
     set SYS1L512=%BASELIB1%\DATA\TXT1\SIMOTIME.ACODE.XE2A0437.txt
     set SYS1CNTL=%BASELIB1%\DATA\WRK1\SIMOTIME.T112.SYS1CNTL.dat
     set SYS1MSGS=%BASELIB1%\LOGS\SIMOTIME.ARRAY.SYS1MSGS.txt
     set SYS1R256=%BASELIB1%\DATA\WRK2\SIMOTIME.ARRAY.XE2A0437.dat
rem  *
     if exist %SYS1R256% erase %SYS1R256%
rem  * *******************************************************************
rem  * Step 2, Execute the Java Program...
     call SimoNOTE "Continue JobName%CmdName% Table Management Program for Batch"
     java simpacks/jvx256e8
     if not ERRORLEVEL = 0 set JobStatus=0010
     if not %JobStatus% == 0000 goto :EojNok
rem  *
rem  * *******************************************************************
rem  * Step 3, End-of-Job Processing...
:EojAok
     call SimoNOTE "Finished JobName %CmdName%, Job Status is %JobStatus%"
     goto :End
:EojNok
     call SimoNOTE "ABENDING JobName %CmdName%, Job Status is %JobStatus%"
:End
     if not "%1" == "nopause" pause

Create an Array, Hex-Dump

The following is the Windows Command file (JV00FFW8.cmd) that is required to run as a job on a Windows System.

WIP …

@echo OFF
rem  * *******************************************************************
rem  *               JV0437W8.cmd - a Windows Command File               *
rem  *         This program is provided by SimoTime Technologies         *
rem  *           (C) Copyright 1987-2019 All Rights Reserved             *
rem  *             Web Site URL:   http://www.simotime.com               *
rem  *                   e-mail:   helpdesk@simotime.com                 *
rem  * *******************************************************************
rem  *
rem  * Text   - Table Management Program for Batch Processing.
rem  * Author - SimoTime Technologies
rem  * Date   - December 15, 2016
rem  *
rem  * *******************************************************************
rem  * Step 1, Prepare the Environment...
rem  *
     set CmdName=JV0437W8
     call ..\ENV1BASE %CmdName%
     if "%SYSLOG%" == "" set syslog=c:\SimoLIBR\LOGS\SimoTime.LOG
     set JobStatus=0000
rem  *
     call SimoNOTE "*******************************************************%CmdName%"
     call SimoNOTE "Starting JobName %CmdName%"
     call SimoNOTE "CATALINA_HOME ... %CATALINA_HOME%"
     call SimoNOTE "JRE_HOME ........ %JRE_HOME%"
     call SimoNOTE "CLASSPATH ....... %CLASSPATH%"
rem  *
     set PBFLAGS=NNNNNNNN/NNNNNNNN
rem  *
     set SYS1L512=%BASELIB1%\DATA\TXT1\SIMOTIME.ACODE.XE2A0437.txt
     set SYS1CNTL=%BASELIB1%\DATA\WRK1\SIMOTIME.T112.SYS1CNTL.dat
     set SYS1MSGS=%BASELIB1%\LOGS\SIMOTIME.ARRAY.SYS1MSGS.txt
     set SYS1R256=%BASELIB1%\DATA\WRK2\SIMOTIME.ARRAY.XE2A0437.dat
rem  *
     if exist %SYS1R256% erase %SYS1R256%
rem  * *******************************************************************
rem  * Step 2, Execute the Java Program...
     call SimoNOTE "Continue JobName%CmdName% Table Management Program for Batch"
     java simpacks/jvx256e8
     if not ERRORLEVEL = 0 set JobStatus=0010
     if not %JobStatus% == 0000 goto :EojNok
rem  *
rem  * *******************************************************************
rem  * Step 3, End-of-Job Processing...
:EojAok
     call SimoNOTE "Finished JobName %CmdName%, Job Status is %JobStatus%"
     goto :End
:EojNok
     call SimoNOTE "ABENDING JobName %CmdName%, Job Status is %JobStatus%"
:End
     if not "%1" == "nopause" pause

Technical Details

This section provides technical information about the components required or referenced in this suite of programs.

Environment Variables

This suite of programs references other system and user members in order to function in a larger environment that includes other languages and sub-systems. The following link provides additional details.

Ancillary Functions

This suite of programs references other system and user members in order to function in a larger environment that includes other languages and sub-systems. The following link provides additional details.

    Explore How to use Common or Shared Routines that perform repetitive tasks in a consistent manner. This link will provide information about setting common environment variables and many other utilitarian tasks.

Summary

The SIMOTIME T112 Conversion Utility Program will convert the EBCDIC-encoded, T112 file to an ASCII/Text file with the bit-sensitive information expanded to text strings. The T112 file is a clearing file for financial transactions. The record structure uses an Integrated Product Messages (IPM) format with variable-length records. It is based on the ISO 8583–1993 specification. This document may be used to assist as a tutorial for new users or as a quick reference for experienced users.

In the world of programming there are many ways to solve a problem. This documentation and software were developed and tested on systems that are configured for a SIMOTIME environment based on the hardware, operating systems, user requirements and security requirements. Therefore, adjustments may be needed to execute the jobs and programs when transferred to a system of a different architecture or configuration.

SIMOTIME Services has experience in moving or sharing data or application processing across a variety of systems. For additional information about SIMOTIME Services or Technologies please contact us using the information in the  Contact or Feedback  section of this document.

Software Agreement and Disclaimer

Permission to use, copy, modify and distribute this software, documentation or training material for any purpose requires a fee to be paid to SimoTime Technologies. Once the fee is received by SimoTime the latest version of the software, documentation or training material will be delivered and a license will be granted for use within an enterprise, provided the SimoTime copyright notice appear on all copies of the software. The SimoTime name or Logo may not be used in any advertising or publicity pertaining to the use of the software without the written permission of SimoTime Technologies.

SimoTime Technologies makes no warranty or representations about the suitability of the software, documentation or learning material for any purpose. It is provided "AS IS" without any expressed or implied warranty, including the implied warranties of merchantability, fitness for a particular purpose and non-infringement. SimoTime Technologies shall not be liable for any direct, indirect, special or consequential damages resulting from the loss of use, data or projects, whether in an action of contract or tort, arising out of or in connection with the use or performance of this software, documentation or training material.

Downloads and Links

This section includes links to documents with additional information that are beyond the scope and purpose of this document. The first group of documents may be available from a local system or via an internet connection, the second group of documents will require an internet connection.

Note: A SimoTime License is required for the items to be made available on a local system or server.

Current Server or Internet Access

The following links may be to the current server or to the Internet.

Note: The latest versions of the SimoTime Documents and Program Suites are available on the Internet and may be accessed using the icon. If a user has a SimoTime Enterprise License the Documents and Program Suites may be available on a local server and accessed using the icon.

    Explore the Java Connection for examples of the various coding or programming techniques using the Java Software Development Kit from Oracle/Sun.

    Explore An Enterprise System Model that describes and demonstrates how Applications that were running on a Mainframe System and non-relational data that was located on the Mainframe System were copied and deployed in a Microsoft Windows environment with Micro Focus Enterprise Server.

    Explore The ASCII and EBCDIC Translation Tables. These tables are provided for individuals that need to better understand the bit structures and differences of the encoding formats.

Internet Access Required

The following links will require an internet connection.

A good place to start is The SimoTime Home Page for access to white papers, program examples and product information. This link requires an Internet Connection

Explore The Java Development and Run Time products and services available from Oracle. This link requires an Internet Connection.

Explore The Micro Focus Web Site for more information about products (including Micro Focus COBOL) and services available from Micro Focus. This link requires an Internet Connection.

Glossary of Terms

    Explore the Glossary of Terms for a list of terms and definitions used in this suite of documents and white papers.

Contact or Feedback

This document was created and is maintained by SimoTime Technologies. If you have any questions, suggestions, comments or feedback please use the following contact information.

We appreciate hearing from you.

Company Overview

SimoTime Technologies was founded in 1987 and is a privately owned company. We specialize in the creation and deployment of business applications using new or existing technologies and services. We have a team of individuals that understand the broad range of technologies being used in today's environments. Our customers include small businesses using Internet technologies to corporations using very large mainframe systems.

Quite often, to reach larger markets or provide a higher level of service to existing customers it requires the newer Internet technologies to work in a complementary manner with existing corporate mainframe systems. We specialize in preparing applications and the associated data that are currently residing on a single platform to be distributed across a variety of platforms.

Preparing the application programs will require the transfer of source members that will be compiled and deployed on the target platform. The data will need to be transferred between the systems and may need to be converted and validated at various stages within the process. SimoTime has the technology, services and experience to assist in the application and data management tasks involved with doing business in a multi-system environment.

Whether you want to use the Internet to expand into new market segments or as a delivery vehicle for existing business functions simply give us a call or check the web site at http://www.simotime.com