User Environment
Libraries for DEVL, TEST & PROD
  Table of Contents  v-18.09.01 - simous01.htm 
  Introduction
  Process Flow
  Programs, Create & Execute
  Documents, Create and Review
  Diagram, Development Libraries
  Directory and sub-Directories
  SIMOUSER\DEVL sub-Directory
  Library, DEVL\ADM1 sub-Directory
  Library, DEVL\ASM sub-Directory
  Library, DEVL\BMS sub-Directory
  Library, DEVL\COBCPY1 sub-Directory
  Library, DEVL\COBCPY6 sub-Directory
  Library, DEVL\COBOL sub-Directory
  Library, DEVL\COBUT1 sub-Directory
  Library, DEVL\COBUT2 sub-Directory
  Library, DEVL\COBUT3 sub-Directory
  Library, DEVL\DATA sub-Directory
  Library, DEVL\DIRS sub-Directory
  Library, DEVL\DOCS sub-Directory
  Library, DEVL\HOLD sub-Directory
  Library, DEVL\HTML sub-Directory
  Library, DEVL\IMSLIB sub-Directory
  Library, DEVL\JAVA sub-Directory
  Library, DEVL\JCL sub-Directory
  Library, DEVL\JCLINC sub-Directory
  Library, DEVL\LOADLIB sub-Directory
  Library, DEVL\LOGS sub-Directory
  Library, DEVL\PARMLIB sub-Directory
  Library, DEVL\PROCLIB sub-Directory
  Library, DEVL\REXXLIB sub-Directory
  Library, DEVL\SIMOGENS sub-Directory
  Library, DEVL\SYS1 sub-Directory
  Summary
  Software Agreement and Disclaimer
  Downloads and Links
  Current Server or Internet Access
  Internet Access Required
  Glossary of Terms
  Comments or Feedback
  Company Overview
The SimoTime Home Page 

Table of Contents Previous Section Next Section Introduction

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. Data Validate
3.1. Hexadecimal Dump
3.2. Accumulate Summary Totals with record counts
3.3. Generate Documentation of Record Layouts in HTML Format
4. and more

 

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-2025
SimoTime Technologies and Services
All Rights Reserved

Table of Contents Previous Section Next Section Process Flow

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.

Link to Internet   Link to Server   Read more about the Data File COMPARE process. This link includes an example that does a physical compare of two data files.

Link to Internet   Link to Server   Read more about the Data File CONVERT process. This link includes an example that does a file format and record content conversion.

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

Table of Contents Previous Section Next Section Programs, Create & Execute

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. Windows System
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. Windows System
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

 

Table of Contents Previous Section Next Section Documents, Create and Review

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

 

Table of Contents Previous Section Next Section Diagram, Development Libraries

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.

 
               
