Introduction

This document is an introduction or overview of the EZ Series and SYS1 Series of Windows Command files that may be used to start a region within Enterprise Server, submit or schedule batch jobs to a region within Enterprise Server or stop a region within Enterprise Server. There are four (4) primary command files used in the EZ Series and SYS1 Series of command files

Command

Description

ezSCHEDULE

This script will schedule a job for a specified server (or region) running under Enterprise Server.Note: The Micro Focus Batch Scheduler Interface (MFBSI) is required for this function.

ezSUB

This script will submit a job to the specified server (or region) running under Enterprise Server.

SYS1START

This script will start a server (or region) to run under control of Enterprise Server.

SYS1STOP

This script will stop a server (or region) that is running under control of Enterprise Server.

The Primary Group of EZ Series and SYS1 Series of Commands

Note: The EZ Series of commands start with the letters EZ and are intended for use by the application programmers and business users. The SYS1 Series of commands start with the letters SYS1 and are intended for use by the operations staff and systems programmers.

The preceding command files will call the following command files.

Command

Description

ENV1BASE

This script will set commonly used environment variables. This script provides a single point of definition for commonly used environment variables.

SIMONOTE

This script will display a message to the screen and write a time-stamped record to a log file. This script provides a single method for consistently displaying and logging information about job execution.

SYS1BAKCATALOG

This script will make a backup copy of the CATALOG.DAT file. It maintains ten (10) levels of back-up. This command is usually called from the SYS1START command.

SYS1BAKCONSOLE

This script will make a backup copy of the CONSOLE.LOG file. It maintains ten (10) levels of back-up. This command is usually called from the SYS1START command.

The Ancillary Group of Commands called by the EZ Series and SYS1 Series of Commands

The preceding command files are called from the primary command files to perform common processes in a consistent manner.

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.

Quick Start

The "Quick Start" provides a quick summary of how to use the most common command files of the EZ Series and SYS1 Series of commands. The EZ Series is primarily intended for use by business users that need to access and use the applications. The SYS1 Series is intended for use by the Operations Staff and Systems Programmers to support and maintain the Micro Focus Enterprise Server and the User Configured Application Servers.

Quick Start, Start a Server

The SYS1START command file calls the ENV1BASE command file to set commonly used environment variables. It then calls the SYS1BAKConsole command file to provide a backup of the previously created "console.log" file. It then starts the specified server based on the first parameter of the command line. The following is an example of the command line syntax. The first parameter is the name of the server to be started.

C:\SIMOSAM1\DEVL\SYS1\LOADLIB> SYS1STARTServerName

Quick Start, Stop a Server

The SYS1STOP command file calls the ENV1BASE command file to set commonly used environment variables. It then stops the specified server based on the first parameter of the command line. The following is an example of the command line syntax. The first parameter is the name of the server to be stopped.

C:\SIMOSAM1\DEVL\SYS1\LOADLIB> SYS1STOPServerName

Quick Start, Submit a Job

The EZSUB command file calls the ENV1BASE command file to set commonly used environment variables. It then submits the job name that is specified as the second parameter to the specified server based on the first parameter of the command line. The following is an example of the command line syntax. The first parameter is the name of the server and the second parameter is the job name (i.e. JCL member).

C:\SIMOSAM1\DEVL\LOADLIB> EZSUBServerName JobName

Note: A specified job will be submitted to the server. When the server accepts the job control is returned to the user with a zero return code.

Quick Start, Schedule a Job

The ezSCHEDULE command file calls the ENV1BASE command file to set commonly used environment variables. It then submits the job name that is specified as the second parameter to the specified server based on the first parameter on the command line. The following is an example of the command line syntax. The first parameter is the name of the server and the second parameter is the job name (i.e. JCL member).

C:\SIMOSAM1\DEVL\LOADLIB> EZSCHEDULEServerName JobName

Note-1: A specified job will be submitted to the server. After the job is executed control is returned to the user with a return code that reflects the job completion code.

Note-2: A prerequisite for running this command is the Micro Focus Batch Scheduler Interface (or MFBSI).

EZname & SYS1name Commands

The commands and associated programs in this section provide additional capability and/or specialized functions that are complimentary to the base programs included in this package.

Run a COBOL Program without JCL

This command (EZEXEC.cmd) is available in a separate package. This utility program provides a specialized function. It provides for the execution of a COBOL program without using JCL. The COBOL program may expect a parameter via its LINKAGE SECTION to be in the standard format as if it were executed by JCL. This utility program will read the parameter string from the Windows Command line and re-format to the JCL format and call the COBOL program. The COBOL program does not know it was executed from a non-JCL environment.

