REGION parameter


Include the REGION parameter on either your JOB statement or your EXEC statement to specify the region size (the amount of virtual storage used by the utility).

For the best performance, we recommend that you specify REGION=0M, in which case the amount of virtual storage needed to run the job is automatically made available when the BMC AMI Copy utility job is run. If your data center does not permit you to specify REGION=0M, REGION=4M will usually ensure adequate storage.

Alternatively, you can specify a calculated amount of storage for the REGION parameter as follows:

  • BMC AMI Copy requires 6 KB for code below the 16-MB line and 3 KB for control blocks per copy statement below the 16-MB line. To determine whether your I/O buffers and control blocks will go below the 16-MB line, see Performance-related messages. If so, you will need 64 KB for allocated storage below the 16-MB line in addition to the I/O buffers.

    Each BMC AMI Copy buffer requires 737,280 bytes, as specified by the NBRBUFS installation option. For more information about the NBRBUFS installation option and for related performance issues, see Installation-options and BMC-AMI-Copy-read-and-write-buffers-NBRBUFS.

  • Additional storage is required when you code a value for BUFNO for the DCB in the output copy DD statement.

The amount of storage required for those buffers (in bytes) is as follows:

(number of concurrent copies)*(BUFNO value)*(BLKSIZE or BUFL value)

Important

If you specify a value for REGION other than 0M, ensure that you have an appropriate value set for the MEMLIMIT parameter, either as your site’s default SMF option or on your JOB statement or EXEC statement.

We recommend a MEMLIMIT value of at least 2 GB. For more information, see MEMLIMIT parameter settings.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*