BLDVRP Macro (Build VSAM Resource Pool)
The format of the BLDVRP macro is:
BLDVRP BUFFERS = (size(number),size(number), •.. ) (,FIX = {BFRIIOBI(BFR,IOB)H
(,KEYLEN = lengthl
I,R~IODE31 = {ALL,BU .. · ... ,CB,NON ..
:U
(,SHRI)OOL =
{!.I
number}I
1,1\IOOE= {~13IH
,STRNO = number
I,TYl)E= (LSRf,~IINOEXII GSRJI
Note: The RMODE31 parameter replaces the LOC= BELOWIANY parameter shown in previous releases.
The BLDVRI) macro has a standard form and list and execute fonns. The standard form builds a parameter list and passes control to VSAM to build the resource pool. The list and execute fonns arc described in Appendix B, "List, Execute, and Generate Forms of l\facros" on page 171.
BUFFERS = (s;ze(number),size(number), ... )
specifies the size and number of buffers in each buffer pool in the resource pool. The number of buffer pools in the resource pool is implied by the number of size(number) pairs you specify. .
\Vhen you process a key-sequenced data set, the index component, as well as the data component, shares the buffers of a buffer pool. When you use an alternate index to process a base cluster, the components of the alternate index and the base cluster share buffers_ The components of alternate indexes in an upgrade set share buffers. Buffers of the appropriate size and number must be provided for all these components. Each component uses the buffer pool with buffers either the required size or larger.
size
is 512, 1024, 2048, 4096, and then in increments of 4096 to a maximum of J2K bytes.
number
is at least 3.
Size times number must be less than 16 megabytes.
FIX
=
{B,,'RIIOBI(B,,'R,IOB)}specifies that I/O buffers (OFR), or I/O-related control blocks (lOB), or both, are to be fixed in real storage. With GSR, lOB inCludes channel programs. If the program that issues BLDVRP with FIX specified is not authorized to fix areas in real storage, FIX is ignored. A program is authorized if it is in ~upervisor state with protection key 0 to 7, or has been link-edited with authorization (the authorized program facility is described in Supervisor Services and Macro Instructions).
46 MVS/XA VSAM Administration: Macro Instruction Reference
Note: If FIX is specified, DLVRP must be issued by the same task that issues BLDVRP.
KEYLEN = length
specifies the maximum key length of the data sets that are to share the resource pool. The default is
255.
The keys whose lengths must be provided for are the prime key of each key-sequenced data set and the alternate key of each alternate index that is used for processing or is being upgraded. If none of the data sets is keyed, specify O.RMODE31 == (ALLIBUf}"ICBINONE}
specifies the storage residence location of the buffers and 110 related control blocks of the LSR pool identified with the SIIRPOOL keyword.
lbe RMODE31 parameter tells the VSAM OPEN routines where to obtain storage for the 110 related control blocks and 110 buffers.
Therefore, the only time the values specified by the RMODE31 parameter have any effect on VSAM is on the setting just before an OPEN is issued.
At other times, changing these values has no effect on the residency of the·
110 related control blocks and 110 buffers. .
Note: The RMODE31 parameter is valid only when TYPE = LSR is specified.
ALL
both I/O buffers and the VSAM 110 related control blocks associated with the pool are to reside above 16 megabytes.
BU ...
CD
specifics that only 110 buffers are to reside above 16 megabytes.
Gal)' the VSAM
110
related control bIock-s assooatcdwith the pool are to reside above 16 megabytes.NO~E
both 110 buffers and the VSAM 110 related control blocks associated with the pool are to reside below 16 megabytes. TIlls is the default.
Note: In previous releases, the LOC= (BELOWIANY) parameter was used to specify that buffers in the pool be created above 16 megabytes. The RMODE31 parameter replaces the LOC parameter and the two parameters are mutually exclusive. If both are specified on the BLDVRP macro, the LOC parameter is ignored.
SHRIlOOL = {!Inumber}
specifics the identification number of a shared resource pool. Valid only when TYPE = LSR is also specified or defaulted. lbis parameter also requires that the RMODE31 parameter be specified.
specifies the shared pool with the ID of O. It is the default LSR pool.
Chapter 2. VSAM Macro Formats and Examples
47
I l I I I I
number
specifies the shared pool with the 10 of number where number can be
o
to Is.
The LS R control block and buffer pool residence is detenruned by th~ RMODE31=
keyword.1\'IOD£ = {~131}
specifies the fonnat of the BLDVRP parameter list that is to be generated.
31
specifies that a standard fonn (24-bit) parameter list address be generated. This is the default.
specifies that a long form (31-bit) parameter list address be generated.
This value must be coded if the parameter list resides above 16 megabytes.
STRNO = number
specifies the total number of placeholders required for all the data sets that are to share the resource pool. 1 is minimum; 2SS is maximum.
The number should equal the potential number of requests that may be issuedconcutrently for all the data sets that wiU...share. the resource pooL I( a request fails because the number of placeholders is insufficient (you receive a reason code of 64 (X'4Q') in the RPL feedback area), you may retry the request; it will be assigned a placeholder if one has been released. See Figure 8 on page 17 for a complete description of reason code 64 (X' 40').
TYPE
=
{lSRI,DATAI~DEXII GSR}specifics whether a local (LSR) or a global (GSR) resource pool is to be built.
specifies that the caller requests a local shared resource pool. A maximum of 16 data and 16 index resource pools can be built in one address space. Each resource pool must be built individually.
~
specifies that the caller wants to build a data resource pool. This option requires that LSR be specified. This resource pool must exist before an index pool with the same shared pool ID can be built.
INDEX
GSR
specifies that the caller wants to build an index resource pool. This option requires that LSR be specified or defaulted. INDEX must be specified in order to 'create a separate index resource pool. If it is not specified, both data and index components will use the data pools. A data pool must already exist before an index pool with the same shared pool 10 can be built.
specifies that the caller requests a global shared resource pool.
48 MVS/XA VSAM Administration: Macro Instruction Reference
Only one BLDVRP TYPE = GSR may be issued for the system for each of the protection keys 0 through 7. The program that issues BLDVRP TYPE