PQTY

The PQTY keyword specifies the primary quantity value that is assigned to the data set.

Syntax

Read syntax diagramSkip visual syntax diagramPQTY=( nnnnnnnn,op)

PQTY=(nnnnnnnn,op)

Where:

nnnnnnnn is an integer (0 - 16777215) that specifies the primary quantity for a data set.

  • For new non-VSAM data sets, it is the actual amount requested.
  • For non-VSAM new data sets, it is the amount of space that is allocated to the first extent.
  • For VSAM data sets, it is the requested primary quantity; the value is represented in space allocation units. For example, SPACE=(TRK,(5,2)) has a PQTY value of 5 as would SPACE=(CYL,(5,2)).
Note: When a DEFINE is performed for a VSAM data set and space is specified using the RECORDS, KILOBYTES, or MEGABYTES parameters, IDCAMS converts the specifications to tracks or cylinders and then saves the converted specification in the catalog. Therefore, if you specify a rule definition that checks SPACEUNITS for performing a function that occurs during VSAM end of volume (such as SEC_ALLOC), SPACEUNITS=RECORDS, KB, or MB does not generate a match. This can affect PQTY (primary quantity) matching. For example, if a DEFINE specifies MB(1), the specification is converted to two cylinders and saved, and then that value is saved in the catalog. Therefore, attempting to check PQTY=1 for a function that is performed during VSAM end-of-volume also causes a non-match to occur.

Default

None.

Environments

ACS, ALLOCATE, EXTEND, UNALLOCATE, STOW, and CATCHECK.

JCL equivalent

DD01 DD SPACE=(...,(1))

IDCAMS equivalent

DEFINE CLUSTER(CYLINDERS(1) ....)
DEFINE CLUSTER(TRACKS(1) ....)
DEFINE CLUSTER(RECORDS(1000) ....)
DEFINE CLUSTER(MEGABYTES(2) ....)
DEFINE CLUSTER(KILOBYTES(2048) ...)

Related Enhanced Allocation Management function

SET_PQTY

Example

PQTY=2048