Running commands that generate binary output

Infoprint XT provides a utility program, AIOZBAT, that you can use to run z/OS UNIX commands. The SAIOSAMP data set contains a sample JCL, AIOZBATB, to run commands that produce binary output. See Figure 1.

Figure 1. Sample JCL for z/OS UNIX commands that produce binary output

//AIOZBATB JOB <JOB STATMENT PARAMETERS>
//*********************************************************************
//*    Licensed Materials - Property of IBM                           *
//*    5655-O15                                                       *
//*    (C) Copyright IBM Corp. 2003, 2012                             *
//*                                                                   *
//*  USE THIS JOB TO RUN COMMANDS IN THE UNIX SYSTEM                  *
//*  SERVICES ENVIRONMENT THAT GENERATE BINARY OUTPUT.                *
//*                                                                   *
//*  CAUTION: THIS IS NEITHER A JCL PROCEDURE NOR A COMPLETE          *
//*  JOB.  BEFORE USING THIS JOB STEP, YOU MUST MAKE THE              *
//*  FOLLOWING MODIFICATIONS:                                         *
//*                                                                   *
//*  1) CHANGE THE JOB STATEMENT TO MEET YOUR SYSTEM REQUIREMENTS.    *
//*                                                                   *
//*  2) CHANGE 'hlq' ON THE STDOUTB DD TO AN APPROPRIATE HIGH         *
//*     LEVEL QUALIFIER FOR YOUR SYSTEM.                              *
//*                                                                   *
//*  3) CHANGE 'volser' ON THE STDOUTB DD TO AN APPROPRIATE VOLUME    *
//*     NAME FOR YOUR SYSTEM.                                         *
//*                                                                   *
//*  4) SET THE SYSIN PARAMETERS TO THE DESIRED UNIX SYSTEM SERVICE   *
//*     COMMAND.                                                      *
//*                                                                   *
//*  5) ENSURE YOU RUN THIS JOB FROM A USERID THAT HAS THE            *
//*     OMVS AUTHORIZATION TO RUN THE SELECTED COMMAND AND ACCESS     *
//*     REFERENCED DIRECTORIES.                                       *
//*                                                                   *
//*********************************************************************
//*
//AIOZBATB EXEC  PGM=AIOZBAT
//*
//*********************************************************************
//* SPECIFY THE SINGLE COMMAND TO RUN.  ONLY ONE COMMAND CAN BE       *
//* SPECIFIED PER RUN.                                                *
//*********************************************************************
//SYSIN    DD *
* (1) The following command packs up the entire /var/pdxt directory.
sh -c 'cd /var/pdxt;pax -wz -b 5 .'
*
* (2) The following command packs up the entire /usr/lpp/pdxt directory.
*sh -c 'cd /usr/lpp/pdxt;pax -wz -b 5 .'
*
/*
//SYSPRINT DD SYSOUT=*
//*********************************************************************
//* THESE DDS ARE INPUT/OUTPUT TO THE COMMAND SPECIFIED.              *
//*********************************************************************
//STDIN    DD *
/*
//STDOUTB  DD UNIT=SYSDA,VOL=SER=volser,DISP=(NEW,CATLG,CATLG),
//         DCB=(LRECL=80,RECFM=FB),SPACE=(CYL,(15,5),RLSE),
//         DSN=hlq.PDXT.AIOZBATB.PAX
//STDERR   DD SYSOUT=*

AIOZBATB JOB

This JOB statement marks the beginning of the job, and tells the system how to process the job through the positional and keyword parameters of the statement. Replace AIOZBATB with the appropriate, eight-character user ID string. Replace the <JOB STATEMENT PARAMETERS> portion of the sample statement with any parameters that your installation requires.

AIOZBATB EXEC

This EXEC statement specifies the Infoprint XT AIOZBAT utility program.

SYSIN DD

Defines a sequential data set that contains the z/OS UNIX command string to run. The command data set normally resides in the input stream; however, it can be defined as a member of a partitioned data set or PDSE. The command data set has a logical record length of 80 bytes, and consists of fixed length, blocked records. AIOZBAT uses these rules to build the command string from SYSIN:

AIOZBAT reads columns 1 to 71. Column 72 is for continuation. AIOZBAT ignores columns 73 to 80.
AIOZBAT ignores blank lines and lines that start with an asterisk, *, in column 1.
AIOZBAT removes leading and trailing blanks.
AIOZBAT catenates non-continued lines, inserting a blank between the text for each line.

SYSPRINT DD

This DD statement defines a sequential data set for messages. The data set can be written to a system output device, a tape volume, or a DASD volume.

STDIN DD

This DD statement defines the data set that AIOZBAT passes to the command's standard input (file descriptor 0) . The data set must be comprised of text records. The record format can be fixed or variable, and there are no restrictions on the record length. You cannot use non-text data such as a compressed file. As each record is read from the data set, AIOZBAT inserts a new-line character at the end.

STDOUTB DD

This DD statement defines the data set where AIOZBAT writes the command's standard output (file descriptor 1). Use this DD when the command generates non-text output such as a compressed file. The record format can be fixed or variable. AIOZBAT reads from the command and writes full records to STDOUTB. You can use STDOUT or STDOUTB, but not both.

STDERR DD

This DD statement defines the data set where AIOZBAT writes the command's standard error (file descriptor 2). The standard error data from the USS command must be comprised of text records. The record format can be fixed or variable, and the record length must be long enough to hold the longest record emitted by the command. New-line characters in the output define record boundaries. AIOZBAT does not write the new-line characters to the data set.