Envcntl Objsize | StorageTek 312564001 guide

ENVCNTL: OBJSIZE

OBJSIZE = nnnnn

Requirement: Optional

Default: 1000

Validation: 'nnnnn' = a 1- to 5-digit numeric value in the range 1-65535.

Use: The OBJSIZE parameter is used to specify the maximum number of migrated rows to be stored per Archive Manager object.

Notes: Increasing the maximum number of rows which may be stored per Archive Manager object will reduce the size of the primary index file required for indexing objects in the Archive Manager database, but will add a little overhead to the time taken to retrieved a migrated row from the database.

During row retrieval processing, Archive Manager will first of all locate the start of the object containing the migrated row, using a high-speed block locate process, then process the object sequentially until the logical record containing the migrated row is encountered. A larger number of migrated rows (i.e. logical records) per object will increase the average time taken to perform this sequential record locate process.

Note that the value specified (or defaulted) here for the global OBJSIZE parameter will be used in conjunction with the OTDBP100 COMMIT parameter specified during table migration processing, in order to determine the number of rows to be stored per object in the Archive Manager database. The actual number of rows per objects will be the lower of the two values (COMMIT or OBJSIZE).

ENVCNTL: READTIMEOUT

	READTIMEOUT	= nnnn

	Requirement:	Optional
	Default:	10
	Validation:	‘nnnn’ = a 1- to 4-digit numeric value in the range 1-1440.
	Use: The READTIMEOUT parameter specifies the maximum
		number of minutes that the SQL intercept routine is to wait for
		a response from the control region, during row retrieval
		processing. If no request is received within this time, the
36		DB2 Manager User Guide
		StorageTek Proprietary

Image 39

StorageTek 312564001 manual Envcntl Objsize

Contents

