DNI Postprocessing Configuration Parameters

You can specify the DNI postprocessing 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 dataset.
  • RENAME: Indicates renaming the z/OS dataset to the dataset 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.

For more information on the DNI substitutable parameters, see 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 dataset.
  • RENAME: Indicates renaming the z/OS dataset to the dataset 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 dataset exists with a new DSN, the new DSN is deleted and uncataloged.
  • The dataset is renamed to the name that is defined by the FAIL_NEWDSN or GOOD_NEWDSN parameter.
  • The new dataset name is cataloged.