z/OS UNIX tools

All packages listed here are free. There are no warranties of any kind, and there is no service or technical support available for these from IBM.

These tools were designed for z/OS UNIX by IBM developers and testers. Unless otherwise noted, most of the tools are not very portable. They probably will not work well on other UNIX systems without at least a little modification. The packages provided here are working to the satisfaction of the people who ported them. If you have a problem working with a package, please contact the owner shown for that package.

If you have a package that you would like to make available here, contact Bill Schoen at wjs@us.ibm.com.

auditid will list audit ids for a path or print a pathname given an audit id. This can be helpful in finding a file or directory that is giving you permission failures when an audit message is your best clue. Please see the readme file for more information.Contact:wjs@us.ibm.com

This tiny script, using as input the /etc/booksrv.80 file builds the command to update the bookserver catalogue of books, you can thus run it as a cron job or a batch job, instead of online over the bookserver web pages. If you have OS/390 2.9 with UQ42601 IBM has built this function into the product, just execute the following commands:

In an ISPF edit session, use bpxget to copy an HFS file into your current edit session. It works similarly to the EDIT COPY command. See the macro prolog for installation and usage information.Contact:wjs@us.ibm.com

In an ISPF edit session, use bpxput to create or replace an HFS file from your current edit session with an entire file or range of lines in a file. It works similarly to the EDIT CREATE or EDIT REPLACE commands. See the macro prolog for installation and usage information.Contact:wjs@us.ibm.com

In an ISPF edit session, use bpxwtabs to convert tab characters in your file to a proper number of spaces or spaces to tabs. See the macro prolog for installation and usage information.Contact:wjs@us.ibm.com

To terminate all z/OS UNIX activity, use the bpxstop tool. First, use normal shutdown procedures to terminate processes, including NFS and TCP/IP. Then use bpxstop to kill any remaining processes and to unmount all file systems, including the root file system. bpxstop is intended for use prior to an IPL.

This tool will find files in a file system that have been deleted yet are still in use and consuming space. It will show the process and user using the file, the space in use, and at least a portion of the name used to open the file. [More]Contact:wjs@us.ibm.com

A shell script which invokes the DB2/OS390 V5 Precompile/Bind utility DSNH (an MVS CLIST) from the Unix shell and provides it with a limited interface to HFS files. [more]Contact:David_Keegan@ie.ibm.com

This package allows an application to use the full power of REXX in formulating requests to DB2 and IMS, and to use the full power of REXX to process the results. These DB2 and IMS routines can be used in TSO and OE REXX execs, thereby enabling much of the development of a Web application to be accomplished under TSO or OE. Also included is the FORMWWWX routine which allows REXX CGI or GWAPI applications to easily obtain browser inputs in terms of REXX variables. FORMWWWX automatically handles the GET and POST methods. [more]Contact:kearneyj@us.ibm.com

describe is a DB2 utility which runs on OS/390 UNIX. It connects to an MVS subsystem name (the subsystem needs to be set up by an MVS system administrator) and retrieves the table and index definitions for the named table. [more]Contact:Phil_Browne@ie.ibm.com

dirsize displays the amount of data contained in a directory and all its subdirectories (similar to the UNIX 'du' command). This tool should be very portable to other POSIX.1 platforms. It uses no functions exclusive to OS/390 UNIX. [More]Contact:pfuntner@pobox.com

OS/390 SQL Command Processor V1.5. execsql is a rough and ready SQL command processor which runs on OS/390 UNIX. It connects to an MVS subsystem name (the subsystem needs to be set up by an MVS system administrator) and executes the SQL statements in the named script file. [more]Contact:Phil_Browne@ie.ibm.com

ext extracts files from an archive using ASCII to EBCDIC character translation and then goes back and identifies binary files (by file suffix) and re-extracts them without character translation. [more]Contact:mikemac@us.ibm.com

( chown/chgrp/chmod/df ) This utility gives a non-superuser special capabilities on files sytems he owns. The owner of a file system is defined as the owner of root directory for that file system. Current capabilities are chown, chgrp, and chmod for any file node in that file system. A list of owning file systems can also be printed. See the readme file for install and usage information.Contact:wjs@us.ibm.com

Lists the process id, user id, and uid of any users that are currently using the file system in which the specified pathname resides. This utility requires superuser authority and OS/390 Rel2 or later. (Please download the README file too.)Contact:wjs@us.ibm.com

fsq lists summary or detailed information about one or more file systems, combining similar information as you might see from the ls, zfsadm, and confighfs commands. See the fsq prolog for documentation on use and install.Contact:wjs@us.ibm.com

getuids is a utility that displays information about OS/390 UNIX users and groups from the security database, similar to what would be found in the /etc/passwd file on other UNIX systems. (Please download the README file too.)