Lifecycle Directortm Page Version Lifecycle Director DB2 Manager User Guide Export Destination Control Statement Table of contents DB2 Manager Control Region Introduction Enabling a DB2 Table for Migration Processing Messages and Codes Appendices Introduction Product Description Introduction Row migration Product Functions Retrieval of migrated rows Access to migrated rows Update of migrated rows Deletion of migrated rows Management of migrated rows DB2 Manager storage configuration Product implementation Database backup and recovery DB2 management processingDatabase reorganization Pre-requisites for DB2 Manager implementation Page Installation and Implementation DB2 Manager implementation proceduresArchive Manager implementation Dataset Name Description Install distribution libraries Tapecntl Update DB2 Manager parameter library Assign DB2 Manager user identification Create DB2 Manager control region procedureUpdate the system Program Properties Table PPT Perform MVS host system modifications Update Flpa or Mlpa definitions Perform tape management system changes Allocate DB2 Manager SMF record identifier Perform STK Host Software Component HSC changes Update automated reply software controls Perform DB2 system modifications Create LCDDB2 system database and grant access authorities Create DB2 Manager application plan Resource type Resource name Access required Enter the value ‘4’ Define Archive Manager databases Base database definition panel OTSN4300 Storage level definition panel OTSN4301 Volume serial number Unit of allocation Access Method Services control panel OTSN4302 Verify DB2 Manager installation DB2 Manager User Guide StorageTek Proprietary General parameter format DB2 Manager Parameter Specification Envcntl Smfrecid Envcntl parameters Envcntl Objsize Tapecntl parameters Envcntl Writetimeout Tapecntl Maxdrdr Tapecntl Maxtwtr Tapecntl Maxqlen Tapecntl Tapewait Tapecntl Command Page Control region initialization DB2 Manager Control Region Start LCDDB2 DB2 Control region componentsPage SQL Select processing Processing requests for access to migrated rows SQL Update processing SQL error codes DB2 Manager operator interfaceSQL Delete processing Display summary status Stg level Dbid Example Display detail status LCDDB2,D T=T1 Force purge task LCDDB2,P T=T1 Purge task Alter DB2 Manager configuration Page Maxsched LCDDB2,SET READTIMEOUT=10 Terminate DB2 Manager control region IEE600I Reply to 13 Isshutdown SMF processingPage Offset Length Format Description SMF header section Database section Record descriptor section Request section Offset Length Format Description Offset Length Format Use of the Maxtrdr parameter Operational considerations Use of the Maxqlen parameter Use of the Maxdrdr parameter Allocation recovery Shutdown processing Resource unavailable condition Enabling a DB2 table for migration processing Table migration processing Introduction Enabling activities Restrictions Otdbind ASC Cluster Disabling activities Page OTDBP100 the table migration utility Functions JCL requirements Sysin parameter specification RESTART=YESNO NEWTAPE=YESNO Sqlin entry specification Print reports Parmlib requirements Operator commands Condition codesUtility failure and restart considerations DB2 table backup and recovery Data management processingDB2 database reorganization Archive Manager database backup Archive Manager database backup and recovery Archive Manager database recovery Page Page DB2 Manager Utilities OTDBP120 the row restore utility Exec PGM=OTDBP120,REGION=4096K Sysin parameter specification INDEXONLY=YN Where Acno = ‘123456789’ Objects will be satisfied via DB2 only OTDBP130 the pre-fetch utility Clean-up processing Exec PGM=OTDBP130,REGION=4096K Sysin parameter specification PRINT=DETAILSUMMARY Print reports Problem. Refer to for a description of the messages Archive Manager housekeeping processing OTDBP140 the table analysis utility DSN=Table.identification.file,DISP=SHR Select key1, key2, .. .., keyn from tablename 108 DB2 Manager User Guide StorageTek Proprietary Detailed table analysis report OTDBP170 the database housekeeping utility 110 DB2 Manager User Guide StorageTek Proprietary Sysin parameter specification Ignored. a maximum of 15 records may be present in this file Detailed processing report Archive Manager database maintenance Page Page Page Messages and Codes OTD100xx table migration utility messagesOTD10000 Row Migration Utility ended with completion code OTD10001 Open failed for xxxxxxxx dataset OTD10003 Mandatory exec parameters have not been specifiedOTD10005 Load failed for program Dsnali DSNHLI2 120 DB2 Manager User Guide StorageTek Proprietary OTD10011 Return code Xxx’ retrieving Name/Token pair OTD10012 Error locating Odct OTD10015 The control region is not active OTD10016 Normal run requested but restart run requiredOTD10017 Unable to obtain Odre request element Page OTD10021 Insufficient storage for workareas OTD120xx row restore utility messages OTD12000 Row Restore Utility ended with completion codeOTD12001 Open failed for xxxxxxxx dataset OTD12004 Mandatory exec parameters have not been specified OTD12006 Insufficient storage for workareasOTD12007 Load failed for program Dsnali DSNHLI2 DB2 Manager User Guide 127 StorageTek Proprietary Sortout OTD130xx pre-fetch utility messages OTD13000 Batch Pre-fetch Utility ended with completion codeOTD13001 Open failed for xxxxxxxx dataset OTD13004 Mandatory exec parameters have not been specified OTD13006 Insufficient storage for workareasOTD13007 Load failed for program Dsnali DSNHLI2 DB2 Manager User Guide 131 StorageTek Proprietary OTD140xx table analysis utility messages OTD13015 Archive Manager is not at the correct levelOTD14000 Table Analysis Utility ended with completion code OTD14004 Mandatory exec parameters have not been specified OTD14001 Open failed for Sysinsqlin dataset OTD14007 Load failed for program Dsnali DSNHLI2 OTD14006 Insufficient storage for workareasPage Page OTD17001 Open failed for Sysinsqlin dataset OTD170xx database housekeeping utility messages OTD17004 Mandatory exec parameters have not been specified OTD17006 Insufficient storage for workareasOTD17007 Load failed for program Dsnali DSNHLI2 Page OTD20001 Error opening parameter file Sysparm OTD200xx control region master processor messagesOTD20000 Enter request OTD20006 Envcntl Tapecntl parameter validation errors OTD20004OTD20005 Envcntl Tapecntl parameters being processed OTD20008 Odct Getmain failure OTD20010 Error Xxx during initialization of task tnnnOTD20011 Timeout error during initialization of task tnnn OTD20007 Envcntl Tapecntl parameters successfully processed OTD20013 Getmain failure Xxx allocating task tnnn OTD20014 Error Xxx received attaching task tnnn OTD20017 Intercept successfully established OTD20016 OTDBP300 is not in Link Pack Area OTD20026 Control region already initialized job terminating OTD20019 Error locating DB2 Manager Ascb JobnameOTD20020 Lifecycle Director V1.1 initialization starting OTD20021 Initialization completed successfully OTD20029 Recursive abends intercepted job terminating OTD20030 Error received posting requestor ECBOTD20032 Command rejected enter request via Modify command OTD20028 Unable to continue after abend job terminating OTD20034 Error X’xx’ received loading program OTD20049 Task tnnn shutdown request has failed errorOTD20050 Missing or invalid request ignored OTD20051 Invalid Set operands request ignored OTD20052 Configuration altered successfully OTD20058 Display processing completed OTD20056 Errors altering configuration check system statusOTD20055 Missing/invalid operand request rejected OTD20057 Requested task tnnn does not exist request ignored OTD20061 Invalid Display operands request ignored OTD20060 Task tnnn has been shutdown successfully OTD20067 Request nnn Stg Level=x Tape=yyyyy Blockid=zzzzzzzz OTD20073 Task tnnn purge request is being processed OTD20082 Controller received error posting requestor ECBOTD20071 Invalid Purge operands request ignored OTD20072 Task tnnn is already being purged request ignored OTD20092 Do you want to proceed with shutdown y/n? OTD20094 Error freeing communications table storageOTD20083 Task tnnn has not been purged request ignored OTD20091 Invalid Shutdown operands OTD220xx control region scheduler messages OTD20095 Communications table storage area freedOTD20096 Shutdown processing complete OTD22004 Invalid request on Scheduler Queue OTD22003 Storage Release Error Return Code=Xxx T=Snnn OTD22009 Scheduler task nnn terminated OTD22008 Scheduler task nnn abend Sxxx intercepted OTD25001 Invalid Odrh received on entry OTD250xx control region tape reader messages OTD25007 Tape rdr task nnn abend Sxxx intercepted OTD25003 Unable to get exclusive access to Odre resourceOTD25004 Insufficient storage for workareas OTD25005 Tape rdr task nnn initialization failed OTD25013 Error xx received writing SMF record OTD25404 Insufficient storage for workareas OTD25403 Unable to get exclusive access to Odre resourceOTD254xx control region disk reader messages OTD25401 Invalid Odrh received on entry OTD25405 Disk rdr task nnn initialization failed OTD25407 Disk rdr task nnn abend Sxxx interceptedOTD25409 Disk rdr task nnn terminated OTD25413 Error xx received writing SMF record OTD260xx control region writer messagesOTD26001 Invalid Odwh received on entry OTD26003 Unable to get exclusive access to Odre resource OTD26004 Insufficient storage for workareasOTD26005 Tape wtr task nnn initialization failed OTD26009 Tape wtr task nnn terminated OTD26007 Tape wtr task nnn abend Sxxx intercepted OTD270xx control region housekeeping task messages OTD27008 Hnnn request timed out Odre DB2 Manager error and reason codesOTD27005 Housekeeping task Hnnn terminated OTD27007 Housekeeping task nnn abend Sxxx intercepted Reason code Explanation hex Action Control region return codes Explanation DB2 Manager User Guide 171 StorageTek Proprietary Appendix a Sample JCL members Appendices Otdbdef 174 DB2 Manager User Guide StorageTek Proprietary DB2 Manager User Guide 175 StorageTek Proprietary Otdbpkg Otdbplan 178 DB2 Manager User Guide StorageTek Proprietary Index Maxdisk Page TSO/ISPF ∎ Contact Us Reader’s Comment Form Business Reply Card StorageTek Proprietary About Storagetek World Headquarters