Mainframe Assembler Analysis
|When technology complements business||Copyright © 1987-2013 SimoTime Enterprises All Rights Reserved|
|The SimoTime Home Page|
SIMOX390 is a mainframe Assembler Analysis Tool. This version of SIMOX390 runs on a Windows System and scans a mainframe assembler source member (or a list of members) that have been downloaded and identifies the macro and copy files used by the program or list of programs. This tool should be used in conjunction with a pilot test that would actually assemble, link, and execute a sample test case of an actual application.
This tool is provided to assist in the initial evaluation phase of offloading, maintaining, developing, and/or testing of mainframe assembler programs using Mainframe Express from Micro Focus (refer to http://www.microfocus.com) SIMOX390 is also very useful for getting a quick overview of the mainframe assembler programs and their dependent macro and copy files.
SIMOX390 requires approximately 800K of disk space. Windows/XP, Windows/7 or Windows Server is the required operating system. The SIMOX390 program, this documentation, the Installation Verification Procedure (IVP) and examples are provided in a zipped file.
To install SIMOX390 and run the IVP and sample create a directory as follows.
C:\> md SimoLIBR
C:\> cd SimoLIBR
C:\> C:\SIMOLIBR> pkunzip simox390.zip
The following shows the Command Line syntax for running the Installation Verification Programs (IVP's).
C:\> C:\SIMOLIBR> X390IVP1
C:\> C:\SIMOLIBR> X390IVP2
The X390IVP1.cmd uses the command line interface to access a single mainframe assembler member and it's dependent macro and copy files.
The X390IVP2.cmd uses the command line with the LISTFILE function to access multiple mainframe assembler source members and their dependent macro and copy files.
SIMOX390 will scan mainframe assembler source members that have been downloaded to a Windows System. In addition to scanning the main source member SIMOX390 will attempt to find and scan dependent macro and copy files. To scan a single 370 assembler source member and it's dependencies use the following command.
C:\SIMOLIBR> SIMOX390 filename.MLC
To scan a list of member names use the following command.
C:\SIMOLIBR> SIMOX390 filename.ext LISTFILE
where filename.ext is the name of an ASCII/TEXT file that contains a list of source members to be scanned.
An easy way to create a LISTFILE is to use the following command.
C:\>dir *.MLC /B /A-D /ON>filename.ext
The /B option will cause the dir command to only display the filename. The A-D option will prevent sub-directory names from being included in the list. The /ON option will cause the dir command to organize the directory list in name sequence. The filename.ext will cause the dir command to pipe (route) the directory listing to the specified file.
Note: if you are using EXEC CICS within 370 assembler applications then you will need to run the analysis tool for the filename.CAP files. The command line with required parameters is as follows.
C:\SIMOLIBR> SIMOX390 filename.CAP
SIMOX390 uses the following environment variables. The X390LIB1 environment variable must point to the directories containing the macro and copy files. The X390LIB1 environment variable may contain concatenated directories separated by a semicolon. If X390LIB1 is not specified then the current directory will be the only directory searched for macro and copy files.
The preceding statement is an example of setting the X390LIB1 environment variable that will be used by SIMOX390 to search the current directory and the c:\mfe\mfasm\include directory for macro and copy files.
TheX390LOG1 environment variable will map the name of the log file to a specific drive, directory and name. The log file is an ASCII/Text file.
The optional parameters are as follows.
|Optional Command Line Parameters for SIMOX390|
The functions provided by SIMOX390 are described in more detail in the following sections.
SIMOX390 will scan a single source member or a list of source members and produce a listing of the macro and copy files used by each source member. SIMOX390 will also scan each of the macro and copy files for additional, nested macro or copy files.
In order for SIMOX390 to complete this analysis the source members, the macro files and the copy files must be accessible from the PC. The X390LIB1 environment variable is used to identify the directories where the macro and copy files are stored. The X390LIB1 environment variable may contain concatenated directories separated by a semicolon. If a macro or copy file cannot be found for analysis then and error message is displayed and written to the SIMOX390.log file.
|The preceding is an example of entries in the log file after running the X390IVP2.BAT file.|
If the CALLPLUS parameter is specified on the command line then SimoX390 will display (and write to the simox390.log file) each source statement that is a CALL, LINK or LOAD. If a literal is used to identify the member being referenced then the task is complete. If a variable or register notation is used in the CALL, LINK or LOAD statement then additional effort will be required. SIMOX390 does not attempt to resolve variable or register content. Also, in some cases this information may not be available until execution time.
C:\SIMOLIBR> run SIMOX390 filename.ext LISTFILE CALLPLUS
The preceding line is an example of the command to cause the CALL, LINK and LOAD analysis to be enabled.
If the SVC parameter is specified on the command line then SIMOX390 will display (and write to the simox390.log file) each source statement that contains the SVC operation code. Since the entire source statement is displayed the SVC number or mnemonic value will also be displayed.
C:\SIMOLIBR> run SIMOX390 filename.ext SVCTRACE
The preceding line is an example of the command to cause the SVC analysis to be enabled.
One of the more difficult items to identify is the used of hexadecimal (i.e. non-printable) characters in mainframe source members. On the mainframe this is an accident waiting to happen. When downloading source members to the PC platform it is a recipe for disaster and needs to be identified as quickly as possible.
Identifying hex characters in assembler source members and their associated macro and copy files is easily accomplished using SIMOX390. The use of the HEX parameter on the command line will scan each member for characters less than x'20' or greater than x'7F'. If a hex character is found then a hex dump of the record is displayed and written to the SIMOX390.log file.
C:\SIMOLIBR> run SIMOX390 filename.ext LISTFILE HEX
The preceding line is an example of the command to cause the HEX analysis to be enabled.
The SimoX390 program provides a user with the capability of quickly understanding the structure and interaction between members for both compile and execution time. For the compile time information, SimoX390 will process a list of assembler source members and create a cross reference list of all the macro and copy files used by each of the members in the list. The purpose of this document is 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 choice of alternatives.
Permission to use, copy, modify and distribute this software, documentation or training material for any purpose requires a fee to be paid to SimoTime Enterprises. 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 Enterprises.
SimoTime Enterprises 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 Enterprises 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.
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 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 Assembler Connection for more examples of mainframe Assembler programming techniques and sample code.
Explore an Extended List of Software Technologies that are available for review and evaluation. The software technologies (or Z-Packs) provide individual programming examples, documentation and test data files in a single package. The Z-Packs are usually in zip format to reduce the amount of time to download.
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.
The Generally Available version of this Software may be purchased onlined and is delivered electronically. The Product ID's are SIMOX39001 or SIMOX39002 and a software order is usually processed and made available for download within three (3) business days.
A good place to start is The SimoTime Home Page via Internet Connect for access to white papers, program examples and product information.
Explore The Micro Focus Web Site via Internet Connect for more information about products and services available from Micro Focus.
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 copyrighted and maintained by SimoTime Enterprises.
If you have any questions, suggestions, comments or feedback please call or send an e-mail to: email@example.com
We appreciate hearing from you.
Founded in 1987, SimoTime Enterprises 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. This includes the smallest thin client using the Internet and the very large mainframe systems. There is more to making the Internet work for your company's business than just having a nice looking WEB site. It is about combining the latest technologies and existing technologies with practical business experience. It's about the business of doing business and looking good in the process. 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.
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
|SIMOX390, Mainframe Assembler Analysis|
|Copyright © 1987-2013 SimoTime Enterprises All Rights Reserved|
|When technology complements business|