C:\SIMOSAM1\DEVL\LOADLIB> EZEXEC ProgramName Parameter

Force a Server to Stop (Terminate)

This command (SYS1FORCE.cmd) calls the ENV1BASE command file to set commonly used environment variables. It then stops (or terminates) the specified server based on the first parameter of the command line. The following is an example of the command line syntax. The first parameter is the name of the server to be stopped.

C:\SIMOSAM1\DEVL\SYS1\LOADLIB> SYS1FORCE ServerName

Caution! This command should only be used when the SYS1STOP command fails to stop a server. The SYS1FORCE will terminate the server and all user jobs in active mode will be cancelled.

List the Content of a Catalog

This command (SYS1CATLIST.cmd) is available in a separate package. This utility program provides a quick and simple way to list or hex-dump the contents of the CATALOG.DAT file to an ASCII/Text file from a Windows Command. The list or hex-dump file may be viewed with NotePad. The program default will produce a list file with the binary values removed prior to writing to the text file.

C:\SIMOSAM1\DEVL\SYS1\LOADLIB> SYS1CATLIST

By setting the CATCTL01 environment variable to a null value the catalog list program will use the program defaults and produce a list file with the binary values removed prior to writing to the text file. The following shows the contents of a control file that will produce a dump of the catalog entries.

*
/DUMP
/NOSHOWDUMP
*
/FLAG-HDR=Y
/FLAG-EBC=N
/FLAG-HEX=Y
/FLAG-ASC=Y

The following describes the possibly records that may be included in the control file.

Keyword

Description

DUMP

/NODUMP is the default, /DUMP will enable the dump format for the output.

SHOWDUMP

/NOSHOWDUMP is the default, /SHOWDUMP will display the dump information to the screen. The /SHOWDUMP is rarely used since the amount of information displayed to the screen rolls off the screen or is difficult to read.

FLAG-HDR

Y or N required, /FLAG-HDR=Y will display the position indicator before each output record is written.

FLAG-EBC

Y or N required, /FLAG-EBC=N will not display the possible EBCDIC interpretation.

FLAG-HEX

Y or N required, /FLAG-HEX=Y will display two lines of a hexadecimal interpretation.

FLAG-ASC

Y or N required, /FLAG-ASC=Y will display a line with the possible ASCII interpretation.

Format of Records within the Control File (CATCTL01)

Note: If a control file is not used an output file in the "LIST" format will be produced.

Export Catalog Information to CSV File

This command (SYS1CATXPORT.cmd) is available in a separate package. This utility program provides a quick and simple way to export file information that is available in the CATALOG.DAT file to a CSV File that is easily imported into a Microsoft Excel spreadsheet or relational data base such as Microsoft Access or MS/SQL

C:\SIMOSAM1\DEVL\SYS1\LOADLIB> SYS1CATXPORT

Review Results of Job Execution

This command (SYS1JESLOG.cmd) and the associated utility program provides a quick and simple way to create and view a list of Job summary information that includes job start, stop and elapsed times.

C:\SIMOSAM1\DEVL\SYS1\LOADLIB> SYS1JESLOG

The following is an example of the output for the SYS1JESLOG utility program.

Get FCT Information from DFHDRDAT

This command (SYS1CSDFCTGET.cmd) and the associated utility program provides a quick and simple way to identify and obtain a list of the files defined in the CICS System Definitions (CSD) file. For the Micro Focus environment this information is stored in the DFHDRDAT file.

Get PCT Information from DFHDRDAT

This command (SYS1CSDPCTGET.cmd) and the associated utility program provides a quick and simple way to identify and obtain a list of the transactions defined in the CICS System Definitions (CSD) file. For the Micro Focus environment this information is stored in the DFHDRDAT file.

Ancillary or Secondary Functions

This section provides additional detail about Micro Focus Server usage and configuration. The commands described in this section are usually called from other commands and not called directly by a business user.

Set the Environment

A command file (ENV1BASE.cmd) is called from other command files to set commonly used environment variables. This provides a single point of definition. The following is a listing of the contents of the command file

CONSOLE.LOG Backup, Ten Levels

A command file (SYS1BAKConsole.cmd) is called from the SYS1START.CMD file when starting a server. Enterprise Server will make a single backup copy of the console log but one level of backup is usually not enough. This command will keep ten levels of backup for the console.log file.

The following is a listing of the contents of the SYS1BAKCONSOLE.cmd command file.

Possibilities and Considerations

This section provides information that addresses specific items pertaining to the function and capabilities and their potential use within or beyond the author's original design objectives.

