Micro Focus Catalog When technology complements business   Accessing the CATALOG.DAT File

Copyright © 1987-2008  SimoTime Enterprises, LLC  All Rights Reserved  http://www.simotime.com

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

This utility program will list the contents of the CATALOG.DAT file that is used by Micro Focus Server for Mainframe Migration and Mainframe Express. The catalog file used with Micro Focus Mainframe Express and Server for Mainframe Migration is a Micro Focus Key Sequence file. The catalog contains information for mapping MVS Data Set Names (DSN) to PC file names. The PC file names may be relative (based on where the CATALOG.DAT file is located) or absolute (drive:\directory\filename.ext) or it may be preceded with the name of a Micro Focus Fileshare Server ($$servername). This utility program provides a quick and simple way to list or hexdump the contents of the CATALOG.DAT file to an ASCII/Text file from a Windows Command. The list or hexdump file may be viewed with Notepad.

Introduction, Sample CatList Output
(Next) (Previous) (Table-of-Contents)

The following is an example of the output provided by the Catalog List function.

MFI01.SIMOPROD.PARMLIB1                             C:\SIMOSAM1\PARMLIB1\
SIMOTIME.DATA.CUSTRSEQ                              <CATALOGFOLDER>\DYN1\SIMOTIME.DATA.CUSTRSEQ.DAT
SIMOTIME.DATA.CUSTMAST                              $$FSSERV01\C:\SIMOSAM1\DATALIBA\DYN1\SIMOTIME.DATA.CUSTMAST.DAT

In the preceding example the first line shows the use of an absolute reference to the PC File Name. The second line shows a relative reference to a PC file name. The third line shows a file that is managed by a Fileshare server name FSSERV01.

Introduction, Sample CatDump Output
(Next) (Previous) (Table-of-Contents)

The following is an example of the output provided by the Catalog Dump function.

....+..010....+..020....+..030....+..040....+..050....+..060....+..070....+..080....+..090....+..100....+..110....+
4443325444554425454444322222222222222222222222222222435544454435545444435222222222222222222222222222222222222222222
D6901E39DF02F4E012DC921000000000000000000000000000003AC39DF31D1C012DC921C000000000000000000000000000000000000000000
MFI01.SIMOPROD.PARMLIB1                             C:\SIMOSAM1\PARMLIB1\

In the preceding example the first line is a position indicator. The second and third lines show the hexadecimal value and the fourth line shows the ASCII/Text value.

CMD for a Catalog List (ezCatList)
(Next) (Previous) (Table-of-Contents)

The following (ezCatList.CMD) is a sample of the Windows CMD needed to run this job.

@echo OFF
rem  *
rem  * ESA, Enterprise Server Administration
rem  *      Catalog List Utility
rem  *
rem  * CATGET01 identifies the CATALOG.DAT file that will be used as input
rem  * CATTXT01 identifies the ASCII/Text file to be used as output
rem  * CATCTL01 identifies the control file, if null then default to list
rem  *
     call Env1UTIL
     set CATGET01=%BaseLib1%\DataLibA\CATALOG.DAT
     set CATTXT01=%BaseLib1%\DataLibA\Wrk1\CATALOGTEXT.TXT
     set CATCTL01=
rem  *
     echo *******************************************************ezCATLIST
     echo Starting JobName ezCATLIST, User is %USERNAME%
rem  *
     run CBLCATC2
     echo The Catalog list will be displayed in a separate window...
     START NotePad %CATTXT01%
rem  *
     echo Finished JobName ezCATLIST, User is %USERNAME%
rem  *

CMD for a Catalog Dump (ezCatDump)
(Next) (Previous) (Table-of-Contents)

The following (ezCatDump.CMD) is a sample of the Windows CMD needed to run this job.

@echo OFF
rem  *
rem  * ESA, Enterprise Server Administration
rem  *      Catalog List Utility, Dump Format
rem  *      The Control file is created using the Windows "echo" command
rem  *
rem  * CATGET01 - identifies the CATALOG.DAT file that will be used as input
rem  * CATTXT01 - identifies the ASCII/Text file to be used as output.
rem  * CATCTL01 - identifies the control file
rem  *
     call Env1UTIL
     set CATGET01=%BaseLib1%\DataLibA\CATALOG.DAT
     set CATTXT01=%BaseLib1%\DataLibA\Wrk1\CATALOGTEXT.TXT
     set CATCTL01=%BaseLib1%\DataLibA\Wrk1\CATDUMPX.TXT
rem  *
     echo *******************************************************ezCATDUMP
     echo * Starting JobName ezCATDUMP, User is %USERNAME%
