Tapecntl Tapewait | StorageTek 312564001 guide

Requirement: Optional

Default: 0

Validation: nnnn = 1-4 digit numeric value in range 0 - 1440

Use: The RETAINTAPE parameter specifies the number of minutes for which a tape is to remain mounted after all outstanding retrieval requests from that tape have been processed by the DB2 Manager control region.

A tape which has not been referenced for the specified interval will be automatically dismounted. A dismount of a tape may be forced by DB2 Manager prior to expiration of this time interval if no free tape drive is available for allocation of a new tape volume, and the tape is the least-recently referenced of all currently mounted tape volumes.

A value of 0 indicates that tapes will be dismounted immediately after the last outstanding request for retrieval from each tape has been processed.

A value of 1440 indicates that tapes are held permanently on a drive until a dismount is forced when there are no free tape drives to satisfy a new request (as described above), or until termination of the DB2 Manager control region.

Notes: This setting may be varied during DB2 Manager operation via the 'SET RETAINTAPE' operator command.

If this parameter is omitted, a default value of RETAINTAPE=0 will be used.

TAPECNTL: TAPEWAIT

TAPEWAIT = nnnn

Requirement: Optional

Default: 0

Validation: nnnn = 1-4 digit numeric value in range 0 - 1440

Use: TAPEWAIT is an optional parameter which is used to control whether retrieval requests for tape-resident Archive Manager objects which cannot be immediately satisfied are rejected (with a ‘resource unavailable’ reason code) or queued internally until a tape retrieval resource becomes available, or until a maximum wait limit has been exceeded. ‘nnnn’ must be a 1-4 digit numeric character string in the range 0-1440, which specifies the maximum number of minutes for which requests are to be queued internally.

DB2 Manager User Guide	41
StorageTek Proprietary

Image 44

StorageTek 312564001 manual Tapecntl Tapewait

Contents