Frequently Asked Questions (FAQ's)

This section is a list of frequently asked questions preceded by a date stamp.

Date

Question and Answer

2007-03-17

Is it a standard practice to provide access by application and business individuals to the EZ Series and deny access to the SYS1 Series? Yes. This is normally done through a separate security system. Most production environments do not allow just anyone to start or stop a server.

2007-05-17

Are the EZ Series and SYS1 Series commands kept in the same directory? No, we normally configure a "LOADLIB" directory for the EZ Series of commands that allow an individual to execute jobs. The SYS1 Series is kept in a "SYS1\LOADLIB" and are only accessible by operations, support and systems individuals.

Frequently Asked Questions (FAQ)

Technical Information

This section provides additional detail about the ezSERIES of command files.

SYS1START (Start a Server)

This command is used to start a server. The name of the server is defined in the first parameter.

SYS1START Diagram of Logic flow

The following flow chart shows the processing logic for the SYS1START command..

%1=ServerName

SYS1START

Start a Server, refer to Note-1

ENV1BASE

SETstatements

Set the Environment, refer to Note-2

SYS1BAKCONSOLE

CONSOLE1-10

Multi-level backup of CONSOLE.LOG file, refer to Note-3

SYS1BAKCATALOG

CATALOG1-10

Multi-level backup of CATALOG.DAT file, refer to Note-4

CASSTART

%1=ServerName

Start the Server, refer to Note-5

EOJ

Note-1:
SYS1START will make multiple calls to SIMONOTE to write information to a log file for vrious processing steps.

Note-2:
SYS1START will make a call to ENV1BASE to set Environment Variables that are common to the server and third party utility programs.

Note-3:
The call to SYS1BAKCONSOLE will maintain ten (10) levels of backup for the console.log file.

Note-4:
The call to SYS1BAKCATALOG will maintain ten (10) levels of backup for the CATALOG.DAT file.

Note-5:
CASSTART is a Micro Focus Command that will start the server. The Server Name is passed to SYS1START as the first parameter.

SYS1CSDFCTGET Command

This command produces a list of the File Control Table (FCT) defined in the CICS System Definitions (CSD) file. The File Control Table (FCT) contains an entry for each file used by the CICS regions. For the Micro Focus environment this information is stored in the DFHDRDAT file. The following shows the content of the SYS1CSDFCTGET.cmd command.

SYS1CSDPCTGET Command

This command produces a list of the Program Control table (PCT) defined in the CICS System Definitions (CSD) file. The Program Control Table (PCT) contains a definition for each transaction and the program that is used by the transaction. For the Micro Focus environment this information is stored in the DFHDRDAT file. The following shows the content of the SYS1CSDFCTGET.cmd command.

Data Files Allocated to a CICS Region

When a CICS Region is active the non-relational data files are usually allocated to the region in a non-share mode. If there is a requirement to perform maintenance on a non-relational data file from a batch environment it could be accomplished using one of the following approaches.

1.

Bring the region down, do the maintenance and restart the region.

2.

Use the CFMT supplied transaction from within CICS to close/disable the file, do the maintenance, use the CFMT supplied transaction from within CICS to open/enable the file.

3.

Use the CASFILE command from a batch window to close/disable a file that is allocated to a CICS region, do the maintenance, use the CASFILE command from a batch window to open/enable the file to be used by a CICS region.

SYS1FILEDISABLE Command

The following shows the content of a command (SYS1FILEDISABLE.cmd) that will close/disable a non-relational data file being used by a CICS region.

Summary

The purpose of this suite of programs is to provide a model of Windows Command Files that may be used to start a region within Enterprise Server, submit or schedule batch jobs to a region within Enterprise Server or stop a region within Enterprise Server. Also, 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 send an e-mail to: helpdesk@simotime.com or call 415 883-6565. We appreciate hearing from you.

Software Agreement and Disclaimer

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

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

Downloads and Links

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

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

Current Server or Internet Access

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

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

Explore the JCL Connection for more examples of JCL functionality with programming techniques and sample code.

Explore the COBOL Connection for more examples of COBOL programming techniques and sample code.

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

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

Internet Access Required

The following links will require an internet connect.

This suite of programs and documentation is available to download for review and evaluation purposes. Other uses will require a SimoTime Software License.
Link toan Evaluation zPAK Optionthat includes the program members, documentation and control files.

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.

Glossary of Terms

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

Comments or Feedback

This document was created and is copyrighted and maintained by SimoTime Technologies.

If you have any questions, suggestions, comments or feedback please call or send an e-mail to: helpdesk@simotime.com

We appreciate hearing from you.

Company Overview

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

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

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

Whether you want to use the Internet to expand into new market segments or as a delivery vehicle for existing business functions or need assistance with converting non-relational data structures simply give us a call at 415 883-6565 or check the web site at http://www.simotime.com