Defining the DNI Active Queue Dataspace

To use the DNI feature, you must define the platform server DNI Active Queue VSAM dataspace.

1. Edit the SYSIN parameters of the DEFDNI JCL to specify the volume and file name according to your installation requirements.
   IDCAMS is invoked to create a linear VSAM file.
2. Submit the JCL and verify that the linear VSAM file is successfully created.
   Note: In some cases, it might be necessary to re-create the DNI active queue (DNIACTQ) file. The JCL is written to be able to be rerun. Therefore, after deleting the existing DNIACTQ file, you will get an error code result when the job runs for the first time. If this is the only error code that you receive, you can ignore it.

   The amount of disk space that platform server actually uses is determined by the DNIACTQ parameter on the platform server startup JCL. For more information, see EXEC PARM Fields Used by Platform Server.

   A DNI Active Queue (512 bytes) is created each time a request is scheduled in the DNI interface. Each entry remains in the DNI Active Queue dataspace until that request is completed and purged from the queue. The size of the linear VSAM file depends on the number of concurrent DNI requests anticipated in the DNI Active Queue dataspace at any given instance.

   The default value of 2000 is large enough to satisfy the requirements of most installations, because DNI requests execute immediately and are purged from the queue when the request is completed.