Utilities

Many batch utility programs are supplied in the source and load distribution libraries (in dsnpref.NMC0.CC2DLOAD). You can change these utilities as required.

This section details the basic functions of each utility and notes the applicable operating system.

You need to study the documentation included in each utility (in dsnpref.NMC0.CC2DSAMP). The documentation contains information about runtime requirements and restrictions, such as warnings about using the utilities with partitioned data sets.

UTIL0001: Batch Job Interface

This utility submits any operating system commands supplied through JCL PARM or SYSIN data file. Its primary use is to provide a means for a batch job to request a file transmission. You can do this by requesting the utility to submit a Modify command of the following format:

F NM,TRANSMIT transdefa

To CA SOLVE:FTS, this Modify command looks like it was entered by an operator from the system console, and therefore looks like it is sourced from the SYSOPER (or alternative installation-defined) console user ID. TRANSMIT is an Operator Console Services (OCS) command requesting transmission of the file defined, in this case, the transdefa transmission definition.

You can include a step that executes this utility in a production run and use it to automate the transmission of files created in earlier job steps.

UTIL0002: Staging File Copy

This utility can be executed in place of IEBGENER to copy a data set into a staging data set prior to transmission. It ensures that the DCB attributes of the staging data set are made the same as the data set being copied into it, and thus eliminates abnormal termination of IEBGENER due to conflicting DCB attributes.

UTIL0003: File Empty Check

This utility verifies that a data set is empty by checking that a staging data set from which previous data was transmitted is empty before copying data into it. If any previous transmission from the staging data set has completed successfully, it is emptied (if the EMPTY INPUT option was selected when the definition was created), and copying proceeds.

The utility usually runs as the step before UTIL0002.

UTIL0004: File Reset

This utility empties any data set by emptying a receive staging data set after the data in it has been copied elsewhere. Once empty, the next transmission into the staging data set can take place.

This utility is designed to work in conjunction with UTIL0003 to protect staging data sets.

UTIL0005: JCL Submission

This utility is called from a Network Control Language (NCL) procedure, using the &CALL statement. It can be passed to JCL statements, and submits them to the operating system internal reader.

As an alternative to using UTIL0005, you can do one of the following:


Copyright © 2010 CA. All rights reserved.