SYSPLAN catalog table

The SYSPLAN table contains one row for each application plan. The schema is SYSIBM.

Column name Data type Description Use
NAME
VARCHAR(24)
NOT NULL
Name of the application plan. G
CREATOR
VARCHAR(128)
NOT NULL
Authorization ID of the owner of the application plan. G
BINDDATE
CHAR(6)
NOT NULL
Not used. N
VALIDATE
CHAR(1)
NOT NULL
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.
G
ISOLATION
CHAR(1)
NOT NULL
Isolation level for the plan:
R
RR (repeatable read)
T
RS (read stability)
S
CS (cursor stability)
U
UR (uncommitted read)
G
VALID
CHAR(1)
NOT NULL
Whether the application plan is valid:
A
An 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".
H
An ALTER TABLE statement changed the description of the table or base table of a view that is referred to by the application plan.
N
No
Y
Yes
G
OPERATIVE
CHAR(1)
NOT NULL
Whether the application plan can be allocated:
N
No; an explicit BIND or REBIND is required before the plan can be allocated
Y
Yes
G
BINDTIME
CHAR(8)
NOT NULL
Not used. N
PLSIZE
INTEGER
NOT NULL
Size of the base section 1 of the plan, in bytes. G
IBMREQD
CHAR(1)
NOT NULL
A value of Y indicates that the row was provided with the Db2 product code. For all other values, see Release dependency indicators.

The value in this field is not a reliable indicator of release dependencies. RELBOUND should be used instead.

G
AVGSIZE
INTEGER
NOT NULL
Average size, in bytes, of those sections1 of the plan that contain SQL statements processed at bind time. G
ACQUIRE
CHAR(1)
NOT NULL
When resources are acquired:
A
At allocation
U
At first use
G
RELEASE
CHAR(1)
NOT NULL
When resources are released:
C
At commit
D
At deallocation
G
 EXREFERENCE
CHAR(1)
NOT NULL
Not used. N
 EXSTRUCTURE
CHAR(1)
NOT NULL
Not used. N
EXCOST
CHAR(1)
NOT NULL
Not used. N
EXPLAN 
CHAR(1)
NOT NULL
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
G
EXPREDICATE
CHAR(1)
NOT NULL
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.
G
BOUNDBY
VARCHAR(128)
NOT NULL WITH
DEFAULT
Primary authorization ID of the binder of the plan. G
QUALIFIER
VARCHAR(128)
NOT NULL WITH
DEFAULT
Implicit qualifier for the unqualified table, view, index, and alias names in the static SQL statements of the plan. G
CACHESIZE
SMALLINT
NOT NULL WITH
DEFAULT
Size, in bytes, of the cache to be acquired for the plan. A value of zero indicates that no cache is used. G
PLENTRIES
SMALLINT
NOT NULL WITH
DEFAULT
Number of package list entries for the plan. The negative of that number if there are rows for the plan in SYSIBM.SYSPACKLIST but the plan was bound in a prior release after fall back. G
DEFERPREP
CHAR(1)
NOT NULL WITH
DEFAULT
Whether the package was last bound with the DEFER(PREPARE) option:
N
No
Y
Yes
G
CURRENTSERVER
VARCHAR(128)
NOT NULL WITH
DEFAULT
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. G
SYSENTRIES
SMALLINT
NOT NULL WITH
DEFAULT
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. G
DEGREE
CHAR(3)
NOT NULL WITH
DEFAULT
The DEGREE option used when the plan was last bound:
ANY
DEGREE(ANY)
1 or blank
DEGREE(1). Blank if the plan was migrated.
G
SQLRULES
CHAR(1)
NOT NULL WITH
DEFAULT
The SQLRULES option used when the plan was last bound:
D or blank
SQLRULES(DB2)
S
SQLRULES(STD)
blank
A migrated plan
G
DISCONNECT
CHAR(1)
NOT NULL WITH
DEFAULT
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
G
GROUP_MEMBER
VARCHAR(24)
NOT NULL WITH
DEFAULT
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. G
DYNAMICRULES
CHAR(1)
NOT NULL WITH
DEFAULT
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.
G
BOUNDTS
TIMESTAMP
NOT NULL WITH
DEFAULT
Time when the plan was bound. G
REOPTVAR
CHAR(1)
NOT NULL WITH
DEFAULT 'N'
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.
G
KEEPDYNAMIC
CHAR(1)
NOT NULL WITH
DEFAULT 'N'
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.
G
PATHSCHEMAS
VARCHAR(2048)
NOT NULL WITH
DEFAULT
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. G
DBPROTOCOL
CHAR(1)
NOT NULL WITH
DEFAULT 'P'
Whether remote access for SQL with three-part names is implemented with DRDA or Db2 private protocol access:
D
DRDA
P
Db2 private protocol
G
FUNCTIONTS
TIMESTAMP
NOT NULL WITH
DEFAULT
Timestamp when the function was resolved. This value is set by the BIND and REBIND commands, but not by automatic rebinds (autobind). G
OPTHINT
VARCHAR(128)
NOT NULL WITH
DEFAULT
Value of the OPTHINT bind option. Identifies rows in the owner.PLAN_TABLE to be used as input to Db2. Contains blanks if no rows in the owner.PLAN_TABLE are to be used as input. G
ENCODING_CCSID
INTEGER
NOT NULL WITH
DEFAULT
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 default CCSID as specified on panel DSNTIPF at installation time. Used when the plan was bound prior to Version 7
G
IMMEDWRITE
CHAR(1)
NOT NULL WITH
DEFAULT
Indicates when writes of updated group buffer pool dependent pages are to be done. This option is only applicable for data sharing 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 buffer pool dependent pages are written at or before phase 1 commit.
blank
A migrated package.
G
RELBOUND
CHAR(1)
NOT NULL WITH
DEFAULT
The release when the package was bound or rebound.
blank
Bound prior to Version 7
For all other values, see Release dependency indicators
G
CATENCODE
CHAR(1)
Not used. N
REMARKS
VARCHAR(762)
NOT NULL WITH
DEFAULT
A character string provided by the user with the COMMENT statement. G
CREATORTYPE
CHAR(1)
NOT NULL WITH
DEFAULT
Indicates the type of creator:
blank
Authorization ID
L
Role
G
ROUNDING
CHAR(1)
NOT NULL WITH
DEFAULT
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.
G
LASTUSED
DATE
NOT NULL WITH
DEFAULT
Not used. N
CONCUR_ACC_RES
CHAR(1)
NOT NULL
Indicates the CONCURRENTACCESSRESOLUTION option when the package was bound or rebound:
blank
Not specified
U
USECURRENTLYCOMMITTED
W
WAITFOROUTCOME
G
PROGAUTH
CHAR(1)
NOT NULL WITH
DEFAULT 'D'
Indicates whether Db2 checks if a program is authorized to run a plan:
D
DISABLE
E
ENABLE
G
1 Plans are divided into sections. The base section of the plan must be in the EDM pool during the entire time the application program is executing. Other sections of the plan, corresponding roughly to sets of related SQL statements, are brought into the pool as needed.