CATLG

CATLG is a collection of three TSO commands that add the equivalent IEHPROGM functions - CATLG, UNCATLG, and SCRATCH - to TSO.

It is located in File #163 of the CBT tape and is part of a collection of batch programs and TSO commands contributed by Dave Phillips of Ouiedo, FL.  

 

Installation

I have extracted the installation jobstream which is a single job to assemble and link-edit CATLG to a TSO command library and place TSO Help information into a TSO Help library.  My initial changes were those noted as required by the author - specified missing JOB card parameters, changed SOUT PROC parameter from '$' to '*', substituted SYS1.SMPMTS for SYS1.MODGEN library, changed assembler from IEV90 to IEUASM, and changed the target load library to SYS2.CMDLIB, and the target Help library to SYS2.HELP.  In order to resolve assembly (really JCL errors) I reordered the MACLIB concatenation order and increased the space allocations for the assembler work datasets.  

Attempting assembly revealed that a system provided UCBSCAN routine came about later than MVS 3.8j.  Fortunately, it appears that a manually coded UCBSCAN routine was left in the program and was simply expunged with conditional assembly directives.  I added a couple of my own directives to instead expunge the call to the "built in" routine that we don't have.  Also there was a segment of code later on in the program that is clearly labeled for MVS-XA.  It is coded in such a way to conditionally execute based upon the level of operating system, but the flag it uses to determine that level isn't present in our system macros.  Again, I just added a couple of conditional assembly directives to expunge that section of code.  To see those changes, pull up the jobstream in a text editor and search for the string 'jlm'.

The resulting jobstream - catlg$.jcl - is contained in the archive catlg.tgz [MD5: 9335EE25693DA7769B8D1DA5D2280032].  Download the archive and extract the jobstream (WinZip on Windows/?? or tar on Linux).  Submit the jobstream to assemble and link the single load module for CATLG into SYS2.CMDLIB and copy the help text into SYS2.HELP.  If you don't have SYS2.CMDLIB defined, you will need to modify the jobstream to specify a different target load library.  Also if you do not have SYS2.HELP defined, you may modify the jobstream to place the help information into SYS1.HELP.

 

Utilizing CATLG, UNCATLG, SCRATCH

The functions perform the same as the equivalent IEHPROGM functions.  For usage information, type HELP followed by the command name at the TSO READY prompt.


I hope that you have found my instructions useful.  If you have questions that I can answer to help expand upon my explanations and examples shown here, please don't hesitate to send them to me:


Return to Site Home Page 


This page was last updated on January 17, 2015 .