SimoX390
Mainframe Assembler Analysis
http://www.simotime.com
Copyright © 1987-2010 SimoTime Enterprises All Rights Reserved

Table of Contents

Version 09.05.17

Introduction

System Requirements

Using SimoX390

Environment Variables

Optional Command Line Parameters

Capabilities, Possibilities and Limitations

	Identify Dependencies by Source Member
	Tracking Call, Link and Load Functions
	Tracking SVC Usage
	Finding Embedded HEX Characters

Summary

	Acquiring Software and Links to Similar Pages
	Comments or Suggestions
	About SimoTime

Introduction
(Next) (Previous) (Table-of-Contents)

SimoX390 is a mainframe Assembler Analysis Tool. 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.

This version of SimoX390 runs on the PC 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.

System Requirements and Installation
(Next) (Previous) (Table-of-Contents)

SimoX390 requires approximately 800K of disk space. Windows/2000, Windows/98 or Windows/NT is the required operating system. The SimoX390 program, this documentation, the Installation Verification Procedure (IVP) and examples are provided in a zipped file. Additional information about acquiring SimoX390 may be obtained from http://www.simotime.com/evaltek2.htm.

To install SimoX390 and run the IVP and sample create a directory as follows.

	C:\> md SimoLIBR
	C:\> cd SimoLIBR
	C:\SIMOLIBR> pkunzip simox390.zip
	C:\SIMOLIBR> x390ivp1
	or
	C:\SIMOLIBR> x390ivp2

The x390ivp1.bat uses the command line interface to access a single mainframe assembler member and it's dependent macro and copy files.

The x390ivp2.bat uses the command line listfile function to access multiple mainframe assembler source members and their dependent macro and copy files.

Using SimoX390
(Next) (Previous) (Table-of-Contents)

SimoX390 will scan mainframe assembler source members that have been downloaded to the PC. 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:\>simox390 filename.cap

Environment Variables
(Next) (Previous) (Table-of-Contents)

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.

set X390LIB1=.;c:\mfe\mfasm\include

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.

set X390LOG1=c:\SimoLIBR\LOGS\X390LOG1.TXT

Optional Command Line Parameters
(Next) (Previous) (Table-of-Contents)

The optional parameters are as follows.

Function	Description
CASE	CASE will make the comparison case sensitive. If the 370 Assembler source members are all upper case using the CASE parameter should not cause a problem. CASEOFF is the default, this allows the 370 assembler source members to be a combination of upper and lower case and the comparisons within SimoX390 will not be case sensitive.
LISTFILE	LISTFILE specifies that the input file is a list of file names to be processed in a single pass. LISTFILEOFF is the default and will assume the input file is 370 assembler source code for an MLC, MAC, or CPY file.
MINIFILE	MINIFILE creates a filename.AAT file for each member scanned. This file will show the fully qualified drive:\directory\filename.ext of each COPY and MACRO file used in a source member. MINIFILEOFF is the default, information will only be written the SIMOX390.LOG file.
INFOMSG	INFOMSG will display all informational messages. INFOMSGOFF is the default, minimum messages will be displayed.
ERRORLOG	ERRORLOG will route the name of all missing macro and copyfiles to a filename.ERR file. ERRORLOGOFF is the default, a filename.ERR will not be created.
CALLPLUS	CALLPLUS, trap and route the CALL, LINK, and LOAD macro statements to the console and SYSLIST.WTO file. CALLPLUSOFF, is the default, the CALL, LINK, and LOAD macro statements will be process like all other macro statements.
HEX	HEX When a non-printable, hexadecimal character is found in a source statement the record is dumped in hex format. If HEXOFF is specified then hex checking is not enabled. Note: usually the hex values greater than X'7F' are OK. The hex values less than X'20' usually run a very high risk of causing failures. For example, the CR, LF, and EOF (X'0D', X'0A', and X'1A') characters will cause failures with most ASCII/TEXT editors. Once the hex values are identified the HEXOFF option may be used to make the report easier to read.
CPYMSG	CPYMSG Display and write to SIMOX390.LOG all copy members used. CPYMSGOFF will not display or write copy member messages.
MACMSG	MACMSG Display and write to SIMOX390.LOG all macro members used. MACMSGOFF will not display or write MACRO member messages.
SVCMSG	SVCMSG Display SVC messages for possible problems. SVCOFF will prevent SVC messages from displaying. SVCTRACE will display all SVC information.

Capabilities, Possibilities and Limitations
(Next) (Previous) (Table-of-Contents)

