Skip to content

CATMAP v1.0.1

Latest
Latest

Choose a tag to compare

View all tags
@mainframed mainframed released this 24 Sep 18:36
v1.0.1
d26b224

Prebuilt CATMAP tools for z/OS, distributed as a nested TSO XMIT package.

Changes in this release

  • All four run jobs (RUN3, RUN3J, RUN3N, RUNREXX) now specify
    TIME=NOLIMIT,REGION=0M on the JOB card, so large catalog scans are not
    stopped by default CPU-time or region limits. Sites that restrict these
    values through JES2 or SMF exits may need to adjust them.
  • The three load modules were rebuilt from unchanged sources. Source, compile
    JCL, the CLIST, the REXX exec, and INSTALL are unchanged.

Contents

  • LOADLIB contains CATMAP3 (TSO), CATMAP3J (batch), and CATMAP3N (TCP).
  • JCLLIB contains run JCL for all four implementations, the CATMAP3J CLIST,
    and the original CATMAP REXX exec.
  • Run JCL and CLIST resolve the load library using the executing user's
    &SYSUID.
  • SOURCE contains all three HLASM sources and their separate compile jobs:
    COMPILE3, COMPILEJ, and COMPILEN.
  • XMILIB includes an INSTALL CLIST to receive all three libraries.

Installation

  1. Upload CATMAP.XMI in binary mode to YOURID.CATMAP.XMI, allocated
    as sequential FB 80 (for example, BLKSIZE 27920).
  2. In TSO, enter RECEIVE INDATASET('YOURID.CATMAP.XMI').
  3. At the restore prompt, enter DATASET('YOURID.CATMAP.XMILIB').
  4. Run EX 'YOURID.CATMAP.XMILIB(INSTALL)'.

Replace YOURID with your TSO user ID. INSTALL creates YOURID.CATMAP.LOADLIB,
YOURID.CATMAP.JCLLIB, and YOURID.CATMAP.SOURCE. It refuses to replace
existing libraries; rename them before installing.
Customize the JOB cards for your site. Set a reachable listener address and
port in RUN3N before running the TCP variant. RUN3J writes output to spool;
the CATMAP3J CLIST creates userid.CATMAP.OUTPUT.

The assembler variants use RACROUTE STATUS=ACCESS. On ACF2 systems, the
site-specific authorization requirement described in the README applies.

Validation

All three assemble and link jobs completed with CC 0000. The run jobs passed
a TYPRUN=SCAN JCL check. The downloaded XMIT was uploaded again, received,
and installed successfully, and all three overwrite guards refused as
expected. Every restored member matched its original byte for byte.
Runtime catalog scans and live TCP connections were not tested for this
release. See release/VALIDATION.md.

SHA-256 of CATMAP.XMI:
f211f99eaf1a67787a2aa6fecaac17195d8f09e308e63a9e03d0b5517510d898

Assets 4
Loading