Libraries for Development
Structure for an Enterprise System
  Table of Contents  v-24.01.01 - mifodevl.htm 
  Introduction
  Diagram, Development Libraries
  Directory and sub-Directories
  SIMOSAM1\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
  Contact or Feedback
  Company Overview
The SimoTime Home Page 

Table of Contents Previous Section Next Section Introduction

The Application Libraries (directories and sub-directories) are structures that provide a Mainframe System Model for analyst, technical administrators, testing groups and support individuals to store configuration files, programs and job scripts that support an application infra-structure. This document will focus on a directory structure for the development environment.


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

 
               
SIMOSAM1
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
   
   
   
   
 
 
GNTS
Contains COBOL Load 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
The Directory Structure used in the in the SimoTime Development 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 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 the SimoTime Application samples that use a base directory of SIMOSAM1. The additional directories will be sub-directories under this base directory.

Table of Contents Previous Section Next Section SIMOSAM1\DEVL sub-Directory

The SIMOSAM1\DEVL directory structure is intended to be used by programs and other individuals the support the application creation, testing and ongoing support processes.

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
  Categories of Programs and Associated Directives Files for Scripted Builds

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 the Micro Focus SORT program.

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

This directory contains a set of sub-directories. The sub-directories contain the members that are used to generate programs that will do data conversion, data validation and data review.

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 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
Libraries for Development, Structure for an Enterprise System
Copyright © 1987-2024
SimoTime Technologies and Services
All Rights Reserved
When technology complements business
http://www.simotime.com