DB2®9 for z/OS Reference Guide - DB2 Expert

DB2®9 for z/OS Reference Guide A guide to help with daily activities on DB2® 9 for z/OS

YL&A, Inc. www.ylassoc.com www.db2expert.com

YL&A DB2® 9 for z/OS Reference Guide

Produced by: YL&A, Inc 2743 S. Veterans Pkwy #226 Springfield, IL 62704 [email protected] 08/17/2007

Notice and Disclaimer This DB2® 9 for z/OS Family Reference Guide was developed to help users in their daily activities in administrating and programming in DB2 on all platforms. There are no guarantees expressed or implied with the contents in this guide. YL&A, Inc., is not liable for any loss or damage, direct or indirect, resulting from usage of this reference guide. We want to provide a quality and useful reference for users. Please notify us of any mistakes or errors in this reference guide at [email protected]. The syntax diagrams and tables were reprinted with permission from the IBM Corporation. Much of the material in this guide has copyrights held by the IBM Corporation. DB2 is a registered trademark of the IBM Corporation. Windows is a registered trademark of the Microsoft Corporation. Unix is a registered trademark of the Open Group.

2

Table of Contents

®

YL&A DB2 9 for z/OS Reference Guide

Reading the IBM® Syntax Diagrams Read the syntax diagrams from left to right, from top to bottom, following the path of the line. The >>--- symbol indicates the beginning of a statement. The ---> symbol indicates that the statement syntax is continued on the next line. The >--- symbol indicates that a statement is continued from the previous line. The --->< symbol indicates the end of a statement. Diagrams of syntactical units other than complete statements start with the >--- symbol and end with the ---> symbol. Required items appear on the horizontal line (the main path). >>__required_item______________________________________________>< Optional items appear below the main path. >>__required_item______________________________________________>< |_optional_item_| If an optional item appears above the main path, that item has no effect on the execution of the statement and is used only for readability. _optional_item_ >>__required_item__|____________|_______________________________>< If you can choose from two or more items, they appear vertically, in a stack. If you must choose one of the items, one item of the stack appears on the main path. >>__required_item____required_choice1____________________________>< |_required_choice2_| If choosing one of the items is optional, the entire stack appears below the main path. >>__required_item______________________________________________>< |_optional_choice1_| |_optional_choice2_| If one of the items is the default, it appears above the main path and the remaining choices are shown below. _default_choice__ >>__required_item__|_______________|____________________________>< |_optional_choice_| |_optional_choice_| An arrow returning to the left, above the main line, indicates an item that can be repeated. >__required_item____repeatable_item_|___________________________>< If the repeat arrow contains a comma, you must separate repeated items with a comma. >__required_item____repeatable_item_|___________________________>< A repeat arrow above a stack indicates that you can repeat the items in the stack. Keywords appear in uppercase (for example, FROM). They must be spelled exactly as shown. Variables appear in all lowercase letters (for example, column-name). They represent user-supplied names or values. If punctuation marks, parentheses, arithmetic operators, or other such symbols are shown, you must enter them as part of the syntax.

Table of Contents

3

®


Table of Contents DB2 9 FOR Z/OS.................................................................20 LANGUAGE ELEMENTS ....................................................20 SPECIAL REGISTERS ................................................................................................... 20 HOST VARIABLES ....................................................................................................... 20 FUNCTIONS ................................................................................................................ 21 TABLE FUNCTION ....................................................................................................... 21 EXPRESSIONS ............................................................................................................ 21 LABELED DURATIONS .................................................................................................. 21 CASE EXPRESSIONS .................................................................................................. 22 CAST ....................................................................................................................... 22 NEXT VALUE EXPRESSION ....................................................................................... 23 PREVIOUS VALUE EXPRESSION .............................................................................. 23 ROW CHANGE EXPRESSION .................................................................................... 23 OLAP ....................................................................................................................... 23 PREDICATES .............................................................................................................. 24 BASIC PREDICATE ...................................................................................................... 24 QUANTIFIED PREDICATE.............................................................................................. 24 BETWEEN PREDICATE .............................................................................................. 24 DISTINCT PREDICATE ............................................................................................... 25 EXISTS PREDICATE ................................................................................................... 25 IN PREDICATE ............................................................................................................ 25 LIKE PREDICATE ........................................................................................................ 25 NULL PREDICATE ...................................................................................................... 25 XMLEXISTS............................................................................................................. 25 SEARCH CONDITIONS.................................................................................................. 25

COLUMN FUNCTIONS .......................................................26 AVG ......................................................................................................................... 26 CORRELATION....................................................................................................... 26 COUNT .................................................................................................................... 26 COUNT_BIG ............................................................................................................ 26 COVARIANCE OR COVARIANCE_SAMP ............................................................... 26 MAX ......................................................................................................................... 26 MIN .......................................................................................................................... 26 STDDEV .................................................................................................................. 26 STDDEV_SAMP ...................................................................................................... 26 SUM ......................................................................................................................... 26 VARIANCE OR VARIANCE SAMP ........................................................................... 27 4

Table of Contents

®


XMLAGG .................................................................................................................. 27

SCALAR FUNCTIONS ........................................................27 ABS .......................................................................................................................... 27 ACOS ....................................................................................................................... 27 ADD_MONTHS ........................................................................................................ 27 ASCII ........................................................................................................................ 27 ASCII_CHR .............................................................................................................. 27 ASCII_STR............................................................................................................... 27 ASIN ......................................................................................................................... 27 ATAN........................................................................................................................ 27 ATANH ..................................................................................................................... 27 ATAN2...................................................................................................................... 27 BIGINT ..................................................................................................................... 27 BLOB........................................................................................................................ 28 BINARY .................................................................................................................... 28 CCSID_ENCODING................................................................................................. 28 CEILING ................................................................................................................... 28 CHAR ....................................................................................................................... 28 CHARACTER_LENGTH .......................................................................................... 29 CLOB........................................................................................................................ 29 COALESCE.............................................................................................................. 29 COLLATION_KEY.................................................................................................... 29 COMPARE_DECFLOAT.......................................................................................... 29 CONCAT .................................................................................................................. 29 COS.......................................................................................................................... 29 COSH ....................................................................................................................... 29 DATE........................................................................................................................ 29 DAY .......................................................................................................................... 29 DAYOFMONTH........................................................................................................ 30 DAYOFWEEK .......................................................................................................... 30 DAYOFWEEK_ISO .................................................................................................. 30 DAYOFYEAR ........................................................................................................... 30 DAYS........................................................................................................................ 30 DBCLOB................................................................................................................... 30 DECFLOAT .............................................................................................................. 30 DECFLOAT_SORTKEY........................................................................................... 30 DECIMAL OR DEC.................................................................................................... 30 DECRYPT ................................................................................................................ 31 DEGREES................................................................................................................ 31 DIFFERENCE .......................................................................................................... 31 DIGITS ..................................................................................................................... 31 DOUBLE OR DOUBLE_PRECISION........................................................................ 31 Table of Contents

5

®


DSN_XMLVALIDATE .............................................................................................. 31 EBCDIC_CHR.......................................................................................................... 31 EBCDIC_STR .......................................................................................................... 31 ENCRYPT................................................................................................................ 32 EXP.......................................................................................................................... 32 EXTRACT ................................................................................................................ 32 FLOAT ..................................................................................................................... 32 FLOOR..................................................................................................................... 32 GENERATE UNIQUE .............................................................................................. 32 GETHINT ................................................................................................................. 32 GETVARIABLE........................................................................................................ 32 GRAPHIC................................................................................................................. 32 HEX.......................................................................................................................... 32 HOUR ...................................................................................................................... 33 IDENTITY_VAL_LOCAL() ....................................................................................... 33 IFNULL..................................................................................................................... 33 INSERT.................................................................................................................... 33 INTEGER OR INT ..................................................................................................... 33 JULIAN_DAY ........................................................................................................... 33 LAST_DAY............................................................................................................... 33 LCASE OR LOWER .................................................................................................. 33 LEFT ........................................................................................................................ 33 LENGTH .................................................................................................................. 33 LN ............................................................................................................................ 33 LOCATE................................................................................................................... 33 LOCATE_IN_STRING ............................................................................................. 34 LOG10 ..................................................................................................................... 34 LOWER.................................................................................................................... 34 LPAD........................................................................................................................ 34 LTRIM ...................................................................................................................... 34 MAX ......................................................................................................................... 34 MICROSECOND ..................................................................................................... 34 MIDNIGHT_SECONDS ........................................................................................... 34 MIN .......................................................................................................................... 34 MINUTE ................................................................................................................... 34 MOD......................................................................................................................... 34 MONTH.................................................................................................................... 34 MONTHS_BETWEEN ............................................................................................. 34 NEXT_DAY .............................................................................................................. 35 NORMALIZE_DECFLOAT....................................................................................... 35 NORMALIZE_STRING ............................................................................................ 35 NULLIF..................................................................................................................... 35 OVERLAY ................................................................................................................ 35 6

Table of Contents

®


POSITION ................................................................................................................ 35 POSSTR................................................................................................................... 35 POWER.................................................................................................................... 35 QUANTIZE ............................................................................................................... 35 QUARTER................................................................................................................ 35 RADIANS ................................................................................................................. 35 RAISE_ERROR ....................................................................................................... 35 RAND ....................................................................................................................... 35 REAL ........................................................................................................................ 36 REPEAT ................................................................................................................... 36 REPLACE................................................................................................................. 36 RID ........................................................................................................................... 36 RIGHT ...................................................................................................................... 36 ROUND .................................................................................................................... 36 ROUND_TIMESTAMP ............................................................................................. 36 ROWID ..................................................................................................................... 36 RPAD ....................................................................................................................... 36 RTRIM ...................................................................................................................... 36 SECOND .................................................................................................................. 36 SIGN......................................................................................................................... 36 SIN ........................................................................................................................... 36 SINH......................................................................................................................... 36 SMALLINT................................................................................................................ 36 SOUNDEX................................................................................................................ 37 SOAPHTTPC AND SOAPHTTPV.............................................................................. 37 SPACE ..................................................................................................................... 37 SQRT ....................................................................................................................... 37 STRIP....................................................................................................................... 37 SUBSTR................................................................................................................... 37 SUBSTRING ............................................................................................................ 37 TAN .......................................................................................................................... 37 TANH........................................................................................................................ 37 TIME......................................................................................................................... 37 TIMESTAMP ............................................................................................................ 37 TIMESTAMPADD..................................................................................................... 38 TIMESTAMP_FORMAT ........................................................................................... 38 TIMESTAMP_ISO .................................................................................................... 38 TIMESTAMPDIFF .................................................................................................... 38 TOTALORDER......................................................................................................... 38 TRANSLATE ............................................................................................................ 38 TRUNCATE.............................................................................................................. 38 TRUNC_TIMESTAMP.............................................................................................. 38 UCASE OR UPPER................................................................................................... 38 Table of Contents

7

®


UNICODE ................................................................................................................ 38 UNICODE_STR ....................................................................................................... 38 VALUE ..................................................................................................................... 38 VARBINARY ............................................................................................................ 38 VARCHAR ............................................................................................................... 39 VARCHAR_FORMAT .............................................................................................. 39 VARGRAPHIC ......................................................................................................... 39 WEEK ...................................................................................................................... 39 WEEK_ISO .............................................................................................................. 39 XMLATTRIBUTES ................................................................................................... 39 XMLCOMMENT ....................................................................................................... 40 XML2CLOB.............................................................................................................. 40 XMLCONCAT .......................................................................................................... 40 XMLDOCUMENT..................................................................................................... 40 XMLELEMENT ........................................................................................................ 40 XMLFOREST ........................................................................................................... 40 XMLNAMESPACE................................................................................................... 40 XMLPARSE ............................................................................................................. 41 XMLPI ...................................................................................................................... 41 XMLQUERY............................................................................................................. 41 XMLSERIALIZE ....................................................................................................... 41 XMLTEXT ................................................................................................................ 41 YEAR ....................................................................................................................... 41

QUERIES.............................................................................42 SUBSELECT ................................................................................................................ 42

select-clause ........................................................................................................ 42

FULLSELECT ............................................................................................................... 44

STATEMENTS.....................................................................46 ALLOCATE CURSOR.............................................................................................. 46 ALTER DATABASE ................................................................................................. 46 ALTER FUNCTION (EXTERNAL) ............................................................................... 46 ALTER FUNCTION (SQL SCALAR) ........................................................................... 48 ALTER INDEX.......................................................................................................... 49 ALTER PROCEDURE (EXTERNAL) ........................................................................... 50 ALTER PROCEDURE (SQL - EXTERNAL)................................................................. 51 ALTER PROCEDURE (SQL - NATIVE)...................................................................... 52 ALTER SEQUENCE ................................................................................................ 52 ALTER STOGROUP................................................................................................ 53 ALTER TABLE ......................................................................................................... 53 ALTER TABLESPACE............................................................................................. 58 8

Table of Contents

®


ALTER TRUSTED CONTEXT.................................................................................. 59 ALTER VIEW............................................................................................................ 60 ASSOCIATE LOCATORS ........................................................................................ 60 BEGIN DECLARE SECTION ................................................................................... 60 CALL ........................................................................................................................ 60 CLOSE ..................................................................................................................... 61 COMMENT ON ........................................................................................................ 61 COMMIT................................................................................................................... 62 CONNECT (TYPE 1 OR TYPE 2)................................................................................. 62 CREATE ALIAS........................................................................................................ 62 CREATE AUXILIARY TABLE................................................................................... 62 CREATE DATABASE............................................................................................... 63 CREATE FUNCTION (EXTERNAL SCALAR) ................................................................ 63 CREATE FUNCTION(EXTERNAL TABLE).................................................................... 65 CREATE FUNCTION (SOURCED).............................................................................. 67 CREATE FUNCTION (SQL SCALAR) ........................................................................ 69 CREATE GLOBAL TEMPORARY TABLE ............................................................... 70 CREATE INDEX....................................................................................................... 71 CREATE PROCEDURE (EXTERNAL) ........................................................................ 73 CREATE PROCEDURE (SQL - EXTERNAL) .............................................................. 75 CREATE PROCEDURE (SQL-NATIVE)..................................................................... 77 CREATE ROLE ........................................................................................................ 80 CREATE SEQUENCE.............................................................................................. 80 CREATE STOGROUP ............................................................................................. 81 CREATE SYNONYM................................................................................................ 81 CREATE TABLE ...................................................................................................... 81 CREATE TABLESPACE .......................................................................................... 85 CREATE TRIGGER ................................................................................................. 86 CREATE TRUSTED CONTEXT............................................................................... 87 CREATE TYPE ........................................................................................................ 87 CREATE VIEW......................................................................................................... 88 DECLARE CURSOR................................................................................................ 88 DECLARE GLOBAL TEMPORARY TABLE ............................................................. 89 DECLARE STATEMENT.......................................................................................... 91 DECLARE TABLE .................................................................................................... 91 DECLARE VARIABLE.............................................................................................. 91 DELETE ................................................................................................................... 91 DESCRIBE CURSOR .............................................................................................. 92 DESCRIBE INPUT ................................................................................................... 92 DESCRIBE OUTPUT ............................................................................................... 93 DESCRIBE PROCEDURE ....................................................................................... 93 DESCRIBE TABLE................................................................................................... 93 DROP ....................................................................................................................... 93 Table of Contents

9

®


END DECLARE SECTION....................................................................................... 94 EXCHANGE............................................................................................................. 94 EXECUTE ................................................................................................................ 94 EXECUTE IMMEDIATE ........................................................................................... 95 EXPLAIN.................................................................................................................. 95 FETCH ..................................................................................................................... 95 FREE LOCATOR ..................................................................................................... 96 GET DIAGNOSTICS................................................................................................ 96 GRANT .................................................................................................................... 97 GRANT (COLLECTION PRIVILEGES)............................................................................. 97 GRANT (DATABASE PRIVILEGES)................................................................................ 98 GRANT (TYPE OR JAR PRIVILEGES)........................................................................... 98 GRANT (FUNCTION OR PROCEDURE PRIVILEGES)........................................................ 98 GRANT (PACKAGE PRIVILEGES) ................................................................................. 99 GRANT (PLAN PRIVILEGES)...................................................................................... 100 GRANT (SCHEMA PRIVILEGES)................................................................................. 100 GRANT (SEQUENCE PRIVILEGES)............................................................................. 100 GRANT (SYSTEM PRIVILEGES) ................................................................................. 100 GRANT (TABLE OR VIEW PRIVILEGES)....................................................................... 101 GRANT (USE PRIVILEGES) ....................................................................................... 101 HOLD LOCATOR................................................................................................... 101 INCLUDE ............................................................................................................... 102 INSERT.................................................................................................................. 102 LABEL ON.............................................................................................................. 103 LOCK TABLE......................................................................................................... 103 MERGE.................................................................................................................. 103 OPEN..................................................................................................................... 105 PREPARE.............................................................................................................. 105 REFRESH TABLE ................................................................................................. 106 RELEASE .............................................................................................................. 106 RELEASE SAVEPOINT......................................................................................... 106 RELEASE (CONNECTION)........................................................................................ 107 RENAME................................................................................................................ 107 REVOKE ................................................................................................................ 107 REVOKE (COLLECTION PRIVILEGES) ........................................................................ 107 REVOKE (DATABASE PRIVILEGES) ........................................................................... 107 REVOKE (TYPE OR JAR PRIVILEGES) ...................................................................... 108 REVOKE (FUNCTION OR PROCEDURE PRIVILEGES) ................................................... 108 REVOKE (PACKAGE PRIVILEGES)............................................................................. 109 REVOKE (PLAN PRIVILEGES) ................................................................................... 110 REVOKE (SCHEMA PRIVILEGES) .............................................................................. 110 REVOKE (SEQUENCE PRIVILEGES) .......................................................................... 110 REVOKE (SYSTEM PRIVILEGES)............................................................................... 110 10

Table of Contents

®


REVOKE (TABLE OR VIEW PRIVILEGES)..................................................................... 111 REVOKE (USE PRIVILEGES) ..................................................................................... 111 ROLLBACK ............................................................................................................ 112 SAVEPOINT........................................................................................................... 112 SELECT INTO ........................................................................................................ 112 SET CONNECTION ............................................................................................... 112 SET CURRENT APPLICATION ENCODING SCHEME ........................................ 112 SET CURRENT DEBUG MODE............................................................................. 113 SET CURRENT DECFLOAT ROUNDING MODE.................................................. 113 SET CURRENT DEGREE...................................................................................... 113 SET CURRENT LOCALE LC_CTYPE ................................................................... 113 SET CURRENT MAITAINED TABLE TYPES FOR OPTIMIZATION ..................... 113 SET CURRENT OPTIMIZATION HINT .................................................................. 113 SET CURRENT PACKAGE PATH ......................................................................... 114 SET CURRENT PACKAGESET............................................................................. 114 SET CURRENT PRECISION ................................................................................. 114 SET CURRENT REFRESH AGE ........................................................................... 114 SET CURRENT RULES ......................................................................................... 114 SET CURRENT ROUTINE VERSION.................................................................... 114 SET CURRENT SQLID .......................................................................................... 114 SET ENCRYPTION PASSWORD.......................................................................... 114 SET HOST VARIABLE ASSIGNMENT .................................................................. 115 SET PATH .............................................................................................................. 115 SET SCHEMA ........................................................................................................ 115 SET TRANSITION VARIABLE ............................................................................... 115 SIGNAL SQLSTATE .............................................................................................. 116 TRUNCATE............................................................................................................ 116 UPDATE................................................................................................................. 116 VALUES ................................................................................................................. 117 VALUES INTO........................................................................................................ 117 WHENEVER........................................................................................................... 118

COMMANDS......................................................................119 -ACCESS DATBASE(DB2) .................................................................................... 119 -ALTER BUFFERPOOL ......................................................................................... 119 -ALTER GROUPBUFFERPOOL ............................................................................ 119 -ALTER UTILITY .................................................................................................... 120 -ARCHIVE LOG...................................................................................................... 120 -BIND PACKAGE ................................................................................................... 120 -BIND PLAN ........................................................................................................... 121 -CANCEL THREAD................................................................................................ 123 CHANGE IMS......................................................................................................... 123 DCLGEN ................................................................................................................ 123 Table of Contents

11

®


DISPLAY IMS......................................................................................................... 123 -DISPLAY ARCHIVE.............................................................................................. 124 -DISPLAY BUFFERPOOL ..................................................................................... 124 -DISPLAY DATABASE .......................................................................................... 124 -DISPLAY DDF ...................................................................................................... 125 -DISPLAY FUNCTION SPECIFIC.......................................................................... 125 -DISPLAY GROUP ................................................................................................ 126 -DISPLAY GROUPBUFFERPOOL........................................................................ 126 -DISPLAY LOCATION ........................................................................................... 126 -DISPLAY LOG ...................................................................................................... 126 -DISPLAY PROCEDURE....................................................................................... 126 -DISPLAY PROFILE .............................................................................................. 127 -DISPLAY RLIMIT.................................................................................................. 127 -DISPLAY THREAD............................................................................................... 127 -DISPLAY TRACE ................................................................................................. 127 -DISPLAY UTILITY ................................................................................................ 129 DSN TSO ............................................................................................................... 129 DSNC (CICS ATTACHMENT FACILITY)....................................................................... 130 DSNC DISCONNECT (CICS ATTACHMENT FACILITY) .............................................. 130 DSNC DISPLAY (CICS ATTACHMENT FACILITY)....................................................... 130 DSNC MODIFY(CICS ATTACHMENT FACILITY)......................................................... 130 DSNC STOP (CICS ATTACHMENT FACILITY) ............................................................ 130 DSNC START (CICS ATTACHMENT FACILITY) .......................................................... 130 DSNH (TSO CLIST) ............................................................................................... 130 END ....................................................................................................................... 130 FREE PACKAGE ................................................................................................... 130 FREE PLAN ........................................................................................................... 131 MODIFY ADMTPROC, APPL=SHUTDOWN ............................................................. 131 MODIFY ADMTPROC, APPL=SHUTDOWN ............................................................. 131 MODIFY IRLMPROC, ABEND............................................................................... 131 MODIFY IRLMPROC, DIAG .................................................................................. 131 MODIFY IRLMPROC, PURGE .............................................................................. 131 MODIFY IRLMPROC, SET .................................................................................... 131 MODIFY IRLMPROC, STATUS ............................................................................. 131 -MODIFY TRACE (DB2) ........................................................................................ 132 REBIND PACKAGE ............................................................................................... 133 REBIND PLAN ....................................................................................................... 133 REBIND TRIGGER PACKAGE.............................................................................. 135 -RECOVER BSDS ................................................................................................. 135 -RECOVER INDOUBT........................................................................................... 135 -RECOVER POSTPONED .................................................................................... 135 -REFRESH DB2, EARLY ....................................................................................... 135 -RESET GENERICLU............................................................................................ 135 12

Table of Contents

®


-RESET INDOUBT ................................................................................................. 136 RUN........................................................................................................................ 136 -SET ARCHIVE ...................................................................................................... 136 -SET LOG............................................................................................................... 136 -SET SYSPARM..................................................................................................... 136 SPUFI..................................................................................................................... 136 /SSR ....................................................................................................................... 137 /START IMS ........................................................................................................... 137 -START DATABASE .............................................................................................. 137 -START DB2........................................................................................................... 137 -START DDF .......................................................................................................... 138 -START FUNCTION SPECIFIC ............................................................................. 138 -START ADMTPROC ................................................................................................. 138 -START IRLMPROC .................................................................................................. 138 -START PROCEDURE .......................................................................................... 138 -START PROFILE .................................................................................................. 139 -START RLIMIT...................................................................................................... 139 -START TRACE ..................................................................................................... 139 STOP...................................................................................................................... 141 STOP ADMTPROC .................................................................................................... 141 -STOP DATABASE ................................................................................................ 141 -STOP DB2............................................................................................................. 142 -STOP DDF ............................................................................................................ 142 -STOP FUNCTION SPECIFIC ............................................................................... 142 STOP IRLMPROC ..................................................................................................... 142 -STOP PROCEDURE ............................................................................................ 142 -STOP PROFILE .................................................................................................... 142 -STOP RLIMIT........................................................................................................ 143 -STOP TRACE ....................................................................................................... 143 -TERM UTILITY...................................................................................................... 145 TRACE IMS ............................................................................................................ 145 TRACE CT.............................................................................................................. 145

SQL CONTROL STATEMENTS........................................146 SQL CONTROL STATEMENT ...................................................................................... 146 ASSIGNMENT ............................................................................................................ 146 CALL ...................................................................................................................... 146 CASE...................................................................................................................... 146 COMPOUND .............................................................................................................. 146 IF ............................................................................................................................ 147 GET DIAGNOSTICS .............................................................................................. 148 GOTO..................................................................................................................... 148 LEAVE.................................................................................................................... 148 Table of Contents

13

®


LOOP ..................................................................................................................... 148 REPEAT................................................................................................................. 148 WHILE.................................................................................................................... 148 SQL PROCEDURE STATEMENT .................................................................................. 148

PLAN TABLE ....................................................................149 DSN_PREDICAT_TABLE .................................................155 DSN_STRUCT_TABLE .....................................................157 DSN_PGROUP_TABLE ....................................................158 DSN_PTASK_TABLE .......................................................159 DSN_FILTER_TABLE .......................................................160 DSN_DETCOST_TABLE ..................................................161 DSN_SORT_TABLE .........................................................162 DSN_SORTKEY_TABLE ..................................................163 DSN_PGRANGE_TABLE .................................................164 DSN_VIEWREF_TABLE ...................................................165 DSN_QUERY_TABLE.......................................................165 DSN_STATEMNT_TABLE ................................................167 DSN_FUNCTION_TABLE .................................................169 DSN_STATEMENT_CACHE_TABLE...............................170 DSNZPARMS ....................................................................172 14

Table of Contents

®


BIND PARAMETERS ........................................................179 DB2 LIMITS .......................................................................182 IDENTIFIER LENGTH LIMITS ........................................................................................ 182 NUMERIC LIMITS ....................................................................................................... 182 STRING LENGTH LIMITS ............................................................................................ 183 DATETIME LIMITS ...................................................................................................... 184 DB2 LIMITS ON SQL STATEMENTS ............................................................................ 184 DB2 SYSTEM LIMITS ................................................................................................. 186

SQL COMMUNICATION AREA (SQLCA) ........................187 THE REXX SQLCA............................................................190 GET DIAGNOSTICS..........................................................192 STATEMENT INFORMATION ........................................................................................ 192 CONDITIONAL DATA TYPES ....................................................................................... 193 CONNECTION INFORMATION ...................................................................................... 194

PREDICATES ....................................................................195 IFCIDS ...............................................................................197 EXCEPTIONS ....................................................................209 DETERMINING PARTITION FROM PAGE NUMBER ......212 CATALOG TABLES ..........................................................214 SYSIBM.IPLIST...................................................................................................... 214 SYSIBM.IPNAMES ................................................................................................ 214 SYSIBM.LOCATIONS............................................................................................ 216 SYSIBM.LULIST .................................................................................................... 217 SYSIBM.LUMODES............................................................................................... 217 SYSIBM.LUNAMES ............................................................................................... 218 SYSIBM.MODESELECT........................................................................................ 219 SYSIBM.SYSAUXRELS......................................................................................... 220 SYSIBM.SYSCHECKDEP ..................................................................................... 220 SYSIBM.SYSCHECKS .......................................................................................... 220 Table of Contents

15

®


SYSIBM.SYSCHECKS2 ........................................................................................ 221 SYSIBM.SYSCOLAUTH........................................................................................ 221 SYSIBM.SYSCOLDIST ......................................................................................... 222 SYSIBM.SYSCOLDIST_HIST ............................................................................... 223 SYSIBM.SYSCOLDISTSTATS.............................................................................. 224 SYSIBM.SYSCOLSTATS ...................................................................................... 225 SYSIBM.SYSCOLUMNS ....................................................................................... 226 SYSIBM.SYSCOLUMNS_HIST............................................................................. 232 SYSIBM.SYSCONSTDEP ..................................................................................... 234 SYSIBM.SYSCONTEXT........................................................................................ 234 SYSIBM.SYSCONTEXTAUTHIDS........................................................................ 235 SYSIBM.SYSCOPY............................................................................................... 236 SYSIBM.SYSCTXTTRUSTATTRS........................................................................ 240 SYSIBM.SYSDATABASE...................................................................................... 241 SYSIBM.SYSDATATYPES.................................................................................... 242 SYSIBM.SYSDBAUTH .......................................................................................... 243 SYSIBM.SYSDBRM .............................................................................................. 245 SYSIBM.SYSDEPENDENCIES............................................................................. 246 SYSIBM.SYSDUMMY1 ......................................................................................... 247 SYSIBM.SYSENVIRONMENT .............................................................................. 247 SYSIBM.SYSFIELDS ............................................................................................ 248 SYSIBM.SYSFOREIGNKEYS ............................................................................... 249 SYSIBM.SYSINDEXES ......................................................................................... 249 SYSIBM.SYSINDEXES_HIST ............................................................................... 253 SYSIBM.SYSINDEXPART .................................................................................... 253 SYSIBM.SYSINDEXPART_HIST .......................................................................... 256 SYSIBM.SYSINDEXSPACESTATS ...................................................................... 257 SYSIBM.SYSINDEXSTATS .................................................................................. 260 SYSIBM.SYSINDEXSTATS_HIST ........................................................................ 260 SYSIBM.SYSJARCLASS_SOURCE..................................................................... 261 SYSIBM.SYSJARCONTENTS .............................................................................. 261 SYSIBM.SYSJARDATA......................................................................................... 261 SYSIBM.SYSJAROBJECTS.................................................................................. 262 SYSIBM.SYSJAVAOPTS ...................................................................................... 262 SYSIBM.SYSJAVAPATHS .................................................................................... 262 SYSIBM.SYSKEYCOLUSE ................................................................................... 263 SYSIBM.SYSKEYS ............................................................................................... 263 SYSIBM.SYSKEYTARGETS................................................................................. 263 SYSIBM.SYSKEYTARGETSTATS ....................................................................... 265 SYSIBM.SYSKEYTARGETS_HIST ...................................................................... 265 SYSIBM.SYSKEYTGTDIST .................................................................................. 266 SYSIBM.SYSKEYTGTDISTSTATS....................................................................... 267 SYSIBM.SYSKEYTGTDIST_HIST ........................................................................ 268 16

Table of Contents

®


SYSIBM.SYSLOBSTATS....................................................................................... 269 SYSIBM.SYSLOBSTATS_HIST ............................................................................ 270 SYSIBM.SYSOBJROLEDEP ................................................................................. 270 SYSIBM.SYSPACKAGE ........................................................................................ 271 SYSIBM.SYSPACKAUTH...................................................................................... 276 SYSIBM.SYSPACKDEP ........................................................................................ 277 SYSIBM.SYSPACKLIST ........................................................................................ 278 SYSIBM.SYSPACKSTMT...................................................................................... 278 SYSIBM.SYSPARMS............................................................................................. 280 SYSIBM.SYSPKSYSTEM...................................................................................... 282 SYSIBM.SYSPLAN ................................................................................................ 283 SYSIBM.SYSPLANAUTH ...................................................................................... 287 SYSIBM.SYSPLANDEP......................................................................................... 288 SYSIBM.SYSPLSYSTEM ...................................................................................... 288 SYSIBM.SYSRELS ................................................................................................ 289 SYSIBM.SYSRESAUTH ........................................................................................ 289 SYSIBM.SYSROLES ............................................................................................. 290 SYSIBM.SYSROUTINEAUTH ............................................................................... 291 SYSIBM.SYSROUTINES....................................................................................... 292 SYSIBM.SYSROUTINESTEXT.............................................................................. 298 SYSIBM.SYSROUTINES_OPTS........................................................................... 298 SYSIBM.SYSROUTINES_SRC ............................................................................. 299 SYSIBM.SYSSCHEMAAUTH ................................................................................ 299 SYSIBM.SYSSEQUENCEAUTH ........................................................................... 300 SYSIBM.SYSSEQUENCEDEP.............................................................................. 301 SYSIBM.SYSSEQUENCES................................................................................... 301 SYSIBM.SYSSTMT................................................................................................ 303 SYSIBM.SYSSTOGROUP..................................................................................... 305 SYSIBM.SYSSTRINGS ......................................................................................... 306 SYSIBM.SYSSYNONYMS..................................................................................... 306 SYSIBM.SYSTABAUTH......................................................................................... 307 SYSIBM.SYSTABCONST...................................................................................... 309 SYSIBM.SYSTABLEPART .................................................................................... 309 SYSIBM.SYSTABLEPART_HIST .......................................................................... 312 SYSIBM.SYSTABLES............................................................................................ 314 SYSIBM.SYSTABLES_HIST ................................................................................. 318 SYSIBM.SYSTABLESPACE.................................................................................. 319 SYSIBM.SYSTABLESPACESTATS ...................................................................... 322 SYSIBM.SYSTABSTATS....................................................................................... 325 SYSIBM.SYSTABSTATS_HIST ............................................................................ 326 SYSIBM.SYSTRIGGERS....................................................................................... 326 SYSIBM.SYSUSERAUTH...................................................................................... 327 SYSIBM.SYSVIEWDEP......................................................................................... 329 Table of Contents

17

®


SYSIBM.SYSVIEWS ............................................................................................. 330 SYSIBM.SYSVOLUMES ....................................................................................... 331 SYSIBM.SYSXMLRELS ........................................................................................ 331 SYSIBM.SYSXMLSTRINGS.................................................................................. 331 SYSIBM.SYSUSERNAMES .................................................................................. 332 SYSIBM.XSRCOMPONENT ................................................................................. 332 SYSIBM.XSROBJECTS ........................................................................................ 333 SYSIBM.XSROBJECTCOMPONENTS................................................................. 333 SYSIBM.XSROBJECTGRAMMER........................................................................ 334 SYSIBM.XSROBJECTHIERARCHIES.................................................................. 334 SYSIBM.XRSOBJECTPROPERTY....................................................................... 335 SYSIBM.XSRPROPERTY ..................................................................................... 335

UPDATEABLE CATALOG STATISTICS..........................336 IBM UTILITIES ..................................................................338 BACKUP SYSTEM ................................................................................................ 338 CATENFM.............................................................................................................. 338 CATMAINT............................................................................................................. 338 CHECK DATA ........................................................................................................ 338 CHECK INDEX ...................................................................................................... 339 CHECK LOB .......................................................................................................... 340 COPY..................................................................................................................... 340 COPYTOCOPY ..................................................................................................... 341 DIAGNOSE ............................................................................................................ 342 EXEC SQL ............................................................................................................. 343 LISTDEF ................................................................................................................ 343 LOAD ..................................................................................................................... 344 MERGECOPY........................................................................................................ 349 MODIFY RECOVERY............................................................................................ 349 MODIFY STATISTICS ........................................................................................... 349 OPTIONS............................................................................................................... 350 QUIESCE............................................................................................................... 350 REBUILD INDEX ................................................................................................... 350 RECOVER ............................................................................................................. 351 REORG INDEX ...................................................................................................... 352 REORG TABLESPACE ......................................................................................... 354 REPAIR.................................................................................................................. 358 REPORT ................................................................................................................ 358 RESTORE SYSTEM.............................................................................................. 359 RUNSTATS............................................................................................................ 359 STOSPACE ........................................................................................................... 361 18

Table of Contents

®


TEMPLATE ............................................................................................................ 361 UNLOAD ................................................................................................................ 362

SQL POSITIVE RETURN CODES ....................................367 SQL ERROR RETURN CODES ........................................370 RESOURCE TYPES ..........................................................393

Table of Contents

19

®


DB2 9 for z/OS Language Elements Special registers >>__ _CURRENT APPLICATION ENCODING SCHEME________________________ __>< |_CURRENT CLIENT_ACCTNG______________________________________| |_CURRENT CLIENT_APPLNAME____________________________________| |_CURRENT CLIENT_USERID______________________________________| |_CURRENT CLIENT_WRKSTNNAME__________________________________| |_ _CURRENT DATE____ ________________________________________| | | | | | |_CURRENT_DATE____| | |_CURRENT DEBUG MODE_________________________________________| |_CURRENT DECFLOAT ROUNDING MODE_____________________________| |_CURRENT DEGREE_____________________________________________| | _LOCALE_ | |_ _CURRENT__|________|__LC_CTYPE_ __________________________| | |_CURRENT_LC_CTYPE______________| | | _TABLE_ _FOR OPTIMIZATION_ | |_CURRENT MAINTAINED__|_______|__TYPES__|__________________|_| |_CURRENT MEMBER_____________________________________________| |_CURRENT OPTIMIZATION HINT__________________________________| |_CURRENT PACKAGE PATH_______________________________________| |_CURRENT PACKAGESET_________________________________________| |_ _CURRENT PATH_ ___________________________________________| | |_CURRENT_PATH_| | |_CURRENT PRECISION__________________________________________| |_CURRENT REFRESH AGE________________________________________| |_CURRENT ROUTINE VERSION____________________________________| |_CURRENT RULES______________________________________________| |_ _CURRENT SCHEMA____ ______________________________________| | | | | | |_CURRENT_SCHEMA____| | |_CURRENT SERVER_____________________________________________| |_CURRENT SQLID______________________________________________| |_ _CURRENT TIME____ ________________________________________| | | | | | |_CURRENT_TIME____| | |_ _CURRENT TIMESTAMP____ ___________________________________| | | | | | |_CURRENT_TIMESTAMP____| | |_CURRENT TIMEZONE___________________________________________| |_SESSION_USER_______________________________________________| |_USER______|

Host Variables >__:host-identifier__________________________________________________> | _INDICATOR_ | |__|___________|_:host-identifier_| DB2 UDB V8 for Z/OS

20

®

DB2 V9 for z/OS Reference Guide In PL/I, C, and COBOL, the syntax of host-variable is: >__:______________________host-identifier____________________________> |_host-identifier._| >____________________________________________________________________> | _INDICATOR_ | |__|___________|_:______________________host-identifier_| |_host-identifier._|

Functions >__function-name__(_________________________________________________)_______> |_ALL______| | _TABLE_(function-name(_____________________________))_correlation-clause __> | |_+_| |_(expression)__________| |_-_| |_constant______________| |_column-name___________| |_host-variable_________| |_special-register______| |_(scalar-fullselect)___| |_labeled-duration______| |_case-expression_______| |_cast-specification____| |_sequence-reference____| |_row-change-expression_| |_OLAP-specification____| >____CONCAT____________________________________________________________> |_||_____| |_/______| |_*______| |_+______| |_-______|

Labeled durations >____function-invocation____YEAR___________________________________________> |_(expression)__| |_YEARS________| |_constant______| |_MONTH________| |_column-name___| |_MONTHS_______| |_host-variable_| |_DAY__________| |_DAYS_________| |_HOUR_________| |_HOURS________| |_MINUTE_______| |_MINUTES______| ®

DB2 9 for z/OS

21

®

DB2 9 z/OS Reference Guide |_SECOND_______| |_SECONDS______| |_MICROSECOND__| |_MICROSECONDS_|

CASE expressions _ELSE NULL_______________ >__CASE____searched-when-clause____|_________________________|_______> |_simple-when-clause___| |_ELSE__result-expression_| >__END_______________________________________________________________> searched-when-clause: ____WHEN__search-condition__THEN____result-expression___|___________> |_NULL______________| simple-when-clause: __expression____WHEN__expression__THEN____result-expression___|_____> |_NULL______________|

CAST >__CAST__(____expression__________AS__data-type__)___________________> |_NULL_____________| |_parameter-marker_| data-type: >_________________built-in-data-type_________________________________> |_schema._| |_distinct-type-name_| built-in data-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1 OCTETS)____ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_length__)____| | | |_CCSID__ASCII___| |_FOR___SBCS____DATA_| | | | | | |___CHARACTER__VARYING__(_length__)__| | |_EBCDIC__| |_MIXED_| | | | | | | |_CHAR_____| | | |_UNICODE_| |_BIT___| | | | | | |__VARCHAR____________| |_CCSID_ integer__________________________ _| | | | | _(1M OCTETS)_ | | | |_____CHARACTER___LARGE OBJECT_ |____________|__________________________________________| | | | |_CHAR______| |_(_lob-len_)_| ||_CCSID__ASCII___| |_FOR__SBCS____DATA_| | | |___CLOB______________________| | |_EBCDIC__| |_MIXED_| | | | | |_UNICODE_| |_BIT___| | | | |_CCSID_ integer_______________________ | | | __(1 CODEUNITS16)_ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__length___)____| | |_CCSID___ASCII___| |

22

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide | |_VARGRAPHIC__(__length__)____________| |_EBCDIC__| | | | __(1M CODEUNITS16)_ |_UNICODE_| | | |_DBCLOB_|___________________| |_integer_| | | |_(lob-length)______| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | | | _(1M)____________________ | | | |_BINARY LARGE OBJECT_____|_________________________|_____|_______________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| | |_TIME______| | | |_TIMESTAMP_| | |_ROWID_____________________________________________________________________________________| |_XML_______________________________________________________________________________________|

length: >_integer_______________________________________________________________> |_CODEUNITS16_| |_CODEUNITS32_| |_OCTETS______| Lob-length: >_integer_______________________________________________________________> |_K_| |_CODEUNITS16_| |_M_| |_CODEUNITS32_| |_G_| |_OCTETS______|

NEXT VALUE expression >__NEXT VALUE FOR sequence-name__________________________________________>

PREVIOUS VALUE expression >__PREVIOUS VALUE FOR sequence-name______________________________________>

ROW CHANGE expression >_ROW CHANGE____TIMESTAMP____FOR__table-designator_______________________> |_TOKEN_____|

OLAP >___ranking-specification _______________________________________________> |_numbering-specification_| ranking-specification: >__RANK_________()_OVER_(____________________________window-order-clause_)_> |_DENSE_RANK_| |_window-partition-clause_|

®

DB2 9 for z/OS

23

®

DB2 9 z/OS Reference Guide numbering-specification: >__ROW_NUMBER___()_OVER_(____________________________window-order-clause_)_> |_window-partition-clause_| window-partition-clause: _PARTITION BY__ partition-expression__|___________________________________> window-order-clause: _ORDER BY___sort-key-expression____|________________________|_|__> |_ASC NULLS FIRST_______| | __NULLS FIRST_ | |_DESC_|______________|_| |_DESC NULLS LAST_______|

Predicates >_______basic predicate__________________________________________________> |_quantified predicate_| |_BETWEEN predicate____| |_EXISTS predicate_____| |_IN predicate_________| |_LIKE predicate_______| |_NULL predicate_______| |_XMLEXISTS predicate__|

Basic predicate >>__ _expression_ _=_____ _expression__________________________ _____>< | |_____| | | |______| | | |_=____| | | | |_(row-value-expression)__ _=____ __(row-value-expression)_| |____|

Quantified predicate >>__ _expression__ _=_____ __ _SOME_ __(fullselect1)____ ___________>< | | | |_ANY__| | | |_____| |_ALL__| | | |______| | | |_=____| | |_(row-value-expression)=_ _SOME_ _(fullselect2)____| | |_ANY__| | |_(row-value-expression)_________ALL(fullselect2)_|

BETWEEN predicate >__expression___________BETWEEN__expression__AND__expression____________>< 24

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |_NOT_|

DISTINCT predicate >__expression_IS________DISTINCT FROM__expression_________________________>< | |_NOT_| | |_(row-value-expression)_IS_______DISCTINCT FROM_(row-value-expression)_| |_NOT_|

EXISTS predicate >__EXISTS(fullselect)___________________________________________________>
>__ _expression1__ _____ __IN_ _(fullselect1)_________ __ ___________>< | |_NOT_| | __match-expression___________LIKE__pattern-expression___________________> |_NOT_| >________________________________________________________________________> |_ESCAPE__escape-expression_|

NULL predicate >__expression__IS___________NULL_________________________________________> |_NOT_|

XMLEXISTS >_XMLEXISTS_(_xquery-expression-constant_________________________________> >___________________________________________________)____________________>< | _BY REF_ | |_PASSING_|________|xquery-argument___| xquery-argument >__xquery-context-item-expression________________________________________>< | _____________predicate________________________________)_________________> |_NOT_| |_(search-condition)_| __________________________________________________|_____________________> |___AND_______________predicate____________| |_OR__| |_NOT_| |_(search-condition)_|

®

DB2 9 for z/OS

25

®

DB2 9 z/OS Reference Guide

Column Functions AVG _ALL______ >__AVG(_|__________|_expression)______________________________________> |_DISTINCT_|

CORRELATION >_CORRELATION(expression-1, expression-2)_____________________________>

COUNT _ALL______ >_COUNT(___|__________|__expression___)_______________________________> | |_DISTINCT_| | |_*________________________|

COUNT_BIG _ALL______ >_COUNT_BIG(___|__________|__expression___)___________________________> | |_DISTINCT_| | |_*________________________|

COVARIANCE or COVARIANCE_SAMP >___COVARIANCE_______(expression-1, expression-2)_____________________> |_COVARIANCE_SAMP_|

MAX _ALL______ >__MAX(_|__________|_expression)______________________________________> |_DISTINCT_|

MIN _ALL______ >__MIN(_|__________|_expression)______________________________________> |_DISTINCT_|

STDDEV _ALL______ >__STDDEV(_|__________|_expression)___________________________________> |_DISTINCT_|

STDDEV_SAMP _ALL______ >__STDDEV_SAMP(_|__________|_expression)______________________________> |_DISTINCT_|

SUM _ALL______ >__SUM(_|__________|_expression)______________________________________> |_DISTINCT_|

26

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide

VARIANCE or VARIANCE SAMP _ALL______ >_____VARIANCE_______(_|__________|_expression)____________________________> |_VARIANCE_SAMP_| |_DISTINCT_|

XMLAGG >____XMLAGG(XML-expression_______________________________________________)_> | ________column-name______________________________________________________>< |_expression_|

Scalar functions ABS >__ABS(numeric-expression)_____________________________________________>

ACOS >__ACOS(numeric-expression)____________________________________________>

ADD_MONTHS >__ADD_MONTHS(expression,numeric-expression)___________________________>

ASCII >_ASCII(string-expression)_____________________________________________>

ASCII_CHR >_ASCII_CHR(expression)________________________________________________>

ASCII_STR >_ASCII_CHR(string-expression)_________________________________________>

ASIN >__ASIN(numeric-expression)____________________________________________>

ATAN >__ATAN(numeric-expression)____________________________________________>

ATANH >__ATANH(numeric-expression)__________________________________________>

ATAN2 >__ATAN2(numeric-expression1,numeric-expression2)______________________>

BIGINT Numeric to Big Integer: >_BIGINT(numeric-expression___________________________________________> ®

DB2 9 for z/OS

27

®

DB2 9 z/OS Reference Guide String to Big Integer: >_BIGINT(string-expression_____________________________________________>

BLOB >__BLOB(expression________________)____________________________________> |_,__integer_|

BINARY >_BINARY(string-expression________________)____________________________> |_,_integer_|

CCSID_ENCODING >__CCSID_ENCODING(expression)__________________________________________>

CEILING >__CEILING_______(__expression__)______________________________________>

CHAR Datetime to Character: >__CHAR(datetime-expression__________________)_________________________> |_,____ISO_____| |_USA___| |_EUR___| |_JIS___| |_LOCAL_| Character to Character: >__CHAR(character-expression_______________________________)___________> |_,_integer__________________| |_,|_CODEUNITS16_| |_CODEUNITS32_| |_OCTETS______| Graphic to Character: >__CHAR(graphic-expression__________________________________)__________> |_,_integer__________________| |_,|_CODEUNITS16_| |_CODEUNITS32_| Integer to Character: >__CHAR(integer-expression)___________________________________________> Decimal to Character: >__CHAR(decimal-expression__________________________)_________________> |_,__decimal-character_| Decimal floating-Point to Character: >__CHAR(decimal-floating-point-expression)____________________________> Floating-Point to Character: >__CHAR(floating-point-expression)____________________________________> Row ID to Character: >__CHAR(row-ID-expression)____________________________________________> 28

®

DB2 9 for z/OS

®


CHARACTER_LENGTH Character sting: >__CHARACTER_LENGTH(character-expression__,_ CODEUNITS16_____)________> |_CODEUNITS32_| |_OCTETS______| Graphic string: >__CHARACTER_LENGTH(graphic-expression__,___CODEUNITS16_____)__________> |_CODEUNITS32_|

CLOB Character to CLOB: >__CLOB(character-expression_______________________________)__________> |_,_integer__________________| |_,|_CODEUNITS16_| |_CODEUNITS32_| |_OCTETS______| GRAPHIC to CLOB: >__CLOB(graphic-expression__________________________________)_________> |_,_integer__________________| |_,|_CODEUNITS16_| |_CODEUNITS32_|

COALESCE _____COALESCE___(expression__,expression|_)__________________________>

COLLATION_KEY >__COLLATION_KEY(string-expression, collation-name______________)_____> |_,integer_|

COMPARE_DECFLOAT >__COMPAR_DECFLOAT(decfloat-expression1,decfloat-expression2__________>

CONCAT >_____CONCAT____(expression1,expression2)_____________________________> |_"||"____|

COS >__COS(numeric-expression)____________________________________________>

COSH >__COSH(numeric-expression)___________________________________________>

DATE >__DATE(expression)___________________________________________________>

DAY >__DAY(expression)____________________________________________________>

®

DB2 9 for z/OS

29

®


DAYOFMONTH >__DAYOFMONTH(expression)____________________________________________>

DAYOFWEEK >__DAYOFWEEK(expression)_____________________________________________>

DAYOFWEEK_ISO >__DAYOFWEEK_ISO(expression)_________________________________________>

DAYOFYEAR >__DAYOFYEAR(expression)_____________________________________________>

DAYS >__DAYS(expression)__________________________________________________>

DBCLOB Character to DBCLOB: >__DBCLOB(character-expression_______________________________)_______> |_,_integer__________________| |_,|_CODEUNITS16_| |_CODEUNITS32_| GRAPHIC to DBCLOB >__DBCLOB(graphic-expression________________________________)________> |_,_integer__________________| |_,|_CODEUNITS16_| |_CODEUNITS32_|

DECFLOAT numeric to DECFLOAT: _,34_ >__DEC_FLOAT _(_numeric-expression__|_____|______________________)___> |_,16_| string to DECFLOAT: _,34_ >__DEC_FLOAT _(_string-expression___|_____|______________________)___> |_,16_|

DECFLOAT_SORTKEY >_DECFLOAT_SORTKEY_ (_decfloat-expression_)__________________________>

DECIMAL or DEC Numeric to decimal: >_____DECIMAL___(___numeric-expression________________________)______> |_DEC_____| |_precision_________| |_scale_| String to decimal: >_DECIMAL_(string-expression___________________________________)_____> |_DEC__| |_,precision_____________________| |_,scale____________| |_,decimal-char_| 30

®

DB2 9 for z/OS

®


DECRYPT >>___ _DECRYPT_BINARY_________(encrypted-expression ____________________> |_DECRYPT_BIT__| |_DECRYPT_CHAR_| |_DECRYPT_DB___| >_____ ______________________________________________________ _)________>< |_,_ _password-string-expression_ _ ___________________| |_DEFAULT____________________| |_,__ccsid-constant_|

DEGREES >__DEGREES(expression)___________________________________________________>

DIFFERENCE >__DIFFERENCE(expression1, expression2)__________________________________>

DIGITS >__DIGITS(expression)____________________________________________________>

DOUBLE or DOUBLE_PRECISION >__DOUBLE_________________(___numeric-expression___)_____________________> |_DOUBLE_PRECISION_| |_string-expression__|

DSN_XMLVALIDATE CLOB input with an XML schema name: >__DSN_XMLVALIDATE(clob-expression, varchar-expression___)_______________> CLOB input with namespace and location hint URIs: >__DSN_XMLVALIDATE(clob-expression,varchar-expression1, varcharexpression1)__> BLOB input with an XML schema name: >__DSN_XMLVALIDATE(blob-expression, varchar-expression___)_______________> BLOB input with namespace and location hint URIs: >__DSN_XMLVALIDATE(blob-expression,varchar-expression1, varcharexpression1)__> Varchar input with an XML schema name: >__DSN_XMLVALIDATE(varchar-expression, varchar-expression___)____________> Varchar input with namespace and location hint URIs: >_DSN_XMLVALIDATE(varhchar-expression1,varchar-expression2,varcharexpressn3)_>

EBCDIC_CHR >>__EBCDIC(expression)__________________________________________________>

EBCDIC_STR >>__EBCDIC_STR(string-expression)_______________________________________>

®

DB2 9 for z/OS

31

®


ENCRYPT >>__ENCRYPT_TDES(data-string-expression_______________________________> >______________________________________________________ _)____________>< |_,password-string-expression,hint-string-expression_|

EXP >__EXP(numeric-expression)___________________________________________>

EXTRACT Extract date values: >__EXTRACT(__YEAR____)_FROM__date-expression_________)_______________> |_MONTH_| |_timestamp-expression_| |_DAY___| Extract time values: >__EXTRACT(___HOUR____)_FROM__time-expression_________)______________> |_MINUTE_| |_timestamp-expression_| |_SECOND_|

FLOAT >__FLOAT(numeric-expression)_________________________________________>

FLOOR >__FLOOR(numeric-expression)_________________________________________>

GENERATE UNIQUE >__GENERATE_UNIQUE()_________________________________________________>

GETHINT >__GETHINT(encrypted-data)___________________________________________>

GETVARIABLE >__GETVARIABLE(string-constant_ _____________________________________> |_,__default-value_________________| |_,__CAST_(_NULL AS_VARCHAR(1)_)___|

GRAPHIC Character to Graphic: >__GRAPHIC(character-expression__________________________________)___> |_,_integer____________________| |_,_CODEUNITS16___| |_CODEUNITS32_| Graphic to Graphic: >__GRAPHIC(graphic-expression___________________________________)____> |_,_integer____________________| |_,_CODEUNITS16___| |_CODEUNITS32_|

HEX >__HEX(expression)___________________________________________________>

32

®

DB2 9 for z/OS

®


HOUR >__HOUR(expression)__________________________________________________>

IDENTITY_VAL_LOCAL() >__IDENTITY_VAL_LOCAL()______________________________________________>

IFNULL >__IFNULL(expression,expression)_____________________________________>

INSERT >_INSERT(source-string,start,length,insert-string___________________)_> |_,_CODEUNITS16___| |_CODEUNITS32_| |_OCTETS______|

INTEGER or INT >_____INTEGER___(___numeric-expression___)___________________________> |_INT_____| |_string-expression__|

JULIAN_DAY >__JULIAN_DAY(expression)____________________________________________>

LAST_DAY >__LAST_DAY(date-expression)_________________________________________>

LCASE or LOWER >_____LCASE___(expression)___________________________________________> |_LOWER_|

LEFT Character string: >_LEFT(character-expression,length ____________________)_____________> |_,_CODEUNITS16___| |_CODEUNITS32_| |_OCTETS______| Graphic string: >_LEFT(graphic-expression,length ____________________)_______________> |_,_CODEUNITS16___| |_CODEUNITS32_| Binary string: >_LEFT(binary-expression,length ____________________)________________> |_,_CODEUNITS16___| |_CODEUNITS32_|

LENGTH >__LENGTH(expression)________________________________________________>

LN >__LN(numeric-expression)____________________________________________>

LOCATE >_LOCATE(search-string,source-string_____________)___________________> |_,_start_| |_,_CODEUNITS16___| ®

DB2 9 for z/OS

33

®

DB2 9 z/OS Reference Guide |_CODEUNITS32_| |_OCTETS______|

LOCATE_IN_STRING >_LOCATE(source-string,search-string_________________________________> |_,_start_______________| |_,instance_| >_________________________________________________)__________________>< |_,_CODEUNITS16___| |_CODEUNITS32_| |_OCTETS______|

LOG10 >__LOG10(numeric-expression)_________________________________________>

LOWER >__LOWER(string-expression__________________________________)________> |_,_locale-name_| |_,_integer_|

LPAD >__LPAD(string-expression,integer____________)_______________________> |_,_pad_|

LTRIM >__LTRIM(string-expression)__________________________________________>

MAX __MAX(expression, expression_|_)____________________________________>

MICROSECOND >__MICROSECOND(expression)___________________________________________>

MIDNIGHT_SECONDS >__MIDNIGHT_SECONDS(expression)______________________________________>

MIN __MIN(expression, expression_|_)____________________________________>

MINUTE >__MINUTE(expression)________________________________________________>

MOD >__MOD(numeric-expression1,numeric-expression2)______________________>

MONTH >__MONTH(expression)_________________________________________________>

MONTHS_BETWEEN >__MONTHS_BETWEEN(expression1,expression2)___________________________>

34

®

DB2 9 for z/OS

®


NEXT_DAY >__NEXT_DAY(expression,string-expression)____________________________>

NORMALIZE_DECFLOAT >__NORMALIZE_DECFLOAT(decfloat-expression)___________________________>

NORMALIZE_STRING _NFC__ >__NORMALIZE_STRING(unicode-string,_|_NFD__|______________)__________> |_NFKC_| |_,_integer_| |_NFKD_|

NULLIF >__NULLIF(expression,expression)_____________________________________>

OVERLAY >_OVERLAY(source-string______________________________________________> >_PLACING_insert-string_FROM_start_____________ USING__CODEUNITS16__)> | |_FOR length_| |_CODEUNITS32_|| | |_OCTETS______|| |,_insert-string, start__________________,_____CODEUNITS16________| |_,_length_| |_CODEUNITS32_| |_OCTETS______|

POSITION >_POSTITION(search-string,source-string_,_ CODEUNITS16__)____________> |_CODEUNITS32_| |_OCTETS______|

POSSTR >__POSSTR(source-string,search-string)_______________________________>

POWER >__POWER(numeric-expression1,numeric-expression2)____________________>

QUANTIZE >__QUANTIZE(numeric-expression,exp-expression)_______________________>

QUARTER >__QUARTER(expression)_______________________________________________>

RADIANS >__RADIANS(numeric-expression)_______________________________________>

RAISE_ERROR >__RAISE_ERROR(sqlstate,diagnostic-string)___________________________>

RAND >__RAND(________________)____________________________________________> |_expression_|

®

DB2 9 for z/OS

35

®


REAL >__REAL(___numeric-expression___)____________________________________> |_string-expression__|

REPEAT >__REPEAT(string-expression,integer)_________________________________>

REPLACE >__REPLACE(source-string, search-string, replace-string)_____________>

RID >__RID(table-designator)_____________________________________________>

RIGHT >__RIGHT(string-expression,length)___________________________________> |_,_CODEUNITS16___| |_CODEUNITS32_| |_OCTETS______|

ROUND >__ROUND(numeric-expression1,numeric-expression2)____________________>

ROUND_TIMESTAMP >__ROUND_TIMESTAMP(timestamp-expression_ ________________ _)_________> |_,format-string_|

ROWID >__ROWID(expression)_________________________________________________>

RPAD >__RPAD(string-expression,integer____________)_______________________> |_,_pad_|

RTRIM >__RTRIM(string-expression)__________________________________________>

SECOND >__SECOND(expression)________________________________________________>

SIGN >__SIGN(numeric-expression)__________________________________________>

SIN >__SIN(numeric-expression)___________________________________________>

SINH >__SINH(numeric-expression)__________________________________________>

SMALLINT >__SMALLINT(___numeric-expression___)________________________________> |_string-expression__|

36

®

DB2 9 for z/OS

®


SOUNDEX >__SOUNDEX(expression)_______________________________________________>

SOAPHTTPC and SOAPHTTPV >__SOAPHTTPC___(endpoint_url, soap_action, soap_body)________________> |_SOAPHTTPV_|

SPACE >__SPACE(numeric-expression)_________________________________________>

SQRT >__SQRT(numeric-expression)__________________________________________>

STRIP >__STRIP__(__string-expression____________________________________)__> |___,BOTH_____________________________| |_,B________| |_,strip-character_| |_,LEADING__| |_,L________| |_,TRAILING_| |_,T________|

SUBSTR >__SUBSTR(string-expression,start_____________)______________________> |_,length_|

SUBSTRING Character: >_SUBSTRING(character-expression,start,___________,_CODEUNITS16____)_> |_,length_| |_CODEUNITS32_| |__OCTETS_____| Graphic: >_SUBSTRING(graphic-expression,start,___________,_CODEUNITS16____)___> Binary: >_SUBSTRING(binary-expression,start,____________)____________________> |_,length_|

TAN >__TAN(numeric-expression)___________________________________________>

TANH >__TANH(numeric-expression)__________________________________________>

TIME >__TIME(expression)__________________________________________________>

TIMESTAMP >__TIMESTAMP(expression_________________)____________________________> |_,expression_|

®

DB2 9 for z/OS

37

®


TIMESTAMPADD >__TIMESTAMPADD(interval, number, timestamp)_________________________>

TIMESTAMP_FORMAT >__TIMESTAMP_FORMAT(string-expression,format-string)_________________>

TIMESTAMP_ISO >_TIMESTAMP_ISO(expression)__________________________________________>

TIMESTAMPDIFF >__TIMESTAMPDIFF(numeric-expression,string-expression)_______________>

TOTALORDER >__TOTALORDER(decfloat-expression1,decfloat-expression2)_____________>

TRANSLATE >_TRANSLATE(expression_____________________________________________)_> |_,_to-string________________________________________| _,__' '___________ | | |_,__from-string_|__________________|_| |_,__pad-character_|

TRUNCATE >__TRUNCATE(numeric-expression1,numeric-expression2)_________________>

TRUNC_TIMESTAMP >__TRUNC_TIMESTAMP_(expression1___________________)__________________> |_,format-string_|

UCASE or UPPER >_____UCASE___(string-expression_________________________________)___> |_UPPER_| |_,_locale-name_| |_,_integer_|

UNICODE >____UNICODE___(string-expression)___________________________________>

UNICODE_STR _,UTF-8_ >____UNICODE_STR_(string-expression)_|________|_)____________________> |_,UTF16_|

VALUE ____VALUE_(expression_, expression_|_)______________________________>

VARBINARY >__VARCHAR(string-expression______________)__________________________> |_,__integer_| 38

®

DB2 9 for z/OS

®


VARCHAR Varchar to Character: >__VARCHAR(character-expression_______________________________)______> |_,_integer__________________| |_,__CODEUNITS16_| |_CODEUNITS32_| |_OCTETS______| Graphic to Varchar: >__VARCHAR(graphic-expression__________________________________)_____> |_,_integer__________________| |_,__CODEUNITS16_| |_CODEUNITS32__| Datetime to Varchar: >__VARCHAR(datetime-expression_______________________________________> Integer to Varchar: >__VARCHAR(integer-expression)_______________________________________> Decimal to Varchar: >__VARCHAR(decimal-expression__________________________)_____________> |_,__decimal-character_| Decimal floating-Point to Varchar: >__VARCHAR(decimal-floating-point-expression)________________________> Floating-Point to Varchar: >__VARCHAR(floating-point-expression)________________________________> Row ID to Varchar: >__VARCHAR(row-ID-expression)________________________________________>

VARCHAR_FORMAT >__VARCHAR_FORMAT(expression,format-string)__________________________>

VARGRAPHIC Character to Vargraphic: >__VARGRAPHIC(character-expression___________________________)____> |_,_integer_____________| |_,__CODEUNITS16_| |_CODEUNITS32_| Graphic to Vargraphic: >__VARGRAPHIC(graphic-expression____________________________)_____> |_,_integer_____________| |_,__CODEUNITS16_| |_CODEUNITS32_|

WEEK >__WEEK(expression)__________________________________________________>

WEEK_ISO >__WEEK_ISO(expression)______________________________________________>

XMLATTRIBUTES __XMLATTRIBUTES(_attribute-value-expression_______________________|_> ®

DB2 9 for z/OS

39

®

DB2 9 z/OS Reference Guide |_AS_attribute-name_|

XMLCOMMENT >__XML2COMMENT(string-expression)____________________________________>

XML2CLOB >__XML2CLOB(XML-value-expression)____________________________________>

XMLCONCAT __XMLCONCAT(XML- expression____,__XML-expression_|_)_________________>

XMLDOCUMENT >__XML2DOCUMENT(XML-expression)_______________________________________>

XMLELEMENT >__XMLELEMENT(_NAME__ element-name____________________________________> |_,_xmlnamespace-declaration_| _________________________________________________________________|___> |,_XML-attributes-function_| |_,_element-content-expression_| >_____________________________________________________________________> | | | _XMLFOREST(_ ______________________________________________________> |_XMLnamespace-function_,_| _ element-content-expression_____________________|_________________> |_AS_element-name_| >___________________________________________________________________> | | | |_DEFAULT_XML-namespace-uri________| 40

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |_NO DEFAULT_____________|

XMLPARSE _STRIP WHITESPACE_______ >_XMLPARSE(DOCUMENT_string-expression___|________________________|_)_______> |_XML-host-variable_| |_PRESERVE WHITESPACE_|

XMLPI >_XMLPI(NAME_pi-name________________________________)______________________> |_,_string-expression_|

XMLQUERY >_XMLQUERY(xquery-expression-constant)_____________________________________> | _BY REF_ | |_PASSING_|________|_xquery-argument_| _BY REF_ _RETURNING SEQUENCE_|________|_ _EMPTY ON EMPTY_ >_|_______________________________|_|________________|__)__________________> Xquery-argument: >____xquery-context-item-expression________________________________________> | _,_________________________________________ | | | | | |_V_xquery-variable-expression AS identifier__|_|

XMLSERIALIZE _CONTENT_ >_XMLSERIALIZE(_|_________|_XML-expression AS data-type____________________> __|___________________________________|___|_______________________________> | _EXCLUDING XMLDECLARATION__ | |_|_INCLUDING XMLDECLARATION__|____| data-type: _(_1M_)_____________ >______CHARACTER______LARGE OBJECT_____|____________________|______________> | | |_CHAR_______| | | |_(__integer______)_| | |_CLOB_________________________| | |_K_| |_DBCLOB___________________________| |_M_| |__BINARY LARGE OBJECT_____________| |_G_| |_BLOB________________|

XMLTEXT >_XMLTEXT(_string-expression _____________________)________________________>

YEAR >_YEAR(expression)_________________________________________________________>

®

DB2 9 for z/OS

41

®


Queries subselect >>__select-clause__from-clause__________________________________________> |_where-clause_| >_______________________________________________________________________> |_group-by-clause_| |_having-clause_| >_______________________________________________________________________>< |_order-by-clause_| |_fetch-first-clause_|

select-clause _ALL______ >>__SELECT__|__________|________________________________________________> |_DISTINCT_| >____*__________________________________________________________________>< | ___FROM___table-reference__|___________________________________________>< table-reference: >>_______single-table____________________________________________________>< |_nested-table-expression_______________| |_table-function-reference______________| |_data-change-table-reference___________| |_joined-table__________________________| |_table-locator-reference_______________| single-table: >>___table-name__________________________________________________________>< |_view-name___________________| |_correlation-clause_| table-locator-reference: >>__TABLE_(_table-locator-variable_LIKE_table-name_)_____________________>< |_correlation-name_| nested-table-expression: >>__________(fullselect)__correlation-clause_____________________________>< |_TABLE_| table-function-reference: >>_TABLE_(function-name(________________________________________)________> | __table-UDF-cardinality-clause__)_______________________________________> >__correlation-clause____________________________________________________>< table-UDF-cardinality-clause: >>__CARDINALITY__integer-constant________________________________________>< |_CARDINALITY MULTIPLIER_numeric-constant_| data-change-table-reference: >>__FINAL TABLE_(INSERT statement)________________________________________>< |__FINAL____TABLE (searched UPDATE statement)_| |_correlation-clause_| | |_OLD__| | |_OLD TABLE__(searchred DELETE statement______| |_FINAL TABLE__(MERGE statement)______________| correlation-clause: _AS_ >>___|____|___correlation-name____________________________________________>< | >__table-reference_|__________|__JOIN__table-reference_ON_join-condition_>< | | _OUTER_ | | | |___LEFT____|_______|_| | | |_RIGHT_| | | |_FULL__| | |_(__joined-table__)_________________________________________________| For INNER, LEFT OUTER, and RIGHT OUTER joins: >>__search-condition______________________________________________________>< For FULL OUTER joins: >____full-join-expression__=__full-join-expression_|_____________________>< full-join-expression: >>______column-name_______________________________________________________>< | |_cast-function____| | | >__WHERE__search-condition_______________________________________________>< group-by-clause: >__GROUP BY____grouping-expression_|_____________________________________>< having-clause: >>__HAVING__search-condition_____________________________________________>< order-by-clause: __ORDER BY____sort-key__|______|_|_____________________________________>< | | |_DESC_| | | | |_ORDER OF table-designator_| | |_INPUT SEQUENCE_________________| sort-key: >__ _column-name_ ______________________________________________________>< |_integer_____| |_expression__| fetch-first-clause: _1_______ >>__FETCH FIRST__|_________|__ _ROW__ __ONLY____________________________>< |_integer_| |_ROWS_|

fullselect ____subselect____________________________________________________|______> |_(fullselect)_| | _DISTINCT_ | |_UNION_______|__________|__subselect______| |_EXCEPT____| |_ALL______| |_(fullselect)_| |_INTERSECT_| >________________________________________________________________________>< |_order-by-clause_| |_fetch-first-clause_| select-statement: >__ _____________________________________________________________________> |_WITH__common-table-expression_| __fullselect________________________________________________________|___> |_read-only-clause____| |_update-clause_______| |_optimize-for-clause_| |_isolation-clause____| |_queryno-clause______| |_SKIP LOCKED DATA____| common-table-expression: >__common-table-expression-name__ _________________________ __AS_________> | __(fullselect)___________________________________ _____________________>< read-only-clause: >>__FOR_READ_ONLY_______________________________________________________>< update-clause: >__FOR UPDATE OF____column-name_|______________________________________>< optimize-for-clause: >>__OPTIMIZE FOR__integer____ROWS_______________________________________>< 44

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |_ROW__| with-clause: >>__WITH_____CS_________________________________________________________>< |_UR________________________| |_RR________________________| | |_lock-clause__| | |_RS________________________| |_lock-clause_| lock-clause: >_USE AND KEEP____EXCLUSIVE___LOCKS_____________________________________>< |__UPDATE____| |__SHARE_____| queryno-clause: >>__QUERYNO__integer____________________________________________________>< SKIP LOCKED DATA: >>__SKIP LOCKED DATA____________________________________________________>
>__ALLOCATE__cursor-name_CURSOR FOR RESULT SET__rs-locator-variable____>

ALTER DATABASE >__ALTER DATABASE__database-name_______BUFFERPOOL__bpname__________|___> |_INDEXBP__bpname_________| |_STOGROUP__stogroup-name_| |_CCSID__ccsid-value______|

ALTER FUNCTION (external) >>__ALTER____FUNCTION__function-name____________________________________> | | __option-list__________________________________________________________>< parameter-type: >>____data-type_________________________________________________________>< | |_AS LOCATOR____| | |_TABLE LIKE__table-name__AS LOCATOR_| data-type: >>____built-in-data-type________________________________________________>< |_distinct-type-name_| built-in-data-type: >__SMALLINT____________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|_______________________________________________________________ | | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1 OCTETS)____ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_length__)____| | | |_CCSID__ASCII___| |_FOR___SBCS____DATA_| | | | | | |___CHARACTER__VARYING__(_length__)__| | |_EBCDIC__| |_MIXED_| | | | | | | |_CHAR_____| | | |_UNICODE_| |_BIT___| | | | | | |__VARCHAR____________| |_CCSID_ integer__________________________ _| | | | | _(1M OCTETS)_ | | | |_____CHARACTER___LARGE OBJECT_ |____________|__________________________________________| | | | |_CHAR______| |_(_lob-len_)_| ||_CCSID__ASCII___| |_FOR__SBCS____DATA_| | | |___CLOB______________________| | |_EBCDIC__| |_MIXED_| | | | | |_UNICODE_| |_BIT___| | | | |_CCSID_ integer_______________________ | | | __(1 CODEUNITS16)_ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__length___)____| | |_CCSID___ASCII___| | | |_VARGRAPHIC__(__length__)____________| |_EBCDIC__| | | | __(1M CODEUNITS16)_ |_UNICODE_| |

46

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide | |_DBCLOB_|___________________| |_integer_| | | |_(lob-length)______| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | | | _(1M)____________________ | | | |_BINARY LARGE OBJECT_____|_________________________|_____|_______________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| | |_TIME______| | | |_TIMESTAMP_| | |_ROWID_____________________________________________________________________________________|

options-list >>__EXTERNAL__ _______________________ __LANGUAGE__ _ASSEMBLE__ _____> | | |_C_________| |_NAME__ _'string'____ _| |_COBOL_____| |_identifier__| |_JAVA______| |_PLI_______| >__PARAMETER STYLE__ _SQL_______ __ _NOT DETERMINISTIC_ _____________> |_JAVA______| |_DETERMINISTIC_____| >__ _RETURNS NULL ON NULL INPUT_ ______ _CONTAINS SQL_________ ______> |_CALLED ON NULL INPUT_______| |_READS SQL DATA_______| |_MODIFIES SQL DATA____| |_NO SQL_______________| >__ _NO EXTERNAL ACTION_ __ _NO SCRATCHPAD__________ ________________> |_EXTERNAL ACTION____| |_SCRATCHPAD____length___| >__PACKAGE PATH package path_________________________________________> |_NO PACKAGEPATH___________| >__ _NO FINAL CALL_ __ _ALLOW PARALLEL____ __ _NO DBINFO_ ___________> |_FINAL CALL____| |_DISALLOW PARALLEL_| |_DBINFO____| >__CARDINALITY__integer______ _NO COLLID_____________ _______________> |_COLLID__collection-id_| >__WLM ENVIRONMENT__ _name___________ _______________________________> |_(__name__,*__)_| >__ASUTIME__ _NO LIMIT_______ __STAY RESIDENT__ _NO__ _______________> |_LIMIT__integer_| |_YES_| >__PROGRAM TYPE__ _SUB__ __SECURITY__ _DB2_____ _____________________> |_MAIN_| |_USER____| |_DEFINER_| >__STOP AFTER SYSTEM DEFAULT FAILURES________________________________> |_STOP AFTER-integer-FAILURES_______| |_CONTINUE AFTER FAILURE____________| >__RUN OPTIONS__run-time-options_____________________________________> >_ _INHERIT SPECIAL REGISTERS_ ____ STATIC DISPATCH ________________>< |_DEFAULT SPECIAL REGISTERS_| external-java-routine-name |__ ___________ __method-name___ __________________ _________________| |_jar-name:_| |_method-signature_| jar-name |__ ______________ __jar-id__________________________________________| |_schema-name._| method-name: ®

DB2 9 for z/OS

47

®

DB2 9 z/OS Reference Guide __ALTER____FUNCTION__function-name_____________________________________> | | __option-list__________________________________________________________>< parameter-type: >>____data-type_________________________________________________________>< | |_AS LOCATOR____| | |_TABLE LIKE__table-name__AS LOCATOR_| data-type: >>____built-in-data-type________________________________________________>< |_distinct-type-name_| built-in-data-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|_______________________________________________________________ | | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1 OCTETS)____ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_length__)____| | | |_CCSID__ASCII___| |_FOR___SBCS____DATA_| | | | | | |___CHARACTER__VARYING__(_length__)__| | |_EBCDIC__| |_MIXED_| | | | | | | |_CHAR_____| | | |_UNICODE_| |_BIT___| | | | | | |__VARCHAR____________| |_CCSID_ integer__________________________ _| | | | | _(1M OCTETS)_ | | | |_____CHARACTER___LARGE OBJECT_ |____________|__________________________________________| | | | |_CHAR______| |_(_lob-len_)_| ||_CCSID__ASCII___| |_FOR__SBCS____DATA_| | | |___CLOB______________________| | |_EBCDIC__| |_MIXED_| | | | | |_UNICODE_| |_BIT___| | | | |_CCSID_ integer_______________________ | | | __(1 CODEUNITS16)_ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__length___)____| | |_CCSID___ASCII___| | | |_VARGRAPHIC__(__length__)____________| |_EBCDIC__| | | | __(1M CODEUNITS16)_ |_UNICODE_| | | |_DBCLOB_|___________________| |_integer_| | | |_(lob-length)______| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________|

48

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | | | _(1M)____________________ | | | |_BINARY LARGE OBJECT_____|_________________________|_____|_______________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| | |_TIME______| | | |_TIMESTAMP_| | |_ROWID_____________________________________________________________________________________|

option-list: >>__LANGUAGE SQL ___ _NOT DETERMINISTIC__ ____________________________> |_DETERMINISTIC______| >__ ____________________ __ ________________ _________________________> |_EXTERNAL ACTION____| |_CONTAINS SQL___| |_NO EXTERNAL ACTION_| |_READS SQL DATA_| >_STATIC DISPATCH__CALLED ON NULL INPUT_______________________________>
>__ALTER INDEX__index-name___________________________________________> |_REGENERATE_| __________________________________________________________________|__> |_BUFFERPOOL__bpname___________________| |_CLOSE____YES_________________________| | |_NO__| | |_COPY____NO___________________________| | |_YES_| | |_PIECESIZE_____integer____K___________| | |_M_| | | |_G_| | |_using-block__________________________| |_free-block___________________________| |_gbpcache-block_______________________| |___CLUSTER____________________________| | |_NOT CLUSTER_| | |__COMPRESS NO_________________________| | |_COMPRESS YES_| | |___NOT PADDED_________________________| | |_PADDED______| | | _ASC____ | |_ADD COLUMN_(column name_|________|_)_| |_DESC___| |_RANDOM_| >__ ___________________________________________________________________> | ______FREEPAGE__integer___|_______________________________________>< |_PCTFREE__integer__| gbpcache-block >>__GBPCACHE____CHANGED_____________________________________________>< |_ALL_____| |_NONE____| partition-element >>__PARTITION__integer_______________________________________________> | | | _AT_ >__ALTER PROCEDURE__procedure-name___option-list___________________> option-list >______DYNAMIC__RESULT____SETS____integer_________________________>< |_EXTERNAL NAME____'string'_______________________| | |_identifier_| | |_LANGUAGE____ASSEMBLE____________________________| | |_C________| | | |_COBOL____| | | |_JAVA_____| | | |_PLI______| | | |_REXX_____| | |_________________________________________________| | |_PARAMETER STYLE____SQL______________________| | | |_GENERAL____________| | | |_GENERAL WITH NULLS_| | | |_JAVA_______________| | |___NOT DETERMINISTIC_____________________________| | |_DETERMINISTIC_____| | |__PACKAGE PATH__package path_____________________| | |_NO PACKAGE PATH_____________| | |___CONTAINS SQL__________________________________| | |_READS SQL DATA____| | | |_MODIFIES SQL DATA_| | | |_NO SQL____________| | |___NO DBINFO_____________________________________| 50

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide | |_DBINFO____| | |___NO COLLID_____________________________________| | |_COLLID__collection-id_| | |___WLM ENVIRONMENT____name_______________________| | |_(__name__,*__)_| | |_ASUTIME____NO LIMIT_____________________________| | |_LIMIT__integer_| | |_STAY RESIDENT____NO_____________________________| | |_YES_| | |_PROGRAM TYPE____SUB_____________________________| | |_MAIN_| | |_SECURITY____DB2_________________________________| | |_USER____| | | |_DEFINER_| | |_RUN OPTIONS__run-time-options___________________| |_COMMIT ON RETURN____NO__________________________| | |_YES_| | |_ INHERIT SPECIAL REGISTERS__ ___________________| | |_DEFAULT SPECIAL REGISTERS_| | |_CALLED ON NULL INPUT____________________________| |___STOP AFTER SYSTEM DEFAULT FAILURES____________| | |_STOP AFTER integer FAILURES__________| | | |_CONTINUE AFTER FAILURE_______________| | |__DISALLOW DEBUG MODE____________________________| |_ALLOW DEBUG MODE_____________| |_DISABLE DEBUG MODE___________| external-java-routine-name |__ ___________ __method-name___ __________________ ________________| |_jar-name:_| |_method-signature_| jar-name |__ ______________ __jar-id_________________________________________| |_schema-name._| method-name __ALTER PROCEDURE__procedure-name__option-list____________________> ______DYNAMIC__RESULT__SETS______integer________|________________>< |_EXTERNAL NAME____'string'_______________| | |_identifier_| | |___NOT DETERMINISTIC_____________________| | |_DETERMINISTIC_____| | |___CONTAINS SQL__________________________| | |_READS SQL DATA____| | ®

DB2 9 for z/OS

51

®

DB2 9 z/OS Reference Guide | |_MODIFIES SQL DATA_| | |___NO COLLID_____________________________| | |_COLLID__collection-id_| | |___WLM ENVIRONMENT____name_______________| | |_(__name__,*__)_| | |_ASUTIME____NO LIMIT_____________________| | |_LIMIT__integer_| | |_STAY RESIDENT____NO_____________________| | |_YES_| | |_PROGRAMTYPE___SUB_______________________| | |_MAIN_| | |_SECURITY____DB2_________________________| | |_USER____| | | |_DEFINER_| | |_RUN OPTIONS__run-time-options___________| |_COMMIT ON RETURN____NO__________________| | |_YES_| | |_ INHERIT SPECIAL REGISTERS___ __________| | |_DEFAULT SPECIAL REGISTERS__| | |___STOP AFTER SYSTEM DEFAULT FAILURES____| |_STOP AFTER integer FAILURES__________| |_CONTINUE AFTER FAILURE_______________|

ALTER PROCEDURE (SQL - native) >_ALTER PROCEDURE__procedure-name_______________________________________> _ALTER_ _ACTIVE VERSION_______________ >__|_______|_|______________________________|_option-list ______________>< | |_VERSION__routine-version-id__| | | _ACTIVE VERSION______________ | |_REPLACE_|_____________________________|_routine-specification __| | |_VERSION routine-version-id__| | |_ADD VERSION__routine-version-id__ routine-specification ________| |_ACTIVATE VERSION__routine-version-id____________________________| | _ACTIVE VERSION______________ | |_REGENERATE__|_____________________________|_____________________| | |_VERSION--routine-version-id_| | |_DROP VERSION__routine-version-id________________________________| Routine-specification: >______________________________________________________SQL-routine-body_> | | |_option-list_| |_(____________________________)_| | | |>__ALTER SEQUENCE__sequence-name____________________________________> ___ _RESTART__ ________________________ _ |______________________>< | |_WITH__numeric-constant_| | 52

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |_INCREMENT BY__numeric-constant______| |_ _NO MINVALUE________________ ______| | |_MINVALUE__numeric-constant_| | |_ _NO MAXVALUE________________ ______| | |_MAXVALUE__numeric-constant_| | |_ _NO CYCLE_ ________________________| | |_CYCLE____| | |_ _NO CACHE________________ _________| | |_CACHE__integer-constant_| | |_ _NO ORDER_ ________________________| |_ORDER_____|

ALTER STOGROUP >>__ALTER STOGROUP__stogroup-name___________________________________> < | | >__ALTER TABLE__table-name__________________________________________> _________ADD___column-definition _____________________|____________> | |_unique-constraint_______| | | |_referential-constraint__| | | |_check-constraint________| | | |_add-partition___________| | | |_partitioning-clause_____| | | |_RESTRICT ON DROP________| | | |_CLONE clone-table-name__| | |_ALTER__column-alteration__________________| | |_partition-alteration_| | |_ROTATE_partition-rotation_________________| |_DROP__ PRIMARY KEY________________________| | | |_FOREIGN KEY_constraint-name_| | | | | |_UNIQUE______| | | | | |_CHECK_______| | | | | |_CONSTRAINT__| | | | |_RESTRICT ON DROP________________| | | |_CLONE___________________________| | |_VALIDPROC____program-name_________________| | |_NULL_________| | |_AUDIT____NONE_____________________________| | |_CHANGES_| | | |_ALL_____| | |_DATA CAPTURE____NONE______________________| ®

DB2 9 for z/OS

53

®

DB2 9 z/OS Reference Guide | |_CHANGES_| | | _CARDINALITY_ | |__NOT VOLATILE____|_____________|__________| | |_VOLATILE____| | | __MATERIALIZED_ | | __|_______________|__QUERY_ | |_ADD_|___________________________|_mqt-def_| | _ MATERIALIZED_ | |_DROP_|_______________|_QUERY______________| | _ MATERIALIZED_ | |_ALTER_|_______________|_QUERY_____mqt-alt_| |_RENAME COLUMN source-column-name _________| |_TO target-column-name___| column-definition: _COLUMN_ >>___|________|___column-name__data-type_____________________________> ________________________________________________________________|___>< | |_NOT NULL_________________________________________________| | _WITH_ | |_|______|_DEFAULT___________________________________________| | |_constant_______________________________| | | |_SESSION_USER___________________________| | | | |_USER_______| | |_CURRENT SQLID__________________________| | | |_NULL___________________________________| | | |_cast-function-name_(_constant________)_| | | |_SESSION_USER__| | | | |_USER_______| | | |_CURRENT SQLID_| | | |_NULL__________| | |_GENERATED_______ALWAYS_____________________________________| | |_BY DEFAULT_| |_as-identity-clause_| || | |_as-row-change-timestamp-cls_|| |_references-clause__________________________________________| |_check-constraint___________________________________________| |_FIELDPROC__program-name____________________________________| | | >______built-in-data-type___________________________________________>< |_distinct-type-name____| built-in-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| |

54

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_FOR SBCS____DATA_| | | | | |___CHARACTER__VARYING_(_ integer _)_| |_MIXED_| | | | | | |_CHAR_____| | |_BIT___| | | | | |__VARCHAR____________| | | | | _(1M)______________ | | | |_____CHARACTER___LARGE OBJECT_ |___________________|___________________________________| | | | |_CHAR______| | |_(_integer _______)| |_FOR__SBCS____DATA_| | | |___CLOB____________________| |_K_| |_MIXED_| | | |_M_| | | |_G_| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(_integer___)____| | | | |_VARGRAPHIC__(__integer_)____________| | | | __(1M)_____________ | | |_DBCLOB_|___________________| | | |_(integer)______| | | |_K_| | | |_M_| | | |_G_| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | | | _(1M)____________________ | | | |_BINARY LARGE OBJECT_____|_________________________|_____|_______________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| | |_TIME______| | | |_TIMESTAMP_| | |_ROWID_____________________________________________________________________________________| |_XML_______________________________________________________________________________________|

as-identity-clause: >>__AS IDENTITY______________________________________________________>< | >__FOR EACH ROW ON UPDATE AS ROW CHANGE TIMESTAMP___________________> unique-constraint: >________________________________PRIMARY KEY_ _(__column-name|_)___>< |_CONSTRAINT__constraint-name_| |_UNIQUE____| referential-constraint: >_________________________________ FOREIGN KEY _(_column-name_|)_____> |_CONSTRAINT___constraint-name_| >__references-clause_________________________________________________>< references-clause: >>__REFERENCES__table-name____________________________________________> | ____________________________________________________________________>< |_ON DELETE____RESTRICT____| |_NO ACTION_| |_CASCADE___| |_SET NULL__| _ENFORCED______ _ENABLE QUERY OPTIMIZATION_ >__|___________________|____________________|_________________________________|______>< |_NOT ENFORCED__| check-constraint: >>___________________________________CHECK__(check-condition)________>< |_CONSTRAINT__constraint-name_| add-partition: _AT_ >__PARTITION__ENDING__|____|__(___constant_|_)__|___________|_______>< |_MAXVALUE_| |_MINVALUE_| partitioning-clause: _RANGE_ >__PARTITION__BY__|______|__(___partition-expression_|_)____________> __(__partition-element__|__)_______________________________________>< partitioning-expression: _NULLS LAST_ __ASC___ >>__column-name__|___________|__|_______|___________________________> |_DESC__| partition-element: _AT_ >__PARTITION__integer ENDING_|____|_(___constant_|_)_|___________|_>< |_MAXVALUE_| |_MINVALUE_| partition-alteration: _AT_ >__PARTITION__integer ENDING_|____|_(___constant_|_)_|___________|_>< |_MAXVALUE_| |_MINVALUE_| column-alteration: _COLUMN_ >>_|________|_column-name_SET _DATA TYPE_altered-data-type_______________>< 56

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide | |_defulat-clause_____________| | |_generation-alteration_______________________| |_________________________identity-alteration_| |_generation-alteration_| altered-data-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_FOR___SBCS____DATA_| | | | | |___CHARACTER__VARYING__(_ integer _)__| |_MIXED_| | | | | | |_CHAR_____| | |_BIT___| | | | | |__VARCHAR____________| | | | | _(1M)_______________ | | | |_____CHARACTER___LARGE OBJECT_ |____________________|__________________________________| | | | |_CHAR______| | |_(_integer_)________| |_FOR__SBCS____DATA_| | | |___CLOB____________________| |_K_| |_MIXED_| | | |_M_| | | __(1)_____________ |_G_| | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(_integer___)____| | | | |_VARGRAPHIC__(_integer_)____________| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | |_(integer)__| | |__BINARY VARYING _(integer)______________________________| |_VARBINARY_____|

generation-alteration: >>__SET GENERATED___ALWAYS__________________________________________>< |_BY DEFAULT_| identity-aleration: >__RESTART___________________________________|_____________________>< | |_WITH_numeric-constant___| | |_SET INCREMENT BY___numeric-constant____| |_SET__NO MINVALUE_______________________| | |_MINVALUE_numeric-constant__| | |_SET__NO MAXVALUE_______________________| | |_MAXVALUE_numeric-constant__| | |_SET__NO CYCLE__________________________| | |_CYCLE_numeric-constant__| | |_SET__NO ORDER__________________________| |_ORDER____| partition-rotation: _AT_ ®

DB2 9 for z/OS

57

®

DB2 9 z/OS Reference Guide >>__PARTITION FIRST TO LAST___ENDING____|____|_______________________> ____(___constant_|_)_|___________|_____RESET________________________>< |_MAXVALUE_| |_MINVALUE_| materialized-query-definition: >>__(_fullselect_) refreshable-table-options__________________________> refreshable-table-options: >>__DATA INITIALLY DEFERRED__REFRESH DEFERRED_________________________> ___ ________________________________|____________________________>< | _MAINTAINED BY SYSTEM_ | |_|______________________|_______| | |_MAINTAINED BY USER___| | | _ENABLE QUERY OPTIMIZATION__ | |_|____________________________|_| |_DISABLE QUERY OPTIMIZATION_| materialized-query-table-alteration: >>__SET refreshable-table-alterations_________________________________> refreshable-table-alteration: >_________MAINTAINED BY___SYSTEM__________|__________________________> | |_USER___| | |__ENABLE____QUERY OPTIMIZATION__| |_DISABLE_|

ALTER TABLESPACE >>__ALTER TABLESPACE______________________table-space-name____________> |_database-name._| ______BUFFERPOOL__bpname___________________|____________________>< |_LOCKSIZE____ANY____________________| | |_TABLESPACE_| | | |_TABLE______| | | |_PAGE_______| | | |_ROW________| | | |_LOB________| | |_LOCKMAX____SYSTEM__________________| | |_integer_| | |_CLOSE____YES_______________________| | |_NO__| | |_USING____VCAT__catalog-name________| | |_STOGROUP__stogroup-name_| | |_PRIQTY__integer____________________| |_SECQTY__integer____________________| |_ERASE____YES_______________________| | |_NO__| | |_FREEPAGE__integer__________________| |_PCTFREE__integer___________________| |_COMPRESS____YES____________________| 58

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide | |_NO__| | |_GBPCACHE____CHANGED________________| | |_ALL_____| | | |_SYSTEM__| | | |_NONE____| | |_LOCKPART____YES____________________| | |_NO__| | |_MAXROWS__integer___________________| |_MAXPARTITIONS_integer______________| |_TRACKMOD____YES____________________| | |_NO__| | |_LOGGED_____________________________| | |_NOT LOGGED__| | |_CCSID__ccsid-value_________________| >>__ALTER PARTITION__integer__________________________________> |_USING____VCAT__catalog-name________| | |_STOGROUP__stogroup-name_| | |_PRIQTY__integer____________________| |_SECQTY__integer____________________| |_ERASE____YES_______________________| | |_NO__| | |_FREEPAGE__integer__________________| |_PCTFREE__integer___________________| |_COMPRESS____YES____________________| | |_NO__| | |_GBPCACHE____CHANGED________________| | |_ALL_____| | | |_SYSTEM__| | | |_NONE____| | |_TRACKMOD____YES____________________| |_NO__|

ALTER TRUSTED CONTEXT >>_ALTER TRUSTED CONTEXT_context-name______________________________________> < | |_NO DEFAULT ROLE___________________________________________| | | | | | _WITHOUT ROLE AS OBJECT OWNER_ | | | | | |_DEFAULT ROLE role-name_|______________________________|_| | | | | |_WITH ROLE AS OBJECT OWNER____| | | | |__ENABLE_____________________________________________________| | | | |_DISABLE_| | | | |_NO DEFAULT SECURITY LABEL___________________________________| | | | |_ROLE_role-name_| |_SECURITY LABEL-seclabel-name_| _WITHOUT AUTHENTICATION_ >>___________________________________________|________________________|_>< |_WITH AUTHENTICATION____|

ALTER VIEW >>__ALTER VIEW__view-name____REGENERATE______________________________>

ASSOCIATE LOCATORS _RESULT SET_ >>__ASSOCIATE__|____________|____LOCATOR_____________________________> |_LOCATORS_| __(____rs-locator-variable_|__)_____________________________________> >__WITH PROCEDURE____procedure-name_________________________________>< |_host-variable__|

BEGIN DECLARE SECTION >>__BEGIN DECLARE SECTION___________________________________________>
>__CALL____procedure-name___________________________________________> |_host-variable__| >_______________________________________________________________>< |_(____________________________________________)_| 60

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide | | >__CLOSE__cursor-name______________________________________________>
>__COMMENT ON_______________________________________________________> >____ALIAS__alias-name___________________________IS_string-constant_>< | |_COLUMN_____table-name___.column-name______________| | | | |_view-name__| | | | |_TYPE_____distinct-type-name_______________________| | | |__FUNCTION__function-name__________________________| | | | | | ____data-type_____________________________________________________>< |_AS LOCATOR____| data-type >>____built-in-data-type____________________________________________>< |_distinct-type-name_| built-in-data-type >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | ®

DB2 9 for z/OS

61

®

DB2 9 z/OS Reference Guide | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_CCSID__ASCII___| |_FOR___SBCS____DATA_| | | | | |___CHARACTER__VARYING__(_integer_)__| |_EBCDIC__| |_MIXED_| | | | | | |_CHAR_____| | |_UNICODE_| |_BIT___| | | | | |__VARCHAR____________| | | | | _(1M)_______ | | | |_____CHARACTER___LARGE OBJECT_ |____________|__________________________________________| | | | |_CHAR______| |_(integer )_| |_CCSID__ASCII___| |_FOR__SBCS____DATA_| | | |___CLOB______________________| |_EBCDIC__| |_MIXED_| | | |_UNICODE_| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | |_CCSID___ASCII___| | | |_VARGRAPHIC__(_ integer_)____________| |_EBCDIC__| | | | __(1M)_____________ |_UNICODE_| | | |_DBCLOB_|___________________| |_integer_| | | |_(integer)______| | | |_K_| | | |_M_| | | |_G_| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | | | _(1M)____________________ | | | |_BINARY LARGE OBJECT_____|_________________________|_____|_______________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| | |_TIME______| | | |_TIMESTAMP_| | |_ROWID_____________________________________________________________________________________|

COMMIT _WORK_ >>__COMMIT__|______|___________________________________________>
>__CONNECT___________________________________________________>< |_TO____location-name______________________| | |_host-variable_| |_authorization_| | |_RESET____________________________________| |_authorization____________________________| authorization >>__USER__host-variable__USING__host-variable__________________>
>__CREATE ALIAS__alias-name__FOR____table-name________________>< |_view-name__|

CREATE AUXILIARY TABLE >>__CREATE____AUXILIARY____TABLE__aux-table-name__IN____________> |_AUX_______| >____________________table-space-name__STORES__table-name_______> |_database-name._| 62

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide >__COLUMN__column-name_________________________________________>< |_PART__integer_|

CREATE DATABASE >>__CREATE DATABASE__database-name______________________________> _______________________________________________|______________>< |_BUFFERPOOL__bpname_____________________| |_INDEXBP__bpname________________________| |_AS____WORKFILE_________________________| | |_FOR__member-name_| | | _SYSDEFLT______ | |_STOGROUP__|_stogroup-name_|____________| |_CCSID____ASCII_________________________| |_EBCDIC__| |_UNICODE_|

CREATE FUNCTION (external scalar) >>__CREATE FUNCTION__function-name__(_____________________________)___> | __RETURNS_____data-type2________________option-list__________________>< | |_AS LOCATOR____| | |_data-type3__CAST FROM__data-type4____________________| |_AS LOCATOR__| parameter-declaration: >>______________________parameter-type________________________________>< |_parameter-name_| parameter-type: >>____data-type_______________________________________________________>< | |_AS LOCATOR____| | |_TABLE LIKE____table-name____AS LOCATOR_| |_view-name__| data-type: >>____built-in-data-type______________________________________________>< |_distinct-type-name_| built-in-data-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_CCSID__ASCII___| |_FOR___SBCS____DATA_| | | | | |___CHARACTER__VARYING__(_integer_)__| |_EBCDIC__| |_MIXED_| | | ®

DB2 9 for z/OS

63

®

DB2 9 z/OS Reference Guide | | | |_CHAR_____| | |_UNICODE_| |_BIT___| | | | | |__VARCHAR____________| | | | | _(1M)_______ | | | |_____CHARACTER___LARGE OBJECT_ |____________|__________________________________________| | | | |_CHAR______| |_(integer )_| |_CCSID__ASCII___| |_FOR__SBCS____DATA_| | | |___CLOB______________________| |_EBCDIC__| |_MIXED_| | | |_UNICODE_| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | |_CCSID___ASCII___| | | |_VARGRAPHIC__(_ integer_)____________| |_EBCDIC__| | | | __(1M)_____________ |_UNICODE_| | | |_DBCLOB_|___________________| |_integer_| | | |_(integer)______| | | |_K_| | | |_M_| | | |_G_| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | | | _(1M)____________________ | | | |_BINARY LARGE OBJECT_____|_________________________|_____|_______________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| | |_TIME______| | | |_TIMESTAMP_| | |_ROWID_____________________________________________________________________________________|

option-list: >>___________________________________________________________________> |_SPECIFIC_specific-name_| | __EXTERNAL____________________________LANGUAGE____ASSEMBLE__________> |_NAME____'string'_____| |_C________| |_identifier_| |_COBOL____| |_JAVA_____| |_PLI______| _PARAMETER STYLE DB2SQL_ _NOT DETERMINISTIC_ _FENCED_ >_|________________________|_|___________________|______|________|___> |_PARAMETER STYLE JAVA___| |_DETERMINISTIC_____| _RETURNS NULL ON NULL INPUT_ _READS SQL DATA____ >__|____________________________|______|___________________|_________> |_CALLED ON NULL INPUT_______| |_NO SQL____________| |_MODIFIES SQL DATA_| |_CONTAINS SQL______| _EXTERNAL ACTION____ _NO SCRATCHPAD__________ >__|____________________|__|________________________|________________> |_NO EXTERNAL ACTION_| | _100____ | |_SCRATCHPAD__|________|_| |_length_| _NO FINAL CALL_ _ALLOW PARALLEL____ _NO DBINFO_ >__|_______________|__|___________________|______|___________|_______> |_FINAL CALL____| |_DISALLOW PARALLEL_| |_DBINFO____| _NO COLLID_____________ 64

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide >__|_______________________|_________________________________________> |_COLLID__collection-id_| |_WLM ENVIRONMENT____name_________| |_(__name__)_| _ASUTIME NO LIMIT________ _STAY RESIDENT NO__ >__|_________________________|__|___________________|________________> |_ASUTIME__LIMIT__integer_| |_STAY RESIDENT YES_| _PROGRAM TYPE SUB__ _SECURITY DB2__________ >__|___________________|__|_______________________|__________________> |_PROGRAM TYPE MAIN_| |_SECURITY____USER______| |_DEFINER_| _STOP AFTER SYSTEM DEFAULT FAILURES___ >___|______________________________________|_________________________> |_STOP AFTER integer FAILURES__________| |_CONTINUE AFTER FAILURE_______________| >____________________________________________________________________> |_RUN OPTIONS__run-time-options_| _INHERIT SPECIAL REGISTERS_ _STATIC DISPATCH >__|___________________________|_________|________________|_________>< |_DEFAULT SPECIAL REGISTERS_| external-java-routine-name |__ ___________ __method-name___ __________________ _________________| |_jar-name:_| |_method-signature_| jar-name |__ ______________ __jar-id__________________________________________| |_schema-name._| method-name __CREATE FUNCTION__function-name____________________________________> >__(__ ___________________________ __)_______________________________> | < |_AS LOCATOR_| parameter-declaration: >>__ ________________ __parameter-type______________________________>< |_parameter-name_| parameter-type: >>__ _data-type_____ ________________________ ______________________>< | |_AS LOCATOR____| | |_TABLE LIKE__ _table-name_ __AS LOCATOR_| |_view-name__| data-type: >>____built-in-data-type____________________________________________>< ®

DB2 9 for z/OS

65

®

DB2 9 z/OS Reference Guide |_distinct-type-name_| built-in-data-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_CCSID__ASCII___| |_FOR___SBCS____DATA_| | | | | |___CHARACTER__VARYING__(_integer_)__| |_EBCDIC__| |_MIXED_| | | | | | |_CHAR_____| | |_UNICODE_| |_BIT___| | | | | |__VARCHAR____________| | | | | _(1M)_______ | | | |_____CHARACTER___LARGE OBJECT_ |____________|__________________________________________| | | | |_CHAR______| |_(integer )_| |_CCSID__ASCII___| |_FOR__SBCS____DATA_| | | |___CLOB______________________| |_EBCDIC__| |_MIXED_| | | |_UNICODE_| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | |_CCSID___ASCII___| | | |_VARGRAPHIC__(_ integer_)____________| |_EBCDIC__| | | | __(1M)_____________ |_UNICODE_| | | |_DBCLOB_|___________________| |_integer_| | | |_(integer)______| | | |_K_| | | |_M_| | | |_G_| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | | | _(1M)____________________ | | | |_BINARY LARGE OBJECT_____|_________________________|_____|_______________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| | |_TIME______| | | |_TIMESTAMP_| | |_ROWID_____________________________________________________________________________________|

option-list: >>___________________________________________________________________> |_SPECIFIC_specific-name_| | __EXTERNAL____________________________LANGUAGE____ASSEMBLE__________> |_NAME____'string'_____| |_C________| |_identifier_| |_COBOL____| |_JAVA_____| 66

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |_PLI______| _PARAMETER STYLE DB2SQL_ _NOT DETERMINISTIC_ _FENCED_ >_|________________________|_|___________________|______|________|___> |_PARAMETER STYLE JAVA___| |_DETERMINISTIC_____| _RETURNS NULL ON NULL INPUT_ _READS SQL DATA____ >__|____________________________|______|___________________|_________> |_CALLED ON NULL INPUT_______| |_NO SQL____________| |_CONTAINS SQL______| _EXTERNAL ACTION____ _NO SCRATCHPAD__________ >__|____________________|__|________________________|________________> |_NO EXTERNAL ACTION_| | _100____ | |_SCRATCHPAD__|________|_| |_length_| _NO PACKAGE PATH___________ >_|___________________________|______________________________________> |_PACKAGE PATH package-path_| _NO FINAL CALL_ _NO DBINFO_ >__|_______________|_____________________________|___________|_______> |_FINAL CALL____| |_DISALLOW PARALLEL_| |_DBINFO____| _NO COLLID_____________ >__|_______________________|_________________________________________> |_COLLID__collection-id_| |_WLM ENVIRONMENT____name_________| |_(__name__)_| >____________________________________________________________________> |_CARDINALITY_integer___| _ASUTIME NO LIMIT________ _STAY RESIDENT NO__ >__|_________________________|__|___________________|________________> |_ASUTIME__LIMIT__integer_| |_STAY RESIDENT YES_| _PROGRAM TYPE SUB__ _SECURITY DB2__________ >__|___________________|__|_______________________|__________________> |_PROGRAM TYPE MAIN_| |_SECURITY____USER______| |_DEFINER_| _STOP AFTER SYSTEM DEFAULT FAILURES___ >___|______________________________________|_________________________> |_STOP AFTER integer FAILURES__________| |_CONTINUE AFTER FAILURE_______________| >____________________________________________________________________> |_RUN OPTIONS__run-time-options_| _INHERIT SPECIAL REGISTERS_ _STATIC DISPATCH_ >__|___________________________|_________|_________________|________>< |_DEFAULT SPECIAL REGISTERS_|

CREATE FUNCTION (sourced) >>__CREATE FUNCTION__function-name____________________________________> >__(__ ___________________________ __)_______________________________> | __RETURNS__data-type2__ _______________ ____________________________> |_AS LOCATOR____| >__ _________________________ __ ______________________________ _____> |_SPECIFIC__specific-name_| |_PARAMETER CCSID__ _ASCII___ _| |_EBCDIC__| |_UNICODE_| >__SOURCE_ _function-name_______________________________ ___________>< ®

DB2 9 for z/OS

67

®

DB2 9 z/OS Reference Guide |_SPECIFIC__specific-name_____________________| |_function-name__(__ ____________________ __)_| | >__ ________________ __parameter-type_______________________________>< |_parameter-name_| parameter-type: >>__ _data-type_____ ________________________ _______________________>< | |_AS LOCATOR____| | |_TABLE LIKE__ _table-name_ __AS LOCATOR_| |_view-name__| data-type: >>____built-in-data-type____________________________________________>< |_distinct-type-name_| built-in-data-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_CCSID__ASCII___| |_FOR___SBCS____DATA_| | | | | |___CHARACTER__VARYING__(_integer_)__| |_EBCDIC__| |_MIXED_| | | | | | |_CHAR_____| | |_UNICODE_| |_BIT___| | | | | |__VARCHAR____________| | | | | _(1M)_______ | | | |_____CHARACTER___LARGE OBJECT_ |____________|__________________________________________| | | | |_CHAR______| |_(integer )_| |_CCSID__ASCII___| |_FOR__SBCS____DATA_| | | |___CLOB______________________| |_EBCDIC__| |_MIXED_| | | |_UNICODE_| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | |_CCSID___ASCII___| | | |_VARGRAPHIC__(_ integer_)____________| |_EBCDIC__| | | | __(1M)_____________ |_UNICODE_| | | |_DBCLOB_|___________________| |_integer_| | | |_(integer)______| | | |_K_| | | |_M_| | | |_G_| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | | | _(1M)____________________ | | | |_BINARY LARGE OBJECT_____|_________________________|_____|_______________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| | |_TIME______| |

68

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide | |_TIMESTAMP_| | |_ROWID_____________________________________________________________________________________|

CREATE FUNCTION (SQL Scalar) >>_CREATE FUNCTION_function-name__(_ ___________________________ __)_> | ____ __RETURNS__data-type2_ _______________________________________>< |_option-list__________| _LANGUAGE SQL_ >___|______________|___option-list RETURN-statement_________________>< parameter-declaration: >>__ parameter-name ___data-type1___________________________________>< data-type: >>____built-in-data-type____________________________________________>< |_distinct-type-name_| built-in-data-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_CCSID__ASCII___| |_FOR___SBCS____DATA_| | | | | |___CHARACTER__VARYING__(_integer_)__| |_EBCDIC__| |_MIXED_| | | | | | |_CHAR_____| | |_UNICODE_| |_BIT___| | | | | |__VARCHAR____________| | | | | _(1M)_______ | | | |_____CHARACTER___LARGE OBJECT_ |____________|__________________________________________| | | | |_CHAR______| |_(integer )_| |_CCSID__ASCII___| |_FOR__SBCS____DATA_| | | |___CLOB______________________| |_EBCDIC__| |_MIXED_| | | |_UNICODE_| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | |_CCSID___ASCII___| | | |_VARGRAPHIC__(_ integer_)____________| |_EBCDIC__| | | | __(1M)_____________ |_UNICODE_| | | |_DBCLOB_|___________________| | | |_(integer)______| | | |_K_| | | |_M_| | | |_G_| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | | | _(1M)____________________ | | | |_BINARY LARGE OBJECT_____|_________________________|_____|_______________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | ®

DB2 9 for z/OS

69

®

DB2 9 z/OS Reference Guide | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| | |_TIME______| | | |_TIMESTAMP_| | |_ROWID_____________________________________________________________________________________|

option-list: >>___________________________________________________________________> |_SPECIFIC_____specific-name_| |_PARAMETER CCSID_ ASCII___| |_EBCDIC__| |_UNICODE_| _NOT DETERMINISTIC_ __EXTERNAL ACTION___ >____|___________________|__|____________________|____________________> |_DETERMINISTIC_____| |_NO_EXTERNAL ACTION_| _READS_SQL_DATA_ _STATIC DISPATCH_ >____|________________|___|_________________|_________________________> |_CONTAINS_SQL___| _ CALLED ON NULL INPUT _ >__|________________________|_________________________________________>

CREATE GLOBAL TEMPORARY TABLE >__CREATE GLOBAL TEMPORARY TABLE_table-name_(__column-spec_|_)_______> |_LIKE__table-name____| |_view-name_| >_____________________________________________________________________> |_CCSID______ASCII_____| |_EBCDIC__| |_UNICODE_| column-spec: >>__columne-name_data-type____________________________________________> |_NOT NULL_| data-type: >>__built-in-data-type________________________________________________> |_distinct-type_name_| built-in-data-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_FOR___SBCS____DATA_| | | | |___CHARACTER__VARYING__(_integer_)__| |_MIXED_| | | | | |_CHAR_____| | |_BIT___| |

70

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide | | |__VARCHAR____________| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | | | |_VARGRAPHIC__(_ integer_)____________| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | |___DATE____________________________________________________________________________________| |_TIME______| |_TIMESTAMP_|

CREATE INDEX >>__CREATE________________________________INDEX__index-name__ON__________> |_UNIQUE__________________| |_WHERE NOT NULL_| | |_key-expression_| |_DESC___| | | |_RANDOM_| | |_aux-table-name______________________________| >_____________________________________________________________________|__> |_XML index-specification_| | _NOT CLUSTER_ | |_|_CLUSTER_____|_| |_PARTITIONED_____| | _NOT PADDED_ | |_|_PADDED_____|__| |_free-block______| |_using-block_____| |_gbpcache-block__| | _YES_ | |_DEFINE__|_NO__|_| | _YES_ | |_COMPRESS_|_NO__|| >_________________________________________________________________________> | >_GENERATE KEY USING____XMLPATTERN_xml-pattern-clause_AS_sql-data-type_>< |_GENERATE KEYS USING_| XML-pattern-clause: >>______________________ pattern-expression_____________________________>< |_ proglog _| prolog: >___declare names NOName = StringLiteral ;_____________|______________>< |_declare defulat element namespace Stringliteral ;__| pattern-expression: >>_______________________________________________________________________> | >______________________________________________________________________> |___/____@attribute-name____________________| |_//_||_attribute::attribute-name_________| |_@*________________________________| |_arrtibute::*______________________| |_forward axis__text()______________| Forward-axis: _child::__________________ >>______|__________________________|_____________________________________> |_descendant::_____________| |_self::___________________| |_descendant or self::_____| SQL-data-type: >>__SQL__VARCHAR__( integer )________________________________________________>< | _(34)_ | |_DECFLOAT__|______|____| using-block: >>__USING___________________________________________________________> >____VCAT__catalog-name_____________________________________________>< | ______FREEPAGE__|_integer_|___|___________________________________>< | _10______ | |_PCTFREE__|_integer_|__| gbpcache-block: _CHANGED_ >>__GBPCACHE__|_ALL_____|_______________________________________________>< |_NONE____| partition-element: _AT_ >__PARTITION__integer_ENDING__|____|_(__constant_|_)_|___________|____>< |_MAXVALUE_| |_MINVALUE_|

CREATE PROCEDURE (external) >>__CREATE PROCEDURE__procedure-name___________________________________> __(____________________________|__)__option-list___________________>< |_parameter-declaration_| parameter-declaration: _IN_______ >__|_OUT______|______________________parameter-type___________________> | | |_parameter-name_| |_INOUT____| parameter-type: >>____data-type_______________________________________________________>< | |_AS LOCATOR____| | |_TABLE LIKE____table-name____AS LOCATOR_| |_view-name__| data-type: >>____built-in-data-type_______________________________________________>< |_distinct-type-name_| built-in-data-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_CCSID__ASCII___| |_FOR___SBCS____DATA_| | | | | |___CHARACTER__VARYING__(_integer_)__| |_EBCDIC__| |_MIXED_| | | | | | |_CHAR_____| | |_UNICODE_| |_BIT___| | | | | |__VARCHAR____________| | | | | _(1M)_______ | | | |_____CHARACTER___LARGE OBJECT_ |____________|__________________________________________| | | | |_CHAR______| ||_(integer )_| |_CCSID__ASCII___| |_FOR__SBCS____DATA_| | | |___CLOB_____________________| |_EBCDIC__| |_MIXED_| | | |_UNICODE_| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | |_CCSID___ASCII___| | ®

DB2 9 for z/OS

73

®

DB2 9 z/OS Reference Guide | |_VARGRAPHIC__(_ integer_)____________| |_EBCDIC__| | | | __(1M)_____________ |_UNICODE_| | | |_DBCLOB_|___________________| | | |_(integer)______| | | |_K_| | | |_M_| | | |_G_| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | | | _(1M)____________________ | | | |_BINARY LARGE OBJECT_____|_________________________|_____|_______________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| | |_TIME______| | | |_TIMESTAMP_| | |_ROWID_____________________________________________________________________________________|

option-list: _DYNAMIC RESULT SET 0_____________ >>__|__________________________________|_____________________________> |_DYNAMIC__RESULT____SET___integer_| >____________________________________________________________________> |_PARAMETER _____CCSID__ASCII________________| | |_EBCDIC__| | | |_UNICODE_| | |__VARCHAR_________NULTERM____| |_STRUCTURE___| >__EXTERNAL____________________________LANGUAGE____ASSEMBLE__________> |_NAME____'string'_____| |_C________| |_identifier_| |_COBOL____| |_JAVA_____| |_PLI______| |_REXX_____| _PARAMETER STYLE SQL___________________________ >__|_______________________________________________|_________________> | _PARAMETER STYLE_ | |__|_________________|__________________________| |_GENERAL____________| |_GENERAL WITH NULLS_| |_JAVA_______________| _NOT DETERMINISTIC_ _FENCED_ >__|___________________|______|________|_____________________________> |_DETERMINISTIC_____| _CALLED ON NULL INPUT____ _MODIFIES SQL DATA_ >__|_________________________|__|___________________|_________________> |_NO SQL____________| |_CONTAINS SQL______| |_READS SQL DATA____| _NO PACAKGE PATH_____________ >__|_____________________________|____________________________________> |_PACKAGE PATH package-path___| _NO DBINFO_ _NO COLLID_____________ >__|___________|__|_______________________|___________________________> |_DBINFO____| |_COLLID__collection-id_| 74

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide >_____________________________________________________________________> |_WLM ENVIRONMENT____name_____________| |_(__name__,*__)_| _ASUTIME NO LIMIT________ _STAY RESIDENT NO__ >__|_________________________|__|___________________|_________________> |_ASUTIME__LIMIT__integer_| |_STAY RESIDENT YES_| _PROGRAM TYPE MAIN_ _SECURITY DB2__________ >__|___________________|_________|_______________________|____________> |_PROGRAM TYPE SUB__| |_SECURITY USER_________| |_SECURITY DEFINER______| _STOP AFTER SYSTEM DEFAULT FAILURES___ >_|______________________________________|____________________________> |_STOP AFTER integer FAILURES__________| |_CONTINUE AFTER FAILURE_______________| _COMMIT ON RETURN NO__ >_____________________________________|______________________|________>< |_RUN OPTIONS__run-time-options_| |_COMMIT ON RETURN YES_| _INHERIT SPECIAL REGISTERS_ _CALLED ON NULL INPUT_ >__|___________________________|____|______________________|__________> |_DEFAULT SPECIAL REGISTERS_| >_____________________________________________________________________>< |_DISALLOW DEBUG MODE____| |_ALLOW DEBUG MODE_______| |_DISABLE DEBUG MODE_____| external-java-routine-name |__ ___________ __method-name___ __________________ _________________| |_jar-name:_| |_method-signature_| jar-name |__ ______________ __jar-id__________________________________________| |_schema-name._| method-name __CREATE PROCEDURE__procedure-name___________________________________> __(____________________________|__)__option-list___________________>< |_parameter-declaration_| parameter-declaration: _IN_______ >__|_OUT______|______________________parameter-type___________________> | | |_parameter-name_| |_INOUT____| parameter-type: >>____built-in data-type______________________________________________>< ®

DB2 9 for z/OS

75

®

DB2 9 z/OS Reference Guide | |_AS LOCATOR____| | |_TABLE LIKE____table-name____AS LOCATOR_| |_view-name__| built-in-data-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_CCSID__ASCII___| |_FOR___SBCS____DATA_| | | | | |___CHARACTER__VARYING__(_integer_)__| |_EBCDIC__| |_MIXED_| | | | | | |_CHAR_____| | |_UNICODE_| |_BIT___| | | | | |__VARCHAR____________| | | | | _(1M)_______ | | | |_____CHARACTER___LARGE OBJECT_ |____________|__________________________________________| | | | |_CHAR______| |_(integer )_| |_CCSID__ASCII___| |_FOR__SBCS____DATA_| | | |___CLOB______________________| |_EBCDIC__| |_MIXED_| | | |_UNICODE_| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | |_CCSID___ASCII___| | | |_VARGRAPHIC__(_ integer_)____________| |_EBCDIC__| | | | __(1M)_____________ |_UNICODE_| | | |_DBCLOB_|___________________| | | |_(integer)______| | | |_K_| | | |_M_| | | |_G_| | | _(1M)____________________ | |___BINARY LARGE OBJECT_____|_________________________|_____________________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| |_TIME______| |_TIMESTAMP_|

option-list: _FENCED_ >>__LANGUAGE SQL__|________|________________________________________> |_EXTERNAL NAME____’string’__________| |_identifier_| _DYNAMIC RESULT SET 0_____________ >__|__________________________________|_____________________________> |_DYNAMIC__RESULT____SET___integer_| >___________________________________________________________________> |_PARAMETER _____CCSID__ASCII________________| |_EBCDIC__| |_UNICODE_| _NOT DETERMINISTIC_ >__|___________________|____________________________________________> |_DETERMINISTIC_____| _CALLED ON NULL INPUT____ _MODIFIES SQL DATA_ >__|_________________________|__|___________________|_______________> 76

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |_NO SQL____________| |_CONTAINS SQL______| |_READS SQL DATA____| _NO DBINFO_ _NO COLLID_____________ >__|___________|__|_______________________|_________________________> |_COLLID__collection-id_| >_________________________________________________________________> |_WLM ENVIRONMENT____name_____________| |_(__name__,*__)_| _ASUTIME NO LIMIT________ _STAY RESIDENT NO__ >__|_________________________|__|___________________|_____________> |_ASUTIME__LIMIT__integer_| |_STAY RESIDENT YES_| _PROGRAM TYPE MAIN_ _SECURITY DB2__________ >__|___________________|_________|_______________________|________> |_PROGRAM TYPE SUB__| |_SECURITY USER_________| |_SECURITY DEFINER______| _STOP AFTER SYSTEM DEFAULT FAILURES___ >_|______________________________________|________________________> |_STOP AFTER integer FAILURES__________| |_CONTINUE AFTER FAILURE_______________| _COMMIT ON RETURN NO__ >_____________________________________|______________________|____> |_RUN OPTIONS__run-time-options_| |_COMMIT ON RETURN YES_| _INHERIT SPECIAL REGISTERS_ _CALLED ON NULL INPUT_ >__|___________________________|____|______________________|______>< |_DEFAULT SPECIAL REGISTERS_|

CREATE PROCEDURE (SQL-native) >>__CREATE PROCEDURE__procedure-name_________________________________> |_(_________________________)_| | _|________________________||______________|_____________SQL-routine-body_> |_VERSION routine ver-id_| |_option-list_| parameter-declaration: _IN____ >__|_______|__parameter-name__parameter-type_________________________> |_OUT___| |_INOUT_| parameter-type: >>__built-in-data-type______________________________________________>< |_TABLE LIKE_ table-name_AS LOCATOR_| built-in-data-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | ®

DB2 9 for z/OS

77

®

DB2 9 z/OS Reference Guide |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_CCSID__ASCII___| |_FOR___SBCS____DATA_| | | | | |___CHARACTER__VARYING__(_integer_)__| |_EBCDIC__| |_MIXED_| | | | | | |_CHAR_____| | |_UNICODE_| |_BIT___| | | | | |__VARCHAR____________| | | | | _(1M)_______ | | | |_____CHARACTER___LARGE OBJECT_ |____________|__________________________________________| | | | |_CHAR______| ||_(integer )_| |_CCSID__ASCII___| |_FOR__SBCS____DATA_| | | |___CLOB_____________________| |_EBCDIC__| |_MIXED_| | | |_UNICODE_| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | |_CCSID___ASCII___| | | |_VARGRAPHIC__(_ integer_)____________| |_EBCDIC__| | | | __(1M)_____________ |_UNICODE_| | | |_DBCLOB_|___________________| | | |_(integer)______| | | |_K_| | | |_M_| | | |_G_| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | | | _(1M)____________________ | | | |_BINARY LARGE OBJECT_____|_________________________|_____|_______________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| |_TIME______| |_TIMESTAMP_|

option-list: _NOT DETERMINISTIC_ _MODIFIES SQL DATA_ >>_ |___________________|__ |___________________|________________> |_DETERMINISTIC_____| |_READS SQL DATA____| |_CONTAINS SQL______| _CALLED ON NULL INPUT_ _DYNAMIC RESULT SETS 0________ >__|______________________|__|______________________________|____> |_DYNAMIC RESULT SETS__integer_| >________________________________________________________________> |_DISALLOW DEBUG MODE_| |_PARAMETER CCSID ASCII___| |_ALLOW DEBUG MODE____| |_PARAMETER CCSID EBCDIC__| |_DISABLE DEBUG MODE__| |_PARAMETER CCSID UNICODE_| >________________________________________________________________> |_QUALIFIER__schema_name_| >________________________________________________________________> |_PACKAGE OWNER__authorization_name_| _ASUTIME NO LIMIT_______ _COMMIT ON RETURN NO__ >__|________________________|__ |______________________|_________> |_ASUTIME LIMIT__integer_| |_COMMIT ON RETURN YES_| _INHERIT SPECIAL REGISTERS_ >__|___________________________|_________________________________> |_DEFAULT SPECIAL REGISTERS_| _STOP AFTER SYSTEM DEFAULT FAILURES_ >__|____________________________________|________________________> 78

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |_STOP AFTER__integer__FAILURES______| |_CONTINUE AFTER FAILURE_____________| >________________________________________________________________> |_WLM ENVIRONMENT FOR DEBUG MODE__name_| _CURRENT DATA NO__ _DEGREE 1___ >_______________________ |__________________|__|____________|____> |_DEFER PREPARE___ | |_CURRENT DATA YES_| |_DEGREE ANY_| |_NODEFER PREPARE_ | _DYNAMICRULES RUN________ >__|_________________________|___________________________________> |_DYNAMICRULES BIND_______| |_DYNAMICRULES DEFINEBIND_| |_DYNAMICRULES DEFINERUN__| |_DYNAMICRULES INVOKEBIND_| |_DYNAMICRULES INVOKERUN__| >________________________________________________________________> |_APPLICATION ENCODING SCHEME ASCII___| |_APPLICATION ENCODING SCHEME EBCDIC__| |_APPLICATION ENCODING SCHEME UNICODE_| _WITHOUT EXPLAIN_ _WITHOUT IMMEDIATE WRITE_ >__|_________________|__ |_________________________|_____________> |_WITH EXPLAIN____| |_WITH IMMEDIATE WRITE____| _ISOLATION LEVEL CS_ _WITHOUT KEEP DYNAMIC_ >__ |____________________|__|______________________|_____________> |_ISOLATION LEVEL RS_| |_WITH KEEP DYNAMIC____| |_ISOLATION LEVEL RR_| |_ISOLATION LEVEL UR_| _OPTHINT_____________________ >__|_____________________________|_______________________________> |_OPTHINT__string_constant____| >________________________________________________________________> |_SQL PATH__schema_name__________| |_SQL PATH__schema_name_list_____| |_SQL PATH__SESSION_USER or USER_| |_SQL PATH__DEFAULT______________| _RELEASE AT COMMIT______ _REOPT NONE____ >__|_______________________ |__ |______________ |________________> |_RELEASE AT DEALLOCATE__| |_REOPT ALWAYS__| |_REOPT ONCE____| _VALIDATE RUN___ >___|________________|___________________________________________> |_VALIDATE BIND_ | |_ROUNDING DEC_ROUND_CEILING___| |_ROUNDING DEC_ROUND_DOWN______| |_ROUNDING DEC_ROUND_FLOOR_____| |_ROUNDING DEC_ROUND_HALF_DOWN_| |_ROUNDING DEC_ROUND_HALF_EVEN_| |_ROUNDING DEC_ROUND_HALF_UP___| |_ROUNDING DEC_ROUND_UP________| >_________________________________________________________________> |_DATE FORMAT ISO___ | |_DECIMAL(15)___ | |_DATE FORMAT EUR___ | |_DECIMAL(31)___ | |_DATE FORMAT USA___ | |_DECIMAL(15,s)_ | ®

DB2 9 for z/OS

79

®

DB2 9 z/OS Reference Guide |_DATE FORMAT JIS___ | |_DATE FORMAT LOCAL_ |

|_DECIMAL(31,s)_ |

_FOR UPDATE CLAUSE REQUIRED_ >___|____________________________|____________________________________>< |_FOR UPDATE CLAUSE OPTIONAL_| |_TIME FORMAT ISO___| |_TIME FORMAT EUR___| |_TIME FORMAT USA___| |_TIME FORMAT JIS___| |_TIME FORMAT LOCAL_|

CREATE ROLE >>__CREATE ROLE__role-name_____________________________________________>

CREATE SEQUENCE >_CREATE SEQUENCE_sequence-name_____________________________________|_>< | _INTEGER___ | |_AS__|_data-type_|_________________| |_START WITH__numeric-constant______| | _INCREMENT BY 1_________________ | |_|________________________________|| | |_INCREMENT BY__numeric-constant_|| | _NO MINVALUE________________ | |_|____________________________|____| | |_MINVALUE__numeric-constant_| | | _NO MAXVALUE________________ | |_|____________________________|____| | |_MAXVALUE__numeric-constant_| | | _NO CYCLE_ | |_|__________|______________________| | |_CYCLE____| | | _CACHE 20________________ | |_|_________________________|_______| | |_NO CACHE________________| | | |_CACHE__integer-constant_| | | | _NO ORDER_ | |_|_|__________|____________________| |_ORDER____| data-type: >>___built-in-type_____________________________________________________> |_distinct-type-name_| built-in-type: >__SMALLINT____________________________________________________________>< | |_INTEGER__| | | | |INT_| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|________________________________|_| |_DEC_____| |_(__integer___________________)_| |_numeric_| |_,integer_|

80

®

DB2 9 for z/OS

®


CREATE STOGROUP >__CREATE STOGROUP__stogroup-name__VOLUMES(____volume-id|_______)_____> | __VCAT__catalog-name__________________________________________________> >______________________________________________________________________>< |_DATACLASdc-name_| |_MGMTCLASmc-name_| |_STORCLASsc-name_|

CREATE SYNONYM >>__CREATE SYNONYM__synonym____________________________________________> >__FOR__authorization-name.___table-name___________________________>< |_view-name__|

CREATE TABLE >>__CREATE TABLE__table-name____________________________________________> __(_____column-definition________|_)___________________________________> | |_unique-constraint______| | | |_referential-constraint_| | | |_check-constraint_______| | |__LIKE__table-name_____copy-options________________________________| | | |_view-name__| | | | |__as-result-table___| | |__materialized-query-definition____________________________________| _______________________________________________________|______________>< |___IN______________________table-space-name___| | | |_database-name._| | | | |_IN DATABASE__database-name_____________| | |_partitioning-clause__________________________| |_EDITPROC__program-name_______________________| |_VALIDPROC__program-name______________________| | _NONE____ | |_AUDIT__|_CHANGES_|___________________________| | | |_ALL_____| |_OBID__integer________________________________| | _NONE____ | |_DATA CAPTURE__|_CHANGES_|____________________| |_WITH RESTRICT ON DROP________________________| |_CCSID____ASCII_______________________________| | |_EBCDIC__| | | |_UNICODE_| | | _NOT VOLATILE_ _CARDINALITY_ | |__|______________|__|_____________|___________| | | _CARDINALITY_ | | | |_VOLATILE______|_____________|_| | | _NO__ | |_APPEND_____|_YES_|___________________________| column-definition: >__column-name__data-type________________________________________|__> ®

DB2 9 for z/OS

81

®

DB2 9 z/OS Reference Guide >____________________________________________________________________>> |_NOT NULL________________________________________________________| |____________________________________ PRIMARY KEY ________________| | |_CONSTRAINT__constraint-name_| | |_UNIQUE______| | | | |_references-clause__________| | | |_CHECK(check-condition)_____| | | _WITH_ | |_|______|__DEFAULT_______________________________________________| | |_constant____________________________| | | |_SESSION_USER________________________| | | | |_USER__________| | | |_CURRENT SQLID_______________________| | | |_NULL________________________________| | | |_cast-function-name_(constant_)_____| | | |_SESSION_USER__| | | | |_USER___| | | | |_CURRENT SQLID_| | | |_NULL__________| | |_GENERATED_______ALWAYS__________________________________________| | |_BY DEFAULT_| |_as-identity-clause_____________| | | |_as-row-change-timestamp-clause_| | |_references-clause_______________________________________________| |_column-constraint_______________________________________________| |_FIELDPROC__program-name_________________________________________| | | >____built-in-data-type__________________________________________>< |_distinct-type-name_| built-in-data-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_FOR SBCS____DATA_| | | | | |___CHARACTER__VARYING_(_ integer _)_| |_MIXED_| | | | | | |_CHAR_____| | |_BIT___| | | | | |__VARCHAR____________| | | | | _(1M)______________ | | | |_____CHARACTER___LARGE OBJECT_ |___________________|___________________________________| | | | |_CHAR______| | |_(_integer ________)| |_FOR__SBCS____DATA_| | | |___CLOB____________________| |_K_| |_MIXED_| | | |_M_| | | |_G_| | | __(1)_____________ |

82

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |___GRAPHIC_|__________________|____________________________________________________________| | | |_(_integer___)____| | | | |_VARGRAPHIC__(__integer_)____________| | | | __(1M)_____________ | | |_DBCLOB_|___________________| | | |_(integer)______| | | |_K_| | | |_M_| | | |_G_| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | | | _(1M)____________________ | | | |_BINARY LARGE OBJECT_____|_________________________|_____|_______________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| | |_TIME______| | | |_TIMESTAMP_| | |_ROWID_____________________________________________________________________________________| |_XML_______________________________________________________________________________________|

as-identity-clause: >>__AS IDENTITY_____________________________________________________>< | >__FOR EACH ROW__ON UPDATE__AS ROW CHANGE__TIMESTAMP_______________>< column-constraint: >>_______________________________________PRIMARY KEY________________>< |_CONSTRAINT_constraint-name_|| |_UNIQUE________| | |_references clause____________| |_CHECK(_check-condition_)_____| unique-constraint: >________________________________PRIMARY KEY__(___column-name_|)___>< |_CONSTRAINT__constraint-name |_UNIQUE___| referential-constraint: >______________________________FOREIGN KEY_(_column-name_|_)________> ®

DB2 9 for z/OS

83

®

DB2 9 z/OS Reference Guide |_CONSTRAINT_constraint-name_| >__references-clause________________________________________________>< references-clause: >>__REFERENCES__table-name___________________________________________> | ___________________________________________________________________>< |_ON DELETE____RESTRICT____| |_NO ACTION_| |_CASCADE___| |_SET NULL__| _ENFORCED______ _ENABLE QUERY OPTIMIZATION_ >_____|_______________|_|___________________________|_______________>< |_NOT ENFORCED__| check-constraint: >>___________________________________CHECK__(check-condition)_______>< |_CONSTRAINT__constraint-name_| as-result_table: >>___________________AS_(fullselect)_WITH NO DATA___________________>< | >_v__|___________________________________________|______________|___> || _COLUMN ATTRIBUTES_ | | ||_INCLUDING IDENTITY__|___________________|_| | | _COLUMN ATTRIBUTES_ | | _EXCLUDING ROW CHANGE TIMESTAMP_|__________________|_ | |_|_____________________________________________________| | | | _COLUMN ATTRIBUTES_ | | | |_INCLUDING ROW CHANGE TIMESTAMP_|__________________|_| | | _COLUMN_ | | _EXCLUDING__|________|__DEFAULTS_ | |___|_________________________________|___________________| | _COLUMN_ | |_INCLUDING__|________|__DEFAULTS_| |_USING TYPE DEFAULTS_________________| partitioning-clause: _RANGE_ >__PARTITION BY__|_______|__(_partition-expression_|_)_______________> |_SIZE_______________________________________________| |__EVERY_ integer-constant_G_| __(_partition-element_____|__)_______________________________________>< partition-expression: _NULLS LAST_ _ASC__ >>__column-name__|____________|__|______|_____________________________>< |_DESC_| partition-element: 84

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide _AT_ >__PARTITION__integer__ENDING__|____|__(___constant_|_)______________> |_MAXVALUE_| |_MINVALUE_| _INCLUSIVE_ >__|_____________|__________________________________________________________________>< materialized-query-definition: >>__ _______________________ __AS__(fullselect)_______________________> | __ _________________________________________________________________>< |_ refreshable-table-options_____| refreshable-table-options: >>__DATA INITIALLY DEFERRED__REFRESH DEFERRED_________________________> ___ ________________________________|____________________________>< | _MAINTAINED BY SYSTEM_ | |_|______________________|_______| | |_MAINTAINED BY USER___| | | _ENABLE QUERY OPTIMIZATION__ | |_|____________________________|_| |_DISABLE QUERY OPTIMIZATION_|

CREATE TABLESPACE >>__CREATE______TABLESPACE__table-space-name___________________________> |_LARGE_| | _DSNDB04_______ | |_LOB___| |_IN_|_database-name_|_| ____________________|__________________________________________________> |_using-block_____| |_DSSIZE__integer__G_| |_free-block______| |_gbpcache-block__| |_trackmod-block__| | _YES_ | |_DEFINE__|_NO__|_| | _LOGGED_____ | |_|____________|__| |_NOT LOGGED_| >__________________________________________________________________________> |_MAXPARTITIONS_integer________________________________________________| |_MEMBER CLUSTER_______________________________________________________| |_NUMPARTS__integer____________________________________________________| | | >__USING____________________________________________________________> >____VCAT__catalog-name_____________________________________________>< | ______FREEPAGE__|_integer_|___|___________________________________>< | _5_______ | |_PCTFREE__|_integer_|__| gbpcache-block: _CHANGED_ >>__GBPCACHE__|_ALL_____|___________________________________________>< |_SYSTEM__| |_NONE____| trackmod-block: _YES_ >>__TRACKMOD__|_NO__|_______________________________________________>
>__CREATE TRIGGER__ trigger-name____NO CASCADE BEFORE_________________> |_AFTER_____________| |_INSTEAD OF________| >____INSERT_____________________________ON__table-name_________________> |_DELETE__________________________| |_UPDATE__________________________| | ______________________________________________________________________> | ____FOR EACH ROW_______________MODE DB2SQL____triggered-action______>< |_FOR EACH STATEMENT____| triggered-action >>_______________________________________SQL trigger body_____________> |_WHEN__(__search-condition__)_| __BEGIN ATOMIC____triggered-SQL-statement__;_|__END__________________>
>__CREATED TRUSTED CONTEXT__context-name_________________________________> >_BASED UPON CONNECTION USING SYSTEM AUTHID_authorization-name____________> _NO DEFAULT ROLE________________________________________ _DISABLE_ >_|________________________________________________________|__|________|__> | _WITHOUT ROLE AS OBJECT OWNER_ | |_ENABLE_| |_DEFAULT ROLE_role-name_|_____________________________|_| |_WITH ROLE AS OBJECT OWNER___| _NO DEFAULT SECURITY LABEL_________________ >_|___________________________________________|___________________________> |_DEFAULT SECURITY LABEL seclabel-name______| _ATTRIBUTES__(_____ADDRESS__address-value________|_______________________> | |_ENCRYPTION_encryption-value__| | | |_SERVAUTH_servauth-value______| | | _________________________________________________________________________> | | |_user-options__| | | _WITHOUT AUTHENTICATION__ | |_PUBLIC____|________________________|_____| |_WITH AUTHENTICATION____| user-options: _WITHOUT AUTHENTICATION_ >>________________________________________________|_______________________|_> |_ROLE_role-name_||_SECURITY LABEL_seclabel-name_||_WITH AUTHENTICATION___|

CREATE TYPE >>__CREATE TYPE_distinct-type-name_AS_source-data-type________________> source-data-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ®

DB2 9 for z/OS

87

®

DB2 9 z/OS Reference Guide ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_CCSID__ASCII___| |_FOR___SBCS____DATA_| | | | | |___CHARACTER__VARYING__(_integer_)__| |_EBCDIC__| |_MIXED_| | | | | | |_CHAR_____| | |_UNICODE_| |_BIT___| | | | | |__VARCHAR____________| | | | | _(1M)_______ | | | |_____CHARACTER___LARGE OBJECT_ |____________|__________________________________________| | | | |_CHAR______| ||_(integer )_| |_CCSID__ASCII___| |_FOR__SBCS____DATA_| | | |___CLOB_____________________| |_EBCDIC__| |_MIXED_| | | |_UNICODE_| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | |_CCSID___ASCII___| | | |_VARGRAPHIC__(_ integer_)____________| |_EBCDIC__| | | | __(1M)_____________ |_UNICODE_| | | |_DBCLOB_|___________________| | | |_(integer)______| | | |_K_| | | |_M_| | | |_G_| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | | | _(1M)____________________ | | | |_BINARY LARGE OBJECT_____|_________________________|_____|_______________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| | |_TIME______| | | |_TIMESTAMP_| | |_ROWID_____________________________________________________________________________________|

CREATE VIEW >>__CREATE VIEW__view-name_____________________________________________> | ____________________________________________ AS__fullselect ______> | __________________________________________________________________>< | _CASCADED_ | |_WITH__|__________|__CHECK OPTION_| |_LOCAL____|

DECLARE CURSOR _NO SCROLL__________________________ >>__DECLARE__cursor-name__|____________________________________|_____> | _ASENSITIVE_____________ | |__|________________________|_SCROLL_| 88

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |_INSENSITIVE____________| | _DYNAMIC_ | |_SENSITIVE_|_________|__| |_STATIC__| __CURSOR____ ____________________ _|________________________________> |_holdability________| |_returnability______| |_rowset-positioning_| >__FOR__ _select-statement_ ________________________________________>< |_statement-name___| holdability: _WITHOUT HOLD_ >>__|______________|_________________________________________________>< |_WITH HOLD_____| returnability: _WITHOUT RETURN_____________ >>__|____________________________|___________________________________>< | _TO CALLER_ | |_WITH RETURN__|______________|____| rowset-positioning: _WITHOUT ROWSET POSITIONING_ >>__|____________________________|___________________________________>< |_WITH ROWSET POSITIONING_____|

DECLARE GLOBAL TEMPORARY TABLE >>__DECLARE GLOBAL TEMPORARY TABLE__table-name________________________> _(_____column-spec___|_)_____________________________________________> |_LIKE___table-name____|____________________________| | |_view-name__| | |_copy-options_| |_as-result-table__________| ____________________________________|________________________________>< |_CCSID___ASCII_______________| | |_EBCDIC__| | | | |_UNICODE_| | _DELETE ROWS___ | |_ON COMMIT_|_PRESERVE_ROWS_|_| |_DROP_TABLE____| column spec: >>__column-name__data-type____________________________________________> ________________________________________________________|___________>< |_NOT NULL__________________________________________| | _WITH_ | |__|______|_DEFAULT_________________________________| | |_constant______| | | |_SESSION_USER__| | | ||_USER_______| | | | |_CURRENT SQLID_| | | |_NULL__________| | ®

DB2 9 for z/OS

89

®

DB2 9 z/OS Reference Guide |_GENERATED___ALWAYS________________________________| |_BY DEFAULT_| |_as-identity-clause_| data-type: >>___built-in type____________________________________________________>< |_distinct_type_name_| built-in-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_FOR___SBCS____DATA_| | | | |___CHARACTER__VARYING__(_integer_)__| |_MIXED_| | | | | |_CHAR_____| | |_BIT___| | | | |__VARCHAR____________| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | | | |_VARGRAPHIC__(_ integer_)____________| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | |___DATE____________________________________________________________________________________| |_TIME______| |_TIMESTAMP_|

as-result-table: >>____AS__(fullselect)__WITH NO DATA_________________________________>< copy-options: _COLUMN ATTRIBUTES_ _EXCLUDING IDENTITY__|___________________|_ >>__|___________________________________________|___________________> | _COLUMN ATTRIBUTES_ | |_INCLUDING IDENTITY__|___________________|_| _COLUMN_ _EXCLUDING_|________|_DEFAULTS_ >__|_______________________________|________________________________>< | _COLUMN_ | |_INCLUDING_|________|_DEFAULTS_| |_USING TYPE DEFAULTS________________| as-identity-clause: >>__AS IDENTITY______________________________________________________>< | __DECLARE____statement-name_|__STATEMENT__________________________>
>_DECLARE__table-name________________________________________________> |_view-name__| _TABLE(column-name__built-in-data-type____________________________|_)>< |_distinct-type-name_||_NOT NULL______________| |_NOT NULL WITH DEFAULT_|

DECLARE VARIABLE >_DECLARE__host-variable|_VARIABLE_|_______________|___________________>< ||_CCSID ASCII___| |_FOR SBCS DATA__|| ||_CCSID UNICODE_| |_FOR MIXED DATA_|| | |_FOR BIT DATA___|| |_CCSID__integer_____________________|

DELETE searched delete: >>__DELETE FROM____table-name_______________________________________> |_view-name__| |_correlation-name_| >___________________________________________________________________> |_include-column_| |_SET assignment-clause_| >___________________________________________________________________> |_WHERE__search-condition_| |_isolation-clause__| |_SKIP LOCKED DATA__| >__________________________________________________________________>< |_QUERYNO__integer_| positioned delete: >>__DELETE FROM____table-name____WHERE CURRENT OF__cursor-name_____>< |_view-name__| >__________________________________________________________________>< |_FOR ROW___host-variable______OF ROWSET_| |_integer-constant__| include-column: ®

DB2 9 for z/OS

91

®

DB2 9 z/OS Reference Guide >>__INCLUDE__(__column-name__data-type__)__________________________>< data-type: >>___built-in type_________________________________________________>< |_distinct_type_name_| built-in-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_FOR___BIT___DATA_| | | | |___CHARACTER__VARYING__(_integer_)__| | | | | |_CHAR_____| | | | | |__VARCHAR____________| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | | | |_VARGRAPHIC__(_ integer_)____________| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | |___DATE____________________________________________________________________________________| |_TIME______| |_TIMESTAMP_|

assignment-clause: >_____column-name___expression_____________________________|________>< | |_NULL_________| | | _WITH___RR_________________________________________________________>< |_RS_| |_CS_|

DESCRIBE CURSOR >>__DESCRIBE CURSOR____cursor-name______INTO__descriptor-name_______>< |_host-variable_|

DESCRIBE INPUT >>__DESCRIBE INPUT____statement-name____INTO__descriptor-name_______>< 92

®

DB2 9 for z/OS

®


DESCRIBE OUTPUT _OUTPUT_ >>_DESCRIBE_|________|_statement-name____INTO__descriptor-name______> >___________________________________________________________________>< | _NAMES__ | |_USING__|_LABELS_|_| |_ANY____| |_BOTH___|

DESCRIBE PROCEDURE >>__DESCRIBE PROCEDURE____procedure-name____INTO__descriptor-name___>< |_host-variable__|

DESCRIBE TABLE >>_DESCRIBE_TABLE___host-variable_________INTO__descriptor-name_____> >___________________________________________________________________>< | _NAMES__ | |_USING__|_LABELS_|_| |_ANY____| |_BOTH___|

DROP >>_DROP____ALIAS__alias-name______________________________________________>< |_DATABASE__database-name_________________________________________| |_TYPE______________distinct-type-name__RESTRICT__________________| |__FUNCTION__function-name______________________________RESTRICT__| | | | >____data-type_________________________________________________________>< |_AS LOCATOR____| data type: >>____built-in-data-type________________________________________________>< |_distinct-type-name_| built-in-data-type: >__SMALLINT___________________________________________________________________________________>< ®

DB2 9 for z/OS

93

®

DB2 9 z/OS Reference Guide | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_CCSID__ASCII___| |_FOR___SBCS____DATA_| | | | | |___CHARACTER__VARYING__(_integer_)__| |_EBCDIC__| |_MIXED_| | | | | | |_CHAR_____| | |_UNICODE_| |_BIT___| | | | | |__VARCHAR____________| | | | | _(1M)_______ | | | |_____CHARACTER___LARGE OBJECT_ |____________|__________________________________________| | | | |_CHAR______| ||_(integer )_| |_CCSID__ASCII___| |_FOR__SBCS____DATA_| | | |___CLOB_____________________| |_EBCDIC__| |_MIXED_| | | |_UNICODE_| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | |_CCSID___ASCII___| | | |_VARGRAPHIC__(_ integer_)____________| |_EBCDIC__| | | | __(1M)_____________ |_UNICODE_| | | |_DBCLOB_|___________________| | | |_(integer)______| | | |_K_| | | |_M_| | | |_G_| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | | | _(1M)____________________ | | | |_BINARY LARGE OBJECT_____|_________________________|_____|_______________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| | |_TIME______| | | |_TIMESTAMP_| | |_ROWID_____________________________________________________________________________________|

END DECLARE SECTION >>__END DECLARE SECTION_____________________________________________>
>__EXCHANGE DATA BETWEEN TABLE table-name1_AND_table-name2 ________>
>__EXECUTE__statement-name__________________________________________> >_______________________________________________________________>< | __ _USING___ _host-variable-array_ |__ ___________________________> | |_host-variable_______| | |_USING DESCRIPTOR__descriptor-name_| >__ _______________________________ ________________________________>< |_FOR_ _host-variable____ _ROWS_| |_integer-constant_|

EXECUTE IMMEDIATE >>__EXECUTE IMMEDIATE____string-expression___________________________>< |_host-variable_____|

EXPLAIN >>__EXPLAIN__________________________________________________________> >_ _ _PLAN_ __ _____________________ _FOR_sql-statement_ ___________>< | |_ALL__| |_SET QUERYNO=integer_| | |_STMTCACHE___ALL_____________________________________| | |_STMTID__ _id-host-variable_ _______| | | | |_integer-constant_| | | | |_STMTTOKEN__ _token-host-variable_ _| | | |_string-constant_____| | |_MONITORED_STMTS__scope-specification________________| Scope-specification: >>__SCOPE__AUTHID__authid-str__IPADDR__ip-address_______________________>< |_PLAN_plan-name______________________________________________| |_COLLECTION-colctn-name_PACKAGE-pckge-name_|

FETCH _FROM_ >>__FETCH__ ________________ ___fetch-orientation______|______|______> |_INSENSITIVE____| |_SENSITIVE______| >__cursor-name__ ________________________ __________________________>< |__ single-row-fetch ____| |__ multiple-row-fetch __| fetch-orientation: >_ _BEFORE________________ __________________________________________> |_AFTER_________________| |___row-positioned______| |___rowset-positioned___| row-positioned: _NEXT___________________________ __|________________________________|_______________________________> |_PRIOR__________________________| |_FIRST__________________________| |_LAST___________________________| |_CURRENT________________________| |_ABSOLUTE_ _host-variable____ __| | |_integer-constant_| | |_RELATIVE_ _host-variable____ __| |_integer-constant_| ®

DB2 9 for z/OS

95

®

DB2 9 z/OS Reference Guide rowset-positioned: _NEXT ROWSET____________________________________________ _______> |_PRIOR ROWSET___________________________________________| |_FIRST ROWSET___________________________________________| |_LAST ROWSET____________________________________________| |_CURRENT ROWSET_________________________________________| |_ROWSET STARTING AT_ _ABSOLUTE_ __ _host-variable____ __| |_RELATIVE_| |_integer-constant_| single-row-fetch: _________________________________ _______________________________> | |_FOR__ _host-variable____ __ROWS_| |_integer-constant_| >__ _________________________________ ____________________________> | __FREE LOCATOR____host_variable_|_________________________________>
>__GET DIAGNOSTICS__ __statement-information _ ____________________>< |__condition-information _| |__combined-information _| statement-information: __ ___host-variable1__=__| statement-information-item-name |_|_ __> |_host-variable1__=__DB2_GET_DIAGNOSTICS_DIAGNOSTICS_________| statement-information-item-name: ____ _DB2_LAST_ROW____________________ _|_________________________> |_DB2_NUMBER_PARAMETER_MARKERS____| |_DB2_NUMBER_RESULT_SETS__________| |_DB2_RETURN_STATUS_______________| |_DB2_SQL_ATTR_CURSOR_HOLD________| |_DB2_SQL_ATTR_CURSOR_ROWSET______| |_DB2_SQL_ATTR_CURSOR_SCROLLABLE__| |_DB2_SQL_ATTR_CURSOR_SENSITIVITY_| |_DB2_SQL_ATTR_CURSOR_TYPE________| |_MORE____________________________| |_NUMBER__________________________| |_ROW_COUNT_______________________| condition-information: >__CONDITION__ _host-variable2_ ___________________________________> |_integer________| __host-variable3__ =__ ___condition-information-item-name ___ _|__> |___connection-information-item-name __| 96

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide condition-information-item-name: >__ _CATALOG_NAME_______________ __________________________________> |_CONDITION_NUMBER___________| |_CURSOR_NAME________________| |_DB2_ERROR_CODE1____________| |_DB2_ERROR_CODE2____________| |_DB2_ERROR_CODE3____________| |_DB2_ERROR_CODE4____________| |_DB2_INTERNAL_ERROR_POINTER_| |_DB2_LINE_NUMBER____________| |_DB2_MESSAGE_ID_____________| |_DB2_MODULE_DETECTING_ERROR_| |_DB2_ORDINAL_TOKEN_n________| |_DB2_REASON_CODE____________| |_DB2_RETURNED_SQLCODE_______| |_DB2_ROW_NUMBER_____________| |_DB2_SQLERRD_SET____________| |_DB2_SQLERRD1_______________| |_DB2_SQLERRD2_______________| |_DB2_SQLERRD3_______________| |_DB2_SQLERRD4_______________| |_DB2_SQLERRD5_______________| |_DB2_SQLERRD6_______________| |_DB2_TOKEN_COUNT____________| |_MESSAGE_TEXT_______________| |_RETURNED_SQLSTATE__________| |_SERVER_NAME________________| connection-information-item-name: >__ _DB2_AUTHENTICATION_TYPE_ ____________________________________> |_DB2_AUTHORIZATION_ID____| |_DB2_CONNECTION_STATE____| |_DB2_CONNECTION_STATUS___| |_DB2_ENCRYPTION_TYPE_____| |_DB2_SERVER_CLASS_NAME___| |_DB2_PRODUCT_ID__________| combined-information: __host-variable4__=__ALL___ _STATEMENT___________________________|_>< |_ _CONDITION__ __ ________________ _| |_CONNECTION_| |_host-variable5_| |_integer________|

GRANT >>__GRANT__authorization-specification_______________________________> __TO______authorization-name________|______________________________>< |_PUBLIC__________________| |_WITH GRANT OPTION_| |_ROLE_role-name__________|

GRANT (collection privileges) >__GRANT____CREATE_______ON____COLLECTION______collection-id_|______> |_PACKADM_| |_IN_| |_*_________________| __TO______authorization-name___|___________________________________>< ®

DB2 9 for z/OS

97

®

DB2 9 z/OS Reference Guide |_PUBLIC_____________| |_ROLE_role-name_____|

|_WITH GRANT OPTION_|

GRANT (database privileges) __GRANT______DBADM_______|__ON DATABASE____database-name_|_________> |_DBCTRL____| |_DBMAINT___| |_CREATETAB_| |_CREATETS__| |_DISPLAYDB_| |_DROP______| |_IMAGCOPY__| |_LOAD______| |_RECOVERDB_| |_REORG_____| |_REPAIR____| |_STARTDB___| |_STATS_____| |_STOPDB____| __TO______authorization-name___|___________________________________>< |_PUBLIC_____________| |_WITH GRANT OPTION_| |_ROLE_role-name_____|

GRANT (type or JAR privileges) >__GRANT__USAGE ON__DISTINCT TYPE_______distinct-type-name_|________> | < |_PUBLIC_____________| |_WITH GRANT OPTION_| |_ROLE_role-name_____|

GRANT (function or procedure privileges) >>__GRANT__EXECUTE__ON________________________________________________> ____FUNCTION______function-name______________________________|_______> | | | ____data-type_____________________________________________________>< |_AS LOCATOR____| data type: >>____built-in-data-type____________________________________________>< |_distinct-type-name_| built-in data type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_CCSID__ASCII___| |_FOR___SBCS____DATA_| | | | | |___CHARACTER__VARYING__(_integer_)__| |_EBCDIC__| |_MIXED_| | | | | | |_CHAR_____| | |_UNICODE_| |_BIT___| | | | | |__VARCHAR____________| | | | | _(1M)_______ | | | |_____CHARACTER___LARGE OBJECT_ |____________|__________________________________________| | | | |_CHAR______| ||_(integer )_| |_CCSID__ASCII___| |_FOR__SBCS____DATA_| | | |___CLOB_____________________| |_EBCDIC__| |_MIXED_| | | |_UNICODE_| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | |_CCSID___ASCII___| | | |_VARGRAPHIC__(_ integer_)____________| |_EBCDIC__| | | | __(1M)_____________ |_UNICODE_| | | |_DBCLOB_|___________________| | | |_(integer)______| | | |_K_| | | |_M_| | | |_G_| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | | | _(1M)____________________ | | | |_BINARY LARGE OBJECT_____|_________________________|_____|_______________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| | |_TIME______| | | |_TIMESTAMP_| | |_ROWID_____________________________________________________________________________________|

GRANT (package privileges) >>__GRANT____ALL____________________ON____PACKAGE____________________> | |_*__________| __TO______authorization-name___|________________________________>< |_PUBLIC_____________| |_WITH GRANT OPTION_| |_ROLE_role-name_____|

GRANT (plan privileges) __GRANT______BIND______|__ON PLAN____plan-name_|___________________> |_EXECUTE_| __TO______authorization-name___|________________________________>< |_PUBLIC_____________| |_WITH GRANT OPTION_| |_ROLE_role-name_____|

GRANT (schema privileges) __GRANT______ALTERIN____|__ON__SCHEMA______schema-name_|___________> |_CREATEIN_| |_DROPIN___| __TO______authorization-name___|___________________________________>< |_PUBLIC_____________| |_WITH GRANT OPTION_| |_ROLE_role-name_____|

GRANT (sequence privileges) __GRANT______ALTER____|__ON_SEQUENCE______sequence-name_|___________> |_USAGE____| |_*_______________| __TO______authorization-name___|___________________________________>< |_PUBLIC_____________| |_WITH GRANT OPTION_| |_ROLE_role-name_____|

GRANT (system privileges) __GRANT______ARCHIVE_______|__TO______authorization-name___|____> |_BINDADD_____| |_PUBLIC_____________| |_BINDAGENT___| |_ROLE_role-name_____| |_BSDS________| |_CREATEALIAS_| |_CREATEDBA___| |_CREATEDBC___| |_CREATESG____| |_CREATETMTAB_| |_DISPLAY_____| |_MONITOR1____| 100

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |_MONITOR2____| |_RECOVER_____| |_STOPALL_____| |_STOSPACE____| |_SYSADM______| |_SYSCTRL_____| |_SYSOPR______| |_TRACE_______| >___________________________________________________________________>< |_WITH GRANT OPTION_|

GRANT (table or view privileges) _PRIVILEGES_ >>__GRANT____ALL__|____________|_____________________________________> | >__GRANT USE OF____________________________________________________> ____BUFFERPOOL___bpname|___________________________________________> |_ALL BUFFERPOOLS______________________________________ | __HOLD LOCATOR____host_variable_|_________________________________>
>__INCLUDE____SQLCA________________________________________________>< |_SQLDA_______| |_member-name_|

INSERT >>__INSERT INTO____table-name________________________________________> |_view-name__| | ____________________________________________________________________> |_include-column_| |_OVERRIDING USER VALUE_| >____VALUES_____expression__________________________________________>< | | |_DEFAULT____| | | | | |_NULL_______| | | | | < data-type: >>___built-in type_______________________________________________>< |_distinct_type_name_| built-in-type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________|

102

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide | | | |_CHAR______| |_(_integer_)____| | |_FOR___BIT___DATA_| | | | |___CHARACTER__VARYING__(_integer_)__| | | | | |_CHAR_____| | | | | |__VARCHAR____________| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | | | |_VARGRAPHIC__(_ integer_)____________| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | |___DATE____________________________________________________________________________________| |_TIME______| |_TIMESTAMP_|

multi-row-insert: >>__VALUES__ _ _expression__________ _______ ___________________> | |_host-variable-array_| | | |_NULL________________| | | |_DEFAULT_____________| | | __ ____________________________________ ____________________> | | |_FOR__ _host-variable____ __ROWS____| |_integer-constant_| _ATOMIC_________________________________ >__|________________________________________|______________>< | | |_NOT ATOMIC CONTINUE ON SQLEXCEPTION____|

LABEL ON >>__LABEL ON___TABLE____table-name________________IS_string-constant_>< | | |_view-name__| | | | |_ALIAS__alias-name_________________| | | |_COLUMN____table-name.column-name__| | | |_view-name.column-name__| | | >__LOCK TABLE__table-name___________________________________________> |_PARTITION__integer_| >__IN____SHARE________MODE__________________________________________>< |_EXCLUSIVE_|

MERGE >>__MERGE INTO____table-name________________________________________> |_view-name__| | _AS_ | |_|____|_correlation-name_| >___________________________________________________________________> ®

DB2 9 for z/OS

103

®

DB2 9 z/OS Reference Guide |_include-column_| >__USING_source-table_ON_search-condition___________________________>< ___WHEN_matching-condition_THEN_modification-operation___|_________> >___________________________________________________________________>< |_NOT ATOMIC CONTINUE ON SQL EXCEPTION_| |_QUERYNO_integer_| include-column: >__INCLUDE__(__column-name__data-type_|_)_______________________>< data-type: >>___built-in type_______________________________________________>< |_distinct_type_name_| built-in-type: >__SMALLINT___________________________________________________________________________________>< | |_INTEGER__| | | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_FOR___BIT___DATA_| | | | |___CHARACTER__VARYING__(_integer_)__| | | | | |_CHAR_____| | | | | |__VARCHAR____________| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | | | |_VARGRAPHIC__(_ integer_)____________| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | |___DATE____________________________________________________________________________________| |_TIME______| |_TIMESTAMP_|

source-table: _AS_ >_(VALUES__values-single-row____)_|__|_correlation-name_(_column-name_|_)_>< |_values-multiple-row_| values-single-row: >>____expression__________________________________________________________>< | |_NULL_______| | | >____expression__________________FOR__host-variable____________ROWS______>< | |_host-variable-array_| | |_integer-constant_| | |_NULL_______| | | >_____________MATCHED_____________________________________________________>< |_NOT_| Modification-operation: >>______UPDATE SET___assignment-clause_____________________________________>< |_insert-operation___________________| Assignment-clause: >_column-name______expression_________________________________|___________>< | |_DEFAULT_______| | | |_NULL__________| | | __INSERT______VALUES__________________expression_________________>< | __OPEN__cursor-name_______________________________________________>< | >__PREPARE__statement-name__________________________________________> >____________________________________________________________________> |_INTO__descriptor-name________________________| | _NAMES__ | |_USING__|_LABELS_|_| |_ANY____| |_BOTH___| >__FROM____string-expression________________________________________>< |______________________________________FROM_host-variable_____| |__ATTRIBUTES__attr-host-variable_| attribute-string ®

DB2 9 for z/OS

105

®

DB2 9 z/OS Reference Guide >______ ASENSITIVE __________|______________________________________>< ||__INSENSITIVE___________| | ||__SENSITIVE__STATIC_____| | | |_DYNAMIC_| | | _NO SCROLL_ | |_|_SCROLL____|_________________________| |_holdability___________________________| |_returnability_________________________| |_rowset-positioning____________________| |_fetch-first-clause____________________| |__read-only-clause_____________________| | |_update-clause___| | |_optimize-clause_______________________| |_isolation-clause______________________| |__FOR MULTIPLE ROWS____________________| | |_FOR SINGLE ROW___| | | _ATOMIC_ | |_|________|____________________________| | |_NOT ATOMIC CONINUE ON SQLEXCEPTION_|| |_SKIP LOCKED DATA______________________| holdability : >>_________________________________________________________________>< |_WITHOUT HOLD_| |_WITH HOLD____| returnability : >>_________________________________________________________________>< |_WITHOUT RETURN____________| | _TO CALLER_ | |_WITH RETURN_|___________|_| rowset-positioning : >>_________________________________________________________________>< |_WITHOUT ROWSET POSITIONING_| |_WITH ROWSET POSITIONING____|

REFRESH TABLE >>__REFRESH_TABLE table-name________________________________________>< |_QUERYNO integer_|

RELEASE >>__RELEASE____location-name________________________________________>< |_host-variable_| |_CURRENT_______| | _SQL_ | |_ALL_|_____|___|

RELEASE SAVEPOINT _TO_ >>__RELEASE___|____|___SAVEPOINT__svpt-name_________________________>< 106

®

DB2 9 for z/OS

®


RELEASE (connection) >>__RELEASE__ _location-name_ ______________________________________>< |_host-variable_| |_CURRENT_______| | _SQL_ | |_ALL_|_____|___|

RENAME _TABLE_ >>__RENAME__|_______|__source-table-name__TO__new-table-identifier__>< |_INDEX__source-index-name__TO__new-index-identifier___|

REVOKE >>__REVOKE__authorization-specification______________________________> __FROM______authorization-name________|_____________________________> |_PUBLIC__________________| |_ROLE-role-name__________| >___________________________________________________________________>< | __REVOKE____CREATE_______IN____COLLECTION______collection-id_|_____> |_PACKADM_| |_ON_| |_*_________________| __FROM______authorization-name___|__________________________________> |_PUBLIC_____________| |_ROLE-role-name_____| >___________________________________________________________________>< | |_DBCTRL____| |_DBMAINT___| |_CREATETAB_| |_CREATETS__| |_DISPLAYDB_| |_DROP______| |_IMAGCOPY__| |_LOAD______| |_RECOVERDB_| |_REORG_____| |_REPAIR____| |_STARTDB___| ®

DB2 9 for z/OS

107

®

DB2 9 z/OS Reference Guide |_STATS_____| |_STOPDB____| __FROM______authorization-name___|__________________________________> |_PUBLIC_____________| |_ROLE-role-name_____| >___________________________________________________________________>< | __REVOKE__USAGE ON__DISTINCT TYPE_______distinct-type-name_|_______> | |_PUBLIC_____________| |_ROLE-role-name_____| >______________________________________RESTRICT_____________________>< | >__REVOKE__EXECUTE__ON_______________________________________________> ____FUNCTION__function-name______________________________|___________> | | | < |_AS LOCATOR____| data type: >>____built-in-data-type____________________________________________>< |_distinct-type-name_| built-in data type: >__SMALLINT__________________________________________________________________________________>< | |_INTEGER__| |

108

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide | | |INT__| | | | |_BIGINT___| | | ______(5,0)______________________ | |__DECIMAL____|_________________________________|___________________________________________| ||_DEC_____| |_(__integer_________________)____| | ||_NUMERIC_| |_, integer_| | | _(34)_ | |_DECFLOAT_ |______|________________________________________________________________________| | |_(16)_| | | _(53)__________ | |___FLOAT__|_______________|________________________________________________________________| | | |_(__integer__)_| | |_|_REAL___________________| | | | _PRECISION_ | | |_|_DOUBLE__|___________|__| | | __(1)___________ | |_______CHARACTER____|________________|_____________________________________________________| | | | |_CHAR______| |_(_integer_)____| | |_CCSID__ASCII___| |_FOR___SBCS____DATA_| | | | | |___CHARACTER__VARYING__(_integer_)__| |_EBCDIC__| |_MIXED_| | | | | | |_CHAR_____| | |_UNICODE_| |_BIT___| | | | | |__VARCHAR____________| | | | | _(1M)_______ | | | |_____CHARACTER___LARGE OBJECT_ |____________|__________________________________________| | | | |_CHAR______| ||_(integer )_| |_CCSID__ASCII___| |_FOR__SBCS____DATA_| | | |___CLOB_____________________| |_EBCDIC__| |_MIXED_| | | |_UNICODE_| | | __(1)_____________ | |___GRAPHIC_|__________________|____________________________________________________________| | | |_(__integer__)____| | |_CCSID___ASCII___| | | |_VARGRAPHIC__(_ integer_)____________| |_EBCDIC__| | | | __(1M)_____________ |_UNICODE_| | | |_DBCLOB_|___________________| | | |_(integer)______| | | |_K_| | | |_M_| | | |_G_| | | _(1)________ | |_ _BINARY__|____________|__________________________________________________________________| | | |_(integer)__| | | | |__BINARY VARYING _(integer)______________________________| | | | |_VARBINARY_____| | | | | _(1M)____________________ | | | |_BINARY LARGE OBJECT_____|_________________________|_____|_______________________________| | |_BLOB________________| |_(__integer_________)____| | | |_K_| | | |_M_| | | |_G_| | |___DATE____________________________________________________________________________________| | |_TIME______| | | |_TIMESTAMP_| | |_ROWID_____________________________________________________________________________________|

REVOKE (package privileges) >>__REVOKE____ALL____________________________________________________> | |_PROGRAM_| |_*__________| __FROM______authorization-name___|__________________________________> |_PUBLIC_____________| |_ROLE_role-name_____| >____________________________________________________________________>< | |_EXECUTE_| __FROM______authorization-name___|__________________________________> |_PUBLIC_____________| |_ROLE_role-name_____| >___________________________________________________________________>< | |_CREATEIN_| |_*_______________| |_DROPIN___| __FROM______authorization-name___|__________________________________> |_PUBLIC_____________| |_ROLE_role-name_____| >___________________________________________________________________>< | |_USAGE______| __FROM______authorization-name___|__________________________________> |_PUBLIC_____________| |_ROLE_role-name_____| _RESTRICT_ >__________________________________________|__________|_____________>< | |_BINDADD_____| |_PUBLIC_____________| |_BINDAGENT___| |_ROLE_role-name_____| 110

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |_BSDS________| |_CREATEALIAS_| |_CREATEDBA___| |_CREATEDBC___| |_CREATESG____| |_CREATETMTAB_| |_DISPLAY_____| |_MONITOR1____| |_MONITOR2____| |_RECOVER_____| |_STOPALL_____| |_STOSPACE____| |_SYSADM______| |_SYSCTRL_____| |_SYSOPR______| |_TRACE_______| >___________________________________________________________________>< | >__REVOKE____ALL__|____________|____________________________________> | |_view-name__| __FROM______authorization-name________|_____________________________> |_PUBLIC__________________| |_ROLE_role-name__________| >___________________________________________________________________>< | >__REVOKE USE OF____________________________________________________> ____BUFFERPOOL____bpname_|__________________________________________> |_ALL BUFFERPOOLS______________________________________| | ___________________________________________________________________>< | >__ROLLBACK__|______|______________________________________________>< |_TO SAVEPOINT________________| |_svpt-name_|

SAVEPOINT >>__SAVEPOINT__svpt-name_____________________________________________> |_UNIQUE_| >__ON ROLLBACK RETAIN CURSORS________________________________________> _ON ROLLBACK RETAIN LOCKS____ >___|_____________________________|_________________________________>
__select-clause__INTO____host-variable_|_from-clause_______________> |_where-clause_| >____________________________________________________________________> |_group-by-clause_| |_having-clause_| |_order-by-clause_| ________________________|__________________________________________>< |_SKIP_LOCKED_DATA_| |_QUERYNO__integer_| |_WITH____RR_______| |_RS_| |_CS_| |_UR_| >__ ____________________________________ ___________________________>< | _1_ | |_FETCH FIRST__|___|__ _ROW__ __ONLY_| |_ROWS_|

SET CONNECTION >>__SET CONNECTION____location-name_________________________________>< |_host-variable___|

SET CURRENT APPLICATION ENCODING SCHEME _APPLICATION_ 112

_=_ ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide >>__SET CURRENT_|_____________|_ENCODING SCHEME__|___|______________> >___string-constant_________________________________________________>< |_host-variable____|

SET CURRENT DEBUG MODE _=_ >>__SET CURRENT_DEBUG MODE_|___|___host-variable____________________>< |_DISALLOW______| |_ALLOW_________| |_DIABLE________|

SET CURRENT DECFLOAT ROUNDING MODE _=_ >>__SET CURRENT DECFLOAT ROUNING MODE_|___|___ROUND_CEILING_________>< |_ROUND_DOWN__________| |_ROUND_FLOOR_________| |_ROUND_HALF_DOWN_____| |_ROUND_HALF_EVEN_____| |_ROUND_HALF_UP_______| |_ROUND_UP____________| |_string-constant_____| |_host-variable_______|

SET CURRENT DEGREE >>__SET CURRENT DEGREE =___string-constant__________________________>< |_host-variable___|

SET CURRENT LOCALE LC_CTYPE _=_ >>__SET_____________________________LC_CTYPE_____|___|_______________> | |_CURRENT_____________| | | |_LOCALE_| | |_CURRENT_LC_CTYPE__________________| >____string-constant________________________________________________>< |_host-variable___|

SET CURRENT MAITAINED TABLE TYPES FOR OPTIMIZATION _TABLE_ _FOR OPTIMIZATION_ _=_ >>__SET CURRENT MAINTAINED_|_______|_TYPES_|__________________|_|___|_> >__ALL____________ ___________________________________________________>< |_NONE__________| |_SYSTEM________| |_SESSION_USER__| ||_USER________|| |_host-variable_|

SET CURRENT OPTIMIZATION HINT >>__SET CURRENT OPTIMIZATION HINT =____string-constant______________>< ®

DB2 9 for z/OS

113

®

DB2 9 z/OS Reference Guide |_host-variable___|

SET CURRENT PACKAGE PATH _=_ >__SET CURRENT PACKAGE PATH_|___|___ _collection-id___________ |___>< |_SESSION_USER____________| ||_USER__________| | |_CURRENT PACKAGE PATH____| |_CURRENT PATH____________| |_host-variable___________| |_string-constant_________|

SET CURRENT PACKAGESET >>__SET CURRENT PACKAGESET =____SESSION USER________________________>< ||_USED________| | |_string-constant_| |_host-variable___|

SET CURRENT PRECISION >>__SET CURRENT PRECISION =____string-constant______________________>< |_host-variable___|

SET CURRENT REFRESH AGE _=_ >>__SET CURRENT REFRESH AGE___|___|___ _numeric-constant_ __________>< |_ANY______________| |_host-variable____|

SET CURRENT RULES >>__SET CURRENT RULES =____string-constant__________________________>< |_host-variable___|

SET CURRENT ROUTINE VERSION _=_ >>__SET CURRENT ROUTINE VERSION_|___|__routine-version-id___________>< |_string-constant___| |_host-variable_____|

SET CURRENT SQLID >>__SET CURRENT SQLID =___SESSION_USER______________________________>< ||_USER________| | |_string-constant_| |_host-variable___|

SET ENCRYPTION PASSWORD _=_ >>__SET ENCRYPTION PASSWORD___|___|___ _password-host-variable______> |_password-string-const__| >__________________________________________________________________>< | _=_ | 114

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |_WITH HINT_|___|__hint-host-variable___| |_hint-string-const__|

SET HOST VARIABLE ASSIGNMENT >>__SET__ _host-variable=_ _CURRENT SERVER__________________________>< | |_CURRENT PACKAGESET___| | | |_CURRENT PACKAGE PATH_| | | < |_SYSTEM PATH__________| |_SESSION_USER_________| ||_USER__________| | | _CURRENT_ | |_|_________|__PATH____| |_CURRENT PACKAGE PATH_| |_host-variable________| |_string-constant______|

SET SCHEMA _CURRENT_ _=_ >>__SET__|_________|__SCHEMA___|___|____schema-name___________________> |_CURRENT_SCHEMA_____| |_SESSION USER_________| ||_USER____________| | |_host-variable________| |_string-constant______| |_DEFAULT______________|

SET TRANSITION VARIABLE >>__SET__ _transition-variable=___expression_______________________>< | |_DEFAULT___| | | |_NULL______| | | < |_correlation-name._|

SIGNAL SQLSTATE _VALUE_ >>__SIGNAL__SQLSTATE_|_______|__sqlstate-string-constant_____________> | |_variable_name___________| | |_condition-name_________________________________| >__(__diagnostic-string-constant__)_________________________________>
>__TRUNCATE_|_______|___table-name__|______________|________________> _IGNORE DELETE TRIGGERS____________ >_____|__RESTRICT WHEN DELETE TRIGGERS____|_________________________>< |_IMMEDIATE_|

UPDATE searched update: >>__UPDATE____table-name_____________________________________________> |_view-name__| |_correlation-name_| |_include_column_| >__SET__assignment-clause____________________________________________> |_WHERE__search-condition_| >___________________________________________________________________>< |_SKIP LOCKED DATA_| |_QUERYNO__integer_| |_WITH____RR_______| |_RS_| |_CS_| positioned update: >>__UPDATE___table-name_______________________SET_assignment-clause___> |_view-name__| |_correlation-name_| >_WHERE CURRENT OF_cursor-name________________________________________>< |_FOR ROW__host-variable___OF ROWSET_| |integer-constant| include-column: >_INCLUDE_(__column-name____data-type__|___)________________________>< data-type: >>___built-in type____________________________________________________>< |_distinct_type_name_| built-in-type: >__SMALLINT__________________________________________________________________________________>
______column-name=___expression________________________________|__>< | |_DEFAULT_______________| | | |_NULL__________________| | | |_(scalar-fullselect__)_| | | __VALUES____expression____________________________________________>< | __VALUES______expression______________INTO__host-variable_|_______>< ||_NULL_________________|| ||_CURRENT SERVER_______|| ||_CURRENT PACKAGESET___|| ||_CURRENT PACKAGE PATH_|| | >__WHENEVER____NOT FOUND_______CONTINUE____________________________>< |_SQLERROR___| |___GOTO_____host-label_| |_SQLWARNING_| |_GO TO_|

118

®

DB2 9 for z/OS

®


Commands -ACCESS DATBASE(DB2) >__ACCESS DATABASE__(_ ___database-name_|_____ _)____________________> |_*_____________________| |_dbname1:dbname2_______| |_dbname*_______________| |_*dbname_______________| |_*dbname*______________| |_*dbstring1*dbstring2*_| > ____________________________________________________________________> | < |_ngdbdep_|

-ALTER BUFFERPOOL >>__ALTER BUFFERPOOL__(__bpname__)__ _________________ ______________> |_VPSIZE(integer)_| >__ _________________ __ __________________ _________________________> |_VPSEQT(integer)_| |_VPPSEQT(integer)_| >__ ___________________ __ __________________________________________> |_VPXPSEQT(integer)_| |_DWQT(integer)_| >__ __________________________ ______________________________________> |_VDWQT(integer1,integer2)_| >__ _________________________ _______________________________________> |_PGSTEAL__(____LRU_____)_|

|_FIFO_| >__ _________________________________________________________________>< | __NO___ | | _NO__ | |_PGFIX__(_|__YES__|__)_| |_AUTOSIZE_(_|_YES_|_)_| -ALTER GROUPBUFFERPOOL >>__ALTER GROUPBUFFERPOOL__(__ _gbpname________ __)__________________> |_structure-name_| >__ _____________________ __ ____________________ ___________________> |_GBPCACHE(_ _YES_ _)_| |_AUTOREC(_ _YES_ _)_| |_NO__| |_NO__| >__ ______________ __ _________________ __ __________________ _______> |_RATIO(ratio)_| |_CLASST(integer)_| |_GBPOOLT(integer)_| >__ ___________________ ____________________________________________>< |_GBPCHKPT(integer)_| ®

DB2 9 for z/OS

119

®


-ALTER UTILITY >>__ALTER__UTILITY__(__utility-id__)__REORG__________________________> |_REBUILD_| >__ ___________________________ __ ______________________ ___________> |_DEADLINE(_ _NONE______ _)_| |_MAXRO(_ _integer_ _)_| |_timestamp_| |_DEFER___| >__ _________________________ __ ______________________ ____________>< |_LONGLOG(_ _CONTINUE_ _)_| |_DELAY(___integer___)_| |_TERM_____| |_DRAIN____|

-ARCHIVE LOG >>__ARCHIVE LOG______________________________________________________> _SCOPE(MEMBER)_____________________________________ >__|___________________________________________________|____________>< |_SCOPE(GROUP)______________________________________| |_MODE(QUIESCE)__ ___________ __ _________________ _| | |_TIME(nnn)_| | _NO__ | | | |_WAIT(_|_YES_|_)_| | |_CANCEL OFFLOAD____________________________________|

-BIND PACKAGE >>_BIND PACKAGE_(________________collection-id__)_____________________)_____> |_location-name._| |_OWNER(authorization-id)_| >________________________________enable-block_______________________________> |_QUALIFIER(qualifier-name)_| >___MEMBER(dbrm-member-name)________________________________________________> | |_LIBRARY(dbrm-pds-name)_| | |_COPY(collection-id.package-id)__________________________________________| |_COPYVER(version-id)_| >___________________________________________________________________________> | _COMPOSITE_ | |OPTIONS(|_COMMAND___|)| >___________________________________________________________________________> |_DEFER(PREPARE)___| |_ACTION__(REPLACE)____________________________| |_NODEFER(PREPARE)_| | |_REPLVER(version-id)_| | |_(ADD)___________________________| >___________________________________________________________________________> | _NO__ | |_CURRENTDATA(_|_YES_|_)| >__ ________________________________________________________________________> |_DBPROTOCOL__(___DRDA____)_|| _1___ ||_DYNAMICRULES(_RUN_)_| |_PRIVATE_| |_DEGREE(_|_ANY_|_)_| |_BIND_______| |_DEFINEBIND_| |_DEFINERUN__| |_INVOKEBIND_| |_INVOKERUN__| >___________________________________________________________________________> |_ENCODING(_ _ASCII___)_| | _NO__ | | _I_ | |_EBCDIC__| |_EXPLAIN(_|_YES_|_)_| |_FLAG(_|_W_|_)_| 120

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |_UNICODE_| |_E_| |_ccsid___| |_C_| >___________________________________________________________________________> |_IMMEDWRITE_(_NO_)_| |_ISOLATION(_ _RR_ _)_| |_YES_| |_RS_| |_CS_| |_UR_| |_NC_| __NONE__ >____________________________________|________|_____________________________> | _NO__ | |_REOPT(_|_ALWAYS_|_)|_OPTHINT__(_'hint-id'__)_| |_KEEPDYNAMIC(_|_YES_|_)_| |_ONCE___| |_AUTO___| >___________________________________________________________________________> | ___________________________________________________________________________> < | _NOPACKAGE_ | | _RUN__ | |_SQLERROR(_|_CONTINUE__|_)_| |_VALIDATE(_|_BIND_|_)_| enable-block: >>__ ______________________________________________________________________>< | _ENABLE(*)________________________ | | | | _(__REPLACE__)__ ________ _ | |_CACHESIZE(decimal-value)_| | | |_RETAIN_| | | |_ACTION__|_(ADD)_____________________|_| >__ ________________________________________________________________________> | _NO__ | |_CURRENTSERVER(location-name)_| |_CURRENTDATA(_|_YES_|_)_| >__ ________________________________________________________________________> |_DBPROTOCOL__(__ _DRDA____ __)_| | _1___ | ®

DB2 9 for z/OS

121

®

DB2 9 z/OS Reference Guide |_PRIVATE_| |_DEGREE(_|_ANY_|_)_| >__ __________________________________________ _____________________________> | _EXPLICIT____ | | _RUN__ | |_DISCONNECT(_|_AUTOMATIC___|_)_| |_DYNAMICRULES(_|_BIND_|_)_| |_CONDITIONAL_| >___________________________________________________________________________> |_ENCODING(_ _ASCII___ _)_| | _NO__ | | _I_ | |_EBCDIC__| |_EXPLAIN(_|_YES_|_)_| |_FLAG(_|_W_|_)_| |_UNICODE_| |_E_| |_ccsid___| |_C_| >__ ________________________________________________________________________> |_IMMEDWRITE(_ _NO__ _)_||_ISOLATION(_ _RR_ _)_|| _NO__ | |_YES_| |_RS_| |_KEEPDYNAMIC(_|_YES_|_)| |_CS_| |_UR_| __NONE__ >_REOPT_(|_ALWAYS_|)_______________________________________________________> |_ONCE___| |_OPTHINT_(_'hint-id'_)_|| ___________________________________________________________________________> | _COMMIT_____ || _DB2_ || _RUN__ | |_RELEASE(_|_DEALLOCATE_|_)_||_SQLRULES(_|_STD_|_)||_VALIDATE(_|_BIND_|_)_| >__________________________________________________________________________>< |_ROUNDING(_CELING___)__| |_DOWN_____| |_FLOOR____| |_HALFDOWN_| |_HALFEVEN_| |_HALFUP___| |_UP_______| enable-block: >>_ _______________________________________________________________________>< | _ENABLE(*)________________________ | | | __RESET____________________________________________________________>
>__DCLGEN__TABLE(_ _table-name_ _)__ ___________________ ____________> |_view-name__| |_OWNER(owner-name)_| >__ ___________________ _____________________________________________> |_AT(location-name)_| >__LIBRARY(library name_ _______________ __ ___________ _)___________> |_(member-name)_| |_/password_| >__ _______________________ __ ________________________ _____________> | _ADD_____ | | | |_ACTION(_|_REPLACE_|_)_| |_LANGUAGE(___PLI______)_| |_C______| |_IBMCOB_| |_CPP____| >__ _______________ __ ___________________________ __ _______ ________> |_NAMES(prefix)_| |_STRUCTURE(structure-name)_| |_APOST_| |_QUOTE_| >__ ________________ __ _____________________ ________________________> | _NO__ | |_DBCSSYMBOL(_ _G_ _)_| |_LABEL_|_YES_|__| |_N_| >__ ______________________ __ ______________________ _________________> | _YES_ | | _NO__ | |_DBCSDELIM(_|_NO__|_)_| |_COLSUFFIX(_|_YES_|_)_| >__ ___________________ ______________________________________________>< | _NO__ | | _STD__ | |_INDVAR(_|_YES_|_)_| |_RMARGIN_(_|_WIDE_|_)_|

/DISPLAY IMS >__/DISPLAY__ _SUBSYS___subsystem-name_|______ ________________________>< |_SUBSYS__ALL____________________| | >__DISPLAY ARCHIVE_____________________________________________________>
>__DISPLAY BUFFERPOOL__|__________________|_____________________________> |_(__*__)__________| | __ ________________________ __ ____________________ ___________________> | _INTERVAL_ | | _ACTIVE_ | |_DETAIL(_|__________|_)_| |_LIST(_|________|_)_| |_*________| |_*______| _ACTIVE_ >__ ________ __(__|________|__)_________________________________________> |_LSTATS_| |_*______| >__ _________________________________ __________________________________> | _*_________________ | | | __ ________________________________ __ ___________________ ____________> | _*______________ | |_GBPDEP(_ _YES_ _)_| | | __ _____________________ _____________________________________________>< |_CASTOWNR(_ _YES_ _)_| |_NO__|

-DISPLAY DATABASE >__DISPLAY DATABASE__(_ ___database-name_|_____ _)______________________> |_*_____________________| |_dbname1:dbname2_______| |_dbname*_______________| |_*dbname_______________| |_*dbname*______________| |_*dbstring1*dbstring2*_| >_ _ __________ __________________________________________________________> | |_USE______| | | |_CLAIMERS_| | | |_LOCKS____| | | |_LPL______| | | |_WEPR_____| | | ________________________________________________________________________>< | ________________________________________________________________________>< | |_50______ | |_LIMIT(_|_integer_|_)_| |_*_______| >________________________________________________________________________>< |_AFTER_||_ACTIVE_||_RESTRICT___(______)_||_ADVISORY__(__ ___________)_| | __DISPLAY DDF__ ________ _____________________________________________>< |_DETAIL_|

-DISPLAY FUNCTION SPECIFIC >>__DISPLAY FUNCTION SPECIFIC___________________________________________> _(*.*)_____________________________________ >__|___________________________________________|________________________> | __ ______________________ _____________________________________________>< | _LOCAL_ | |_SCOPE__(_|_______|_)_|

|_GROUP_|

®

DB2 9 for z/OS

125

®


-DISPLAY GROUP >>__DISPLAY GROUP__ ________ ___________________________________________>< |_DETAIL_|

-DISPLAY GROUPBUFFERPOOL >>__DISPLAY GROUPBUFFERPOOL__ ________________________________ _________> | _(*)________________________ | | | __ _________________________ __ _______________________________ ____> | _*_______ | |_MDETAIL__ __________________ _| |_TYPE__(__|_GCONN___|__)_| | _INTERVAL_ | |_MCONN___| |_(_|__________|_)_| |_NOCACHE_| |_*________| >__ _______________________________ __ _________________________ ____>< |_GDETAIL__ __________________ _| | _NO__ | | _INTERVAL_ | |_CONNLIST__(__|_YES_|__)_| |_(_|__________|_)_| |_*________|

-DISPLAY LOCATION _(*)_____________________________ >>__DISPLAY LOCATION__|_________________________________|_______________> | __ ________ __________________________________________________________>< |_DETAIL_|

-DISPLAY LOG >>__DISPLAY LOG_________________________________________________________>
>__DISPLAY PROCEDURE__|____________________________________|___________> | ______________________________________________________________________>< | _LOCAL_ | |_SCOPE__(_|_______|_)_| |_GROUP_| 126

®

DB2 9 for z/OS

®


-DISPLAY PROFILE >>__DISPLAY PROFILE____________________________________________________>
>__DISPLAY RLIMIT_____________________________________________________>
>__DISPLAY THREAD___ ___________________________________ _____________> | __ _______________________ __ _______________________ ______________> | _LOCAL__ | | _ACTIVE____ | |_SCOPE__(_|________|_)_| |_TYPE(_|_INDOUBT___|_)_| |_GROUP__| |_*_________| |_INACTIVE__| |_POSTPONED_| |_PROC______| |_SYSTEM____| >__ _______________________________________________ __ ________ _____> | < | >__DISPLAY TRACE__|_______________|__ ______________________ _______> |_(__PERFM__)___| | _LOCAL_ | |_(__ACCTG__)___| |_SCOPE__(_|_______|_)_| |_(__STAT__)____| |_GROUP_| |_(__AUDIT__)___| |_(__MONITOR__)_| >__ ___________________ __ __________________ _______________________> |_destination block_| |_constraint block_| >__ _____________________ __ _________________ _____________________>< |_DETAIL(output-type)_| |_COMMENT(string)_| |_RMID_| destination block: __DEST(__ _GTF_ |_)_________________________________________________> |_SMF_| ®

DB2 9 for z/OS

127

®

DB2 9 z/OS Reference Guide |_SRV_| |_OPn_| constraint block: _*_____________ _*__________________________ | |_partial-package-location_| _*______________ | __AUTHID(_|___auth-id_|____|_)__________________________________________> |_partial-userid_| _*___________ _*___________ | _*_________________ | __LOCATION(_|___location-name_|_|_)____________________________________> |___________| |_partial-element___| |_ipaddr____________| |_partial-ipaddr____| _*______________ | __USERID(_|___user-id_|____|_)__________________________________________> |_partial-userid_| _*________________________ | __APPLNAME(_|___application-name_|_____|_)______________________________> |_partial-application-name_| _*________________________ | __WRKSTN(_|___workstation-name_|_____|_)________________________________> |_partial-workstation-name_| _*_________________________ | __CONNID(_|___connection-role-id_|_____|_)______________________________> |_partial-connection-name____| _*__________________________ | __CORRID(_|___correlation-role-id_|_____|_)_____________________________> |_partial-correlation-name____| _*____________________________ | __ROLE(___|___correlation-role___|_______|_)____________________________> |_partial-correlation-role-id__| |_constraint block 2_| constraint block 2: |_partial-plan-name_| |_partial-pkge-location_| __XPKGCOL(____package-collection-id ______|__)_________________________> |_partial-package-collection-id_| __XPKGPROG(____package-program-name________|__)________________________> |_partial-package-program-name__| __XAUTHID(_____authorization-id____________|__)________________________> |_partial-authorization-id______| |_partial-location-name__| |_partial-userid_| |________________| |_partial _______| |_ipaddr_________________| |_partial-ipaddr_________| __XAPPNAME(_____application-name_|_______)_______________________________> |_partial-application-name_| __XWRKSTN(_____workstation-name_|_______)________________________________> |_partial-workstation-name_| __XCONNID(_____connection-role-id_|_______)______________________________> |_partial-connection-name____| __XCORRID(____correlation-role-id_|_______)______________________________> |_partial-correlation-name____| __XROLE(_______correlation-role___|_________)____________________________> |_partial-correlation-role-id_|

-DISPLAY UTILITY >>__DISPLAY UTILITY__(_ _utility-id__________ _)________________________> |_partial-utility-id*_| |_*___________________| >___ _________________________ _________________________________________>< | >__DSN__ _____________________________________ ________________________> | _DSN___________________ | |_SYSTEM(_|_subsystem-name________|_)_| |_group-attachment-name_| >__ ______________________ __ _______________ __________________________> | _0_______ | |_TEST(integer)_| |_RETRY(_|_integer_|_)_| >__ __________________ _________________________________________________>< | _YES_ | |_ASUSER(userid)_| |_GROUP(_|_NO__|_)_| ®

DB2 9 for z/OS

129

®


DSNC (CICS attachment facility) >>__DSNC__ _____________ __db2 command__________________________________>< |_destination_|

DSNC DISCONNECT (CICS attachment facility) >>__DSNC DISCONNECT__plan-name__________________________________________>
>__DSNC DISPLAY__ _PLAN__ ___________ _____________ ___________________> | |_plan-name_| | |_TRANSACTION__ ________________ _| | |_transaction-id_| | |_STATISTICS______________________| >______________________________________________________________________>< |_destination_|

DSNC MODIFY(CICS attachment facility) >>__DSNC MODIFY__ _DESTINATION__old__new________________________________>< |_TRANSACTION__transaction-id__integer_|

DSNC STOP (CICS attachment facility) _QUIESCE_ >>__DSNC STOP__|_FORCE___|______________________________________________>
>__DSNC STRT__ _______ ________________________________________________>< |_ssid__|

DSNH (TSO CLIST) >>__DSNH__INPUT(data-set-name)__________________________________________>< | >__END_________________________________________________________________>
>__FREE PACKAGE____________________________________________________________> (___________________collection-id_._package-id________________________|__)_> ||_location-name.||_*___________| |_*________| |_.(_ _____________)_| | | |_version-id_| | | |_*__________| | 130

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |_*____________________________________________________________________| >__________________________________________________________________________>< | _I_ | |_FLAG(_|_W_|_)_| |_E_| |_C_|

FREE PLAN >__FREE PLAN__(_ ___plan-name_|_ _)__ _______________ ____________________>< |_*_____________| | _I_ | |_FLAG(_|_W_|_)_| |_E_| |_C_|

MODIFY admtproc, APPL=SHUTDOWN >>__MODIFY__admtproc,APPL__________________________________________________>< |_,SHUTDOWN_|

MODIFY admtproc, APPL=SHUTDOWN >>__MODIFY__admtproc,APPL__________________________________________________>< |_,TRACE__ON____| |_OFF_|

MODIFY IRLMPROC, ABEND _,DUMP___ >>__MODIFY__irlmproc,ABEND_|_________|_____________________________________>< |_,NODUMP_|

MODIFY IRLMPROC, DIAG >>__MODIFY__irlmproc,DIAG_ _,DELAY_ _______________________________________>< |_,PLOCK_| |_,ALL___| |_,NONE__| |_,HANG__|

MODIFY IRLMPROC, PURGE >>__MODIFY__irlmproc,PURGE,db2name_________________________________________>
>__MODIFY__irlmproc,SET__ _,DEADLOCK=nnnn_________________________________>< |_,LTE=nnnn____________________| |_,PVT=nnnn____________________| |_,MVT=nnnnnU__________________| |_,TIMEOUT=nnnn,subsystem-name_| | _10__ | |_,TRACE=_|_nnn_|______________|

MODIFY IRLMPROC, STATUS _,irlmx__ >>__MODIFY__irlmproc,STATUS_|________|_____________________________________>< ®

DB2 9 for z/OS

131

®

DB2 9 z/OS Reference Guide |_,ALLD__| |_,ALLI__| |_,MAINT_| |_,STOR__| |_,TRACE_|

-MODIFY TRACE (DB2) _*___________ | >__MODIFY TRACE__(_ _PERFM___ _)__CLASS(_|___integer_|_|_)_____________> |_ACCTG___| |_STAT____| |_AUDIT___| |_MONITOR_| _*_______________ | __TNO(integer)__IFCID(_|____ifcid_nbr__|_|_)__________________________> >__ _________________ _________________________________________________> |_COMMENT(string)_| >__ ___________________________________________________________________>< | _*________________________ | |_constraint-block-2_| | | |_partial-package-collection-id_| __XPKGPROG(____package-program-name________|__)________________________> |_partial-package-program-name__| __XAUTHID(_____authorization-id____________|__)________________________> |_partial-authorization-id______| |_partial-location-name__| |_partial-userid_| |________________| |_partial _______| |_ipaddr_________________| |_partial-ipaddr_________| __XAPPNAME(_____application-name_|_______)_______________________________> |_partial-application-name_| __XWRKSTN(_____workstation-name_|_______)________________________________> |_partial-workstation-name_| __XCONNID(_____connection-role-id_|_______)______________________________> |_partial-connection-name____| __XCORRID(____correlation-role-id_|_______)______________________________> |_partial-correlation-name____| __XROLE(_______correlation-role___|_________)____________________________> |_partial-correlation-role-id_|

REBIND PACKAGE >>__REBIND PACKAGE__________________________________________________________> >>_(____________________collection-id__._package-id_ _______________________> ||_location-name._| |_* ___________| |_* ________||_.(______________)_| | | |_version-id_| | | |_*__________| | |_*_____________________________________________________________________| >___________________________________________________________________________> |_OWNER(auth-id)_| |_QUALIFIER(qualifier-name)_| |_CURRENTDATA(_YES__)_| |_NO_| >___________________________________________________________________________> |_DBPROTOCOL_(___DRDA____)_||_DEFER(PREPARE)___| |_DEGREE(_ _1___ _)_| |_PRIVATE_| |_NODEFER(PREPARE)_| |_ANY_| >___________________________________________________________________________> |_DYNAMICRULES(__RUN______)_| |_BIND___| |_DEFINE_| |_INVOKE_| >___________________________________________________________________________> |_ENCODING(_ _ASCII___)_| | _NO__ | | _I_ | |_EBCDIC__| |_EXPLAIN(_|_YES_|_)_| |_FLAG(_|_W_|_)_| |_UNICODE_| |_E_| |_ccsid___| |_C_| >___________________________________________________________________________> |_IMMEDWRITE_(_NO_)_| |_ISOLATION(_ _RR_ _)_| |_YES_| |_RS_| |_CS_| |_UR_| |_NC_| >___________________________________________________________________________> | _NO__ | | _NONE___ | |_OPTHINT_(_'hint-id'__)_| |_KEEPDYNAMIC(_|_YES_|_)_| |_REOPT(|_ALWAYS_|)_| |_ONCE___| |_AUTO___| >___________________________________________________________________________> | __________________________________________________________________________>< | _RUN__ | |_VALIDATE(_|_BIND_|_)_|

REBIND PLAN >__REBIND PLAN__(_ ___plan-name_|_ _)______________________________________> |_*_____________| |_OWNER(authorization-id)_| >__ ________________________________________________________________________> ®

DB2 9 for z/OS

133

®

DB2 9 z/OS Reference Guide |_QUALIFIER(qualifier-name)_| >___________________________________________________________________________> | __________________________________________________________________________> |_NODEFER(PREPARE)_||_ACQUIRE(_ _USE______ )||_CACHESIZE(decimal-value)_| |_DEFER(PREPARE)___| |_ALLOCATE_| >__________________________________________________________________________> |_CURRENTDATA(_ _NO__ _)_| |_CURRENTSERVER(location-name)_| |_YES_| >_____________________________________ ____________________________________> |_DBPROTOCOL__(__ _DRDA____ __)_| |_DEGREE(_ _1___ _)_| |_PRIVATE_| |_ANY_| >__________________________________________________________________________> |_DISCONNECT(_ _EXPLICIT____ _)_| |_DYNAMICRULES(_ _RUN__ _)_| |_AUTOMATIC___| |_BIND_| |_CONDITIONAL_| >__ _______________________________________________________________________> |_ENCODING(_ _ASCII___ _)_| |_EXPLAIN(_ _NO__ _)_| | _I_ | |_EBCDIC__| |_YES_| |_FLAG(_|_W_|_)_| |_UNICODE_| |_E_| |_ccsid___| |_C_| >__________________________________________________________________________> |_IMMEDWRITE(_ _NO__ _)_||_ISOLATION(_ _RR_ _)_|| _NO__ | |_PH1_| |_RS_| |_KEEPDYNAMIC(_|_YES_|_)| |_YES_| |_CS_| |_UR_| >__________________________________________________________________________> | _NONE___ ||_OPTHINT_(__'hint-id'__)_|| __________________________________________________________________________> | | |_RELEASE(_ _COMMIT_____ _)_| |_SQLRULES(_ _DB2_ _)_| |_PATHDEFAULT_| |_DEALLOCATE_| |_STD_| >________________ _________________________________________________________> |_VALIDATE(_ _RUN__ _)_| |_BIND_| enable-block >>__ ______________________________________________________________________>< | _ENABLE(*)________________________ | | | __________________________________________________________________________> | _I_ | |_FLAG(_|_W_|_)| |_E_| |_C_| >__________________________________________________________________________> |_IMMEDWRITE(_ _NO__ _)| |_ISOLATION(__RR__)_||_RELEASE(___COMMIT_____)_| |_YES_| |_RS_| |_DEALLOCATE_| _ |_CS_| |_UR_| |_NC_|

-RECOVER BSDS >>__RECOVER BSDS__________________________________________________________>
>__RECOVER INDOUBT__ ___________________ __ACTION(_ _COMMIT_ _)__________> |_(connection-name)_| |_ABORT__| __ _ID(_ ___correlation-id_|_ _)_ ______________________________________>< | |_*__________________| | | __RECOVER POSTPONED__ ________ _________________________________________>< |_CANCEL_|

-REFRESH DB2, EARLY >>__REFRESH DB2, EARLY____________________________________________________>
__RESET GENERICLU__ _(___ _luname_______ _|_)_ _________________________>< | |_netid.luname_| | |_(*)______________________| ®

DB2 9 for z/OS

135

®


-RESET INDOUBT >>__RESET INDOUBT_________________________________________________________> __ _LUNAME(_ ___luname_|_ _)_ _______ ___________________________________>< | |_*__________| |_FORCE_| | | | |_PLAN(plan-name)_| | |_CP__PLAN(plan-name)________________________| >__ _______________________ __ _________________________ ________________>< |_LIBRARY(library-name)_| |_PARMS(parameter-string)_|

-SET ARCHIVE >>__SET ARCHIVE__ __ __________ __ ______________________________________>< | |_COUNT__(__integer__)_||_TIME(_ _minutes_ __)_| | | | |_,seconds_| | | | |_,seconds____________| | | |_1440________________| | | |_NOLIMIT_____________| | |_DEFAULT____________________________________________|

-SET LOG >>__SET LOG__ _LOGLOAD(integer)_________________________________________> |_CHKTIME(integer)_| |_SUSPEND__________| |_RESUME___________|

-SET SYSPARM >>__SET SYSPARM__ _LOAD(_ _DSNZPARM_________ _)_ _______________________>< | |_load-module-name_| | |_RELOAD_______________________| |_STARTUP______________________|

SPUFI >>__SPUFI______________________________________________________________>
>__/SSR__subsystem-command____________________________________________>
>__/START_____________________________________________________________>< | | | __START DATABASE__(_ ___database-name_|_____ _)_______________________> |_*_____________________| |_dbname1:dbname2_______| |_dbname*_______________| |_*dbname_______________| |_*dbname*______________| |_*dbstring1*dbstring2*_| > ______________________________________________________________________> | ______________________________________________________________________> | _____ACCESS(_|_RO____|_)______________________________________________>< |_UT____| |_FORCE_|

-START DB2 >>__START DB2__ _________________________ ______________________________> | ___DSNZPARM__ | |_PARM(_|_module name_|_)_| >__ _____________________ __ __________________ ________________________> | _*_____ | | _NO__ | |_ACCESS(_|_MAINT_|_)_| |_LIGHT(_|_YES_|_)_| >__ ________________________ __ ________________________ _______________> |_MSTR(jcl-substitution)_| |_DBM1(jcl-substitution)_| >__ ________________________ ___________________________________________>< |_DIST(jcl-substitution)_| ®

DB2 9 for z/OS

137

®


-START DDF >>__START DDF___________________________________________________________>
>__START FUNCTION SPECIFIC_____________________________________________> _(*.*)_____________________________________ >__|___________________________________________|________________________> | __ ______________________ _____________________________________________>< | _LOCAL_ | |_SCOPE__(_|_______|_)_| |_GROUP_|

-START admtproc >>__START__irlmproc,__ _________________________________________________>< |_TRACE=__ON_____| |_OFF_|

-START irlmproc >__START__irlmproc,__ ___________________________ |____________________>< |_DEADLOK='iiii,kkkk'_______| |_IRLMGRP='irlm-group-name__| |_IRLMID=n__________________| |_IRLMNM=irlmname___________| |_LOCKTABL=irlmltnm_________| |_MAXCSA=nnn________________| |_MAXUSRS=nnn_______________| |_PC=_ _YES_ _______________| | |_NO__| | |_PGPROT=_ _YES_ ___________| | |_NO__| | |_SCOPE=_ _LOCAL____ _______| | |_GLOBAL___| | | |_NODISCON_| | |_TRACE=_ _NO__ ____________| |_YES_|

-START PROCEDURE _(*.*)_____________________________ >>__START PROCEDURE__|___________________________________|_______________> | __ ______________________ ______________________________________________>< | _LOCAL_ | 138

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |_SCOPE__(_|_______|_)_| |_GROUP_|

-START PROFILE >>__START PROFILE________________________________________________________>
>__START RLIMIT__ _______ ______________________________________________>< |_ID=id_|

-START TRACE >>__START TRACE__(_ _PERFM___ _)__ ______________________ _______________> |_ACCTG___| | _LOCAL_ | |_STAT____| |_SCOPE__(_|_______|_)_| |_AUDIT___| |_GROUP_| |_MONITOR_| >__ ___________________ __ __________________ ___________________________> |_destination block_| |_constraint block_| |_RMID_| >__ _________________ ___________________________________________________>< |_COMMENT(string)_| destination block: __DEST(__ _GTF_ |_)_____________________________________________________> |_SMF_| |_SRV_| |_OPn_| |_OPX_| constraint block: _*_________________ _*__________________________ | |_partial-plan-name_| |_partial-package-location_| ___PKGCOL(____package-collection-id ______|__)__________________________> |_partial-package-collection-id_| _*_____________________________ | __PKGPROG(_|__package-program-name______|_|_)___________________________> |_partial-package-program-name_| _*_____________ | __AUTHID(_|___auth-id_|____|_)__________________________________________> |_partial-authid_| _*___________ _*___________ |

®

DB2 9 for z/OS

139

®

DB2 9 z/OS Reference Guide _*_________________ | __LOCATION(_|___location-name_|_|_)_____________________________________> |___________| |_partial-element___| |_ipaddr____________| |_partial-ipaddr____| _*_____________ | __USERID(_|___user-id_|____|_)__________________________________________> |_partial-userid_| _*_______________________ | __APPLNAME(_|___application-name_|_____|_)_______________________________> |_partial-application-name_| _*________________________ | __WRKSTN(_|___workstation-name_|_____|_)_________________________________> |_partial-workstation-name_| _*_________________________ | __CONNID(_|___connection-role-id_|_____|_)_______________________________> |_partial-connection-name____| _*__________________________ | __CORRID(_|___correlation-role-id_|_____|_)______________________________> |_partial-correlation-name____| _*____________________________ | __ROLE(___|___correlation-role___|_______|_)_____________________________> |_partial-correlation-role-id__| |_filtering block_| _*__________ | __IFCID(_|___ifcid__|_|_)_BUFSIZE_(_|_k_bytes_|__________________________> __TDATA(__ _CORRELATION_ |_)_____________________________________________> |_TRACE________| |_CPU__________| |_DISTRIBUTED__| filtering block: |_partial-plan-name_| |_partial-pkge-location_| __XPKGCOL(____package-collection-id ______|__)__________________________> |_partial-package-collection-id_| __XPKGPROG(____package-program-name________|__)_________________________> 140

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |_partial-package-program-name__| __XAUTHID(_____authorization-id____________|__)_________________________> |_partial-authorization-id______| |_partial-location-name__| |_partial-userid_| |________________| |_partial _______| |_ipaddr_________________| |_partial-ipaddr_________| __XAPPNAME(_____application-name_|_______)_______________________________> |_partial-application-name_| __XWRKSTN(_____workstation-name_|_______)________________________________> |_partial-workstation-name_| __XCONNID(_____connection-role-id_|_______)______________________________> |_partial-connection-name____| __XCORRID(____correlation-role-id_|_______)______________________________> |_partial-correlation-name____| __XROLE(_______correlation-role___|_________)____________________________> |_partial-correlation-role-id_|

STOP >__/STOP__ _SUBSYS____subsystem-name_|_ __________________________________>< |_SUBSYS__ALL________________|

STOP admtproc >>__STOP____admtproc_______________________________________________________>< -STOP DATABASE >__STOP DATABASE_(___database-name_|________ _)____________________________> |_*_____________________| |_dbname1:dbname2_______| |_dbname*_______________| |_*dbname_______________| |_*dbname*______________| |_*dbstring1*dbstring2*_| >_______________________________________________________________________)___> | < |_CLONE_| |_AT(COMMIT)_|

-STOP DB2 _MODE(QUIESCE)_ _CASTOUT(YES)_ >>__STOP DB2__|_______________|__|______________|__________________________>< |_MODE(FORCE)___| |_CASTOUT(NO)__|

-STOP DDF _MODE(QUIESCE)________________ >>__STOP DDF__|______________________________|_____________________________>< |_MODE(FORCE)__________________| |_MODE(SUSPEND)_ _CANCEL(n)_ __| |_WAIT(n)___|

-STOP FUNCTION SPECIFIC >>__STOP FUNCTION SPECIFIC__________________________________________________> _(*.*)_____________________________________ >__|___________________________________________|____________________________> | __ ________________________ __ ______________________ _____________________>< | _QUEUE__ | | _LOCAL_ | |_ACTION__(_|_REJECT_|_)_| |_SCOPE__(_|_______|_)_| |_GROUP_|

STOP irlmproc >>__STOP__irlmproc__________________________________________________________>

-STOP PROCEDURE _(*.*)_____________________________ >>__STOP PROCEDURE__|___________________________________|___________________> | __ ________________________ __ _____________________ _____________________>< | _QUEUE__ | | _LOCAL_ | |_ACTION__(_|_REJECT_|_)_| |_SCOPE__(_|_______|_)_| |_GROUP_|

-STOP PROFILE >>__STOP PROFILE___________________________________________________________>
>__STOP RLIMIT____________________________________________________________>
>__STOP TRACE__(_ _PERFM___ _)_____________________________________________> |_ACCTG___| | _LOCAL_ | | |_STAT____| |_SCOPE__(_|_______|_)_| |_AUDIT___| |_GROUP_| |_MONITOR_| |_*_______| >__ ___________________ __ __________________ ______________________________> |_destination block_| |_constraint block_| | | >___________________________________________________________________________> < |_RMID_| |_COMMENT(string)_| destination block: __DEST(__ __________|_)____________________________________________________> |_GTF_____| |_SMF_____| |_SRV_____| |_OPn_____| constraint block: _*_________________ _*_________________________ | |_partial-plan-name_| |_partial-package-location_| ___PKGCOL(____package-collection-id ______|__)__________________________> |_partial-package-collection-id_| _*____________________________ | __PKGPROG(_|__package-program-name______|_|_)___________________________> |_partial-package-program-name_| _*_____________ | __AUTHID(_|___auth-id_|____|_)__________________________________________> |_partial-authid_| _*___________ _*___________ | _*_________________ | __LOCATION(_|___location-name_|_|_)_____________________________________> |___________| |_partial-element___| |_ipaddr____________| |_partial-ipaddr____| _*______________ ®

DB2 9 for z/OS

143

®

DB2 9 z/OS Reference Guide | __USERID(_|___user-id_|____|_)__________________________________________> |_partial-userid_| _*________________________ | __APPLNAME(_|___application-name_|_____|_)_______________________________> |_partial-application-name_| _*________________________ | __WRKSTN(_|___workstation-name_|_____|_)_________________________________> |_partial-workstation-name_| _*__________________________ | __CONNID(_|___connection-role-id_|_____|_)_______________________________> |_partial-connection-name____| _*___________________________ | __CORRID(_|___correlation-role-id_|_____|_)______________________________> |_partial-correlation-name____| _*____________________________ | __ROLE(___|___correlation-role___|_______|_)_____________________________> |_partial-correlation-role-id__| |_filtering block_|

filtering block: |_partial-plan-name_| |_partial-pkge-location_| __XPKGCOL(____package-collection-id ______|__)__________________________> |_partial-package-collection-id_| __XPKGPROG(____package-program-name________|__)_________________________> |_partial-package-program-name__| __XAUTHID(_____authorization-id____________|__)_________________________> |_partial-authorization-id______| |_partial-location-name__| |_partial-userid_| |________________| |_partial _______| |_ipaddr_________________| |_partial-ipaddr_________| __XAPPNAME(_____application-name_|_______)_______________________________> |_partial-application-name_| __XWRKSTN(_____workstation-name_|_______)________________________________> 144

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide |_partial-workstation-name_| __XCONNID(_____connection-role-id_|_______)______________________________> |_partial-connection-name____| __XCORRID(____correlation-role-id_|_______)______________________________> |_partial-correlation-name____| __XROLE(_______correlation-role___|_________)____________________________> |_partial-correlation-role-id_|

-TERM UTILITY >>__TERM UTILITY__(_ _utility-id________ _)________________________________>< |_partial-utility-id*_| |_*___________________|

TRACE IMS >>__/TRACE__SET_ _ON__ ___ _________________________________________________> |_OFF_| | _ALL__ | |_TABLE_|_SUBS_|__| >__ ___________________ ___________________________________________________>< | _NOLOG_ | |_OPTION_|_LOG___|__|

TRACE CT _,WRAP___ >>__TRACE CT,____ _WTRSTART=parmlibmem_|_________|________________________>< | |_,NOWRAP_| | |_WTRSTOP=jobname________________________| |_ON,__COMP=irlmnm__ __________________ _| | |_,SUB=(_ _DBM_ _)_| | | |_EXP_| | | |_INT_| | | |_SLM_| | | |_XCF_| | | |_XIT_| | |_OFF____________________________________|

®

DB2 9 for z/OS

145

®


SQL Control Statements SQL Control Statement >>____assignment-statement__________________________________________>< |_CALL statement_______| |_CASE statement_______| |_compund-statement____| |_GET DIAGNOSTICS stmt_| |_case-statement_______| |_compound-statement___| |_if-statement_________| |_loop-statement_______| |_repeat-statement_____| |_while-statement______|

Assignment >>______________SET____SQL-parameter-name____=____expression________>< |_label:_| |_SQL-variable-name__| |_NULL_______|

CALL >>__CALL__procedure-name_____________________________________________> >___________________________________________________________________>< |_(____________________________________________)_| | __CASE____searched-case-statement-when-clause______________________> |_simple-case-statement-when-clause___| >____________________________________________END CASE_______________> | __expression_______________________________________________________>

Compound _NOT ATOMIC_ >>______________BEGIN__|____________|______________________________> |_label:_| >__________________________________________________________________> 146

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide | __________________________________________________________________> | | __END____________________________________________________________>< |_label_| SQL-variable-declaration: >>__DECLARE_________________________________________________________> __SQL-variable-name_|_data-type__|_______________________|_________>< | |_DEFAULT__constant_| | |_RESULT_SET_LOCATOR VARYING___________| |_TABLE LIKE_table-name_AS_LOCATOR_____| condition-declaration: >>__DECLARE__condition-name__CONDITION__FOR___string-constant_______>< |_SQLSTATE____________| |_VALUE_| return-codes-declaration: _DEFAULT '00000'_______ >>__DECLARE__ _SQLSTATE__CHAR(5)__|_ ___________________ _|________>< | |_DEFAULT__constant_| | | _DEFAULT 0_____________ | |_SQLCODE__INTEGER__|_ ___________________ _|__| |_DEFAULT__constant handler-declaration: >>__DECLARE____CONTINUE____HANDLER__FOR______________________________> |_EXIT_____| >____specific-condition-value_______SQL-procedure-statement_________>< |_general-condition-value_| specific-condition-value: >_____SQLSTATE__|_______|__string__|_______________________________>< |_condition-name______________| general-condition-value: >>____SQLEXCEPTION__________________________________________________>< |_SQLWARNING___| |_NOT FOUND____|

IF >__IF__search-condition__THEN____SQL-procedure-statement__;_|_______> _______________________________________________________|____________> | ______________END IF_______________________________________________>< | >__GET DIAGNOSTICS__SQL-variable-name__=__ROW_COUNT________________>
>__GOTO__label_____________________________________________________>
>__LEAVE__label____________________________________________________>
______________LOOP____SQL-procedure-statement__;_|__END LOOP_______> |_label:_| >___________________________________________________________________>< |_label_|

REPEAT >______________REPEAT____SQL-procedure-statement__;_|_______________> |_label:_| >__UNTIL__search-condition__END REPEAT______________________________>< |_label_|

WHILE >>______________WHILE__search-condition__DO__________________________> |_label:_| ____SQL-procedure-statement__;_|__END WHILE________________________>< |_label_|

SQL Procedure statement >>____assignment-statement__________________________________________>< |_case-statement____________| |_get-diagnostics-statement_| |_goto-statement____________| |_if-statement______________| |_leave-statement___________| |_loop-statement____________| |_repeat-statement__________| |_while-statement___________| |_nested-SQL-statement______|

148

®

DB2 9 for z/OS

®


Plan Table Contains information about access paths for queries that were explained or hints. Column name QUERYNO

QBLOCKNO APPLNAME PROGNAME

PLANNO METHOD

CREATOR

®

DB2 9 for z/OS

Description A number intended to identify the statement being explained. For a row produced by an EXPLAIN statement, specify the number in the QUERYNO clause. For a row produced by non-EXPLAIN statements, specify the number using the QUERYNO clause, which is an optional part of the SELECT, INSERT, UPDATE, and DELETE statement syntax. Otherwise, DB2 assigns a number based on the line number of the SQL statement in the source program. FETCH statements do not each have an individual QUERYNO assigned to them. Instead, DB2 uses the QUERYNO of the DECLARE CURSOR statement for all corresponding FETCH statements for that cursor. When the values of QUERYNO are based on the statement number in the source program, values greater than 32,767 are reported as 0. Hence, in a very long program, the value is not guaranteed to be unique. If QUERYNO is not unique, use the value of TIMESTAMP, which is always unique. A number that identifies each query block within a query. The value of the numbers are not in any particular order, nor are they necessarily consecutive. The name of the application plan for the row. Applies only to embedded EXPLAIN statements executed from a plan or to statements explained when binding a plan. Blank if not applicable. The name of the program or package containing the statement being explained. For statements explained dynamically, such as with QMF or SPUFI, the associated plan/package is listed. Blank if not applicable. The number of the step in which the query indicated in QBLOCKNO was processed. This column indicates the order in which the steps were executed. A number (0, 1, 2, 3, or 4) that indicates the join method used for the step: 0 = First table accessed, continuation of previous table accessed, or not used. 1 = Nested loop join. For each row of the present composite table, matching rows of a new table are found and joined. 2 = Merge scan join. The present composite table and the new tables are scanned in the order of the join columns, and matching rows are joined. 3 = Sorts needed by ORDER BY, GROUP BY, SELECT DISTINCT, UNION, a quantified predicate, or an IN predicate. This step does not access a new table. 4 = Hybrid join. The current composite table is scanned in the order of the join-column rows of the new table. The new table is accessed using list prefetch. The creator of the new table accessed in this step; blank if METHOD is 3. 149

®

DB2 9 z/OS Reference Guide TNAME

TABNO ACCESSTYPE

MATCHCOLS ACCESSCREATOR ACCESSNAME INDEXONLY SORTN_UNIQ SORTN_JOIN SORTN_ORDERBY SORTN_GROUPBY SORTC_UNIQ

150

The name of a table, materialized query table, created or declared temporary table, materialized view, or materialized table expression. The value is blank if METHOD is 3. The column can also contain the name of a table in the form DSNWFQB(qblockno). DSNWFQB(qblockno) is used to represent the intermediate result of a UNION ALL, an INTERSECT ALL, an EXCEPT ALL, or an outer join that is materialized. If a view is merged, the name of the view does not appear. UDSN_BIM_TBL(qblockno) is used to represent the work file of a star join dimension table. IBM use only. The method of accessing the new table: DI = By an intersection of multiple DOCID lists to return the final DOCID list. DU = By a union of multiple DOCID lists to return the final DOCID list. DX = By an XML index scan of the index named in ACCESSNAME to return a DOCID list. E = By direct row using a row change timestamp column. I = By an index (identified in ACCESSCREATOR and ACCESSNAME). I1 = By a one-fetch index scan. M = By a multiple index scan (followed by MX, MI, or MU). MX = By an index scan on the index named in ACCESSNAME. When the access method MX follows the access method DX, DI, or DU, the table is accessed by the DOCID index using the DOCID list returned by DX, DI, or DU. MI = By an intersection of multiple indexes. MU = By a union of multiple indexes. N = By an index scan when the matching predicate contains the IN keyword. P = By a dynamic index ANDing scan. R = By a table space scan. RW = By a work file scan of the result of a materialized userdefined table function. V = By buffers for an INSERT statement within a SELECT. Blank = Not applicable to the current row. For ACCESSTYPE I, I1, N, MX, or DX, the number of index keys used in an index scan; otherwise, 0. For ACCESSTYPE I, I1, N, MX, or DX, the creator of the index; otherwise, blank. For ACCESSTYPE I, I1, N, MX, or DX, the name of the index; for ACCESSTYPE P, DSNPJW(mixopseqno) is the starting pair-wise join leg in MIXOPSEQNO; otherwise, blank. Whether access to an index alone is enough to carry out the step, or whether data, too, must be accessed. Y = Yes; N = No. Whether the new table is sorted to remove duplicate rows. Y = Yes; N = No. Whether the new table is sorted for join method 2 or 4. Y = Yes; N = No. Whether the new table is sorted for ORDER BY. Y = Yes; N = No. Whether the new table is sorted for GROUP BY. Y = Yes; N = No. Whether the composite table is sorted to remove duplicate rows. Y = Yes; N = No. ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide SORTC_JOIN SORTC_ORDERBY SORTC_GROUPBY TSLOCKMODE

TIMESTAMP

REMARKS PREFETCH

COLUMN_FN_EVAL

MIXOPSEQ

®

DB2 9 for z/OS

Whether the composite table is sorted for join method 1, 2, or 4. Y = Yes; N = No. Whether the composite table is sorted for an ORDER BY clause or a quantified predicate. Y = Yes; N = No. Whether the composite table is sorted for a GROUP BY clause. Y = Yes; N = No. An indication of the mode of lock to be acquired on the new table or its table space or table space partitions. If the isolation can be determined at bind time, the values are: IS = Intent share lock IX = Intent exclusive lock S = Share lock U = Update lock X = Exclusive lock SIX = Share with intent exclusive lock N = UR isolation; no lock If the isolation cannot be determined at bind time, the lock mode determined by the isolation at runtime is shown by the following values. NS = For UR isolation, no lock; for CS, RS, or RR, an S lock. NIS = For UR isolation, no lock; for CS, RS, or RR, an IS lock. NSS = For UR isolation, no lock; for CS or RS, an IS lock; for RR, an S lock. SS = For UR, CS, or RS isolation, an IS lock; for RR, an S lock. The data in this column is right-justified. For example, IX appears as a blank followed by I followed by X. If the column contains a blank, no lock is acquired. If the access method in the ACCESSTYPE column is DX, DI, or DU, no latches are acquired on the XML index page, and no lock is acquired on the new base table data page or row, nor on the XML table and the corresponding table spaces. The value of TSLOCKMODE is blank in this case. Usually, the time at which the row is processed, to the last 0.01 second. If necessary, DB2 adds 0.01 second to the value to ensure that rows for two successive queries have different values. A field into which you can insert any character string of 254 or fewer characters. Whether data pages are to be read in advance by prefetch: D = Optimizer expects dynamic prefetch S = Pure sequential prefetch L = Prefetch through a page list Blank = Unknown at bind time or no prefetch When a SQL aggregate function is evaluated: R = While the data is being read from the table or index S = While performing a sort to satisfy a GROUP BY clause Blank = After data retrieval after any sorts The sequence number of a step in a multiple index operation: 1, 2, . . . n = For the steps of the multiple index procedure (ACCESSTYPE is MX, MI, MU, DX, DI, or DU) 0 = For any other rows

151

®

DB2 9 z/OS Reference Guide VERSION

COLLID

ACCESS_DEGREE

ACCESS_PGROUP_ID

JOIN_DEGREE

JOIN_PGROUP_ID SORTC_PGROUP_ID SORTN_PGROUP_ID PARALLELISM_MODE

MERGE_JOIN_COLS CORRELATION_NAME PAGE_RANGE JOIN_TYPE

GROUP_MEMBER IBM_SERVICE_DATA

152

The version identifier for the package. Applies only to an embedded EXPLAIN statement executed from a package or to a statement that is explained when binding a package. Blank if not applicable. The collection ID for the package. Applies only to an embedded EXPLAIN statement executed from a package or to a statement that is explained when binding a package. Blank if not applicable. The value DSNDYNAMICSQLCACHE indicates that the row is for a cached statement. The number of parallel tasks or operations activated by a query. This value is determined at bind time; the actual number of parallel operations used at execution time could differ. The column contains 0 if there is a host variable. The identifier of the parallel group for accessing the new table. A parallel group is a set of consecutive operations, executed in parallel, that have the same number of parallel tasks. This value is determined at bind time; it could change at execution time. The number of parallel operations or tasks used in joining the composite table with the new table. This value is determined at bind time and can be 0 if there is a host variable. The actual number of parallel operations or tasks used at execution time could be different. The identifier of the parallel group for joining the composite table with the new table. This value is determined at bind time; it could change at execution time. The parallel group identifier for the parallel sort of the composite table. The parallel group identifier for the parallel sort of the new table. The kind of parallelism, if any, that is used at bind time: I = Query I/O parallelism C = Query CP parallelism X = Sysplex query parallelism The number of columns that are joined during a merge scan join (Method = 2). The correlation name of a table or view that is specified in the statement. If there is no correlation name, the column is blank. Whether the table qualifies for page range screening, so that plans scan only the partitions that are needed. Y = Yes; blank = No. The type of an outer join: F = Full outer join L = Left outer join S = Star join Blank = Inner join or no join RIGHT OUTER JOIN converts to a LEFT OUTER JOIN when you use it, so that JOIN_TYPE contains L. The member name of the DB2 that executed EXPLAIN. The column is blank if the DB2 subsystem was not in a data sharing environment when EXPLAIN was executed. IBM use only.

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide WHEN_OPTIMIZE

QBLOCK_TYPE

BIND_TIME

OPTHINT HINT_USED PRIMARY_ACCESSTYPE

®

DB2 9 for z/OS

When the access path was determined: blank = At bind time, using a default filter factor for any host variables, parameter markers, or special registers. B = At bind time, using a default filter factor for any host variables, parameter markers, or special registers; however, the statement is reoptimized at runtime using input variable values for input host variables, parameter markers, or special registers. The bind option REOPT(ALWYAS), REOPT(ONCE), or REOPT(AUTO), must be specified for reoptimization to occur. R = At runtime, using input variables for any host variables, parameter markers, or special registers. The bind option REOPT(ALWAYS), REOPT(ONCE), or REOPT(AUTO) must be specified for this to occur. For each query block, the type of SQL operation performed. For the outermost query, the column identifies the statement type. Possible values: SELECT = SELECT INSERT = INSERT UPDATE = UPDATE DELETE = DELETE SELUPD = SELECT with FOR UPDATE OF DELCUR = DELETE WHERE CURRENT OF CURSOR UPDCUR = UPDATE WHERE CURRENT OF CURSOR CORSUB = Correlated subquery NCOSUB = Noncorrelated subquery TABLEX = Table expression TRIGGR = WHEN clause on CREATE TRIGGER UNION = UNION UNIONA = UNION ALL INTERS = INTERSECT INTERA = INTERSECT ALL EXCEPT = EXCEPT EXCEPTA = EXCEPT ALL For non-cached static SQL statements, the time at which the plan or package for the statement or query block was bound. For cached static and dynamic statements, the time at which the statement entered the cache. For non-cached static, cached static, and cached dynamic statements, this is a full-precision timestamp value. For non-cached dynamic SQL statements, this is the value contained in the TIMESTAMP column of PLAN_TABLE appended by four zeroes. A string that you use to identify this row as an optimization hint for DB2. DB2 uses this row as input when choosing an access path. If DB2 used one of your optimization hints, it puts the identifier for that hint (the value in OPTHINT) in this column. Indicates whether direct row access will be attempted first: D = DB2 will try to use direct row access. If it cannot use direct row access at runtime, it uses the access path described in the ACCESSTYPE column of PLAN_TABLE. T = The base table or result file is materialized into a work file, and the work file is accessed via sparse index access. If a base table is involved, ACCESSTYPE indicates how the base table is accessed. Blank = DB2 will not try to use direct row access. 153

®

DB2 9 z/OS Reference Guide PARENT_QBLOCK TABLE_TYPE

TABLE_ENCODE

TABLE_SCCSID TABLE_MCCSID TABLE_DCCSID ROUTINE_ID CTREF STMTTOKEN PARENT_PLANNO

154

Number that indicates the QBLOCKNO of the parent query. The type of new table: B = Buffers for SELECT from INSERT, SELECT from UPDATE, SELECT from MERGE, or SELECT from DELETE statement. C = Common table expression F = Table function M = Materialized query table Q = Temporary intermediate result table (not materialized). For the name of the view or nested table expression, a value of Q indicates that the materialization was virtual and not actual. Materialization can be virtual when the view or nested table expression definition contains a UNION ALL that is not distributed. R = Recursive common table expression S = Subquery (correlated or non-correlated) T = Table W = Work file The value of the column is null if the query uses GROUP BY, ORDER BY, or DISTINCT, which requires an implicit sort. The encoding scheme of the table. If the table has a single CCSID set, possible values are: A = ASCII E = EBCDIC U = Unicode M = The table contains multiple CCSID sets. The SBCS CCSID value of the table. If column TABLE_ENCODE is M, the value is 0. The mixed CCSID value of the table. If column TABLE_ENCODE is M, the value is 0. The DBCS CCSID value of the table. If column TABLE_ENCODE is M, the value is 0. IBM use only. If the referenced table is a common table expression, the value is the top-level query block number. A user-specified statement token. Corresponds to the plan number in the parent query block where a correlated subquery is involved. Or, for non-correlated subqueries, corresponds to the plan number in the parent query block that represents the work file for the subquery.

®

DB2 9 for z/OS

®


DSN_PREDICAT_TABLE Contains information about all the predicates in a query. Column name QUERYNO

QBLOCKNO APPLNAME PROGNAME PREDNO TYPE

LEFT_HAND_SIDE

LEFT_HAND_PNO LHS_TABNO LHS_QBNO RIGHT_HAND_SIDE ®

DB2 9 for z/OS

Description A number used to help identify the query being explained. It is not a unique identifier. Using a negative number will cause problems. The possible sources are: • The statement line number in the program • The QUERYNO clause • The EXPLAIN statement • The EDM unique token in the statement cache A number used to identify each query block within a query. The application plan name. The program name (binding an application) or the package name (binding a package). A number used to identify a predicate within a query. A string used to indicate the type or the operation of the predicate. The possible values are: AND OR EQUAL RANGE BETWEEN IN LIKE NOT LIKE EXISTS NOTEXIST SUBQUERY HAVING OTHERS If the left-hand side (LHS) of the predicate is a table column (LHS_TABNO > 0, this column indicates the column name. Other possible values are: VALUE COLEXP NONCOLEXP CORSUB NONCORSUB SUBQUERY EXPRESSION Blanks If the LHS of the predicate is a table column, this column indicates a number that uniquely identifies the corresponding table reference within a query. If the LHS of the predicate is a table column, this column indicates a number that uniquely identifies the corresponding table reference within a query. If the right-hand side (RHS) of the predicate is a table column 155

®


RIGHT_HAND_PNO RHS_TABNO RHS_QBNO FILTER_FACTOR BOOLEAN_TERM SEARCHARG AFTER_JOIN

ADDED_PRED

REDUNDANT_PRED DIRECT_ACCESS KEYFIELD EXPLAIN_TIME CATEGORY CATEGORY_B PRED_ENCODE PRED_CCSID PRED_MCCSID MARKER PARENT_PNO NEGATION LITERALS CLAUSE 156

(RHS_TABNO > 0), this column indicates the column name. Other possible values are: VALUE COLEXP NONCOLEXP CORSUB NONCORSUB SUBQUERY EXPRESSION Blanks If the predicate is a compound predicate (AND/OR), this column indicates the second child predicate. However, this column is not reliable when the predicate tree consolidation happens. If the RHS of the predicate is a table column, this column indicates a number that uniquely identifies the corresponding table reference within a query. If the RHS of the predicate is a subquery, this column indicates a number that uniquely identifies the corresponding query block within a query. The estimated filter factor. Whether this predicate can be used to determine the truth value of the whole WHERE clause. Whether this predicate can be processed by data manager (DM) stage 1. If it cannot, the relational data service (RDS) stage 2 needs to be used to take care of it, which is more costly. Indicates the predicate evaluation phase: A = After join D = During join Blank = Not applicable Whether the predicate is generated by transitive closure, which means DB2 can generate additional predicates to provide more information for access path selection, when the set of predicates that belong to a query logically imply other predicates. Whether the predicate is a redundant predicate, which means evaluation of other predicates in the query already determines the result that the predicate provides. Whether the predicate is direct access, which means one can navigate directly to the row through ROWID. Whether the predicate includes the index key column of the involved table. The EXPLAIN timestamp. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. Whether the predicate includes host variables, parameter markers, or special registers. The parent predicate number. If this predicate is a root predicate within a query block, this column is 0. Whether the predicate is negated via NOT. The literal value or literal values separated by colon symbols. The clause where the predicate exists: ®

DB2 9 for z/OS

®


GROUP_MEMBER

HAVING = HAVING clause ON = ON clause WHERE = WHERE clause The member name of the DB2 that executed EXPLAIN. The column is blank if the DB2 subsystem was not in a data sharing environment when EXPLAIN was executed.

DSN_STRUCT_TABLE Contains information about the query blocks in a query. Column name QUERYNO

QBLOCKNO APPLNAME PROGNAME PARENT ROWCOUNT ATOPEN CONTEXT

ORDERNO DOATOPEN_PARENT QBLOCK_TYPE

®

DB2 9 for z/OS

Description A number used to help identify the query being explained. It is not a unique identifier. Using a negative number will cause problems. The possible sources are: • The statement line number in the program • The QUERYNO clause • The EXPLAIN statement • The EDM unique token in the statement cache A number used to identify each query block within a query. The application plan name. The program name (binding an application) or the package name (binding a package). The parent query block number of the current query block in the structure of SQL text; this is the same as the PARENT_QBLOCKNO in the PLAN_TABLE. The estimated number of rows returned by RDS (query cardinality). Whether the query block is moved up for do-at-open processing. The value is Y if done-at-open or N otherwise. This column indicates the context of the current query block. The possible values are: TOP LEVEL UNION UNION ALL PREDICATE TABLE EXP UNKNOWN This column is currently not used. The parent query block number of the current query block. Do-at-open parent if the query block is done-at-open, this value may differ from the PARENT_QBLOCKNO in the PLAN_TABLE. The type of the current query block: SELECT INSERT UPDATE DELETE SELUPD DELCUR UPDCUR CORSUB NCOSUB TABLEX TRIGGR 157

®


EXPLAIN_TIME QUERY_STAGE GROUP_MEMBER

UNION UNIONA CTE This column is equivalent to the QBLOCK_TYPE column in PLAN_TABLE, except for CTE. The EXPLAIN timestamp. IBM internal use only. The member name of the DB2 subsystem that executed EXPLAIN. The column is blank if the DB2 subsystem was not in a data sharing environment when EXPLAIN was executed.

DSN_PGROUP_TABLE Contains information about the parallel groups in a query. Column name QUERYNO

QBLOCKNO PLANNAME COLLID PROGNAME EXPLAIN_TIME VERSION GROUPID FIRSTPLAN LASTPLAN CPUCOST IOCOST BESTTIME DEGREE MODE

REASON LOCALCPU TOTALCPU FIRSTBASE LARGETS 158

Description A number used to help identify the query being explained. It is not a unique identifier. Using a negative number will cause problems. The possible sources are: • The statement line number in the program • The QUERYNO clause • The EXPLAIN statement • The EDM unique token in the statement cache A number used to identify each query block within a query. The application plan name. The collection ID for the package. The program name (binding an application) or the package name (binding a package). The explain timestamp. The version identifier for the package. The parallel group identifier within the current query block. The plan number of the first contributing mini-plan associated within this parallel group. The plan number of the last mini-plan associated with this parallel group. The estimated CPU cost of this parallel group in milliseconds. The estimated total I/O cost of this parallel group in milliseconds. The estimated elapsed time for each parallel task for this parallel group. The degree of parallelism for this parallel group determined at bind time. The maximum parallelism degree if the table space is large is 255; otherwise, 64. The parallel mode: I = I/O parallelism C = CPU parallelism X = Multiple CPU Sysplex parallelism (highest level) N = No parallelism The reason for downgrading parallelism mode. The number of CPUs currently online when preparing the query. The total number of CPUs in Sysplex. LOCALCPU and TOTALCPU are different only for the DB2 coordinator in a Sysplex. The table number of the table that on which partitioning is performed. Value is Y if the table space is large in this group. ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide PARTKIND GROUPTYPE ORDER

STYLE

RANGEKIND NKEYCOLS LOWBOUND HIGHBOUND LOWKEY HIGHKEY FIRSTPAGE LASTPAGE GROUP_MEMBER HOST_REASON PARA_TYPE PART_INNER GRNU_KEYRNG OPEN_KEYRNG

The partitioning type: L = Logical partitioning P = Physical partitioning Indicates what operations this parallel group contains: table access, join, or sort (A, AJ, or AJS). The ordering requirement of this parallel group: N = No order. Results need no ordering. T = Natural order. Ordering is required but results already ordered if accessed via index. K = Key order. Ordering achieved by sort. Results ordered by sort key. This value applies only to parallel sort. The input/output format style of this parallel group. Blank for I/O parallelism. For other modes: RIRO = Records IN, Records OUT WIRO = Work file IN, Records OUT WIWO = Work file IN, Work file OUT The range type: K = Key range P = Page range The number of interesting key columns — that is, the number of columns that will participate in the key operation for this parallel group. The low bound of the parallel group. The high bound of the parallel group. The low key of range if partitioned by key range. The high key of range if partitioned by key range. The fist page in range if partitioned by page range. The last page in range if partitioned by page range. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only.

DSN_PTASK_TABLE Contains information about the parallel tasks in a query. Column name QUERYNO

QBLOCKNO APPLNAME PROGNAME LPTNO KEYCOLID DPSI ®

DB2 9 for z/OS

Description A number used to help identify the query being explained. It is not a unique identifier. Using a negative number will cause problems. The possible sources are: • The statement line number in the program • The QUERYNO clause • The EXPLAIN statement • The EDM unique token in the statement cache A number used to identify each query block within a query. The application plan name. The program name (binding an application) or the package name (binding a package). The parallel task number. The key columns ID (KEY range only). Indicates whether a data partition secondary index (DPSI) is used. 159

®

DB2 9 z/OS Reference Guide LPTLOKEY LPTHIKEY LPTLOPAG LPTLHIPAG LPTLOPG# LPTHIPG# LPTLOPT# KEYCOLDT KEYCOLPREC KEYCOLSCAL EXPLAIN_TIME GROUP_MEMBER

The low key value for this key column for this parallel task (KEY range only). The high key value for this key column for this parallel task (KEY range only). The low page information if partitioned by page range. The high page information if partitioned by page range. The lower bound page number for this parallel task (page range or DPSI enabled only). The upper bound page number for this parallel task (page range or DPSI enabled only). The lower bound partition number for this parallel task (page range or DPSI enabled only). The data type for this key column (KEY range only). The precision/length for this key column (KEY range only). The scale for this key column (KEY range with decimal data type only). The EXPLAIN timestamp. The member name of the DB2 that executed EXPLAIN. The column is blank if the DB2 subsystem was not in a data sharing environment when EXPLAIN was executed.

DSN_FILTER_TABLE Contains information about how predicates are used during query processing. Column name QUERYNO

QBLOCKNO PLANNO APPLNAME PROGNAME COLLID ORDERNO PREDNO STAGE

ORDER_CLASS EXPLAIN_TIME MIXOPSEQ REEVAL 160

Description A number used to help identify the query being explained. It is not a unique identifier. Using a negative number will cause problems. The possible sources are: The statement line number in the program The QUERYNO clause The EXPLAIN statement The EDM unique token in the statement cache A number used to identify each query block within a query. A number used to identify each mini-plan within a query block. The application plan name. The program name (binding an application) or the package name (binding a package). The collection ID for the package. The sequence number of evaluation. Indicates the order in which the predicate is applied within each stage. A number used to identify a predicate within a query. Indicates at which stage the predicate is evaluated. The possible values are: Matching Screening Stage 1 Stage 2 IBM internal use only. The EXPLAIN timestamp. IBM internal use only. IBM internal use only. ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide GROUP_MEMBER

The member name of the DB2 subsystem that executed EXPLAIN. The column is blank if the DB2 subsystem was not in a data sharing environment when EXPLAIN was executed.

DSN_DETCOST_TABLE Contains information about detailed cost estimation of the mini-plans in a query. Column name QUERYNO

QBLOCKNO PLANNO APPLNAME PROGNAME OPENIO OPENCPU OPENCOST DMIO DMCPU DMTOT SUBQIO SUBQCOST BASEIO BASECPU BASETOT ONECOMPROWS IMLEAF IMIO IMPREFH IMMPRED IMFF IMSRPRED IMFFADJ IMSCANCST IMREDSORT IMMERGCST IMCPU IMTOT IMSEQNO DMPEREFH DMCLUDIO DMPREDS DMSROWS DMSCANCST ®

DB2 9 for z/OS

Description A number used to help identify the query being explained. It is not a unique identifier. Using a negative number will cause problems. The possible sources are: The statement line number in the program The QUERYNO clause The EXPLAIN statement The EDM unique token in the statement cache A number used to identify each query block within a query. A number used to identify each mini-plan within a query block. The application plan name. The program name (binding an application) or the package name (binding a package). The Do-at-open I/O cost for the non-correlated subquery. The Do-at-open CPU cost for the non-correlated subquery. The Do-at-open total cost for the non-correlated subquery. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. The number of rows qualified after applying local predicates. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. The filter factor of matching predicates only. IBM internal use only. The filter factor of matching and screening predicates. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. 161

®

DB2 9 z/OS Reference Guide DMROWS DMCOLS RDSROWCST DMPAGECST DMDATAIO DMDATACPU RDSROW SNCOLS SNROWS SNRUNS SNMERGES SNIOCOST SNCPUCOST SNCOST SNCSANIO SNSCANCPU SNCCOLS SCROWS SCRECSZ SCPAGES SCRUNS SCMERGES SCIOCOST SCCPUCOST SCCOST SCSCANIO SCSCANCPU SCSCANCOST COMPCARD COMPIOCOST COMPCPUCOST COMPCOST JOINCOLS EXPLAIN_TIME GROUP_MEMBER

The number of data manager rows returned (after all stage 1 predicates are applied). The number of data manager columns. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. The number of RDS rows returned (after all stage 1 and stage 2 predicates are applied). The number of columns as sort input for a new table. The number of rows as sort input for a new table. The number of runs generated for a sort of a new table. The number of merges needed during a sort. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. The number of columns as sort input for a composite table. The number of rows as sort input for a composite table. The record size for a composite table. The page size for a composite table. The number of runs generated during the sort of a composite table. The number of merges needed during a sort of a composite table. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. IBM internal use only. The total composite cardinality. IBM internal use only. IBM internal use only. The total cost. IBM internal use only. The EXPLAIN timestamp. The member name of the DB2 subsystem that executed EXPLAIN. The column is blank if the DB2 subsystem was not in a data sharing environment when EXPLAIN was executed.

DSN_SORT_TABLE Contains information about sort operations required for a query. Column name

Description

QUERYNO

A number used to help identify the query being explained. It is not a unique identifier. Using a negative number will cause problems. The possible sources are: The statement line number in the program The QUERYNO clause The EXPLAIN statement

162

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide QBLOCKNO PLANNO APPLNAME PROGNAME COLLID SORTC

SORTN

SORTNO KEYSIZE ORDERCLASS EXPLAIN_TIME GROUP_MEMBER

The EDM unique token in the statement cache A number used to identify each query block within a query. A number used to identify each mini-plan within a query block. The application plan name. The program name (binding an application) or the package name (binding a package). The collection ID for the package. Indicates the reasons for sort of the composite table, using a bitmap of the following values: G = Group By O = Order By J = Join U = Uniqueness Indicates the reasons for sort of the Composite table. Using a bitmap of the following values: G = Group By O = Order By J = Join U = Uniqueness The sequence of the sort. The sum of the lengths of the sort keys. IBM internal use only. The EXPLAIN timestamp. The member name of the DB2 subsystem that executed EXPLAIN. The column is blank if the DB2 subsystem was not in a data sharing environment when EXPLAIN was executed.

DSN_SORTKEY_TABLE Contains information about sort keys for all the sorts required by a query. Column name QUERYNO

QBLOCKNO PLANNO APPLNAME PROGNAME COLLID SORTNO ORDERNO EXPTYPE

TEXT ®

DB2 9 for z/OS

Description A number used to help identify the query being explained. It is not a unique identifier. Using a negative number will cause problems. The possible sources are: • The statement line number in the program • The QUERYNO clause • The EXPLAIN statement • The EDM unique token in the statement cache A number used to identify each query block within a query. A number used to identify each mini-plan within a query block. The application plan name. The program name (binding an application) or the package name (binding a package). The collection ID for the package. The sequence number of the sort. The sequence of the sort key. The type of the sort key. The possible values are: COL EXP QRY The sort key text; can be a column name, a scalar subquery, or ‘Record ID’. 163

®

DB2 9 z/OS Reference Guide TABNO COLNO DATATYPE

LENGTH CCSID ORDERCLASS EXPLAIN_TIME GROUP_MEMBER

A number that uniquely identifies the corresponding table reference within a query. A number that uniquely identifies the corresponding column within a query. Applicable only when the sort key is a column. The data type of the sort key. The possible values are: HEXADECIMAL CHARACTER PACKED FIELD FIXED(31) FIXED(15) DATE’ TIME VARCHAR PACKED FLD FLOAT TIMESTAMP UNKNOWN DATA TYPE’ The length of the sort key. IBM internal use only. IBM internal use only. The EXPLAIN timestamp. The member name of the DB2 subsystem that executed EXPLAIN. The column is blank if the DB2 subsystem was not in a data sharing environment when EXPLAIN was executed.

DSN_PGRANGE_TABLE Contains information about qualified partitions for all page range scans in a query. This information is more detailed that the PAGE_RANGE column of the PLAN_TABLE, and it includes information about when partitions are eliminated even when the query is scanning an index. Column name QUERYNO

QBLOCKNO RANGE FIRSTPART LASTPART NUMPARTS EXPLAIN_TIME GROUP_MEMBER

164

Description The query number, a number used to help identify the query being explained. It is not a unique identifier. Using a negative number will cause problems. The possible sources are: • The statement line number in the program • The QUERYNO clause • The EXPLAIN statement • The EDM unique token in the statement cache A number used to identify each query block within a query. The sequence number of the current page range. The starting partition in the current page range. The ending partition in the current page range. The number of partitions in the current page range. The EXPLAIN timestamp. The member name of the DB2 subsystem that executed EXPLAIN. The column is blank if the DB2 subsystem was not in a data sharing environment when EXPLAIN was executed.

®

DB2 9 for z/OS

®


DSN_VIEWREF_TABLE Contains information about all the views and materialized query tables used to process a query. Column name QUERYNO

APPLNAME PROGNAME VERSION

CREATOR NAME TYPE

MQTUSE EXPLAIN_TIME GROUP_MEMBER

Description A number used to help identify the query being explained. It is not a unique identifier. Using a negative number will cause problems. The possible sources are: • The statement line number in the program • QUERYNO clause • The EXPLAIN statement • The EDM unique token in the statement cache The application plan name. The program name (binding an application) or the package name (binding a package). The version identifier for the package. Applies only to an embedded EXPLAIN statement that is executed from a package or to a statement that is explained when binding a package. Blank if not applicable. The value DSNDYNAMICSQLCACHE indicates that the row is for a cached statement. Authorization ID of the owner of the object. Name of the object. The type of the object: • V = View • R = MQT that has been used to replace the base table for rewrite • M = MQT IBM internal use only. The EXPLAIN timestamp. The member name of the DB2 subsystem that executed EXPLAIN. The column is blank if the DB2 subsystem was not in a data sharing environment when EXPLAIN was executed.

DSN_QUERY_TABLE Contains information about an SQL statement and displays the statement before and after query transformation in XML. Column name QUERYNO

TYPE QUERY_STAGE SEQNO NODE_DATA

®

DB2 9 for z/OS

Description A number used to help identify the query being explained. It is not a unique identifier. Using a negative number will cause problems. The possible sources are: • The statement line number in the program • QUERYNO clause • The EXPLAIN statement • The EDM unique token in the statement cache The type of the data in the NODE_DATA column. The stage during query transformation when this row is populated. The sequence number for this row if NODE_DATA exceeds the size of its column. The XML data containing the SQL statement and its query block, table, and column information. 165

®

DB2 9 z/OS Reference Guide EXPLAIN_TIME QUERY_ROWID GROUP_MEMBER HASHKEY HASH_PRED

166

The EXPLAIN timestamp. The ROWID of the statement. The member name of the DB2 subsystem that executed EXPLAIN. The column is blank if the DB2 subsystem was not in a data sharing environment when EXPLAIN was executed. The hash value of the contents in NODE_DATA. When NODE_DATA contains an SQL statement, this column indicates whether the statement contains a parameter marker literal, a non-parameter marker literal, or no predicates.

®

DB2 9 for z/OS

®


DSN_STATEMNT_TABLE Contains information about queries in the dynamice SQL cache. Column name QUERYNO APPLNAME PROGNAME COLLID

GROUP_MEMBER EXPLAIN_TIME STMT_TYPE

COST_CATEGORY

PROCMS

PROCSU

REASON

®

DB2 9 for z/OS

Description A number intended to identify the statement being explained. If QUERYNO is not unique, the value of EXPLAIN_TIME is unique. The name of the application plan for the row, or blank. The name of the program or package containing the statement being explained, or blank. The collection ID for the package. Applies only to an embedded EXPLAIN statement executed from a package or to a statement that is being explained when binding a package. Blank is not applicable. The value DSNDYNAMICSQLCACHE indicates that the row is for a cached statement. The member name of the DB2 that executed EXPLAIN, or blank. The time at which the statement is processed. This time is the same as the BIND_TIME column in PLAN_TABLE. The type of statement being explained: SELECT = SELECT INSERT = INSERT UPDATE = UPDATE DELETE = DELETE SELUPD = SELECT with FOR UPDATE OF DELCUR = DELETE WHERE CURRENT OF CURSOR UPDCUR = UPDATE WHERE CURRENT OF CURSOR Indicates whether DB2 was forced to use default values when making its estimates: A = DB2 had enough information to make a cost estimate without using default values. B = Some condition exists for which DB2 was forced to use default values. See the values in REASON to determine why DB2 was unable to put this estimate in cost category A. The estimated processor cost in milliseconds for the SQL statement, rounded up to the next integer value. The maximum value for this cost is 2,147,483,647 milliseconds, which is equivalent to approximately 24.8 days. If the estimated value exceeds this maximum, the column reports the maximum value. The estimated processor cost in service units for the SQL statement, rounded up to the next integer value. The maximum value for this cost is 2,147,483,647 service units. If the estimated value exceeds this maximum, the column reports the maximum value. A string that indicates the reasons for putting an estimate into cost category B: HAVING CLAUSE: A subselect in the SQL statement contains a HAVING clause. HOST VARIABLES: The statement uses host variables, parameter markers, or special registers. REFERENTIAL CONSTRAINTS: Referential constraints of the type CASCADE or SET NULL exist on the target table of a 167

®


STMT_ENCODE

TOTAL_COST

168

DELETE statement. TABLE CARDINALITY: The cardinality statistics are missing for one or more of the tables used in the statement. UDF: The statement uses user-defined functions. TRIGGERS: Triggers are defined on the target table of an INSERT, UPDATE, or DELETE statement. MATERIALIZATION: Statistics are missing because the statement uses materialized views or nested table expressions. The encoding scheme of the statement. If the statement represents a single CCSID set, possible values are: A = ASCII E = EBCDIC U = Unicode If the statement has multiple CCSID sets, the column value is M. The overall estimated cost of the statement. This cost should be used only for reference purposes.

®

DB2 9 for z/OS

®


DSN_FUNCTION_TABLE Column Name QUERYNO APPLNAME PROGNAME COLLID GROUP_MEMBER EXPLAIN_TIME SCHEMA_NAME FUNCTION_NAME SPEC_FUNC_ID FUNCTION_TYPE

VIEW_CREATOR VIEW_NAME PATH FUNCTION_TEXT

®

DB2 9 for z/OS

Description A number intended to identify the statement being explained. If QUERYNO is not unique, the value of EXPLAIN_TIME is unique. The name of the application plan for the row, or blank. The name of the program or package containing the statement being explained, or blank. The collection ID for the package, or blank. The member name of the DB2 that executed EXPLAIN, or blank. The time at which the statement is processed. This time is the same as the BIND_TIME column in PLAN_TABLE. The schema name of the function invoked in the explained statement. The name of the function invoked in the explained statement. The specific name of the function invoked in the explained statement. The type of function invoked in the explained statement. Possible values are: SU: Scalar function TU: Table function If the function specified in the FUNCTION_NAME column is referenced in a view definition, the creator of the view. Otherwise, blank. If the function specified in the FUNCTION_NAME column is referenced in a view definition, the name of the view. Otherwise, blank. The value of the SQL path that was used to resolve the schema name of the function. The text of the function reference (the function name and parameters). If the function reference is over 1500 bytes, this column contains the first 1500 bytes. For functions specified in infix notation, FUNCTION_TEXT contains only the function name. For example, for a function named /, which overloads the SQL divide operator, if the function reference is A/B, FUNCTION_TEXT contains only /, not A/B.

169

®


DSN_STATEMENT_CACHE_TABLE Column name STMT_ID STMT_TOKEN COLLID PROGRAM_NAME INV_DROPALT INV_REVOKE INV_LRU INV_RUNSTATS CACHED_TS USERS COPIES LINES PRIMAUTH CURSQLID BIND_QUALIFIER BIND_ISO

BIND_C BIND_DYNRL BIND_DEGRE BIND_SQLRL BIND_CHOLD STAT_TS STAT_EXEC STAT_GPAG STAT_SYNR STAT_WRIT STAT_EROW STAT_PROW STAT_SORT 170

Description An EDM unique token. A user-provided identification string. Collection ID; value is DSNDYNAMICSQLCACHE. Name of package or DBRM that performed the initial PREPARE. Invalidated by DROP/ALTER. Invalidated by REVOKE. Removed from cache by LRU. Invalidated by RUNSTATS. Timestamp when statement was cached. Number of current users of statement. These are the users that have prepared or executed the statement during their current unit of work. Number of copies of statement owned by all threads in the system. Precompiler line number from the initial PREPARE. Primary authorization ID of the user that did the initial PREPARE. CURRENT SQLID of the user that did the initial prepare. Bind object qualifier for unqualified table names. ISOLATION bind option: UR = Uncommitted read CS = Cursor stability RS = Read stability RR =Repeatable read DATA CURRENTDATA bind option: Y = CURRENTDATA(YES) N = CURRENTDATA(NO) DYNAMICRULES bind option: B = DYNAMICRULES(BIND) R = DYNAMICRULES(RUN) CURRENT DEGREE value: A = ANY 1=1 CURRENT RULES value: D = DB2 S = SQL Cursor WITH HOLD bind option: Y = Initial PREPARE was done for a cursor WITH HOLD N = Initial PREPARE was not done for a cursor WITH HOLD Timestamp of stats when IFCID 318 is started. Number of executions of statement. For a cursor statement, this value is the number of OPENs. Number of getpage operations performed for statement. Number of synchronous buffer reads performed for statement. Number of buffer write operations performed for statement. Number of rows examined for statement. Number of rows processed for statement. Number of sorts performed for statement. ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide STAT_INDX STAT_RSCN STAT_PGRP STAT_ELAP STAT_CPU STAT_SUS_SYNIO STAT_SUS_LOCK STAT_SUS_SWIT STAT_SUS_GLCK STAT_SUS_OTHR STAT_SUS_OTHW STAT_RIDLIMT STAT_RIDSTOR EXPLAIN_TS SCHEMA STMT_TEXT STMT_ROWID BIND_RA_TOT BIND_RO_TYPE

®

DB2 9 for z/OS

Number of index scans performed for statement. Number of table space scans performed for statement. Number of parallel groups created for statement. Accumulated elapsed time used for statement. Accumulated CPU time used for statement. Accumulated wait time for synchronous I/O. Accumulated wait time for lock and latch requests. Accumulated wait time for synchronous execution unit switch. Accumulated wait time for global locks. Accumulated wait time for read activity done by another thread. Accumulated wait time for write activity done by another thread. Number of times a RID list wasn’t used because the number of RIDs would have exceeded one or more DB2 limits. Number of times a RID list wasn’t used because not enough storage was available to hold the list of RIDs. When the statement cache table is populated. CURRENT SCHEMA value. Statement text. Statement ROWID. The total number of REBIND commands that have been issued for the dynamic statement because of the REOPT(AUTO) option. The current specification of the REOPT option for the statement: N = REOPT(NONE) 1 = REOPT(ONCE) or its equivalent A = REOPT(AUTO) or its equivalent 0 = The current plan is deemed optimal and there is no need for REOPT(AUTO)

171

®


DSNZPARMs Parameter

Description

Acceptable values (defaults appear in bold)

Updatable online?

ABEXP ABIND ACCUMACC

EXPLAIN processing Auto BIND DDF/RRSAF accumulation data Aggregation fields Authorization exit limit ASCII coded character set (graphic) Allocation units Start names ASCII coded character set (mixed) Application encoding

YES, NO YES, NO NO, 2–65535

Yes Yes Yes

0–10 0–32676; 10 0–65533

Yes Yes —

BLK, TRK, CYL ALL, spacenames 0–65533

Yes — —

ASCII, EBCDIC, UNICODE, ccsid 1–34 char 1–34 char 0–9999 1–16; 1,3,4 NO, YES NO, YES 0–65533

— Yes Yes Yes Yes Yes Yes —

YES, NO NO, YES, list, * YES, NO 0–4096; 1024

No No No Yes

0–255; 5 BINDADD, BIND 8192–28672 1–254; 4 NO, YES 0–2MB; 32K

No Yes Yes Yes Yes No

0–2 MB; 32K

No

1–8 char; DSNCAT 1, ANY ALPHANUM, KATAKANA (if SCCSID = 930 or 5026) 200K–16 MB rec (50K) or 1–60 minutes 1, 2, 3 ACTIVE, INACTIVE

Yes Yes —

ACCUMUID AEXITLIM AGCCSID ALCUNIT ALL/dbname AMCCSID APPENSCH ARCPFX1 ARCPFX2 ARCRETN ARCWRTC ARCWTOR ARC2FRST ASCCSID

CATALOG CDSSRDEF CHARSET

Copy 1 prefix Copy 2 prefix Retention period WTOR route code Write to operator Read copy 2 archive ASCII coded character set (singlebyte) Assistant Audit trace Use protection Plan authorization cache Backout duration Bind new package Block size IMS BMP timeout Cache dynamic SQL Package authorization cache Routine authorization cache Catalog alias Current degree CCSID used

CHKFREQ

Checkpoint frequency

CHGDC CMTSTAT

DROP support DDF threads

ASSIST AUDITST AUTH AUTHCACH BACKODUR BINDNV BLKSIZE BMPTOUT CACHEDYN CACHEPAC CACHERAC

172

Yes Yes No ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide COMPACT COMPAT CONDBAT CONTSTOR COORDNTR CTHREAD DBACRVW DBPROTCL DATE DB2SUPLD

Compact data IBM service Max remote connected Contract thread storage Coordinator Max users DBADM can create view for other authid Database protocol Date format

DATELEN DDF DEALLCT

Serviceability parameter Local date length DDF startup option Deallocate period

DECARTH DECDIV3 DECIMAL DEF_DECFLOAT _ROUND_MODE

Decimal arithmetic Minimum divide scale Decimal point Decfloat rounding mode

DEFLANG

Language default

DEFLTID DELIM DESCSTAT DISABSCL

Unknown authid String delimiter Describe for static SQLWARN1 and 5 for non-scrollable cursors Level ID update frequency DL/I batch timeout Data sharing Data set maximum Dist SQL string delimiter Data set stats time Vary DS control interval Use for dynamic rules Algorithm for free chain search EDM DBD cache EDMPOOL storage

DLDFREQ DLITOUT DSHARE DSMAX DSQLDELI DSSTIME DSCVI DYNRULES EDMBFIT EDMDBDC EDMPOOL ®

DB2 9 for z/OS

NO, YES OFF 0–25000; 64

Yes — Yes

NO, YES

Yes

NO, YES 1–2000; 70 YES, NO

No Yes Yes

DRDA, PRIVATE ISO, USA, EUR, JIS, LOCAL —

Yes —

0, 10–254 NO, AUTO, COMMAND 0–1439 min, 0–59 sec, NOLIMIT DEC15, DEC31, 15, 31 NO, YES ,. ROUND_CELING, ROUND_DOWN, ROUND_FLOOR, ROUND_HALF_DOWN, ROUND_HALF_EVEN, ROUND_HALF_UP, ROUND_HALF_EVEN ASM, C, CPP, COBOL, COB2, IBMCOB, FORTRAN, PL1 IBMUSER, authid DEFAULT, “, ‘ NO, YES NO, YES

— No Yes

—

— No — —

— No — Yes —

0–32767; 5

Yes

1–254; 6 Yes, No, blank 1–32767; calculated ‘, ‘’

Yes No Yes —

1–1440; 5 YES, NO

Yes Yes

YES, NO YES, NO

— Yes

5000K–2097152K 1K–2097152K; calculated

Yes Yes 173

®


IMPTSSEG

size EDM statement cache size DROP support Default encoding scheme Predicate evaluation with UR and RS Extra blocks requestor Extra blocks server Extended security EBCDIC coded character set (graphic byte) Group name Authorization at hop site Max batch connect Max TSO connect Idle thread timeout Default buffer pool for user indexes Immediate write Create implicit database Define datasets Use data compression Tablespace type

INLISTP IRLMAUT IRLMPRC

IN list elements Auto start Proc name

IRLMRWT IRLMSID IRLMSWT IXQTY

Resource timeout Subsystem name Time to autostart Indexspace default size Postpone backward log processing Locale LC_CTYPE Maximum LE tokens User LOB value storage User LOB value storage Log apply storage Long-running reader threshold Current maintenance

EDMSTMTC EDPROP ENSCHEME EVALUNC EXTRAREQ EXTRASRV EXTSEC GCCSID GRPNAME HOPAUTH IDBACK IDFORE IDTHTOIN IDXBPOOL IMMEDWRI IMPDB IMPDSDEF IMPTSCMP

LBACKOUT LC_CTYPE LEMAX LOBVALA LOBVALS LOGAPSTG LRDRTHLD MAINTYPE 174

0–1048576K; 5000

Yes

1, 2, 3 EBCDIC, ASCII

Yes —

YES, NO

Yes

0–100

Yes

0–100 NO, YES 0–65533

Yes Yes —

1–8 char; DSNCAT BOTH, RUNNER

No No

1–2000; 40 1–2000; 40 0–9999 BP0–BPx

Yes Yes Yes Yes

NO, YES, PH1 YES, NO

Yes Yes

YES, NO YES, NO

Yes Yes

SEGMENTED, PARTITIONED 1–5000; 50 YES, NO IRLMPROC, IRLM procedure name 1–3600; 60 IRLM, IRLM name 1–3600 0–4194304

Yes

AUTO, YES, NO

No

Valid locale, 0–50 char 0–50; 20 1–2097152; 2048

— No Yes

1–510002; 2048

Yes

1MB–100MB; 100 0–1439 minutes

No Yes

NONE, SYSTEM, USER,

Yes

Yes No No No No Yes Yes

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide MAXARCH MAXDBAT MAX_NUM_CUR MAXOFILR MAXKEEPD MAXRBLK MAXRTU MAXTEMPS MAX_ST_PROC MAXTYPE1 MCCSID MEMBNAME MGEXTSZ MINDVSCL MINRBLK MINSTOR MIXED MON MONSIZE NEWFUN NPGTHRSH NUMLKTS NUMLKUS OFFLOAD OJPERFEH OPTPREF OPTHINTS OUTBUFF PADIX PADNTSTR PARAMDEG PARTKEYU PCLOSEN PCLOSET POOLINAC PRIQTY PROTECT ®

DB2 9 for z/OS

types for MQTs Recording max Max remote active Max open cursors Max open file references Max kept dynamic statements RID pool size Read tape units Max temp/stage agent Max number of stored procedures Max type 1 inactive EBCDIC coded character set (mixed byte) Member name Optimize extent sizing

ALL 10–1000 0–1999; 64 0–99999; 500 0–MAXUSERS value; 100

No Yes Yes Yes

0–65535; 5000

Yes

0, 16K–1000000K; calculated 1–99; 2 0–214748364 0–99999; 2000

Yes

0–MAX REMOTE CON value 0–65533

Yes —

1–8 char; DSN1 YES, NO

No Yes

Yes Yes Yes

Number of ridlists for each ridmap Thread management Mixed data Monitor trace Monitor size

1, n

Use of index after table growth Locks per tablespace Locks per user Offload active logs online Outer join performance

0, –1, n

Yes — No No — Yes

0–50000; 1000 0–100000; 10000 NO, YES

Yes Yes •

YES, NO

Yes

ON, OFF NO, YES 40K–400MB; 400K YES, NO YES, NO

Yes No Yes Yes

0–no upper limit YES, NO, or SAME

Yes Yes

1–32767; 5

Yes

1–32767; 10 0–9999; 120 Blank, 1–9999999 NO, YES

Yes Yes Yes Yes

Optimization hints Output buffer Pad index by default Pad null-terminated strings Degree of parallelism Allow partitioning keys to be updated RO switch checkpoints RO switch time Pool thread timeout Primary quantity Archive logs protected

YES, NO NO, YES NO, YES 8K to 1MB

175

®

DB2 9 z/OS Reference Guide with RACF Include accounting traces for parallel tasks Quiesce period Recall database Recall delay Current refresh age Reopt automatically Restart or defer Recovery/restore

YES, NO

Yes

0–999; 5 YES, NO 0–32767; 120 0, ANY YES, NO RESTART, DEFER YES, NO

Yes No Yes Yes Yes — Yes

Maximum tape units

NOLIMIT, 1–255

Yes

1–99; 2 0–254 NO, YES 1–8 char; DSNRGCOL 1–8 char; DSNRGFDB NO, YES

Yes Yes Yes No No No

APPL, ACCEPT, REJECT

No

Non-alphanumeric char

No

YES, NO NO, YES

No No

RLFERRD

RLST access error

RLFTBL ROUTCDE RRULOCK SCCSID SECQTY

RLST name suffix WTO route codes U lock for RR/RS EBCDIC coded character set (singlebyte) Secondary quantity

1–17 char; DSN_REGISTER_OBJT 1–17 char; DSN_REGISTER_APPL NO, YES SYSIBM, authid NOLIMIT, NORUN, 1–50000000 NOLIMIT, NORUN, 1–50000000 01, 2 alphanumeric char 1, 1–14 route codes NO, YES 0-65533

No

RLF RLFAUTH RLFERR

Resync interval Retained lock timeout Varchar from index Registration owner Registration database Control all applications Unregistered DDL default ART/ORT escape character Require full names Install DD control support OBJT registration table APPL registration table RLF auto start Resource authid RLST access error

SEQCACH SEQPRES SITETYP

Sequential cache Utility cache option Site type

SJMXPOOL

Star join max pool

PTASKROL QUIESCE RECALL RECALLD REFSHAGE REOPTEXT RESTART/DEFR RESTORE_ RECVOER_ FROMDUMP RESTORE_TAPE UNITS RESYNC RETLWAIT RETVLCFK RGFCOLID RGFDBNAM RGFDEDPL RGFDEFLT RGFESCP RGFFULLQ RGFINSTL RGFNMORT RGFNMPRT

176

Blank (clist calculated), 1–9999999 BYPASS, SEQ NO, YES LOCALSITE, RECOVERYSITE 0–1024; 20

No No Yes Yes Yes Yes No Yes — Yes Yes Yes No Yes ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide SJTABLES

SMFACCT

Number of tables in star join Skip uncommitted inserts Measured usage pricing SMF accounting

SMFSTAT

SMF statistics

SMSDCFL

SMS data class for file tablespace SMS data class for index tablespace

SKIPUNCI SMF89

SMSDCIX SPRMEDX SPRMLTD SQLDELI SRTPOOL SSID STARJOIN STATHIST STATSINT STATROLL STATIME STDSQL STORMXAB STORPROC STORTIME SUPERRS SVOLARC SYNCVAL SYSADM SYSADM2 SYSOPR1 SYSOPR2 SYSTEM_LEVEL _BACKUPS TBSBP8K TBSBP16K TBSBP32K TBSBPOOL ®

DB2 9 for z/OS

1–255; 10

Yes

YES, NO

Yes

YES, NO

Yes

NO, YES(1), list (1–5,7,8), * YES (1,3,4), NO, list(1–5) , * Blank, 1–8 char

No No

Blank, 1–8 char

Yes

Yes

Yes SQL string delimiter Sort pool size Subsystem name Enabling star join Collect historical statistics Time to write RTS stats Runstats aggregates partition-level statistics Statistics time Standard SQL language Max abend count DB2 procedure name Timeout value Suppress Logrec recording during soft errors Single volume Statistics sync System admin 1 System admin 2 System operator 1 System operator 2 System-level backups Default 8K BP for user data Default 16K BP for user data Default 32K BP for user data Default buffer pool for

Default, ‘, “ 240K–64000K; 2MB DSN, SSID Disable, enable, 1, 2– 32768 SPACE, NONE, ALL, ACCESSPATH 1–1440 min; 30

— Yes — Yes

YES, NO

Yes

1–1440 min; 30 NO, YES

Yes —

0–225 1–8 char; ssnmSPAS 5–1800 sec; 180 YES, NO

Yes No Yes Yes

YES, NO NO, 0–59 SYSADM, authid SYSADM, authid SYSOPR, authid SYSOPR; authid YES, NO

Yes Yes Yes Yes Yes Yes Yes

Any 8K buffer pool; BP8K0

Yes

Any 16K buffer pool; BP16K0 Any 32K buffer pool; BP32K0 BP0–BPx

Yes

Yes Yes

Yes Yes 177

®


TCPKPALV

user Data TCP/IP already verified TCP/IP keep alive

TIME

Time format

TIMELEN TRACLOC

Local time length Size of local trace table Trace auto start Trace size Remote tracker site usage Default allocation for tablespace Timestamp archives Number of active copies Number of archive copies Number of BSDSs Unicode CCSID (graphic) Unicode IFCIDS Unicode CCSID (Mixed) Device type 1 Device type 2 UR check frequency UR log write check Unicode CCSID (single-byte) Dump class name

TCPALVER

TRACSTR TRACTBL TRKRSITE TSQTY TSTAMP TWOACTV TWOARCH TWOBSDS UGCCSID UIFCIDS UMCCSID UNIT UNIT2 URCHKTH URLGWTH USCCSID UTILS_DUMP_ CLASS_NAME UTIMOUT VOLTDEVT WLMENV XLKUPDT

178

Utility timeout Temporary unit name WLM environment X lock for searched U/D

NO, YES

Yes

ENABLE, DISABLE, 1– 65524 ISO, JIS, USA, EUR, LOCAL 0, 8–254 16 (4K bytes)

Yes — —

NO, YES (1–3), list (1–9) 4K–396K; 64K NO, YES

No No No

0–4194304

Yes

NO, YES 2, 1

Yes No

2, 1

No

YES, NO 1208

No —

YES, NO 1208

Yes —

TAPE, any device Device or unit name 0–255 0K–1000K 1208

Yes Yes Yes Yes —

Blank, valid DFSMS dump class name 1–254; 6 SYSDA, valid name Valid name (1–18 char) YES, NO

Yes Yes Yes Yes

®

DB2 9 for z/OS

®


Bind Parameters Option Valid values Plan Package Trigger ACQUIRE USE, ALLOCATE X Determines whether to acquire resources specified in the DBRM at first access or allocation ACTION REPLACE, ADD X, BO X, BO REPLACE(RPLVER) X, BO REPLACE(RETAIN) X, BO Determines whether the object (plan or package) replaces an existing object with same name or is new CACHESIZE Value of PLAN AUTH CACHE; X decimal value Determines the size (in bytes) of the authorization cache acquired in the EDM pool for the plan COPY Collection-id, package-id, X, BO COPYVER Determines that you are copying an existing package and names the package CURRENTDATA YES, NO X X X Determines whether to require data currency for RO and ambiguous cursors when isolation level is CS CURRENTSERVER Location-name X Determines the location to connect to before running the plan DBPROTOCOL DRDA, PRIVATE X X Specifies which protocol to use when connecting to a remote site that is identified by a three-part name X X DEFER DEFER(PREPARE), NODEFER(PREPARE) Determines whether to defer preparation of dynamic SQL statements that refer to remote objects or to prepare them immediately DEGREE 1, ANY X X Determines whether to attempt to run a query using parallel processing to maximize performance X DEPLOY (collection-id.package-id), COPYVER(version-id) Deploys a native SQL procedure DISCONNECT EXPLICIT, AUTOMATIC, X CONDITIONAL Determines which remote connections to destroy during commit operations DYNAMICRULES RUN, BIND,DEFINEBIND(PKG X X ONLY), DEFINERUN (PKG ONLY), INVOKEBIND(PKG ONLY), INVOKERUN(PKG ONLY) DEFINEBIND, DEFINERUN, X INVOKEBIND, INVOKERUN Determines which values apply at runtime for dynamic SQL attributes X X ENABLE/ DISABLE BATCH, CICS, DB2CALL, DLIBATCH, IMS, IMSBMP, IMSMPP, RRSAF , * REMOTE X Determines which connections can use the plan or package ®

DB2 9 for z/OS

179

®

DB2 9 z/OS Reference Guide Option Valid values Plan Package Trigger ENCODING ASCII, EBCDIC, UNICODE, ccsid X X Specifies the application encoding for all static statements in the plan or package (defaults to installed selection) EXPLAIN NO, YES X X X Determines whether to populate the PLAN_TABLE with information about the SQL statements FLAG I, W, E, C X X X Determines what messages to display IMMEDIATE NO, YES X X Determines whether immediate writes will be done for updates made to GBP-dependent page sets/partitions ISOLATION RR, RS, CS, UR, NC X X X Determines how far to isolate an application from the effects of other running applications KEEPDYNAMIC NO, YES X X Determines whether DB2 keeps dynamic SQL statements after commit points LIBRARY dbrm-pds-name (can be multiple X, BO X, BO for PLAN) Determines which partitioned data set to search for DBRMs listed in the member option MEMBER dbrm-member-name (can be X, BO X, BO multiple for PLAN) Determines what DBRMs to include in the plan or package OPTHINT X X Hint-id Controls whether query optimization hints are used for static SQL OPTIONS COMPOSITE, COMMAND X, BC Specifies which bind options to use for the new package OWNER X X Authorization-id Determines the authorization ID or the owner of the object (plan or package) PACKAGE X Location-name.collectionid.package-id (version-id) (*) – Rebind Only X, RO Determines which package or packages to bind or rebind PATH Schema-name, USER, (schemaX X name, (USER)…) Determines the SQL path that DB2 uses to resolve unqualified UDTs, functions, and stored procedure names PATHDEFAULT Mutually exclusive with PATH X X Resets the PATH for a package or plan to “SYSIBM”, “SYSFUN”, “SYSPROC”, or plan/package qualifier PKLIST or (Location-name.collectionX NOPKLIST id.package-id...), PKLIST only Determines which package to include for the package list in the plan PLAN X Plan-name (*) X, RO Determines which plan or plans to bind or rebind QUALIFIER X X Qualifier-name Determines the implicit qualifier for unqualified names of objects in the plan or package RELEASE COMMIT, DEALLOCATE X X X Determines when to release resources that the program uses, either at commit or at termination REOPT ONCE, ALWAYS, AUTO, NONE X X Specifies whether access path should be determined at runtime with host variables, parameter markers, and special registers 180

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Option ROUNDING

Valid values Plan Package Trigger X X CEILING, DOWN, FLOOR HALFDOWN, HALFEVEN, HALFUP, UP Specifies the rounding mode at bind time SQLERROR NOPACKAGE, CONTINUE X Determines whether to create a package if the package contains an SQL error SQLRULES DB2, STD X Determines whether a Type 2 connection can be made according to DB2 rules for an existing connection VALIDATE RUN, BIND X X Determines whether to recheck at runtime “not found” and “not authorized” errors found at bind time

®

DB2 9 for z/OS

181

®


DB2 Limits Identifier Length Limits Item External-java-routine-name Name of an alias, auxiliary table, collection, clone table, constraint, correlation, cursor (except for DECLARE CURSOR WITH RETURN or the EXEC SQL utility), distinct type (both parts of two-part name), function (both parts of two-part name), host identifier, index, JARs, parameter, procedure, role, schema, sequence, specific, statement, storage group, savepoint, SQL condition, SQL label, SQL parameter, SQL variable, synonym, table, trigger, view, XML attribute name, XML element name Name of an authorization ID Routine version number Name of a column Name of cursor that is created with DECLARE CURSOR WITH RETURN Name of cursor that is created with the EXEC SQL utility Name of a location Name of buffer pool name, catalog, database, plan, program, table space Name of package

Limit 1305 bytes 128 bytes

8 bytes 124 bytes 30 bytes 30 bytes 8 bytes 16 bytes 8 bytes 8 bytes (Only 8 EBCDIC characters are used for packages that are created with the BIND PACKAGE command. 128 bytes can be used for packages that are created as a result of the CREATE TRIGGER statement.)

Numeric Limits Item Smallest SMALLINT value Largest SMALLINT value Smallest INTEGER value Largest INTEGER value Smallest BIGINT value Largest BIGINT value Smallest REAL value Largest REAL value Smallest positive REAL value Largest negative REAL value Smallest FLOAT value Largest FLOAT value Smallest positive FLOAT value Largest negative FLOAT value 182

Limit -32768 32767 -2147483648 2147483647 -9223372036854775808 9223372036854775807 About -7.2*10(75) About 7.2*10(75) About 5.4*10(-79) About -5.4*10(-79) About -7.2*10(75) About 7.2*10(75) About 5.4*10(-79) About -5.4*10(-79) ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Item Smallest DECIMAL value Largest DECIMAL value Largest DECIMAL precision Smallest DECFLOAT(16) value Largest DECFLOAT(16) value Smallest positive DECFLOAT(16) value Largest negative DECFLOAT(16) value Smallest DECFLOAT(34) value Largest DECFLOAT(34) value Smallest positive DECFLOAT(34) value Largest negative DECFLOAT(34) value Coefficient length for DECFLOAT values Maximum Exponent (Emax) for DECFLOAT values Minimum Exponent (Emin) for DECFLOAT values Bias for DECFLOAT values

Limit 1 - 10(31) 10(31) - 1 31 384 -9.999999999999999×10 384 9.999999999999999×10 -383 1.000000000000000×10 -383 -1.000000000000000×10 -9.999999999999999999999999999999999 6144 ×10 9.999999999999999999999999999999999 6144 ×10 1.000000000000000000000000000000000 -6143 ×10 -1.000000000000000000000000000000000 -6143 ×10 DECFLOAT(16) is 16 digits; DECFLOAT(34) is 34 digits DECFLOAT(16) is 384; DECFLOAT(34) is 6144 DECFLOAT(16) is -383; DECFLOAT(34) is 6143 DECFLOAT(16) is 398; DECFLOAT(34) is 6176

String Length Limits Item Maximum length of CHAR Maximum length of GRAPHIC Maximum length of BINARY

Limit 255 bytes 127 DBCS characters 255 bytes

Maximum length of VARCHAR

4046 bytes for 4-KB pages 8128 bytes for 8-KB pages 16320 bytes for 16-KB pages 32704 bytes for 32-KB pages

Maximum length of VARCHAR that can be indexed by an XML index

100 bytes after conversion to UTF-8

Maximum length of VARGRAPHIC

2023 DBCS characters for 4-KB pgs 4064 DBCS characters for 8-KB pgs 8160 DBCS characters for 16-KB pgs 16352 DBCS characters for 32-KB pgs 32704 bytes 2 147 483 647 bytes (2GB - 1 byte) 1 073 741 824 DBCS characters 2 147 483 647 bytes (2GB - 1 byte) 32704 UTF-8 bytes 32704 hexadecimal digits

Maximum length of VARBINARY Maximum length of CLOB Maximum length of DBCLOB Maximum length of BLOB Maximum length of a character constant Maximum length of a hexadecimal ®

DB2 9 for z/OS

183

®

DB2 9 z/OS Reference Guide Item character constant Maximum length of a graphic string constant Maximum length of a hexadecimal graphic string constant Maximum length of a text string used for a scalar expression Maximum length of a concatenated character string Maximum length of a concatenated graphic string Maximum length of a concatenated binary string Maximum length of XML pattern text Maximum length of an XML element or attribute name in an XML document Maximum length of a namespace uri Maximum length of a namespace prefix Largest depth of an internal XML tree

Limit 32704 UTF-8 bytes 32704 hexadecimal digits 4000 UTF-8 bytes 2 147 483 647 bytes (2GB - 1 byte) 1 073 741 824 DBCS characters 2 147 483 647 bytes (2GB - 1 byte) 4000 bytes after conversion to UTF-8 1000 bytes 1000 bytes 998 bytes 128 levels

Datetime Limits Item Smallest DATE value (shown in ISO format) Largest DATE value (shown in ISO format) Smallest TIME value (shown in ISO format) Largest TIME value (shown in ISO format) Smallest TIMESTAMP value Largest TIMESTAMP value

Limit 0001-01-01 9999-12-31 00.00.00 24.00.00 0001-01-01-00.00.00.000000 9999-12-31-24.00.00.000000

DB2 Limits on SQL Statements Item Maximum number of columns in a table or view (the value depends on the complexity of the CREATE VIEW statement) or columns returned by a table function. Maximum number of base tables in a view, SELECT, UPDATE, INSERT, or DELETE Maximum number of rows that can be inserted with a single INSERT or MERGE statement Maximum row and record sizes for a table Maximum number of volume IDs in a storage group Maximum number of partitions in a partitioned tablespace or partitioned index

184

Limit 750 or fewer (including hidden columns) 749 if the table is a dependent 225 32767 Dependent on type of table created 133 64 for tablespaces that are not defined with LARGE or a DSSIZE greater than 2GB 4096, depending on what is specified for DSSIZE or LARGE and the page size

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Item Maximum size of a partition (tablespace or index)

Maximum length of an index key

Maximum number of expressions in an index key Maximum number of columns in an index key Maximum number of tables in a FROM clause Maximum number of subqueries in a statement Maximum total length of host and indicator variables pointed to in an SQLDA Longest host variable used for insert or update

Longest SQL statement Maximum number of elements in a select list Maximum number of predicates in a WHERE or HAVING clause Maximum total length of columns of a query operation requiring a sort key (SELECT DISTINCT, ORDER BY, GROUP BY, UNION, EXCEPT and INTERSECT, without the ALL keyword, and the DISTINCT keyword for aggregate functions) Maximum total length of columns of a query operation requiring a sort and evaluating column functions (MULTIPLE DISTINCT and GROUP BY) Maximum length of a sort key Maximum length of a table check constraint

®

DB2 9 for z/OS

Limit For tablespaces that are not defined with LARGE or a DSSIZE greater than 2GB: 4GB, for 1 to 16 partitions 2GB, for 17 to 32 partitions 1GB, for 33 to 64 partitions For tablespaces that are defined with LARGE: 4GB, for 1 to 4096 partitions For tablespaces that are defined with a DSSIZE greater than 2GB: 64GB, depending on the page size, (1 to 256 partitions for 4KB, 1 to 512 partitions for 16KB, 1 to 1024 partitions for 32KB, and 1 to 2048 for 32KB) Partitioning index: 255-n Nonpartitioning index that is padded 2000-n Nonpartitioning index that is not padded 2000-n2m N=number of columns in the key that allow nulls, and m is the number of varying length columns in the key 64 64 225 or fewer, depending on the complexity of the statement 224 32767 bytes 2 147 483 647 bytes (2GB - 1 byte) for a LOB, subject to the limitations imposed by the application environment and host language 32704 bytes for a non-LOB 2 147 483 647 bytes (2GB - 1 byte) for a LOB, subject to the limitations imposed by the application environment and host language 2097152 bytes 750 or fewer, depending on whether the select list is for the result table of a static scrollable cursor Limited by storage 4000 bytes

32600 bytes

16000 bytes 3800 bytes

185

®

DB2 9 z/OS Reference Guide Item Maximum number of bytes that can be passed in a single parameter of an SQL CALL statement Maximum number of stored procedures, triggers, and user-defined functions that an SQL statement can implicitly or explicitly reference Maximum length of the SQL path Maximum length of a WLM environment name in a CREATE PROCEDURE, CREATE FUNCTION, ALTER PROCEDURE, or ALTER FUNCTION statement. Maximum number of XPath level in the XMLPATTERN clause of the CREATE INDEX statement.

Limit 32765 bytes for a non-LOB 2 147 483 647 bytes (2GB - 1 byte) for a LOB, subject to the limitations imposed by the application environment and host language 16 nesting levels

2048 bytes 32 bytes

50 nesting levels

DB2 System Limits Item Maximum number of concurrent DB2 or application agents Largest non-LOB table or tablespace Largest simple or segmented table space Largest log space Largest active log data set Largest archive log data set Maximum number of active log copies Maximum number of archive log copies Max number of active log data sets (each copy) Max number of archive log volumes (each copy) Maximum number of databases accessible to an application or end user Largest EDM pool Maximum number of databases Maximum number of rows per page Maximum number of implicitly created databases Maximum number of indexes on declared global temporary tables Maximum simple or segmented data set size Maximum partitioned data set size Maximum LOB data set size Maximum number of rows that can be inserted with a single INSERT statement Maximum number of table spaces that can be defined in a work file database Maximum number of tables and triggers that can be defined in a work file database 186

Limit Limited by the EDM pool size, buffer pool size, and the amount of storage used by each DB2 or application agent 128 terabytes 64 GB 48 2 4 GB – 1 byte 4 GB – 1 byte 2 2 93 10000 Limited by system storage and EDM pool size The installation parameter maximum depends on available space 65271 255 for all tablespaces except catalog and directory tablespaces, which have a maximum of 127 60000 10000 2GB See "maximum size of a partition" 64GB 32767 rows 500 11767 ®

DB2 9 for z/OS

®


SQL Communication Area (SQLCA) Assembler, COBOL, or PL/I Name SQLCAID

C Name sqlcaid

Data type CHAR(8)

SQLCABC SQLCODE

sqlcabc SQLCODE

INTEGER INTEGER

Purpose An “eye catcher” for storage dumps, containing the text 'SQLCA'. The sixth byte is ’L’ if line number information is returned from parsing a dynamic statement or a native SQL procedure. The sixth byte is not set when processing an external SQL procedure. Contains the length of the SQLCA: 136. Contains the SQL return code. 0 = Successful execution (though there might have been warning messages). Positive = Successful execution, but with an exception condition.

SQLERRML

sqlerrml

SMALLINT

SQLERRMC

sqlerrmc

VARCHAR(70)

SQLERRP

sqlerrp

CHAR(8)

SQLERRD(1)

sqlerrd[0]

INTEGER

SQLERRD(2)

sqlerrd[1]

INTEGER

®

DB2 9 for z/OS

Negative = Error condition. Length indicator for SQLERRMC, in the range 0 through 70.0 means that the value of SQLERRMC is not pertinent. Contains one or more tokens, separated by X'FF', that are substituted for variables in the descriptions of error conditions. It may contain truncated tokens. A message length of 70 bytes indicates a possible truncation. Provides a product signature and, in the case of an error, diagnostic information such as the name of the module that detected the error. In all cases, the first three characters are 'DSN' for DB2 for z/OS. For a sensitive static cursor, contains the number of rows in a result table when the cursor position is after the last row (that is, when SQLCODE is equal to +100). Can also contain an internal error code. For a sensitive static cursor, contains the number of rows in a result table when the cursor position is after the last row (that is, when SQLCODE is equal to +100). Can also contain an internal error code.

187

®

DB2 9 z/OS Reference Guide Assembler, COBOL, or PL/I Name SQLERRD(3)

188

C Name sqlerrd[2]

Data type INTEGER

Purpose Contains the number of rows that qualified to be deleted, inserted, or updated after an INSERT, MERGE, UPDATE, or DELETE statement. The number excludes rows affected by either triggers or referential integrity constraints. For the OPEN of a cursor for a SELECT with a data change statement or for a SELECT INTO, SQLERRD(3) contains the number of rows affected by the embedded data change statement. The value is 0 if the SQL statement fails, indicating that all changes made in executing the statement canceled. For a DELETE statement the value will be -1 if the operation is a mass delete from a table in a segmented table space and the DELETE statement did not include selection criteria. If the delete was against a view, neither the DELETE statement nor the definition of the view included selection criteria. For a TRUNCATE statement, the value will be -1. For a REFRESH TABLE statement, SQLERRD(3) contains the number of rows inserted into the materialized query table. For a rowsetoriented FETCH, contains the number of rows fetched. For SQLCODES -911 and 913, SQLERRD(3) contains the reason code for the timeout or deadlock. When an error is encountered in parsing a dynamic statement, or when parsing, binding, or executing a native SQL procedure, SQLERRD(3) will contain the line number where the error was encountered. The sixth byte of SQLCAID must be ’L’ for this to be a valid line number. This value will be meaningful only if the statement source contains new line control characters. This information is not returned for an external SQL procedure.

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Assembler, COBOL, or PL/I Name SQLERRD(4)

C Name sqlerrd[3]

Data type INTEGER

SQLERRD(5)

sqlerrd[4]

INTEGER

SQLERRD(6) SQLWARN0

sqlerrd[5] SQLWARN0

INTEGER CHAR(1)

SQLWARN1

SQLWARN1

CHAR(1)

SQLWARN2

SQLWARN2

CHAR(1)

SQLWARN3

SQLWARN3

CHAR(1)

SQLWARN4

SQLWARN4

CHAR(1)

®

DB2 9 for z/OS

Purpose Generally contains timerons, a short floating-point value that indicates a rough relative estimate of resources required. It does not reflect an estimate of the time required. When preparing a dynamically defined SQL statement, you can use this field as an indicator of the relative cost of the prepared SQL statement. For a particular statement, this number can vary with changes to the statistics in the catalog. It is also subject to change between releases of DB2 for z/OS. Contains the position or column of a syntax error for a PREPARE or EXECUTE IMMEDIATE statement. Contains an internal error code. Contains a W if at least one other indicator also contains a W; otherwise, contains a blank. Contains a W if the value of a string column was truncated when assigned to a host variable. Contains an N for non-scrollable cursors and S for scrollable cursors after the OPEN CURSOR or ALLOCATE CURSOR statement. If subsystem parameter DISABSCL is set to YES, the field will not be set to N for non-scrollable cursors. Contains a W if null values were eliminated from the argument of a column function; not necessarily set to W for the MIN function because its results are not dependent on the elimination of null values. Contains a W if the number of result columns is larger than the number of host variables. Contains a Z if fewer locators were provided in the ASSOCIATE LOCATORS statement than the stored procedure returned. Contains a W if a prepared UPDATE or DELETE statement does not include a WHERE clause. For scrollable cursor, contains a D for sensitive dynamic cursors, I for insensitive cursors, and S for sensitive cursors after the OPEN CURSOR or ALLOCATE CURSOR statement; blank if not scrollable. If DSNZPARM DISABSCL is set to YES, it will be set to N for nonscrollable cursors.

189

®

DB2 9 z/OS Reference Guide Assembler, COBOL, or PL/I Name SQLWARN5

C Name SQLWARN5

Data type CHAR(1)

SQLWARN6

SQLWARN6

CHAR(1)

SQLWARN7

SQLWARN7

CHAR(1)

SQLWARN8

SQLWARN8

CHAR(1)

SQLWARN9

SQLWARN9

CHAR(1)

SQLWARNA

SQLWARNA

CHAR(1)

SQLSTATE

sqlstate

CHAR(5)

Purpose Contains a W if the SQL statement was not executed because it is not a valid SQL statement in DB2 for z/OS. Contains a character value of 1 (read only), 2 (read and delete), or 4 (read, delete, and update) to reflect capability of the cursor after the OPEN CURSOR or ALLOCATE CURSOR statement. If subsystem parameter DISABSCL is set to YES, the field will not be set to N for non-scrollable cursors. Contains a W if the addition of a month or year duration to a DATE or TIMESTAMP value results in an invalid day (for example, June 31). Indicates that the value of the day was changed to the last day of the month to make the result valid. Contains a W if one or more nonzero digits were eliminated from the fractional part of a number used as the operand of a decimal multiply or divide operation. Contains a W if a character that could not be converted was replaced with a substitute character. Contains a W if arithmetic exceptions were ignored during COUNT or COUNT_BIG processing. Contains a Z if the stored procedure returned multiple result sets. Contains a W if at least one character field of the SQLCA or the SQLDA names or labels is invalid due to a character conversion error. Contains a return code for the outcome of the most recent execution of an SQL statement.

The REXX SQLCA Variable SQLCODE SQLERRMC SQLERRP SQLERRD.1 SQLERRD.2

190

Contents The SQL return code. One or more tokens, separated by X'FF', that are substituted for variables in the descriptions of error conditions. It may contain truncated tokens. A message length of 70 bytes indicates a possible truncation. A product signature and, in the case of an error, diagnostic information such as the name of the module that detected the error. For DB2 for z/OS, the product signature is “DSN”. For a sensitive static cursor, contains the number of rows in a results table when the cursor position is after the last row (that is, when SQLCODE is equal to +100) Can also contain an internal error code. For a sensitive static cursor, contains the number of rows in a results table when the cursor position is after the last row (that is, when SQLCODE is equal to +100) ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Variable SQLERRD.3

SQLERRD.4

SQLERRD.5 SQLERRD.6 SQLWARN.0 SQLWARN.1 SQLWARN.2 SQLWARN.3 SQLWARN.4

SQLWARN.5

SQLWARN.6 SQLWARN.7

®

DB2 9 for z/OS

Contents Can also contain an internal error code. Contains the number of rows that qualified for the operation after an SQL data change statement (but not rows deleted as a result of CASCADE delete). For the OPEN of a cursor for a SELECT with an SQL data change statement or for a SELECT INTO, SQLERRD(3) contains the number of rows affected by the embedded data change statement. Set to 0 if the SQL statement fails, indicating that all changes made in executing the statement were canceled. Set to -1 for a mass delete from a table in a segmented table space, for a truncate operation, or a delete from a view when neither the DELETE statement nor the definition of the view included selection criteria. For rowset-oriented FETCH statements, contains the number of rows returned in the rowset. For SQLCODES -911 and -913, SQLERRD(3) contains the reason code for the timeout or deadlock. After successful execution of the REFRESH TABLE statement, SQLERRD(3) contains the number of rows inserted into the materialized query table. When an error is encountered in parsing a dynamic statement, or when parsing, binding, or executing a native SQL procedure, SQLERRD(3) will contain the line number where the error was encountered. The sixth byte of SQLCAID must be ’L’ for this to be a valid line number. This value will be meaningful only if the statement source contains new line control characters. This information is not returned for an external SQL procedure. Generally contains timerons, a short floating-point value that indicates a rough relative estimate of resources required. This value does not reflect an estimate of the time required to execute the SQL statement. After you prepare an SQL statement, you can use this field as an indicator of the relative cost of the prepared SQL statement. For a particular statement, this number can vary with changes to the statistics in the catalog. This value is subject to change between releases of DB2 for z/OS. The position or column of a syntax error for a PREPARE or EXECUTE IMMEDIATE statement. An internal error code. Blank if all other indicators are blank; W if at least one other indicator also contains a W. W if the value of a string column was truncated when assigned to a host variable. W if null values were eliminated from the argument of a column function; not necessarily set to W for the MIN function because its results are not dependent on the elimination of null values. W if the number of result columns is larger than the number of host variables. Z if the ASSOCIATE LOCATORS statement contains fewer locators than the stored procedure returned. W if a prepared UPDATE or DELETE statement does not include a WHERE clause. For a scrollable cursor, contains a D for sensitive dynamic cursors, I for insensitive cursors, and S for sensitive cursors after the OPEN CURSOR or ALLOCATE CURSOR statement, blank if not scrollable. Contains a W if the SQL statement was not executed because it is not a valid SQL statement in DB2 for z/OS. Contains a character value of 1 (read only), 2 (read and delete), or 4 (read, delete, and update) to reflect capability of the cursor after the OPEN CURSOR or ALLOCATE CURSOR statement. W if the addition of a month or year duration to a DATE or TIMESTAMP value results in an invalid day (for example, June 31). Indicates that the value of the day was changed to the last day of the month to make the result valid. W if one or more nonzero digits were eliminated from the fractional part of a number that was used as the operand of a decimal multiply or divide operation. 191

®

DB2 9 z/OS Reference Guide Variable SQLWARN.8 SQLWARN.9 SQLWARN.10 SQLSTATE

Contents W if a character that could not be converted was replaced with a substitute character. W if arithmetic exceptions were ignored during COUNT DISTINCT processing. Z if the stored procedure returned multiple result sets. W if at least one character field of the SQLCA is invalid due to a character conversion error. A return code for the outcome of the most recent execution of an SQL statement.

GET DIAGNOSTICS Statement Information Item DB2_GET_DIAGNOSTICS _DIAGNOSTICS DB2_LAST_ROW DB2_NUMBER_ PARAMETER_MARKERS DB2_NUMBER_RESULT_ SETS DB2_NUMBER_ROWS

DB2_RETURN_STATUS DB2_SQL_ATTR _CURSOR_HOLD DB2_SQL_ATTR_ CURSOR_ROWSET DB2_SQL_ATTR _CURSOR_SCROLLABLE DB2_SQL_ATTR _CURSOR_SENSITIVITY DB2_SQL_ATTR 192

Description After a GET DIAGNOSTICS statement, if any error or warning occurred, this item contains all of the diagnostics as a single string After a multiple-row FETCH statement, this item contains a value of +100 if the last row in the table is in the rowset that was returned. After a PREPARE statement, this item contains the number of parameter markers in the prepared statement. After a CALL statement that invokes a stored procedure, this item contains the number of result sets that are returned by the procedure. After an OPEN or FETCH statement for which the size of the result table is known, this item contains the number of rows in the result table. After a PREPARE statement, this item contains the estimated number of rows in the result table for the prepared statement. For SENSITIVE DYNAMIC cursors, this item contains the approximate number of rows. After a CALL statement that invokes an SQL procedure, this item contains the return status if the procedure contains a RETURN statement. After an ALLOCATE or OPEN statement, this item indicates whether the cursor can be held CHAR(1) open across multiple units of work (Y or N). After an ALLOCATE or OPEN statement, this item indicates whether the cursor can use rowset positioning (Y or N). After an ALLOCATE or OPEN statement, this item indicates whether the cursor is scrollable (Y or N). After an ALLOCATE or OPEN statement, this item indicates whether the cursor shows updates made by other processes (sensitivity A, I, or S). After an ALLOCATE or OPEN statement, this

Data type VARCHAR(32672) INTEGER INTEGER INTEGER DECIMAL(31,0)

INTEGER

CHAR(1) CHAR(1) CHAR(1) CHAR(1) ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Item _CURSOR_TYPE

MORE NUMBER

ROW_COUNT

Description item indicates whether the cursor is declared static (S for INSENSITIVE or SENSITIVE STATIC) or dynamic (D for SENSITIVE DYNAMIC). After any SQL statement, this item indicates whether some conditions items were discarded because of insufficient storage (Y or N). After any SQL statement, this item contains the number of condition items. If no warning or error occurred, or if no previous SQL statement has been executed, the number that is returned is 1. After DELETE, INSERT, UPDATE, or FETCH, this item contains the number of rows that are deleted, inserted, updated, or fetched. After PREPARE, this item contains the estimated number of result rows in the prepared statement.

Data type

CHAR(1) INTEGER

DECIMAL(31,0)

Conditional Data Types Item CATALOG_NAME

CONDITION_NUMBER CURSOR_NAME DB2_ERROR_CODE1 DB2_ERROR_CODE2 DB2_ERROR_CODE3 DB2_ERROR_CODE4 DB2_INTERNAL _ERROR_POINTER DB2_LINE_NUMBER DB2_MESSAGE_ID

DB2_MODULE_ DETECTING _ERROR DB2_ORDINAL_TOKEN_n DB2_REASON_CODE DB2_RETURNED_SQLCODE ®

DB2 9 for z/OS

Description This item contains the server name of the table that owns a constraint that caused an error, or that caused an access rule or check violation. This item contains the number of the condition. This item contains the name of a cursor in an invalid cursor state. This item contains an internal error code This item contains an internal error code This item contains an internal error code. This item contains an internal error code. For some errors, this item contains a negative value that is an internal error pointer. Line number where an error is encountered in parsing a dynamic statement. This item contains the message ID that corresponds to the message that is contained in the CHAR(10) MESSAGE_TEXT diagnostic item. After any SQL statement, this item indicates which module detected the error After any SQL statement, this item contains the nth token, where n is a value from 1 to 100. After any SQL statement, this item contains the reason code for errors that have a reason code token in the message text. After any SQL statement, this item contains

Data type VARCHAR(128)

INTEGER VARCHAR(128) INTEGER INTEGER INTEGER INTEGER INTEGER INTEGER INTEGER

CHAR(8) VARCHAR(515) INTEGER INTEGER 193

®

DB2 9 z/OS Reference Guide Item DB2_ROW_NUMBER

DB2_TOKEN_COUNT MESSAGE_TEXT RETURNED_SQLSTATE SERVER_NAME

Description the SQLCODE for the condition. After any SQL statement that involves multiple rows, this item contains the row number on which DB2 detected the condition. After any SQL statement, this item contains the number of tokens available for the condition. After any SQL statement, this item contains the message text associated with the SQLCODE. After any SQL statement, this item contains the SQLSTATE for the condition. After a CONNECT, DISCONNECT, or SET CONNECTION statement, this item contains the name of the server specified in the statement.

Data type DECIMAL(31,0)

INTEGER VARCHAR(32672) CHAR(5) VARCHAR(128)

Connection Information Item DB2_AUTHENTICATION_TYPE DB2_AUTHORIZATION_ID DB2_CONNECTION_STATE DB2_CONNECTION_STATUS DB2_ENCRYPTION_TYPE

DB2_SERVER_CLASS_NAME DB2_PRODUCT_ID

194

Description This item contains the authentication type (S, C, T or blank). This item contains the authorization ID that is used by the connected server. This item indicates whether the connection is unconnected (-1), local (0), or remote (1). This item indicates whether updates can be committed for the current unit of work (1 for Yes, 2 for No). This item contains one of the following values that indicates the level of encryption for the Connection: A = Only the Authentication tokens (authid and password) are encrypted D = All of the data for the connection is encrypted After a CONNECT or SET CONNECTION statement, this item contains the DB2 server class name. This item contains the DB2 product signature.

Data type CHAR(1) VARCHAR(128) INTEGER INTEGER CHAR(1)

VARCHAR(128) VARCHAR(8)

®

DB2 9 for z/OS

®


Predicates Predicate Type COL = value COL = noncol expr COL IS NULL COL op value COL op noncol expr COL BETWEEN value1 AND value2 COL BETWEEN noncol expr1 AND noncol expr2 value BETWEEN COL1 AND COL2 COL BETWEEN COL1 AND COL2 COL BETWEEN expression1 AND expression2 COL LIKE 'pattern' COL IN (list) COL value COL noncol expr COL IS NOT NULL COL NOT BETWEEN value1 AND value2 COL NOT BETWEEN noncol expr1 AND noncol expr2 value NOT BETWEEN COL1 AND COL2 COL NOT IN (list) COL NOT LIKE ‘ char’ COL LIKE '%char' COL LIKE '_char' COL LIKE host variable T1.COL = T2 col expr T1.COL op T2 col expr T1.COL T2 col expr T1.COL1 = T1.COL2 T1.COL1 op T1.COL2 T1.COL1 T1.COL2 COL=(noncor subq) COL = ANY (noncor subq) COL = ALL (noncor subq) COL op (noncor subq) COL op ANY (noncor subq) COL op ALL (noncor subq) COL (noncor subq) COL ANY (noncor subq) COL ALL (noncor subq) COL IN (noncor subq) (COL1,...COLn) IN (noncor subq) COL NOT IN (noncor subq) (COL1,...COLn) NOT IN (noncor subq) COL = (cor subq) COL = ANY (cor subq) COL = ALL (cor subq) COL op (cor subq) COL op ANY (cor subq) ®

DB2 9 for z/OS

Indexable Y Y Y Y Y Y Y N N Y Y Y N N Y N N

Stage 1 Y Y Y Y Y Y Y N N Y Y Y Y Y Y Y Y

N N N N N Y Y Y N N N N Y N N Y Y Y N N N Y Y N N N N N N N

N Y Y Y Y Y Y Y Y N N N Y N N Y Y Y Y N N Y Y N N N N N N N 195

®

DB2 9 z/OS Reference Guide COL op ALL (cor subq) COL (cor subq) COL ANY (cor subq) COL ALL (cor subq) COL IN (cor subq) (COL1,...COLn) IN (cor subq) COL NOT IN (cor subq) (COL1,...COLn) NOT IN (cor subq) COL IS DISTINCT FROM value COL IS NOT DISTINCT FROM value COL IS DISTINCT FROM noncol expr COL IS NOT DISTINCT FROM noncol expr T1.COL1 IS DISTINCT FROM T2.COL2 T1.COL1 IS NOT DISTINCT FROM T2.COL2 T1.COL1 IS DISTINCT FROM T2 col expr T1.COL1 IS NOT DISTINCT FROM T2 col expr COL IS DISTINCT FROM (noncor subq) COL IS NOT DISTINCT FROM (noncor subq) COL IS DISTINCT FROM ANY (noncor subq) COL IS NOT DISTINCT FROM ANY (noncor subq) COL IS DISTINCT FROM ALL (noncor subq) COL IS NOT DISTINCT FROM ALL (noncor subq) COL IS NOT DISTINCT FROM (cor subq) COL IS DISTINCT FROM ANY (cor subq) COL IS DISTINCT FROM ANY (cor subq) COL IS NOT DISTINCT FROM ANY (cor subq) COL IS DISTINCT FROM ALL (cor subq) COL IS NOT DISTINCT FROM ALL (cor subq) EXISTS (subq) NOT EXISTS (subq) expression = value expression value expression op value expression op (subq) XMLEXISTS NOT XMLEXISTS

196

N N N N N N N N N Y N Y N N N Y N Y N N N N N N N N N N N N N N N N Y N

N N N N N N N N Y Y Y Y N N Y Y Y Y N N N N N N N N N N N N N N N N N N

®

DB2 9 for z/OS

®


IFCIDS Trace Type

Class IFCID

Description

ACCOUNTING

1

3

ALL ACCOUNTING

106

SYSTEM PARAMETERS IN EFFECT

239

OVERFLOW FOR PACKAGE ACCOUNTING

200

UDF ENTRY/EXIT SIGNAL

2 3

®

DB2 9 for z/OS

232

DB2 THREAD ENTRY/EXIT SIGNAL

6

BEGINNING OF A READ I/O OPERATION

7

CC AFTER READ I/O OPERATION

8

BEGINNING OF SYNCHRONOUS WRITE I/O

9

CC OF SYNC OR ASYNC WRITE I/O

32

BEGIN OF WAIT FOR LOG MANAGER

33

END OF WAIT FOR LOG MANAGER

44

LOCK SUSPEND OR IDENTIFY CALL IRLM

45

LOCK RESUME

51

SHARED LATCH RESUME. SERVICEABILITY

52

SHARED LATCH WAIT. SERVICEABILITY

56

EXCL. LATCH WAIT. SERVICEABILITY

57

EXCL. LATCH RESUME. SERVICEABILITY

117

BEGIN THREAD WAIT TIME FOR LOG I/O

118

END THREAD WAIT TIME FOR LOG I/O

127

AGENT READY TO SUSPEND PAGE WAIT

128

PAGE REQUESTOR RESUMED BY I/O INIT.

170

SUSPEND FOR SYNC EXEC.N UNIT SWITCH

171

RESUME AGENT WAITING DB2 SERV. TASK

174

BEGIN ARCHIVE LOG MODE (QUIESCE)

175

END ARCHIVE LOG MODE (QUIESCE)

213

BEGIN OF WAIT FOR CLAIM REQUEST

214

END OF WAIT FOR CLAIM REQUEST

215

BEGIN OF WAIT FOR DRAIN REQUEST

216

END OF WAIT FOR DRAIN REQUEST

226

BEGIN OF SUSPEND FOR PAGE LATCH

227

END OF SUSPEND FOR PAGE LATCH

242

BEGIN WAIT FOR SCHED. STORED PROC.

243

END WAIT FOR SCHED. STORED PROC.

313

MESSAGES FOR LONG-RUNNING URS. 197

®

DB2 9 z/OS Reference Guide Trace Type

Class IFCID

Description

4

151

USER-DEFINED ACCOUNTING TRACE

5

187

ENTRY TO AND EXIT FROM IFI

7

232


232

FOR PACKAGE/DBRM LEVEL ACCOUNTING

8

AUDIT

198

240

EVENT SIGNAL FOR PACKAGE ACCOUNTING

6


7


8


9

CC OF SYNC OR ASYNC WRITE I/O

32


33


44


45

LOCK RESUME

51


52


56


57


117


118


127


128


170

SUSPEND FOR SYNC EXEC.N UNIT SWITCH

171

RESUME AGENT WAITING DB2 SERV. TASK

174


175


213


214


215


216


226


227


241

BEGIN/END SUSPENSION OF PACK/DBRM

242


243


1

140

AUTHORIZATION FAILURES

2

141

EXPLICIT GRANT AND REVOKES

3

142

CREATES, ALTERS, DROPS – AUDIT ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Trace Type

Class IFCID

Description

4

143

FIRST ATTEMPTED WRITE AUDITED OBJ.

5

144

FIRST ATTEMPTED READ AUDITED OBJ.

6

145

AUDIT LOG RECORD OF SOME SQL STMTS

7

55

ISSUANCE OF SET CURRENT SQLID

83

END IDENTIFY REQUEST

87

ENDING OF SIGNON REQUEST

169

DISTRIBUTED AUTHID TRANSLATION

8

MONITOR

®

DB2 9 for z/OS

312

DCE SECURITY

23

UTILITY START INFORMATION

24

UTILITY OBJECT OR PHASE CHANGE

25

UTILITY END INFORMATION

9

146

USER-DEFINED AUDIT TRACE

1

1

SYSTEM SERVICES

2

DATABASE SERVICES

106


124

CURRENT SQL STATEMENT

129

VSAM CI'S – DB2 RECOVER LOG

147

SUMMARY THREAD STATUS RECORD

148

DETAILED THREAD STATUS RECORD

149

LOCK INFORMATION FOR A RESOURCE

150

LOCK INFORMATION FOR AN AGENT IFCID

202

SYSTEM PARAMETERS

230

DATA SHARING GLOBAL STATISTICS

254

GROUP BUFFER POOL USAGE

306

LOG RECORD RETRIEVAL

316

PREPARED STMT. CACHE STATISTICS

317

PREPARED STMT. CACHE STMT. TEXT

2

232

DB2 THREAD ENTRY EXIT SIGNAL

3

6


7


8


9

CC OF SYN OR ASYNC WRITE I/O

32


33


44


45

LOCK RESUME

51

SHARED LATCH RESUME. SERVICEABILITY 199

®


Class IFCID


56


57


117


118


127


128


170

SUSPEND FOR SYNC EXEC. UNIT SWITCH

171

RESUME AGENT WAITING DB2 SERV. TSK

174


175


213


214


215


216


226


227


242


243


4

155

USER-DEFINED MONITOR TRACE

5

187

ENTRY OR EXIT TO IFI

6

185

DATA CAPTURE INFORMATION

7

232


232

FOR PACKAGE/DBRM-LEVEL ACCOUNTING

8

200

Description

52

240

EVENT SIGNAL FOR PACKAGE ACCOUNTING

6


7


8


9


32


33


44


45

LOCK RESUME

51


52


56


57

EXCL. LATCH RESUME. SERVICEABILITY ®

DB2 9 for z/OS

®


Class IFCID 117

PERFORMANCE

1

2

®

DB2 9 for z/OS

Description BEGIN THREAD WAIT TIME FOR LOG I/O

118


127


128


170

SUSPEND FOR SYNC EXEC. UNIT SWITCH

171

RESUME AGENT WAITING DB2 SERV. TSK

174


175


213


214


215


216


226


227


241

BEGIN/END SUSPENSION OF PACK/DBRM

242


243


1

SYSTEM SERVICES

2

DATABASE SERVICES

31

EDM POOL FULL CONDITION

42

A CHECKPOINT STARTED

43

A CHECKPOINT ENDED

76

BEGINNING OF END OF MEMORY REQUEST

77

ENDING OF AN END OF MEMORY REQUEST

78

BEGINNING OF AN END OF TASK REQUEST

79

ENDING OF AN END OF TASK REQUEST

102

DETECTION OF SHORT ON STORAGE

103

SETTING OFF OF SHORT ON STORAGE

105

INTERNAL DBID OBID TO DB/TS

106


107

DATA SET OPEN/CLOSE INFORMATION

153

USER-DEFINED EXCEPT-CONDITION TRACE

3

ALL ACCOUNTING

68

BEGINNING OF A ROLLBACK REQUEST

69

ENDING OF A ROLLBACK REQUEST

70

BEGIN COMMIT PHASE 2 REQUEST

71

END COMMIT PHASE 2 REQUEST 201

®


Class IFCID

3

202

Description

72

BEGINNING OF CREATE THREAD REQUEST

73

ENDING OF A CREATE THREAD REQUEST

74

BEGINNING OF TERM. THREAD REQUEST

75

ENDING OF A TERM. THREAD REQUEST

80

BEGINNING OF AN ESTABLISH EXIT REQ.

81

ENDING OF AN ESTABLISH EXIT REQUEST

82

BEGIN IDENTIFY REQUEST

83

END IDENTIFY REQUEST

84

BEGIN PHASE 1 COMMIT REQUEST

85

END PHASE 1 COMMIT REQUEST

86

BEGINNING OF SIGNON REQUEST

87

ENDING OF SIGNON REQUEST

88

BEGINNING OF A SYNC REQUEST

89

ENDING OF A SYNC REQUEST

106


174


175


22

MINIPLANS GENERATED

53

END OF DESCR., COMMIT, RLBCK OR ERR

55

ISSUANCE OF SET CURRENT SQLID

58

END OF SQL STATEMENT EXECUTION

59

START OF FETCH SQL STATEMENT EXEC.

60

START OF SELECT SQL STATEMENT EXEC.

61

START OF INSERT, UPDATE, DELETE SQL

62

START OF DDL STATEMENT EXECUTION

63

SQL STATEMENT TO BE PARSED

64

START PREPARE SQL STATEMENT EXEC.

65

START OPEN CURSOR STATIC/DYN SQL

66

START CLOSE CURSOR STATIC/DYN SQL

92

START AN ACCESS METHOD SERVICES

95

SORT STARTED

96

SORT ENDED

97

ACCESS METHOD SERVICES CMD COMPL.

106


112

ATTRIBUTES PLAN AFTER THREAD ALLOC.

177

SUCCESSFUL PACKAGE ALLOCATION

233

START/END CALL TO USER ROUTINE ®

DB2 9 for z/OS

®


Class IFCID

4

5

®

DB2 9 for z/OS

Description

237

SET CURRENT DEGREE INFORMATION

272

ASSOCIATE LOCATORS INFORMATION

273

ALLOCATE CURSOR INFORMATION

324

FUNCTION RESOLUTION INFORMATION

325

START/END TRIGGER ACTIVATION

350

COMPLETE SQL STATEMENT

6


7

COMPLETION CODE AFTER READ I/O

8


9


10

BEGINNING OF ASYNC WRITE I/O

29

START EDM I/O REQ. LOAD DBD OR CT

30

END OF EDM I/O REQUEST

105


106


107


127


128


226


227


32


33


34

LOG MANAGER WAIT FOR READ I/O BEGIN

35

LOG MANAGER WAIT FOR READ I/O END

36

LOG MANAGER WAIT FOR NON-I/O BEGIN

37

LOG MANAGER WAIT FOR NON-I/O END

38

LOG MGR WAIT ACT. LOG WRITE BEGIN

39

LOG MGR WAIT ACT. LOG WRITE I/O END

40

LOG MANAGER ARCHIVE WRITE I/O BEGIN

41

LOG MANAGER ARCHIVE WRITE I/O END

104

LOG DATA SET MAPPING

106


114

START ARCHIVE READ I/O WAIT

115

END READ ARCHIVE I/O WAIT ON DASD

116

END READ ARCHIVE I/O WAIT ON TAPE

117

BEGIN ARCHIVE READ

118

END ARCHIVE READ 203

®


Class IFCID

6

7

8

204

Description

119

BSDS WRITE I/O BEGINNING

120

BSDS WRITE I/O END

228

START ARCHIVE ALLOCATION WAIT

229

END ARCHIVE ALLOCATION WAIT

20

LOCKING SUMMARY

44

LOCK SUSPEND OR AN ID. CALL TO IRLM

45

LOCK RESUME

105


106


107


172

UNITS OF WORK INVOLVED IN DEADLOCK

196

LOCK TIMEOUT DETAILS

213

BEGINNING OF WAIT FOR DRAIN LOCK

214

END OF WAIT FOR DRAIN LOCK

218

SUMMARY OF LOCK AVOIDANCE TECHNIQUE

337

LOCK ESCALATION OCCURRED

21

DETAIL LOCK REQ.ON RETURN FROM IRLM

105


106


107


199

BUFFER POOL DATA SET STATISTICS

223

DETAIL OF LOCK AVOIDANCE TECHNIQUE

13

INPUT TO HASH SCAN

14

END OF HASH SCAN

15

INPUT MATCH./NON-MATCH.INDEX SCAN

16

INPUT TO THE FIRST INSERT

17

INPUT TO SEQUENTIAL SCAN

18

END INDEX SCAN, INSERT, SEQ. SCAN

105


106


107


125

RID LIST PROCESSING USAGE

221

PARALLEL DEGREE FOR PARALLEL GROUP

222

PARALLEL GROUP ELAPSED TIME

231

PARALLEL GROUP COMPLETION

305

TABLE CHECK CONSTRAINTS

311

TEMPORARY TABLES ®

DB2 9 for z/OS

®


Class IFCID

Description

9

26

WORK FILE OBTAINED FOR SORT

27

NUMBER OF ORDERED RECORDS SORT RUN

28

DETAILED SORT INFORMATION

95

SORT STARTED

96

SORT ENDED

106


23

UTILITY START INFORMATION

24

UTILITY OBJECT OR PHASE CHANGE

25

UTILITY END INFORMATION

90

COMMAND TEXT OF ENTERED DB2 COMMAND

91

COMPLETION STATUS OF A DB2 COMMAND

105


106


107


108

BEGINNING OF BIND/REBIND

109

END OF BIND/REBIND

110

BEGINNING OF FREE PLAN

111

END OF FREE PLAN

201

STATUS BEF/AFT ALTER BUFFERPOOL

256

ATTRIBUTES BEF/AFT ALTER BUFFERPOOL

46

AGENT BEGIN EXEC. UNIT SWITCH

47

NEW SRB EXECUTION UNIT STARTED

48

NEW SRB EXECUTION UNIT COMPLETED

49

BEGIN NEW TCB

50

END NEW TCB

51

SHARED LATCH RESUME

52

SHARED LATCH WAIT

56

EXCLUSIVE LATCH WAIT

57

EXCLUSIVE LATCH RESUME

93

SUSPEND WAS CALLED

94

EVENT RESUMED

106


113

ATTRIBUTES PLAN AFTER AGENT ALLOC.

98

BEGIN GETMAIN/FREEMAIN (NONPOOL)

99

END GETMAIN/FREEMAIN (NONPOOL)

100

BEGIN GETMAIN/FREEMAIN (POOL)

101

END GETMAIN/FREEMAIN (POOL)

10

11

12

®

DB2 9 for z/OS

205

®


Class IFCID 13

14


11

RESULTS OF A VALIDATION EXIT CALL

12

RESULTS EDIT EXIT CALL ENCODE RECRD

19

RESULTS EDIT EXIT CALL DECODE A ROW

105


106


107


67

START OF ACCOUNTING COLLECTION

106


121

ENTRY ALLOCATING DB2 CONNECTION

122

EXIT ALLOCATING DB2 CONNECTION

15

154

USER-DEFINED ROUTINE COND. PERF.

16

157

DRDS INTER. WITH RDS RDI CALL TYPES

158

DRDS INTER. WITH CONVERSATION MGR

159

DRDS REQUESTING LOCATION DATA

160

REQUESTING AGENT DATA

161

SERVING AGENT DATA

162

DISTRIB TRANS. MGR REQ. AGENT DATA

163

DISTRIB TRANS. MGR RESP. AGENT DATA

167

CONVERSATION ALLOC. REQUEST QUEUED

17

20

21 206

Description

106

183

DRDS RDS/SCC INTERFACE DATA

211

INFORMATION ABOUT CLAIMS

212

INFORMATION ABOUT DRAINS

213

BEGINNING OF WAIT FOR DRAIN LOCK

214

END OF WAIT FOR DRAIN LOCK

215

BEGIN OF WAIT OF CLAIM COUNT TO 0

216

END OF CLAIM COUNT TO GO TO 0

249

EDM POOL DBD INVALIDATION

250

GROUP BUFFER POOL CON/DISCON

251

P-LOCK OPERATIONS

256

ALTER BUFFERPOOL COMMAND

257

DETAILS OF IRLM NOTIFY REQUEST

261

GROUP BUFFER POOL CHECKPOINT

262

GBPOOLT CASTOUT THRESHOLD PROCESSIN

267

BEGIN CF STRUCT REBLD/EXPAND/CONTR

268

END CF STRUCTURE REBLD/EXPAND/CONTR

255

BUFFER REFRESH DUE TO XI ®

DB2 9 for z/OS

®


Class IFCID 259

STATISTICS

1

®

P-LOCK REQUEST/NEGOTIATION REQUEST

263

PAGE SET AND PARTITION CASTOUT DATA

314

AUTHORIZATION EXIT PARAMETERS

327

LANGUAGE ENVIRONMENT RUN-TIME INFO

1

SYSTEM SERVICES

2

DATABASE SERVICES

105


106


202

BUFFER POOL ATTRIBUTES

2

152

USER-DEFINED STATISTICS TRACE

3

172

UNITS OF WORK INVOLVED IN DEADLOCK

196

LOCK TIMEOUT DETAILS

250

CONNECT/DISCONNECT FROM GBP

4

DB2 9 for z/OS

Description

258

DATA SET EXTEND INFORMATION.

330

ACTIVE LOG SHORTAGE

337

LOCK ESCALATION OCCURRED

191

DATA CAPTURE FOR DDIS ERRORS

192

DDM LEVEL 6A HEADER ERRORS

193

UOW DISPOSITION/SQLCODE MISMATCH

194

INVALID SNA FMH-5 RECEIVED

195

FIRST FAILURE DATA CAPTURE FOR DRDS

203

HEURISTIC DECISION OCCURRED

204

PARTNER COLD START DETECTED

205

INCORRECT LOGNAME/SYNC. PARMS

206

SNA COMPARE STATES PROTOCOL ERROR

207

HEURISTIC DAMAGE OCCURRED

208

SNA SYNC POINT PROTOCOL ERROR

209

SYNC POINT COMMUNICATION FAILURE

210

LOG NAME CHANGED ON WARM START

235

CONDITIONAL RESTART DATA LOSS

236

EXCHANGE LOG NAMES PROTOCOL ERROR

238

DB2 RESTART ERROR

267

START OF CF STRUCTURE REBUILD

268

END OF CF STRUCTURE REBUILD

5

230

DATA SHARING GLOBAL STATISTICS

7

326

WLM DELAY MONITOR SUPPORT 207

®


208

®

DB2 9 for z/OS

®


Exceptions Status Code ACHKP

Status Name Auxiliary CHECK Pending

Objects Affected Base table space, LOB table spaces

AUXW

Auxiliary Warning

Base Table Space

LOB Table Space

CHECKP

COPY

CHECK Pending

Copy Pending

DBETE

GRECP

®

GBP Recover Pending

DB2 9 for z/OS

Table space, base table space Partitioning index, nonpartitioning index, index on auxiliary table LOB table space Table space, table space partition Table space, table space partition, index space, index partition, or logical index partition Table space, index space

Corrective Action(s) 1. Update or delete invalid LOB using SQL 2. Run CHECK DATA Utility with the appropriate SCOPE option to verify the validity of LOBs and XML objects and reset status. 1. Update or delete invalid LOBs and XML objects using SQL. 2. If an orphan LOB exists or a version mismatch exists between the base table and the auxiliary index, use REPAIR to delete the LOB from the LOB table space. 3. Run CHECK DATA utility to verify the validity of LOBs and XML objects and reset AUXW status. 1. Update or delete invalid LOBs and XML objects using SQL. 2. If an orphan LOB exists or a version mismatch exists between the base table and the auxiliary index, use REPAIR to delete the LOB from the LOB table space. 3. Run CHECK LOB utility to verify the validity of LOBs and XML objects and reset AUXW status. Check and correct RI constraints using the CHECK DATA utility. 1. Run CHECK INDEX on index. 2. If errors – run REBUILD INDEX utility

Use CHECK LOB utility – if errors: 1. Correct defects found in LOB table space with REPAIR utility 2. Run CHECK LOB again *Take an image copy (best action), or use –START DATABASE (db) SPACENAM(ts) ACCESS FORCE or run REPAIR and reset COPY flag. Contact IBM Software Support to report the problem. DB2 log records need to be analyzed to diagnose the cause of the problem and determine further actions.

RECOVER the object, or use START DATABASE command

209

®

DB2 9 z/OS Reference Guide Status Code ICOPY

Status Name Informational COPY Pending

LPL

Logical Page List

RBDP

REBUILD Pending

RBDP*

PSRBD

RECP

RECOVER Pending

Objects Affected Partitioned Index, nonpartitioned index, Index on auxiliary table NOT LOGGED table spaces Table spaces, index space Physical or logical index partition Logical Partitions of nonpartitioned secondary indexes Nonpartitioned secondary index, index on the auxiliary table

Table space Table space partition Index on the auxiliary table Index Space

Any

210

Corrective Action(s) Copy the affected index

Copy the affected table space. * START DATABASE ACCESS R/W or R/O * Run RECOVER or REBUILD INDEX utility * Run LOAD REPLACE * DROP the object Run the REBUILD or RECOVER utility on the affected index partition Run REBUILD INDEX PART or RECOVER utility on the affected logical partitions

Run REBUILD INDEX ALL, the RECOVER utility, or run REBUILD INDEX The following actions also reset the REBUILD status: * LOAD REPLACE with table space or partition * REPAIR SET INDEX with NORBDPEND on index part – however does not correct inconsistencies . * Start database ACCESS FORCE – however does not correct inconsistencies * Run REORG INDEX SORTDATA on Index Run the RECOVER utility on the affected object Recover the logical partition Run REBUILD INDEX, RECOVER INDEX or REORG SORTDATA Run one of the following utilities on the affected index space: * REBUILD INDEX * RECOVER INDEX * REORG INDEX SORTDATA The following actions also reset the RECOVER status: * LOAD REPLACE with table space or partition * REPAIR SET TABLESPACE or INDEX with NORCVRPEND on index part – however does not correct inconsistencies . * Start database ACCESS FORCE – however does not correct inconsistencies ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Status Code REFP REORP

Status Name Refresh Pending REORG Pending

Objects Affected Tablespace, or Indexspace Tablespace

Partitioned Table Space

AREO*

Advisory REORG status

Table Space

Index Space

RESTP

Restart Pending

WEPR

Write Error Page Range

®

DB2 9 for z/OS

Table space, partitions, index spaces, physical index partitions Page range in error

Corrective Action(s) * Run a LOAD REPLACE * Object will also be in RECP or RBDP status – will need appropriate action taken Perform one of the following: * LOAD REPLACE entire tablespace * REORG TABLESPACE SHRLEVEL NONE * REORG PART n:m SHRLEVEL NONE Rows 32KB 1. Run REORG TABLESPACE UNLOAD ONLY 2. Run LOAD TABLESPACE FORMAT UNLOAD Run one of the following utilities: * REORG TABLESPACE * LOAD REPLACE * REPAIR TABLESPACE Run one of the following utilities: * REORG TABLESPACE * LOAD REPLACE * REORG INDEX * REPAIR INDEX Objects are unavailable until back-out work is complete or until restart is canceled and a conditional restart or cold start is performed.

Run a RECOVER utility on effected data

211

®


Determining Partition From Page Number Use these charts to determine the partition number from a page number displayed in a console message. You first need to know the type of data sets for the table space (EA or non EA-enabled), along with the page size and DSSIZE (if EA-enabled). Use this information to determine how many leading bits of a RID are used to represent the partition number. Convert the hex representation of leading portion of the page number to binary, and then the appropriate number of bits to decimal. Partition numbers begin with zero. EA-Enabled Table Spaces (Defined as LARGE or with DSSIZE) DSSIZE

1GB 1GB 1GB 1GB 2GB 2GB 2GB 2GB 4GB 4GB 4GB 4GB 8GB 8GB 8GB 8GB 16GB 16GB 16GB 16GB 32GB 32GB 32GB 32GB 64GB 64GB 64GB 64GB

Page Leading Example Page Size Bits Number (First 4 used for RID bytes) Part Number X’01000004’ 4KB 14 bits X’01000004’ 8KB 15 bits X’01000004’ 16KB 16 bits X’01000004’ 32KB 17 bits X’01000004’ 4KB 13 bits X’00040040’ 8KB 14 bits X’00040040’ 16KB 15 bits X’00040040’ 32KB 16 bits X’01000004’ 4KB 12 bits X’06000007’ 8KB 13 bits X’007C0005’ 16KB 14 bits X’007C0005’ 32KB 15 bits X’3FFFFFFF’ 4KB 11 bits X’3FFFFFFF’ 8KB 12 bits X’3FFFFFFF’ 16KB 13 bits X’3FFFFFFF’ 32KB 14 bits X’3FFFFFFF’ 4KB 10 bits X’06000007’ 8KB 11 bits X’3FFFFFFF’ 16KB 12 bits X’06000007’ 32KB 13 bits X’06000007’ 4KB 9 bits X’06000007’ 8KB 10 bits X’03F00009’ 16KB 11 bits X’03F00009’ 32KB 12 bits X’FFFFFFFF’ 4KB 8 bits X’FFFFFFFF’ 8KB 9 bits X’FFFFFFFF’ 16KB 10 bits X’FFFFFFFF’ 32KB 11 bits

Example Partition Number Partition Part in Binary Number

B’00000001000000’ B’000000010000000’ B’0000000100000000’ B’00000001000000000’ B’0000000100000’ B’00000000000001’ B’000000000000010’ B’0000000000000100’ B’000000010000’ B’0000011000000’ B’00000000011111’ B’000000000111110’ B’00111111111’ B’001111111111’ B’0011111111111’ B’00111111111111’ B’0011111111’ B’00000110000’ B’001111111111’ B’0000011000000’ B’000001100’ B’0000011000’ B’00000011111’ B’000000111111’ B’11111111’ B’111111111’ B’1111111111’ B’11111111111’

64 128 256 512 32 1 2 4 16 192 31 62 511 1023 2047 4095 255 48 1023 192 12 24 31 63 255 511 1023 2047

65 129 257 513 33 2 3 5 17 193 32 63 512 1024 2048 4096 256 49 1024 193 13 25 32 64 256 512 1024 2048

Non EA-Enabled Table Spaces 212

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Number of Parts

Page RID Size Type

1 to 16 1 to 16 1 to 16 1 to 16 17 to 32 17 to 32 17 to 32 17 to 32 33 to 64 33 to 64 33 to 64 33 to 64 1 to 4096 1 to 4096 1 to 4096 1 to 4096

4KB 8KB 16KB 32KB 4KB 8KB 16KB 32KB 4KB 8KB 16KB 32KB 4KB 8KB 16KB 32KB

®

DB2 9 for z/OS

4 byte 4 byte 4 byte 4 byte 4 byte 4 byte 4 byte 4 byte 4 byte 4 byte 4 byte 4 byte 5 byte 5 byte 5 byte 5 byte

Leading Example Page Bits Number (First 3 used or 4 RID bytes) for Part Number X’000004’ 4 bits X’E80005’ 5 bits X’1E0007’ 6 bits X’1E0007’ 7 bits X’1E0007’ 5 bits X’1E0007’ 6 bits X’010008’ 7 bits X’010008’ 8 bits X’1F8009’ 6 bits X’1F8009’ 7 bits X’1F8009’ 8 bits X’1F8009’ 9 bits 12 bits X’00100004’ 13 bits X’00100004’ 14 bits X’1FFE000B’ 15 bits X’1FFE000B’

Example Partition Number in Binary

Partition Part Number

B’0000’ B’01111’ B’000111’ B’0001111’ B’00011’ B’000111’ B’0000000’ B’00000001’ B’000111’ B’0001111’ B’00011111’ B’000111111’ B’000000000001’ B’0000000000010’ B’00011111111111’ B’000111111111111’

0 15 7 15 3 7 0 1 7 15 31 63 1 2 2047 4095

1 16 8 16 4 8 1 2 8 16 32 64 2 3 2048 4096

213

®


Catalog Tables SYSIBM.IPLIST Allows multiple IP addresses to be specified for a given LOCATION. Insert rows into this table when you want to define a remote DB2 data sharing group. The same value for the IPADDR column cannot appear in both the SYSIBM.IPNAMES table and the SYSIBM.IPLIST table. Rows in this table can be inserted, updated and deleted. Column Name LINKNAME

Data Type VAHCHAR(24)

IPADDR

VARCHAR(254)

IBMREQD

CHAR(1)

Description This column is associated with the value specified in the LINKNAME column in the SYSIBM.LOCATIONS table and the SYSIBM.IPNAMES table. The values of the other columns in the SYSIBM.IPNAMES table apply to the server identified by the LINKNAME column in this row. • This column contains an IPv4 or IPv6 address, or domain name of a remote TCP/IP host of the server. If WLM Domain Name Server workload balancing is used, this column must contain the member specific domain name. If Dynamic VIPA workload balancing is used, this column must contain the member specific Dynamic VIPA address. The IPADDR column must be specified as follows: • An IPv4 address must be left justified and is represented as a dotted decimal address. For example, '123.456.78.912' would be interpreted as an IPv4 address. • An IPv6 address must be left justified and is represented as a colon hexadecimal address. An example of an IPv6 address is 2001:0DB8:0000:0000:0008:0800:200C:417A, which can also be expressed in compressed form as 2001:DB8::8:800:200C:417A. • A domain name is converted to an IP address by the domain name server where a resulting IPv4 or IPv6 address is determined. A value of Y means row came from MRM tape.

SYSIBM.IPNAMES Defines the remote DRDA servers DB2 can access using TCP/IP. Rows in this table can be inserted updated, and deleted. Column Name LINKNAME

Data Type VARCHAR(24)

SECURITY_OUT

CHAR(1)

Description The value specified in this column must match the value specified in the LINKNAME column of the associated row in SYSIBM.LOCATIONS. This column defines the DRDA security option that is used when local DB2 SQL applications connect to any remote server associated with this TCP/IP host: A: The option is “already verified”. Outbound connection

214

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name

Data Type

Description requests contain an authorization ID and no password. The authorization ID used for an outbound request is either the DB2 user ’s authorization ID or a translated ID, depending upon the value of the USERNAMES column. The authorization ID is not encrypted when it is sent to the partner. D: The option is ‘userid and and security-sensitive data encryption’. Outbound connection requests contain an authorization ID and no password. E: The option is ‘userid, password, and security sensitive data encryption’. Outbound connection requests contain an authorization ID and a password. The password is obtained from SYSIBM.SYSUSERNAMES table. The USERNAMES column must specify ‘O’. If the applications connect to any remote server as trusted, the USERNAMES column must specify ‘O’ or ‘S’ R: The option is “RACF PassTicket”. Outbound connection requests contain a userid and a RACF PassTicket. The value specified in the LINKNAME column is used as the RACF PassTicket application name for the remote server. The authorization ID used for an outbound request is either the DB2 user ’s authorization ID or a translated ID, depending upon the value of the USERNAMES column. P: The option is “password”. Outbound connection requests contain an authorization ID and a password. The password is obtained from the SYSIBM.USERNAMES table. The USERNAMES column must specify “O”.

USERNAMES

CHAR(1)

IBMREQD

CHAR(1)

IPADDR

VARCHAR(254)

®

DB2 9 for z/OS

If the applications connect to any remote server as trusted, the USERNAMES column must specify ‘O’ or ‘S’ This column controls outbound authorization ID translation. Outbound translation is performed when an authorization ID is sent by DB2 to a remote server. O: An outbound ID is subject to translation. Rows in the SYSIBM.USERNAMES table are used to perform ID Translation. No translation or “come from” checking is performed on inbound IDs. S: Row in the SYSIBM.USERNAMES table is used to obtain the system AUTHID used to establish a trusted connection. Blank: No translation occurs. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape This column contains the IP address or domain name of a remote TCP/IP host. The IPADDR column must be specified as follows: • An IPv4 address must be left justified and is represented as a dotted decimal address. For example, '123.456.78.91' would be interpreted as an IPv4 address. • An IPv6 address must be left justified and is represented as a colon hexadecimal address. An example of an IPv6 address is 215

®

DB2 9 z/OS Reference Guide Column Name

Data Type

Description 2001:0DB8:0000:0000:0008:0800:200C:417A, which can also be expressed in compressed form as 2001:DB8::8:800:200C:417A. • A domain name is converted to an IP address by the domain name server where a resulting IPv4 or IPv6 address is determined. call. TCP/IP domain names are not case sensitive.

SYSIBM.LOCATIONS Contains a row for every accessible remote server. The row associates a LOCATION name with the TCP/IP or SNA network attributes for the remote server. Requesters are not defined in this table .Rows in this table can be inserted, updated, and deleted. Column Name LOCATION


LINKNAME

VARCHAR(128)

IBMREQD

CHAR(1)

PORT

VARCHAR(96)

Description A unique location name for the accessible server. This is the name by which the remote server is known to local DB2 SQL applications. Identifies the VTAM or TCP/IP attributes associated with this location. For any LINKNAME specified, one or both of the following statements must be true: 1: A row exists in SYSIBM.LUNAMES whose LUNAME matches the value specified in the SYSIBM.LOCATIONS LINKNAME column. This row specifies the VTAM communication attributes for the remote location. 2: A row exists in SYSIBM.IPNAMES whose LINKNAME matches the value specified in the SYSIBM.LOCATIONS LINKNAME column. This row specifies the TCP/IP communication attributes for the remote location. A value of Y indicates that the row came from the basic machinereadable material (MRM) tape. TCP/IP is used for outbound DRDA connections when the following statement is true: A row exists in SYSIBM.IPNAMES, where the LINKNAME column matches the value specified in the SYSIBM.LOCATIONS LINKNAME column.

TPN

216

VARCHAR(192)

If the above-mentioned row is found, the value of the PORT column is interpreted as follows: –If PORT is blank ,the default DRDA port (446)is used. –If PORT is nonblank, the value specified for PORT can take one of two forms: 1: If the value in PORT is left justified with 1-5 numeric characters, the value is assumed to be the TCP/IP port number of the remote database server. 2: Any other value is assumed to be a TCP/IP service name, which can be converted to a TCP/IP port number using the TCP/IP getservbyname socket call. TCP/IP service names are not case sensitive. Used only when the local DB2 begins an SNA conversation with another server. When used, TPN indicates the SNA LU 6.2 transaction program name (TPN) that will allocate the ®

DB2 9 for z/OS

®


Data Type

DBALIAS

VARCHAR(128)

TRUSTED

CHAR(1)

SECURE

CHAR(1)

Description conversation. A length of zero for the column indicates the default TPN. For DRDA conversations, this is the DRDA default, which is X'07F6C4C2'. For DB2 private protocol conversations, this column is not used. For an SQL/DS server, TPN should contain the resource ID of the SQL/DS machine. Database alias. The name associated with the server. This name is used to access a remote database server. If DBALIAS is balnk the location name is used to access the remote database server. This column does not change the name of any database objects send to the remote site that contains the location qualifier. Indicates whether the connection to the remote server can be trusted. This is restricted to TCP/IP only. This column is ignored for connections using SNA. Y Location is trusted. Access to the remote location requires trusted context defined at the remote location. N Location is not trusted. Indicates the use of the Secure Socket Layer (SSL) protocol for outbound DRDA connections when local DB2 applications connects to the remote database server using TCP/IP. Y Indicates a secure connection using SSL is required for the outbound DRDA connection. N Indicates a secure connection is not required for the outbound DRDA connection.

SYSIBM.LULIST Allows multiple LU names to be specified for a given LOCATION. Insert rows into this table when you want to define a remote DB2 data-sharing group. The same value for LUNAME column cannot appear in both the SYSIBM.LUNAMES table and the SYSIBM.LULIST table. Rows in this table can be inserted, updated, and deleted. Column Name LINKNAME


LUNAME

VARCHAR(24)

IBMREQD

CHAR(1)

Description The value of the LINKNAME column in the SYSIBM.LOCATIONS table with which this row is associated. This is also the value of the LUNAME column in the SYSIBM.LUNAMES table. The values of the other columns in the SYSIBM.LUNAMES row apply to the LU identified by the LUNAME column in this row of SYSIBM.LULIST. The VTAM logical unit name (LUNAME) of the remote database system. This LUNAME must not exist in the LUNAME column of SYSIBM.LUNAMES. A value of Y indicates that the row came from the basic machinereadable material (MRM) tape.

SYSIBM.LUMODES Each row of the table provides VTAM with conversation limits for a specific combination of LUNAME and MODENAME. The table is accessed only during the initial conversation limit negotiation between DB2 and a remote LU. This negotiation is called change-number-ofsessions (CNOS) processing. Rows in this table can be inserted, updated, and deleted. ®

DB2 9 for z/OS

217

®

DB2 9 z/OS Reference Guide Column Name LUNAME MODENAME CONVLIMIT

Data Type VARCHAR(24) VARCHAR(24) SMALLINT

IBMREQD

CHAR(1)

Description LU name of the server involved in the CNOS processing. Name of a logon mode description in the VTAM logon mode table. Maximum number of active conversations between the local DB2 and the other system for this mode. Used to override the number in the DSESLIM parameter of the VTAMAPPL definition statement for this mode. A value of Y indicates that the row name from the basic machinereadable material (MRM) tape.

SYSIBM.LUNAMES The table must contain a row for each remote SNA client or server that communicates with DB2. Rows in this table can be inserted, updated, and deleted. Column Name LUNAME


SYSMODENAME

VARCHAR(24)

SECURITY_IN

CHAR(1)

SECURITY_OUT

CHAR(1)

218

Description Name of the LU for one or more accessible systems. A blank string indicates the row applies to clients whose LU name is not specifically defined in this table. All other column values for a given row in this table are for clients and servers associated with the row ’s LU name. Mode used to establish inter-system conversations. A blank indicates the default mode IBMDB2LM (DB2 private protocol access). This column defines the security options that are accepted by this DB2 when an SNA client connects to DB2: V: The option is “verify”. An incoming connection request must include one of the following: a userid and password, a userid and RACF PassTicket, or a Kerberos security ticket. A: The option is “already verified”. A request does not need a password, although a password is checked if it is sent. With this option, an incoming connection request is accepted if it includes any of the following: a userid, a userid and password, a userid and RACF PassTicket, or a Kerberos security ticket. If the USERNAMES column contains 'I'or 'B', RACF is not invoked to validate incoming connection requests that contain only a userid. This column defines the security option that is used when local DB2 SQL applications connect to any remote server associated with this LUNAME: A: The option is “already verified”. Outbound connection requests contain an authorization ID and no password. The authorization ID used for an outbound request is either the DB2 user’s authorization ID or a translated ID, depending upon the value of the USERNAMES column. R: The option is “RACF PassTicket”. Outbound connection requests contain a userid and a RACF PassTicket .The server’s LU name is used as the RACF PassTicket application name. The authorization ID used for an outbound request is either the DB2 user’s authorization ID or a translated ID, depending upon the value of the USERNAMES column. P: The option is “password”. Outbound connection requests contain an authorization ID and a password. The password is ®

DB2 9 for z/OS

®


Data Type

ENCRYPTPSWDS

CHAR(1)

MODESELECT

CHAR(1)

USERNAMES

CHAR(1)

GENERIC

CHAR(1)

IBMREQD

CHAR(1)

Description obtained from the SYSIBM.USERNAMEs table or RACF, depending upon the value specified in the ENCRYPTPWDS column. The USERNAMES column must specify 'B' or 'O'. This column only applies to DB2 for OS/390 partners. It is provided to support connectivity to prior releases of DB2 that are unable to support RACF PassTickets. For connections between DB2 Version 5 and later, using the SECURITY_OUT='R' option instead of the ENCRYPTPSWDS='Y' option is recommended. N: No, passwords are not in internal RACF encrypted format. This is the default. Y: Yes for outbound requests ,the encrypted password is extracted from RACF and sent to the server .For inbound requests ,the password is treated as encrypted. Whether to use the SYBIBM.MODESELECT table: N: Use default modes:IBMDB2LM (for DB2 private protocol) and IBMRDB (for DRDA). Y: Searches SYSIBM.MODESELECT for appropriate mode name. This column controls inbound and outbound authorization ID translation, and “come from” checking. Inbound translation and “come from” checking are performed when an authorization ID is received from a remote client. Outbound translation is performed when an authorization ID is sent by DB2 to a remote server. When I,O,or B is specified in this column, rows in the SYSIBM.USERNAMES table are used to perform ID translation. I An inbound ID is subject to translation and “come from ” checking. No translation is performed on outbound IDs. O No translation or “come from ”checking is performed on inbound IDs. An outbound ID is subject to translation. B An inbound ID is subject to translation and “come from ” checking. An outbound ID is subject to translation. blank No translation occurs. Indicates whether DB2 should use its real LU name or generic LU name to identify itself to the partner LU, which is identified by this row. N The real VTAMLU name of this DB2 subsystem Y The VTAM generic LU name of this DB2 subsystem A value of Y indicates that the row came from the basic machinereadable material (MRM)tape.

SYSIBM.MODESELECT Associates a mode name with any conversation created to support an outgoing SQL request. Each row represents one or more combinations of LUNAME, authorization ID, and application plan name. Rows in this table can be inserted, updated, and deleted. Column Name ®

DB2 9 for z/OS

Data Type

Description 219

®

DB2 9 z/OS Reference Guide Column Name AUTHID


PLANNAME

VARCHAR(24)

LUNAME MODENAME


IBMREQD

CHAR(1)

Description Authorization ID of the SQL request. Blank (the default) indicates that the MODENAME specified for the row is to apply to all authorization IDs. Plan name associated with the SQL request. Blank (the default) indicates that the MODENAME specified for the row is to apply to all plan names. LU name associated with the SQL request. Name of the logon mode in the VTAM logon mode table to be used in support of the outgoing SQL request. If blank, IBMDB2LM is used for DB2 private protocol connections and IBMRDB is used for DRDA connections. Whether the row came from the basic machine-readable material (MRM) tape: N=No; Y=Yes

SYSIBM.SYSAUXRELS Contains one row for each auxiliary table created for a LOB column. A base tablespace that is partitioned must have one auxiliary table for each partition of each LOB column. Column Name TBOWNER TBNAME COLNAME PARTITION

Data Type VARCHAR(128) VARCHAR(128) VARCHAR(128) SMALLINT

AUXTBOWNER AUXTBNAME AUXRELOBID

VARCHAR(128) VARCHAR(128) INTEGER

IBMREQD

CHAR(1)

RELCREATED

CHAR(1)

Description Schema of the base table. Name of the base table. Name of the LOB column in the base table. Partition number if the base tablespace is partitioned. Otherwise, the value is 0. Schema of the owner of the auxiliary table. Name of the auxiliary table. Internal identifier of the relationship between the base table and the auxiliary table. Whether the row came from the basic machine-readable material (MRM) tape: N=No; Y=Yes The release of DB2 that is used to create the object. Blank if created prior to Version 9.

SYSIBM.SYSCHECKDEP Contains one row for each reference to a column in a table check constraint. Column Name TBOWNER


TBNAME CHECKNAME COLNAME IBMREQD

VARCHAR(128) VARCHAR(128) VARCHAR(128) CHAR(1)

Description Schema of the owner oft he table on which the table check constraint is defined. Name of the table on which the check constraint is defined. Name of the check constraint. Name of the column that the table check constraint refers to. Whether the row came from the basic machine-readable material (MRM) tape: N=No; Y=Yes

SYSIBM.SYSCHECKS Contains one row for each table check constraint. Column Name TBOWNER 220


Description Schema of the owner of the table on which the table check ®

DB2 9 for z/OS

®


Data Type

CREATOR DBID

VARCHAR(128) SMALLINT

OBID TIMESTAMP RBA IBMREQD

SMALLINT TIMESTAMP CHAR(6) CHAR(1)

TBNAME CHECKNAME CHECKCONDITION RELCREATED


Description constraint is defined. Authorization ID of the creator of the table check constraint. Internal identifier of the database for the table check constraint. Internal identifier of the table check constraint. Time when the table check constraint was created. The log RBA when the table check constraint was created. Whether the row came from the basic machine-readable material (MRM) tape: N =No, Y=Yes Name of the table on which the check constraint is defined. Table check constraint name. Text of the table check constraint. The release of DB2 that is used to create the object. Blank if created prior to Version 9.

SYSIBM.SYSCHECKS2 Contains one row for each table check constraint. Column Name TBOWNER


TBNAME CHECKNAME PATHSCHEMAS

VARCHAR(128) VARCHAR(128) VARCHAR(2048)

IBMREQD

CHAR(1)

RELCREATED

CHAR(1)

Description Schema of the owner of the table on which the table check constraint is defined. Name of the table on which the check constraint is defined. Table check constraint name. SQL path at the time the table check constraint was created. The path is used to resolve unqualified cast function names that are used in the constraint definition. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. The release of DB2 that is used to create the object. Blank if created prior to Version 9.

SYSIBM.SYSCOLAUTH Records the UPDATE or REFERENCES privileges that are held by users on individual columns of a table or view. Column Name GRANTOR


GRANTEE

VARCHAR(128)

GRANTEETYPE

CHAR(1)

CREATOR

VARCHAR(128)

®

DB2 9 for z/OS

Description Authorization ID of the user who granted the privileges. Could also be PUBLIC or PUBLIC followed by an asterisk. Authorization ID of the user who holds the privilege or the name of an application plan or package that uses the privilege. PUBLIC for a grant to PUBLIC. PUBLIC followed by an asterisk for a grant to PUBLIC AT ALL LOCATIONS. Type of grantee: Blank: An authorization ID L: Role P: An application plan or a package. The grantee is a package if COLLID is not blank. Schema of the owner of the table or view on which the update privilege is held. 221

®

DB2 9 z/OS Reference Guide Column Name TNAME DATEGRANTED

Data Type VARCHAR(18) CHAR(12) CHAR(6)

Description Name of the table or view. Internal use only. Date the privilege was granted, in the form yymmdd.

TIMEGRANTED COLNAME IBMREQD

CHAR(8) VARCHAR(128) CHAR(1)

Time the privilege was granted, in the form hhmmssth. Name of the column to which the UPDATE privilege applies. Whether the row came from the basic machine-readable material (MRM) tape: N=No; Y=Yes.

COLLID

CHAR(18)

CONTOKEN

CHAR(8)

PRIVILEGE

CHAR(1)

GRANTEDTS GRANTORTYPE

TIMESTAMP CHAR(1)

If GRANTEE is a package, its collection name. Otherwise, the value is blank. If GRANTEE is a package, the consistency token of the DBRM from which the package was derived. Otherwise, the value is blank. Indicates which privilege this row describes: R Row pertains to the REFERENCES privilege. Blank Row pertains to the UPDATE privilege. Time when the GRANT statement was executed. Indicates the type of grantor L Role Blank Authoriation ID that is not a role

SYSIBM.SYSCOLDIST Contains one or more rows for the first key column of an index key. Rows in this table can be inserted, updated, and deleted. Column Name STATSTIME

Data Type SMALLINT TIMESTAMP

Description Not used If RUNSTATS updated the statistics, the date and time when the last invocation of RUNSTATS updated the statistics.

IBMREQD

CHAR(1)

TBOWNER

VARCHAR(128)

Whether the row came from the basic machine-readable material (MRM) tape: N=No; Y=Yes Schema of the owner of the table that contains the column.

TBNAME

VARCHAR(128)

Name of the table that contains the column.

NAME

VARCHAR(128)

COLVALUE

VARCHAR(2000)

TYPE

CHAR(1)

CARDF

FLOAT

Name of the column. If NUMCOLUMNS is greater than 1 this name identifies the first column name of the set of columns associated with the statistics. Contains the data of a frequently occurring value. FOR BIT DATA the value has a non-character data type, the data might not be printable. The type of statistics gathered: C Cardinality F Frequent value H Histogram Statistics N Nonpadded frequent value For TYPE='C', the number of distinct values for the column group. For TYPE='H', the number of distinct values for the column group in a quantile indicated by QUANTILENO.

222

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name COLGROUPCOLNO


NUMCOLUMNS

SMALLINT

FREQUENCYF

FLOAT

QUANTILENO

SMALLINT

LOWVALUE

VARCHAR(2000)

HIGHVALUE

VARCHAR(2000)

Description Identifies the set of columns associated with the statistics. If the statistics are only associated with a single column, the field contains a zero length. Otherwise, the field is an array of SMALLINT column numbers with a dimension equal to the value in NUMCOLUMNS. This is an updatable column. Identifies the number of columns associated with the statistics. Gives the percentage of rows in the table with the value specified in COLVALUE when the number is multiplied by 100. For example, a value of 1 indicates 100%. A value of .153 indicates 15.3%. When TYPE=’H’, this is the percentage of rows in table which falls in the quantile indicated by QUANTILENO whose range is limited by [LOWVALUE, HIGHVALUE]. Statistics are not collected for an index on a ROWID column. Ordinary sequence number of a quantile in the whole consecutive value range, from low to high. This column is not updatable. For TYPE=’H’, this is the lower bound for the quantile indicated by QUANTILENO. Not used if TYPE is not ’H’. This column is not updatable. For TYPE=’H’ this is the higher bound for the quantile indicated by QUANTILENO. Not used if TYPE is not ’H’. This column is not updatable.

SYSIBM.SYSCOLDIST_HIST Contains rows from SYSCOLDIST. Whenever rows are added or changed in SYSCOLDIST, the rows are also written to the new history table. Rows in this table can be inserted, updated, and deleted. Column Name STATSTIME

Data Type TIMESTAMP

TBOWNER TBNAME NAME

VARCHAR(128) VARCHAR(128) VARCHAR(128)

COLVALUE

VARCHAR(2000)

TYPE

CHAR(1)

®

DB2 9 for z/OS

Description If RUNSTATS updated the statistics, the date and time when the last invocation of RUNSTATS updated the statistics. Schema of the owner of the table that contains the column. Name of the table that contains the column. Name of the column .If NUMCOLUMNS is greater than 1, this name identifies the first column name of the set of columns associated with the statistics. Contains the data of a frequently occurring value. Statistics are not collected for an index on a ROWID column. If the value has a non-character data type, the data might not be printable. The type of statistics gathered: C Cardinality F Frequent value H Histogram Statistics N Nonpadded frequent value

223

®

DB2 9 z/OS Reference Guide Column Name CARDF

Data Type FLOAT(8)

COLGROUPCOLNO

VARCHAR(254)

NUMCOLUMNS

SMALLINT

FREQUENCYF

FLOAT(8)

IBMREQD

CHAR(1)

QUANTILENO

SMALLINT

LOWVALUE

VARCHAR(2000)

HIGHVALUE

VARCHAR(2000)

Description When TYPE='C', this is the number of distinct values for the column group. When TYPE='H', this is he number of distinct values for the column group in a quantile indicated by QUANTILENO. The value is -1 if statistics have not been gathered. Identifies the set of columns associated with the statistics. If the statistics are only associated with a single column, the field contains a zero length. Otherwise, the field is an array of SMALLINT column numbers with a dimension equal to the value in NUMCOLUMNS. Identifies the number of columns associated with the statistics. Gives the percentage of rows in the table with the value specified in COLVALUE when the number is multiplied by 100. For example, a value of 1 indicates 100%. A value of .153 indicates 15.3%. When TYPE=’H’, this is the percentage of rows in table which falls in the quantile indicated by QUANTILENO whose range is limited by [LOWVALUE, HIGHVALUE]. Statistics are not collected for an index on a ROWID column. The value is -1 if statistics have not been gathered. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. Ordinary sequence number of a quantile in the whole consecutive value range, from low to high. This column is not updatable. For TYPE=’H’, this is the lower bound for the quantile indicated by QUANTILENO. Not used if TYPE is not ’H’. This column is not updatable. For TYPE=’H’ this is the higher bound for the quantile indicated by QUANTILENO. Not used if TYPE is not ’H’. This column is not updatable.

SYSIBM.SYSCOLDISTSTATS Contains zero or more rows per partition for the first key column of a partitioning index. Rows are inserted when RUNSTATS scans index partitions of the partitioning index. No row is inserted if the index is a non-partitioning index. Rows in this table can be inserted, updated, and deleted. Column Name STATSTIME

Data Type SMALLINT TIMESTAMP

IBMREQD

CHAR(1)

PARTITION

SMALLINT

TBOWNER

VARCHAR(128)

224

Description Not used If RUNSTATS updated the statistics, the date and time when the last invocation of RUNSTATS updated the statistics. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Partition number for the tablespace that contains the table in which the column is defined. Schema of the owner of the table that contains the column. ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name TBNAME NAME

Data Type VARCHAR(128) VARCHAR(128)

Description Name of the table that contains the column. Name of the column. If NUMCOLUMNS is greater than 1, this name identifies the first column name of the set of columns associated with the statistics.

COLVALUE

VARCHAR(2000)

TYPE

CHAR(1)

CARDF

FLOAT

COLGROUPCOLNO

VARCHAR(254)

NUMCOLUMNS

SMALLINT

FREQUENCYF

FLOAT

QUANTILENO

SMALLINT

LOWVALUE

VARCHAR(2000)

HIGHVALUE

VARCHAR(2000)

Contains the data of a frequently occurring value. FOR BIT DATA the value has a non-character data type, the data may not be printable. The type of statistics gathered: C Cardinality F Frequent value H Historgram statistics N Non-padded frequent value If TYPE is C, the value is the number of distinct values for the column group. If TYPE is N or TYPE is F, the value is the number of rows or keys in the partition for which the FREQUENCYF value applies. If TYPE is H, the number of distinct values for the column group in a quantile indicated by QUANTILENO. Identifies the set of columns associated with the statistics. If the statistics are only associated with a single column, the field contains a zero length. Otherwise, the field is an array of SMALLINT column numbers with a dimension equal to the value in NUMCOLUMNS. This is an updatable column. Identifies the number of columns associated with the statistics. Gives the percentage of rows in the table with the value specified in COLVALUE when the number is multiplied by 100. For example, a value of 1 indicates 100%. A value of .153 indicates 15.3%. When TYPE=’H’, this is the percentage of rows in table which falls in the quantile indicated by QUANTILENO whose range is limited by [LOWVALUE, HIGHVALUE]. Statistics are not collected for an index on a ROWID column. Ordinary sequence number of a quantile in the whole consecutive value range, from low to high. This column is not updatable. For TYPE=’H’, this is the lower bound for the quantile indicated by QUANTILENO. Not used if TYPE is not ’H’. This column is not updatable. For TYPE=’H’ this is the higher bound for the quantile indicated by QUANTILENO. Not used if TYPE is not ’H’. This column is not updatable.

SYSIBM.SYSCOLSTATS Contains partition statistics for selected columns. For each column, a row exists for each partition in the table. Rows are inserted when RUNSTATS collects either indexed column statistics or non-indexed column statistics for a partitioned tablespace. No row is inserted if the tablespace is non-partitioned. Rows in this table can be inserted, updated, and deleted.

®

DB2 9 for z/OS

225

®

DB2 9 z/OS Reference Guide Column Name HIGHKEY


HIGH2KEY

VARCHAR(2000)

LOWKEY

VARCHAR(2000)

LOW2KEY

VARCHAR(2000)

STATSTIME

INTEGER TIMESTAMP

IBMREQD

CHAR(1)

PARTITION

SMALLINT

TBOWNER TBNAME NAME COLCARDDATA STATS_FORMAT

VARCHAR(128) VARCHAR(128) VARCHAR(128) VARCHAR(1000) CHAR(1)

Description Highest value of the column within the partition. Blank if statistics have not been gathered or the column is an indicator column, a node ID column, or a column of an XML table. If the column has a non-character data type, the data might not be printable. If the partition is empty, the value is a string of length 0. Second highest value of the column within the partition. Blank if statistics have not been gathered or the column is an indicator column, a node ID column, or a column of an XML table. If the column has a non-character data type, the data might not be printable. If the partition is empty, the value is a string of length 0. Lowest value of the column within the partition. Blank if statistics have not been gathered or the column is an indicator column, a node ID column, or a column of an XML table. If the column has a non-character data type, the data might not be printable. If the partition is empty, the value is a string of length 0. Second lowest value of the column within the partition. Blank if statistics have not been gathered or the column is an indicator column, a node ID column, or a column of an XML table. If the column has a non-character data type, the data might not be printable. If the partition is empty, the value is a string of length 0. Number of distinct column values in the partition. If RUNSTATS updated the statistics, the date and time when the last invocation of RUNSTATS updated the statistics. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Partition number for the tablespace that contains the table in which the column is defined. Schema of the owner of the table that contains the column. Name of the table that contains the column. Name of the column. Internal use only. The type of statistics gathered: Blank Statistics have not been collected or varchar column statistical values are padded N Varchar column statistical values are not padded This is an updatable column

SYSIBM.SYSCOLUMNS Contains one row for every column of each table and view. Column Name NAME TBNAME TBCREATOR

Data Type VARCHAR(128) VARCHAR(128) VARCHAR(128)

COLNO

SMALLINT

COLTYPE

CHAR(8)

226

Description Name of the column. Name of the table or view that contains the column. Schema of the owner of the table or view that contains the column. Numeric place of the column in the table or view; for example 4 (out of 10). An additional row with column number 0 is inserted into SYSCOLUMNS if the definition of the table is incomplete (all required unique indexes have not been created). The type of the column specified in the definition of the column: INTEGER Large integer SMALLINT Small integer ®

DB2 9 for z/OS

®


LENGTH

®

DB2 9 for z/OS

Data Type

SMALLINT

Description FLOAT CHAR VARCHAR LONGVAR DECIMAL GRAPHIC VARGRAPHIC LONGVARG DATE TIME TIMESTMP BLOB CLOB DBCLOB ROWID DISTINCT XML BIGINT BINARY VARBIN DECFLOAT

Floating-point Fixed-length character string Varying-length character string Varying-length character string (prior to V9) Decimal Fixed-length graphic string Varying-length graphic string Varying-length graphic string (prior to V9) Date Time Timestamp Binary large object Character large object Double Byte Character Large Objects ROWID Data Type Distinct Type XML data type Big integer Fixed-length binary string Varying-length binary string Decimal floating point

Whether a column described as VARCHAR, LONGVAR, CLOB, VARG, LONGVAR, DBCLOB, or BLOB is a long string column depends on its length attribute. A column described as BLOB, CLOB, or DBCLOB is always a long string column. Length attribute of the column or, in the case of a decimal column, its precision. The number does not include the internal prefixes that are used to record the actual length and null state, where applicable. INTEGER 4 SMALLINT 2 FLOAT 4 or 8 CHAR Length of string VARCHAR Maximum length of string LONGVAR Maximum length of string (prior to V9) DECIMAL Precision of number GRAPHIC Number of DBCS characters VARGRAPHIC Maximum number of DBCS char.(prior to V9) LONGVARG Maximum number of DBCS characters DATE 4 TIME 3 TIMESTMP 10 BLOB 4 – The length of the field that is stored in the base table. The maximum length of the LOB column is found in LENGTH2 CLOB 4 – The length of the field that is stored in the base table. The maximum length of the CLOB column is found in LENGTH2 DBCLOB 4 – The length of the field that is stored in the base table. The maximum length of the CLOB column is found in LENGTH2 ROWID 17 – The maximum length of the stored portion 227

®


Data Type

SCALE NULLS

SMALLINT CHAR(1)

HIGH2KEY

INTEGER VARCHAR(2000)

LOW2KEY

VARCHAR(2000)

UPDATES

CHAR(1)

IBMREQD

CHAR(1)

REMARKS

VARCHAR(762)

DEFAULT

CHAR(1)

Description of the identifier DISTINCT The length of the source data type XML 6 BIGINT 8 BINARY Length of String VARBIN Maximum length of string DECFLOAT 8 or 16 Scale of decimal data. Zero if not a decimal column. Whether the column can contain null values: N = No Y = Yes The value can be N for a view column that is derived from an expression or a function. Nevertheless, such a column allows nulls when an outer select list refers to it. Not used Second highest value of the column. Blank if statistics have not been gathered, or the column is an indicator column or a column of an auxiliary table. If the column has a non-character data type, the data might not be printable. If the table is empty, the value is a string of length 0. This is an updatable column. Second lowest value of the column. Blank if statistics have not been gathered, or the column is an indicator column or a column of an auxiliary table. If the column has a non-character data type, the data might not be printable. If the table is empty, the value is a string of length 0. This is an updatable column. Whether the column can be updated: N = No Y = Yes The value is N if the column is: * Derived from a function or expression. * A column that is defined with the AS IDENTITY and GENERATED ALWAYS attributes. The value can be Y for columns of a read-only view. Whether the row came from the basic machine-readable material (MRM) tape: N=No ,Y=Yes A character string provided by the user with the COMMENT ON statement. The contents of this column are meaningful only if the TYPE column for the associated SYSTABLES row indicates that this is for a table(T) or a created temporary table (G). Default indicator: A The column has a row ID data type (COLTYPE=’ROWID’) and the GENERATED ALWAYS attribute B The column has a default value that depends on the data type of the column. Data Type Default Value Numeric 0 Fixed-length char/graphic string Blanks Fixed-length binary string Hexidecimal Varying-length string A string length of 0 Date The current date Time The current time

228

®

DB2 9 for z/OS

®


Data Type

Description Timestamp The current timestamp D The column has a row ID data type (COLTYPE=’ROWID’ and the GENERATED BY DEFAULT attribute. E The column is defined with the FOR EACH ROW ON UPDATE and GENERATED ALWAYS attributes. F The column is defined with the FOR EACH ROW ON UPDATE and GENERATED BY DEFAULT attributes. I The column is defined with the AS IDENTITY and GENERATED ALWAYS attributes. J The column is defined with the AS IDENTITY and GENERATED BY DEFAULT attributes. K The column is defined for the implicit DOCID column for a base table that contains XML data. L The column is defined with the AS SECURITY LABEL attribute N The column has no default value. S The column has a default value that is the value of the SQL authorization ID of the process at the time a default value is used. U The column has a default value that is the value of the SESSION_USER special register at the time a default value is used. Y If the NULLS column is Y, the column has a default value of null. If the NULLS column is N, the default value depends on the data type of the column. Data Type Default Value Numeric 0 Fixed-length char string Blanks Fixed length graphic Blanks Fixed length binary Hexadecimal Varying-length string A string length of 0 Date The current date Time The current time Timestamp The current timestamp 1 The column has a default value that is the string constant found in the DEFAULTVALUE column of this table row. 2 The column has a default value that is the floating-point constant found in the DEFAULTVALUE column of this table row. 3 The column has a default value that is the decimal constant found in the DEFAULTVALUE column of this table row. 4 The column has a default value that is the integer constant found in the DEFAULTVALUE column of this table row. 5 The column has a default value that is the hexadecimal character string found in the DEFAULTVALUE column of this table row. 6 The column has a default value that is the UX string found in the DEFAULTVALUE column of this table row. 7 The column has a graphic data type and has a default value that is the character string constant found in the

®

DB2 9 for z/OS

229

®


Data Type

KEYSEQ

SMALLINT

FOREIGNKEY

CHAR(1)

FLDPROC

CHAR(1)

LABEL

VARCHAR(90)

STATSTIME

TIMESTAMP

DEFAULTVALUE

VARCHAR(1536)

230

Description DEFAULTVALUE column of this table row. 8 The column has a character data type and has a default value that is the graphic string constant found in the DEFAULTVALUE column of this table row. 9 The column has a default value that is the DECFLOAT constant found in the DEFAULTVALUE column of this table row. The column's numeric position within the table's primary key. The value is 0 if it is not part of a primary key. Applies to character columns only, where it indicates the subtype of the data. A value of B indicates BIT data, and if value of the field MIXED DATA on installation panel DSNTIPF is: * NO, any other value indicates SBCS data * YES, an S indicates SBCS and any other value indicates MIXED. For views defined prior to V7, subtype information is not available and the default (MIXED or SBCS) is used. This is an updatable column. Whether the column has a field procedure: N No Y Yes Blank The column is for a view defined prior to V7. Views defined after V7 contain Y or N. The column label provided by the user with a LABEL ON Statement; otherwise it is an empty string. If RUNSTATS updated the statistics, the date and time when The last invocation of RUNSTATS updated the statistics. This field is meaningful only if the column being described is for a table (the TYPE column of the associated SYSTABLES row is T for table or G for created temporary table). When the DEFAULT column is 1, 2, 3, 4, 5, 6, 7, 8, or 9, this field contains the default value of the column. If the default value is a string constant or a hexadecimal constant (DEFAULT is 1, 5, 6, 7, or 8 respectively), the value is stored without delimiters. If the default value is a numeric constant (DEFAULT is 2, 3, 4, or 9), the value is stored as specified by the user, including sign and decimal point representation, or special constant values, as appropriate for the constant. When the DEFAULT column is S or U and the default value was specified when a new column was defined with the ALTER TABLE statement, this field contains the value of the CURRENT SQLID or SESSION_USER special register at the time the ALTER TABLE statement was executed. Remember that this default value applies only to rows that existed before the ALTER TABLE statement was executed. When the DEFAULT column is L and the column was added as a new column with the ALTER TABLE statement, this field contains the security label of the user at the time the ALTER TABLE statement was executed. Remember that this default value applies only to rows that existed before the ALTER TABLE statement was executed. ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name COLCARDF

Data Type FLOAT

COLSTATUS

CHAR(1)

LENGTH2

INTEGER

DATATYPEID

INTEGER

SOURCETYPEID

INTEGER

For a built-in data type, 0. For a distinct type, the internal ID of the built-in data type upon which the distinct type is sourced.

TYPESCHEMA

VARCHAR(128)

If COLTYPE is 'DISTINCT', the schema of the distinct type. Otherwise, the value is 'SYSIBM'.

TYPENAME

VARCHAR(128)

CREATEDTS

TIMESTAMP

STATS_FORMAT

CHAR(1)

PARTKEY_ COLSEQ

SMALLINT

If COLTYPE is 'DISTINCT', the name of the distinct type. Otherwise, the value is the same as the value of the COLTYPE column. TYPENAME is set only for columns created in V6 or later. The value for columns created earlier is not filled in. Timestamp when the column was created. The value is '0001-01-01.00.00.00.000000' if the column was created prior to migration to Version 6. Type of statistics gathered: Blank Statistics have not been collected or varchar column statistical columns are padded N Varchar column statistical values are padded This is an updateable column The columns numeric position within the tables partitioning key. The value is 0 if it is not part of the partitioning key.

PARTKEY_ ORDERING

CHAR(1)

ALTERDTS

TIMESTAMP

CCSID

INTEGER

CCSID of the column. 0 if the object was created prior to V8 or is not a string column

HIDDEN

INTEGER

RELCREATED

CHAR(1)

Indicates whether the column is hidden. P Partically hidden N Not hidden Blank Not hidden The release of DB2 that is used to create the object.

®

DB2 9 for z/OS

Description Estimated number of distinct values in the column. For an indicator column, this is the number of LOBs that are not null and have a length greater than zero. The value is -1 if statistics have not been gathered. The value is -2 for the first column of an index of an auxiliary table. This is an updatable column. Indicates the status of the definition of a column: I The definition is incomplete because a LOB table space, auxiliary table, or index on an auxiliary table has not been created for the column. Blank The definition is complete. Maximum length of the data retrieved from the column. Possible values are: 0 Not a LOB or ROWID column 40 For a ROWID column, the length of the returned value 1 to 2 147 483 647 bytes For a LOB column, the maximum length For a built-in data type, the internal ID of the built-in type. For a distinct type, the internal ID of the distinct type.

Order of the column in the partitioning key A Ascending D Descending Blank Column is not used as part of a partitioning key Timestamp when the alter occurred.

231

®


SYSIBM.SYSCOLUMNS_HIST Contains rows from SYSCOLUMNS. Whenever rows are added or changed in SYSCOLUMNS, the rows are also written to the new history table. Rows in this table can be inserted, updated, and deleted. Column Name NAME TBNAME TBCREATOR


COLNO

SMALLINT

COLTYPE

CHAR(8)

LENGTH

232

SMALLINT

Description Name of the column. Name of the table or view that contains the column. Schema of the owner of the table or view that contains the column. Numeric place of the column in the table or view; for example 4 (out of 10). The type of the column specified in the definition of the column: INTEGER Large integer SMALLINT Small integer FLOAT Floating-point CHAR Fixed-length character string VARCHAR Varying-length character string LONGVAR Varying-length character string (prior to V9) DECIMAL Decimal GRAPHIC Fixed-length graphic string VARGRAPHIC Varying-length graphic string LONGVARG Varying-length graphic string (prior to V9) DATE Date TIME Time TIMESTMP Timestamp BLOB Binary large object CLOB Character large object DBCLOB Double Byte Character Large Objects ROWID ROWID Data Type DISTINCT Distinct Type XML XML data type BIGINT Big integer BINARY Fixed-length binary string VARBIN Varying-length binary string DECFLOAT Decimal floating point Whether a column described as VARCHAR, LONGVAR, CLOB, VARG, LONGVAR, DBCLOB, or BLOB is a long string column depends on its length attribute. Length attribute of the column or, in the case of a decimal column, its precision. The number does not include the internal prefixes that are used to record the actual length and null state, where applicable. INTEGER 4 SMALLINT 2 FLOAT 4 or 8 CHAR Length of string VARCHAR Maximum length of string LONGVAR Maximum length of string DECIMAL Precision of number GRAPHIC Number of DBCS characters VARG Maximum number of DBCS characters ®

DB2 9 for z/OS

®


Data Type

LENGTH2

INTEGER

NULLS

CHAR(1)

HIGH2KEY

VARCHAR (2000)

LOW2KEY

VARCHAR (2000)

STATSTIME

TIMESTAMP

COLCARDF

FLOAT

IBMREQD

CHAR(1)

STATS_FORMAT

CHAR(1)

®

DB2 9 for z/OS

Description LONGVARG DATE TIME TIMESTMP BLOB

Maximum number of DBCS characters 4 3 10 4 – The length of the field that is stored in the base table. The maximum length of the LOB column is found in LENGTH2 CLOB 4 – The length of the field that is stored in the base table. The maximum length of the CLOB column is found in LENGTH2 DBCLOB 4 – The length of the field that is stored in the base table. The maximum length of the CLOB column is found in LENGTH2 ROWID 17 – The maximum length of the stored portion of the identifier. DISTINCT The length of the source data type XML 6 BIGINT 8 BINARY Length of String VARBIN Maximum length of string DECFLOAT 8 or 16 Maximum length of the data retrieved from the column. Possible values are: 0 Not a LOB or ROWID column 40 For a ROWID column, the length of the returned value 2 to 2 147 483 647 bytes For a LOB column, the maximum length. Whether the column can contain null values: N=No Y=Yes Second highest value of the column. Blank if statistics have not been gathered, or the column is an indicator column or a column of an auxiliary table. If the column has a non-character data type, the data might not be printable. Second lowest value of the column. Blank if statistics have not been gathered, or the column is an indicator column or a column of an auxiliary table. If the column has a non-character data type, the data might not be printable. If RUNSTATS updated the statistics, the date and time when the last invocation of RUNSTATS updated the statistics. Estimated number of distinct values in the column. For an indicator column, this is the number of LOBs that are not null and have a length greater than zero. The value is -1 if statistics have not been gathered. The value is -2 for the first column of an index of an auxiliary table. Whether the row came from the basic machine-readable material (MRM) tape: N=No ,Y=Yes The type of statistics gathered: Blank Statistics have not been collected or varchar column statistical values are padded N Varchar column statistical values are not padded This is an updatable column 233

®


SYSIBM.SYSCONSTDEP Records dependencies on check constraints or user-defined defaults for a column. Column Name BNAME BSCHEMA BTYPE

Data Type VARCHAR(128) VARCHAR(128) CHAR(1)

DTBNAME DTBCREATOR

VARCHAR(128) CHAR(8)

DCONSTNAME

VARCHAR(128)

DTYPE

CHAR(1)

IBMREQD

CHAR(1)

DTBOWNER

VARCHAR(128)

OWNERTYPE

CHAR(1)

Description Name of the object on which the dependency exists. Schema of the object on which the dependency exists. Type of object on which the dependency exists: F=Function instance Name of the table to which the dependency applies. Schema of the owner of the table to which the dependency applies. If DTYPE = 'C', the unqualified name of the check constraint. If DTYPE = 'D', a column name. Type of object: C Check constraint D User-defined default constant Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Authorization ID of the owner of the table or a zero length string for tables that were created in a DB2 release prior to Version 9. Indicates the type of owner: blank Authorization ID R Role

SYSIBM.SYSCONTEXT The SYSIBM.SYSCONTEXT table contains one row for each trusted context. Column name NAME CONTEXTID DEFINER DEFINERTYPE

Data Type VARCHAR(128) INTEGER VARCHAR(128) CHAR(1)

SYSTEMAUTHID

VARCHAR(128)

DEFAULTROLE OBJECTOWNERTYPE


234

Description Name of the trusted context. Internal context ID. Authorization ID or role that defined the trusted context. The type of the definer: L Role blank Authorization ID The DB2 primary authorization ID that is used to establish the connection. For remote requests, SYSTEMAUTHID is derived from the system user ID that is provided by an external entity, such as a middleware server. For local requests, SYSTEMAUTHID depends on one of the following sources of the address space: BATCH USER parameter on JOB statement RRSAF USER parameter on JOB statement or RACF user TSO TSO logon ID Name of the trusted context default role. Specification of ROLE AS OBJECT OWNER on the trusted context L ROLE AS OBJECT OWNER is specified. A role owns any object created in the trusted context. blank ROLE AS OBJECT OWNER not specified. An ®

DB2 9 for z/OS

®


CREATEDTS ALTEREDTS ENABLED

TIMESTAMP TIMESTAMP CHAR(1)

ALLOWPUBLIC

CHAR(1)

AUTHENTICATEPUBLIC

CHAR(1)

RELCREATED IBMREQD

CHAR(1) CHAR(1)

REMARKS

VARCHAR(762)

DEFAULTSECURITYLABEL

VARCHAR(24)

authorization ID owns any object created in the trusted context. The time when the trusted context is created. The time when the trusted context is last altered. The status of the trusted context: Y Enabled N Disabled Whether the connection is allowed to be reused for PUBLIC: Y Connection reuse is allowed N Connection reuse is not allowed Whether authentication is required for PUBLIC when ALLOWPUBLIC is Y: Y Authentication token is required for PUBLIC.For local requests, the token is the password. For remote requests, the token can be a password, a RACF passticket, or a KERBEROS token N Authentication is not required The release of DB2 that is used to create the object. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. A character string that is provided using the COMMENT statement. Name of the context default RACF security label.

SYSIBM.SYSCONTEXTAUTHIDS The SYSIBM.SYSCONTEXTAUTHIDS table contains one row for each authorization ID with which the trusted context can be used. Column name CONTEXTID AUTHID

Data type INTEGER VARCHAR(128)

AUTHENTICATE

CHAR(1)

ROLE

VARCHAR(128)

CREATEDTS

TIMESTAMP

IBMREQD

CHAR(1)

SECURITYLABEL

VARCHAR(24)

®

DB2 9 for z/OS

Description The internal trusted context ID. The primary authorization ID that can reuse a connection in the identified trusted context. Whether authentication is required for the authorization ID in the AUTHID column: Y Authentication token is required for the authorization ID. For local requests, the token is the password. For remote requests, the token can be a password, a RACF passticket, or a KERBEROS token N Authentication is not required The role for the authorization ID in the AUTHID column. The role supersedes the default role that is defined for the trusted context. The time when the authorization ID is added to the trusted context. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. RACF security label for AUTHID. The security label supersedes the default security label, if any, that is 235

®

DB2 9 z/OS Reference Guide defined for the context.

SYSIBM.SYSCOPY Contains information needed for recovery. Column Name DBNAME TSNAME DSNUM

Data Type CHAR(8) CHAR(8) INTEGER

ICTYPE

CHAR(1)

ICDATE

CHAR(6)

START_RBA

CHAR(6)

FILESEQNO

INTEGER

236

Description Name of the database. Name of the target tablespace or index space. Data set number within the tablespace. For partitioned tablespaces, this value corresponds to the partition number for a single partition copy, or 0 for a copy of an entire partitioned tablespace or index space. Type of operation: A ALTER B REBUILD INDEX C CREATE D CHECK DATA LOG(NO) (no log records for the range are available for RECOVER utility) E RECOVER (to current point) F COPY FULL YES I COPY FULL NO M MODIFY RECOVERY utility P RECOVER TOCOPY or RECOVER TORBA (partial recovery point) Q QUIESCE R LOAD REPLACE LOG(YES) S LOAD REPLACE LOG(NO) V REPAIR VERSIONS utility W REORG LOG(NO) X REORG LOG(YES) Y LOAD LOG(NO) Z LOAD LOG(YES) T TERM UTILITY command (terminated utility) Date of the entry in the form yymmdd. For the COPYTOCOPY utility, this value is the date of the original entry, when the primary local site or primary recovery site copy was made. A 48-bit positive integer that contains the LRSN of a point in the DB2 recovery log. (The LRSN is the RBA in a non-data-sharing environment.) * For ICTYPE I or F, the starting point for all updates since the image copy was taken * For ICTYPE P, the point after the log-apply phase of point-intime recovery * For ICTYPE Q, the point after all data sets have been successfully quiesced * For ICTYPE R or S, the end of the log before the start of the LOAD utility and before any data is changed * For ICTYPE T, the end of the log when the utility is terminated * For other values of ICTYPE, the end of the log before the start of the RELOAD phase of the LOAD or REORG utility. Tape file sequence number of the copy. ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name DEVTYPE IBMREQD

Data Type CHAR(8) CHAR(1)

DSNAME

CHAR(44)

ICTIME

CHAR(6)

SHRLEVEL

CHAR(1)

DSVOLSER

VARCHAR(1784)

TIMESTAMP

TIMESTAMP

ICBACKUP

CHAR(2)

ICUNIT

CHAR(1)

STYPE

CHAR(1)

®

DB2 9 for z/OS

Description Device type the copy is on. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes For ICTYPE='P' (RECOVER TOCOPY only), 'I', or 'F', DSNAME contains the data set name. Otherwise, DSNAME contains the name of the database and tablespace or index space in the form, database-name.space-name, or DSNAME is blank for any row migrated from a DB2 release prior to Version 4. The time at which this row was inserted, in the form hhmmss. The insertion takes place after the completion of the operation that the row represents. ICTIME is blank for any row that was migrated from Version 1 Release 1 of DB2. SHRLEVEL parameter on COPY (for ICTYPE F or I only): C Change R Reference blank Does not describe an image copy or was migrated from Version 1 Release 1 of DB2. The volume serial numbers of the data set. A list of 6-byte numbers separated by commas. Blank if the data set is cataloged. The date and time when the row was inserted. This is the date and time recorded in ICDATE and ICTIME. The use of TIMESTAMP is recommended over that of ICDATE and ICTIME, because the latter two columns may not be supported in later DB2 releases. Specifies the type of image copy contained in the data set: Blank LOCALSITE primary copy (first data set named with COPYDDN) LB LOCALSITE backup copy (second data set named with COPYDDN) RP RECOVERYSITE primary copy (first data set named with RECOVERYDDN) RB RECOVERYSITE backup copy (second data set named with RECOVERYDDN) Indicates the media that the image copy data set is stored on: D DASD T Tape blank Medium is neither tape nor DASD, the image copy is from a DB2 release prior to Version 2 Release 3, or ICTYPE is not 'I' or 'F'. When ICTYPE=A, the values are: A A partition was added to a table. C A column was added to a table and an index in different commit scopes. E The data set numbers of a base table and its associated clone table are exchanged. G An index was regenerated L The logging attribute of the table space was altered to LOGGED. N An index was altered to not padded O The logging attribute of the table space was altered to NOT LOGGED. 237

®


Data Type

Description P An index was altered to padded R A table was altered to rotate partitions. V A column in a table was altered for a numeric data type change and the column is in an index. Z A column that is in the key of an index that was versioned prior to DB2 Version 8 was altered. When ICTYPE=C, the values are: L The logging attribute of the table space was altered to LOGGED. O The logging attribute of the table space was altered to NOT LOGGED. When ICTYPE=F, the values are: A ADD PARTITION execution C DFSMS concurrent copy (″I″ instance of the table space) J DFSMS concurrent copy (″J″ instance of the table space) R ROTATE FIRST TO LAST S LOAD REPLACE(NO) V ALTER INDEX NOT PADDED W REORG LOG(NO) X REORG LOG(YES) blank DB2 image copy The MERGECOPY utility, when used to merge an embedded copy with subsequent incremental copies, also produces a record that contains ICTYPE=F and the STYPE of the original image copy (R, S, W, or X). When ICTYPE = M and the MODIFY RECOVERY utility was executed to delete SYSCOPY and/or SYSLGRNX records, the value is R. When ICTYPE=O, the values are: R Reordered format B Basic row format When ICTYPE=P, the values are: C Recover to a point in time without using logonly with consistency. L Recover to a point in time using logonly without consistency. M Recover to a point in time using logonly with consistency. blank Recover to a point in time without using logonly without consistency. When ICTYPE=Q and option WRITE(YES) is in effect when the quiesce point is taken, the value is W. When ICTYPE=R, S, W, or X and the operation is resetting REORG pending status, the value is A. When ICTYPE=R, S, W, or X and the operation is first materializing the default value for a row change timestamp

238

®

DB2 9 for z/OS

®


Data Type

PIT_RBA

CHAR(6)

GROUP_ NAME

CHAR(8)

OTYPE

CHAR(1)

LOWDSNUM

INTEGER

HIGHDSNUM

INTEGER

COPYPAGESF NPAGESF

FLOAT(8) FLOAT(8)

CPAGESF JOBNAME AUTHID OLDEST_VERSION LOGICAL_PART LOGGED

FLOAT(8) CHAR(8) CHAR(8) SMALLINT INTEGER CHAR(1)

®

DB2 9 for z/OS

Description column, the value is T. When ICTYPE=T, this field indicates which COPY utility was terminated by the TERM UTILITY command or the START DATABASE command with the ACCESS(FORCE) option. The values are: F COPY FULL YES I COPY FULL NO For other values of ICTYPE, the value is blank. When ICTYPE=P, this field contains the LRSN for the point in the DB2 log. (The LRSN is the RBA in a non-data-sharing Environment). For other ICTYPEs, this field is X'000000000000'. When ICTYPE=P, this field indicates the stop location of a point-in-time recovery. If a record contains ICTYPE=P and PIT_RBA=X'000000000000', the copy pending status is active and a full image copy is required. If such a record is encountered during fallback processing of RECOVER, the recover job fails, and a point-in-time recovery is required. PIT_RBA can be zero if the point-in-time recovery is completed by the fall-back processing of RECOVER, or if CTYPE=P from a prior release of DB2. When ICTYPE=F or I and SHRLEVEL=C, this column contains the current RBA or LRSN that corresponds to the point in the DB2 log when the SHRLEVEL CHANGE copy completes. The DB2 data-sharing member name of the DB2 subsystem that performed the operation. This column is blank if the DB2 subsystem was not in a DB2 data-sharing environment at the time the operation was performed. Type of object that the recovery information is for: I Index space T Tablespace Partition number of the lowest partition in the range for SYSCOPY records created for REORG and LOAD REPLACE for resetting a REORG pending status. Version number of an index for SYSCOPY records created for a COPY (ICTYPE=F) of an index space (OTYPE=I). (An index is versioned when a VARCHAR column in the index key is lengthened.) The column is valid only for these uses. Partition number of the highest partition in the range. This column is valid only for SYSCOPY records created for REORG and LOAD REPLACE for resetting REORG pending status. Number of pages written to the copy data set. The number of pages in the tablespace or index at the time of INLINE COPY. Total number of changed pages. Job name of the utility. Authorization ID of the utility. Version number of the oldest format of data for an object. Logical partition number. Indicates the logging attribute of the table space at the time the SYSCOPY record is written: 239

®


Data Type

TTYPE

CHAR(8)

INSTANCE

SMALLINT

RELCREATED

CHAR(1)

Description Y — indicates that the logging attribute of the table space is LOGGED N — indicates that the logging attribute of the table spaces is NOT LOGGED blank — indicates that the row was inserted prior to Version 9.1. For a non-LOB table spaces or an index space, blank indicates that the logging attribute is LOGGED. When ICTYPE=T, TTYPE of B indicates that a broken page was detected during copy. When ICTYPE = P, R, S, W, X, this column indicates the row format for the table space or partition. RRF Indicates that the row format is the reordered row format BRF Indicates that the row format is the basic row format When ICTYPE = E, this column indicates if the full recovery reset the object: blank The full recovery reset the object N The full recovery did not reset the object When STYPE = E and ICTYPE = A, INSTANCE indicates the data set instance number of a base object after an EXCHANGE statement completes. The value of the INSTANCE column for the last data exchange will match the value of the INSTANCE column for the SYSIBM.SYSTABLESPACE table. For an image copy, INSTANCE indicates the instance number of the current base objects (table and index). The release of DB2 that is used to create the object. Blank if created prior to Version 9

SYSIBM.SYSCTXTTRUSTATTRS Contains one row for each list of attributes for a given trusted context. Column Name CONTEXTID NAME

240

Data Type INTEGER VARCHAR(128)

Description The internal trusted context ID. Name of the trust attribute. Possible values including the following attributes: • An IPv4 address is represented as a dotted decimal IP address. An example of an IPv4 address is 9.112.46.111 • An IPv6 address is represented as a colon hexadecimal address. An example of an IPv6 address is 2001:0DB8:0000:0000:0008:0800:2 00C:417A, which can also be expressed in a compressed form as 2001:DB8::8:800:200C:417A • A domain name which is converted to an IP address by the domain name server where a resulting IPv4 or IPv6 address is determined. • A job or started task name for local ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide applications. A network access security zone name in the RACF SERVAUTH class. The value of the trust attribute. The time when the attribute is created. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape.

•

VALUE CREATEDTS IBMREQD

VARCHAR(254) TIMESTAMP CHAR(1)

SYSIBM.SYSDATABASE Contains one row for each database, except for database DSNDB01. Column Name NAME CREATOR STGROUP


BPOOL

CHAR(8)

DBID

SMALLINT

IBMREQD

CHAR(1)

CREATEDBY

VARCHAR(128)

TIMESTAMP TYPE

CHAR(1) TIMESTAMP CHAR(1)

GROUP_MEMBER

VARCHAR(24)

CREATEDTS

TIMESTAMP

ALTEREDTS

TIMESTAMP

®

DB2 9 for z/OS

Description Database name. Authorization ID of the owner of the database. Name of the default storage group of the database; blank for a system database. Name of the default buffer pool of the tablespace; blank for a system tablespace. Internal identifier of the database. If there were 32511 databases or more when this database was created, the DBID is a negative number. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Primary authorization ID of the user who created the database. Not used. The value is '0001-01-01-00.00.00.000000'. Type of database: blank Not a work file database or a TEMP database. T A TEMP database. The database was created with the AS TEMP clause, which indicates it is used for declared temporary tables. W A work file database. The database is DSNDB07, or it was created with the WORKFILE clause and used as a work file database by a member of a DB2 data-sharing group. The DB2 data-sharing member name of the DB2 subsystem that use this work file database. This column is blank if the work file database was not created in a DB2 data-sharing environment, or if the database is not a work file database as indicated by the TYPE column. Time when the CREATE statement was executed for the database. For DSNDB04 and DSNDB06, the value is '1985-04-01.00.00.00.000000'. Time when the most recent ALTER DATABASE statement was applied. If no ALTER DATABASE statement has been applied, ALTEREDTS has the value 241

®


Data Type

ENCODING_ SCHEME

CHAR(1)

SBCS_CCSID

INTEGER

DBCS_CCSID

INTEGER

MIXED_CCSID

INTEGER

INDEXBP IMPLICIT

CHAR(8) CHAR(1)

CREATORTYPE

CHAR(1)

RELCREATED

CHAR(1)

Description of CREATEDTS. Default encoding scheme for the database: E EBCDIC A ASCII U UNICODE blank For DSNDB04, a work file database, and a TEMP database. Default SBCS CCSID for the database. For a TEMP database or a database created in a DB2 release prior to Version 5, the value is 0. Default DBCS CCSID for the database. For a TEMP database or a database created in a DB2 release prior to Version 5, the value is 0. Default mixed CCSID for the database. For a TEMP database or database created in a DB2 release prior to Version 5, the value is 0. Name of the default buffer pool for indexes. Indicates whether the database was implicitly created: Y The database was implicitly created N The database was explicitly created Indicates the type of creator: blank Authorization ID L Role The release of DB2 that is used to create the object.

SYSIBM.SYSDATATYPES Contains one row for each distinct type defined to the system. Column Name SCHEMA OWNER NAME CREATEDBY SOURCESCHEMA SOURCETYPE METATYPE DATATYPEID SOURCETYPEID

Data Type VARCHAR(128) VARCHAR(128) VARCHAR(128) VARCHAR(128) VARCHAR(128) VARCHAR(128) CHAR(1) INTEGER INTEGER

LENGTH

INTEGER

SCALE

SMALLINT

SUBTYPE

CHAR(1)

CREATEDTS ENCODING_SCHEME

TIMESTAMP CHAR(1)

242

Description Schema of the distinct type. Owner of the distinct type. Name of the distinct type. Schema under which the distinct type was created. Schema of the source data type. Name of the source type. The class of data type: T Distinct type. Internal identifier of the distinct type. Internal ID of the built-in data type upon which the distinct type is sourced. Maximum length or precision of a distinct type that is sourced on the IBM-defined DECIMAL data type. Scale for a distinct type that is sourced on the IBM-defined DECIMAL type. For all other distinct types, the value is 0. Subtype of the distinct type, which is based on the subtype of the source type: B The subtype is FOR BIT DATA. S The subtype is FOR SBCS DATA. M The subtype is FOR MIXED DATA. blank The source type is not a character type. Time when the distinct type was created. Encoding scheme of the distinct type: ®

DB2 9 for z/OS

®


Data Type

IBMREQD

CHAR(1)

REMARKS

VARCHAR(762)

OWNERTYPE

CHAR(1)

RELCREATED

CHAR(1)

Description A ASCII E EBCDIC U UNICODE Whether the row came from the basic machine-readable material (MRM) tape: N=No ,Y=Yes A character string provided by the user with the COMMENT ON statement. Indicates the type of owner: blank Authorization ID L Role The release of DB2 that is used to create the object.

SYSIBM.SYSDBAUTH Records the privileges that are held by users over databases. Column Name GRANTOR


GRANTEE

VARCHAR(128)

NAME DATEGRANTED TIMEGRANTED

VARCHAR(24) CHAR(12) CHAR(6) CHAR(8)

GRANTEETYPE

CHAR(1)

AUTHHOWGOT

CHAR(1)

CREATETABAUTH

CHAR(1)

CREATETSAUTH

CHAR(1)

DBADMAUTH

CHAR(1)

DBCTRLAUTH

CHAR(1)

®

DB2 9 for z/OS

Description Authorization ID of the user who granted the privileges. Could also be PUBLIC or PUBLIC followed by an asterisk. Application ID of the user who holds the privilege. Could also be PUBLIC for a grant to PUBLIC. Database name. Internal use only. Date the privileges were granted; in the form yymmdd. Time the privileges were granted; in the form hhmmssth. Indicates the type of owner: blank Authorization ID L Role Authorization level of the user from whom the privileges were received. This authorization level is not necessarily the highest authorization level of the grantor. blank Not applicable C DBCTL D DBADM L SYSCTRL M DBMAINT S SYSADM Whether the GRANTEE can create tables within the database: blank Privilege is not held G Privilege held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can create tablespaces within the database: blank Privilege is not held G Privilege held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE has DBADM authority over the database: blank Privilege is not held G Privilege held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE has DBCTRL authority over the 243

®


Data Type

DBMAINTAUTH

CHAR(1)

DISPLAYDBAUTH

CHAR(1)

DROPAUTH

CHAR(1)

IMAGCOPYAUTH

CHAR(1

LOADAUTH

CHAR(1)

REORGAUTH

CHAR(1)

RECOVERDBAUTH

CHAR(1)

REPAIRAUTH

CHAR(1)

STARTDBAUTH

CHAR(1)

STATSAUTH

CHAR(1)

244

Description database: blank Privilege is not held G Privilege held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE has DBMAINT authority over the database: blank Privilege is not held G Privilege held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can issue the DISPLAY command for the database: blank Privilege is not held G Privilege held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can issue the ALTER DATABASE and DROP DATABASE statement: blank Privilege is not held G Privilege held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can use the COPY, MERGECOPY, MODIFY, and QUIESCE utilities on the database: blank Privilege is not held G Privilege held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can use the LOAD utility to load tables in the database: blank Privilege is not held G Privilege held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can use the REORG utility to reorganize tablespaces and indexes in the database: blank Privilege is not held G Privilege held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can use the RECOVER and REPORT utilities on tablespaces in the database: blank Privilege is not held G Privilege held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can use the DIAGNOSE and REPAIR utilities on tablespaces and indexes in the database: blank Privilege is not held G Privilege held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can use the START command against the database: blank Privilege is not held G Privilege held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can use the CHECK and RUNSTATS utilities against the database: blank Privilege is not held G Privilege held with the GRANT option ®

DB2 9 for z/OS

®


Data Type

STOPAUTH

CHAR(1)

IBMREQD

CHAR(1)

GRANTEDTS GRANTORTYPE

TIMESTAMP CHAR(1)

Description Y Privilege is held without the GRANT option Whether the GRANTEE can issue the STOP command against the database: blank Privilege is not held G Privilege held with the GRANT option Y Privilege is held without the GRANT option Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Time when the GRANT statement was executed. Indicates the type of owner: blank Authorization ID L Role

SYSIBM.SYSDBRM Contains one row for each DBRM of each application plan. Column Name NAME TIMESTAMP PDSNAME PLNAME PLCREATOR PRECOMPTIME

Data Type VARCHAR(24) CHAR(8) CHAR(132) VARCHAR(24) VARCHAR(128) CHAR(8)

PRECOMPDATE

CHAR(6)

QUOTE

CHAR(1)

COMMA

CHAR(1)

HOSTLANG

CHAR(1)

IBMREQD

CHAR(1)

CHARSET

CHAR(1)

MIXED

CHAR(1)

®

DB2 9 for z/OS

Description Name of the DBRM. Consistency token. Name of the partitioned data set of which the DBRM is a member. Name of the application plan of which this DBRM is a part. Authorization ID of the owner of the application plan. Time of precompilation in the form hhmmssth. If the LEVEL precompiler option is used, then this value does not represent the precompile time. Date of precompilation in the form yymmdd. If the LEVEL precompiler option is used, then this value does not represent the precompile date. SQL string delimiter for the SQL statements in the DBRM: N Apostrophe Y Quotation mark Decimal point representation for SQL statements in the DBRM: N Period Y Comma The host language used B Assembler language C OS/VS COBOL D C F Fortran P PL/I 2 VS COBOL II or IBM COBOL Release 1 (formerly called COBOL/370) 3 IBM COBOL (Release 2 or subsequent releases) 4 C++ Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Indicates whether the system CCSID for SBCS data was 290 (Katakana) when the program was precompiled: A No K Yes Indicates if mixed data was in effect when the application program was precompiled. 245

®


Data Type

DEC31

CHAR(1)

VERSION PRECOMPTS PLCREATOR TYPE

VARCHAR(122) TIMESTAMP CHAR(1)

RELCREATED

CHAR(1)

Description N No Y Yes Indicates whether DEC31 was in effect when the program was precompiled. Blank No Y Yes Version identifier for the DBRM. Time when the DBRM was precompiled. Indicates the type of creator: blank Authorization ID L Role The release of DB2 that is used to create the object.

SYSIBM.SYSDEPENDENCIES Records the dependencies between objects. Column Name BNAME


BSCHEMA

VARCHAR(128)

BCOLNAME

VARCHAR(128)

BCOLNO

SMALLINT

BTYPE

CHAR(1)

BOWNER

VARCHAR(128)

BOWNERTYPE

CHAR(1)

DNAME DSCHEMA


DCOLNAME

VARCHAR(128)

DCOLNO

SMALLINT

DTYPE

CHAR(1)

DOWNER

VARCHAR(128)

DOWNERTYPE

CHAR(1)

IBMREQD

CHAR(1)

246

Description Name of the object on which another object is dependent. If BTYPE is 'F', the name is the specific name of the function. Schema or qualifier of the object on which another object is dependent. Column name of the object on which another object is dependent. Column number of the object on which another object is dependent. Type of object that is identified by BNAME, BSCHEMA, and BCOLNAME F Function Authorization ID of the owner of the object on which another object is dependent. Type of creator of the object on which another object is dependent: L Role blank Authorization ID that is not a role Name of the object that has dependencies on another object. Schema or qualifier of the object that has dependencies on another object. Column name of the object that has dependencies on another object. Column number of the object that has dependencies on another object. Type of the object that is identified by DNAME, DSCHEMA, and DCOLNAME: I Index Authorization ID of the owner of the object that has dependencies on another object. Type of creator of the object that has dependencies on another object: L Role blank Authorization ID if not a role A value of Y indicates that the row came from the basic machinereadable material (MRM) tape. ®

DB2 9 for z/OS

®


SYSIBM.SYSDUMMY1 Contains one row. The table is used for SQL statements in which a table reference is required, but the contents of the table are not important. Column Name IBMREQD

Data Type CHAR(1)

Description Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes

SYSIBM.SYSENVIRONMENT Records the environment variables when an object is created. Column Name ENVID

Data Type INTEGER

CURRENT_SCHEMA RELCREATED PATHSCHEMAS APPLICATION_ ENCODING_CCSID ORIGINAL_ ENCODING_CCSID DECIMAL_POINT

VARCHAR(128) CHAR(1) VARCHAR(2048) INTEGER

Description Internal identifier of the environment. The current schema. The release when the environment information is created. The schema path. The CCSID of the application environment.

INTEGER

The original CCSID of the statement text string.

CHAR(1)

MIN_DIVIDE_SCALE

CHAR(1)

STRING_DELIMITER

CHAR(1)

SQL_STRING_ DELIMITER

CHAR(1)

MIXED_DATA

CHAR(1)

DECIMAL_ ARITHMETIC

CHAR(1)

DATA_FORMAT

CHAR(1)

TIME_FORMAT

CHAR(1)

The decimal point indicator: C Comma P Period The minimum divide scale: N The usual rules apply for decimal division in SQL Y Retain at lease three digits to the right of the decimal point after any decimal division. The string delimiter that is used in COBOL string constants: A Apostrophe (') Q Quote (") The SQL string delimiter that is used in string constants: A Apostrophe (') Q Quote (") Uses mixed DBCS data: N No mixed data Y Mixed data The rules that are to be used for CURRENT PRECISION and when both operands in a decimal operation have a precision of 15 or less: 1 DEC15 specifies that the rules do not allow a precision greater than 15 digits 2 DEC31 specifies that the rules allow a precision of up to 31 digits The date format: I ISO - yyyy-mm-dd J JIS - yyyy-mm-dd U USA - mm/dd/yyyy E EUR - dd.mm.yyyy L Locally defined by an installation exit routine The time format: I ISO - hh.mm.ss

®

DB2 9 for z/OS

247

®

DB2 9 z/OS Reference Guide J U E FLOAT_FORMAT

CHAR(1)

HOST_LANGUAGE

CHAR(8)

CHARSET

CHAR(1)

FOLD

CHAR(1)

IBMREQD

CHAR(1)

ROUNDING

CHAR(1)

JIS - hh.mm.ss USA - hh:mm AM or hh:mm PM EUR - hh.mm.ss L Locally defined by an installation exit routine The floating point format: I IEEE floating point format S System/390 floating point format The host language: ASM C CPP IBMCOB PLI FORTRAN The character set: A Alphanumeric FOLD is only applicable when HOST_LANGUAGE is C or CPP. Otherwise FOLD is blank. N Lower case letters in SBCS ordinary identifiers are not folded to uppercase Y Lower case letters in SBCS ordinary identifiers are folded to uppercase blank Not applicable A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. The rounding mode that is used when arithmetic and casting operations are performed on DECFLOAT data: C ROUND_CEILING D ROUND_DOWN F ROUND_FLOOR G ROUND_HALF_DOWN E ROUND_HALF_EVEN H ROUND_HALF_UP U ROUND_UP

SYSIBM.SYSFIELDS Contains one row for every column that has a field procedure. Column Name TBCREATOR


TBNAME COLNO NAME FLDTYPE

VARCHAR(128) SMALLINT VARCHAR(128) VARCHAR(24)

248

Description Authorization ID of the owner of the table that contains the column. Name of the table that contains the column. Numeric place of this column in the table. Name of the column. Data type of the encoded values in the field: INTEGER Large integer SMALLINT Small integer FLOAT Floating-point CHAR Fixed-length character string VARCHAR Varying-length character string DECIMAL Decimal GRAPHIC Fixed-length graphic string VARG Varying-length graphic string ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name LENGTH

Data Type SMALLINT

SCALE FLDPROC

SMALLINT VARCHAR(24)

WORKAREA

SMALLINT

IBMREQD

CHAR(1)

EXITPARML

SMALLINT

PARMLIST

VARCHAR(735)

EXITPARM

VARCHAR(1530) FOR BIT DATA

Description The length attribute of the field; or, for a decimal field, its precision. The number does not include the internal prefixes that can be used to record actual length and null state. INTEGER 4 SMALLINT 2 FLOAT 8 CHAR Length of string VARCHAR Maximum length of string DECIMAL Precision of number GRAPHIC Number of DBCS characters VARG Maximum number of DBCS characters Scale if FLDTYPE is DECIMAL; otherwise, the value is 0. For a row describing a field procedure, the name of the procedure. For a row describing a field procedure, the size, in bytes, of the work area required for the encoding and decoding of the procedure. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes For a row describing a field procedure, the length of the field procedure parameter value block. For a row describing a field procedure, the parameter list following FIELDPROC in the statement that created the column, with insignificant blanks removed. For a row describing a field procedure, the parameter value block of the field procedure (the control block passed to the field procedure when it is invoked).

SYSIBM.SYSFOREIGNKEYS Contains one row for every column of every foreign key. Column Name CREATOR TBNAME RELNAME


COLNAME COLNO COLSEQ IBMREQD

VARCHAR(128) SMALLINT SMALLINT CHAR(1)

Description Authorization ID of the owner of the table that contains the column. Name of the table that contains the column. Constraint name for the constraint for which the column is part of the foreign key. Name of the column. Numeric place of the column in its table. Numeric place of the column in the foreign key. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes

SYSIBM.SYSINDEXES Contains one row for every index. Column Name NAME CREATOR TBNAME TBCREATOR UNIQUERULE ®

DB2 9 for z/OS

Data Type VARCHAR(128) VARCHAR(128) VARCHAR(128) VARCHAR(128) CHAR(1)

Description Name of the index. Schema of the owner of the index. Name of the table on which the index is defined. Schema of the owner of the table. Whether the index is unique: 249

®


Data Type

COLCOUNT CLUSTERING

SMALLINT CHAR(1)

CLUSTERED

CHAR(1)

DBID OBID ISOBID DBNAME INDEXSPACE

NLEAF

SMALLINT SMALLINT SMALLINT VARCHAR(24) VARCHAR(24) INTEGER INTEGER INTEGER

NLEVELS

SMALLINT

BPOOL PGSIZE

CHAR(8) SMALLINT

ERASERULE

CHAR(1)

CLOSERULE

CHAR(1)

250

Description D No (duplicates are allowed) U Yes P Yes, and it is a primary index (As in prior releases of DB2, a value of P is used for primary keys that are used to enforce a referential constraint.) C Yes, and it is an index used to enforce UNIQUE constraint N Yes, and it is defined with UNIQUE WHERE R Yes, and it is an index used to enforce the uniqueness of a non-primary parent key G Yes, and it is an index used to enforce the uniqueness of values in a column defined as ROWID GENERATED BY DEFAULT. X Yes, and it is an index used to enformce the uniqueness of values in a column that contains XML data The number of columns in the key. Whether CLUSTER was specified when the index was created: N No Y Yes Whether the table is actually clustered by the index: N A significant number of rows are not in clustering order, or statistics have not been gathered. Y Most of the rows are in clustering order. blank Not applicable. This is an updatable column that can also be changed by the RUNSTATS utility. Internal identifier of the database. Internal identifier of the index fan set descriptor. Internal identifier of the index page set descriptor. Name of the database that contains the index. Name of the index space. Not used. Not used. Number of active leaf pages in the index. The value is -1 if statistics have not been gathered. This is an updatable column. Number of levels in the index tree. If the index is partitioned, it is the maximum of the number of levels in the index tree for all the partitions. The value is -1 if statistics have not been gathered. This is an updatable column. Name of the buffer pool used for the index. Contains the value 4, 8, 16, or 32 which indicates the size, in KB, of the leaf pages in the index. Whether the data sets are erased when dropped. The value is meaningless if the index is partitioned: N No Y Yes Whether the data sets are candidates for closure when the limit on the number of open data sets is reached: N No Y Yes ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name SPACE

Data Type INTEGER

IBMREQD

CHAR(1)

CLUSTERRATIO

SMALLINT

CREATEDBY

VARCHAR(128)

STATSTIME

TIMESTAMP

INDEXTYPE

CHAR(1)

FIRSTKEYCARDF

FLOAT

FULLKEYCARDF

FLOAT

CREATEDTS

TIMESTAMP

ALTEREDTS

TIMESTAMP

PIECESIZE

INTEGER

COPY

CHAR(1)

COPYLRSN

CHAR(6)

®

DB2 9 for z/OS

Description Number of kilobytes of DASD storage allocated to the index, as determined by the last execution of the STOSPACE utility. The value is 0 if the index is not related to a storage group, or if STOSPACE has not been run. If the index space is partitioned, the value is the total kilobytes of DASD storage allocated to all partitions that are defined in a storage group. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Percentage of rows that are in clustering order. For a partitioning index, it is the weighted average of all index partitions in terms of the number of rows in the partition. The value is 0 if statistics have not been gathered. The value is -2 if the index is for an auxiliary table. This is an updatable column. Primary authorization ID of the user who created the index. If RUNSTATS updated the statistics, the date and time when the last invocation of RUNSTATS updated the statistics. The default value is '0001-01-01.00.00.00.000000'. This is an updatable column. The index type: 2 Type 2 index blank Type 1 index D Data partitioned secondary index P Partitioning index Number of distinct values of the first key column. This number is an estimate if updated while collecting statistics on a single partition. The value is -1 if statistics have not been gathered. This is an updatable column. Number of distinct values of the key. The value is -1 if statistics have not been gathered. This is an updatable column. Time when the CREATE statement was executed for the index. If the index was created in a DB2 release prior to Version 5, the value is '0001-01-01.00.00.00.000000'. Time when the most recent ALTER INDEX statement was executed for the index. If no ALTER INDEX statement has been applied, ALTEREDTS has the value of CREATEDTS. If the index was created in a DB2 release prior to Version 5, the value is '0001-01-01.00.00.00.000000'. Maximum size of a data set in kilobytes for non-partitioning indexes. A value of zero (0) indicates that the index is a partitioning index or that the index was created in a DB2 release prior to Version 5. Whether COPY YES was specified for the index, which indicates if the index can be copied and if SYSIBM.SYSLGRNX recording is enabled for the index. N No Y Yes The value can be either an RBA or LRSN. (LRSN is only for data sharing.) If the index is currently defined as COPY YES, the value is the RBA or LRSN when the index was created with COPY YES or altered to COPY YES, not the current 251

®


Data Type

CLUSTERRATIOF

FLOAT

SPACEF

FLOAT(8)

REMARKS

VARCHAR(762)

PADDED

CHAR(1)

VERSION OLDEST_VERSION

SMALLINT SMALLINT

CURRENT_VERSION

SMALLINT

RELCREATED AVGKEYLEN KEYTARGET_COUNT

CHAR(1) INTEGER SMALLINT

UNIQUE_COUNT

SMALLINT

IX_EXTENSION_ TYPE

CHAR(1)

COMPRESS

CHAR(1)

OWNER

VARCHAR(128)

OWNERTYPE DATAREPEAT FACTORF

CHAR(1) FLOAT

252

Description RBA or LRSN. If the index is currently defined as COPY NO, the value is set to X'000000000000' if the index was created with COPY NO; otherwise, if the index was altered to COPY NO, the value in COPYLRSN is not changed when the index is altered to COPY NO. When multiplied by 100, the value of the column is the percentage of rows that are in clustering order. For example, a value of .9125 indicates 91.25%. For a partitioning index, it is the weighted average of all index partitions in terms of the number of rows in the partition. The value is 0 if statistics have not been gathered. The value is -2 if the index is for an auxiliary table, a node ID index or an XML index. This is an updatable column. Kilobytes of DASD storage. The value is –1 if statistics have not been gathered. This is an updatable column. A character field string provided by the user with the COMMENT ON statement. Indicates whether keys within the index will be padded for vary-length column data. Y The index contains varying length character or graphic data is padded N The index contains varying length characters or graphic data that is not padded Blank The index does not contain varying length or graphic data The version of the data row format for the index. The version number describing the oldest format of the data in the index space and any image copies of the index The version number describing the newest format of the data in the index space. 0 indicates no versioning. Release of DB2 use to the object. Blank if before V8. Average key length within the index. The number of key-targets for an extended index. The value is 0 for a simple index. The value is 0 for a simple index or if the index has no unique key. Otherwise, the value is the number of key-targets that are required for the unique key of the index. Identifies the type of extended index: blank Simple index S Index on a scalar expression N node ID index V XML index Indicates whether index compression is active: N Index compression is not active Y Index compression is active Authorization ID of the owner of the index, empty string for indexes created in a DB2 release prior to Version 9. Indicates the type of owner: blank Authorization ID L Role The anticipated number of data pages that will be touched following an index key order. This statistic is only collected when the STATCLUS subsystem parameter is set to ENHANCED. This number is -1 if statistics have not been ®

DB2 9 for z/OS

®


Data Type

ENVID

INTEGER

Description collected. The valid value is -1 or any value that is equal to or greater than 1. This is an updatable column. Internal environment identifier.

SYSIBM.SYSINDEXES_HIST Contains rows from SYSINDEXES. Whenever rows are added or changed in SYSINDEXES, the rows are also written to the new history table. Rows in this table can be inserted, updated, and deleted. Column Name NAME CREATOR TBNAME TBCREATOR CLUSTERING


NLEAF

INTEGER

NLEVELS

SMALLINT

STATSTIME

TIMESTAMP

FIRSTKEYCARDF

FLOAT(8)

FULLKEYCARDF

FLOAT(8)

CLUSTERRATIOF

FLOAT(8)

SPACEF

FLOAT(8)

IBMREQD

CHAR(1)

AVGKEYLEN DATAREPEAT FACTORF

INTEGER FLOAT

Description Name of the index. Schema of the owner of the index. Name of the table on which the index is defined. Schema of the owner of the table. Whether CLUSTER was specified when the index was created: N No Y Yes Number of active leaf pages in the index. The value is -1 if statistics have not been gathered. Number of levels in the index tree .If the index is partitioned, it is the maximum of the number of levels in the index tree for all the partitions. The value is -1 if statistics have not been gathered. If RUNSTATS updated the statistics ,the date and time when the last invocation of RUNSTATS updated the statistics. The default value is ’0001-01-01.00.00.00.000000 ’. Number of distinct values of the first key column. This number is an estimate if updated while collecting statistics on a single partition. The value is -1 if statistics have not been gathered. Number of distinct values of the key. The value is -1 if statistics have not been gathered. Percentage of rows that are in clustering order. For a partitioning index, it is the weighted average of all index partitions in terms of the number of rows in the partition. The value is 0 if statistics have not been gathered. The value is -2 if the index is for an auxiliary table. Number of kilobytes of DASD storage allocated to the index space partition. The value is -1 if statistics have not been gathered. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. Average key length within the index. The anticipated number of data pages that will be touched following an index key order. This statistic is only collected when the STATCLUS subsystem parameter is set to ENHANCED. This number is -1 if statistics have not been collected. The valid value is -1 or any value that is equal to or greater than 1. This is an updatable column.

SYSIBM.SYSINDEXPART Contains one row for each non-partitioning secondary index and one row for each partition of a partitioning index or data partitioned secondary index. ®

DB2 9 for z/OS

253

®

DB2 9 z/OS Reference Guide Column Name PARTITION IXNAME IXCREATOR PQTY

Data Type SMALLINT VARCHAR(128) VARCHAR(128) INTEGER

SQTY

SMALLINT

STORTYPE

CHAR(1)

STORNAME

VARCHAR(128)

VCATNAME

VARCHAR(24)

LEAFDIST

INTEGER

IBMREQD

CHAR(1)

LIMITKEY

VARCHAR(512)

FREEPAGE

SMALLINT

PCTFREE

SMALLINT

SPACE

INTEGER

254

Description Partition number; Zero if index is not partitioned. Name of the index. Schema of the owner of the index. Primary space allocation in units of 4KB storage blocks. For user-managed data sets, the value is set to the primary space allocation only if RUNSTATS INDEX with UPDATE(ALL) or UPDATE(SPACE) is executed; otherwise, the value is zero. Secondary space allocation in units of 4KB storage blocks. For user-managed data sets, the value is set to the secondary space allocation only if RUNSTATS INDEX with UPDATE(ALL) or UPDATE(SPACE) is executed; otherwise, the value is zero. If the value does not fit into the column, the value of the column is 0. See the description of column SECQTYI. Type of storage allocation: E Explicit, and STORNAME names an integrated catalog facility catalog I Implicit, and STORNAME names a storage group Name of storage group or integrated catalog facility catalog used for space allocation. Name of integrated catalog facility catalog used for space allocation. 100 times the average number of leaf pages between successive active leaf pages of the index. The value is -1 if statistics have not been gathered. The value is -2 if the index is a node ID index or an XML index. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes The high value of the limit key of the partition in an internal format. Zero if the index is not partitioned. If any column of the key has a field procedure, the internal format is the encoded form of the value. Number of pages that are loaded before a page is left as free space. Percentage of each leaf or non-leaf page that is left as free space. Number of kilobytes of DASD storage allocated to the index space partition, as determined by the last execution of the STOSPACE utility. The value is 0 if STOSPACE or RUNSTATS has not been run. The value is updated by STOSPACE if the index is related to a storage group. The value is updated by RUNSTATS if the utility is executed as RUNSTATS INDEX with UPDATE(ALL) or UPDATE(SPACE). The value is -1 if the index was defined with the DEFINE NO clause, which defers the physical creation of the data sets until data is first inserted into the index, and data has yet to be inserted into the index.

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name STATSTIME

Data Type TIMESTAMP

GBPCACHE

CHAR(1)

FAROFFPOSF

FLOAT

NEAROFFPOSF

FLOAT

CARDF

FLOAT

SECQTYI

INTEGER

IPREFIX

CHAR(1)

ALTEREDTS

TIMESTAMP

SPACEF

FLOAT(8)

DSNUM

INTEGER

EXTENTS

INTEGER

PSEUDO_DEL_ENTRIES

INTEGER

LEAFNEAR

INTEGER

®

DB2 9 for z/OS

Description If RUNSTATS updated the statistics, the date and time when the last invocation of RUNSTATS updated the statistics. The default value is '0001-0101.00.00.00.000000'. Group buffer pool cache option specified for this index or index partition. blank Only changed pages are cached in the group buffer pool. A Changed and unchanged pages are cached in the group buffer pool. N No data is cached in the group buffer pool. Number of referred to rows far from optimal position because of an insert into a full page. The value is -1 if statistics have not been gathered. The value is -2 if the index is a node ID index or an XML index. The column is not applicable for an index on an auxiliary table. Number of referred to rows near, but not at optimal position, because of an insert into a full page. The value is -2 if the index is a node ID index or an XML index. Not applicable for an index on an auxiliary table. Number of keys in the index that refer to data rows or LOBs. The value is -1 if statistics have not been gathered. Secondary space allocation in units of 4KB storage. For user-managed data sets, the value is the secondary space allocation in units of 4KB blocks if RUNSTATS INDEX with UPDATE(SPACE) or UPDATE(ALL) is executed; otherwise, the value is zero. The first character of the instance qualifier for this index’s data set name. ‘I’ or ‘J’ are the only valid characters for this field. Time when the most recent ALTER INDEX statement was executed for the index. If no ALTER INDEX statement has been applied, the value is '0001-01-01.00.00.00.000000'. Kilobytes of DASD storage. The value is –1 if statistics have not been gathered. This is an updatable column. Number of data sets. The value is –1 if statistics have not been gathered. This is an updatable column. Number of data set extents. The value is –1 if statistics have not been gathered. This is an updatable column. Number of pseudo deleted entries (entries that are logically deleted but still physically present in the index). For a non-unique index, value is the number of RIDs that are pseudo deleted. For a unique index, the value is the number of keys and RIDs that are pseudo deleted. The value is –1 if statistics have not been gathered. This is an updatable column. Number of leaf pages physically near previous leaf page for successive active leaf pages. The value is –1 if statistics have not been gathered. This is an updatable column.

255

®

DB2 9 z/OS Reference Guide Column Name LEAFFAR

Data Type INTEGER

OLDEST_VERSION

SMALLINT

CREATEDTS AVGKEYLEN

TIMESTAMP INTEGER

Description Number of leaf pages located physically far away from previous leaf pages for successive (active leaf) pages accessed in an index scan. The value is –1 if statistics have not been gathered. This is an updatable column. The version numbers describing the oldest formt of data in the index part and any image copies of the index part. Time when the partition was created. Average length of keys within the index.

SYSIBM.SYSINDEXPART_HIST Contains rows from SYSINDEXPART. Whenever rows are added or changed in SYSINDEXPART, the rows are also written to the new history table. Rows in this table can be inserted, updated, and deleted. Column Name PARTITION IXNAME IXCREATOR PQTY


SECQTYI

INTEGER

LEAFDIST

INTEGER

SPACEF

INTEGER

STATSTIME

TIMESTAMP

FAROFFPOSF

FLOAT

NEAROFFPOSF

FLOAT

CARDF

FLOAT

EXTENTS

INTEGER

PSEUDO_DEL_ENTRIES

INTEGER

DSNUM

INTEGER

256

Description Partition number; zero if index is not partitioned. Name of the index. Schema of the owner of the index. Primary space allocation in units of 4KB storage blocks. Zero if a storage group is used. Secondary space allocation in units of 4KB storage. Zero if a storage group is used. 100 times the average number of leaf pages between successive active leaf pages of the index. The value is -1 if statistics have not been gathered. Number of kilobytes of DASD storage allocated to the index space partition. The value is -1 if statistics have not been gathered. If RUNSTATS updated the statistics, the date and time when the last invocation of RUNSTATS updated the statistics. The default value is '0001-0101.00.00.00.000000'. Number of referred to rows far from optimal position because of an insert into a full page. The value is -1 if statistics have not been gathered. The column is not applicable for an index on an auxiliary table. Number of referred to rows near, but not at optimal position, because of an insert into a full page. Not applicable for an index on an auxiliary table. Number of keys in the index that refer to data rows or LOBs. The value is -1 if statistics have not been gathered. Number of data set extents. The value is -1 if statistics have not been gathered. Number of pseudo deleted entries. The value is -1 if statistics have not been gathered. Data set number within the tablespace. For partitioned index spaces, this value corresponds to the partition number for a single partition copy, or 0 for a copy of an entire partitioned index space. The value is -1 if statistics have not been gathered.

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name IBMREQD

Data Type CHAR(1)

LEAFNEAR

INTEGER

LEAFFAR

INTEGER

AVGKEYLEN

INTEGER

Description A value of Y indicates that the row came from the basic machine-readable material (MRM) tape Number of leaf pages physically near previous leaf page for successive active leaf pages. The value is -1 if statistics have not been gathered. This is an updatable column. Number of leaf pages located physically far away from previous leaf pages for successive (active leaf) pages accessed in an index scan. The value is -1 if statistics have not been gathered. This is an updatable column. Average length of keys within the index.

SYSIBM.SYSINDEXSPACESTATS Contains real time statistics for index spaces. Rows in this table can inserted, updated and deleted. Column name UPDATESTATSTIME NLEVELS

Data type TIMESTAMP SMALLINT

NPAGES

INTEGER

NLEAF

INTEGER

NACTIVE

INTEGER

SPACE

INTEGER

EXTENTS

SMALLINT

LOADRLASTTIME

TIMESTAMP

REBUILDLASTTIME

TIMESTAMP

REORGLASTTIME

TIMESTAMP

®

DB2 9 for z/OS

Description The timestamp when the row was inserted or last updated. The number of levels in the index tree A null value indicates that the number of levels is unknown. The number of distinct pages with active rows in the associated table. This is an updatable column. The number of leaf pages in the index. This is an updatable column. The number of active pages in the index space or partition. This value is equivalent to the number of preformatted pages. A null value indicates that the number of active pages is unknown. The amount of space, in KB, that is allocated to the index space or partition. For multi-piece linear page sets, this value is the amount of space in all data sets. A null value indicates the amount of space is unknown. The number of extents in the index space or partition. For multi-piece index spaces, this value is the number of extents for the last data set. For a data set that is striped across multiple volumes, the value is the number of logical extents. A null value indicates the number of extents is unknown. The timestamp of the last LOAD REPLACE on the index space or partition. A null value indicates that the LOAD REPLACE utility has never been run on the index space or partition or that the timestamp is unknown. The timestamp of the last REBUILD INDEX on the index space or partition. A null value indicates that the timestamp that the REBUILD INDEX was last run is unknown. The timestamp of the last REORG INDEX on the index space or partition. A null value indicates that the REORG INDEX utility has never been run on the index space or partition or that the 257

®

DB2 9 z/OS Reference Guide REORGINSERTS

INTEGER

REORGDELETES

INTEGER

REORGAPPENDINSERT

INTEGER

REORGPSEUDODELETES

INTEGER

REORGMASSDELETE

INTEGER

REORGLEAFNEAR

INTEGER

REORGLEAFFAR

INTEGER

REORGNUMLEVELS

INTEGER

STATSLASTTIME

TIMESTAMP

258

timestamp is unknown. The number of index entries that have been inserted since the last REORG, REBUILD INDEX, or LOAD REPLACE on the index space or partition. A null value indicates that the number of inserted index entries is unknown. The number of index entries that have been deleted since the last REORG, REBUILD INDEX, or LOAD REPLACE on the index space or partition A null value indicates that the number of deleted index entries is unknown. The number of index entries that have been inserted since the last REORG, REBUILD INDEX, or LOAD REPLACE on the index space or partition that have a key value that is greater than the maximum key value in the index or partition. A null value indicates that the number of inserted index entries is unknown. The number of index entries that have been pseudo-deleted since the last REORG, REBUILD INDEX, or LOAD REPLACE on the index space or partition. A pseudo-delete is a RID entry that has been marked as deleted. A null value indicates that the number of pseudo-deleted index entries is unknown. The number of mass deletes from a segmented or LOB table space, or the number of dropped tables from a segmented table space since the last time the REORG or LOAD REPLACE utilities were run. A null value indicates that the number of mass deletes is unknown. The number of index page splits that occurred since the last REORG, REBUILD INDEX, or LOAD REPLACE in which the higher part of the split page was near the location of the original page. The higher part of a split page is near the original page if the two page numbers differ by 16 or less. A null value means that the number of split pages near their original pages is unknown. The number of index page splits that occurred since the last REORG, REBUILD INDEX, or LOAD REPLACE in which the higher part of the split page was far from the location of the original page. The higher part of a split page is far from the original page if the two page numbers differ by more than 16. A null value means that the number of split pages near their original pages is unknown. The number of levels in the index tree that were added or removed since the last REORG, REBUILD INDEX, or LOAD REPLACE. A null value means that the number of added or deleted levels is unknown. The timestamp of the last RUNSTATS on the index space or partition. A null value means that RUNSTATS has never been run on the index space or partition, or that the timestamp of the last RUNSTATS is unknown. ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide STATSINSERTS

INTEGER

STATSDELETES

INTEGER

STATSMASSDELETE

INTEGER

COPYLASTTIME

TIMESTAMP

COPYUPDATEDPAGES

INTEGER

COPYCHANGES

INTEGER

COPYUPDATELRSN

CHAR(6)

COPYUPDATETIME

TIMESTAMP

IBMREQD

CHAR(1)

DBID ISOBID

SMALLINT SMALLINT

PSID

SMALLINT

PARTITION

SMALLINT

INSTANCE

SMALLINT

TOTALENTRIES

FLOAT

DBNAME NAME CREATOR

CHAR(8) CHAR(8) VARCHAR(1 28) VARCHAR(1 28) DATE

INDEXSPACE LASTUSED

®

DB2 9 for z/OS

The number of records or LOBs that have been inserted into the table space or partition since the last time that the RUNSTATS utility was run. A null value indicates that the number of inserted records or LOBs is unknown. The number of index entries that have been deleted since the last RUNSTATS on the index space or partition. A null value means that the number of deleted index entries is unknown. The number of times that the index or index space partition was mass deleted since the last RUNSTATS. A null value means that the number of mass deletes is unknown. The timestamp of the last full image copy on the index space or partition. A null value means that COPY has never been run on the index space or partition, or that the timestamp of the last full image copy is unknown. The number of distinct pages that have been updated since the last COPY. A null value indicates that the number of updated pages is unknown. The number of insert or delete operations since the last COPY. A null value indicates that the number of insert, update, and delete operations is unknown. The LRSN or RBA of the first update after the last COPY. A null value indicates that the LRSN or RBA is unknown. The timestamp of the first update after the last COPY. A null value indicates that the timestamp is unknown. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. The internal identifier of the database. The internal identifier of the index space page set descriptor. The internal identifier of the table space page set descriptor for the table space associated with the index. The data set number within the index space. For partitioned index spaces, this value corresponds to the partition number for a single partition. For non-partitioned table spaces, this value is 0. Indicates if the object is associated with data set 1 or 2. This is an updatable column. The number of entries, including duplicate entries, in the index space or partition. A null value indicates that the number of entries is unknown. The name of the database. The name of the index. The schema of the index. The name of the index space. The date when the index is used for SELECT, FETCH, searched UPDATE, searched DELETE, or used to enforce 259

®

DB2 9 z/OS Reference Guide referential integrity constraints. The default value is 1/1/0001.

SYSIBM.SYSINDEXSTATS Contains one row for each partition of a partitioning index or a data partitioned secondary index. Rows in this table can be inserted, updated, and deleted. Column Name FIRSTKEYCARD

Data Type INTEGER

FULLKEYCARD NLEAF NLEVELS CLUSTERRATIO

INTEGER INTEGER SMALLINT SMALLINT

STATSTIME

TIMESTAMP

IBMREQD

CHAR(1)

PARTITION OWNER NAME KEYCOUNT FIRSTKEYCARDF

SMALLINT VARCHAR(128) VARCHAR(128) INTEGER FLOAT

FULLKEYCARDF KEYCOUNTF CLUSTERRATIOF

FLOAT FLOAT FLOAT

DATAREPEAT FACTORF

FLOAT

Description For the index partition, number of distinct values of the first key column. For the index partition, number of distinct values of the key. Number of active leaf pages in the index partition. Number of levels in the partition index tree. For the index partition, the percentage of rows that are in clustering order. The value is 0 if statistics have not been gathered. If RUNSTATS updated the statistics, the date and time when the last invocation of RUNSTATS updated the statistics. The default value is '0001-01-01.00.00.00.000000'. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Partition number of the index. Schema of the owner of the index. Name of the index. Total number of rows in the partition. For the index partition, number of distinct values of the first key column. For the index partition, number of distinct values of the key. Total number of rows in the partition. For the index partition, the value, when multiplied by 100, is the percentage of rows that are in clustering order. For example, a value of .9125 indicates 91.25%. The value is 0 if statistics have not been gathered. The anticipated number of data pages that will be touched following an index key order. This statistic is only collected when the STATCLUS subsystem parameter is set to ENHANCED. This number is -1 if statistics have not been collected. The valid value is -1 or any value that is equal to or greater than 1. This is an updatable column.

SYSIBM.SYSINDEXSTATS_HIST Contains rows from SYSINDEXSTATS. Whenever rows are added or changed in SYSINDEXSTATS, the rows are also written to the new history table. Rows in this table can be inserted, updated, and deleted. Column Name NLEAF

Data Type INTEGER

NLEVELS

SMALLINT

STATSTIME

TIMESTAMP

260

Description Number of active leaf pages in the index partition. The value is -1 if statistics have not been gathered. Number of levels in the partition index tree. The value is -1 if statistics have not been gathered. If RUNSTATS updated the statistics, the date and time when the last invocation of RUNSTATS updated the statistics. ®

DB2 9 for z/OS

®


Data Type

PARTITION OWNER NAME FIRSTKEYCARDF

SMALLINT VARCHAR(128) VARCHAR(128) FLOAT

FULLKEYCARDF

FLOAT

KEYCOUNTF

FLOAT

CLUSTERRATIOF

FLOAT

IBMREQD

CHAR(1)

DATAREPEAT FACTORF

FLOAT

Description The default value is '0001-01-01.00.00.00.000000'. Partition number of the index. Schema of the owner of the index. Name of the index. For the index partition, number of distinct values of the first key column. The value is -1 if statistics have not been gathered. For the index partition, number of distinct values of the key. The value is -1 if statistics have not been gathered. Total number of rows in the partition. The value is -1 if statistics have not been gathered. For the index partition, the value, when multiplied by 100, is the percentage of rows that are in clustering order. For example, a value of .9125 indicates 91.25%. The value is 0 if statistics have not been gathered. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. The anticipated number of data pages that will be touched following an index key order. This statistic is only collected when the STATCLUS subsystem parameter is set to ENHANCED. This number is -1 if statistics have not been collected. The valid value is -1 or any value that is equal to or greater than 1. This is an updatable column.

SYSIBM.SYSJARCLASS_SOURCE Auxiliary table for SYSIBM.SYSCONTENTS, which contains the source code for a Java stored procedure. Column Name CLASS_SOURCE

Data Type CLOB(10M)

Description The contents of the class in the jar file.

SYSIBM.SYSJARCONTENTS Contains Java class source for installed jar. Column Name JARSCHEMA JAR_ID CLASS CLASS_SOURCE_ROWID CLASS_SOURCE IBMREQD

Data Type VARCHAR(128) VARCHAR(128) VARCHAR(384) ROWID CLOB(10M) CHAR(1)

Description The schema of the jar file. The name of the jar file. The class name contained in the jar file. ID used to support CLOB data type. The contents of the class in the jar file. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape.

SYSIBM.SYSJARDATA Auxiliary table for SYSIBM.SYSJAROBJECTS. Column Name JAR_DATA

®

DB2 9 for z/OS

Data Type BLOB(100M)

Description The contents of the jar file.

261

®


SYSIBM.SYSJAROBJECTS Contains binary large object representing the installed jar. Column Name JARSCHEMA JAR_ID OWNER JAR_DATA_ROWID JAR_DATA PATH

Data Type VARCHAR(128) VARCHAR(128) VARCHAR(128) ROWID BLOB(100M) VARCHAR(2048)

IBMREQD

CHAR(1)

CREATEDTS ALTEREDTS OWNERTYPE

TIMESTAMP TIMESTAMP CHAR(1)

Description The schema of the jar file. The name of the jar file. Authorization ID of the owner of the jar object. ID used to support BLOB data type. The contents of the jar file. This is an updatable column. The URL path of the source jar file. This is an updatable column. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. Time when the JAR object was created. Time when the JAR object was altered. Indicates the type of owner: blank Authorization ID L Role

SYSIBM.SYSJAVAOPTS Contains build options used during INSTALL_JAR. Column Name JARSCHEMA JAR_ID BUILDSCHEMA BUILDNAME BUILDOWNER DBMLIB HPJCOMPILE_OPTS BIND_OPTS POBJECT_LIB IBMREQD

Data Type VARCHAR(128) VARCHAR(128) VARCHAR(128) VARCHAR(128) VARCHAR(128) VARCHAR(256) VARCHAR(512) VARCHAR(2048) VARCHAR(256) CHAR(1)

Description The schema of the jar file. The name of the jar file. Schema name for BUILDNAME. Procedure used to create the routine. Authorization ID used to create the routine. PDS name where DBRM is located. HPJ compile options used to install the routine. Bind options used to install the routine. PDSE name where program object is located. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape.

SYSIBM.SYSJAVAPATHS Contains the complete JAR class resolution path, and records the dependencies that one JAR has on the JARs in its Java path. Column Name JARSCHEMA JAR_ID OWNER ORDINAL


PE_CLASS_PATTERN

VARCHAR(2048)

PE_JARSCHEMA

VARCHAR(128)

262

Description The schema of the JAR file. The name of the JAR file. Authorization ID of the owner of the JAR object. The ordinal number of the path element within the JAR’s Java path. The pattern for the names of the classes that are to be searched for in this path element’s JAR file. The schema of this path element’s JAR file. ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide PE_JAR_ID IBMREQD


The name of this path element’s JAR file. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape.

SYSIBM.SYSKEYCOLUSE Contains a row for every column in a unique constraint (primary key or unique key) from the SYSIBM.SYSTABCONST table. Column Name CONSTNAME TBCREATOR


TBNAME COLNAME COLSEQ

VARCHAR(128) VARCHAR(128) SMALLINT

COLNO

SMALLINT

IBMREQD

CHAR(1)

Description Name of the constraint. Authorization ID of the owner of the table on which the constraint is defined. Name of the table on which the constraint is defined. Name of the column. Numeric position of the column in the key (the first position in the key is 1). Numeric position of the column in the table on which the constraint is defined. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape.

SYSIBM.SYSKEYS Contains one row for each column of an index key. Column Name IXNAME IXCREATOR COLNAME COLNO


COLSEQ

SMALLINT

ORDERING

CHAR(1)

IBMREQD

CHAR(1)

Description Name of the index. Authorization ID of the owner of the index. Name of the column of the key. Numeric position of the column in the table; for example, 4 (out of 10). Numeric position of the column in the key; for example, 4 (out of 4). This value is meaningless for an index that is based on an expression. Order of the column in the key: Blank index is based on an expression A Ascending D Descending R Random Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes

SYSIBM.SYSKEYTARGETS Contains one row for each key-target that is participating in an extended index definition. Column Name IXNAME IXSCHEMA KEYSEQ COLNO ®

DB2 9 for z/OS

Data Type VARCHAR(128) VARCHAR(128) SMALLINT SMALLINT

Description Qualifier of the index. Numeric position of the key-target in the index. Numeric position of the key-target in the index. Numeric position of the column in the table if the expression is a single column. 263

®

DB2 9 z/OS Reference Guide ORDERING

CHAR(1)

TYPESCHEMA TYPENAME DATATYPEID SOURCETYPEID

VARCHAR(128) VARCHAR(128) INTEGER INTEGER

LENGTH

SMALLINT

LENGTH2

INTEGER

SCALE

SMALLINT

NULLS

CHAR(1)

CCSID

INTEGER

SUBTYPE

CHAR(1)

CREATEDTS RELCREATED IBMREQD

TIMESTAMP CHAR(1) CHAR(1)

DERIVED_FROM

VARCHAR(4000)

264

Order of the key: A Ascending Schema of the data type. Name of the data type. The internal ID of the data type. For a built-in data type, this column contains 0. For a distinct type, this column contains the internal ID of the built-in type on which the distinct type is based. The length attribute of the key-target or its precision for a decimal key-target. The number does not include the internal prefixes that are used to record the actual length and null states, when applicable. Data type Value of the LENGTH column INTEGER 4 SMALLINT 2 FLOAT 4 or 8 CHAR The length of the string VARCHAR The maximum length of the string DECIMAL The precision of the number GRAPHIC The number of DBCS characters VARGRAPHIC The maximum number of DBCS characters DATE 4 TIME 3 TIMESTAMP 10 BIGINT 8 BINARY The length of the string VARBINARY The maximum length of the string DECFLOAT 8 or 16 The maximum length of the data that is retrieved from the column. Possible values include the following values: 0 Not a ROWID column 40 For a ROWID The scale of decimal data. SCALE contains 0 if the key is not a decimal key. Whether the key can contain null values: N No Y Yes. Y also indicates that the index is an XML index. The CCSID of the key. CCSID contains 0 if the key is a noncharacter type key. SUBTYPE applies to character keys only and indicated the subtype of the data: B BIT data M MIXED data S SBCS data blank non-character data The timestamp for when the key-target is created. The release of DB2 in which the key-target is created. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. For an index on a scalar expression, DERIVED_FROM contains the text of the scalar expression that is used to generated the key-target value. For an XML index, this is the XML pattern that is used to generate the key-target value. Otherwise DERIVED_FROM contains an empty string. ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide STATSTIME

TIMESTAMP

CARDF HIGH2KEY

FLOAT VARCHAR(2000)

LOW2KEY

VARCHAR(2000)

STATS_FORMAT

CHAR(1)

The timestamp of the most recent RUNSTATS. The default value is '0001-01-01.00.00.00.000000'. STATSTIME is an updatable column. The number of distinct values for the key-target. The second highest key-value. HIGH2KEY is an updatable column. The second lowest key-value. LOW2KEY is an updatable column. The type of statistics that are gathered: N VARCHAR column statistical values are not padded blank Statistics have not been collects or VARCHAR column statistical values are padded STATS_FORMAT is an updatable column.

SYSIBM.SYSKEYTARGETSTATS The SYSIBM.SYSKEYTARGETSTATS table contains partition statistics for selected keytargets. For each key-target, a row exists for each partition in the table. Rows are inserted when RUNSTATS collects indexed key statistics or non-indexed key statistics for a partitioned table space. No row is inserted if the table space is non-partitioned. Rows in this table can be inserted, updated, and deleted. Column Name IXSCHEMA IXNAME KEYSEQ HIGHKEY HIGH2KEY LOWKEY LOW2KEY PARTITION STATSTIME

Data Type VARCHAR(128) VARCHAR(128) SMALLINT VARCHAR(2000) VARCHAR(2000) VARCHAR(2000) VARCHAR(2000) SMALLINT TIMESTAMP

IBMREQD

CHAR(1)

STATS_FORMAT CARDF

FLOAT FLOAT

Description The qualifier of the index. The name of the index. Numeric position of the key-target in the index. The highest key value. The second highest key-value. The lowest key value. The second lowest key-value. The partition number of the table space. The timestamp of the most recent RUNSTATS. The default value is '0001-01-01.00.00.00.000000'. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. Number of distinct values for the key target. Number of distinct values for the key target.

SYSIBM.SYSKEYTARGETS_HIST Contains rows from the SYSKEYTARGETS table. Whenever rows are added or changed in SYSKEYTARGETS, the rows are also written to this table. Rows in this table can be inserted, updated, and deleted. Column Name IXNAME IXSCHEMA KEYSEQ TYPESCHEMA TYPENAME DATATYPEID ®

DB2 9 for z/OS

Data Type VARCHAR(128) VARCHAR(128) SMALLINT VARCHAR(128) VARCHAR(128) INTEGER

Description Name of the index. Qualifier of the index. Numeric position of the key-target in the index. Schema of the data type. Name of the data type. The internal ID of the data type. 265

®

DB2 9 z/OS Reference Guide SOURCETYPEID

INTEGER

LENGTH

SMALLINT

LENGTH2

INTEGER

SCALE

SMALLINT

For a built-in data type, this field contains 0. For a distinct type, this field contains the internal ID of the built-in type on which the distinct type is based. Length attribute of the column or, in the case of a decimal column, its precision. The number does not include the internal prefixes that are used to record the actual length and null state, where applicable. INTEGER 4 SMALLINT 2 FLOAT 4 or 8 CHAR Length of string VARCHAR Maximum length of string LONGVAR Maximum length of string (prior to V9) DECIMAL Precision of number GRAPHIC Number of DBCS characters VARGRAPHIC Maximum number of DBCS char.(prior to V9) LONGVARG Maximum number of DBCS characters DATE 4 TIME 3 TIMESTMP 10 BLOB 4 – The length of the field that is stored in the base table. The maximum length of the LOB column is found in LENGTH2 CLOB 4 – The length of the field that is stored in the base table. The maximum length of the CLOB column is found in LENGTH2 DBCLOB 4 – The length of the field that is stored in the base table. The maximum length of the CLOB column is found in LENGTH2 ROWID 17 – The maximum length of the stored portion of the identifier DISTINCT The length of the source data type XML 6 BIGINT 8 BINARY Length of String VARBINARY Maximum length of string DECFLOAT 8 or 16 The maximum length of the data that is retrieved from the column. Possible values include the following values: 0 Not a ROWID column 40 For a ROWID column, the length of the value that is returned The scale of decimal data. SCALE contains 0 if the key is not a decimal key.

SYSIBM.SYSKEYTGTDIST The SYSIBM.SYSKEYTGTDIST table contains one or more rows for the first key-target of an extended index key. Rows in this table can be inserted, updated, and deleted. Column Name STATSTIME

266

Data Type TIMESTAMP

Description If the RUNSTATS utility updated the statistics, this column contains the date and time when the last invocation of RUNSTATS updated the statistics. The default value is ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide IBMREQD IXSCHEMA IXNAME KEYSEQ KEYVALUE

CHAR(1) VARCHAR(128) VARCHAR(128) SMALLINT VARCHAR(2000)

TYPE

CARDF

FLOAT

KEYGROUPKEYNO

VARCHAR(254)

NUMKEYS FREQUENCYF

SMALLINT FLOAT

QUANTILENO

SMALLINT

LOWVALUE

VARCHAR(2000)

HIGHVALUE

VARCHAR(2000)

'0001-01-01.00.00.00.000000'. The qualifier of the index. The name of the index. The numeric position of the key-target in the index. The numeric position of the key-target in the index. KEYVALUE contains the data of a frequently occurring value. If the value has a non-character data type, the data might not be printable. The type of statistics that are gathered: C Cardinality F Frequent value N Non-padded frequent value H Histogram statistics When TYPE='C', CARDF contains the number of distinct values for the key group. When TYPE='H', CARDF contains the number of distinct values for the key group in a quantile indicated by QUANTILENO. KEYGROUPKEYNO contains a value that identifies the set of keys that are associated with the statistics. KEYGROUPKEYNO contains 0 if the statistics are only associated with a single key. If the statistics are associated with more than a single key, KEYGROUPKEYNO contains an array of SMALLINT key numbers with The number of keys that are associated with the statistics. When TYPE='F' or 'N', FREQUENCYF contains the percentage of entries in the index that have the value that is specified in KEYVALUE when the number of entries is multiplied by 100. For example, a value of 1 indicates 100 percent. A value of .153 indicates 15.3 percent. When TYPE='H', FREQUENCYF contains the percentage of entries in the index that have a value that is in the range of the quantile that is indicated in QUALTILENO. QUANTILENO contains an ordinary sequence number of a quantile in the whole consecutive value range, from low to high. When TYPE='H', LOWVALUE contains the lower bound for the quantile that is in QUANTILENO. LOWVALUE is not used if TYPE does not equal 'H'. When TYPE='H', HIGHVALUE contains the upper bound for the quantile that is in QUANTILENO. HIGHVALUE is not used if TYPE does not equal 'H'.

SYSIBM.SYSKEYTGTDISTSTATS The SYSIBM.SYSKEYTGTDISTSTATS table contains zero or more rows per partition for the first key-target of a data-partitioned secondary index. Rows are inserted when RUNSTATS scans a data-partitioned secondary index. No row is inserted if the index is a secondary index. Rows in this table can be inserted, updated, and deleted. Column Name STATSTIME ®

DB2 9 for z/OS

Data Type TIMESTAMP

Description If RUNSTATS updated the statistics, STATSTIME contains the 267

®


IBMREQD

CHAR(1)

PARTITION

SMALLINT

IXSCHEMA IXNAME KEYSEQ KEYVALUE

VARCHAR(128) VARCHAR(128) SMALLINT VARCHAR(2000)

TYPE

CHAR(1)

CARDF

FLOAT

KEYGROUPKE YNO

VARCHAR(254)

NUMKEYS

SMALLINT

FREQUENCYF

FLOAT

QUANTILENO

SMALLINT

LOWVALUE

VARCHAR(2000)

HIGHVALUE

VARCHAR(2000)

timestamp of the most recent RUNSTATS. The default value is '0001-01-01.00.00.00.000000'. A value of Y indicates that the row came from the basic machinereadable material (MRM) tape. The partition number of the table space that contains the index in which the key is defined. The qualifier of the index. The name of the index. Numeric position of the key-target in the index. KEYVALUE contains the data of a frequently occurring value. If the value has a non-character data type, the data might not be printable. The type of statistics that are gathered: C Cardinality F Frequent value N Non-padded frequent value H Histogram statistics When TYPE='C', CARDF contains the number of distinct values for the key group. When TYPE='H', CARDF contains the number of distinct values for the key group in the quantile that is in QUANTILENO. Identifies the set of keys that are associated with the statistics. If the statistics are only associated with a single key, KEYGROUPKEYNO contains a zero length value. Otherwise, KEYGROUPKEYNO contains an array of SMALLINT key numbers that have a dimension that is equal to the value in NUMKEYS. Identifies the number of keys that are associated with the statistics. When TYPE='F' or 'N', FREQUENCYF contains the percentage of entries in the index that have the value that is specified in KEYVALUE when the number of entries is multiplied by 100. For example, a value of 1 indicates 100 percent. A value of .153 indicates 15.3 percent. When TYPE='H', FREQUENCYF contains the percentage of entries in the index that have a value that is in the range of the quantile that is indicated in QUALTILENO. QUANTILENO contains an ordinary sequence number of a quantile in the whole consecutive value range, from low to high. When TYPE='H', LOWVALUE is the lower bound for the quantile that is indicated in QUANTILENO. LOWVALUE is not used if TYPE does not equal 'H'. When TYPE='H', HIGHVALUE is the upper bound for the quantile that is indicated in QUANTILENO. HIGHVALUE is not used if TYPE does not equal 'H'.

SYSIBM.SYSKEYTGTDIST_HIST The SYSIBM.SYSKEYTGTDIST_HIST table contains rows from the SYSKEYTGTDIST table. Whenever rows are added or changed in SYSKEYTGTDIST, the rows are also written to this table. Rows in this table can be inserted, updated, and deleted. Column Name STATSTIME 268

Data Type TIMESTAMP

Description If the RUNSTATS utility updated the statistics, this column contains the date and time when the last invocation of RUNSTATS ®

DB2 9 for z/OS

®


IBMREQD

CHAR(1)

IXSCHEMA IXNAME KEYSEQ KEYVALUE

VARCHAR(128) VARCHAR(128) SMALLINT VARCHAR(2000)

TYPE

CHAR(1)

CARDF

FLOAT

KEYGROUPKE YNO

VARCHAR(254)

NUMKEYS FREQUENCYF

SMALLINT FLOAT

QUANTILENO

SMALLINT

LOWVALUE

VARCHAR(2000)

HIGHVALUE

VARCHAR(2000)

updated the statistics. The default value is '0001-0101.00.00.00.000000'. A value of Y indicates that the row came from the basic machinereadable material (MRM) tape. The qualifier of the index. The name of the index. The numeric position of the key-target in the index. KEYVALUE contains the data of a frequently occurring value. If the value has a non-character data type, the data might not be printable. The type of statistics that are gathered: C Cardinality F Frequent value N Non-padded frequent value H Histogram statistics When TYPE='C', CARDF contains the number of distinct values for the key group. When TYPE='H', CARDF contains the number of distinct values for the key group in a quantile indicated by QUANTILENO. KEYGROUPKEYNO contains a value that identifies the set of keys that are associated with the statistics. KEYGROUPKEYNO contains 0 if the statistics are only associated with a single key. If the statistics are associated with more than a single key, KEYGROUPKEYNO contains an array of SMALLINT key numbers with a dimension that is equal to the value in NUMKEYS. The number of keys that are associated with the statistics. When TYPE='F' or 'N', FREQUENCYF contains the percentage of entries in the index that have the value that is specified in KEYVALUE when the number of entries is multiplied by 100. For example, a value of 1 indicates 100 percent. A value of .153 indicates 15.3 percent. When TYPE='H', FREQUENCYF contains the percentage of entries in the index that have a value that is in the range of the quantile that is indicated in QUALTILENO. QUANTILENO contains an ordinary sequence number of a quantile in the whole consecutive value range, from low to high. When TYPE='H', LOWVALUE contains the lower bound for the quantile that is in QUANTILENO. LOWVALUE is not used if TYPE does not equal 'H'. When TYPE='H', HIGHVALUE contains the upper bound for the quantile that is in QUANTILENO. HIGHVALUE is not used if TYPE does not equal 'H'.

SYSIBM.SYSLOBSTATS Contains one row for each LOB tablespace. Column Name STATSTIME AVGSIZE FREESPACE ORGRATIO

Data Type TIMESTAMP INTEGER INTEGER DECIMAL(5,2)

DBNAME

CHAR(8)

®

DB2 9 for z/OS

Description Timestamp of RUNSTATS statistics update. Average size of a LOB, measured in bytes, in the LOB tablespace. Number of kilobytes of available space in the LOB tablespace. Ratio of organization in the LOB tablespace. A value of 1 indicates perfect organization of the LOB tablespace. The greater the value exceeds 1, the more disorganized the LOB tablespace. Name of the database that contains the LOB tablespace named in NAME. 269

®

DB2 9 z/OS Reference Guide Column Name NAME IBMREQD

Data Type CHAR(8) CHAR(1)

Description Name of the LOB tablespace. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes

SYSIBM.SYSLOBSTATS_HIST Contains rows from SYSLOBSTATS. Whenever rows are added or changed in SYSLOBSTATS, the rows are also written to the new history table. Rows in this table can be inserted, updated, and deleted. Column Name STATSTIME FREESPACE ORGRATIO

Data Type TIMESTAMP INTEGER DECIMAL(5,2)

DBNAME

VARCHAR(24)

NAME IBMREQD

VARCHAR(24) CHAR(1)

Description Timestamp of RUNSTATS statistics update. Number of kilobytes of available space in the LOB tablespace. Ratio of organization in the LOB tablespace. A value of 1 indicates perfect organization of the LOB tablespace. The greater the value exceeds 1, the more disorganized the LOB tablespace. Name of the database that contains the LOB tablespace named in NAME. Name of the LOB tablespace. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes

SYSIBM.SYSOBJROLEDEP

Contains the dependent objects for each role. Column Name DEFINER DEFINERTYPE

Data Type VARCHAR(128) CHAR(1)

ROLENAME DSCHEMA DNAME DTYPE


IBMREQD

CHAR(1)

270

Description The authorization ID or role that created the object. The type of definer: L Role blank Authorization ID Name of the role on which there is a dependency. Name of the schema of the dependent object. Name of the dependent object. The type of the dependent object in DNAME: A Alias B Trigger D Database E Distinct type F User-defined function I Index J Jar L Role M Materialized query table N Trusted context O Stored procedure Q Sequence R Table space S Storage group T Table V View A value of Y indicates that the row came from the basic ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide machine-readable material (MRM) tape.

SYSIBM.SYSPACKAGE Contains a row for every package. Column Name LOCATION COLLID


NAME CONTOKEN


OWNER

VARCHAR(128)

CREATOR

VARCHAR(128)

TIMESTAMP BINDTIME QUALIFIER

TIMESTAMP TIMESTAMP VARCHAR(128)

PKSIZE

INTEGER

AVGSIZE

INTEGER

SYSENTRIES

SMALLINT

VALID

CHAR(1)

OPERATIVE

CHAR(1)

®

DB2 9 for z/OS

Description Always contains blanks. Name of the package collection. For a trigger package, it is the schema name of the trigger. Name of the package. Consistency token for the package. For a package derived from a DB2 DBRM, this is either: o The "level" as specified by the LEVEL option when the package's program was precompiled o The timestamp indicating when the package's program was precompiled, in an internal format. Authorization ID of the package owner. For a trigger package, the value is the authorization ID of the owner of the trigger, which is set to the current authorization ID (the plan or package owner for static CREATE TRIGGER statement; the current SQLID for a dynamic CREATE TRIGGER statement). Authorization ID of the owner of the creator of the package version. For a trigger package the value is determined differently. For dynamic SQL, it is the primary authorization ID of the user who issued the CREATE TRIGGER statement. For static SQL, it is the authorization ID of the plan or package owner. Timestamp indicating when the package was created. Timestamp indicating when the package was last bound. Implicit qualifier for the unqualified table, view, index, and alias names in the static SQL statements of the package. Size of the base section of the package, in bytes. Average size, in bytes, of those sections of the plan that contain SQL statements processed at bind time. Number of enabled or disabled entries for this package in SYSIBM.SYSPKSYSTEM. A value of 0 if all types of connections are enabled. Whether the package is valid: A The ALTER statement changed the description of the table or base table of a view referred to by the package. For a CREATE INDEX statement involving data sharing, VALID is also marked as “A”. The changes do not invalidate the package. H The ALTER TABLE statement changed the description of the table or base table of a view referred to by the package. For releases of DB2 prior to V5R1, the change invalidates the package. N No Y Yes Whether the package can be allocated: 271

®


Data Type

VALIDATE

CHAR(1)

ISOLATION

CHAR(1)

RELEASE

CHAR(1)

EXPLAIN

CHAR(1)

QUOTE

CHAR(1)

COMMA

CHAR(1)

HOSTLANG

CHAR(1)

CHARSET

CHAR(1)

MIXED

CHAR(1)

DEC31

CHAR(1)

272

Description N No; an explicit BIND or REBIND is required before the package can be allocated. Y Yes Whether validity checking can be deferred until run time: B All checking must be performed at bind time. R Validation is done at run time for tables, views, and privileges that do not exist at bind time. Isolation level when the package was last bound or rebound R RR (repeatable read) S CS (cursor stability) T RS (read stability) U UR (uncommitted read) blank Not specified, and therefore at the level specified for the plan executing the package The value used for RELEASE when the package was last bound or rebound: C Value used was COMMIT. D Value used was DEALLOCATE. blank Not specified, and therefore the value specified for the plan executing the package. EXPLAIN option specified for the package; that is, whether information on the package's statements was added to the owner of the PLAN_TABLE table: N No Y Yes SQL string delimiter for SQL statements in the package: N Apostrophe Y Quotation mark Decimal point representation for SQL statements in package: N Period Y Comma Host language for the package's DBRM: B Assembler language C OS/VS COBOL D C F Fortran P PL/I 2 VS COBOL II or IBM COBOL Release 1 (formerly called COBOL/370(TM)) 3 IBM COBOL (Release 2 or subsequent releases) 4 C++ blank For remotely bound packages, or trigger packages (TYPE='T') Indicates whether the system CCSID for SBCS data was 290 (Katakana) when the program was precompiled: K Yes A No Indicates if mixed data was in effect when the package's program was precompiled. N No Y Yes Indicates whether DEC31 was in effect when the package's program was precompiled. ®

DB2 9 for z/OS

®


Data Type

DEFERPREP

CHAR(1)

SQLERROR

CHAR(1)

REMOTE

CHAR(1)

PCTIMESTAMP

TIMESTAMP

IBMREQD

CHAR(1)

VERSION

VARCHAR(122)

PDSNAME

VARCHAR(132)

DEGREE

CHAR(3)

GROUP_MEMBER

VARCHAR(24)

DYNAMICRULES

CHAR(1)

®

DB2 9 for z/OS

Description N No Y Yes Indicates the CURRENTDATA option when the package was bound or rebound: A Data currency is required for all cursors. Inhibit blocking for all cursors. B Data currency is not required for ambiguous cursors. C Data currency is required for ambiguous cursors. blank The package was created before the CURRENTDATA option was available. Indicates the SQLERROR option on the most recent subcommand that bound or rebound the package: C CONTINUE N NOPACKAGE Source of the package: C Package was created by BIND COPY. D Package was created by BIND COPY with the OPTIONS(COMMAND) option. K The package was copied from a package that was originally bound on behalf of a remote requester. L The package was copied with the OPTIONS(COMMAND) option from a package that was originally bound on behalf of a remote requester. N Package was locally bound from a DBRM. Y Package was bound on behalf of a remote requester. Date and time the application program was precompiled, or 0001-01-01-00.00.00.000000 if the LEVEL precompiler option was used, or if the package came from a non-DB2 location. Whether the row came from the basic machine-readable material (MRM) tape: N=No , Y=Yes Version identifier for the package. The value is blank for a trigger package (TYPE='T'). For a locally bound package, the name of the PDS (library) in which the package's DBRM is a member. For a locally copied package, the value in SYSPACKAGE.PDSNAME for the source package. Otherwise, the product signature of the bind requester followed by one of the following: o The requester's location name if the product is DB2 o Otherwise, the requester' LU name enclosed in angle brackets; for example, "." The DEGREE option used when the package was last bound: ANY DEGREE(ANY) 1 or blank DEGREE(1) Blank if the package was migrated. The DB2 data-sharing member name of the DB2 subsystem that performed the most recent bind. This column is blank if the DB2 subsystem was not in a DB2 data-sharing environment when the bind was performed. The DYNAMICRULES option used when the package was last bound: B BIND. Dynamic SQL statements are executed with DYNAMICRULES bind behavior. D DEFINEBIND. When the package is run under 273

®


Data Type

REOPTVAR

CHAR(1)

DEFERPREPARE

CHAR(1)

274

Description an active stored procedure or user-defined function, dynamic SQL statements in the package are executed with DYNAMICRULES define behavior. When the package is not run under an active stored procedure or user-defined functions, dynamic SQL statements in the package are executed with DYNAMICRULES bind behavior. E DEFINERUN. When the package is run under an active stored procedure or user-defined function, dynamic SQL statements in the package are executed with DYNAMICRULES define behavior. When the package is not run under an active stored procedure or user-defined function, dynamic SQL statements in the package are executed with DYNAMICRULES run behavior. H INVOKEBIND. When the package is run under an active stored procedure or user-defined function, dynamic SQL statements in the package are executed with DYNAMICRULES invoke behavior. When the package is not run under an active stored procedure or user-defined function, dynamic SQL statements in the package are executed with DYNAMICRULES bind behavior. I INVOKERUN. When the package is run under an active stored procedure or user-defined function, dynamic SQL statements in the package are executed with DYNAMICRULES invoke behavior. When the package is not run under an active stored procedure or user-defined function, dynamic SQL statements in the package are executed with DYNAMICRULES run behavior. R RUN. Dynamic SQL statements are executed with DYNAMICRULES run behavior. blank DYNAMICRULES is not specified for the package. The package uses the DYNAMICRULES value of the plan to which the package is appended at execution time. Whether the access path is determined again at execution time using input variable values: A Bind option REOPT(AUTO) indicates that the access path is determined multiple times at execution time depending on the parameter value. N Bind option REOPT(NONE) indicates that the access path is determined at bind time. Y Bind option REOPT(ALWAYS) indicates that the access path is determined at execution time for SQL statements with variable values. 1 Bind option REOPT(ONCE) indicates that the access path is determined only once at execution time, using the first set of input variable values, regardless of how many times the same statement is executed. Whether PREPARE processing is deferred until OPEN is ®

DB2 9 for z/OS

®


Data Type

KEEPDYNAMIC

CHAR(1)

PATHSCHEMAS

VARCHAR(2048)

TYPE

CHAR(1)

DBPROTOCOL

CHAR(1)

FUNCTIONTS

TIMESTAMP

OPTHINT

VARCHAR(128)

ENCODING_CCSID

INTEGER

IMMEDWRITE

CHAR(1)

®

DB2 9 for z/OS

Description executed: N Bind option NODEFER(PREPARE) indicates that PREPARE processing is not deferred until OPEN is executed. Y Bind option DEFER(PREPARE) indicates that PREPARE processing is deferred until OPEN is executed. blank Bind option not specified for the package. It is inherited from the plan. Whether prepared dynamic statements are to be purged at each commit point: N The bind option is KEEPDYNAMIC(NO). Prepared dynamic SQL statements are destroyed at commit. Y The bind option is KEEPDYNAMIC(YES). Prepared dynamic SQL statements are kept past commit. SQL path specified on the BIND or REBIND command that bound the package. The path is used to resolve unqualified data type, function, and stored procedure names used in certain contexts. If the PATH bind option was not specified, the value in the column is a zero length string; however, DB2 uses a default SQL path of: SYSIBM, SYSFUN, SYSPROC, package qualifier. Type of package. Identifies how the package was created: blank BIND PACKAGE command created the package. T CREATE TRIGGER statement created the package, and the package is a trigger package. N CREATE PROCEDURE or ALTER PROCEDURE statement, or BIND PACKAGE DEPLOY command created the package, and this package is a native SQL routine package. Whether remote access for SQL with three-part names is implemented with DRDA or DB2 private protocol access: D DRDA P DB2 private protocol Timestamp when the function was resolved. Set by the BIND and REBIND commands, but not by AUTOBIND. Value of the OPTHINT bind option. Identifies rows in the authid.PLAN_TABLE to be used as input to the optimizer. Contains blanks if no rows in the authid.PLAN_TABLE are to be used as input. The CCSID corresponding to the encoding scheme or CCSID as specified for the bind option ENCODING. The encoding scheme specified on the bind command: CCSID The specified or derived CCSID 0 The EBCDIC default CCSID as specified on panel DSNTIPF at installation time. Indicates when writes of updated group bufferpool dependent pages are to be done. This option is only applicable for datasharing environments. N Bind option IMMEDWRITE(NO) indicates normal write activity is done. Y Bind option IMMEDWRITE(YES) indicates that immediate writes are done for updated group buffer pool dependent pages. 1 Bind option IMMEDWRITE(PH1) indicates that 275

®


Data Type

RELBOUND

CHAR(1)

REMARKS

VARCHAR(762)

OWNERTYPE ROUNDING

CHAR(1) CHAR(1)

Description updated group bufferpool dependent pages are written at or before phase 1 commit. The release when the package was bound or rebound. blank Bound prior to V7 K Bound on V7 A character string provided by the user with the COMMENT statement. Indicates the type of owner blank Authorization ID L Role The ROUNDING option used when the package was last bound: C ROUND_CEILING D ROUND_DOWN F ROUND_FLOOR G ROUND_HALF_DOWN E ROUND_HALF_EVEN H ROUND_HALF_UP U ROUND_UP blank The package created in a DB2 release prior to Version 9

SYSIBM.SYSPACKAUTH Records the privileges that are held by users over packages. Column Name GRANTOR


GRANTEE

VARCHAR(128)

LOCATION COLLID


NAME

VARCHAR(128)

TIMESTAMP GRANTEETYPE

TIMESTAMP CHAR(1)

AUTHHOWGOT

CHAR(1)

BINDAUTH

CHAR(1)

276

Description Authorization ID of the user who granted the privilege. Could also be PUBLIC or PUBLIC followed by an asterisk. Authorization ID of the user who holds the privileges, the name of a plan that uses the privileges or PUBLIC for a grant to PUBLIC. Always contains blanks. Collection name for the package or packages on which the privilege was granted. Name of the package on which the privileges are held. An asterisk (*) if the privileges are held on all packages in a collection. Timestamp indicating when the privilege was granted. Type of grantee: blank An authorization ID L Role P An application plan Authorization level of the user from whom the privileges were received. This authorization level is not necessarily the highest authorization level of the grantor. blank Not applicable A PACKADM (on collection *) C DBCTL D DBADM L SYSCTRL M DBMAINT P PACKADM (on a specific collection) S SYSADM Whether GRANTEE can use the BIND and REBIND subcommands against the package: ®

DB2 9 for z/OS

®


Data Type

COPYAUTH

CHAR(1)

EXECUTEAUTH

CHAR(1)

IBMREQD

CHAR(1)

GRANTORTYPE

CHAR(1)

Description blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether GRANTEE can COPY the package: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether GRANTEE can execute the package: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Indicates the type of grantor: blank Authorization ID L Role

SYSIBM.SYSPACKDEP Records the dependencies of packages on local tables, views, synonyms, tablespaces, indexes, aliases, functions, and stored procedures. Column Name BNAME BQUALIFIER


BTYPE

CHAR(1)

DLOCATION DCOLLID DNAME DCONTOKEN


®

DB2 9 for z/OS

Description The name of an object that a package depends on. The value of the column depends on the type of object: • If BNAME identifies a table space (BTYPE is R), the value is the name of its database. • If BNAME identifies user-defined function, a cast function, a stored procedure, or a sequence (BTYPE is F, O, or Q), the value is the schema name. • If BNAME identifies a role, the value is blank. • Otherwise, the value is the schema of BNAME. Type of object identified by BNAME and BQUALIFIER: A Alias E INSTEAD OF trigger F User-defined function or cast function G Global temporary table I Index M Materialized query table O Stored procedure P Partitioned tablespace Q Sequence object R Tablespace S Synonym T Table V View Always contains blanks Name of the package collection. Name of the package. Consistency token for the package. This is either: o The "level" as specified by the LEVEL option when the package's program was precompiled 277

®


Data Type

IBMREQD

CHAR(1)

DOWNER DTYPE


DOWNERTYPE

CHAR(1)

Description o The timestamp indicating when the package's program was precompiled, in an internal format. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Owner of the package. Type of package: T Trigger package N Native SQL routine package blank Not a trigger package Indicates the type of owner of the package: blank Authorization ID L Role

SYSIBM.SYSPACKLIST Contains one or more rows for every local application plan bound with a package list. Each row represents a unique entry in the plan's package list. Column Name PLANNAME SEQNO LOCATION

Data Type VARCHAR(24) SMALLINT VARCHAR(128)

COLLID

VARCHAR(128)

NAME

VARCHAR(128)

TIMESTAMP IBMREQD

TIMESTAMP CHAR(1)

Description Name of the application plan. Sequence number of the entry in the package list. Location of the package. Blank if this is local. An asterisk (*) indicates location to be determined at run time. Collection name for the package. An asterisk (*) indicates that the collection name is determined at run time. Name of the package. An asterisk (*) indicates an entire collection. Timestamp indicating when the row was created. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes

SYSIBM.SYSPACKSTMT Contains one or more rows for each statement in a package. Column Name LOCATION COLLID NAME CONTOKEN

Data Type VARCHAR(128) VARCHAR(128) VARCHAR(128) CHAR(8)

SEQNO

INTEGER

STMTNO

SMALLINT

SECTNO BINDERROR

SMALLINT CHAR(1)

278

Description Always contains blanks Name of the package collection. Name of the package. Consistency token for the package. This is either: o The "level" as specified by the LEVEL option when the package's program was precompiled o The timestamp indicating when the package's program was precompiled, in an internal format Sequence number of the row with respect to a statement in the package. The numbering starts with 0. The statement number of the statement in the source program. A statement number greater than 32767 is displayed as zero or a or a negative number (see STMTNOI for the statement number). The section number of the statement. Whether an SQL error was detected at bind time: N No Y Yes ®

DB2 9 for z/OS

®


Data Type CHAR(1)

VERSION STMT


ISOLATION

CHAR(1)

STATUS

CHAR(1)

®

DB2 9 for z/OS

Description Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Version identifier for the package. All or a portion of the text for the SQL statement that the row represents. Isolation level for the SQL statement: R RR (repeatable read) T RS (read stability) S CS (cursor stability) U UR (uncommitted read) L KEEP UPDATE LOCKS for an RS isolation X KEEP UPDATE LOCKS for an RR isolation blank The WITH clause was not specified on this statement. The isolation level is recorded in SYSPACKAGE.ISOLATION and in SYSPLAN.ISOLATION. Status of binding the statement: A Distributed - statement uses DB2 private protocol access. The statement will be parsed and executed at the server using defaults for input variables during access path selection. B Distributed - statement uses DB2 private protocol access. The statement will be parsed and executed at the server using values for input variables during access path selection. C Compiled - statement was bound successfully using defaults for input variables during access path selection. E Explain - statement is an SQL EXPLAIN statement. The explain is done at bind time using defaults for input variables during access path selection. F Parsed - statement did not bind successfully and VALIDATE(RUN) was used. The statement will be rebound at execution time using values for input variables during access path selection. G Compiled - statement bound successfully, but REOPT is specified. The statement will be rebound at execution time using values for input variables during access path selection. H Parsed - statement is either a data definition statement or a statement that did not bind successfully and VALIDATE(RUN) was used. The statement will be rebound at execution time using defaults for input variables during access path selection. Data manipulation statements use defaults for input variables during access path selection. I Indefinite - statement is dynamic. The statement will be bound at execution time using defaults for input variables during access path selection. J Indefinite - statement is dynamic. The statement will be bound at execution time using values for input variables during access path selection. K Control - CALL statement. L Bad - the statement has some allowable error. The bind 279

®


Data Type

ACCESSPATH

CHAR(1)

STMTNOI SECTNOI EXPLAINABLE

INTEGER INTEGER CHAR(1)

QUERYNO

INTEGER

Description continues but the statement cannot be executed. blank The statement is non-executable, or was bound in a DB2 release prior to Version 5. For static statements, indicates if the access path for the statement is based on user-specified optimization hints. A value of 'H' indicates that optimization hints were used. A blank value indicates that the access path was determined without the use of optimization hints, or that there is no access path associated with the statement. For dynamic statements, the value is blank. The statement number of the statement in the source program. The section number of the statement. Contains one of the following values: Y Indicates that the SQL statement can be used with the EXPLAIN function and may have rows describing its access path in the userid.PLAN_TABLE. N Indicates that the SQL statement does not have any rows describing its access path in the userid.PLAN_TABLE Blank Indicates that the SQL statement was bound prior to V7. The query number of the SQL statement in the source program. SQL statements bound prior to V7 have a default value of –1. Statements bound V7 or later used the value specified on the QUERYNO clause on SELECT, UPDATE, INSERT, DELETE, EXPLAIN, and DECLARE CURSOR or REFRESH TABLE statements. If the QUERYNO clause is not specified, the query number is set to the statement number.

SYSIBM.SYSPARMS Contains a row for each parameter of a routine or multiple rows for table parameters (one for each column of the table). Column Name SCHEMA OWNER NAME SPECIFICNAME ROUTINETYPE


CAST_FUNCTION

CHAR(1)

PARMNAME

VARCHAR(128)

ROUTINEID ROWTYPE

INTEGER CHAR(1)

280

Description Schema of the routine. Owner of the routine. Name of the routine. Specific name of the routine. Type of routine: F User-defined function or cast function P Stored procedure Whether the routine is a cast function: N Not a cast function Y A cast function The only way to get a value of Y is if a user creates a distinct type when DB2 implicitly generates cast functions for the distinct type. Name of the parameter. For a table parameter, the parameter name in the row corresponding to the first column of the table is the parameter name specified on CREATE; an empty string or blanks are stored for the parameter name for the rows corresponding to the remaining columns. Internal identifier of the routine. The following values indicate the type of parameter described by this row: ®

DB2 9 for z/OS

®


Data Type

ORDINAL

SMALLINT

TYPESCHEMA TYPENAME DATATYPEID

CHAR(8) CHAR(18) INTEGER

SOURCETYPEID

INTEGER

LOCATOR

CHAR(1)

TABLE

CHAR(1)

®

DB2 9 for z/OS

Description P Input parameter. O Output parameter; not applicable for functions B Both an input and an output parameter; not applicable for functions R Result before casting; not applicable for stored procedures C Result after casting; not applicable for stored procedures S Input parameter of the underlying built-in source function. For a sourced function and a given ORDINAL value: • The row with ROWTYPE = P describes the input parameter of the user-defined function (identified by ROUTINEID). • The row with ROWTYPE = S describes the corresponding input parameter of the built-in function that is the underlying source function (identified by the SOURCESCHEMA and SOURCESPECIFIC values). A value of ’X’ indicates that the row is not used to describe a particular parameter of the routine. Instead, for a routine that was created prior to Version 9, the row is used to record a CCSID for the encoding scheme specified in a PARAMETER CCSID clause, or a DATATYPEID for the representation of the variable length character string parameters of a LANGUAGE C routine, as specified in a PARAMETER VARCHAR clause. For routines created with Version 8 (new function mode) or later releases, the CCSID is recorded in the PARAMETER_CCSID column of SYSROUTINES. For routines created with Version 9 or later releases, the DATATYPEID information to support PARAMETER VARCHAR is recorded in the PARAMETER_VARCHARFORM column of SYSIBM.SYSROUTINES. If ROWTYPE is B, O, P, or S, the ordinal number of the parameter within the routine signature. If ROWTYPE is C or R, the value is 0. When the ROWTYPE is X, because a PARAMETER CCSID is specified for functions or procedures created prior to V8, the ORDINAL value is 0. Schema of the data type of the parameter. Name of the data type of the parameter. For a built-in data type, the internal ID of the built-in type. For a distinct type, the internal ID of the distinct type. For a built-in data type, 0. For a distinct type, the internal ID of the built-in data type upon which the distinct type is sourced. Indicates whether a locator to a value, instead of the actual value, is to be passed as the input value when the routine is called: N The actual value is to be passed. Y A locator to a value is to be passed The data type of a column for a table parameter: N This is not a table parameter. Y This is a table parameter. 281

®

DB2 9 z/OS Reference Guide Column Name TABLE_COLNO

Data Type SMALLINT

LENGTH

INTEGER

SCALE SUBTYPE

SMALLINT CHAR(1)

CCSID

INTEGER

CAST_FUNCTION_ID

INTEGER

ENCODING_SCHEME

CHAR(1)

IBMREQD

CHAR(1)

VERSION

VARCHAR(122)

OWNERTYPE

CHAR(1)

Description For table parameters, the column number of the table. Otherwise, the value is 0. Length attribute of the parameter, or in the case of a decimal parameter, its precision. Scale of the data type of the parameter. If the data type is a distinct type, the subtype of the distinct type, which is based on the subtype of its source type: B The subtype is FOR BIT DATA. S The subtype is FOR SBCS DATA. M The subtype is FOR MIXED DATA. blank The source type is not a character type. CCSID of the data type for character, graphic, date, time, and timestamp data types. When the ROWTYPE is X and ORDINAL is 0, the CCSID column is the CCSID for all character and graphic string parameters. Internal function ID of the function used to cast the argument, if this function is sourced on another function, or result. Otherwise, the value is 0. Not applicable for stored procedures. Encoding scheme of the parameter: A ASCII E EBCDIC U UNICODE blank The source type is not a character type. Whether the row came from the basic machine-readable material (MRM) tape: N No Y Yes The version identifier for the routine. The column is a zerolength string if the value of ORIGIN is not ’I’ or if the rows were created prior to Version 9. Indicates the type of owner: blank Authorization ID L Role

SYSIBM.SYSPKSYSTEM Contains zero or more rows for every package. Each row for a given package represents one or more connections to an environment in which the package could be executed. Column Name LOCATION COLLID NAME CONTOKEN


SYSTEM

VARCHAR(24)

282

Description Always contains blanks. Name of the package collection. Name of the package. Consistency token for the package. This is either: o The "level" as specified by the LEVEL option when the package's program was precompiled o The timestamp indicating when the package's program was precompiled, in an internal format. Environment. Values can be: BATCH TSO batch CICS Customer Information Control System DB2CALL DB2 call attachment facility ®

DB2 9 for z/OS

®


Data Type

ENABLE

CHAR(1)

CNAME

VARCHAR(60)

IBMREQD

CHAR(1)

Description DLIBATCH DLI batch support facility IMSBMP IMS BMP region IMSMPP IMS MPP and IFP region REMOTE remote application server Indicates whether the connections represented by the row are enabled or disabled: N Disabled Y Enabled Identifies the connection or connections to which the row applies. Interpretation depends on the environment specified by SYSTEM. Values can be: o Blank if SYSTEM=BATCH or SYSTEM=DB2CALL o The LU name for an application server if SYSTEM=REMOTE o Either the requester's location (if the product is DB2) or the requester's LU name enclosed in angle brackets if SYSTEM=REMOTE. o The name of a single connection if SYSTEM has any other value. CNAME can also be blank when SYSTEM is not equal to BATCH or DB2CALL. When this is so, the row applies to all servers or connections for the indicated environment. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes

SYSIBM.SYSPLAN Contains one row for each application plan. Column Name NAME CREATOR BINDDATE VALIDATE

Data Type VARCHAR(24) VARCHAR(128) CHAR(6) CHAR(1)

ISOLATION

CHAR(1)

®

DB2 9 for z/OS

Description Name of the application plan. Authorization ID of the owner of the application plan. Date on which the plan was last bound, in the form yymmdd. Whether validity checking can be deferred until run time: B All checking must be performed during BIND. R Validation is done at run time for tables, views, and privileges that do not exist at bind time. Isolation level for the plan: R RR (repeatable read) T RS (read stability) S CS (cursor stability) U UR (uncommitted read)

283

®

DB2 9 z/OS Reference Guide Column Name VALID

Data Type CHAR(1)

OPERATIVE

CHAR(1)

BINDTIME PLSIZE IBMREQD

CHAR(8) INTEGER CHAR(1)

AVGSIZE

INTEGER

ACQUIRE

CHAR(1)

RELEASE

CHAR(1)

EXPLAN

CHAR(1)

EXPREDICATE

CHAR(1)

BOUNDBY QUALIFIER


CACHESIZE

SMALLINT

PLENTRIES

SMALLINT

284

Description Whether the application plan is valid: A The ALTER TABLE statement changed the description of the table or base table of a view that is referred to by the application plan. For a CREATE INDEX statement involving data sharing, VALID is also marked as ‘A’. The change does not invalidate the application plan. H The ALTER TABLE statement changed the description of the table or base table of a view that is referred to by the application plan. For releases of DB2 prior to Version 5, the change invalidates the application plan. N No Y Yes Whether the application plan can be allocated: N No; an explicit BIND or REBIND is required before the plan can be allocated Y Yes Time of the BIND in the form hhmmssth. Size of the base section of the plan, in bytes. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Average size, in bytes, of those sections of the plan that contain SQL statements processed at bind time. When resources are acquired: A At allocation U At first use When resources are released: C At commit D At deallocation EXPLAIN option specified for the plan; that is, whether information on the plan's statements was added to the owner's PLAN_TABLE table: N No Y Yes Indicates the CURRENTDATA option when the plan was bound or rebound: B Data currency is not required for ambiguous cursors. Allow blocking for ambiguous cursors. C Data currency is required for ambiguous cursors. Inhibit blocking for ambiguous cursors. N Blocking is inhibited for ambiguous cursors, but the plan was created before the CURRENTDATA option was available. Primary authorization ID of the binder of the plan. Implicit qualifier for the unqualified table, view, index, and alias names in the static SQL statements of the plan. Size, in bytes, of the cache to be acquired for the plan. A value of zero indicates that no cache is used. Number of package list entries for the plan. The negative of that number if there are rows for the plan in SYSIBM.SYPACKLIST but the plan was bound in a prior release after fall back. ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name DEFERPREP

Data Type CHAR(1)

CURRENTSERVER

VARCHAR(128)

SYSENTRIES

SMALLINT

DEGREE

CHAR(3)

SQLRULES

CHAR(1)

DISCONNECT

CHAR(1)

GROUP_MEMBER

VARCHAR(24)

DYNAMICRULES

CHAR(1)

BOUNDTS REOPTVAR

TIMESTAMP CHAR(1)

®

DB2 9 for z/OS

Description Whether the package was last bound with the DEFER(PREPARE) option: N No Y Yes Location name specified with the CURRENTSERVER option when the plan was last bound. Blank if none was specified, implying that the first server is the local DB2 subsystem. Number of rows associated with the plan in SYSIBM.SYSPLSYSTEM. The negative of that number if such rows exist but the plan was bound in a prior release after fall back. A negative value or zero means that all connections are enabled. The DEGREE option used when the plan was last bound: ANY DEGREE(ANY) 1 or blank DEGREE(1). Blank if the plan was migrated. The SQLRULES option used when the plan was last bound: D or blank SQLRULES(DB2) S SQLRULES(STD) blank A migrated plan The DISCONNECT option used when the plan was last bound: E or blank DISCONNECT (EXPLICIT) A DISCONNECT (AUTOMATIC) C DISCONNECT (CONDITIONAL) blank A migrated plan The DB2 data-sharing member name of the DB2 subsystem that performed the most recent bind. This column is blank if the DB2 subsystem was not in a DB2 data-sharing environment when the bind was performed. The DYNAMICRULES option used when the plan was last bound: B BIND. Dynamic SQL statements are executed with DYNAMICRULES bind behavior. blank RUN. Dynamic SQL statements in the plan are executed with DYNAMICRULES run behavior. Time when the plan was bound. Whether the access path is determined again at execution timeusing input variable values: A Bind option REOPT(AUTO) indicates that the access path is determined multiple times at execution time depending on the parameter value. N Bind option REOPT(NONE) indicates that the access path is determined at bind time. Y Bind option REOPT(ALWAYS) indicates that the access path is determined at execution time for SQL statements with variable values. 1 Bind option REOPT(ONCE) indicates that the access path is determined only once at execution time, using the first set of input variable values, regardless of how many times the same statement is executed.

285

®

DB2 9 z/OS Reference Guide Column Name KEEPDYNAMIC

Data Type CHAR(1)

PATHSCHEMAS

VARCHAR(254)

DBPROTOCOL

CHAR(1)

FUNCTIONTS

TIMESTAMP

OPTHINT

CHAR(8)

ENCODING_CCSID

INTEGER

IMMEDWRITE

CHAR(1)

RELBOUND

CHAR(1)

REMARKS

VARCHAR(128)

CREATORTYPE

CHAR(1)

286

Description Whether prepared dynamic statements are to be purged at each commit point: N The bind option is KEEPDYNAMIC(NO). Prepared dynamic SQL statements are destroyed at commit or rollback. Y The bind option is KEEPDYNAMIC(YES). Prepared dynamic SQL statements are kept past commit or rollback. SQL path specified on the BIND or REBIND command that bound the plan. The path is used to resolve unqualified data type, function, and stored procedure names used in certain contexts. If the PATH bind option was not specified, the value in the column is a zero length string; however, DB2 uses a default SQL path of: SYSIBM, SYSFUN, SYSPROC, plan qualifier. Whether remote access for SQL with three-part names is implemented with DRDA or DB2 private protocol access: D DRDA P DB2 private protocol Timestamp when the function was resolved. Set by the BIND and REBIND commands, but not by AUTOBIND. Value of the OPTHINT bind option. Identifies rows in the authid.PLAN_TABLE to be used as input to the optimizer. Contains blanks if no rows in the authid.PLAN_TABLE are to be used as input. The CCSID corresponding to the encoding scheme or CCSID as specified for the bind option ENCODING. The encoding scheme specified on the bind command: CCSID The specified or derived CCSID 0 The EBCDIC default CCSID as specified on panel DSNTIPF at installation time. Indicates when writes of updated group bufferpool dependent pages are to be done. This option is only applicable for datasharing environments. N Bind option IMMEDWRITE(NO) indicates normal write activity is done. Y Bind option IMMEDWRITE(YES) indicates that immediate writes are done for updated group buffer pool dependent pages. 1 Bind option IMMEDWRITE(PH1) indicates that updated group bufferpool dependent pages are written at or before phase 1 commit. The release when the package was bound or rebound. blank Bound prior to V7 K Bound on V7 A character string provided by the user with the COMMENT statement. Indicates the type of creator: blank Authorization ID L Role

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name ROUNDING

Data Type CHAR(1)

Description The ROUNDING option used when the plan was last bound: C ROUND_CEILING D ROUND_DOWN F ROUND_FLOOR G ROUND_HALF_DOWN E ROUND_HALF_EVEN H ROUND_HALF_UP U ROUND_UP blank The plan was created in a DB2 release prior to Version 9.

SYSIBM.SYSPLANAUTH Records the privileges that are held by users over application plans. Column Name GRANTOR GRANTEE


NAME DATEGRANTED TIMEGRANTED AUTHHOWGOT

VARCHAR(24) CHAR(6) CHAR(8) CHAR(1)

BINDAUTH

CHAR(1)

EXECUTEAUTH

CHAR(1)

IBMREQD

CHAR(1)

GRANTEDTS GRANTEETYPE

TIMESTAMP CHAR(1)

GRANTORTYPE

CHAR(1)

®

DB2 9 for z/OS

Description Authorization ID of the user who granted the privileges. Authorization ID of the user who holds the privileges. Could also be PUBLIC for a grant to PUBLIC. Name of the application plan on which the privileges are held. Date the privileges were granted; in the form yymmdd. Time the privileges were granted; in the form hhmmssth. Authorization level of the user from whom the privileges were received. This authorization level is not necessarily the highest authorization level of the grantor. blank Not applicable C DBCTL D DBADM L SYSCTRL M DBMAINT S SYSADM Whether the GRANTEE can use the BIND, REBIND, or FREE subcommands against the plan: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can run application programs that use the application plan: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Time when the GRANT statement was executed. Indicates the type of grantee: blank Authorization ID L Role Indicates the type of grantor: blank Authorization ID L Role

287

®


SYSIBM.SYSPLANDEP Records the dependencies of plans on tables, views, aliases, synonyms, tablespaces, indexes, functions, and stored procedures. Column Name BNAME BCREATOR


BTYPE

CHAR(1)

DNAME IBMREQD

VARCHAR(24) CHAR(1)

Description The name of an object the plan depends on. If BNAME is a table space, its database. Otherwise, the schema of BNAME. If BNAME is a role, the value is blank. Type of object identified by BNAME: A Alias E INSTEAD OF trigger F User-defined function or cast function I Index L Role M Materialized query table O Stored procedure P Partitioned tablespace Q Sequence object R Tablespace S Synonym T Table V View Name of the plan. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes

SYSIBM.SYSPLSYSTEM Contains zero or more rows for every plan. Each row for a given plan represents one or more connections to an environment in which the plan could be used. Column Name NAME SYSTEM


ENABLE

CHAR(1)

CNAME

VARCHAR(60)

288

Description Name of the plan. Environment. Values can be: BATCH TSO batch DB2CALL DB2 call attachment facility CICS Customer Information Control System DLIBATCH DLI batch support facility IMSBMP IMS BMP region IMSMPP IMS MPP or IFP region Indicates whether the connections represented by the row are enabled or disabled: N Disabled Y Enabled Identifies the connection or connections to which the row applies. Interpretation depends on the environment specified by SYSTEM. Values can be: o Blank if SYSTEM=BATCH or SYSTEM=DB2CALL o The name of a single connection if SYSTEM has any other value CNAME can also be blank when SYSTEM is not equal to BATCH or DB2CALL. When this is so, the row applies to all connections for the indicated environment. ®

DB2 9 for z/OS

®


Data Type CHAR(1)

Description Whether the row came from the basic machine-readable material (MRM) tape N=No, Y=Yes

SYSIBM.SYSRELS Contains one row for every referential constraint. Column Name CREATOR


TBNAME RELNAME REFTBNAME REFTBCREATOR COLCOUNT DELETERULE

VARCHAR(128) VARCHAR(128) VARCHAR(128) VARCHAR(128) SMALLINT CHAR(1)

IBMREQD

CHAR(1)

RELOBID1

SMALLINT

RELOBID2

SMALLINT

TIMESTAMP

TIMESTAMP

IXOWNER

VARCHAR(128)

IXNAME

VARCHAR(128)

ENFORCED

CHAR(1)

CHECKEXISTING DATA

CHAR(1)

RELCREATED

CHAR(1)

Description Schema of the owner of the dependent table of the referential constraint. Name of the dependent table of the referential constraint. Constraint name. Name of the parent table of the referential constraint. Schema of the owner of the parent table. Number of columns in the foreign key. Type of delete rule for the referential constraint: A NO ACTION C CASCADE N SET NULL R RESTRICT Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Internal identifier of the constraint with respect to the database that contains the parent table. Internal identifier of the constraint with respect to the database that contains the dependent table. Date and time the constraint was defined. If the constraint is between catalog tables prior to DB2 Version 2 Release 3, the value is '1985-04-01-00.00.00.000000.'. Schema of unique non-primary index used for the parent key. '99999999' if the enforcing index has been dropped. Blank if the enforcing index is a primary index. Name of unique non-primary index used for a parent key. '99999999' if the enforcing index has been dropped. Blank if the enforcing index is a primary index. Enforced by the system or not: Y Enforced by the system N Not enforced by the system(trusted) Option for checking existing data I Immediately check existing data. If ENFORCED = Y this column will have a value or ‘I’ N Never check existing data. If ENFORCED = N, this column will have a value of N The release of DB2 that is used to create the object.

SYSIBM.SYSRESAUTH Records CREATE IN and PACKADM ON privileges for collections; USAGE privileges for distinct types; and USE privileges for buffer pools, storage groups, and tablespaces. Column Name GRANTOR ®

DB2 9 for z/OS


Description Authorization ID of the user who granted the privilege. 289

®

DB2 9 z/OS Reference Guide Column Name GRANTEE


Description Authorization ID of the user who holds the privilege. Could also be PUBLIC for a grant to PUBLIC. Qualifier of the tablespace (the database name) if the privilege is for a tablespace (OBTYPE='R'). The schema name of the distinct type if the privilege is for a distinct type (OBTYPE='D'). Otherwise, the value is blank. Name of the buffer pool, collection, DB2 storage group, distinct type, or tablespace. Could also be ALL when USE OF ALL BUFFERPOOLS is granted.

QUALIFIER

VARCHAR(128)

NAME

VARCHAR(128)

AUTHHOWGOT

CHAR(1)

OBTYPE

CHAR(1)

DATEGRANTED

CHAR(6)

Authorization level of the user from whom the privileges were received. This authorization level is not necessarily the highest authorization level of the grantor. blank Not applicable C DBCTL D DBADM L SYSCTRL M DBMAINT S SYSADM P PACKADM (on a specific collection) A PACKADM (on collection *) Type of object: B Buffer pool C Collection D Distinct type R Tablespace S Storage group J JAR (Java Archive file) Date the privilege was granted; in the form yymmdd.

TIMEGRANTED

CHAR(8)

Time the privilege was granted; in the form hhmmssth.

USEAUTH

CHAR(1)

IBMREQD

CHAR(1)

GRANTEDTS GRANTEETYPE

TIMESTAMP CHAR(1)

GRANTORTYPE

CHAR(1)

Whether the privilege is held with the GRANT option: G Privilege is held with the GRANT option Y Privilege is held without the GRANT option The authority held is PACKADM when the OBTYPE is C (a collection) and QUALIFIER is PACKADM. The authority held is CREATE IN when the OBTYPE is C and QUALIFIER is blank. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Time when the GRANT statement was executed. Indicates the type of grantee: blank Authorization ID L Role Indicates the type of grantor: blank Authorization ID L Role

SYSIBM.SYSROLES Contains one row for each role. Column Name NAME DEFINER 290


Description The name of the role. The authorization ID or role that defined this role listed in the ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide DEFINERTYPE

CHAR(1)

CREATEDTS RELCREATED REMARKS

TIMESTAMP CHAR(1) VARCHAR(762)

IBMREQD

CHAR(1)

NAME column. The type of definer: L Role blank Authorization ID The time when the role is created. The release of DB2 that is used to create the role. A character string that is provided using the COMMENT statement. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape.

SYSIBM.SYSROUTINEAUTH

Records the privileges that are held by users on routines. (A routine can be a user-defined function, cast function, or stored procedure.) Column Name GRANTOR GRANTEE


SCHEMA SPECIFICNAME


GRANTEDTS ROUTINETYPE

TIMESTAMP CHAR(1)

GRANTEETYPE

CHAR(1)

AUTHHOWGOT

CHAR(1)

EXECUTEAUTH

CHAR(1)

COLLID

VARCHAR(128)

CONTOKEN

CHAR(8)

IBMREQD

CHAR(1)

®

DB2 9 for z/OS

Description Authorization ID of the user who granted the privilege. Authorization ID of the user who holds the privilege or the name of a plan or package that uses the privilege. Can also be PUBLIC for a grant to PUBLIC. Schema of the routine. Specific name of the routine. An asterisk (*) if the privilege is held on all routines in the schema. Time when the GRANT statement was executed. Type of routine: F User-defined function or cast function P Stored procedure Type of grantee: blank An authorization ID L Role P An application plan or package. The grantee is a package if COLLID is not blank. R Internal use only Authorization level of the user from whom the privileges were received. This authorization level is not necessarily the highest authorization level of the grantor. This field is also used to indicate that the privilege was held on all schemas by the grantor. blank Not applicable 1 Grantor had privilege on schema.* at time of grant L SYSCTRL S SYSADM Whether GRANTEE can execute the routine: Y Privilege is held without GRANT option. G Privilege is held with GRANT option. If the GRANTEE is a package, its collection name. Otherwise, the value is blank. If the GRANTEE is a package, the consistency token of the DBRM from which the package was derived. Otherwise, the value is blank. Whether the row came from the basic machine-readable material 291

®


Data Type

GRANTORTYPE

CHAR(1)

Description (MRM) tape. Indicates the type of grantor: blank Authorization ID L Role

SYSIBM.SYSROUTINES Contains a row for every routine. (A routine can be a user-defined function, cast function, or stored procedure.) Column Name SCHEMA OWNER NAME ROUTINETYPE


CREATEDBY

VARCHAR(128)

SPECIFICNAME ROUTINEID RETURN_TYPE

VARCHAR(128) INTEGER INTEGER

ORIGIN

CHAR(1)

FUNCTION_TYPE

CHAR(1)

PARM_COUNT LANGUAGE

SMALLINT VARCHAR(24)

COLLID

VARCHAR(128)

292

Description Schema of the routine. Owner of the routine. Name of the routine. Type of routine: F User-defined function or cast function P Stored procedure Primary authorization ID under which the routine was created. Specific name of the routine. Internal identifier of the routine. Internal identifier of the result data type of the function. The column contains a -2 if the function is a table function. Origin of the routine: E External user-defined function or stored procedure N Native SQL Procedure Q SQL Function U Sourced on user-defined function or built-in function S System-generated function Type of function: C Column function S Scalar function T Table function blank For a stored procedure (ROUTINETYPE = 'P') Number of parameters for the routine. Implementation language of the routine: ASSEMBLE C COBOL COMPJAVA JAVA PLI REXX SQL blank ORIGIN is not 'E'. Name of the package collection to be used when the routine is executed. A blank value indicates the package collection is the same as the package collection of the program that invoked the routine.

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name SOURCESCHEMA


SOURCESPECIFIC

VARCHAR(128)

DETERMINISTIC

CHAR(1)

EXTERNAL_ACTION

CHAR(1)

NULL_CALL

CHAR(1)

CAST_FUNCTION

CHAR(1)

SCRATCHPAD

CHAR(1)

SCRATCHPAD_LENGTH

INTEGER

FINAL_CALL

CHAR(1)

®

DB2 9 for z/OS

Description If ORIGIN is 'U' and ROUTINETYPE is 'F', the schema of the source user-defined function ('SYSIBM' for a source built-in function). Otherwise, the value is blank. If ORIGIN is 'U' and ROUTINETYPE is 'F', the specific name of the source user-defined function or source built-in function name. Otherwise, the value is blank. The deterministic option of an external function or a stored procedure: N Indeterminate (results may differ with a given set of input values). Y Deterministic (results are consistent). blank ROUTINETYPE='F' and ORIGIN is not 'E' (the routine is a function, but not an external function). The external action option of an external function: N Function has no side effects. E Function has external side effects so that the number of invocations is important. blank ORIGIN is not 'E' for the function (ROUTINETYPE='F'), or it is a stored procedure (ROUTINETYPE='P'). The CALLED ON INPUT option of an external function or stored procedure: N The routine is not called if any parameter has a NULL value. Y The routine is called if any parameter has a NULL value. blank ROUTINETYPE='F' and ORIGIN is not 'E' (the routine is a function, but not an external function). Whether the routine is a cast function: N The routine is not a cast function. Y The routine is a cast function. A cast function is generated by DB2 for a CREATE DISTINCT TYPE statement. The SCRATCHPAD option of an external function: N This function does not have a SCRATCHPAD. Y This function has a SCRATCHPAD. blank ORIGIN is not 'E' for the function (ROUTINETYPE='F'), or it is a stored procedure (ROUTINETYPE='P'). Length of the scratchpad if the ORIGIN is 'E' for the function (ROUTINETYPE='F') and NO SCRATCHPAD is not specified. Otherwise, the value is 0. The FINAL CALL option of an external function: N A final call will not be made to the function. Y A final call will be made to the function. blank ORIGIN is not 'E' for the function (ROUTINETYPE='F'), or it is a stored procedure (ROUTINETYPE='P').

293

®

DB2 9 z/OS Reference Guide Column Name PARALLEL

Data Type CHAR(1)

PARAMETER_STYLE

CHAR(1)

FENCED

CHAR(1)

SQL_DATA_ACCESS

CHAR(1)

DBINFO

CHAR(1)

STAYRESIDENT

CHAR(1)

294

Description The PARALLEL option of an external function: A This function can be invoked by parallel tasks. D This function cannot be invoked by parallel tasks. blank ORIGIN is not 'E' for the function (ROUTINETYPE='F'), or it is a stored procedure (ROUTINETYPE='P'). The PARAMETER STYLE option of an external function or stored procedure: D DB2SQL. All parameters are passed to the external function or stored procedure according to the DB2SQL standard convention. G GENERAL. All parameters are passed to the stored procedure according to the GENERAL standard convention. N GENERAL CALL WITH NULLS. All parameters are passed to the stored procedure according to the GENERAL CALL WITH NULLS convention. Y Indicates that this routine runs separately from the DB2 address space in a WLM managed DB2 address space. All user defined routines that are not marked with Y in this column run in the DB2 address space. blank ORIGIN is 'Q' or ORIGIN is ’N’. The SQL statements that are allowed in an external function or stored procedure: C CONTAINS SQL: Only SQL that does not read or modify data is allowed. M MODIFIES SQL DATA: All SQL is allowed, including SQL that reads or modifies data. N NO SQL: SQL is not allowed. R READS SQL DATA: Only SQL that reads data is allowed. blank Not applicable. The DBINFO option of an external function or stored procedure: N No, the DBINFO parameter will not be passed to the external function or stored procedure. Y Yes, the DBINFO parameter will be passed to the external function or stored procedure. The STAYRESIDENT option of the routine, which determines whether the routine is to be deleted from memory when the routine ends. N The load module is to be deleted from memory after the routine terminates. Y The load module is to remain resident in memory after the routine terminates. blank ORIGIN is not 'E'.

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name ASUTIME

Data Type INTEGER

WLM_ENVIRONMENT

VARCHAR(54)

Description Number of CPU service units permitted for any single invocation of this routine. If ASUTIME is zero, the number of CPU service units is unlimited. If a routine consumes more CPU service units than the ASUTIME value allows, DB2 cancels the routine. Name of the WLM environment to be used to run this routine. When ORIGIN = 'N', this is the name of the WLM ENVIRONMENT FOR DEBUG MODE that is to be used when debugging a native SQL procedure.

WLM_ENV_FOR_NESTED

CHAR(1)

PROGRAM_TYPE

CHAR(1)

EXTERNAL_SECURITY

CHAR(1)

®

DB2 9 for z/OS

The column is blank if ROUTINETYPE = 'F' and ORIGIN is not 'E'. If the ROUTINETYPE = 'P', the value might be blank. If this value is blank the stored procedure cannot be run. For nested routine calls, indicates whether the address space of the calling store procedure or user-defined function is used to run the nested stored procedure or user-defined function: N The nested stored procedure or user-defined function runs in an address space other than the specified WLM environment if the calling stored procedure or user-defined function is not running in the specified WLM environment. 'WLM ENVIRONMENT name' was specified. Y The nested stored procedure or user-defined function runs in the environment used by the calling stored procedure or user-defined function. 'WLM ENVIRONMENT(name,*)' was specified. blank WLM_ENVIRONMENT is blank. Indicates whether the routine runs as a Language Environment main routine or a subroutine: M The routine runs as a main routine. S The routine runs as a subroutine. blank ORIGIN is not 'E'. Specifies the authorization ID to be used if the routine accesses resources protected by an external security product: D DB2 - The authorization ID associated with the WLM-established stored procedure address space. U SESSSION_USER - The authorization ID of the SQL user that invoked the routine. C DEFINER - The authorization ID of the owner of the routine. blank ORIGIN is not 'E'.

295

®

DB2 9 z/OS Reference Guide Column Name COMMIT_ON_RETURN

Data Type CHAR(1)

RESULT_SETS

SMALLINT

LOBCOLUMNS

SMALLINT

CREATEDTS

TIMESTAMP

ALTEREDTS

TIMESTAMP

IBMREQD

CHAR(1)

PARM1 - 30 IOS_PER_INVOC

SMALLINT FLOAT

INSTS_PER_INVOC

FLOAT

INITIAL_IOS

FLOAT

INITIAL_INSTS

FLOAT

CARDINALITY

FLOAT

RESULT_COLS

SMALLINT

EXTERNAL_NAME

VARCHAR(762)

PARM_SIGNATURE RUNOPTS


REMARKS

VARCHAR(762)

JAVA_SIGNATURE

VARCHAR(3072)

296

Description If ROUTINETYPE = 'P', whether the transaction is always to be committed immediately on successful return (non-negative SQLCODE) from this stored procedure: N The unit of work is to continue. Y The unit of work is to be committed immediately. If ROUTINETYPE = 'F', the value is blank. If ROUTINETYPE = 'P', the maximum number of ad hoc result sets that this stored procedure can return. If no ad hoc result exists or ROUTINETYPE = 'F', the value is zero. If ORIGIN = 'E', the number of LOB columns found in the parameter list for this user-defined function. If no LOB columns are found in the parameter list or ORIGIN is not 'E', the value is 0. Time when the CREATE statement was executed for this routine. Time when the last ALTER statement was executed for this routine. Whether the row came from the basic machinereadable material (MRM) tape: N=No, Y=Yes Internal use only. Estimated number of I/Os required to execute the routine. The value is -1 if the estimated number is not known. Estimated number of machine instructions required to execute the routine. The value is -1 if the estimated number is not known. Estimated number of I/Os that are performed the first time or the last time the routine is invoked. The value is -1 if the estimated number is not known. Estimated number of machine instructions that are performed the first time or the last time the routine is invoked. The value is -1 if the estimated number is not known. The predicted cardinality of the routine. The value is -1 if the predicted cardinality is not known. For a table function, the number of columns in the result table. Otherwise, the value is 1. The path/module/function that DB2 should load to execute the routine. The column is blank if the ORIGIN is not 'E'. Internal use only. The Language Environment run-time options to be used for this routine. An empty string indicates that the installation default Language Environment run-time options are to be used. A character string provided by the user with the COMMENT ON statement. The signature of the jar file: Blank When PARAMETER STYLE is not JAVA ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name CLASS


JARSCHEMA

VARCHAR(128)

JAR_ID

VARCHAR(128)

SPECIAL_REGS

CHAR(1)

NUM_DEP_MQTS

SMALLINT

MAX_FAILURES PARAMETER_CCSID

SMALLINT INTEGER

VERSION

VARCHAR(122)

CONTOKEN

CHAR(8)

ACTIVE

CHAR(1)

DEBUG_MODE

CHAR(1)

TEXT_ENVID

INTEGER

TEXT_ROWID TEXT

ROWID CLOB(2M)

OWNERTYPE

CHAR(1)

®

DB2 9 for z/OS

Description The class name contained in the jar file: Blank When PARAMETER STYLE is not JAVA The schema of the jar file: Blank When PARAMETER STYLE is not JAVA The name of the jar file: Blank When PARAMETER STYLE is not JAVA The SPECIAL REGISTER option for a routine: I INHERIT SPECIAL REGISTER D DEFAULT SPECIAL REGISTER Number of dependent MQTs. The value is 0 if the row does not describe a user defined table function or if no MQTs are defined on the table function. Allowable failures for the routine. A CCSID that specifies how character, graphic, data, time, and timestamp data types for system genereated parameters to the routine such as message tokens and DBINFO should be passed. The version identifier for a native SQL procedure (indicated by the value ’N’ in the column ORIGIN). A zero length string for the rows that are created prior to Version 9 and for the rows in which the value of ORIGIN is not ’N’. The consistency token for the routine. The column is set to X'20' if the value of ORIGIN is not ’N’ Identifies the active version of the routine: Y The routine is the active version. N The routine is not the active version. blank The value of ORIGIN is not ’N’ or the row was created prior to Version 9. Identifies whether or not this routine is enabled for debugging: 1 This routine is enabled for debugging and can be debugged in a client debug session using the DB2 Unified Debugger. 0 This routine is not enabled for debugging. N This routine can never be enabled for debugging. blank The LANGUAGE is not specified as JAVA, the value of ORIGIN is not ’N’, or the row was created prior to Version 9. Internal identifier of the environment. The column is 0 if the value of ORIGIN is not ’N’ or if the row was created prior to Version 9. ID to support LOB columns for source text. The source text of the CREATE statement or the ALTER statement with the body for the routine. The column is a zero-length string if the value of ORIGIN is not ’N’ or if the row was created prior to Version 9. Indicates the type of owner: blank Authorization ID L Role

297

®

DB2 9 z/OS Reference Guide Column Name PARAMETER_ VARCHARFORM

Data Type INTEGER

RELCREATED

CHAR(1)

PACKAGEPATH

VARCHAR(4096)

Description A non-zero value that indicates the actual representation, to a LANGUAGE C routine, of any varying length string parameter that appears in the parameter list or RETURNS clause for that routine. The release of DB2 that is used to create the object. Blank if created prior to Version 9. The value of the PACKAGE PATH option of the CREATE FUNCTION, CREATE PROCEDURE, ALTER FUNCTION, or ALTER PROCEDURE statement that created or last changed the routine. PACKAGE PATH identifies the package path to use when the routine is executed. A blank value indicates the package path is the same as the package path of the program that invoked the routine.

SYSIBM.SYSROUTINESTEXT An auxiliary table for the TEXT column of SYSIBM.SYSROUTINES and is required to hold the LOB data. Column Name TEXT

Data Type CLOB(2M)

Description The source text of the CREATE PROCEDURE statement for the routine. TEXT can also hold the source text of the ALTER PROCEDURE statement for the routine if the routine is a native SQL procedure and the SQL procedure body is included in the ALTER PROCEDURE statement.

SYSIBM.SYSROUTINES_OPTS Contains a row for each generated routine, such as one created by the DB2 Stored Procedure Builder tool, that records the build options for the routine. Rows in this table can be inserted, updated, and deleted. Column Name SCHEMA ROUTINENAME BUILDDATE BUILDTIME BUILDSTATUS

Data Type VARCHAR(128) VARCHAR(128) DATE TIME CHAR(1)

BUILDSCHEMA BUILDNAME BUILDOWNER IBMREQD


PRECOMPILE_OPTS COMPILE_OPTS PRELINK_OPTS LINK_OPTS BIND_OPTS SOURCEDSN DEBUG_MODE

VARCHAR(765) VARCHAR(765) VARCHAR(765) VARCHAR(765) VARCHAR(3072) VARCHAR(765) CHAR(1)

298

Description Schema of the routine. Name of the routine. Date the routine was built. Time the routine was built. Whether this version of the routine’s source is the current version. Schema name for BUILDNAME. Procedure used to create the routine. Authorization ID used to create the routine. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. Precompiler options used to build the routine. Compiler options used to build the routine. Prelink-edit options used to build the routine. Link-edit options used to build the routine. Bind options used to build the routine. Name of the source data set. Debugging is on or off for this objects ®

DB2 9 for z/OS

®


Data Type

Description 0 Debugging is off. 1 Debugging is on.

SYSIBM.SYSROUTINES_SRC Contains source for generated routines, such as those created by the DB2 Stored Procedure Builder tool. Rows in this table can be inserted, updated, and deleted. Column Name SCHEMA ROUTINENAME BUILDDATE BUILDTIME BUILDSTATUS

Data Type VARCHAR(128) VARCHAR(128) DATE TIME CHAR(1)

SEQNO IBMREQD

INTEGER CHAR(1)

CREATESTMT

VARCHAR(7500)

Description Schema of the routine. Name of the routine. Date the routine was built. Time the routine was built. Whether this version of the routine’s source is the current version. Number of the source statement piece in CREATESTMT. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. Routine source statement.

SYSIBM.SYSSCHEMAAUTH Contains one or more rows for each user that is granted a privilege on a particular schema in the database. Column Name GRANTOR


GRANTEE

VARCHAR(128)

SCHEMANAME AUTHHOWGOT


CREATEINAUTH

CHAR(1)

ALTERINAUTH

CHAR(1)

DROPINAUTH

CHAR(1)

®

DB2 9 for z/OS

Description Authorization ID of the user who granted the privileges or SYSADM. Authorization ID of the user or group that holds the privileges. Can also be PUBLIC for a grant to PUBLIC. Name of the schema or '*' for all schemas. Authorization level of the user from whom the privileges were received. This authorization level is not necessarily the highest authorization level of the grantor. This field is also used to indicate that the privilege was held on all schemas by the grantor. 1 Grantor had privilege on all schemas at time of grant L SYSCTRL S SYSADM Indicates whether grantee holds CREATEIN privilege on the schema: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Indicates whether grantee holds ALTERIN privilege on the schema: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Indicates whether grantee holds DROPIN privilege on the schema: blank Privilege is not held 299

®


Data Type

GRANTEDTS IBMREQD

TIMESTAMP CHAR(1)

GRANTEETYPE

CHAR(1)

GRANTORTYPE

CHAR(1)

Description G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Time when the GRANT statement was executed. Whether the row came from the basic machine-readable material (MRM) tape: I V6 dependency indicator; not from MRM tape Indicates the type of grantee: blank Authorization ID L Role Indicates the type of grantor: blank Authorization ID L Role

SYSIBM.SYSSEQUENCEAUTH

Records the privileges that are held by users over sequences. Column Name GRANTOR GRANTEE


SCHEMA NAME GRANTEETYPE

VARCHAR(128) VARCHAR(128) CHAR(1)

AUTHHOWGOT

CHAR(1)

ALTERAUTH

CHAR(1)

USEAUTH

CHAR(1)

COLLID

VARCHAR(128)

CONTOKEN

CHAR(8)

GRANTEDTS IBMREQD

TIMESTAMP CHAR(1)

300

Description Authorization ID of the user who granted the privileges. Authorization ID of the user or group that holds the privileges or the name of an application plan or package that uses the privileges. PUBLIC for a grant to PUBLIC. Schema of the sequence. Name of the sequence. Type of grantee: blank An authorization ID. L Role P An application plan or package. The grantee is a package if COLLID is not blank. R Internal use only. Authorization level of the user from whom the privileges were received. This authorization level is not necessarily the highest authorization level of the grantor: L SYSCTRL S SYSADM blank Not applicable Indicates whether grantee holds ALTER privilege on the sequence: blank Privilege is not held. G Privilege is held with the GRANT option. Y Privilege is held without the GRANT option. Indicates whether grantee holds USAGE privilege on the sequence: blank Privilege is not held. G Privilege is held with the GRANT option. Y Privilege is held without the GRANT option. If the GRANTEE is a package, its collection name. Otherwise, a string of length zero. If the GRANTEE is a package, the consistency token of the DBRM from which the package wasderived. Otherwise, blank. Time when the GRANT statement was executed. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name GRANTORTYPE

Data Type CHAR(1)

Description Indicates the type of grantor: blank Authorization ID L Role

SYSIBM.SYSSEQUENCEDEP Records the dependencies of identity columns on tables. Column Name BSEQUENCEID DCREATOR

Data Type INTEGER VARCHAR(128)

IBMREQD

CHAR(1)

DNAME

VARCHAR(128)

DCOLNAME DTYPE


BSCHEMA

VARCHAR(129)

BNAME

VARCHAR(128)

DSCHEMA

VARCHAR(128)

DOWNER

VARCHAR(128)

DOWNERTYPE

CHAR(1)

Description Internal identifier of the identity column or sequence. Owner of the object that is dependent on this identity column or sequence. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. Name of the object that is dependent on this identity column or sequence. Name of the identity column. Blank for SQL function rows. The type of object that is dependent on this sequence: F SQL function I Identity column X Implicit DOCID column that is created on a base tabl with XML blank Represents an identity column created prior to Version 8 The schema name of the sequence, will be a string of length zero for an object created prior to Version 8. The sequence name (generated by DB2 for an identity column), will be a string of length zero for an object created prior to Version 8. The qualifier of the object that is dependent on this sequence, will be a string of length zero for an object created prior to Version 8. The owner of the object that is dependent on this sequence. This will be a string of length zero for an object that was created prior to Version 9. The type of owner: Blank An authorization ID L A role

SYSIBM.SYSSEQUENCES Contains one row for each identity column or user-defined sequence. Column Name SCHEMA


OWNER

VARCHAR(128)

NAME

VARCHAR(128)

SEQTYPE

CHAR(1)

®

DB2 9 for z/OS

Description Schema of the sequence. For an identity column, the value of TBCREATOR from the SYSCOLUMNS entry for the column. Owner of the sequence. For an identity column, the value of TBCREATOR from the SYSCOLUMNS entry for the column. Name of the identity column or sequence. (The name for an identity is generated by DB2.) Type of sequence object: I An identity column S A userdefined sequence X An implicitly created DOCID column 301

®


Data Type

SEQUENCEID CREATEDBY

INTEGER VARCHAR(128)

INCREMENT

DECIMAL(31,0)

START MAXVALUE MINVALUE CYCLE

DECIMAL(31,0) DECIMAL(31,0) DECIMAL(31,0) CHAR(1)

CACHE

INTEGER

ORDER

CHAR(1)

DATATYPEID

INTEGER

SOURCETYPEID

INTEGER

CREATEDTS

TIMESTAMP

ALTEREDTS

TIMESTAMP

MAXASSIGNEDVAL

DECIMAL(31,0)

IBMREQD

CHAR(1)

REMARKS

VARCHAR(254)

PRECISION

SMALLINT

RESTARTWITH

DECIMAL(31,0)

OWNERTYPE

CHAR(1)

RELCREATED

CHAR(1)

302

Description for a base table that contains XML data. Internal identifier of the identity column or sequence. Primary authorization ID of the user who created the sequence or identity column. Increment value (positive or negative, within INTEGER scope). Start value. Maximum value allowed for the data type. Minimum value allowed for the data type. Whether cycling will occur when a boundary is reached: N No Y Yes Number of sequence values to preallocate in memory for faster access. A value of 0 indicates that values are not to be preallocated. Whether the values must be generated in order Y Yes N No For a built-in data type, the internal ID of the built-in type. For a distinct type, the internal ID of the distinct type. For a built-in data type, 0. For a distinct type, the internal ID of the built-in data type upon which the distinct type is sourced. Timestamp when the identity column or sequence was created. Timestamp when the identity column or sequence was ALTERed. Last possible assigned value. Initialized to null when the sequence object is created. Updated each time the next chunk of n values is cached, where n is the value for CACHE. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. Character string provided by user with the COMMENT statement. The value is blank for an identity column. The precision defined for a sequence with a decimal or numeric type. Value is 5 for SMALLINT, 10 for INTEGER, or the actual precision specified by the user for the decimal data type. The value is 0 for rows created prior to Version 8. The RESTART WITH value specified for a sequence during ALTER or NULL. The RESTART WITH value is reset to NULL during the first value generation after the ALTER. The value is NULL if no ALTER with RESTART WITH has happened. Indicates the type of owner: blank Authorization ID L Role The release of DB2 that is used to create the object. Blank if created prior to Version 9.

®

DB2 9 for z/OS

®


SYSIBM.SYSSTMT Contains one or more rows for each SQL statement of each DBRM. Column Name NAME PLNAME PLCREATOR SEQNO


STMTNO

SMALLINT

SECTNO IBMREQD

SMALLINT CHAR(1)

TEXT

VARCHAR(3800)

ISOLATION

CHAR(1)

®

DB2 9 for z/OS

Description Name of the DBRM. Name of the application plan. Authorization ID of the owner of the application plan. Sequence number of this row with respect to a statement of the DBRM. The numbering starts with zero. The statement number of the statement in the source program. A statement number greater than 32767 is displayed as zero (see STMTNOI for the statement number). The section number of the statement. Whether the row came from the basic machine-readable material (MRM) tape: N No Y Yes Text or portion of the text of the SQL statement. Isolation level for the SQL statement: R RR (repeatable read) T RS (read stability) S CS (cursor stability) U UR (uncommitted read) L KEEP UPDATE LOCKS for an RS isolation X KEEP UPDATE LOCKS for an RR isolation blank The WITH clause was not specified on this statement. The isolation level is recorded in SYSPACKAGE.ISOLATION and in SYSPLAN.ISOLATION.

303

®

DB2 9 z/OS Reference Guide Column Name STATUS

Data Type CHAR(1)

Description Status of binding the statement: A Distributed - statement uses DB2 private protocol access. The statement will be parsed and executed at the server using defaults for input variables during access path selection. B Distributed - statement uses DB2 private protocol access. The statement will be parsed and executed at the server using values for input variables during access path selection. C Compiled - statement was bound successfully using defaults for input variables during access path selection. E Explain - statement is an SQL EXPLAIN statement. The explain is done at bind time using defaults for input variables during access path selection. F Parsed - statement did not bind successfully and VALIDATE(RUN) was used. The statement will be rebound at execution time using values for input variables during access path selection. G Compiled - statement bound successfully, but REOPT is specified. The statement will be rebound at execution time using values for input variables during access path selection. H Parsed - statement is either a data definition statement or a statement that did not bind successfully and VALIDATE(RUN) was used. The statement will be rebound at execution time using defaults for input variables during access path selection. Data manipulation statements use defaults for input variables during access path selection. I Indefinite - statement is dynamic. The statement will be bound at execution time using defaults for input variables during access path selection. J Indefinite - statement is dynamic. The statement will be bound at execution time using values for input variables during access path selection. K Control - CALL statement. L Bad - the statement has some allowable error. The bind continues but the statement cannot be executed. blank The statement is non-executable, or was bound in DB2 release prior to Version 5.

ACCESSPATH

CHAR(1)

STMTNOI

INTEGER

SECTNOI EXPLAINABLE

INTEGER CHAR(1)

For static statements, indicates if the access path for the statement is based on user-specified optimization hints. A value of 'H' indicates that optimization hints were used. A blank value indicates that the access path was determined without the use of optimization hints, or that there is no access path associated with the statement. For dynamic statements, the value is blank. The statement number of the statement in the source program. The section number of the statement. Contains one of the following values:

304

®

DB2 9 for z/OS

®


Data Type

QUERYNO

INTEGER

PLCREATOR

CHAR(1)

Description Y Indicates that the SQL statement can be used with the EXPLAIN function and may have rows describing its access path in the userid.PLAN_TABLE. N Indicates that the SQL statement does not have any rows describing its access path in the userid.PLAN_TABLE Blank Indicates that the SQL statement was bound prior to V7. The query number of the SQL statement in the source program. SQL statements bound prior to V7 have a default value of –1. Statements bound V7 or later used the value specified on the QUERYNO clause on SELECT, UPDATE, INSERT, DELETE, EXPLAIN, and DECLARE CURSOR statements. If the QUERYNO clause is not specified, the query number is set to the statement number. Indicates the type of creator: blank Authorization ID L Role

SYSIBM.SYSSTOGROUP Contains one row for each storage group. Column Name NAME CREATOR VCATNAME SPACE

Data Type VARCHAR(128) VARCHAR(128) VARCHAR(128) INTEGER

SPCDATE

CHAR(5)

IBMREQD

CHAR(1)

CREATEDBY

VARCHAR(128)

STATSTIME

TIMESTAMP

CREATEDTS

TIMESTAMP

ALTEREDTS

TIMESTAMP

SPACEF DATACLAS MGMTCLAS

FLOAT VARCHAR(24) VARCHAR(24)

STORCLAS CREATOR TYPE RELCREATED

VARCHAR(24) CHAR(1)

®

DB2 9 for z/OS

CHAR(1)

Description Name of the storage group. Authorization ID of the owner of the storage group. Name of the integrated catalog facility catalog. Number of kilobytes of DASD storage allocated to the storage group as determined by the last execution of the STOSPACE utility. Date when the SPACE column was last updated, in the form yyddd. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Primary authorization ID of the user who created the storage group. If the STOSPACE utility was executed for the storage group, date and time when STOSPACE was last executed. Time when the CREATE statement was executed for the storage group. Time when the most recent ALTER STOGROUP statement was executed for the storage group. If no ALTER STOGROUP statement has been applied, ALTEREDTS has the value of CREATEDTS. Kilobytes of DASD storage for the storage group. Name of the SMS data class. Blank if data class is not used. Name of the SMS management class. Blank if management class is not used. Name of the SMS storage class. Blank if storage class is not used. Indicates the type of creator: blank Authorization ID L Role The release of DB2 that is used to create the object. Blank if created prior to Version 9. 305

®


SYSIBM.SYSSTRINGS Contains information about character conversion. Each row describes a conversion from one coded character set to another. If OS/390 Version 2 Release 9 is installed, additional conversions that are supported. Column Name INCCSID

Data Type INTEGER

OUTCCSID

INTEGER

TRANSTYPE

CHAR(2)

ERRORBYTE

CHAR(1)

SUBBYTE

CHAR(1)

TRANSPROC

VARCHAR(24)

IBMREQD

CHAR(1)

TRANSTAB

VARCHAR(256)

Description The source CCSID for the character conversion represented by this row. The target CCSID for the character conversion represented by this row. Indicates the nature of the conversion. Values can be: GG GRAPHIC to GRAPHIC MM EBCDIC MIXED to EBCDIC MIXED MS EBCDIC MIXED to SBCS PM ASCII MIXED to EBCDIC MIXED PS ASCII MIXED to SBCS SM SBCS to EBCDIC MIXED SS SBCS to SBCS MP EBCDIC MIXED to ASCII MIXED PP ASCII MIXED to ASCII MIXED SP SBCS to ASCII MIXED The byte used in the conversion table as an error byte. Null indicates the absence of an error byte. The byte used in the conversion table as a substitution character. Null indicates the absence of a substitution character. The name of a module or blanks. If IBMREQD is 'N', a nonblank value is the name of a conversion procedure provided by the user. If IBMREQD is 'Y', a nonblank value is the name of a DB2 module that contains DBCS conversion tables. The first five characters of the name of a user-provided conversion procedure must not be 'DSNXV'; these characters are used to distinguish user-provided conversion procedures from DB2 modules that contain DBCS conversion tables. Whether the row came from the basic machine-readable material (MRM) tape: N=No , Y=Yes Either a conversion table or an empty string.

SYSIBM.SYSSYNONYMS Contains one row for each synonym of a table or view. Column Name NAME CREATOR TBNAME TBCREATOR IBMREQD


CREATEDBY CREATEDTS

VARCHAR(128) TIMESTAMP

306

Description Synonym for the table or view. Authorization ID of the owner of the synonym. Name of the table or view. Schema of the owner of the table or view. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Primary authorization ID of the user who created the synonym. Time when the CREATE statement was executed for the synonym. The value is '0001-01.01.00.00.00.000000' for ®

DB2 9 for z/OS

®


Data Type

CREATORTYPE

CHAR(1)

RELCREATED

CHAR(1)

Description synonyms created in a DB2 release prior to Version 5. Indicates the type of creator: blank Authorization ID L Role The release of DB2 that is used to create the object. Blank if created prior to Version 9.

SYSIBM.SYSTABAUTH Records the privileges that users hold on tables and views. Column Name GRANTOR


GRANTEE

VARCHAR(128)

GRANTEETYPE

CHAR(1)

DBNAME

VARCHAR(24)

SCREATOR

VARCHAR(128)

STNAME

VARCHAR(128)

TCREATOR TTNAME AUTHHOWGOT


DATEGRANTED TIMEGRANTED UPDATECOLS

CHAR(6) CHAR(8) CHAR(1)

®

DB2 9 for z/OS

Description Authorization ID of the user who granted the privileges. Could also be PUBLIC, or PUBLIC followed by an asterisk. Authorization ID of the user who holds the privileges or the name of an application plan or package that uses the privileges. PUBLIC for a grant to PUBLIC. PUBLIC followed by an asterisk for a grant to PUBLIC AT ALL LOCATIONS. Type of grantee: blank An authorization ID L Role P An application plan or a package. The grantee is a package if COLLID is not blank. If the privileges were received from a user with DBADM, DBCTRL, or DBMAINT authority, DBNAME is the name of the database on which the GRANTOR has that authority. Otherwise, DBNAME is blank. If the row of SYSIBM.SYSTABAUTH was created as a result of a CREATE VIEW statement, SCREATOR is the schema of the owner of a table or view referred to in the CREATE VIEW statement. Otherwise, SCREATOR is the same as TCREATOR. If the row of SYSIBM.SYSTABAUTH was created as a result of a CREATE VIEW statement, STNAME is the name of a table or view referred to in the CREATE VIEW statement. Otherwise, STNAME is the same as TCREATOR. Schema of the owner of the table or view. Name of the table or view. Authorization level of the user from whom the privileges were received. This authorization level is not necessarily the highest authorization level of the grantor. blank Not applicable C DBCTL D DBADM L SYSCTRL M DBMAINT S SYSADM Date the privileges were granted, in the form yymmdd. Time the privileges were granted, in the form hhmmssth. The value of this column is blank if the value of UPDATEAUTH applies uniformly to all columns of the table or view. The value is an asterisk (*) if the value of UPDATEAUTH applies to some columns but not to others. In this case, rows will exist in SYSIBM.SYSCOLAUTH with matching timestamps and 307

®


Data Type

ALTERAUTH

CHAR(1)

DELETEAUTH

CHAR(1)

INDEXAUTH

CHAR(1)

INSERTAUTH

CHAR(1)

SELECTAUTH

CHAR(1)

UPDATEAUTH

CHAR(1)

IBMREQD

CHAR(1)

COLLID

VARCHAR(128)

CONTOKEN

CHAR(8)

REFERENCESAUTH

CHAR(1)

REFCOLS

CHAR(1)

GRANTEDTS TRIGGERAUTH

TIMESTAMP CHAR(1)

GRANTORTYPE

CHAR(1)

308

Description PRIVILEGE = blank. These rows list the columns on which update privileges have been granted. Whether the GRANTEE can alter the table: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can delete rows from the table or view: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can create indexes on the table: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can insert rows into the table or view: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can select rows from the table or view: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can update rows of the table or view: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes If the GRANTEE is a package, its collection name. Otherwise, the value is blank. If the GRANTEE is a package, the consistency token of the DBRM from which the package was derived. Otherwise, the value is blank. Whether the GRANTEE can create or drop referential constraints in which the table is a parent. blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option The value of this column is blank if the value of REFERENCESAUTH applies uniformly to all columns of the table. The value is an asterisk(*) if the value of REFERENCESAUTH applies to some columns but not to others. In this case, rows will exist in SYSIBM.SYSCOLAUTH with PRIVILEGE = R and matching timestamps that list the columns on which reference privileges have been granted. Time when the GRANT statement was executed. Whether the GRANTEE can create triggers in which the table is named as the triggering table: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Indicates the type of grantor: ®

DB2 9 for z/OS

®


Data Type

Description blank Authorization ID L Role

SYSIBM.SYSTABCONST Contains one row for each unique constraint (primary key or unique key) created in DB2 for OS/390 Version 7 or later. Column Name CONSTNAME TBCREATOR


TBNAME CREATOR TYPE

VARCHAR(128) CHAR(8) CHAR(1)

IXOWNER

VARCHAR(128)

IXNAME

VARCHAR(128)

CREATEDTS

TIMESTAMP

IBMREQD COLCOUNT CREATORTYPE

CHAR(1) DEFAULT ’N ’ SMALLINT CHAR(1)

RELCREATED

CHAR(1)

Description Name of the constraint. Schema of the owner of the table on which the constraint is defined. Name of the table on which the constraint is defined. Authorization ID under which the constraint was created. Type of constraint: P Primary key U Unique key Schema of the index enforcing the constraint or blank if index has not been created yet. Name of the index enforcing the constraint or blank if index has not been created yet. Time when the statement to create the constraint was executed. A value of Y indicates that the row name from the basic machine-readable material (MRM) tape. Number of columns in the constraint. Indicates the type of creator: blank Authorization ID L Role The release of DB2 that is used to create the object. Blank if created prior to Version 9.

SYSIBM.SYSTABLEPART Contains one row for each non-partitioned tablespace and one row for each partition of a partitioned tablespace. Column Name PARTITION TSNAME DBNAME IXNAME

Data Type SMALLINT VARCHAR(24) VARCHAR(24) VARCHAR(128)

IXCREATOR

VARCHAR(128)

PQTY

INTEGER

®

DB2 9 for z/OS

Description Partition number; 0 if tablespace is not partitioned. Name of the tablespace. Name of the database that contains the tablespace. Name of the partitioning index. This column is blank if the tablespace is not partitioned. Schema of the owner of the partitioning index. This column is blank if the tablespace is not partitioned. Primary space allocation in units of 4KB storage blocks. For user-managed data sets, the value is set to the primary space allocation only if RUNSTATS TABLESPACE with UPDATE(ALL) or UPDATE(SPACE) is executed; otherwise, the value is zero. PQTY is based on a value of PRIQTY in the appropriate CREATE or ALTER TABLESPACE statement. Unlike PQTY, however, PRIQTY asks for space 309

®


Data Type

SQTY

SMALLINT

STORTYPE

CHAR(1)

STORNAME

VARCHAR(128)

VCATNAME

VARCHAR(24)

CARD

INTEGER

FARINDREF

INTEGER

NEARINDREF

INTEGER

PERCACTIVE

SMALLINT

PERCDROP

SMALLINT

IBMREQD

CHAR(1)

LIMITKEY

VARCHAR(765)

FREEPAGE PCTFREE CHECKFLAG

SMALLINT SMALLINT CHAR(1)

SPACE

INTEGER

310

Description in 1KB units. Secondary space allocation in units of 4KB blocks. For usermanaged data sets, the value is set to the secondary space allocation only if RUNSTATS TABLESPACE with UPDATE(ALL) or UPDATE(SPACE) is executed; otherwise, the value is zero. SQTY is based on a value of SECQTY in the appropriate CREATE or ALTER TABLESPACE statement. Unlike SQTY, however, SECQTY asks for space in 1KB units. If the value does not fit into the column, the value of the column is 0. See the description of column SECQTYI. Type of storage allocation: E Explicit (storage group not used) I Implicit (storage group used) Name of storage group used for space allocation. Blank if storage group not used. Name of integrated catalog facility catalog used for space allocation. Number of rows in the tablespace or partition or, if the tablespace is a LOB tablespace, the number of LOBs in the tablespace. The value is 2 147 483 647 if the number of rows is greater than or equal to 2 147 483 647. The value is -1 if statistics have not been gathered. Number of rows that have been relocated far from their original page. The value is -1 if statistics have not been gathered. Not applicable if the tablespace is a LOB tablespace. Number of rows that have been relocated near their original page. The value is -1 if statistics have not been gathered. Not applicable if the tablespace is a LOB tablespace. Percentage of space occupied by rows of data from active tables. The value is -1 if statistics have not been gathered. The value is -2 if the tablespace is a LOB tablespace. Percentage of space occupied by rows of dropped tables. The value is -1 if statistics have not been gathered. The value is 0 for segmented tablespaces. Not applicable if the table is an auxiliary table. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes The high value of the partition in external format. The value is 0 if the tablespace is not partitioned. Number of pages loaded before a page is left as free space. Percentage of each page left as free space. C The tablespace partition is in a check pending status and there are rows in the table that can violate referential constraints, table check constraints, or both. blank The tablespace is not a partition, or does not contain rows that may violate referential constraints, table check constraints, or both. Number of kilobytes of DASD storage allocated to the tablespace partition, as determined by the last execution of ®

DB2 9 for z/OS

®


Data Type

COMPRESS

CHAR(1)

PAGESAVE

SMALLINT

STATSTIME

TIMESTAMP

GBPCACHE

CHAR(1)

CHECKRID5B

CHAR(5)

®

DB2 9 for z/OS

Description the STOSPACE utility or RUNSTATS utility. The value is 0 if STOSPACE or RUNSTATS has not been run. The value is updated by STOSPACE if the tablespace is related to a storage group. The value is updated by RUNSTATS if the utility is executed as RUNSTATS TABLESPACE with UPDATE(ALL) or UPDATE(SPACE). The value is -1 if the table space was defined with the DEFINE NO clause, which defers the physical creation of the data sets until data is first inserted into one of the partitions, and data has yet to be inserted. Indicates the following: o For a tablespace partition, whether the COMPRESS attribute for the partition is YES. o For a non-partitioned tablespace, whether the COMPRESS attribute is YES for the tablespace. Values for the column can be: Y Compression is defined for the tablespace blank No compression Percentage of pages saved in the tablespace or partition as a result of defining the tablespace with COMPRESS YES or other compression routines. For example, a value of 25 indicates a savings of 25%, so that the pages required are only 75% of what would be required without data compression. The calculation includes overhead bytes for each row, the bytes required for dictionary, and the bytes required for the current FREEPAGE and PCTFREE specification for the table space or partition. This calculation is based on an average row length, and the result varies depending on the actual lengths of the rows. The value is 0 if there are no savings from using data compression, or if statistics have not been gathered. The value can be negative, if for example, data compression causes an increase in the number of pages in the data set. If RUNSTATS updated the statistics, the date and time when the last invocation of RUNSTATS updated the statistics. The default value is '0001-0101.00.00.00.000000'. Group buffer pool cache option specified for this tablespace or tablespace partition. A Changed and unchanged pages are cached in the group buffer pool. N No data is cached in the group buffer pool. S Only changed system pages, such as space map pages that do not contain actual data values, are cached in the group buffer pool. blank Only changed pages are cached in the group buffe pool. Blank if the table or partition is not in a check pending status (CHECKFLAG is blank), or if the tablespace is not partitioned. Otherwise, the RID of the first row of the tablespace partition that can violate referential constraints, table check 311

®


Data Type

TRACKMOD

CHAR(1)

EPOCH

INTEGER

SECQTYI

INTEGER

CARDF

FLOAT

IPREFIX

CHAR(1)

ALTEREDTS

TIMESTAMP

SPACEF

FLOAT(8)

DSNUM

FLOAT(8)

EXTENTS

INTEGER

LOGICAL_PART

SMALLINT

LIMITKEY_INTERNAL

VARCHAR(512)

OLDEST_VERSION

SMALLINT

CREATDTS AVGROWLEN FORMAT

TIMESTAMP INTEGER CHAR(1)

RELCREATED

CHAR(1)

REORG_LR_TS

TIMESTAMP

Description constraints, or both; or the value is X'0000000000', indicating that any row can violate referential constraints. Whether to track the page modifications in the space map pages: N No blank Yes A number that is incremented whenever an operation that changes the location of rows in a table occurs. Secondary space allocation in units of 4KB storage. For user-managed data sets, the value is the secondary space allocation in units of 4KB blocks if RUNSTATS TABLESPACE with UPDATE(SPACE) or UPDATE(ALL) is executed; otherwise, the value is zero. Number of rows in the tablespace or partition, or if the tablespace is a LOB tablespace, the number of LOBS in the tablespace. The value is -1 if statistics have not been gathered. Number of rows in the tablespace or partition, or if the tablespace is a LOB tablespace, the number of LOBs in the tablespace. The value is –1 statistics have not been gathered. Time when the most recent ALTER INDEX statement was executed for the index. If no ALTER INDEX statement has been applied, the value is '0001-01-01.00.00.00.000000'. Kilobytes of DASD storage. The value is –1 if statistics have not been gathered. This is an updatable column. Number of data sets. The value is –1 if statistics have not been gathered. This is an updatable column. Number of data set extents. The value is –1 if statistics have not been gathered. This is an updatable column. The logical partition for table spaces created with either table or index controlled partitioning. The highest value of the limit key of the partition in an internal format. The version number of the oldest format of data in the table past and any image copies at the part level. Time when the partition was created. Average length of rows for the table in the table space or part Indicates the format of the rows in the table space or partition: R Indicates reordered row format blank Indicates basic row format or a LOB tablespace The release of DB2 that is used to create the object. Blank if created prior to Version 9. The time when the REORG or LOAD REPLACE utility last occurred. The default value is '0001-01-01.00.00.00.000000'.

SYSIBM.SYSTABLEPART_HIST Contains rows from SYSTABLEPART. Whenever rows are added or changed in SYSTABLEPART, the rows are also written to the new history table. Rows in this table can be inserted, updated, and deleted. 312

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name PARTITION TSNAME DBNAME PQTY


SECQTYI

SMALLINT

FARINDREF

INTEGER

NEARINDREF

INTEGER

PERCACTIVE

SMALLINT

PERCDROP

SMALLINT

SPACEF

FLOAT(8)

PAGESAVE

SMALLINT

STATSTIME

TIMESTAMP

CARDF

FLOAT(8)

EXTENTS

INTEGER

DSNUM

INTEGER

IBMREQD

CHAR(1)

®

DB2 9 for z/OS

Description Partition number; 0 if tablespace is not partitioned. Name of the tablespace. Name of the database that contains the tablespace. Primary space allocation in units of 4KB storage blocks. The value of this column is 0 if a storage group is not used. PQTY is based on a value of PRIQTY in the appropriate CREATE or ALTER TABLESPACE statement. Secondary space allocation in units of 4KB blocks. If a storage group is not used the value is 0. Number of rows that have been relocated far from their original page. The value is -1 if statistics have not been gathered. Not applicable if the tablespace is a LOB tablespace. Number of rows that have been relocated near their original page. The value is -1 if statistics have not been gathered. Not applicable if the tablespace is a LOB tablespace. Percentage of space occupied by rows of data from active tables. The value is -1 if statistics have not been gathered. The value is -2 if the tablespace is a LOB tablespace. Percentage of space occupied by rows of dropped tables. The value is -1 if statistics have not been gathered. The value is 0 for segmented tablespaces. Not applicable if the table is an auxiliary table. Number of kilobytes of DASD storage allocated to the tablespace partition. The value is -1 if statistics have not been gathered. Percentage of pages saved in the tablespace or partition as a result of defining the tablespace with COMPRESS YES or other compression routines. For example, a value of 25 indicates a savings of 25%, so that the pages required are only 75% of what would be required without data compression. The calculation includes overhead bytes for each row, the bytes required for dictionary, and the bytes required for the current FREEPAGE and PCTFREE specification for the tablespace or partition. This calculation is based on an average row length, and the result varies depending on the actual lengths of the rows. The value is 0 if there are no savings from using data compression, or if statistics have not been gathered. The value an be negative, if for example, data compression causes an increase in the number of pages in the data set. If RUNSTATS updated the statistics ,the date and time when the last invocation of RUNSTATS updated the statistics. The default value is ’0001-01-01.00.00.00.000000 ’. Number of rows in the tablespace or partition ,or if the tablespace is a LOB tablespace , the number of LOBS in the tablespace. The value is -1 if statistics have not been gathered. Number of data set extents. The value is -1 if statistics have not been gathered. Data set number within the tablespace. For partitioned tablespaces, this value corresponds to the partition number for a single partition copy, or 0 for a copy of an entire partitioned tablespace or index space. The value is -1 if statistics have not been gathered. A value of Y indicates that the row came from the basic machinereadable material (MRM) tape. 313

®

DB2 9 z/OS Reference Guide Column Name AVGROWLEN

Data Type INTEGER

Description Average length of rows for the table in the table space or part

SYSIBM.SYSTABLES Contains one row for each table, view, or alias. Column Name NAME CREATOR TYPE

Data Type VARCHAR(128) VARCHAR(128) CHAR(1)

DBNAME

VARCHAR(24)

TSNAME

VARCHAR(24)

DBID

SMALLINT

OBID

SMALLINT

COLCOUNT

SMALLINT

EDPROC

VARCHAR(24)

VALPROC

VARCHAR(24)

CLUSTERTYPE

CHAR(1)

NPAGES

INTEGER

PCTPAGES

SMALLINT

314

Description Name of the table, view, or alias. Schema of the owner of the table, view, or alias. Type of object: A Alias C Clone table G Created global temporary table M Materialized query table P Implicit table created for XML columns T Table V View X Auxiliary table For a table, or a view of tables, the name of the database that contains the tablespace named in TSNAME. For a created temporary table, an alias, or a view of a view, the value is DSNDB06. For a table, or a view of one table, the name of the table space that contains the table. For a view of more than one table, the name of a tablespace that contains one of the tables. For a created temporary table, the value is SYSPKAGE. For a view of a view, the value is SYSVIEWS. For an alias, it is SYSDBAUT. Internal identifier of the database; 0 if the row describes a view, alias, or created temporary table. Non-zero if the view has an INSTEAD OF trigger defined. Internal identifier of the table; 0 if the row describes a view, an alias, or a created temporary table. Non-zero if the view has an INSTEAD OF trigger defined. Number of columns in the table or view. The value is 0 if the row describes an alias. Name of the edit procedure; blank if the row describes a view or alias or a table without an edit procedure. Name of the validation procedure; blank if the row describes a view or alias or a table without a validation procedure. Whether RESTRICT ON DROP applies: blank No Y Yes. Neither the table nor any tablespace or database that contains the table can be dropped. Total number of pages on which rows of the table appear. The value is -1 if statistics have not been gathered, or the row describes a view, an alias, a created temporary table, or an auxiliary table. This is an updatable column. Percentage of active tablespace pages that contain rows of the table. A page is termed active if it is formatted for rows, regardless of whether it contains any. If the table space is segmented, the percentage is based on the number of active pages in the set of segments assigned to ®

DB2 9 for z/OS

®


Data Type

IBMREQD

CHAR(1)

REMARKS

VARCHAR(254)

PARENTS

SMALLINT

CHILDREN

SMALLINT

KEYCOLUMNS

SMALLINT

RECLENGTH

SMALLINT

STATUS

CHAR(1)

KEYOBID

SMALLINT

LABEL

VARCHAR(90)

CHECKFLAG

CHAR(1)

®

DB2 9 for z/OS

Description the table. The value is -1 if statistics have not been gathered, or the row describes a view, alias, created temporary table, or auxiliary table. This is an updatable column. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes A character string provided by the user with the COMMENT ON statement. Number of relationships in which the table is a dependent. The value is 0 if the row describes a view, an alias, a created temporary table or MQT. Number of relationships in which the table is a parent. The value is 0 if the row describes a view, an alias, a created temporary table or MQT. Number of columns in the table's primary key. The value is 0 if the row describes a view, an alias, or a created temporary table. For user tables, the maximum length of any record in the table. Length is 8+N+L, where: • The number 8 accounts for the header (6 bytes) and the ID map entry (2 bytes). • N is 10 if the table has an edit procedure, or 0 otherwise. • L is the sum of the maximum column lengths. In determining a column's maximum length, take into account whether the column allows nulls and the data type of the column. If the column can contain nulls and is not a LOB or ROWID column, add 1 byte for a null indicator. Use 4 bytes for the length of a LOB column and 19 bytes for the length of a ROWID column. If the column has a varying-length data type (for example, VARCHAR, CLOB, or BLOB), add 2 bytes for a length indicator. The value is 0 if the row describes a view, alias, or auxiliary table. Indicates the status of the table definition: I The definition of the table is incomplete. The TABLESTATUS column indicates the reason for the table definition being incomplete. R An error occurred when an attempt wa made to regenerate the internal representation of the view. X The table has a parent index and the table definition is complete. blank The table has no parent index, or is a catalog table, or the row describes a view or alias. The definition of the table, view, or alias is complete. Internal DB2 identifier of the index that enforces uniqueness of the table's primary key; 0 if not applicable. The label as given by a LABEL ON statement; otherwise an empty string. C The tablespace that contains the table is in a check pending status and there are rows in the 315

®


Data Type

AUDITING

CHAR(1)

CREATEDBY

VARCHAR(128)

LOCATION

VARCHAR(128)

TBCREATOR

VARCHAR(128)

TBNAME

VARCHAR(128)

CREATEDTS

TIMESTAMP

ALTEREDTS

TIMESTAMP

DATACAPTURE

CHAR(1)

RBA1

CHAR(6)

RBA2

CHAR(6)

316

Description table that can violate referential constraints, table check constraints, or both. R The table is an mqt that may contain in consistent data. blank The table contains no rows that violate referential constraints, table check constraints, or both; or the row describes a view, alias, or created temporary table. Value of the audit option: A AUDIT ALL C AUDIT CHANGE blank AUDIT NONE, or the row describes a view, an alias, or a created temporary table. Primary authorization ID of the user who created the table, view, or alias. Location name of the object of an alias. Blank for a table, a view, or for an alias that was not defined with a three-part object name. • For an alias, the schema of the referred to table or view • For a base table that is involved in a clone relationship, the name of the creator of the clone table • For a clone table that is involved in a clone relationship, the name of the creator of the base table • Otherwise, TBCREATOR is blank • For an alias, the name for the referred to table or view • For a base table that is involved in a clone relationship, the name of the clone table • For a clone table that is involved in a clone relationship, the name of the base table • Otherwise, TBNAME is blank Time when the CREATE statement was executed for the table, view, or alias. For a table, the time when the latest ALTER TABLE statement was applied. If no ALTER TABLE statement has been applied, or if the row is for a view or alias, ALTEREDTS has the value of CREATEDTS. Records the value of the DATACAPTURE option for a table: blank No Y Yes For a created temporary table, DATACAPTURE is always blank. The log RBA when the table was created. Otherwise, RBA1 is X'000000000000', indicating that the log RBA is not known, or that the object is a view, an alias, or a created temporary table. For data sharing it is the LRSN. The log RBA when the table was last altered. Otherwise, RBA2 is X'000000000000' indicating that the log RBA is not known, or that the object is a view, an alias, or a created ®

DB2 9 for z/OS

®


Data Type

PCTROWCOMP

SMALLINT

STATSTIME

TIMESTAMP

CHECKS

SMALLINT

CARDF

FLOAT

CHECKRID5B

CHAR(5)

ENCODING_SCHEME

CHAR(1)

TABLESTATUS

VARCHAR(30)

NPAGESF

FLOAT(8)

®

DB2 9 for z/OS

Description temporary table. RBA1 will equal RBA2 if the table has not been altered. For data sharing it is the LRSN. Percentage of rows compressed within the total number of active rows in the table. This includes any row in a table space that is defined with COMPRESS YES. The value is -1 if statistics have not been gathered, or the row describes a view, alias, created temporary table, or auxiliary table. This is an updatable column. If RUNSTATS updated the statistics, the date and time when the last invocation of RUNSTATS updated the statistics. The default value is '0001-01-01.00.00.00.000000'. For a created temporary table, the value of STATSTIME is always the default value. This is an updatable column. Number of check constraints defined on the table. The value is 0 if the row describes a view, an alias, or a created temporary table, or if no constraints are defined on the table. Total number of rows in the table or total number of LOBs in an auxiliary table. The value is -1 if statistics have not been gathered or the row describes a view, alias, or created temporary table. This is an updatable column. Blank if the table or partition is not in a check pending status (CHECKFLAG is blank), if the tablespace is not partitioned, or if the table is a created temporary table. Otherwise, the RID of the first row of the tablespace partition that can violate referential constraints, table check constraints, or both; or the value is X'0000000000', indicating that any row can violate referential constraints. Default encoding scheme for tables, views, and local aliases: E EBCDIC A ASCII M Multiple CCSID set or multiple encoding schemes U UNICODE blank For remote aliases The value is 'E' for tables in non-work-file databases and blank for tables in work-file databases created prior to Version 5 or the default database, DSNDB04. Indicates the reason for an incomplete table definition: L Definition is incomplete because an auxiliary table or auxiliary index has not been defined for a LOB column. P Definition is incomplete because the table lacks a parent index. R Definition is incomplete because the table lacks a required index on a row ID. U Definition is incomplete because the table lacks a required index on a unique key. V An error occurred when an attempt was made to regenerate the internal representation of the view. blank Definition is complete. Number of pages used by the table. The value is –1 if 317

®


Data Type

SPACEF

FLOAT(8)

AVGROWLEN

INTEGER

RELCREATED NUM_DEPT_MQTS VERSION PARTKEYCOLNUM SPLIT_ROWS

CHAR(1) SMALLINT SMALLINT SMALLINT CHAR(16)

SECURITY_LABEL

CHAR(1)

Description statistics have not been gathered. This is an updatable column. Kilobytes of DASD storage. The value is –1 if statistics have not been gathered. This is an updatable column. Average length of rows for the tables in the tablespace. If the tablespace is compressed, the value is the compressed row length. If the tablespace is not compressed, the value is the uncompressed row. The value is –1 if statistics have not been gathered. Release of DB2 that was used to create the object. Number of dependent MQTs. Version of the data row format for this table. Number of columns in the partitioning key. Value is blank except for VOLATILE tables which will have a Y in the field to indicate to DB2 to use index access on the table wheneve possible. Only meaningful it TYPE column is T or M. Indicates if table has multi-level security: Blank No multi-level security R Table has multi-level security with row granularity

SYSIBM.SYSTABLES_HIST Contains rows from SYSTABLES. Whenever rows are added or changed in SYSTABLES, the rows are also written to the new history table. Rows in this table can be inserted, updated, and deleted. Column Name NAME CREATOR DBNAME


TSNAME

VARCHAR(24)

COLCOUNT

SMALLINT

PCTPAGES

SMALLINT

PCTROWCOMP

SMALLINT

318

Description Name of the table, view, or alias. Schema of the owner of the table, view, or alias. For a table, or a view of tables ,the name of the database that contains the tablespace named in TSNAME. For a temporary table, an alias, or a view of a view, the value is DSNDB06. For a table, or a view of one table, the name of the tablespace that contains the table. For a view of more than one table, the name of a tablespace that contains one of the tables. For a temporary table, the value is SYSPKAGE. For a view of a view, the value is SYSVIEWS. For an alias, it is SYSDBAUT. Number of columns in the table or view. The value is 0 if the row describes an alias. Percentage of active tablespace pages that contain rows of the table. A page is termed active if it is formatted for rows, regardless of whether it contains any. If the tablespace is segmented, the percentage is based on the number of active pages in the set of segments assigned to the table. The value is -1 if statistics have not been gathered, or the row describes a view, alias, temporary table, or auxiliary table. Percentage of rows compressed within the total number of active rows in the table. This includes any row in a tablespace that is defined with COMPRESS YES. The value is -1 if statistics have not been gathered, or the row ®

DB2 9 for z/OS

®


Data Type

STATSTIME

TIMESTAMP

CARDF

FLOAT(8)

NPAGESF

FLOAT(8)

AVGROWLEN

INTEGER

SPACEF

FLOAT(8)

IBMREQD

CHAR(1)

Description describes a view, alias, temporary table, or auxiliary table. If RUNSTATS updated the statistics, the date and time when the last invocation of RUNSTATS updated the statistics. The default value is ’0001-01-01.00.00.00.000000’. For a temporary table, the value of STATSTIME is always the default value. Total number of rows in the table or total number of LOBs in an auxiliary table. The value is -1 if statistics have not been gathered or the row describes a view, alias, or temporary table. Total number of pages on which rows of the partition appear. The value is -1 if statistics have not been gathered. Average row length of the table specified in the tablespace. The value is -1 if statistics have not been gathered. Kilobytes of DASD storage. The value is -1 if statistics have not been gathered. This is an updatable column. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape.

SYSIBM.SYSTABLESPACE Contains one row for each tablespace. Column Name NAME CREATOR DBNAME DBID


OBID PSID BPOOL PARTITIONS

SMALLINT SMALLINT CHAR(8) SMALLINT

LOCKRULE

CHAR(1)

PGSIZE ERASERULE

SMALLINT CHAR(1)

STATUS

CHAR(1)

®

DB2 9 for z/OS

Description Name of the tablespace. Authorization ID of the owner of the tablespace. Name of the database that contains the tablespace. Internal identifier of the database that contains the tablespace. Internal identifier of the tablespace file descriptor. Internal identifier of the tablespace page set descriptor. Name of the buffer pool used for the tablespace. Number of partitions of the tablespace; 0 if the tablespace is not partitioned. Lock size of the tablespace: A Any L Large object (LOB) P Page R Row S Tablespace T Table X Implicitly created XML table space Size of pages in the tablespace in kilobytes. Whether the data sets are to be erased when dropped. The value is meaningless if the tablespace is partitioned. N No erase Y Erase Availability status of the tablespace: A Available C Definition is incomplete because a partitioning index has not been created. 319

®


Data Type

IMPLICIT

CHAR(1)

NTABLES NACTIVE

SMALLINT INTEGER

CLOSERULE

CHAR(1)

SPACE

INTEGER

IBMREQD

CHAR(1)

SEGSIZE

SMALLINT

CREATEDBY

VARCHAR(128)

STATSTIME

TIMESTAMP

LOCKMAX

INTEGER

TYPE

CHAR(1)

320

Description P Tablespace is in a check pending status. S Tablespace is in a check pending status with the scope less than the entire tablespace. T Definition is incomplete because no table has been created. Whether the tablespace was created implicitly: N No Y Yes Number of tables defined in the tablespace. Number of active pages in the tablespace. A page is termed active if it is formatted for rows, even if it currently contains none. The value is 0 if statistics have not been gathered. This is an updatable column. Whether the data sets are candidates for closure when the limit on the number of open data sets is reached. N No Y Yes Number of kilobytes of DASD storage allocated to the tablespace, as determined by the last execution of the STOSPACE utility. The value is 0 if the tablespace is not related to a storage group, or if STOSPACE has not been run. If the tablespace is partitioned, the value is the total kilobytes of DASD storage allocated to all partitions that are storage-group defined. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Number of pages in each segment of a segmented tablespace. The value is 0 if the tablespace is not segmented. Primary authorization ID of the user who created the tablespace. If RUNSTATS updated the statistics, the date and time when the last invocation of RUNSTATS updated the statistics. The default value is '0001-0101.00.00.00.000000'. This is an updatable column. The maximum number of locks per user to acquire for the table or tablespace before escalating to the next locking level. 0 Lock escalation does not occur. n n, where n > 0, is the maximum number of locks (row, page, or LOB locks for the table or tablespace) an application process can acquire before lock escalation occurs. -1 Represents LOCKMAX SYSTEM. The value of field LOCKS PER TABLE(SPACE) on installation panel DSNTIPJ determines lock escalation. If the value of the field is 0, lock escalation does not occur. If the value is n, where n > 0, lock escalation occurs as it does for LOCKMAX n. The type of tablespace: blank The tablespace was created without any of the following options: DSSIZE, LARGE, LOB, and MEMBER CLUSTER. ®

DB2 9 for z/OS

®


Data Type

CREATEDTS

TIMESTAMP

ALTEREDTS

TIMESTAMP

ENCODING_SCHEME

CHAR(1)

SBCS_CCSID

INTEGER

DBCS_CCSID

INTEGER

MIXED_CCSID

INTEGER

MAXROWS

SMALLINT

LOCKPART

CHAR(1)

LOG

CHAR(1)

®

DB2 9 for z/OS

Description I The table space was defined with the MEMBER CLUSTER option and is not greater than 64 gigabytes. G The table space was defined with the MAXPARTITIONS option (a partitioned-by-growth table space) with the underlying structure of a universal table space. K The table space was defined with the MEMBER CLUSTER option and can be greater than 64 gigabytes. L The table space can be greater than 64 gigabytes. O The table space was defined with the LOB option (the table space is a LOB table space). P Implicit table space created for XML columns. R Range-partitioned universal table space. Time when the CREATE statement was executed for the tablespace. If the tablespace was created in a DB2 release prior to Version 5, the value is '0001-01-01.00.00.00.000000'. Time when the most recent ALTER TABLESPACE statement was executed for the tablespace. If no ALTER TABLESPACE statement has been applied, ALTEREDTS has the value of CREATEDTS. If the index was created in a DB2 release prior to Version 5, the value is '0001-01-01.00.00.00.000000'. Default encoding scheme for the tablespace: E EBCDIC A ASCII U UNICODE blank For tablespaces in a work file database or a TEMP database (a database that was created AS TEMP, which is for declared temporary tables) The value is 'E' for tables in non- work-file databases and blank for tables in work-file databases created prior to Version 5 or the default database, DSNDB04. Default SBCS CCSID for the tablespace. For a tablespace in a TEMP database or a database created in a DB2 release prior to Version 5, the value is 0. Default DBCS CCSID for the tablespace. For a tablespace in a TEMP database or a database created in a DB2 release prior to Version 5, the value is 0. Default mixed CCSID for the tablespace. For a tablespace in a TEMP database or a database created in a DB2 release prior to Version 5, the value is 0. The maximum number of rows that DB2 will place on a data page. The default value is 255. For a LOB tablespace, the value is 0 to indicate that the column is not applicable. Y LOCKPART YES is specified for the tablespace. blank LOCKPART NO is specified, or LOCKPART is not specified or not a partitioned tablespace. Whether the changes to a tablespace are to be logged. N This table space has the NOT LOGGED attribute. Undo and redo logging for the table space and all 321

®


Data Type

NACTIVEF

FLOAT

DSSIZE OLDEST_VERSION

INTEGER SMALLINT

CURRENT_VERSION

SMALLINT

AVGROWLEN

INTEGER

SPACEF CREATORTYPE RELCREATED

FLOAT CHAR(1) CHAR(1)

INSTANCE

SMALLINT

CLONE

CHAR(1)

MAXPARTITIONS

SMALLINT

Description indexes for tables in the table space is suppressed. Logging is also suppressed for the auxiliary indexes for all auxiliary tables associated with tables in the table space. Y This table space has the LOGGED attribute. Normal logging is associated with modifications to this table space, all indexes for tables in this table space, and all auxiliary indexes for all auxiliary tables associated with tables in the table space. X This LOB or XML table space has the NOT LOGGED attribute. Undo and redo logging for the table space is suppressed. Also, the logging attribute for this LOB or XML table space is linked to the logging attribute of the associated base table space and might not be able to be altered independently. If the logging attribute of the base table space is altered to LOGGED, the logging attribute of the LOB or XML table space will also be altered to LOGGED. Number of active pages in the tablespace. A page is termed active if it is formatted for rows, even if it currently contains none. The value is -1 if statistics have not been gathered. This is an updatable column. Maximum size of a data set in kilobytes. Version number of the oldest format of data in the table space and any image copies. Version number describing the newest format of data in the table space. Average length of rows for the tables in the table space or part. Kilobytes of DASD storage for the storage group. Indicates the type of creator: blank Authorization ID L Role The release of DB2 that is used to create the object. Blank if created prior to Version 9. INSTANCE indicates the column value of the data set instance number of the current base object (table and index). Indicates whether the table space contains any objects that are involved in a clone relationship: Y Table space contains objects that are involved in a clone relationship N Table space does not contain any objects that are involved in a clone relationship Identifies the maximum number of partitions to which the table space can grow. 0 if the table space is not partitioned or is range partitioned but not a universal table space.

SYSIBM.SYSTABLESPACESTATS Contains real time statistics for table spaces. Rows in this table can be inserted, updated, and deleted. Column name 322

Data type

Description ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide UPDATESTATSTIME NACTIVE NPAGES

TIMESTAMP INTEGER INTEGER

EXTENTS

SMALLINT

LOADRLASTTIME

TIMESTAMP

REORGLASTTIME

TIMESTAMP

REORGINSERTS

INTEGER

REORGDELETES

INTEGER

REORGUPDATES

INTEGER

REORGDISORGLOB

INTEGER

REORGUNCLUSTINS

INTEGER

REORGMASSDELETE

INTEGER

REORGNEARINDREF

INTEGER

®

DB2 9 for z/OS

The timestamp when the row was inserted or last updated The number of active pages in the table space or partition. The number of distinct pages with active rows in the partition of the table space. This is an updateable column. The number of extents in the table space or partition. For multi-piece table spaces, this value is the number of extents for the last data set. For a data set that is striped across multiple volumes, the value is the number of logical extents. A null value indicates the value is unknown. The timestamp of the last LOAD REPLACE on the table space or partition. A null value indicates that the LOAD REPLACE utility has never been run on the table space or partition or that the timestamp is unknown. The timestamp of the last REORG on the table space or partition. A null value indicates that the REORG utility has never been run on the table space or partition or that the timestamp is unknown. The number of records or LOBs that have been inserted since the last REORG or LOAD REPLACE on the table space or partition. A null value indicates that the number of inserted records or LOBs is unknown. The number of records or LOBs that have been deleted since the last REORG or LOAD REPLACE on the table space or partition. A null value indicates that the number of deleted records or LOBs is unknown. The number of rows that have been updated since the last REORG or LOAD REPLACE on the table space or partition. This value does not include LOB updates because LOB updates are really deletions followed by insertions. A null value indicates that the number of updated rows is unknown. The number of LOBs that were inserted since the last REORG or LOAD REPLACE that are not perfectly chunked. A LOB is perfectly chunked if the allocated pages are in the minimum number of chunks. A null value indicates that the number of not perfectly chunked LOBs is unknown. The number of records that were inserted since the last REORG or LOAD REPLACE that are not well-clustered with respect to the clustering index. A record is well-clustered if the record is inserted into a page that is within 16 pages of the ideal candidate page. The clustering index determines the ideal candidate page. A null value indicates that the number of not well clustered pages is unknown. The number of mass deletes from a segmented or LOB table space, or the number of dropped tables from a segmented table space, since the last REORG or LOAD REPLACE. A null value indicates that the number of mass deletes is unknown. The number of overflow records that were created since the 323

®


REORGFARINDEF

INTEGER

STATSLASTTIME

TIMESTAMP

STATSINSERTS

INTEGER

STATSDELETES

INTEGER

STATSUPDATES

INTEGER

STATSMASSDELETE

INTEGER

COPYLASTTIME

TIMESTAMP

COPYUPDATEDPAGES

INTEGER

COPYCHANGES

INTEGER

COPYUPDATELRSN

CHAR(6)

324

last REORG or LOAD REPLACE and were relocated near the pointer record. For nonsegmented table spaces, a page is near the present page if the two page numbers differ by 16 or less. For segmented table spaces, a page is near the present page if the two page numbers differ by SEGSIZE*2 or less. A null value indicates that the number of overflow records that are near the pointer record is unknown. The number of overflow records that were created since the last REORG or LOAD REPLACE and were relocated far from the pointer record. For nonsegmented table spaces, a page is far from the present page if the two page numbers differ by more than 16. For segmented table spaces, a page is far from the present page if the two page numbers differ by at least (SEGSIZE*2)+1. A null value indicates that the number of overflow records that are far from the pointer record is unknown. The timestamp of the last RUNSTATS on the table space or partition. The number of records or LOBs that have been inserted since the last RUNSTATS on the table space or partition. A null value indicates that the number of inserted records or LOBs is unknown. The number of records or LOBs that have been deleted since the last RUNSTATS on the table space or partition. A null value indicates that the number of deleted records or LOBs is unknown. The number of rows that have been updated since the last RUNSTATS on the table space or partition. This value does not include LOB updates because LOB updates are really deletions followed by insertions. A null value indicates that the number of updated records or LOBs is unknown. The number of mass deletes from a segmented or LOB table space, or the number of dropped tables from a segmented table space, since the last RUNSTATS. A null value indicates that the number of mass deletes is unknown. The timestamp of the last full or incremental image copy on the table space or partition. A null value indicates that the COPY utility has never been run on the table space or partition. A null value can also indicate that the timestamp of the last image copy is unknown. The number of distinct pages that have been updated since the last COPY. A null value indicates that the number of updated pages is unknown. The number of insert, delete, and update operations since the last COPY. A null value indicates that the number of insert, update, and delete operations is unknown. The LRSN or RBA of the first update after the last COPY A null value indicates that the LRSN or RBA is unknown. ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide COPYUPDATETIME

TIMESTAMP

IBMREQD

CHAR(1)

DBID PSID PARTITION

SMALLINT SMALLINT SMALLINT

INSTANCE

SMALLINT

SPACE

INTEGER

TOTALROWS DATASIZE

BIGINT BIGINT

UNCOMPRESSEDDATASIZE

BIGINT

DBNAME

CHAR(8)

NAME

CHAR(8

The timestamp of the first update after the last COPY. A null value indicates that the timestamp is unknown. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape. The internal identifier of the database. The internal identifier of the table space page set descriptor. The data set number within the table space. This column is used to map a data set number in a table space to its statistics. For partitioned table spaces, this value corresponds to the partition number for a single partition. For nonpartitioned table spaces, this value is 0. Indicates if the object is associated with data set instance 1 or 2. This is an updatable column. The amount of space, in KB, that is allocated to the table space or partition. For multi-piece linear page sets, this value is the amount of space in all data sets. The number of rows or LOBs in the table space or partition. The total number of bytes that row data occupy in the data rows or LOB rows. This is an updatable column. The total number of bytes that row data would have occupied in the data rows or LOB rows if the data was not compressed. This is an updatable column. The name of the database. This column is used to map a database to its statistics. The name of the table space. This column is used to map a table space to its statistics.

SYSIBM.SYSTABSTATS Contains one row for each partition of a partitioned tablespace. Rows in this table can be inserted, updated, and deleted. Column Name CARD NPAGES PCTPAGES

Data Type INTEGER INTEGER SMALLINT

NACTIVE PCTROWCOMP

INTEGER SMALLINT

STATSTIME

TIMESTAMP

IBMREQD

CHAR(1)

DBNAME TSNAME PARTITION OWNER NAME CARDF

VARCHAR(24) VARCHAR(24) SMALLINT VARCHAR(128) VARCHAR(128) FLOAT

®

DB2 9 for z/OS

Description Total number of rows in the partition. Total number of pages on which rows of the partition appear. Percentage of total active pages in the partition that contain rows of the table. Number of active pages in the partition. Percentage of rows compressed within the total number of active rows in the partition. This includes any row in a table space that is defined with COMPRESS YES. If RUNSTATS updated the statistics, the date and time when the last invocation of RUNSTATS updated the statistics. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Database that contains the tablespace named in TSNAME. Tablespace that contains the table. Partition number of the tablespace that contains the table. Schema of the owner of the table. Name of the table. Total number of rows in the partition. 325

®


SYSIBM.SYSTABSTATS_HIST Contains rows from SYSTABLES. Whenever rows are added or changed in SYSTABLES, the rows are also written to the new history table. Rows in this table can be inserted, updated, and deleted. Column Name NPAGES STATSTIME

Data Type INTEGER TIMESTAMP

DBNAME TSNAME PARTITION OWNER NAME CARDF

VARCHAR(24) VARCHAR(24) SMALLINT VARCHAR(128) VARCHAR(128) FLOAT(8)

IBMREQD

CHAR(1)

Description Total number of pages on which rows of the partitions appear. If RUNSTATS updated the statistics, the date and time when the last invoation of RUNSTATS updated the statistics. Database that contains the table space in TSNAME. Table space that contains the table. Partition number of the table space that contains the table. Schema of the owner of the table. Name of the table. Total number of rows in the partition. The value is –1 is statistics have not been gathered. A value of Y indicates that the row came from the basic machine-readable material (MRM) tape.

SYSIBM.SYSTRIGGERS Contains one row for each trigger. Column Name NAME SCHEMA


SEQNO

SMALLINT

DBID OBID OWNER CREATEDBY TBNAME TBOWNER TRIGTIME

SMALLINT SMALLINT VARCHAR(128) VARCHAR(128) VARCHAR(128) VARCHAR(128) CHAR(1)

TRIGEVENT

CHAR(1)

GRANULARITY

CHAR(1)

CREATEDTS

TIMESTAMP

326

Description Name of the trigger and trigger package. Schema of the trigger. This implicit or explicit qualifier for the trigger name is also used for the collection ID of the trigger package. Sequence number of this row; the first portion of the trigger definition is in row 1, and successive rows have increasing SEQNO values. Internal identifier of the database for the trigger. Internal identifier of the trigger. Owner of the trigger. Primary authorization ID of the creator of the trigger. Name of the table or view. Qualifier of the name of the table to which this trigger applies. Time when triggered actions are applied to the base table, relative to the event that activated the trigger: B Trigger is applied before the event. A Trigger is applied after the event. I Trigger is applied instead of the event. Operation that activates the trigger: I Insert D Delete U Update Trigger is executed once per: S Statement R Row Time when the CREATE statement was executed for this trigger. The time value is used in resolving functions, distinct types, and ®

DB2 9 for z/OS

®


Data Type

IBMREQD

CHAR(1)

TEXT REMARKS


TRIGNAME OWNERTYPE

VARCHAR(18) CHAR(1)

ENVID RELCREATED

INTEGER CHAR(1)

Description stored procedures. It is also used to order the execution of multiple triggers. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Full text of the CREATE TRIGGER statement. A character string provided by the user with the COMMENT ON statement. Unused. Indicates the type of creator: blank Authorization ID L Role Internal environment identifier. The release of DB2 that is used to create the object. Blank if created prior to Version 9.

SYSIBM.SYSUSERAUTH Records the system privileges that are held by users. Column Name GRANTOR GRANTEE


DATEGRANTED TIMEGRANTED AUTHHOWGOT

CHAR(6) CHAR(8) CHAR(1)

BINDADDAUTH

CHAR(1)

BSDSAUTH

CHAR(1)

CREATEDBAAUTH

CHAR(1)

CREATEDBCAUTH

CHAR(1)

®

DB2 9 for z/OS

Description Authorization ID of the user who granted the privileges. Authorization ID of the user that holds the privilege. Could also be PUBLIC for a grant to PUBLIC. Date the privileges were granted; in the form yymmdd. Time the privileges were granted; in the form hhmmssth. Authorization level of the user from whom the privileges were received. This authorization level is not necessarily the highest authorization level of the grantor. blank Not applicable C DBCTL D DBADM L SYSCTRL M DBMAINT S SYSADM Whether the GRANTEE can use the BIND subcommand with the ADD option: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can issue the RECOVER BSDS command: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can create databases and automatically receive DBADM authority over the new databases: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can execute the CREATE DATABASE statement to create new databases and automatically receive DBCTRL authority over the new 327

®


Data Type

CREATESGAUTH

CHAR(1)

DISPLAYAUTH

CHAR(1)

RECOVERAUTH

CHAR(1)

STOPALLAUTH

CHAR(1)

STOSPACEAUTH

CHAR(1)

SYSADMAUTH

CHAR(1)

SYSOPRAUTH

CHAR(1)

TRACEAUTH

CHAR(1)

IBMREQD

CHAR(1)

MON1AUTH

CHAR(1)

MON2AUTH

CHAR(1)

328

Description databases: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can execute the CREATE STOGROUP statement to create new storage groups: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can use the DISPLAY commands: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can use the RECOVER INDOUBT command: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can use the STOP command: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can use the STOSPACE utility: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE has system administration authority: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option GRANTEE has the privilege with the GRANT option for a value of either Y or G. Whether the GRANTEE has system operator authority: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can issue the START TRACE and STOP TRACE commands: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Whether the GRANTEE can obtain IFC serviceability data: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE can obtain IFC data: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option ®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide Column Name CREATEALIASAUTH

Data Type CHAR(1)

SYSCTRLAUTH

CHAR(1)

BINDAGENTAUTH

CHAR(1)

ARCHIVEAUTH

CHAR(1)

GRANTEDTS

TIMESTAMP

CREATETMTABAUTH

CHAR(1)

GRANTEETYPE

CHAR(1)

GRANTORTYPE

CHAR(1)

DEBUGSESSIONAUTH

CHAR(1)

Description Whether the GRANTEE can execute the CREATE ALIAS statement: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE has SYSCTRL authority: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option GRANTEE has the privilege with the GRANT option for a value of either Y or G. Whether the GRANTEE has BINDAGENT privilege: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Whether the GRANTEE is privileged to use the ARCHIVE LOG command: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Time when the GRANT statement was executed. The value is '1985-04-01.00.00.00.000000' for the one installation row. Whether the GRANTEE has CREATETMTABAUTH privilege: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option Indicates the type of grantee: blank Authorization ID L Role Indicates the type of grantor: blank Authorization ID L Role Whether the GRANTEE has DEBUGSESSION privilege: blank Privilege is not held G Privilege is held with the GRANT option Y Privilege is held without the GRANT option

SYSIBM.SYSVIEWDEP Records the dependencies of views on tables, functions, and other views. Column Name BNAME


BCREATOR

VARCHAR(128)

BTYPE

CHAR(1)

®

DB2 9 for z/OS

Description Name of the object on which the view is dependent. If the object type is a function (BTYPE='F'), the name is the specific name of the function. Authorization ID of the owner of BNAME. For functions, it is the schema name of the BNAME. Type of object: F Function M Materialized query table T Table 329

®


Data Type

DNAME DCREATOR IBMREQD


BSCHEMA DTYPE


DOWNER

VARCHAR(128)

OWNERTYPE

CHAR(1)

Description V View Name of the view. Schema of the owner of the view. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Schema of BNAME. Type of table F SQL Function M Materialized V View Authorization ID of the owner of the view, blank for views that were created in a DB2 release prior to Version 9. Indicates the type of owner: blank Authorization ID L Role

SYSIBM.SYSVIEWS Contains one or more rows for each view. Column Name NAME CREATOR SEQNO

Data Type VARCHAR(128) VARCHAR(128) SMALLINT

CHECK

CHAR(1)

IBMREQD

CHAR(1)

TEXT PATHSCHEMAS


RELCREATED

CHAR(1)

TYPE

CHAR(1)

REFRESH

CHAR(1)

ENABLE

CHAR(1)

MAINTENANCE

CHAR(1)

330

Description Name of the view. Schema of the owner of the view. Sequence number of this row; the first portion of the view is on row one and successive rows have increasing values of SEQNO. Whether the WITH CHECK OPTION clause was specified in the CREATE VIEW statement: N No C Yes with the cascaded semantic Y Yes with the local semantic The value is N if the view has no WHERE clause. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes Text or portion of the text of the CREATE VIEW statement. SQL path at the time the view was defined. The path is used to resolve unqualified data type and function names used in the view definition. Release of DB2 that was used to create the object: Blank Created prior to V7 K Create on V7 Type of table F SQL Function M Materialized Query Table V View Refresh mode D An MQT with a deferred refresh mode Blank Not an MQT Indicates whether an MQT is enabled or disabled for query optimization: Y Enabled N Disabled Blank Row describes a view Maintenance Mode ®

DB2 9 for z/OS

®


Data Type

REFRESH_TIME

TIMESTAMP

ISOLATION

CHAR(1)

SIGNATURE APP_ENCODING_ CCSID OWNER

VARCHAR(1024) INTEGER

OWNERTYPE

CHAR(1)

RELCREATED

CHAR(1)

VARCHAR(128)

Description S Maintained by system U Maintained by user Blank Row describes a view Timestamp of the REFRESH TABLE statement that last refreshed the data. Isolation level when the MQT is created or altered from a bas table. Contains the internal description. Used for MQT tables CCSID of the current application encoding scheme at the time the view was created. Authorization ID of the owner of the view, blank for views that were created in a DB2 release prior to Version 9. Indicates the type of owner: blank Authorization ID L Role The release of DB2 that is used to create the object. Blank if created prior to Version 9.

SYSIBM.SYSVOLUMES Contains one row for each volume of each storage group. Column Name SGNAME SGCREATOR VOLID IBMREQD


RELCREATED

CHAR(1)

Description Name of the storage group. Authorization ID of the owner of the storage group. Serial number of the volume or * if SMS-managed. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes The release of DB2 that is used to create the object. Blank if created prior to Version 9.

SYSIBM.SYSXMLRELS Contains one row for each XML table that is created for an XML column. Column Name TBOWNER TBNAME COLNAME XMLTBOWNER XMLTBNAME XMLRELOBID

Data Type VARCHAR(128) VARCHAR(128) VARCHAR(128) VARCHAR(128) VARCHAR(128) INTEGER

IBMREQD

CHAR(1)

CREATEDTS RELCREATED

TIMESTAMP CHAR(1)

Description Schema or qualifier of the base table. Name of the base table. Name of the XML column in the base table. Schema or qualifier of the XML table. Name of the XML table. Internal identifier of the relationship between the base table and the XML table. A value of Y indicates that the row came from the basic machinereadable material (MRM) tape. Time when the XML table was created. The release of DB2 that is used to create the object.

SYSIBM.SYSXMLSTRINGS Each row contains a single string and its unique ID that are used to condense XML data. The string can be an element name, attribute name, name space prefix, or a namespace URI. ®

DB2 9 for z/OS

331

®

DB2 9 z/OS Reference Guide Column Name STRINGID STRING IBMREQD

Data Type

Description

INTEGER VARCHAR(1000) CHAR(1)

Unique ID for the string. The string data. A value of Y indicates that the row came from the basic machinereadable material (MRM) tape.

SYSIBM.SYSUSERNAMES Each row in the table is used to carry out one of the following operations: • Outbound ID translation • Inbound ID translation and "come from" checking Rows in this table can be inserted, updated, and deleted. Column Name TYPE

Data Type CHAR(1)

AUTHID

VARCHAR(128)

LINKNAME

VARCHAR(24)

NEWAUTHID PASSWORD


IBMREQD

CHAR(1)

Description How the row is to be used: O For outbound translation. I For inbound translation and "come from" checking. S For outbound system AUTHID to establish a trusted connection. Authorization ID to be translated. Applies to any authorization ID if blank. Identifies the VTAM or TCP/IP network locations associated with this row. A blank value in this column indicates this name translation rule applies to any TCP/IP or SNA partner. If a nonblank LINKNAME is specified, one or both of the following statements must be true: o A row exists in SYSIBM.LUNAMES whose LUNAME matches the value specified in the SYSIBM.USERNAMES LINKNAME column. This row specifies the VTAM site associated with this name translation rule. o A row exists in SYSIBM.IPNAMES whose LINKNAME matches the value specified in the SYSIBM.USERNAMES LINKNAME column. This row specifies the TCP/IP host associated with this name translation rule. Inbound name translation and "come from" checking are not performed for TCP/IP clients. Translated value of AUTHID. Blank specifies no translation. Password to accompany an outbound request, if passwords are not encrypted. If passwords are encrypted, or the row is for inbound requests, the column is not used. Whether the row came from the basic machine-readable material (MRM) tape: N=No, Y=Yes

SYSIBM.XSRCOMPONENT An auxiliary table for the BLOB column COMPONENT in SYSIBM.SYSXSROBJECTCOMPONENTS. It is in LOB table space SYSXSRA3. Column Name COMPONENT 332

Data Type BLOB(30M)

Description Contents of the XML schema document ®

DB2 9 for z/OS

®


SYSIBM.XSROBJECTS SYSIBM.XSROBJECTS contains one row for each registered XML schema. Rows in this table can only be changed using static SQL statements issued by the DB2supplied XSR stored procedures. Column Name XSROBJECTID

Data Type INTEGER

XSROBJECT SCHEMA XSROBJECT NAME TARGET NAMESPACE

VARCHAR(128)

SCHEMA LOCATION

INTEGER

ROWID GRAMMAR PROPERTIES CREATEDBY CREATEDTS

ROWID BLOB(250M) BLOB(5M) VARCHAR(128) TIMESTAMP

STATUS

CHAR(1)

RELCREATED DECOMPOSITION

CHAR(1) CHAR(1)

DECOMPOSITION _ VERSION REMARKS

VARCHAR(128)

VARCHAR(128) INTEGER

VARCHAR(762)

Description Internal identifier of the XML schema. XSROBJECTID is generated as an identity column. Qualifier of the XML schema name. This is always set to ’SYSXSR’. Name of the XML schema. The value of the STRINGID column in SYSIBM.SYSXMLSTRINGS when the target namespace URI of the primary XML schema document is stored in SYSIBM.SYSXMLSTRINGS The value of the STRINGID column in SYSIBM.SYSXMLSTRINGS when the schema location URI of the primary XML schema document is stored in SYSIBM.SYSXMLSTRINGS ID that is used to support BLOB data type values. The internal binary representation of the XML schema. Additional property information of the entire XML schema. Authorization ID under which the XML schema was created. The time that the DB2-supplied stored procedure XSR_REGISTER was executed for the XML schema. Registration status of the XML schema: C Complete I Incomplete T Temporary The release of DB2 that is used to create the object. Indicates the decomposition status of the XSR object: Y Enabled N Not enabled X Inoperative Indicates the version of the XDB map that is used for decomposition Character string that contains comments about this XML schema.

SYSIBM.XSROBJECTCOMPONENTS SYSIBM.XSROBJECTCOMPONENTS contains one row for each component (document) in an XML schema. Rows in this table can only be changed using static SQL statements issued by the DB2-supplied XSR stored procedures. Column Name XSRCOMPONENTID

Data Type INTEGER

TARGETNAMESPACE

INTEGER

®

DB2 9 for z/OS

Description Internal identifier of the XML schema document. XSRCOMPONENTID is generated as an identity column. The value of the STRINGID column in 333

®


SCHEMALOCATION

INTEGER

ROWID COMPONENT PROPERTIES

ROWID BLOB(30M) BLOB(5M)

CREATEDTS STATUS

TIMESTAM P CHAR(1)

RELCREATED

CHAR(1)

SYSIBM.SYSXMLSTRINGS when the target namespace URI of the primary XML schema document is stored in SYSIBM.SYSXMLSTRINGS. The value of the STRINGID column in SYSIBM.SYSXMLSTRINGS when the schema location URI of the primary XML schema document is stored in SYSIBM.SYSXMLSTRINGS. The ID that is used to support BLOB data type values. Contents of the XML schema document. If available, additional property information of the XML schema document The time that the XML schema document was registered. Registration status of the XML schema: C Complete I Incomplete The release of DB2 that is used to create the object.

SYSIBM.XSROBJECTGRAMMER SYSIBM.XSROBJECTGRAMMAR is an auxiliary table for the BLOB column GRAMMAR in SYSIBM.SYSXSROBJECTS. It is in LOB table space SYSXSRA1. Column Name GRAMMAR

Data Type BLOB(250M)

Description Internal binary representation of the XML schema

SYSIBM.XSROBJECTHIERARCHIES SYSIBM.XSROBJECTHIERARCHIES contains one row for each component (document) in an XML schema to record the XML schema document hierarchy relationship. Rows in this table can only be changed using static SQL statements issued by the DB2-supplied XSR stored procedures. Column Name XSROBJECTID XSRCOMPONENTID HTYPE

Data Type INTEGER INTEGER CHAR(1)

TARGETNAMESPACE

INTEGER

SCHEMALOCATION

INTEGER

RELCREATED

CHAR(1)

334

Description Internal identifier of the XML schema. Internal identifier of the XML schema document. Hierarchy type: D Document P Primary document The value of the STRINGID column in SYSIBM.SYSXMLSTRINGS when the target namespace URI of the primary XML schema document is stored in SYSIBM.SYSXMLSTRINGS. The value of the STRINGID column in SYSIBM.SYSXMLSTRINGS when the schema location URI of the primary XML schema document is stored in SYSIBM.SYSXMLSTRINGS. The release of DB2 that is used to create the object.

®

DB2 9 for z/OS

®


SYSIBM.XRSOBJECTPROPERTY An auxiliary table for the BLOB column PROPERTIES in SYSIBM.SYSXSROBJECTS. It is in LOB table space SYSXSRA2. Column Name PROPERTIES

Data Type BLOB(5M)

Description Contents of the additional property information of the entire XML schema.

SYSIBM.XSRPROPERTY An auxiliary table for the BLOB column COMPONENT in SYSIBM.SYSXSROBJECTCOMPONENTS. It is in LOB table space SYSXSRA3. Column Name COMPONENT

®

DB2 9 for z/OS

Data Type BLOB(5M)

Description Contents of the additional property information of the XML schema document

335

®


Updateable Catalog Statistics The following table shows the catalog statistics that are updateable and used for access path selection. Table

Statistics

SYSIBM.SYSCOLDIST

CARDF COLGROUPCOLNO COLVALUE FREQUENCYF HIGHVALUE LOWVALUE NUMCOLUMNS QUANTILENO TYPE HIGHVALUE QUANTILENO COLCARDF HIGH2KEY LOW2KEY CLUSTERRATIOF FIRSTKEYCARDF FULLKEYCARDF NLEAF NLEVELS DATAREPEATFACTORF DATAREPEATFACTORF HIGH2KEY LOW2KEY STATS_FORMAT HIGHKEY HIGH2KEY LOWKEY LOW2KEY STATS_FORMAT CARDF KEYGROUPKEYNO KEYVALUE FREQUENCYF HIGHVALUE LOWVALUE NUMKEYS QUANTILENO TYPE HIGHVALUE LOWVALUE QUANTILENO CARDINALITY INITIAL_INSTS INITIAL_IOS

SYSIBM.SYSCOLDISTSTATS SYSIBM.SYSCOLUMNS SYSIBM.SYSINDEXES

SYSIBM.SYSINDEXSTATS SYSIBM.SYSKEYTARGETS SYSIBM.SYSKEYTARGETSTATS

SYSIBM.SYSKEYTGTDIST

SYSIBM.SYSKEYTGTDISTSTATS SYSIBM.SYSROUTINES

336

®

DB2 9 for z/OS

®


SYSIBM.SYSTABLES

SYSIBM.SYSTABLESPACE SYSIBM.SYSTABSTATS

®

DB2 9 for z/OS

INSTS_PER_INVOC IOS_PER_INVOC CARDF NPAGES NPAGESF PCTROWCOMP NACTIVE CARDF NPAGES

337

®


IBM Utilities BACKUP SYSTEM .-FULL-----. >>-BACKUP SYSTEM--+-----------+--+-------------------------+----> '-DATA ONLY-' +-ESTABLISH FCINCREMENTAL-+ '-END FCINCREMENTAL-------' >--+-----------------------------------------------------------+->< +--FORCE----------------------------------------------------+ +--DUMP--+-------------------+--+-------+-------------------+ | '- dumpclass-spec---' '-FORCE-' | '-DUMPONLY--+-------------------------+-+------------------+' '- TOKEN- (X'byte-string')' '- dumpclass-spec -'

CATENFM >>-CATENFM--+-START----------------------------+--------------->< +-COMPLETE-------------------------+ +-ENFMON---------------------------+ +-CMON-----------------------------+ '-CONVERT--INPUT--table-space-name-'

CATMAINT >>-CATMAINT--UPDATE---------------------------------------------> >--+-------------------------------------------------+----------> | .-------------------------------------. | | V | | +-SCHEMA----SWITCH(schema_name,new_schema_name)-+-+ | .-,----------. | | V | | '-OWNER--FROM--(----owner_name-+--)--TO ROLE------' >--+-------------------------------------------+--------------->< | .---------------------------------. | | V | | '-VCAT---SWITCH(vcat_name,new_vcat_name)-+-'

CHECK DATA .--------------------------------------. V | >>-CHECK--DATA----table-space-spec--+---------------+-+---------> '-PART--integer-' . .--SHRLEVEL-REFERENCE-. >--+-------+--+---------------------+---------------------------> '-CLONE-' '--SHRLEVEL--CHANGE---' .-SCOPE--PENDING-----. >--drain-spec--+--------------------+---------------------------> 338

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide '-SCOPE--+-AUXONLY-+-' +-ALL-----+ '-REFONLY-' .-AUXERROR--REPORT--------. >--+-------------------------+----------------------------------> '-AUXERROR--INVALIDATE----' .-LOBERROR--REPORT-----. .-XMLERROR--REPORT-----. >--+----------------------+--+----------------------+-----------> '-LOBERROR--INVALIDATE-' '-XMLERROR--INVALIDATE-' >--+-------------------------------------------------------+----> | .-----------------------------------. | | V | | '-FOR--EXCEPTION----IN--table-name1--USE--table-name2-+-' .-DELETE--NO---------------. .-EXCEPTIONS--0-------. >--+---------------------------+--+---------------------+-------> | .-LOG--YES- | '-EXCEPTIONS--integer-' '-DELETE--YES--+----------+-' '-LOG--NO--' .-ERRDDN--SYSERR-. >--+----------------+-------------------------------------------> '-ERRDDN--ddname-' .-WORKDDN--SYSUT1--,--SYSUT2----------. >--+-------------------------------------+----------------------> '-WORKDDN--+-ddname1--,--ddname2----+-' | .-,--SYSUT2-. | +-ddname1--+-----------+-+ | .-SYSUT1-. | '-+--------+--,--ddname2-' >--+------------------------+--+-----------------------+--------> | .-SYSPUNCH-. | '-SORTDEVT--device-type-' '-PUNCHDDN--+-ddname---+-' >--+------------------+---------------------------------------->< '-SORTNUM--integer-'

CHECK INDEX >>-CHECK--INDEX-------------------------------------------------> >-+-LIST--listdef-name---------------------------------------------------+-> +-(-index-name-+--------------+-)--------------------------------------+ | '-PART-integer-' | '-(ALL)-TABLESPACE-+----------------+-table-space-name-+-------------+-' '-database-name.-' '-PART-integer' .-SHRLEVEL--REFERENCE-. >--+-------+--+---------------------+---------------------------> '-CLONE-' '-SHRLEVEL--CHANGE----' .-DRAIN_WAIT--IRLMRWT value-. .-RETRY--UTIMOUT value-. >--+---------------------------+--+----------------------+------> '-DRAIN_WAIT--integer-------' '-RETRY--integer-------' .-WORKDDN--SYSUT1-. >--+----------------------+--+-----------------+----------------> '-RETRY_DELAY--integer-' '-WORKDDN--ddname-' >--+-----------------------+--+------------------+------------->< '-SORTDEVT--device-type-' '-SORTNUM--integer-'

®

DB2 9 for z/OS

339

®


CHECK LOB .-SHRLEVEL--REFERENCE-. >>-CHECK--LOB--lob-table-space-spec--+---------------------+----> '-SHRLEVEL--CHANGE----' .-EXCEPTIONS--0-------. >--drain-spec--+---------------------+--------------------------> '-EXCEPTIONS--integer-' >--+------------------------+--+-----------------------+--------> | .-SYSPUNCH-. | '-SORTDEVT--device-type-' '-PUNCHDDN--+-ddname---+-' >--+------------------+---------------------------------------->< '-SORTNUM--integer-'

COPY >>-COPY--+-copy-spec------------+--+--------+--------------------> | | '--CLONE-' +-concurrent-spec------+ | | '-filterddn-spec-------' .-SHRLEVEL--REFERENCE-. .-SCOPE--ALL-------. >--+---------------------+--+------------------+---------------->< '-SHRLEVEL--CHANGE----' '--SCOPE---PENDING-' copy-spec: .-FULL--YES--------. >>-+-LIST--listdef-name--data-set-spec--+------------------+-----------------------------==---> | +-FULL--NO--------+ | | '-changelimit-spec' | | .------------------------------------------------------------------------------------. | | V .-FULL--YES--------. .-DSNUM--ALL----------.| | | '---+-table-space-spec-+--+------------------+--+---------------------+--data-set-spec-+-' '-index-name-spec--' +-FULL--NO---------+ | | '-changelimit-spec-' '-DSNUM--integer------'

>--+----------------------------------------------------------------+--> '-PARALLEL-+---------------+-+---------------------------------+-' '-(num-objects)-' '-TAPEUNITS--(--num-tape-units--)-' .-CHECKPAGE-. .-SYSTEMPAGES--YES-. >--+-----------+--+------------------+------------------------->< '-SYSTEMPAGES--NO--' Concurrent-spec: >>-+-LIST--listdef-name--data-set-spec--------------------------------+--> | .--------------------------------------------------------------. | | V .-DSNUM--ALL----------. | | '---+-table-space-spec-+--+---------------------+--data-set-spec-+-' '-index-name-spec--' '-DSNUM--integer------' >--CONCURRENT-------------------------------------------------->< Filterddn-spec:

>>-+-LIST--listdef-name--------------------------------+--------> | .-----------------------------------------------. | 340

®

DB2 9 for z/OS

®


| V .-DSNUM--ALL----------. | | '---+-table-space-spec-+--+---------------------+-+-' '-index-name-spec--' '-DSNUM--integer------' >--data-set spec--FILTERDDN--(ddname)--CONCURRENT-------------->< data-set spec: >>-+-COPYDDN(-+-ddname1-------+----------+-+-)-+------------------------------------------+-+->< | | '-,ddname2-' | '-RECOVERYDDN(-+-ddname3--+----------+-+-)-' | | '-,ddname2-------------------' | '-,ddname4-' | | | '-,ddname4--------------' | '-RECOVERYDDN(-+-ddname3--+----------+-+-)-----------------------------------------------' | '-,ddname4-' | '-,ddname4--------------'

Change-limit spec: >>-CHANGELIMIT-+---------------------------------------+-+------------+->< '-(percent_value1-+-----------------+-)-' '-REPORTONLY-' '-,percent_value2-'

Tablespace spec: >>-TABLESPACE--+----------------+--table-space-name------------>< '-database-name.-' Indexpspace spec: >>-+-INDEXSPACE--+----------------+--index-space-name-+-------->< | '-database-name.-' | '-INDEX--+-------------+--index-name---------------' '-creator-id.-' COPYTOCOPY >>-COPYTOCOPY---------------------------------------------------> >--+-LIST--listdef-name--from-copy-spec--data-set-spec------+---> | .----------------------------------------------------. | | V | | '---+-ts-num-spec-----+--from-copy-spec--data-set-spec-+-' '-index-name-spec-' >--+-------+--------------------------------------------------->< '-CLONE-' ts-num-spec: >>-TABLESPACE--+----------------+--table-space-name-------------> '-database-name.-' .-DSNUM--ALL-----. >--+----------------+------------------------------------------>< '-DSNUM--integer-' index-name-spec: ®

DB2 9 for z/OS

341

®

DB2 9 z/OS Reference Guide >>-+-INDEXSPACE-------+----------------+--index-space-name-+----> | '-database-name.-' | '-INDEX--+-------------+--index-name--------------------' '-creator-id.-' .-DSNUM--ALL----------. >--+---------------------+------------------------------------->< '-DSNUM--integer------' from-copy-spec: .-FROMLASTCOPY-----------------------------------------------------. >>-+------------------------------------------------------------------+->< +-FROMLASTFULLCOPY-------------------------------------------------+ +-FROMLASTINCRCOPY-------------------------------------------------+ '-FROMCOPY-------dsn--+------------------------------------------+-' '-FROMVOLUME--+-CATALOG------------------+-' '-volser--+--------------+-' '-FROMSEQNO--n-' data-set-spec: >>-+-COPYDDN(-+-ddname1----+----------+-+-)-+------------------------------------------+-+------>< | | '-,ddname2-' | '-RECOVERYDDN(-+-ddname3--+----------+-+-)-' | | '-,ddname2----------------' | '-,ddname4-' | | | '-,ddname4--------------' | '-RECOVERYDDN(-+-ddname3--+----------+-+-)--------------------------------------------' | '-,ddname4-' | '-,ddname4--------------'

DIAGNOSE >>-DIAGNOSE--+-diagnose statement-+---------------------------->< '-END----------------' diagnose-statement: >>-+---------------------+--------------------------------------> | .-,-------. | | V | | '-TYPE(---integer-+-)-' >--+------------------------------------+-----------------------> '-ALLDUMPS-+-----------------------+-' | .-,-------------. | | V | | '-(---X'abend-code'-+-)-' >--+-----------------------------------+------------------------> '-NODUMPS-+-----------------------+-' | .-,-------------. | | V | | '-(---X'abend-code'-+-)-' >--+-------------------+--+----------------+--+-----------------+->< '-display statement-' '-wait statement-' '-abend statement-' display-statement:

342

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide >>-DISPLAY------------------------------------------------------> >--+-OBD-+------------------+-table-space-name-+---------+-+-------+---+>< | '-database-name--.-' +-ALL-----+ '-CLONE-' | | +-TABLES--+ | | '-INDEXES-' | +-SYSUTIL-----------------------------------------------------------+ +-MEPL--------------------------------------------------------------+ +-AVAILABLE---------------------------------------------------------+ '-DBET-+-DATABASE--database-name------------------------+-+-------+-' +-TABLESPACE-+----------------+-table-space-name-+ '-CLONE-' | '-database-name.-' | '-INDEX--index-name------------------------------' wait-statement: .-----------------------------------------------------. V | >>-WAIT----+-MESSAGE--message-id--+-------------------+------+-+->< | '-INSTANCE--integer-' | '-TRACEID--+-X'trace-id'-+--+-------------------+-' '-integer-----' '-INSTANCE--integer-' abend-statement: >>-ABEND--+-MESSAGE--message-id--+-------------------+------+--+--------+->< | '-INSTANCE--integer-' | '-NODUMP-' '-TRACEID--+-X'trace-id'-+--+-------------------+-' '-integer-----' '-INSTANCE--integer-'

EXEC SQL >>-EXEC--SQL--+-declare-cursor-spec--------------+--ENDEXEC---->< '-non-select dynamic SQL statement-' declare-cursor-spec: >>-DECLARE--cursor-name--CURSOR--FOR--select-statement--------->
>-LISTDEF--list-name-------------------------------------------> .-------------------------------------------------------------------------. V | >-+INCLUDE+-+-----------+-+-LIST-ref-list-+-+---------------++----+-+-----+-+->< 'EXCLUDE' | | '-init-obj-spec-' 'CLONED-+-YES-+-''-RI-' +-ALL-+ '-type-spec-' '-NO--' +-BASE+ +-LOB-+ '-XML-' type-spec: >>-+-TABLESPACES--------------------+-------------------------->< '-INDEXSPACES--+---------------+-' ®

DB2 9 for z/OS

343

®

DB2 9 z/OS Reference Guide '-COPY--+-NO--+-' '-YES-' init-obj-spec: >>-+-DATABASE--database-name-+--+--------------------+--------->< +-table-space-spec--------+ '-PARTLEVEL--+-----+-' +-index-space-spec--------+ '-(n)-' +-table-spec--------------+ '-index-spec--------------' table-space-spec: TABLESPACE--+----------------+--table-space-name------------>< '-database-name.-' index-space-spec >>-INDEXSPACE--+----------------+--index-space-name------------>< '-database-name.-' table-spec >>-TABLE--+-------------+--table-name-------------------------->< '-creator-id.-' index-spec >>-INDEX--+-------------+--index-name-------------------------->< '-creator-id.-'

LOAD .-DATA-. .-INDDN--SYSREC---------. >>-LOAD--+------+--+-----------------------+--+-----------+-----> +-INDDN--ddname---------+ '-PREFORMAT-' '-INCURSOR--cursor-name-' .-RESUME--NO-. .-SHRLEVEL--NONE-. >--+-+------------+--+----------------+--+--------------------+--+-----------------+-+-> | '-REPLACE--copy-spec-' '-statistics-spec-' | | .-SHRLEVEL--NONE---. | '-RESUME--YES--+------------------+-----------------------------------------------' '-SHRLEVEL--CHANGE-'

.-LOG--YES----------------. >--+----------------+--+-------+--+-------------------------+---> '-KEEPDICTIONARY-' '-REUSE-' '-LOG--NO--+------------+-' '-NOCOPYPEND-' .-SORTKEYS--0--------. >--workddn-spec--+--------------------+--format-spec------------> +-SORTKEYS--NO-------+ '-SORTKEYS--integer--' .-FLOAT(S390)-. .-EBCDIC--. >--+-------------+--+---------+--+----------------------+-------> '-FLOAT(IEEE)-' +-ASCII---+ | .-,-------. | 344

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide '-UNICODE-'

| V | | '-CCSID(---integer-+-)-' .-ENFORCE--CONSTRAINTS-. .-ERRDDN--SYSERR-. >--+--------+--+----------------------+--+----------------+-----> '-NOSUBS-' '-ENFORCE--NO----------' '-ERRDDN--ddname-' .-MAPDDN--SYSMAP-. .-DISCARDDN--SYSDISC-. >--+----------------+--+--------------------+-------------------> '-MAPDDN--ddname-' '-DISCARDDN--ddname--' .-DISCARDS--0-------. >--+-------------------+--+-----------------------+-------------> '-DISCARDS--integer-' '-SORTDEVT--device-type-' >--+------------------+-----------------------------------------> '-SORTNUM--integer-' >--+-----------------------------------------------------+------> '-CONTINUEIF(start-+------+-)=-+-X'byte-string'-----+-' '-:end-' '-'character-string'-' >--+-----------------------------------------+------------------> '-DECFLOAT_ROUNDMODE--+-ROUND_CEILING---+-' +-ROUND_DOWN------+ +-ROUND_FLOOR-----+ +-ROUND_HALF_DOWN-+ +-ROUND_HALF_EVEN-+ +-ROUND_HALF_UP---+ '-ROUND_UP--------' .-----------------. V | >----INTO-TABLE-spec-+----------------------------------------->< Workddn-spec .-WORKDDN(SYSUT1,SORTOUT)--------------. >>-+--------------------------------------+-------------------->< '-WORKDDN--+-(ddname1,ddname2)-------+-' | .-,SORTOUT-. | +-(ddname1-+----------+-)-+ | .-SYSUT1-. | '-(-+--------+-,ddname2)--' Copy-spec >>-+---------------------------------------+-------------------> | .-(SYSCOPY)---------------. | '-COPYDDN-+-------------------------+---' +-(ddname1-+----------+-)-+ | '-,ddname2-' | '-(,ddname2)--------------' >--+------------------------------------+---------------------->< '-RECOVERYDDN(ddname3-+----------+-)-' '-,ddname4-' statistics-spec

®

DB2 9 for z/OS

345

®

DB2 9 z/OS Reference Guide >>-STATISTICS---------------------------------------------------> .-TABLE--(--ALL--)-. >--+-+------------------+--+-----------------+-----------------------------------+--> | '-SAMPLE--integer-' | | .---------------------------------------------------------------------.| | V .-COLUMN--ALL----------------. || '-TABLE-(-table-name-)-+------------+-+-----------------------------+-+---'—' '-SAMPLE-int-' | .-,----------. | | V | | '-COLUMN-(-column-name-+-)----'

.-INDEX--(--ALL--)-. >--+-+------------------+--correlation-stats-spec--------------+------> | .-,----------------------------------. | | V | | '-INDEX--(----index-name--correlation-stats-spec-+--)-------' .-REPORT--NO--. .-UPDATE--ALL------------. >--+-------------+--+------------------------+------------------> '-REPORT--YES-' '-UPDATE--+-ACCESSPATH-+-' +-SPACE------+ '-NONE-------' >--+-------------------------+--+----------------------+------->< '-HISTORY--+-ALL--------+-' '-FORCEROLLUP--+-YES-+-' +-ACCESSPATH-+ '-NO--' +-SPACE------+ '-NONE-------' Correlation-stats-spec >>-+---------+--------------------------------------------------> '-KEYCARD-' .-FREQVAL--NUMCOLS--1--COUNT--10----------------. >--+-------------------------------------------------+--------->< | .-------------------------------------------. | | V | '-----FREQVAL--NUMCOLS--integer--COUNT--integer-+-' format-spec >>-+---------------------------------------------------------------------+->< '-FORMAT-+-UNLOAD------------------------------------------------------+-' +-SQL/DS------------------------------------------------------------+ | .-COLDEL--','--. .-CHARDEL--'"'----. .-DECPT---'.'--. | '-DELIMITED--+---------------+-+-----------------+-+--------------+-' '-COLDEL-coldel-' '-CHARDEL-chardel-' '-DECPT-decpt--' into-table-spec >>-INTO--TABLE--table-name--+------------------+----------------> '-IDENTITYOVERRIDE-' .-IGNOREFIELDS--NO--. >--+-------------------+----------------------------------------> '-IGNOREFIELDS--YES-' >-+-----------------------------------------------------------------------+> | .-INDDN--SYSREC-----------------. '-PART-integer-+-----------+-resume-spec-+-------------------------------+' 346

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide '-PREFORMAT-'

+-INDDN-ddname+-----------------++ | 'DISCARDDN-ddname '| '-INCURSOR--cursor-name----------' >--+------------------------------------+-----------------------> '-WHEN-+-SQL/DS='table-name'-------+-' '-field selection criterion-' >--+-----------------------------+----------------------------->< | .-,-------------------. | | V | | '-(---field specification-+-)-' resume-spec .-RESUME--NO-. >>-+-+------------+-+-----------------------------------+-+-----> | '-REPLACE--+-------+--+-----------+-' | | '-REUSE-' '-copy-spec-' | '-RESUME--YES------------------------------------------' >--+----------------+------------------------------------------>< '-KEEPDICTIONARY-' Field-selection-criteria >>-+-field-name--------+--=--+-X'byte-string'-----+------------>< '-(start-+------+-)-' +-'character-string'-+ '-:end-' +-G'graphic-string'--+ '-N'graphic-string'--' field specification >>-field-name--+---------------------------+--------------------> '-POSITION(start-+------+-)-' '-:end-' >--+----------------------------------------------+-------------> +-CHAR--+---------------------------+----------+ | +-BIT--(length)--strip-spec-+ | | +-MIXED--strip-spec---------+ | | +-BLOBF---------------------+ | | +-CLOBF--+-------+----------+ | | | '-MIXED-' | | | '-DBCLOBF-------------------' | +-VARCHAR--+------------------+--strip-spec----+ | +-BIT--------------+ | | +-MIXED------------+ | | +-BLOBF------------+ | | +-CLOBF--+-------+-+ | | | '-MIXED-' | | | '-DBCLOBF----------' | +-GRAPHIC-+----------+-+----------+-strip-spec-+ | '-EXTERNAL-' '-(length)-' | +-VARGRAPHIC--strip-spec-----------------------+ +-SMALLINT-------------------------------------+ +-INTEGER-+-----------------------+------------+ | '-EXTERNAL-+----------+-' | ®

DB2 9 for z/OS

347

®

DB2 9 z/OS Reference Guide | '-(length)-' | +-BIGINT---------------------------------------+ +-BINARY-+----------+-strip-spec---------------+ | '-(length)-' | +-+-VARBINARY------+--strip-spec---------------+ | '-BINARY VARYING-' | +-decimal-spec---------------------------------+ +-FLOAT-+----------+-+----------+--------------+ | '-EXTERNAL-' '-(length)-' | +-DATE--EXTERNAL--+----------+-----------------+ | '-(length)-' | +-TIME--EXTERNAL--+----------+-----------------+ | '-(length)-' | +-TIMESTAMP--EXTERNAL--+----------+------------+ | '-(length)-' | +-ROWID----------------------------------------+ +-BLOB-----------------------------------------+ +-CLOB-+-------+-------------------------------+ | '-MIXED-' | +-DBCLOB---------------------------------------+ | .-(34)-------------------. | +-DECFLOAT--+------------------------+---------+ | +-(16)-------------------+ | | '-EXTERNAL--+----------+-' | | '-(length)-' | '-XML--+---------------------------+-----------' | .-WHITESPACE-. | '-|PRESERVE--+------------+-' >--+--------------------------------------+-------------------->< +-NULLIF--field selection criterion----+ '-DEFAULTIF--field selection criterion-' Strip spec >>-+--------------------------------------------+---------------> | .-BOTH----. | '-STRIP--+----------+--+-------------------+-' +-TRAILING-+ | | '-LEADING--' +-'strip-char'------+ '-X'strip-char'-----' >--+----------+------------------------------------------------>< '-TRUNCATE-' decimal spec .-PACKED----------------------------. >>-DECIMAL-+-----------------------------------+--------------->< +-ZONED-----------------------------+ '-EXTERNAL-+----------------------+-' | .-,0-----. | '-(length-+--------+-)-' '-,scale-'

348

®

DB2 9 for z/OS

®


MERGECOPY

>>-MERGECOPY----------------------------------------------------> >--+-LIST--listdef-name--------------------------------------------------+--> | .-DSNUM--ALL-----. | '-TABLESPACE--+----------------+-table-space-name--+----------------+-' '-database-name.-' '-DSNUM--integer-' .-WORKDDN--SYSUT1-. >--+-------+--+-----------------+-------------------------------> '-CLONE-' '-WORKDDN--ddname-' .-NEWCOPY--NO-. .-COPYDDN--SYSCOPY-------------------. >--+-+-------------+--+------------------------------------+-------------+->< | +-COPYDDN(ddname1-+----------+-)-----+ | | | '-,ddname2-' | | | +-COPYDDN(,ddname2)------------------+ | | '-RECOVERYDDN(ddname3-+--------+-)-' | | | ',ddname4' | | | .-COPYDDN--SYSCOPY-----------. | '-NEWCOPY-YES-+----------------------------+--+-+--------------------+' +-COPYDDN(ddname1-+---------+-)-+ '-RECOVERYDDN(ddname3)' | ',ddname2-' | ',ddname4' '-COPYDDN(,ddname2)-------------'

MODIFY RECOVERY >>-MODIFY--RECOVERY---------------------------------------------> >--+-LIST--listdef-name------------------------------+----------> '-TABLESPACE--+----------------+-table-space-name-' '-database-name.-' .-DSNUM--ALL-----. >--+----------------+--+-------+--------------------------------> '-DSNUM--integer-' '-CLONE-' >--+-DELETE-+------------------+----------------------+-------->< | +-AGE-+-integer-+--+ | | | '-(*)-----' | | | '-DATE-+-integer-+-' | | '-(*)-----' | '-RETAIN----+-LAST--(--integer--)--------------+---' +-LOGLIMIT-------------------------+ '-GDGLIMIT-+---------------------+-' +-LAST--(--integer--)-+ '-LOGLIMIT------------'

MODIFY STATISTICS >>-MODIFY--STATISTICS-------------------------------------------> >--+-LIST-- listdef-name------------------------------+---------> +-TABLESPACE--+----------------+--table-space-name-+ | '-database-name.-' | +-INDEXSPACE--+----------------+--index-space-name-+ | '-database-name.-' | '-INDEX--+-------------+--index-name---------------' '-creator-id.-' >--DELETE-+-ALL--------+--+-AGE-+-(integer)-+--+--------------->< ®

DB2 9 for z/OS

349

®

DB2 9 z/OS Reference Guide +-ACCESSPATH-+ '-SPACE------'

| '-(*)-------' | '-DATE-+-(integer)-+-' '-(*)-------'

OPTIONS >>-OPTIONS------------------------------------------------------> >--+-+---------+--+-------------------+--+--------------------+--+------------+-+->< | '-PREVIEW-' '-LISTDEFDD--ddname-' '-TEMPLATEDD--ddname-' '-event-spec-' | +-OFF------------------------------------------------------------------------+ '-KEY--key-value-------------------------------------------------------------'

event-spec .-ITEMERROR,HALT-. .-WARNING,RC4-. >>-EVENT--(--+----------------+--+---+--+-------------+--)----->< '-ITEMERROR,SKIP-' '-,-' +-WARNING,RC0-+ '-WARNING,RC8-'

QUIESCE >>-QUIESCE------------------------------------------------------> >--+-LIST--listdef-name--------------------------------------------------+--> | .-------------------------------------------------------------------| | V | | '---+-TABLESPACE-+----------------+-table-space-name-+------------+-++-' | '-database-name.-' '-PART--integer-' | |-TABLESPACESET-+------------+-+----------------+-table-space-name-' '-TABLESPACE-' '-database-name.-' .-WRITE--YES-. >--+-------+--+------------+----------------------------------->< '-|CLONE-' '-WRITE--NO--'

REBUILD INDEX >>-REBUILD------------------------------------------------------> .-,---------------------------------------. V | >--+-INDEX--+-(----creatorid.index-name--+---------------+-+--)-+----------+> | | '-PART--integer-' | | | | +-(ALL)--table-space-spec---------------------------+ | | '-LIST--listdef-name--------------------------------' | | .-,------------------------------------------. | | V | | '-INDEXSPACE-+(----+----------------+--index-space-name--+----------++)-+' '-database-name.-' '-PART-int-' | '-(ALL)-table-space-spec-----------------------------' .-SHRLEVEL--REFERENCE-----------. >--+-------------------------------+--drain-spec--+-------+-----> '-SHRLEVEL--CHANGE--change-spec-' '-|CLONE-' .-SCOPE--ALL-----. >--+----------------+--+-------+--+-----------------------+-----> '-SCOPE--PENDING-' '-REUSE-' '-SORTDEVT--device-type-' >--+------------------+--+------------+------------------------>< '-SORTNUM--integer-' '-stats-spec-' 350

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide table-space-spec >>-TABLESPACE--+----------------+--table-space-name-------------> '-database-name.-' >--+---------------+------------------------------------------->< '-PART--integer-' change-spec .-MAXRO--integer-. .-LONGLOG--CONTINUE-. >>-+----------------+--+-------------------+--------------------> '-MAXRO--DEFER---' +-LONGLOG--TERM-----+ '-LONGLOG--DRAIN----' .-DELAY--1200----. >--+----------------+------------------------------------------>< '-DELAY--integer-' drain-spec .-DRAIN_WAIT--IRLMRWT value-. .-RETRY--UTIMOUT value-. >>-+---------------------------+--+----------------------+------> '-DRAIN_WAIT--integer-------' '-RETRY--integer-------' >--+----------------------+------------------------------------>< '-RETRY_DELAY--integer-' stats-spec .-REPORT--NO--. >>-STATISTICS--+-------------+--correlation-stats-spec----------> '-REPORT--YES-' .-UPDATE--ALL------------. >--+------------------------+--+-------------------------+------> '-UPDATE--+-ACCESSPATH-+-' '-HISTORY--+-ALL--------+-' +-SPACE------+ +-ACCESSPATH-+ '-NONE-------' +-SPACE------+ '-NONE-------' >--+----------------------+------------------------------------>< '-FORCEROLLUP--+-YES-+-' '-NO--' correlation-stat-spec >>-+---------+--------------------------------------------------> '-KEYCARD-' .-FREQVAL--NUMCOLS--1--COUNT--10----------------. >--+-----------------------------------------------+----------->< | .-------------------------------------------. | | V | | '---FREQVAL--NUMCOLS--integer--COUNT--integer-+-'

RECOVER >>-RECOVER------------------------------------------------------> >--+-+-LIST--listdef-name-----------------+--list-options-spec-+--> ®

DB2 9 for z/OS

351

®

DB2 9 z/OS Reference Guide | | .--------------------------------. | | | | V .-DSNUM--ALL----------. | | | | '---object-+---------------------+-+-' | | '-DSNUM--integer------' | | .-DSNUM--ALL----------. | +-object--+---------------------+--recover-options-spec-----+ | '-DSNUM--integer------' | '-object--PAGE--page-number--+----------+-------------------' '-CONTINUE-' .-LOGRANGES--YES-----. >--+-------+--+--------------+--+--------------------+--------->< '-CLONE-' +-LOCALSITE----+ | | '-RECOVERYSITE-'

'-LOGRANGES--NO------'

REORG INDEX

>>-REORG--+-INDEX--LIST--listdef-name-+--+-------+--+-------+---> '-index-name-spec-----------'

'-REUSE-'

'-CLONE-'

.-SHRLEVEL NONE-----------------------------------------------. >--+-------------------------------------------------------------+--> '-SHRLEVEL-+-REFERENCE--deadline-spec--drain-spec-----------+-' '-CHANGE--deadline-spec--drain-spec--change-spec-' >--+------------------------------------------+-----------------> '-LEAFDISTLIMIT-+---------+-+------------+-' '-integer-' '-REPORTONLY-' .-UNLOAD--CONTINUE-------. >--+------------------------+--+-----------------+--------------> '-UNLOAD--+-PAUSE------+-' '-stats-spec------' '-ONLY-------' .-WORKDDN--(SYSUT1)-. >--+-------------------+--+-----------+------------------------>< '-WORKDDN--(ddname)-' '-PREFORMAT-' index-name-spec >>-+-INDEX-+-------------+-index-name---------------+-----------> | '-creator-id.-' | '-INDEXSPACE-+----------------+-index-space-name-' '-database-name.-' >--+---------------+------------------------------------------->< '-PART--integer-' deadline-spec .-DEADLINE--NONE----------------------------. >>-+-------------------------------------------+--------------->< '-DEADLINE--+-timestamp-------------------+-' '-labeled-duration-expression-' drain-spec

352

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide >>-+---------------------+-------+----------------+-------------> '-DRAIN_WAIT--integer-' '-RETRY--integer-' >--+----------------------+------------------------------------>< '-RETRY_DELAY--integer-' change-spec .-DRAIN--WRITERS-. >>-+-------------------------+--+----------------+--------------> | | '-DRAIN--ALL-----' '-MAXRO--+-integer-+------' '-DEFER---' .-LONGLOG--CONTINUE--. .-DELAY--1200----. >--+--------------------+--+----------------+-------------------> '-LONGLOG--+-TERM--+-' '-DELAY--integer-' '-DRAIN-' .-TIMEOUT--TERM--. >--+----------------+------------------------------------------>< '-TIMEOUT--ABEND-' Labeled-duration-expression >>-+-CURRENT_DATE------+----------------------------------------> '-CURRENT_TIMESTAMP-' .-------------------------------------. V | >----+- + -+--constant--+-YEAR---------+-+--------------------->< '- - -' +-YEARS--------+ +-MONTH--------+ +-MONTHS-------+ +-DAY----------+ +-DAYS---------+ +-HOUR---------+ +-HOURS--------+ +-MINUTE-------+ +-MINUTES------+ +-SECOND-------+ +-SECONDS------+ +-MICROSECOND--+ '-MICROSECONDS-' stats-spec .-REPORT--NO--. >>-STATISTICS--+-------------+--correlation-stats-spec----------> '-REPORT--YES-' .-UPDATE--ALL------------. >--+------------------------+--+-------------------------+------> '-UPDATE--+-ACCESSPATH-+-' '-HISTORY--+-ALL--------+-' +-SPACE------+ +-ACCESSPATH-+ '-NONE-------' +-SPACE------+ '-NONE-------' ®

DB2 9 for z/OS

353

®

DB2 9 z/OS Reference Guide >--+----------------------+------------------------------------>< '-FORCEROLLUP--+-YES-+-' '-NO--' correlation-stat-spec >>-+---------+--------------------------------------------------> '-KEYCARD-' .-FREQVAL--NUMCOLS--1--COUNT--10----------------. >--+-----------------------------------------------+----------->< | .-------------------------------------------. | | V | | '---FREQVAL--NUMCOLS--integer--COUNT--integer-+-'

REORG TABLESPACE

>>-REORG--TABLESPACE--------------------------------------------> >--+-LIST--listdef-name-------------------------------------------------+--> '-+----------------+-table-space-name-+----------------------------+-' '-database-name.-' '-PART-+-integer-----------+-' '-integer1:integer2-' .-SCOPE ALL-----. >--+-------+--+-------+--+---------------+--+-----------+-------> '-|CLONE-' '-REUSE-' '-SCOPE PENDING-' '-REBALANCE-' .-YES-. .-LOG--YES-. .-SORTDATA--+-NO--+-. >--+----------+--+-------------------+--+----------+------------> '-LOG--NO--' '-NOSYSREC-' >--copy-spec----------------------------------------------------> .-SHRLEVEL NONE------------------------------------------------------. >--+--------------------------------------------------------------------+--> '-SHRLEVEL--+-REFERENCE--deadline-spec--drain-spec-----------------+-' '-CHANGE--deadline-spec--drain-spec--table-change-spec-' >--+------------------------------------------------------------------+--> | .-10------. .-10------. | '-OFFPOSLIMIT--+---------+-INDREFLIMIT--+---------+-+------------+-' '-integer-' '-integer-' '-REPORTONLY-' .-UNLOAD--CONTINUE---. >--+-+--------------------+--+----------------+--+-----------------+-+--> | | | '-KEEPDICTIONARY-' '-statistics-spec-' | | '-UNLOAD--PAUSE------' | +-UNLOAD--ONLY----------------------------------------------------+ '-UNLOAD--EXTERNAL--+-------+--+---------------------+------------' '-NOPAD-' | .-----------------. | | V | | '---FROM-TABLE-spec-+-' .-PUNCHDDN--SYSPUNCH-. .-DISCARDDN--SYSDISC-. >--+--------------------+--+--------------------+---------------> '-PUNCHDDN--ddname---' '-DISCARDDN--ddname--' >--+--------------------------+---------------------------------> '-reorg tablespace options-' >--+-----------------------------------------+----------------->< | .-----------------. | | V | | 354

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide '-DISCARD--+-------+----FROM-TABLE-spec-+-' '-NOPAD-' copy-spec .-COPYDDN(SYSCOPY)---------------------. >>-+--------------------------------------+---------------------> '-COPYDDN(-+-ddname1--+----------+-+-)-' | '-,ddname2-' | '-,ddname2--------------' >--+------------------------------------+---------------------->< '-RECOVERYDDN(ddname3-+----------+-)-' '-,ddname4-' deadline-spec .-DEADLINE--NONE----------------------------. >>-+-------------------------------------------+--------------->< '-DEADLINE--+-timestamp-------------------+-' '-labeled-duration-expression-' drain-spec >>-+---------------------+-------+----------------+-------------> '-DRAIN_WAIT--integer-' '-RETRY--integer-' .-MAXRO--------------. >--+----------------------+-------+--------------------+--------> '-RETRY_DELAY--integer-' '-MAXRO--+-integer-+-' '-DEFER---' .-DRAIN--WRITERS-. .-LONGLOG--CONTINUE--. >--+----------------+--+--------------------+-------------------> '-DRAIN--ALL-----' '-LONGLOG--+-TERM--+-' '-DRAIN-' .-DELAY--1200----. .-TIMEOUT--TERM--. >--+----------------+--+----------------+---------------------->< '-DELAY--integer-' '-TIMEOUT--ABEND-' table-change-spec >>-MAPPINGTABLE--table-name------------------------------------>< Labeled-duration-expression >>-+-CURRENT_DATE------+----------------------------------------> '-CURRENT_TIMESTAMP-' .-------------------------------------. V | >----+- + -+--constant--+-YEAR---------+-+--------------------->< '- - -' +-YEARS--------+ +-MONTH--------+ +-MONTHS-------+ +-DAY----------+ +-DAYS---------+ ®

DB2 9 for z/OS

355

®

DB2 9 z/OS Reference Guide +-HOUR---------+ +-HOURS--------+ +-MINUTE-------+ +-MINUTES------+ +-SECOND-------+ +-SECONDS------+ +-MICROSECOND--+ '-MICROSECONDS-'

statistics-spec >>-STATISTICS---------------------------------------------------> .-TABLE--(--ALL--)-. >--+-+------------------+--+-----------------+---------------------------+-> | '-SAMPLE--integer-' | | .-------------------------------------------------------------------| | V .-COLUMN--ALL---------------------------. | '---TABLE-(-table-name-)--+-----------------+--+--------------------+-+-' '-SAMPLE--integer-' | .-,-------. | | V | | '-COLUMN(-colname-)+-' .-INDEX--(--ALL--)-. >--+-+------------------+--correlation-stats-spec--------+------> | .-,----------------------------------. | | V | | '-INDEX--(----index-name--correlation-stats-spec-+--)-' .-REPORT--NO--. .-UPDATE--ALL------------. >--+-------------+--+------------------------+------------------> '-REPORT--YES-' '-UPDATE--+-ACCESSPATH-+-' +-SPACE------+ '-NONE-------' >--+-------------------------+--+----------------------+------->< '-HISTORY--+-ALL--------+-' '-FORCEROLLUP--+-YES-+-' +-ACCESSPATH-+ '-NO--' +-SPACE------+ '-NONE-------' correlation-stat-spec >>-+---------+--------------------------------------------------> '-KEYCARD-' .-FREQVAL--NUMCOLS--1--COUNT--10----------------. >--+-----------------------------------------------+----------->< | .-------------------------------------------. | | V | | '---FREQVAL--NUMCOLS--integer--COUNT--integer-+-' FROM-TABLE spec >>-FROM--TABLE--table-name--------------------------------------> >--+--------------------------------------+-------------------->< '-WHEN--(--selection-condition-spec--)-' selection-codition spec 356

®

DB2 9 for z/OS

®


>>-+-predicate-----------+--------------------------------------> '-selection condition-' .-------------------------------------. V | >----+----------------------------------+-+-------------------->< '-+-AND-+--+-predicate-----------+-' '-OR--' '-selection condition-' predicate >>-+-basic predicate---+--------------------------------------->< +-BETWEEN predicate-+ +-IN predicate------+ +-LIKE predicate----+ '-NULL predicate----' basic predicate >>-column-name--+- = --+----------------------------------------> +- -+ +- > --+ +- < --+ +- >= -+ '- >-+-----------------------------+------------------------------> '-PUNCHDDN--+-ddname--------+-' '-template-name-' .-UNLDDN--SYSREC------------. >--+---------------------------+--+---------+-------------------> '-UNLDDN--+-ddname--------+-' +-EBCDIC--+ '-template-name-' +-ASCII---+ '-UNICODE-' >--+----------------------+--+--------+--+-------+--------------> | .-,-------. | '-NOSUBS-' '-NOPAD-' | V | | '-CCSID(---integer-+-)-' >+-----------------------------------------------------------------------+--> | .-COLDEL--','----. .-CHARDEL--'"'-----. .-DECPT--'.'---. | '-DELIMITED--+----------------+--+------------------+--+--------------+-' '-COLDEL--coldel-' '-CHARDEL--chardel-' '-DECPT--decpt-' .-FLOAT--S390-. .-MAXERR--1-------. >--+-------------+--+-----------------+-------------------------> '-FLOAT--IEEE-' '-MAXERR--integer-' .-SHRLEVEL--CHANGE--ISOLATION--CS--+------------------+-. | '-SKIP LOCKED DATA-' | >--+-------------------------------------------------------+----> '-SHRLEVEL-+-CHANGE--ISOLATION--UR-+--------------------' '-REFERENCE-------------' >--+-----------------------------------------+----------------->< '-DECFLOAT_ROUNDMODE--+-ROUND_CEILING---+-' +-ROUND_DOWN------+ +-ROUND_FLOOR-----+ +-ROUND_HALF_DOWN-+ +-ROUND_HALF_EVEN-+ +-ROUND_HALF_UP---+ '-ROUND_UP--------' from-table spec >>-FROM--TABLE--table-name--------------------------------------> .-HEADER--OBID-------------------------. >--+--------------------------------------+---------------------> '-HEADER--+-NONE---------------------+-' '-CONST--+-'string'------+-' '-X'hex-string'-' >--+-----------------+--+----------------+----------------------> '-SAMPLE--decimal-' '-LIMIT--integer-' ®

DB2 9 for z/OS

363

®

DB2 9 z/OS Reference Guide >--+-----------------------------+------------------------------> | .-,-------------------. | | V | | '-(---field-specification-+-)-' >--+-----------------------------+----------------------------->< '-WHEN--(selection-condition)-' field spec .-POSITION(*)-----. >>-field-name--+-----------------+------------------------------> '-POSITION(start)-' >--+-----------------------------------------------------+----->< +-CHAR-+----------+-+----------------------------+----+ | '-(length)-' +-TRUNCATE-------------------+ | | '-+-BLOBF---+--template-name-' | | +-CLOBF---+ | | '-DBCLOBF-' | +-VARCHAR-+----------+-+----------------------------+-+ | '-(length)-' +-strip-spec-----------------+ | | '-+-BLOBF---+--template-name-' | | +-CLOBF---+ | | '-DBCLOBF-' | +-GRAPHIC-+----------+-+----------+-+----------+------+ | '-EXTERNAL-' '-(length)-' '-TRUNCATE-' | +-VARGRAPHIC-+----------+-strip-spec------------------+ | '-(length)-' | +-SMALLINT--------------------------------------------+ +-INTEGER--+-----------------------+------------------+ | '-EXTERNAL-+----------+-' | | '-(length)-' | +-BIGINT----------------------------------------------+ +-BINARY-+----------+-+----------+--------------------+ | '-(length)-' '-TRUNCATE-' | +-+-VARBINARY------+----------------------------------+ | '-BINARY VARYING-' | +-strip-spec------------------------------------------+ | .-PACKED---. | +-DECIMAL--+----------+--+----------------------+-----+ | +-ZONED----+ | .-,0-----. | | | '-EXTERNAL-' '-(length-+--------+-)-' | | '-,scale-' | +-FLOAT-+----------+-+----------+---------------------+ | '-EXTERNAL-' '-(length)-' | +-DOUBLE----------------------------------------------+ +-REAL------------------------------------------------+ +-DATE--EXTERNAL--+----------+------------------------+ | '-(length)-' | +-TIME--EXTERNAL--+----------+------------------------+ | '-(length)-' | +-TIMESTAMP--EXTERNAL--+----------+-------------------+ | '-(length)-' | +-CONSTANT--+-'string'------+-------------------------+ | '-X'hex-string'-' | +-ROWID-----------------------------------------------+ +-BLOB-+----------+-+----------+----------------------+ 364

®

DB2 9 for z/OS

®

DB2 V9 for z/OS Reference Guide | '-(length)-' '-TRUNCATE-' | +-CLOB-+----------+-+----------+----------------------+ | '-(length)-' '-TRUNCATE-' | +-DBCLOB-+----------+-+----------+--------------------+ | '-(length)-' '-TRUNCATE-' | | .-(34)-------------------. | +-DECFLOAT--+------------------------+----------------+ | +-(16)-------------------+ | | '-EXTERNAL--+----------+-' | | '-(length)-' | '-XML-------------------------------------------------' strip spec >>-+--------------------------------------------+---------------> | .-BOTH----. | '-STRIP--+----------+--+-------------------+-' +-TRAILING-+ | | '-LEADING--' +-'strip-char'------+ '-X'strip-char'-----' >--+----------+------------------------------------------------>< '-TRUNCATE-' selection-codition spec >>-+-predicate-----------+--------------------------------------> '-selection condition-' .-------------------------------------. V | >----+----------------------------------+-+-------------------->< '-+-AND-+--+-predicate-----------+-' '-OR--' '-selection condition-' predicate >>-+-basic predicate---+--------------------------------------->< +-BETWEEN predicate-+ +-IN predicate------+ +-LIKE predicate----+ '-NULL predicate----' basic predicate >>-column-name--+- = --+----------------------------------------> +- -+ +- > --+ +- < --+ +- >= -+ '-

DB2®9 for z/OS Reference Guide - DB2 Expert

DB2®9 for z/OS Reference Guide - DB2 Expert

Suggest Documents

DB2 10.1 LUW - DB2 Workload Management Guide and Reference

DB2 10.1 LUW - DB2 Workload Management Guide and Reference

PHP for zOS - Confex

Nimsoft Monitor db2 Guide

DB2 Connect User's Guide

DB2 Connect User's Guide

Symantec NetBackup™ for DB2 Administrator's Guide: UNIX ...

DB2 Access Service User's Guide

Zos Kia Cultus PDF

Cross-Reference Guide for:

Cross-Reference Guide for:

zOS Penetration Testing - Confex

Siebel Database Upgrade Guide for DB2 for z/OS - Oracle ...

External Products Integration Guide: IBM DB2 UDB

Product Reference Guide Product Reference Guide 2009

DB2 Connect User's Guide

DB2 Developer's Guide: A Solutions-Oriented ... - Pearsoncmg.com

DB2 Demo Program Guide - DBI Software

Read DB2 Developer s Guide - Google Sites

User Reference Guide for SkyDrive.pdf

REFERENCE GUIDE FOR PHARMACEUTICAL CALCULATIONS

Technical Reference Guide for Agents

QUICK REFERENCE GUIDE FOR mikroC

REFERENCE GUIDE