DNI Parameter Extensions to the Batch Interface

The platform server DNI supports some parameters that are not supported by the platform server Batch interface. These parameters are extensions to the batch commands in that with those parameters, the platform server DNI supports features that are not supported by the Batch interface.

Valid Parameters in Both the Batch and DNI Interfaces

The following two parameters are valid in both the Batch and DNI interfaces, but are specified in different ways. These two parameters are typically defined on the batch PROCESS statement:

  • REQUEST={SEND/RECEIVE}: this required parameter defines whether a request is a send or receive request.
  • PROCESS={process_name}: this parameter defines the process name for a transfer request.

Unsupported Functions of the Batch Interface

You can define the following parameters to specify the actions that the platform server takes when a request is completed. Because DNI is a "lights out" interface, you must either delete or rename the data set when a request is completed so that you can process additional files with the same data set name. This post processing capability can be accomplished by the use of the post processing configuration parameters.

The DNI interface supports the following post processing configuration parameters. See DNI Post Processing Configuration Parameters for details of these parameters.

  • FAIL_ACTION
  • FAIL_NEWDSN
  • GOOD_ACTION
  • GOOD_NEWDSN

These DNI parameters are used for post processing on DNI data sets and defines what DNI does when a transfer request is completed. It is important to understand what the word completion means to DNI. completion means that the request is purged from the platform server transaction queue. A request is purged from the platform server transaction queue under the following circumstances:

  • A request is completed successfully and is purged from the queue.
  • A request is completed with an unrecoverable error and is purged from the queue.
  • A request is completed with a recoverable error, and is purged from the queue when the number of attempts exceeds the value defined in the TRY parameter.
Note: When a DNI request is defined to a platform server distribution list through the LIST parameter, the request is considered to be failed even if only a single transfer in the distribution list fails. The DNI request is considered successful only when all requests in the distribution list are completed successfully.