ICS2WLM a utility designed to take the panel beating out of creating your first WLM defs. It creates a good starting point for further work under the WLM utility. Please also see the readme for usage information.Contact:alan@nichols.de

The IPLSTATS.ZIP file contains two programs which can be used to report on the time taken by z/OS to initialize various parts of the operating system. The IPLSTATX program writes the report to a standard data set. The IPLSTATZ program writes the report as messages to the z/OS SYSLOG. The programs and report are otherwise identical.Contact:kkelley@us.ibm.com

IOSSPOFD

3/29/16

IOSSPOFD can be used to determine if volumes have a singular hardware component common to all paths to the device. It can also be used to determine if a primary volume and an alternate volume have any common hardware components. If such a hardware component were to fail, then the volume would not be available. The messages issued are documented in z/OS MVS System Messages, Vol 9 (IGF-IWM) under the IOSPF messages section.

The IHS Configuration Migration Tool generates an approximation of an equivalent httpd configuration file for IHS for z/OS powered by Apache. There is no guaranteed mapping of the old z/OS HTTP Server configuration file to an Apache-based server. You should modify this file as necessary before using it. After the conversion, you need to follow the steps mentioned in the section "Changes Required in the Output File" and after that the generated file can be used as an httpd.conf file for IHS for z/OS powered by Apache. For more information, view the README file.Contact:pashok@in.ibm.com

makedep is required for building ICU on OS/390 in Unix System Services. The makedep command reads each SourceFile in sequence and parses it like a C-preprocessor. It processes all #include, #define, #undef, #ifdef, #ifndef, #endif, #if, and #else directives to determine which #include directives need to be used in a compilation. Any #include directives can reference files having other #include directives, and parsing occurs in these files as well. See README for more information.Contact:fixler@us.ibm.com

mcp is a shell function wrapper for readmvs and writemvs (both are described below), and all three are packaged together as "readmvs". mcp mimics the syntax of cp for copying files from one place to another. These files may be MVS files, indicated by a leading // on each MVS file name. "MVS file" means a sequential data set or a member of a partitioned data set. (Please download the README file too.)

The MSGLG610 program and the accompanying IPLMERG4 program can be used to analyze z/OS SYSLOG data sets. Reports include the most frequently occurring message IDs, the most frequently occurring commands, actions taken on messages by the Message Processing Facility (MPF) and Message Flood Automation, as well information about message rates. The IPLMERG4 program can compare events in one SYSLOG relative to events in another SYSLOG and is especially useful in understanding z/OS start-up events.Contact:kkelley@us.ibm.com

Java 2 code that submits JCL to the internal reader. The class defines a MVSJob object that allows a program to add JCL cards and submit them. This class is meant to be a base class. From this class a programmer could create classes that add cards programmatically with standard cards available via environment variables or some other method that resides outside the code. This would provide a level of abstraction from the vagaries of the system.Contact:degilio@us.ibm.com

odb2 is a command line db2 interface for OS/390 UNIX. It uses CAF instead of CLI, so its generally quicker and easier to setup than CLI. Also included are several tools (cwrap and others) to make db2 OS/390 UNIX application development easier. Enhancements to odb2v1.3 include LOB support. More command line options, Some bug fixes. The are also enhancements to the tools: cwrap and db2pb. Please refer to the ReadMe file for more information.Contact:johngood@us.ibm.com

An extended MCS console interface for z/OS UNIX. oeconsol is an z/OS UNIX shell commmand which allows users to issue MVS system commands and receive their responses. The command is very similar to the TSO/E CONSOLE command. Please read the usage and installation information.Contact:tony_hogg@uk.ibm.com

The OS/390 UNIX Setup Verification Program (SVP) lets you check for troublesome setup errors before they trip you up. This utility requires ISPF version 4.1 or higher and MVS 5.2.2 or any release of OS/390. (Please download the README file too.) [More]

The ORACOMP script is used to execute the Oracle PRO*C pre-compiler from the OS/390 UNIX System Services environment. Since the Oracle PRO*C pre-compiler does not recognize HFS files, the ORACOMP script converts the source input file from an HFS file to an MVS dataset and the source output file from an MVS dataset back to an HFS file.Contact:edgerly@us.ibm.com

The IBM z/OS PAV Analysis Tool is a new tool provided to understand the PAV-alias utilization in a dynamic PAV environment and to assist customers in analyzing their I/O configuration. The tool is intended to be used for traditional PAV subsystems and not HyperPAV. For HyperPAV, the system manages PAV-Aliases and thus, no tool is required to analyze PAV utilization.

