Defining the Work Queue VSAM Data Set

You can create a new QUEUE data set using the DEFQUEUE member located in the platform server JCL library.

Procedure

  1. Edit the SYSIN parameters of the DEFQUEUE 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 work queue (WorkQ) file. The JCL is written to be able to be rerun. Therefore, after deleting the existing WorkQ 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 the platform server actually uses is determined by the WORKQ parameter on the platform server startup JCL. For more information, see EXEC PARM Fields Used by Platform Server.

    A work queue entry (4K in size) is created for each platform server transaction. Each work queue entry remains in the work queue until completion (successful or unsuccessful). The size of the linear VSAM file depends on the number of transactions anticipated in the work queue at any given instance.