Libraries for DEVL, TEST & PROD
|The SimoTime Home Page|
SIMOTIME Technology is a suite of programs, job scripts, control files, templates and other files that are used to understand, modify, verify and support program members and non-relational data structures that reside on multiple systems of varying architectures.
The SIMOTIME Technology is provided in a single Library (Windows Folder) called SIMOLIBR. The technology is delivered electronically via a download from the SIMOTIME Web Site.
Note: The terms Library, Folder or Directory may be used interchangeably to reference data structures across multiple systems.
As part of a SIMOTIME Services agreement a second, user-oriented Library (Windows Folder) called SIMOUSER is created. This Library (or directory) will contain a control file (ENV1BASE.cmd), a group of sub-directories, a suite of Job Scripts and a few test cases or examples. The SIMOUSER Library allows the "Application Support" functions to be separated from the production environment that addresses the business functions.
The following is a partial list of some of the "Application Support" functions that may be performed by SIMOTIME Technologies.
|1.||Data File Convert|
|1.1.||File Format Conversion|
|1.2.||Record Content Conversion|
|1.3.||Export or extract by Field Name|
|1.4.||Convert using Sequential Batch File Processing|
|1.5.||Convert using Random Update or Add Processing|
|2.||Data File Compare|
|2.1.||Physical Record by Record Compare|
|2.2.||Logical Record by Record Compare|
|2.3.||Partial Record Compare|
|2.4.||Omit or Bypass Records|
|3.2.||Accumulate Summary Totals with record counts|
|3.3.||Generate Documentation of Record Layouts in HTML Format|
The methodologies used to perform the "Application Support" tasks will be discussed in more detail in the following sections of this document.
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-2020
SimoTime Technologies and Services
All Rights Reserved
The SimoTime Technologies were originally intended for use by application developers and application support personnel that were using a Windows System to support applications that were running on an IBM Mainframe System.
We needed to be able to execute the programs that do the data management tasks of conversion, comparison and validation to run on a variety of systems. To address this requirement the SimoTime Technology uses a technique of generating COBOL programs that will do the actual data management tasks. The generated programs may then be compiled and executed on a variety of systems that have an ANSI/2002 (or later) compliant COBOL compiler.
Read more about the Data File COMPARE process. This link includes an example that does a physical compare of two data files.
Read more about the Data File CONVERT process. This link includes an example that does a file format and record content conversion.
Read more about the Data Validation Process and Record Layout Documentation. This link includes examples for accumulating summary totals, creating hex-dump information and creating documentation of a record structure based on the field definitions of a COBOL Copy file.
The following outline assumes the SIMOTIME Base configuration is being used and the promotion of members between libraries is done manually.
|1.||Create a Process Control File (PCF)|
|1.1.||The default-directory where the PCF File is located will be dependent on the function|
|1.1.1.||Converts is C:\SIMOUSER\DEVL\SIMOGENS\CONVERTS|
|1.1.2.||Compares is C:\SIMOUSER\DEVL\SIMOGENS\COMPARES|
|1.1.3.||Validate is C:\SIMOUSER\DEVL\SIMOGENS\COGITATE|
|1.2.||This file is an ASCII/Text File and may be created or modified using a Text Editor of choice.|
|1.2.1.||Create a New File|
|1.2.2.||Copy a SimoTime PCF Example and modify the copied PCF based on user requirements|
|1.3.||The PCF File will be used to Generate COBOL Source Code|
|2.||Generate COBOL Source Code|
|2.1.||The target library for the COBOL Source members is the default-directory\GENR sub-directory|
|3.||Promote or Copy the Source Code to a User Library|
|3.1.||Copy the COBOL Source members from the default-directory\GENR sub-directory to C:\SIMOUSER\DEVL\COBOLUT1|
|4.||Compile the Program or Programs|
|4.1.1.||Compile as a program within a Batch Job from a Windows Command Line|
|4.1.2.||Compile as a Program within a Visual Studio Project|
|4.1.3.||Compile as a Program within an Eclipse Project|
|4.2.||For other operating systems contact SimoTime Services.|
|5.||Promote or Copy to the executable Members to a User Library|
|5.1.||Copy the executable members from C:\SIMOUSER\DEVL\HOLD\UT1A to C:\SIMOUSER\DEVL\LOADLIB|
|6.||Create a Job Script|
|6.1.1.||A Job Script may be a Windows Command File|
|6.1.2.||A Job Script may be a JCL Member if Micro Focus Server is configured with the Mainframe Sub-System Option.|
|6.2.||For other operating systems contact SimoTime Services.|
|7.||Run the Job Script to Execute the Program|
|8.||Review the Results|
|9.||End of Process|
The following outline describes the process for creating HTML Documentation of a record layout by reading and analyzing the field definitions within a COBOL Copy File. A repository of information is created based on the field definitions.
|1.||Create a Process Control File (PCF)|
|1.1.||This file is an ASCII/Text File and may be created or modified using a Text Editor of choice.|
|1.1.1.||Create a New File|
|1.1.2.||Copy a SimoTime PCF Example and modify the copied PCF based on user requirements|
|1.2.||The File will be used to Generate an HTML document for record structures based on the fields definitions from a COBOL Copy File.|
|2.||Generate an HTML Document|
|3.||Promote or Copy the HTML Document to a User Library|
|4.||View the HTML Document using a browser of choice|
|5.||End of Process|
The following diagram shows the model sub-directory structure for the Application Libraries and the DEVELOPMENT environment. The Application Libraries are typically a sub-directory structure under a directory structure for a Development, Production or Test environments. Update or change capability to the Application Library structure and content may be limited to system and support individuals. Read or view access typically has a larger audience.
Color Associations: The
This section provides additional detail about the Application Libraries and some of the system and support functions available. This description will use some of the SimoTime Application examples as test cases and will be included in the SIMOUSER Library structure under the DEVL sub-directory.
The SIMOUSER\DEVL directory structure is intended to provide a development environment for programmers and other individuals that support the application creation, maintenance, testing and ongoing support processes. This directory contains a number of sub-directories and a Windows Command file called ENV1BASE.cmd.
The ENV1BASE command (or job script) will set the commonly used environment variables. This job is used to provide a single point for managing the commonly used environment variables. it is a building block for integrating the functions of a Windows System, a Micro Focus sub-system and the SimoTime environment. This Job Script is called (or executed) from other job scripts within the SIMOUSER environment.
This directory contains commands and data that provide technical administrative function. Administrative functions include the following.
|A List of Administrative Functions|
This link provides additional information about the sub-directory structure for Technical Administrative Tasks that includes the processes for the scripted builds and the management of the Repository of Application Properties.
This directory contains the source code for the Assembler (Mainframe HLASM) source members. The source members typically have an extension of filename.MLC.
This directory contains the source code for the BMS source members. The source members typically have an extension of filename.BMS.
This directory contains the COBOL Copy File (or copybooks) used by the application programs. The source members typically have an extension of filename.CPY.
This directory is reserved for use by the BMS Generation process. It contains the copy files that are generated by the BMS Generation process. The source members typically have an extension of filename.CPY.
This directory contains COBOL Source Code for application programs that deliver business function. The source members typically have an extension of filename.CBL.
This directory contains COBOL Source Code for programs that perform utilitarian function in support of the application but are not part of the application that delivers business function. The programs in this directory should be compiled using a mainframe dialect. The source members typically have an extension of filename.CBL.
This directory contains COBOL Source Code for programs that perform utilitarian function in support of the application but are not part of the application that delivers business function. The programs in this directory should be compiled using a Micro Focus dialect. This suite of programs uses functions and syntax that is unique to the Micro Focus compiler. The source members typically have an extension of filename.CBL.
This directory contains COBOL Source Code for programs that perform utilitarian function in support of the application but are not part of the application that delivers business function. The programs in this directory have unique or specialized function and require specific compiler directives. The source members typically have an extension of filename.CBL.
This directory and its sub-directories contain non-relational data files that are accessed by the application programs and programs that support the infra-structure for the applications.
This link provides additional information about the sub-directory structure for non-relational Data that includes files that are used by Micro Focus Enterprise Server, the application programs and the utility programs that support the applications.
This directory contains the filename.DIR files that are use when compiling the various categories of COBOL Programs. The following shows the different categories.
|Program Categories and Associated Directives Files|
Explore A Scripted Build for additional information about how to do an automated, unattended build of an application that was migrated from a Mainframe System.
This directory contains documents that are used by individuals that are involved with the development, test and execution of the application programs and processes.
This sub-directory is a holding place for load members to be promoted to the Quality Acceptance Testing environment.
This directory contains the HTML documents for the systems and application environments.
Explore The Enterprise System Model for additional information about defining, creating and managing the Environments, Processes, Functions and Data that are needed (required) to expand the platform flexibility and allow a business application currently running on a mainframe system to run on a Windows, UNIX or Linux system using Micro Focus Server Enterprise Edition.
This directory contains the IMS Members. The execution-time members are in this directory. The source code is in two sub-directories, DBD and PSB.
This directory contains Java Source Code for application programs. The source members typically have an extension of filename.java, filename.jsp or filename.htm.
This directory contains the JCL Members that are submitted to and executed by the Micro Focus Server. The JCL Members (Job Control Language) are used to define a batch job consisting of a single job step or multiple job steps. The mapping of the physical file names to the Data Set Name (DSN) and DD name (file name used by program) is done within the JCL Member.
This directory contains JCL INCLUDE members. The content of an include member is used to replace an INCLUDE statement in the Primary JCL member. The included JCL statements are then processed with the submitted JCL stream of statements.
This directory contains the load members for this suite of sample programs. The types of load members are GNT's, MOD's and CMD members.
This directory is reserved for the LOG files produced by the applications and/or system utility programs used with this suite of application programs.
This directory contains the control file (sometimes referred to as control cards) for the programs used by the applications. An example would be a control file that contains the sort specifications used by a SORT program.
When transferring or sharing data between an IBM Mainframe Systems and a Linux, UNIX or Windows System the data files may be converted between EBCDIC-encoded and ASCII-encoded records. This conversion makes the task of data validation (or data file compare) a little more challenging since a simple compare would result in a "NOT Equal" condition for all the records in the file. If the records in the files are sequenced based on the content of a field that is a mixture of letters and numbers we are presented with a bigger challenge since the "Collating Sequence" for EBCDIC and ASCII are different.
Note: The SIMOTIME Technology provides a "Logical Compare" capability that addresses the comparison of EBCDIC and ASCII encoded data files.
Explore how to sort ASCII-encoded Files into an EBCDIC collating sequence or EBCDIC-encoded files into an ASCII collating sequence using the alternate collating or ALTSEQ function of the Mainframe SORT or the ALTSEQ function of the Micro Focus SORT.
This directory contains the JCL Procedures (or PROC's) used by the JCL for the batch jobs of the application being migrated.
This directory contains the REXX program members that are executed by the IRXJCL program in a Micro Focus batch environment.
The SIMOGENS Library is a directory and sub-directory structure that provides a separate place for analyst, technical administrators, testing groups and support individuals to generate programs that will be used to convert, verify or review the content and properties of non-relational data structures.
Explore the SIMOGENS directory structure. The SIMOGENS Library is a directory and sub-directory structure that provides a separate place for analyst, technical administrators, testing groups and support individuals to generate programs that will be used to convert, verify or review the content and properties of non-relational data structures.
This directory is reserved for use by the systems and support teams. It contains programs that are used in support of the application, system and sub-system environments and are not part of the application programs that deliver business functionality. Access to this directory is usually limited to system and support personnel.
This document will focus on a directory structure for the development environment. This document may be used to assist as a tutorial for new programmers or as a quick reference for experienced programmers.
In the world of programming there are many ways to solve a problem. This document and the links to other documents are intended to provide a greater awareness of the Data Management and Application Processing alternatives.
The 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 Comments 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.
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.
The following links may be to the current server or to the Internet.
Explore the non-Relational Data Connection for more examples of accessing methodologies and coding techniques for Data Files and VSAM Data Sets.
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.
Explore The File Status Return Codes to interpret the results of accessing VSAM data sets and/or QSAM files.
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 Micro Focus Web Site for more information about products and services available from Micro Focus. This link requires an Internet Connection.
Explore the Glossary of Terms for a list of terms and definitions used in this suite of documents and white papers.
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.|
|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.
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
|User Libraries for DEVL, TEST & PROD|
|Copyright © 1987-2020
SimoTime Technologies and Services
All Rights Reserved
|When technology complements business|