Skip to Main Content
IBM Z Hardware and Operating Systems Ideas Portal


This is the public portal for all IBM Z Hardware and Operating System related offerings. To view all of your ideas submitted to IBM, create and manage groups of Ideas, or create an idea explicitly set to be either visible by all (public) or visible only to you and IBM (private), use the IBM Unified Ideas Portal (https://ideas.ibm.com).


Shape the future of IBM!

We invite you to shape the future of IBM, including product roadmaps, by submitting ideas that matter to you the most. Here's how it works:

Search existing ideas

Start by searching and reviewing ideas and requests to enhance a product or service. Take a look at ideas others have posted, and add a comment, vote, or subscribe to updates on them if they matter to you. If you can't find what you are looking for,

Post your ideas
  1. Post an idea.

  2. Get feedback from the IBM team and other customers to refine your idea.

  3. Follow the idea through the IBM Ideas process.


Specific links you will want to bookmark for future use

Welcome to the IBM Ideas Portal (https://www.ibm.com/ideas) - Use this site to find out additional information and details about the IBM Ideas process and statuses.

IBM Unified Ideas Portal (https://ideas.ibm.com) - Use this site to view all of your ideas, create new ideas for any IBM product, or search for ideas across all of IBM.

ideasibm@us.ibm.com - Use this email to suggest enhancements to the Ideas process or request help from IBM for submitting your Ideas.

Status Future consideration
Workspace z/OS
Categories Shell & Utilities
Created by Guest
Created on May 11, 2023

Improve MAN command

The current MAN command uses a z/OS unique man page format and man database. As others port tools (see the z/OS Open Tools project on Github at https://zosopentools.github.io/meta/#/) to run under OMVS this presents challenges  and a great barrier in the area of man pages as:

1. The man page format is different on OMVS when compared to the standard *nix man pages

2. The man database for OMVS is proprietary with no tools to update or add to it preventing ported/new tools from adding their man page to the database

There are two solutions, with one better than the other.

Preferred solution: Convert all existing OMVS man pages to the standard *nix format and provide a mandb tool to update the man page database.

Alternate solution: Release the tool that builds the existing OMVS man page database.

Idea priority High
  • Guest
    Reply
    |
    May 29, 2023

    As the man pages look just like the pages on the web, it should be possible to use that format to generate the pages in man format (I've used Python to do something similar to download control blocks from html)


    it looks like the hard bit will be getting the man command to interpret the data and display it. This might be easier than porting man to z/OS

  • Guest
    Reply
    |
    May 29, 2023
    Thanks for submitting this. I put it in backlog so far, and will consider it in the future release plan.
  • Guest
    Reply
    |
    May 11, 2023

    Saw this on IBM-Main

    It's a tough climb: It's hard enough to get IBM to conform to standards, let alone widespread prevailing conventions.

    And Single UNIX says <https://pubs.opengroup.org/onlinepubs/9699919799/utilities/man.html#tag_20_77_18>:

    RATIONALE

    It is recognized that the man utility is only of minimal usefulness as specified. The opinion of the standard developers was strongly divided as to how much or how little information man should be required to provide. They considered, however, that the provision of some portable way of accessing documentation would aid user portability. The arguments against a fuller specification were:

    When installing FOSS, I have directed the man pages to an NFS-exported directory, then run a script on Solaris to access every man page, ">/dev/null", rendering the nroff format into the "cat" hierarchy for viewing on MVS. Far from ideal.

  • Guest
    Reply
    |
    May 11, 2023

    Saw this on ibm-main:

    It's a tough climb: It's hard enough to get IBM to conform to standards, let alone widespread prevailing conventions.

    And Single UNIX says <https://pubs.opengroup.org/onlinepubs/9699919799/utilities/man.html#tag_20_77_18>:

    RATIONALE

    It is recognized that the man utility is only of minimal usefulness as specified. The opinion of the standard developers was strongly divided as to how much or how little information man should be required to provide. They considered, however, that the provision of some portable way of accessing documentation would aid user portability. The arguments against a fuller specification were:

    When installing FOSS, I have directed the man pages to an NFS-exported directory, then run a script on Solaris to access every man page, ">/dev/null", rendering the nroff format into the "cat" hierarchy for viewing on MVS. Far from ideal.

1 MERGED

Upgrade ALL man pages to standard open format

Merged
All of the current IBM supplied man pages are in a proprietary format which if different from the open-source formatted man pages. This causes problems when using the open-source mandb to create/manage/update the man page database as the mandb is ...
8 months ago in z/OS / Shell & Utilities 1 Future consideration