The functions provided by SimoX390 are described in more detail in the following sections.

Identify Dependencies by Source Member
(Next) (Previous) (Table-of-Contents)

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.

o

o

o

o

o

o

1	**		START	2000/10/11 16:40:42:62
2	**		CLINE	hellolst.txt listfile
3	01	*	SYSIN	helloasm.mlc
4	02		COPY	helloac1.cpy
5	02		MACRO	helloam1.mac
6	03		MACRO	helloam2.mac
7	03	*	ERROR	390.110T.MSG 0000004 LOAD	Missing MACRO, invalid OPCODE

8	**
9	**	Files:	0000001
10	**	Comments:	0000010
11	**	Blank Lines:	0000000
12	**	Code:	0000030
13	**	Total Count:	0000040
14	**	Warning:	0000000
15	**	Terminal:	0000001
16	**

STOP

2000/10/11 16:40:42:84

o

o

o

o

o

o

The preceding is an example of entries in the log file after running the X390IVP2.BAT file.

1.		The START statement and shows the date and time the SimoX390 job was started.
2.		The CLINE statement and shows the command line parameters.
3.		The SYSIN statement. The 01 indicates the main program ot first level of possible nested members.
4.		The COPY statement and shows the name of the copy member. The 02 indicates this is the second level.
5.		The MACRO statement and shows the name of the macro member. The 02 indicates this is the second level.
6.		The MACRO statement and shows the name of the macro member. The 03 indicates this is the third level.
7.		The ERROR statement that indicates an error during the member scanning process. In this example the fourth statement in the third level member (helloam2.mac) has a reference to the LOAD macro and the LOAD macro cannot be found.
8-16.		These lines show the number of main members processed and other summary information.
17.		The STOP statement and shows the date and time the SimoX390 job was completed.

Tracking Call, Link and Load Functions
(Next) (Previous) (Table-of-Contents)

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.

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.

Tracking SVC Usage
(Next) (Previous) (Table-of-Contents)

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.

simox390 filename.ext LISTFILE SVCTRACE

The preceding line is an example of the command to cause the SVC analysis to be enabled.

Finding Embedded HEX Characters
(Next) (Previous) (Table-of-Contents)

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.

simox390 filename.ext LISTFILE HEX

The preceding line is an example of the command to cause the HEX analysis to be enabled.

Summary
(Next) (Previous) (Table-of-Contents)

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.

For execution information, a listing of all the call, link and load statements can be created using a simple command line parameter.

Acquiring Software and Links to Similar Pages
(Next) (Previous) (Table-of-Contents)

The SimoX390 program, this documentation, the Installation Verification Procedure (IVP) and examples are provided in a zipped file. Additional information about acquiring SimoX390 may be obtained from http://www.simotime.com/evaltek2.htm.

Check out The Assembler Connection for more examples of mainframe Assembler coding techniques and sample code.

Check out The SimoTime Library for a wide range of topics for Programmers, Project Managers and Software Developers.

To review all the information available on this site start at The SimoTime Home Page .

Comments or Suggestions
(Next) (Previous) (Table-of-Contents)

If you have any questions, suggestions or comments please call or send an e-mail to:

helpdesk@simotime.com

About SimoTime Enterprises
(Next) (Previous) (Table-of-Contents)

Founded in 1987, SimoTime Enterprises is a privately owned company, California. 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

Return-to-Top

SimoX390, Version 2.0.01

When technology complements business

http://www.simotime.com

Introduction(Next) (Previous) (Table-of-Contents)

System Requirements and Installation(Next) (Previous) (Table-of-Contents)

Using SimoX390(Next) (Previous) (Table-of-Contents)

Environment Variables(Next) (Previous) (Table-of-Contents)

Optional Command Line Parameters(Next) (Previous) (Table-of-Contents)

Capabilities, Possibilities and Limitations(Next) (Previous) (Table-of-Contents)

Identify Dependencies by Source Member(Next) (Previous) (Table-of-Contents)

Tracking Call, Link and Load Functions(Next) (Previous) (Table-of-Contents)

Tracking SVC Usage(Next) (Previous) (Table-of-Contents)

Finding Embedded HEX Characters(Next) (Previous) (Table-of-Contents)

Summary(Next) (Previous) (Table-of-Contents)

Acquiring Software and Links to Similar Pages(Next) (Previous) (Table-of-Contents)

Comments or Suggestions(Next) (Previous) (Table-of-Contents)

About SimoTime Enterprises(Next) (Previous) (Table-of-Contents)