rem  *
     echo * Create the control file CATCTL01 to have the Catalog List
     echo * be created in a Hexadecimal Dump format.
rem  *
     if exist %CATCTL01% erase %CATCTL01%
     echo *>%CATCTL01%
     echo /DUMP>>%CATCTL01%
     echo /NOSHOWDUMP>>%CATCTL01%
     echo *>>%CATCTL01%
     echo /FLAG-HDR=Y>>%CATCTL01%
     echo /FLAG-EBC=N>>%CATCTL01%
     echo /FLAG-HEX=Y>>%CATCTL01%
     echo /FLAG-ASC=Y>>%CATCTL01%
     echo *>>CATCTL01.TXT
rem  *
     echo * Post Catalog information to a file and display to a screen
     run CBLCATC2
     echo * The Catalog list with dump format will be displayed in a separate window...
     START NotePad %CATTXT01%
rem  *
     echo * Finished JobName ezCATDUMP, User is %USERNAME%
rem  *

CMD for Setting Environment
(Next) (Previous) (Table-of-Contents)

The following (Env1UTIL.CMD) is a sample of the Windows CMD script that is called by other Windows CMD scripts. This script will set commonly used environment variables that are used by various utilitarian programs.

rem  * *******************************************************************
rem  * Set the commonly used environment variables. This is used to
rem  * provide a single point for managing the commonly used environment
rem  * variables.
rem  *
     echo Starting JobName Env1UTIL.CMD
     set BaseLib1=c:\SimoSAM1
     set sysout=%BaseLib1%\LOGS\ApplSysOut.TXT
rem  *
rem  * The following may need to be adjusted based on individual systems and the
rem  * various versions of the Operating System, Sub-Systems and other software.
     if "%ENV1UTIL%" == "Y" goto :NOPATH
     echo May need to set the PATH for Micro Focus...
rem  set path="C:\Program Files\Micro Focus\Net Express 5.0\Base\";"C:\Program Files\Micro Focus\Net Express 5.0\Base\bin";%PATH%;
rem  set path="C:\Program Files\Micro Focus\Server 5.0\Base\";"C:\Program Files\Micro Focus\Server 5.0\Base\bin";%PATH%;
:NOPATH
     set JobStatus=0000
     set StepStatus=0000
     set ENV1UTIL=Y
     echo Finished JobName Env1UTIL.CMD

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

The purpose of this utility program is to provide a listing of the contents of a Micro Focus CATALOG.DAT file in text or hexdump format.

Software Agreement and Disclaimer
(Next) (Previous) (Table-of-Contents)

Permission to use, copy, modify and distribute this software for any commercial purpose requires a fee to be paid to SimoTime Enterprises. Once the fee is received by SimoTime the latest version of the software 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.

Permission to use, copy, modify and distribute this software for a non-commercial purpose and without fee is hereby granted, 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 for any purpose. It is provided "AS IS" without any express 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.

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

You may download this example at http://www.simotime.com/sim4dzip.htm#zpackcblcat01 or view the complete list of SimoTime Examples at http://www.simotime.com/sim4dzip.htm.
Note: You must be attached to the Internet to download or view the list.

The hexadecimal dump of the parameter-buffer uses the same technique as describe in another SimoTime example that describes the dumping of a data string using COBOL. The name of the member that does the actual hexadecimal dump is called SimoDUMP. A copy file (PASSDUMP.CPY) is provided for defining the pass area.

The SimoZAPS Utility Program has the capability of generating a COBOL program that will do the conversion of sequential and VSAM (KSDS) files between EBCDIC and ASCII. SimoZAPS can also read a sequential file in EBCDIC format and create an ASCII/CRLF file or VSAM KSDS file in ASCII format. The conversion tables may be viewed or modified to meet unique requirements. The Hexcess/2 function provides the capability of viewing, finding or patching the contents of a file in hexadecimal.

This item will provide a link to  an ASCII or EBCDIC translation table. A column for decimal, hexadecimal and binary is also included.

Check out  The VSAM - QSAM Connection  for more examples of mainframe VSAM and QSAM accessing techniques and sample code.

This document provides a quick summary of the  File Status Key  for VSAM data sets and QSAM files.

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 .

Glossary of Terms
(Next) (Previous) (Table-of-Contents)

Check out  The SimoTime Glossary  for a list of terms and definitions used in the documents provided by SimoTime.

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

We appreciate your comments and feedback.

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

Founded in 1987, SimoTime Enterprises is a privately owned, Limited Liability Corporation located in Novato, 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