LIFECYCLE DIRECTORTM
DB2 MANAGER USER GUIDE
312564001
PART NUMBER
Page
Lifecycle Director DB2 Manager User Guide
Version
EC Revision C
Restricted Rights
Export Destination Control Statement
Limitations on Warranties and Liability
Proprietary Information Statement
DB2 MANAGER PARAMETER SPECIFICATION
Table of contents
INSTALLATION AND IMPLEMENTATION
DB2 MANAGER CONTROL REGION
INTRODUCTION
MESSAGES AND CODES
DB2 MANAGER ERROR AND REASON CODES
APPENDICES
OTD260XX – CONTROL REGION WRITER MESSAGES
CONTROL REGION RETURN CODES
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 reorganization
Database backup and recovery
DB2 management processing
Pre-requisitesfor DB2 Manager implementation
StorageTek Proprietary
This page is intentionally left blank
DB2 Manager User Guide
Archive Manager implementation
Installation and Implementation
DB2 Manager implementation procedures
Description
Install distribution libraries
Dataset Name
Update DB2 Manager parameter library
b. Create DB2 Manager control region procedure
Perform MVS host system modifications
d. Update the system Program Properties Table PPT
c. Assign DB2 Manager user identification
e. Update FLPA or MLPA definitions
g. Perform tape management system changes
f. Allocate DB2 Manager SMF record identifier
i. Update automated reply software controls
Perform DB2 system modifications
Resource type
Access required
Resource name
b. Create DB2 Manager application plan
Enter the value ‘4’
Define Archive Manager databases
Data retention
Database Enter the value ‘32760’. blocksize
Volume serial number Unit of allocation
DB2 Manager User Guide
Verify DB2 Manager installation
StorageTek Proprietary
DB2 Manager User Guide
General parameter format
DB2 Manager Parameter Specification
ENVCNTL: SMFRECID
ENVCNTL parameters
ENVCNTL: OBJSIZE
ENVCNTL: READTIMEOUT
TAPECNTL: MAXTRDR
ENVCNTL: WRITETIMEOUT
TAPECNTL parameters
TAPECNTL: MAXDRDR
TAPECNTL: MAXSCHED
TAPECNTL: MAXTWTR
TAPECNTL: RETAINTAPE
TAPECNTL: MAXQLEN
TAPECNTL: TAPEWAIT
TAPECNTL: COMMAND
StorageTek Proprietary
This page is intentionally left blank
DB2 Manager User Guide
Control region initialization
DB2 Manager Control Region
DB2 Manager User Guide
FLPA/MLPA storage
Control region components
Figure 4: Structure of DB2 Manager control region
StorageTek Proprietary
DB2 Manager User Guide
SQL SELECT processing
Processing requests for access to migrated rows
SQL UPDATE processing
SQL DELETE processing
SQL error codes
DB2 Manager operator interface
Display summary status
Stg level
DBID
Example
Manager database for update processing
Display detail status
A request to commit updates to an Archive
Manager database after completion of update
Force purge task
StorageTek Proprietary
DB2 Manager User Guide
Purge task
StorageTek Proprietary
Alter DB2 Manager configuration
DB2 Manager User Guide
StorageTek Proprietary
Valid parameters for the SET command are
DB2 Manager User Guide
MAXQLEN
MAXSCHED
RETAINTAPE
TAPEWAIT
StorageTek Proprietary
DB2 Manager User Guide
Terminate DB2 Manager control region
SMF processing
StorageTek Proprietary
DB2 Manager User Guide
Offset
SMF header section
Length
Format
Database section
Record descriptor section
Offset
Length
Offset
Request section
Length
Format
0 8 16 24
Offset
Length
Format
Length
Offset
Format
Description
Use of the MAXTRDR parameter
Operational considerations
Offset
Length
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
Example
Restrictions
Enabling activities
where
Disabling activities
StorageTek Proprietary
DB2 Manager User Guide
OTDBP100 - the table migration utility
Functions
JCL requirements
SYSIN parameter specification
•LCDDBID =
The following parameters may be specified
•COMMIT = nnnnn
•RESTART=YES|NO
•DB2SSID=xxxx
NEWTAPE=YES NO
•PLAN=xxxxxxxx
•S100PRI=nnnnnnn
SQLIN entry specification
Print reports
PARMLIB requirements
Utility failure and restart considerations
Operator commands
Condition codes
DB2 database reorganization
DB2 table backup and recovery
Data management processing
Archive Manager database backup
Archive Manager database backup and recovery
Archive Manager database recovery
1.Loss of individual tape volumes
The procedure in each case is summarized below
2.Loss of entire database
DB2 Manager User Guide
StorageTek Proprietary
DB2 Manager User Guide
DB2 Manager Utilities
OTDBP120 - the row restore utility
DD entries should be specified as follows
Functions
JCL requirements
A parameter entry has the general format
SYSIN parameter specification
•COMMIT = nnnnn|0
•PLAN=xxxxxxxx
•INDEXONLY=Y|N
•S120PRI=nnnnnnn
•S120UNIT=xxxxxxxx
SQLIN entry specification
Condition codes
Print reports
Utility failure and restart considerations
the utility has been executed successfully
OTDBP130 - the pre-fetchutility
Clean-upprocessing
DD entries should be specified as follows
Functions
JCL requirements
A parameter entry has the general format
SYSIN parameter specification
PLAN=xxxxxxxx
SQLIN entry specification
DB2 Manager User Guide
Print reports
after processing the request
Condition codes
Utility failure and restart considerations
Archive Manager housekeeping processing
OTDBP140 - the table analysis utility
Functions
JCL requirements
DD entries should be specified as follows
SYSIN parameter specification
The following parameters may be specified
SQLIN entry specification
oConcatenated DB2 key of row
Print reports
Figure 5: Detailed table analysis report
OTDBP170 - the database housekeeping utility
Condition codes
Utility failure and restart considerations
DB2 Manager User Guide
Functions
JCL requirements
DD entries should be specified as follows
SYSIN parameter specification
•PLAN=xxxxxxxx
SQLIN entry specification
Print reports
Condition codes
Figure 6: Detailed processing report
Utility failure and restart considerations
Archive Manager database maintenance
StorageTek Proprietary
DB2 Manager User Guide
StorageTek Proprietary
DB2 Manager User Guide
StorageTek Proprietary
This page is intentionally left blank
DB2 Manager User Guide
OTD100xx – table migration utility messages
Messages and Codes
OTD10001 OPEN failed for xxxxxxxx dataset
DB2 Manager User Guide
OTD10012 Error locating ODCT
OTD10015 The control region is not active
DB2 Manager User Guide
OTD10021 Insufficient storage for workareas
OTD120xx – row restore utility messages
OTD12006 Insufficient storage for workareas
INDEXONLY processing
SORTOUT
OTD130xx – pre-fetchutility messages
OTD13006 Insufficient storage for workareas
INDEXONLY processing
OTD140xx - table analysis utility messages
OTD14001 OPEN failed for SYSIN|SQLIN dataset
OTD14007 Load failed for program DSNALI | DSNHLI2
OTD14006 Insufficient storage for workareas
DB2 Manager User Guide
DB2 Manager User Guide
OTD170xx – database housekeeping utility messages
OTD17006 Insufficient storage for workareas
DB2 Manager User Guide
OTD20000 Enter request
OTD20001 Error opening parameter file SYSPARM
OTD20004
OTD20008 ODCT GETMAIN failure
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
OTD20019 Error locating DB2 Manager ASCB | Jobname
OTD20030 Error received posting requestor ECB
OTD20050 Missing or invalid request - ignored
OTD20034 Error X’xx’ received loading program
OTD20051 Invalid Set operands - request ignored
OTD20052 Configuration altered successfully
OTD20058 Display processing completed
OTD20060 Task tnnn has been shutdown successfully
WAIT – the task is currently waiting for work
OTD20071 Invalid Purge operands – request ignored
OTD20093 Shutdown in progress
OTD20091 Invalid Shutdown operands
OTD20096 Shutdown processing complete
OTD220xx – control region scheduler messages
OTD20095 Communications table storage area freed
OTD22004 Invalid request on Scheduler Queue
T=Snnn
OTD22009 Scheduler task nnn terminated
OTD250xx – control region tape reader messages
OTD25005 Tape rdr task nnn initialization failed
OTD25004 Insufficient storage for workareas
OTD25007 Tape rdr task nnn abend Sxxx intercepted
OTD25009 Tape rdr task nnn terminated
OTD25013 Error xx received writing SMF record
OTD25404 Insufficient storage for workareas
OTD254xx – control region disk reader messages
OTD25401 Invalid ODRH received on entry
OTD25409 Disk rdr task nnn terminated
OTD25405 Disk rdr task nnn initialization failed
OTD25407 Disk rdr task nnn abend Sxxx intercepted
OTD26001 Invalid ODWH received on entry
OTD260xx – control region writer messages
OTD25413 Error xx received writing SMF record
OTD26005 Tape wtr task nnn initialization failed
OTD26004 Insufficient storage for workareas
OTD26009 Tape wtr task nnn terminated
OTD26007 Tape wtr task nnn abend Sxxx intercepted
OTD27001 Invalid ODCT received on entry
OTD26013 Error xx received writing SMF record
OTD27003 ODRE table is not valid
OTD27004 Insufficient storage for workareas
OTD27008 Hnnn request timed out - ODRE
DB2 Manager error and reason codes
OTD27005 Housekeeping task Hnnn terminated
Reason code Explanation hex
0A00
Reason code Explanation hex
Action
Action
Reason code Explanation hex
Control region return codes
brackets
Explanation
hex value in
hex value in
Explanation
brackets
DB2 Manager User Guide
Appendix A: Sample JCL members
Appendices
StorageTek Proprietary
OTDBDEF
DB2 Manager User Guide
StorageTek Proprietary
DB2 Manager User Guide
StorageTek Proprietary
DB2 Manager User Guide
StorageTek Proprietary
OTDBPKG
DB2 Manager User Guide
StorageTek Proprietary
OTDBPLAN
DB2 Manager User Guide
StorageTek Proprietary
DB2 Manager User Guide
Index
F FLPA, FORCE, 56 force purge, H HLQ,
MLPA, MODIFY, 43, 46, 51, N new tape volume, O
Host Software Component, 25, 72 housekeeping
failure, 117 housekeeping processing, 13 HSC, I
tape recycling, tape volume recovery,
READTIMEOUT, 37, 53, 59, 60, 62, 63, 126, 171,
R reader task,
selection criteria, 95, 99, 102 utility failure,
updated row,
tape volume recycling,
WRITETIMEOUT, 38, 53, 59, 60, 62,
database housekeeping, 13, 95,
Reader’s Comment Form
∎Contact Us
Publication Information
Questions and Comments
Storage Technology Corporation
BUSINESS REPLY CARD
Code:______________________
StorageTek Proprietary
NEED MORE INFORMATION?
ABOUT STORAGETEK
WORLD HEADQUARTERS