Giter Club home page Giter Club logo

adcd-makedist's Introduction

adcd_makedist

makedist.png

Converts an OS/390 ADCD disk image set into an Hercules distribution

Caveat

makedist is intended as a tool for mainframe hobbyists, not for software pirates: thus, this repository does not contain the disk images required to use this software, as they are property of IBM. Before using this script you should understand that the ADCDs supported by makedist are not licensed to run on anything other than a P/390 or an R/390 system, and running the distribution derived from this script constitutes a violation of IBM's license agreement.

Files

  • cnf/ - Configuration files for Hercules
    • os390_v1r2.cnf - Translation of DEVMAP.NME from the OS/390 V1R2 ADCD disk image set
    • os390_v2r10.cnf - Translation of DEVMAP.NME from the OS/390 V2R10 ADCD disk image set
  • makedist - The main script that checks the images' checksums and performs the conversion
  • README.md - This file

Prerequisites

Supported OSes

The script has been developed and tested on bash under Ubuntu and Fedora Linux, and should work on any distribution that has bash and hercules without issues.

Dependencies

  • makedist.sh - Mandatory
    • bash
    • sudo
    • md5sum
    • unzip
    • dasdcopy (part of Hercules)

Usage

Example

$ chmod +x makedist
$ ./makedist -d v2r10 -D path/to/isos -ot local/prefix

Creates an OS/390 V2R10 ADCD distribution into ./local/prefix from disk images located into ./path/to/isos overwriting existing distribution files.

TODOs

In order of importance:

  • Fixing v1r2
  • Testing on different Linux distributions
  • Adding an option to choose a different target directory
    • Adding an option to allow the user to use an absolute path at their own risk
  • Adding support for v2r10 (mainly ISO checksums, DASD conversion strategies and the translation of DEVMAP.NME)
  • Allow using /tmp as cache The cache is now under $prefix_dir/tmp
  • Adding checksums and strategies for converting VM/ESA V2R4 ADCD and VSE/ESA V2R4 ADCD

Contributing

Tickets and PRs for bugs or feature requests are very welcome, if anyone wants to tackle something that's on the TODO list just open a ticket and we'll set up a roadmap together

adcd-makedist's People

Contributors

jack23247 avatar

Stargazers

 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.