batchtsocmd 0.1.9

Run TSO commands via IKJEFT1B

batchtsocmd

Run TSO commands via IKJEFT1B with automatic encoding conversion.

Description

batchtsocmd is a Python utility for z/OS that executes TSO commands through IKJEFT1B with automatic ASCII/EBCDIC encoding conversion. It handles SYSIN and SYSTSIN inputs from files, automatically converting them to EBCDIC as needed.

Features

• Execute TSO commands via IKJEFT1B
• Automatic ASCII to EBCDIC conversion for input files
• Optional STEPLIB support
• Optional DBRMLIB support
• Configurable output destinations (SYSTSPRT, SYSPRINT)
• Verbose mode for debugging

Requirements

• Python 3.8 or higher
• z/OS operating system
• IBM Z Open Automation Utilities (ZOAU)
• zoautil-py package
• zos-ccsid-converter package

Installation

Note: This package can only be installed and run on z/OS systems.

pip install batchtsocmd

Usage

Basic Usage

batchtsocmd --systsin systsin.txt --sysin input.txt

With Output Files

batchtsocmd --systsin systsin.txt --sysin input.txt \
            --systsprt output.txt --sysprint print.txt

With STEPLIB and Verbose Output

batchtsocmd --systsin systsin.txt --sysin input.txt \
            --steplib DB2V13.SDSNLOAD --verbose

With STEPLIB and DBRMLIB

batchtsocmd --systsin systsin.txt --sysin input.txt \
            --steplib DB2V13.SDSNLOAD --dbrmlib DB2V13.DBRMLIB

With Concatenated STEPLIB Datasets

batchtsocmd --systsin systsin.txt --sysin input.txt \
            --steplib DB2V13.SDSNLOAD:DB2V13.SDSNLOD2:DB2V13.SDSNLOD3

With Concatenated STEPLIB and DBRMLIB Datasets

batchtsocmd --systsin systsin.txt --sysin input.txt \
            --steplib DB2V13.SDSNLOAD:DB2V13.SDSNLOD2 \
            --dbrmlib DB2V13.DBRMLIB:DB2V13.DBRMLI2

Command Line Options

• --systsin PATH - Path to SYSTSIN input file (required)
• --sysin PATH - Path to SYSIN input file (required)
• --systsprt PATH - Path to SYSTSPRT output file or 'stdout' (optional, defaults to stdout)
• --sysprint PATH - Path to SYSPRINT output file or 'stdout' (optional, defaults to stdout)
• --steplib DATASET - Optional STEPLIB dataset name(s). Use colon (:) to concatenate multiple datasets (e.g., DB2V13.SDSNLOAD or DB2V13.SDSNLOAD:DB2V13.SDSNLOD2)
• --dbrmlib DATASET - Optional DBRMLIB dataset name(s). Use colon (:) to concatenate multiple datasets (e.g., DB2V13.DBRMLIB or DB2V13.DBRMLIB:DB2V13.DBRMLI2)
• -v, --verbose - Enable verbose output

Notes

• Input files can be ASCII (ISO8859-1) or EBCDIC (IBM-1047)
• Encoding is auto-detected via file tags; untagged files are assumed to be EBCDIC
• Output files will be tagged as IBM-1047
• Both --systsprt and --sysprint default to 'stdout'
• When stdout is used, SYSTSPRT output is written first, then SYSPRINT output

License

Apache License 2.0

Author

Mike Fulton