Lifecycle Directortm Page Lifecycle Director DB2 Manager User Guide Version 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 Product Functions Row migration Access to migrated rows Retrieval of migrated rows Update of migrated rows Deletion of migrated rows DB2 Manager storage configuration Management of migrated rows Product implementation Database reorganization Database backup and recoveryDB2 management processing Pre-requisites for DB2 Manager implementation Page Archive Manager implementation Installation and ImplementationDB2 Manager implementation procedures Install distribution libraries Dataset Name Description Update DB2 Manager parameter library Tapecntl Create DB2 Manager control region procedure Update the system Program Properties Table PPTPerform MVS host system modifications Assign DB2 Manager user identification Update Flpa or Mlpa definitions Allocate DB2 Manager SMF record identifier Perform tape management system changes Update automated reply software controls Perform STK Host Software Component HSC changes Create LCDDB2 system database and grant access authorities Perform DB2 system modifications Resource type Resource name Access required Create DB2 Manager application plan Define Archive Manager databases Enter the value ‘4’ 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 DB2 Manager Parameter Specification General parameter format Envcntl parameters Envcntl Smfrecid Envcntl Objsize Envcntl Writetimeout Tapecntl parameters Tapecntl Maxdrdr Tapecntl Maxtwtr Tapecntl Maxqlen Tapecntl Tapewait Tapecntl Command Page DB2 Manager Control Region Control region initialization Start LCDDB2 Control region components DB2Page Processing requests for access to migrated rows SQL Select processing SQL Update processing SQL Delete processing SQL error codesDB2 Manager operator interface Display summary status Dbid Stg level Example Display detail status Force purge task LCDDB2,D T=T1 LCDDB2,P T=T1 Purge task Alter DB2 Manager configuration Page Maxsched LCDDB2,SET READTIMEOUT=10 Terminate DB2 Manager control region SMF processing IEE600I Reply to 13 IsshutdownPage SMF header section Offset Length Format Description Record descriptor section Database section Request section Offset Length Format Description Offset Length Format Operational considerations Use of the Maxtrdr parameter Use of the Maxqlen parameter Allocation recovery Use of the Maxdrdr parameter Shutdown processing Resource unavailable condition Table migration processing Introduction Enabling a DB2 table for migration processing Restrictions Enabling activities Otdbind ASC Cluster Disabling activities Page OTDBP100 the table migration utility Functions Sysin parameter specification JCL requirements RESTART=YESNO NEWTAPE=YESNO Sqlin entry specification Parmlib requirements Print reports Utility failure and restart considerations Operator commandsCondition codes DB2 database reorganization DB2 table backup and recoveryData management processing Archive Manager database backup and recovery Archive Manager database backup Archive Manager database recovery Page Page OTDBP120 the row restore utility DB2 Manager Utilities Exec PGM=OTDBP120,REGION=4096K Sysin parameter specification INDEXONLY=YN Where Acno = ‘123456789’ Objects will be satisfied via DB2 only Clean-up processing OTDBP130 the pre-fetch utility Exec PGM=OTDBP130,REGION=4096K Sysin parameter specification PRINT=DETAILSUMMARY Print reports Problem. Refer to for a description of the messages OTDBP140 the table analysis utility Archive Manager housekeeping processing DSN=Table.identification.file,DISP=SHR Select key1, key2, .. .., keyn from tablename 108 DB2 Manager User Guide StorageTek Proprietary OTDBP170 the database housekeeping utility Detailed table analysis report 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 OTD10000 Row Migration Utility ended with completion code Messages and CodesOTD100xx table migration utility messages OTD10005 Load failed for program Dsnali DSNHLI2 OTD10001 Open failed for xxxxxxxx datasetOTD10003 Mandatory exec parameters have not been specified 120 DB2 Manager User Guide StorageTek Proprietary OTD10012 Error locating Odct OTD10011 Return code Xxx’ retrieving Name/Token pair OTD10017 Unable to obtain Odre request element OTD10015 The control region is not activeOTD10016 Normal run requested but restart run required Page OTD10021 Insufficient storage for workareas OTD12001 Open failed for xxxxxxxx dataset OTD120xx row restore utility messagesOTD12000 Row Restore Utility ended with completion code OTD12007 Load failed for program Dsnali DSNHLI2 OTD12004 Mandatory exec parameters have not been specifiedOTD12006 Insufficient storage for workareas DB2 Manager User Guide 127 StorageTek Proprietary Sortout OTD13001 Open failed for xxxxxxxx dataset OTD130xx pre-fetch utility messagesOTD13000 Batch Pre-fetch Utility ended with completion code OTD13007 Load failed for program Dsnali DSNHLI2 OTD13004 Mandatory exec parameters have not been specifiedOTD13006 Insufficient storage for workareas DB2 Manager User Guide 131 StorageTek Proprietary OTD14000 Table Analysis Utility ended with completion code OTD140xx table analysis utility messagesOTD13015 Archive Manager is not at the correct level OTD14001 Open failed for Sysinsqlin dataset OTD14004 Mandatory exec parameters have not been specified OTD14006 Insufficient storage for workareas OTD14007 Load failed for program Dsnali DSNHLI2Page Page OTD170xx database housekeeping utility messages OTD17001 Open failed for Sysinsqlin dataset OTD17007 Load failed for program Dsnali DSNHLI2 OTD17004 Mandatory exec parameters have not been specifiedOTD17006 Insufficient storage for workareas Page OTD20000 Enter request OTD20001 Error opening parameter file SysparmOTD200xx control region master processor messages OTD20005 Envcntl Tapecntl parameters being processed OTD20006 Envcntl Tapecntl parameter validation errorsOTD20004 OTD20010 Error Xxx during initialization of task tnnn OTD20011 Timeout error during initialization of task tnnnOTD20007 Envcntl Tapecntl parameters successfully processed OTD20008 Odct Getmain failure OTD20014 Error Xxx received attaching task tnnn OTD20013 Getmain failure Xxx allocating task tnnn OTD20016 OTDBP300 is not in Link Pack Area OTD20017 Intercept successfully established OTD20019 Error locating DB2 Manager Ascb Jobname OTD20020 Lifecycle Director V1.1 initialization startingOTD20021 Initialization completed successfully OTD20026 Control region already initialized job terminating OTD20030 Error received posting requestor ECB OTD20032 Command rejected enter request via Modify commandOTD20028 Unable to continue after abend job terminating OTD20029 Recursive abends intercepted job terminating OTD20050 Missing or invalid request ignored OTD20034 Error X’xx’ received loading programOTD20049 Task tnnn shutdown request has failed error OTD20052 Configuration altered successfully OTD20051 Invalid Set operands request ignored OTD20056 Errors altering configuration check system status OTD20055 Missing/invalid operand request rejectedOTD20057 Requested task tnnn does not exist request ignored OTD20058 Display processing completed OTD20060 Task tnnn has been shutdown successfully OTD20061 Invalid Display operands request ignored OTD20067 Request nnn Stg Level=x Tape=yyyyy Blockid=zzzzzzzz OTD20082 Controller received error posting requestor ECB OTD20071 Invalid Purge operands request ignoredOTD20072 Task tnnn is already being purged request ignored OTD20073 Task tnnn purge request is being processed OTD20094 Error freeing communications table storage OTD20083 Task tnnn has not been purged request ignoredOTD20091 Invalid Shutdown operands OTD20092 Do you want to proceed with shutdown y/n? OTD20096 Shutdown processing complete OTD220xx control region scheduler messagesOTD20095 Communications table storage area freed OTD22003 Storage Release Error Return Code=Xxx T=Snnn OTD22004 Invalid request on Scheduler Queue OTD22008 Scheduler task nnn abend Sxxx intercepted OTD22009 Scheduler task nnn terminated OTD250xx control region tape reader messages OTD25001 Invalid Odrh received on entry OTD25003 Unable to get exclusive access to Odre resource OTD25004 Insufficient storage for workareasOTD25005 Tape rdr task nnn initialization failed OTD25007 Tape rdr task nnn abend Sxxx intercepted OTD25013 Error xx received writing SMF record OTD25403 Unable to get exclusive access to Odre resource OTD254xx control region disk reader messagesOTD25401 Invalid Odrh received on entry OTD25404 Insufficient storage for workareas OTD25409 Disk rdr task nnn terminated OTD25405 Disk rdr task nnn initialization failedOTD25407 Disk rdr task nnn abend Sxxx intercepted OTD26001 Invalid Odwh received on entry OTD25413 Error xx received writing SMF recordOTD260xx control region writer messages OTD26005 Tape wtr task nnn initialization failed OTD26003 Unable to get exclusive access to Odre resourceOTD26004 Insufficient storage for workareas OTD26007 Tape wtr task nnn abend Sxxx intercepted OTD26009 Tape wtr task nnn terminated OTD270xx control region housekeeping task messages DB2 Manager error and reason codes OTD27005 Housekeeping task Hnnn terminatedOTD27007 Housekeeping task nnn abend Sxxx intercepted OTD27008 Hnnn request timed out Odre Reason code Explanation hex Action Control region return codes Explanation DB2 Manager User Guide 171 StorageTek Proprietary Appendices Appendix a Sample JCL members 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 Reader’s Comment Form ∎ Contact Us Business Reply Card StorageTek Proprietary About Storagetek World Headquarters