DB2 bind on z/os

BIND and REBIND options for packages and plans

There are several options you can use for binding or rebinding plans and packages. Some of the options are common for both bind and rebind and for both plans and packages.

Defaults: The default for an option is the value used if you omit the entire option.

• A default of plan value for BIND PACKAGE means that the default is the same as the value determined during the bind or rebind of the plan to which the package is appended at run time.
• A default of existing value for REBIND PLAN or REBIND PACKAGE means that the default is the value that was determined during the previous bind or rebind of the plan or package that you are rebinding.

Catalog records: The DB2® catalog records information about plans and packages, chiefly in the tables SYSIBM.SYSPLAN and SYSIBM.SYSPACKAGE. The descriptions of where the options record information omit the constant qualifier, SYSIBM, of those table names.

For all other cases, the option descriptions note the specific defaults, which DB2 assigns at bind time. If a specific default value exists, that value is underlined.

• ACQUIRE bind option
  The ACQUIRE bind option specifies
  that resources for the packages in the plan are to be acquired when
  the application first accesses them.
• ACTION bind option
  The ACTION option determines whether the object (plan or
  package) replaces an existing object with the same name or is new.
• APCOMPARE bind option
  The APCOMPARE option determines whether the new access paths are different from the older
  access paths.
• APPLCOMPAT bind option
  The APPLCOMPAT option specifies the package compatibility
  level behavior for static SQL.
• APRETAINDUP bind option
  The APRETAINDUP option determines whether or not DB2 retains an old package copy
  when access paths of the old copy are identical to the incoming copy.
• APREUSE bind option
  The APREUSE option specifies whether DB2 tries to
  reuse previous access paths for SQL statements in a package. DB2 uses
  information about the previous access paths from the directory to create
  a hint.
• ARCHIVESENSITIVE bind option
  The ARCHIVESENSITIVE option determines whether references to archive-enabled tables in
  both static and dynamic SQL statements are affected by the value of the SYSIBMADM.GET_ARCHIVE global
  variable.
• BUSTIMESENSITIVE bind option
  The BUSTIMESENSITIVE option determines whether references
  to application-period temporal tables in both static and dynamic SQL
  statements are affected by the value of the CURRENT TEMPORAL BUSINESS_TIME
  special register.
• CACHESIZE bind option
  The CACHESIZE option determines the size (in bytes) of
  the authorization cache acquired in the EDM pool for the plan.
• COLLID bind option
  The COLLID option specifies that any DBRMs in the plan
  are to be bound to packages.
• CONCURRENTACCESSRESOLUTION bind option
  The CONCURRENTACCESSRESOLUTION option specifies which concurrent
  access resolution option to use for statements in a package.
• COPY bind option
  The COPY option copies an existing package, and names that
  package.
• CURRENTDATA bind option
  The CURRENTDATA option determines whether to require data
  currency for read-only and ambiguous cursors when the isolation level
  of cursor stability is in effect. It also determines whether block
  fetching can be used for distributed, ambiguous cursors.
• CURRENTSERVER bind option
  The CURRENTSERVER option determines the location to connect
  to before running a plan.
• DBPROTOCOL bind option
  The DBPROTOCOL option
  specifies the protocol to be used when connecting to a remote site.
• DEFER and NODEFER bind options
  The DEFER and NODEFER options determine whether to defer
  preparation for dynamic SQL statements that refer to remote objects,
  or to prepare them immediately.
• DEGREE bind option
  The DEGREE option determines whether to attempt to run
  a query using parallel processing to maximize performance.
• DEPLOY bind option
  The DEPLOY option deploys
  a non-inline SQL function or a native SQL procedure.
• DESCSTAT bind option
  The DESCSTAT option determines whether DB2 builds a DESCRIBE SQL descriptor area (SQLDA)
  when binding static SQL statements.
• DISCONNECT bind option
  The DISCONNECT option determines which remote connections
  to destroy during commit operations.
• DYNAMICRULES bind option
  The DYNAMICRULES option determines the rules that apply
  at run time for certain dynamic SQL attributes.
• ENABLE and DISABLE bind options
  The ENABLE and DISABLE options determines which connections
  can use a plan or package.
• ENCODING bind option
  The ENCODING option specifies the application encoding
  for all host variables in static statements in a plan or package.
• EXPLAIN bind option
  The EXPLAIN option causes the bind
  process to obtain information about how SQL statements in the package
  or packages are to execute.
• EXTENDEDINDICATOR bind option
  The EXTENDEDINDICATOR option determines whether DB2 recognizes extended indicator
  variables when the associated package is run.
