Data Virtualization Manager configuration member parameters
Except for the ZCONNECT parameter, the value of these z/OS Connect parameters can be changed at any time.
However, while the parameter values can be altered at any time, the latest values of the parameters at the time a DEFINE ZCPATH command is processed will be used.
The parameters would normally be specified in the AVZSIN00 configuration member for a Data Virtualization Manager region.
All parameters other than the tracing parameters associated with the z/OS Connect facility are
grouped into the PRODZCONNECT group.
Note: Contact Technical Support when using these parameters.
| Parameter | Description | Valid values |
|---|---|---|
| ZCONNECT | This parameter controls whether the z/OS Connect facility will be available in this Data Virtualization Manager server. If set to NO, then nothing can be done including defining specific connections (They will be ignored with an error message). Note that the value of this parameter cannot be changed after a Data Virtualization Manager server region starts. |
|
| ZCONNECTPWNAMEX | The default second and third parts of the name used to connect via WOLA to the z/OS Connect facility. Each part is 1-8 characters and is separated by a ‘.’ From the next part. A specific connection definition may override this value. | NAME2.NAME3 |
| ZCONNECTPMINCR | The default minimum number of processing threads that are pre-attached to process incoming requests. A specific connection definition may override this value. | 1-30 (default value 2) |
| ZCONNECTPMAXCR | The default maximum number of processing threads that are allowed. If a request comes in while the server is already processing this number of requests, an error may be returned to the requestor. A specific connection definition may override this value. See the notes below *1 and *3. | 5-30 (default value 10) |
| ZCONNECTPMAXQR | The default maximum number of queued requests allowed if a new request arrives when the path is already processing the maximum number of concurrent requests. A specific connection definition may override this value. See the notes below *2 and *3. | 0-50 (default value 10) |
| ZCONNECTPMAXQACT | The default action to take if the maximum number of queued requests is reached and a new request is received. Values are ERROR (Return an error to the requestor) and QUEUE (queue the request until a processing thread becomes available). A specific path definition may override this value. | ERROR |
| ZCONNECTPMAXQT | The default time that a queued request (as described in the previous parameter) is allowed to wait for a processing thread. If this time is exceeded, it is if ZCONNECTPMAXQACT=ERROR was in effect. | 0-600 (default value 0) Note: If the value is 0, the request can wait indefinitely. A specific
connection definition may override this value. |
| ZCONNECTPMAXPRQ | The default maximum number of requests that a given ‘processing thread’ will handle before it is recycled. This allows any storage leaks to be controlled. | 0-1000 (default value 10) Note: If the value is 0, no recycling is performed. A specific
connection definition may override this value. |
| ZCONNECTPMAXPTM | The default maximum time allowed to process a request. If a request cannot be completed in this time, an error is returned to the requestor. The value is in seconds. A specific connection definition may override this value. | 0-600 (default value 10) Note: A value of 0 means no limit. |
| ZCONNECTPMAXRECS | The default maximum number of records that can be returned on a (query) request. If the number of records is exceeded, an error is returned to the requestor. A specific connection definition may override this value. | 1-10,000 (default value 1000) |
| ZCONNECTPMAXRLEN | The default limit on the length (in bytes) of the response that can be delivered on a request. If the size (in bytes) of the response would exceed this value, an error is returned to the requestor. A specific connection definition may override this value. | 100-50,000,000 (default value 100,000) |
| ZCONNECTPRETRYINT | The default retry interval, in seconds. If unable to connect to a specific z/OS Connect instance, this parameter sets the number of seconds before the path is retried. A specific connection definition may override this value. | 0-600 (default value 30) Note: If the value is 0, no retry is performed. If less than 10, 10
is used. |
| ZCONNECTPUID | If we cannot obtain a suitable userid from the WOLA or the z/OS Connect facility, this
parameter can be used to nominate a userid under which the requests will run (for authorization
purposes). ‘*’ means that the region userid is used. Note: This parameter will not be needed
if there is a userid. |
NOUIDSET |
| ZCONNECTTRLEV | Sets a trace level. Customers can use this parameter (under guidance). Level meanings: 0: No tracing 1: Trace path start/stop 2: 1 + trace request begin/end 3: 2 + trace request information 4: 3 + trace i/o buffers Note: This parameter this parameter is
not in the ‘PRODZCONNECT’ parameter group, but is in the tracing parameter
group. |
0-9 |