Utility Programs
Support for the Java Environment
  Table of Contents  v-24.01.01 - jvutil01.htm 
  Introduction
  Program Overview
  Job Diagram
  Program Functionality
  The System Environment
  CMD Members
  Create an Array, x'00' to x'FF'
  XBYT00FF Input
  XBYT00FF Array Content
  Create an Array, EBCDIC to ASCII
  Create an Array, Hex-Dump
  Technical Details
  Environment Variables
  Ancillary Functions
  Summary
  Software Agreement and Disclaimer
  Downloads and Links
  Current Server or Internet Access
  Internet Access Required
  Glossary of Terms
  Contact or Feedback
  Company Overview
The SimoTime Home Page 

Table of Contents Previous Section Next Section 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-2024
SimoTime Technologies and Services
All Rights Reserved

Table of Contents Previous Section Next Section Program Overview

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

Table of Contents Previous Section Next Section Job Diagram

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

             
JV00FFW8
cmd
Start the Job, Convert the T112 File
from EBCDIC/ZOS-variable to ASCII/Text
   
SYS1LSEQ
LSEQ
   
   
jva256e8
java
   
   
SYS1RSEQ
RSEQ
Read ZOS file and create a comma-delimited file
   
   
   
XE2ACONV
RSEQ
Fixed-256
   
   
   
   
   
SYS1
LSEQMSGS
ASCII/Text
Input is Record Sequential, Output is ASCII/Text
   
   
PGMFLAGS
   
   
   
Define Program Behavior Flags
   
   
EOJ
This is End-of-Job.
 
Note-1: The following notations are used for file formats.
LSEQ = Line Sequential or ASCII/Text File
RSEQ = Record Sequential File
ZOS = IBM Mainframe System
Array Management Support for the SimoTime Java Environment

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.

Table of Contents Previous Section Next Section Program Functionality

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

1. The File Conversion Utility will read the EBCDIC-encoded file with bit-mapped records and write to an ASCII/Text file with field-delimited records.
1.1. The field delimiter character is be configurable.
1.2. The File Conversion Utility provides a character masking technique for the Primary Account Number (PAN or DE 2).
1.3. Replace DE 55, Integrated Circuit Card (ICC) System-Related Data with one space character.
Note: This Data Element contains binary information that cannot be stored in an ASCII/Text File.
1.4. Program File Names may be externally mapped to physical file names (i.e. File location and name).
1.5. The ASCII translation table may be user-defined.

 

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.

Table of Contents Previous Section Next Section The System Environment

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

1. Create a System that has the prerequisite software for running the Conversion Utility Program.
1.1. A Windows System is required.
1.1.1. Windows/7 and Windows/10 are used for the development and testing of the conversion jobs and programs.
1.1.2. For a single-use production environment Windows/7 or later is required.
1.1.3. For a multi-user Server environment Microsoft Server 2012 or later is required.
1.2. A Java Runtime Environment (JRE) is required.
1.2.1. The Java Developer's Kit (JDK) 8 is used for the development and testing of the conversion jobs and programs.
1.2.2. For the production environment JDK 8 or JRE 8 is required.

 

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

Table of Contents Previous Section Next Section CMD Members

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

Table of Contents Previous Section Next Section 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 …

Table of Contents Previous Section Next Section 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

Table of Contents Previous Section Next Section 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

Table of Contents Previous Section Next Section 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

Table of Contents Previous Section Next Section 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

Table of Contents Previous Section Next Section Technical Details

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

Table of Contents Previous Section Next Section 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.

1. PGMFLAGS=NNNNNNNN/NYNNNNNN
2. FLDDELIM=,
3. EDITCHAR=*
4. EDITMASK=0000000000001111

 

Table of Contents Previous Section Next Section 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.

Link to Internet   Link to Server   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.

Table of Contents Previous Section Next Section 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.

Table of Contents Previous Section Next Section 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.

Table of Contents Previous Section Next Section 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.

Table of Contents Previous Section Next Section 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 Link to Internet 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 Link to Server icon.

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

Link to Internet   Link to Server   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.

Link to Internet   Link to 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.

Table of Contents Previous Section Next Section 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.

Table of Contents Previous Section Next Section Glossary of Terms

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

Table of Contents Previous Section Next Section 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.

1. Send an e-mail to our helpdesk.
1.1. helpdesk@simotime.com.
2. Our telephone numbers are as follows.
2.1. 1 415 763-9430 office-helpdesk
2.2. 1 415 827-7045 mobile

 

We appreciate hearing from you.

Table of Contents Previous Section Next Section 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


Return-to-Top
Utility Programs for Java
Copyright © 1987-2024
SimoTime Technologies and Services
All Rights Reserved
When technology complements business
http://www.simotime.com