• FILTER bind option
  The FILTER option lets you delete a set of queries in the
  SYSIBM.SYSQUERY table under a {tag} value that is specified by the
  SYSQUERY.USERFILTER column.
• FLAG bind option
  The FLAG option determines the messages to display during
  the bind process.
• GENERIC bind option
  The GENERIC option specifies one or more bind options that
  are supported by the target server, but are not supported as options
  for BIND PACKAGE or REBIND PACKAGE on the DB2 for z/OS® subsystem
  on which the BIND or REBIND command is issued.
• GETACCELARCHIVE bind option
  The GETACCELARCHIVE bind option specifies whether a static
  SQL query that is bound for acceleration retrieves archived data on
  the accelerator, instead of active data.
• IMMEDWRITE bind option
  The IMMEDWRITE option indicates whether immediate writes
  are to be done for updates that are made to group buffer pool dependent
  page sets or partitions.
• ISOLATION bind option
  The ISOLATION option determines how far to isolate an application
  from the effects of other running applications.
• KEEPDYNAMIC bind option
  The KEEPDYNAMIC option determines whether DB2 keeps dynamic SQL statements after commit points. .
• LIBRARY bind option
  The LIBRARY option determines what
  partitioned data set or zFS file path to search for the DBRM that
  is listed in the MEMBER option.
• MEMBER bind option
  The MEMBER option determines
  what database request modules (DBRMs) to include in the package.
• OPTHINT bind option
  The OPTHINT option controls whether access paths that are
  specified in PLAN_TABLE instances are used for static SQL statements.
• OPTIONS bind option
  The OPTIONS option specifies which bind options to use
  for the new package when the COPY option is specified.
• OWNER bind option
  The OWNER option determines the authorization ID of the
  owner of a plan or package.
• PACKAGE bind option
  The PACKAGE option determines the packages to bind or rebind.
• PATH bind option
  The PATH option determines the SQL path that DB2 uses to resolve unqualified stored procedure
  names in CALL statements, in user-defined data types, and in functions.
• PATHDEFAULT bind option
  The PATHDEFAULT option resets the
  PATH value for a package or plan to SYSIBM, SYSFUN, SYSPROC, SYSIBMADM, plan
  qualifier, or to SYSIBM, SYSFUN, SYSPROC, SYSIBMADM, package
  qualifier .
• PKLIST and NOPKLIST bind options
  The PKLIST option determines the packages to include in
  a package list. The NOPKLIST option deletes packages from a package
  list.
• PLAN bind option
  The PLAN option determines the plan or plans to bind or rebind.
• PLANMGMT bind option
  The PLANMGMT option retains, during a rebind operation,
  all relevant package information (such as metadata, query text, dependencies,
  authorizations, and access paths) in catalog tables and in the directory.
• PROGAUTH bind option
  The PROGAUTH option specifies whether DB2 performs program authorization checking to
  determine whether DB2 can execute
  a plan.
• QUALIFIER bind option
  The QUALIFIER option determines the implicit qualifier
  for unqualified names of tables, views, indexes, and aliases contained
  in the plan or package.
• QUERYACCELERATION bind option
  The QUERYACCELERATION bind option specifies whether a static
  SQL query is bound for acceleration, and if so, with what behavior.
• QUERYID bind option
  The QUERYID option frees entries in the SYSIBM.SYSQUERY
  table, and the SYSIBM.SYSQUERYPLAN table or the SYSIBM.SYSQUERYOPTS
  table.
• RELEASE bind option
  The RELEASE option determines when to release resources
  that a program uses, either at each commit point or when the program
  terminates.
• REOPT bind option
  The REOPT option specifies whether DB2 determines an access path at run time by
  using the values of host variables, parameter markers, and special
  registers.
• ROUNDING bind option
  The ROUNDING option specifies the rounding mode at bind
  time. Use rounding mode to manipulate DECFLOAT data.
• SQLERROR bind option
  The SQLERROR option determines whether to create a package
  if SQL errors occur.
• SQLRULES bind option
  The SQLRULES option determines whether you can execute
  a type 2 CONNECT statement to an existing SQL connection, according
  to DB2 rules.
• SWITCH bind option
  The SWITCH option causes the previous copy or original
  copy of a package to become the current copy of the package.
• SYSTIMESENSITIVE bind option
  The SYSTIMESENSITIVE option specifies whether references
  to system-period temporal tables in both static and dynamic SQL statements
  are affected by the value of the CURRENT TEMPORAL SYSTEM_TIME special
  register.
• VALIDATE bind option
  The VALIDATE option determines whether to recheck, at run
  time, errors of the types "OBJECT NOT FOUND" and "NOT AUTHORIZED"
  that are found during bind or rebind.