The tool provides information on the I/O activity to all the PAV-alias devices for each logical subsytem. The data is written to a sequential dataset to be processed by a graphical tool. The graphical tool utilizing SAS application sums up data over all the time interval and displays the utilization per time interval in the 3 dimensional graph, busiest device to least busiest device. This display can be used to determine whether or not the number of PAV-alias devices can be reduced without impacting the work.

a z/OS UNIX System Services utility which allows RACF commands to be executed from a z/OS UNIX environment and writes the output to stdout. This utility uses existing command authorization along with authorization to a FACILITY class resource.Contact:brwells@us.ibm.com

readmvs is a utility that copies one MVS file to stdout, so it can be manipulated in shell pipelines and redirected into HFS files. writemvs is a utility that copies stdin to an MVS file. ("MVS file" means a sequential data set or a member of a partitioned data set.) readmvs, writemvs, and mcp are packaged together. (Please download the README file too.)

RTOOLS is a set of tools to perform remote commands on OS/390 UNIX System Services. In many cases they can be used as a substitute for the remote UNIX commands rcp and rsh. Click here for more information and for usage and installation instructions.Contact:buendgen@de.ibm.com

sdsf is a shell utility that gives you some of the capabilities provided by the SDSF product. These capabilities include the display of active entries (DA), job status display (ST), display of input, output, and hold queues (I, O, and H), and view, delete, and release output. Your system must be running JES2 and have SDSF to use this utility. (Please download the README file too.)Contact:wjs@us.ibm.com

Use the startd utility to start one or more daemons that operate synchronously, that is, they receive control and do not return control immediately back to the invoker. The startd utility also ensures that the started daemons are protected from unexpected signals such as SIGHUP, SIGINT, SIGQUIT, etc. (Please download the README file too.)

submit2 is a shell command that submits JCL, waits until the job is done and retrieves the job output. submit2 is a shell script that can be run in a bash shell on a Linux machine, for example, as well as a ksh shell on OMVS.Contact:jffische@us.ibm.com

This is an SVC Dump analyzer written in Java. It provides an alternative to using IPCS. This package also includes FindRoots which is a tool for analyzing out of memory conditions in Java. [more].)Contact:dgriff@hursley.ibm.com

This utility has similar capabilities as the sdsf utility but is more suitable for shell scripts or make files. It can print job information, job output, and the job completion codes, and purge a job. It can also wait for a job to complete. Download and install like the sdsf utility. See the utility prolog for usage information.Contact:wjs@us.ibm.com

tcpcfg is a tool that provides information about the TCP/IP configuration on OS/390. It can diagnose some problems and make suggestions. Please view the README file for installation and usage information.Contact:trawick@us.ibm.com

tsocmd is a shell command that creates a full batch Terminal Monitor Program (instead of using your TSO session) and runs a TSO command. This command supports authorized TSO commands, which the tso shell command does not. (Please download the README file.)Contact:wjs@us.ibm.com

This version of the tsocmd command matches the version of the tsocmd command shipped with z/OS V1R12.0. This should run on z/OS V1R10 and up. See the README file for additional information.Contact:wlwangwl@cn.ibm.com

These tools build a collection of useful functions and extensions for the current UNIX System Services Environment. Most of the tools included in this package are designed and useful for one or more of the following situations:

You are working on z/OS UNIX related tasks as a BPX.SUPERUSER with a real UID<>0.

You are using a German or the US terminal emulation and are working in the OMVS shell with the default z/OS USS environment or are editing or browsing UNIX files composed in the default z/OS USS code page.

A handy text-viewing tool. Handles EBCDIC, ASCII, even binary files. Scrolls by line or page. Can skip to the start or end. Jumps to a specified a line number. Toggles 'hex mode' to see the raw data of binary files. Performs case-insensitive searches. Release 5 and up only, please. [More].Contact:heim@us.ibm.com

wjsfsmon is a tool that can help identify file systems that might perform better when configured using ZFS sysplex support available on z/OS V1.11. This tool can also be used on earlier releases to help determine which file systems are heavily accessed by systems other than the owner. See the documentation for detailed usage information. Contact:wjs@us.ibm.com

wjsigshl will show information on what is loaded in the shared library region. It shows the
number of processes actively referencing a module, the number of 1MB slots the module
takes, the actual number of pages the module takes and the number of unused pages in
the slots it is loaded in. The first 64 bytes of pathnames to the modules are also displayed. (Please download the README file too.)Contact:wjs@us.ibm.com

Use zfsspace to scan zFS file systems for small files to help determine if an existing file system might need more DASD storage when migrating to z/OS 1.3. A file system with a large number of small files and high space utilization may require more space.Contact:wjs@us.ibm.com

This utility lists users or processes using files or file systems and lists files or file systems in use by users or processes. See the readme file for install and usage information.Contact:wjs@us.ibm.com