DNI Post Processing Configuration Parameters

You can specify the DNI post processing configuration parameters to define the actions to be performed when a transfer request is completed.

FAIL_ACTION={RENAME | DELETE}

This required parameter defines what action to take when a DNI transfer request fails and is purged from the platform server queue. The following two options are supported:
  • DELETE: indicates deleting the z/OS data set.
  • RENAME: indicates renaming the z/OS data set to the data set that is defined by the FAIL_NEWDSN parameter.
Note: If FAIL_ACTION=RENAME is specified, the FAIL_NEWDSN parameter is required.

FAIL_NEWDSN={new_z/OS_data_set_name}

When a DNI request fails and FAIL_ACTION=RENAME is specified, the local z/OS file is renamed to the file defined by the FAIL_NEWDSN parameter. This parameter supports the DSN substitutable parameters. This parameter is required when FAIL_ACTION=RENAME is specified.

Note: See Substitutable Parameters for more information of the DNI substitutable parameters.
For example, 
FAIL_ACTION=RENAME
FAIL_NEWDSN=%Q01.FAIL.%NOHLQ

GOOD_ACTION={RENAME | DELETE}

This required parameter defines what action to take when a DNI transfer request is completed successfully. The following two options are supported:
  • DELETE: indicates deleting the z/OS data set.
  • RENAME: indicates renaming the z/OS data set to the data set that is defined by the GOOD_NEWDSN parameter.
Note: If GOOD_ACTION=RENAME is specified, the GOOD_NEWDSN parameter is required.

GOOD_NEWDSN={new_z/OS_dataset_name}

When a DNI request is completed successfully and GOOD_ACTION=RENAME is specified, the local z/OS file is renamed to the file defined by the GOOD_NEWDSN parameter. This parameter supports the DSN substitutable parameters. This parameter is a required when GOOD_ACTION=RENAME is specified.

See Substitutable Parameters for more information of the DNI substitutable parameters.

For example, 
GOOD_ACTION=RENAME
GOOD_NEWDSN=%Q01.GOOD.%NOHLQ
Note:

When a file is renamed by specifying FAIL_ACTION=RENAME or GOOD_ACTION=RENAME, the following operations are performed:

  • If a data set exists with a new DSN, the new DSN is deleted and uncataloged.
  • The data set is renamed to the name that is defined by the FAIL_NEWDSN or GOOD_NEWDSN parameter.
  • The new data set name is cataloged.