SIMOUSER
See Note-1
   
   
 
 
DEVL
See Note-2
   
   
 
 
ADM1
 
 
and MORE
Administrative and Support functions
   
   
 
 
ASM
 
 
and MORE
Mainframe Assembler Source and Sub-Directories
   
   
 
 
BMS
Contains Basic Mapping Support Member
   
   
 
 
COBCPY1
Contains COBOL Copy Members
   
   
 
 
COBCPY6
Contains COBOL Copy Members from a BMS GEN
   
   
 
 
COBOL
Contains COBOL Source Members
   
   
 
 
COBOLUT1
Contains COBOL Source Members, see Note-3
   
   
 
 
COBOLUT2
Contains COBOL Source Members, see Note-4
   
   
 
 
COBOLUT3
Contains COBOL Source Members, see Note-5
   
   
 
 
DATA
Contains the catalog and data files
   
   
   
   
 
 
APPL
Contains non-Relational data files for Application
   
   
   
   
 
 
SPOOL
Contains the JES and SYSOUT files
   
   
   
   
 
 
and MORE
Link to additional sub-Directories
   
   
 
 
DIRS
Contains compiler directives files
   
   
 
 
DOCS
Contains user or application documentation
   
   
 
 
HOLD
 
 
and MORE
Contains new load members from Scripted Builds
   
   
 
 
IMSLIB
Contains the IMS Members for execution-time
   
   
   
   
 
 
DBD
Source Members for the IMS DBD
   
   
   
   
 
 
PSB
Source Members for the IMS PSB
   
   
 
 
JAVA
Contains JAVA Source Members
   
   
 
 
JCL
Contains the JCL Source Members
   
   
 
 
JCLINC
Contains the Include Members for JCL
   
   
 
 
LOADLIB
Contains the executable members
   
   
   
   
 
 
simpacks
Contains Java Class Members
   
   
 
 
LOGS
Contains the log files for the application
   
   
 
 
PARMLIB
Contains the parameter or control files
   
   
 
 
PROCLIB
Contains the Procedures (or PROC's) for JCL
   
   
 
 
REXXLIB
Contains the REXX Program Members
   
   
 
 
SIMOGENS
 
 
and MORE
Contains the Program Generation Members
   
   
 
 
SYS1
Systems directory, not exposed to users
   
   
 
 
CONFIG
System configuration specifications
   
   
 
 
and MORE
Link to additional sub-Directories?
 
Note-1: This is the primary directory for the SimoTime Driver Programs and Test Cases
Note-2: This is the Development, Production or Test directory, for this example it is set to DEVL.
Note-3: Utility programs using a mainframe dialect, not part of application business functions
Note-4: Utility programs using a Micro Focus dialect, not part of application business functions
Note-5: Utility programs with specialized or unique requirements
Directory Structure for the SimoTime Data Management Technologies
 

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 Directory and sub-Directories

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.

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

Table of Contents Previous Section Next Section Library, DEVL\ADM1 sub-Directory

This directory contains commands and data that provide technical administrative function. Administrative functions include the following.

1 Create a Repository of Application Properties.
2 Read the repository and create reports for member properties and counts in ASCII/Text format.
3 Read the repository and create reports for member properties and counts in HTML format.
4 Read the repository and create member lists that are used to do scripted batch BMS Generations.
5 Read the repository and create member lists that are used to do scripted batch COBOL Compilations.
  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.

Table of Contents Previous Section Next Section Library, DEVL\ASM sub-Directory

This directory contains the source code for the Assembler (Mainframe HLASM) source members. The source members typically have an extension of filename.MLC.

Table of Contents Previous Section Next Section Library, DEVL\BMS sub-Directory

This directory contains the source code for the BMS source members. The source members typically have an extension of filename.BMS.

Table of Contents Previous Section Next Section Library, DEVL\COBCPY1 sub-Directory

This directory contains the COBOL Copy File (or copybooks) used by the application programs. The source members typically have an extension of filename.CPY.

Table of Contents Previous Section Next Section Library, DEVL\COBCPY6 sub-Directory

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.

Table of Contents Previous Section Next Section Library, DEVL\COBOL sub-Directory

This directory contains COBOL Source Code for application programs that deliver business function. The source members typically have an extension of filename.CBL.

Table of Contents Previous Section Next Section Library, DEVL\COBUT1 sub-Directory

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.

Table of Contents Previous Section Next Section Library, DEVL\COBUT2 sub-Directory

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.

Table of Contents Previous Section Next Section Library, DEVL\COBUT3 sub-Directory

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.

Table of Contents Previous Section Next Section Library, DEVL\DATA sub-Directory

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.

Table of Contents Previous Section Next Section Library, DEVL\DIRS sub-Directory

This directory contains the filename.DIR files that are use when compiling the various categories of COBOL Programs. The following shows the different categories.

Category Description
Batch W/O SQL COBOL Batch programs without SQL syntax
Batch with SQL COBOL Batch programs with SQL syntax
Online W/O SQL COBOL Online programs without SQL syntax
Online with SQL COBOL Online programs with SQL syntax
Special Requirements COBOL programs that require special compiler options or directives
  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.

Table of Contents Previous Section Next Section Library, DEVL\DOCS sub-Directory

This directory contains documents that are used by individuals that are involved with the development, test and execution of the application programs and processes.

Table of Contents Previous Section Next Section Library, DEVL\HOLD sub-Directory

This sub-directory is a holding place for load members to be promoted to the Quality Acceptance Testing environment.

Table of Contents Previous Section Next Section Library, DEVL\HTML sub-Directory

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.

Table of Contents Previous Section Next Section Library, DEVL\IMSLIB sub-Directory

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.

Table of Contents Previous Section Next Section Library, DEVL\JAVA sub-Directory

This directory contains Java Source Code for application programs. The source members typically have an extension of filename.java, filename.jsp or filename.htm.

Table of Contents Previous Section Next Section Library, DEVL\JCL sub-Directory

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.

Table of Contents Previous Section Next Section Library, DEVL\JCLINC sub-Directory

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.

Table of Contents Previous Section Next Section Library, DEVL\LOADLIB sub-Directory

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.

Table of Contents Previous Section Next Section Library, DEVL\LOGS sub-Directory

This directory is reserved for the LOG files produced by the applications and/or system utility programs used with this suite of application programs.

Table of Contents Previous Section Next Section Library, DEVL\PARMLIB sub-Directory

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.

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

Table of Contents Previous Section Next Section Library, DEVL\PROCLIB sub-Directory

This directory contains the JCL Procedures (or PROC's) used by the JCL for the batch jobs of the application being migrated.

Table of Contents Previous Section Next Section Library, DEVL\REXXLIB sub-Directory

This directory contains the REXX program members that are executed by the IRXJCL program in a Micro Focus batch environment.

Table of Contents Previous Section Next Section Library, DEVL\SIMOGENS sub-Directory

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.

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

Table of Contents Previous Section Next Section Library, DEVL\SYS1 sub-Directory

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.

Table of Contents Previous Section Next Section Summary

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 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.

Link to Internet   Link to Server   Explore the non-Relational Data Connection for more examples of accessing methodologies and coding techniques for Data Files and VSAM Data Sets.

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.

Link to Internet   Link to Server   Explore The File Status Return Codes that are used to interpret the results of accessing VSAM data sets and/or QSAM files.

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 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 Comments 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
User Libraries for DEVL, TEST & PROD
Copyright © 1987-2025
SimoTime Technologies and Services
All Rights Reserved
When technology complements business
http://www.simotime.com