diff options
| author | Andrew Dolgov <fox@fakecake.org> | 2024-12-10 05:22:37 +0000 |
|---|---|---|
| committer | Andrew Dolgov <fox@fakecake.org> | 2024-12-10 05:22:37 +0000 |
| commit | 0ef2dd7175248e1116a867e0a86579d9f6ca16eb (patch) | |
| tree | 452fc6e3391544b209ea075d587935e7ab42e714 /vendor/thecodingmachine/safe/generated/ibmDb2.php | |
| parent | f15db7b9610467aa29f6441361fdc4e6c90deaa1 (diff) | |
| parent | 3860435cba19cf2cd9c86dcc5d8938198c6b6736 (diff) | |
Merge branch 'feature/alpine_3.21-and-php_8.4' into 'master'
Bump to Alpine 3.21 and PHP 8.4, raise the minimum to PHP 8.2
See merge request tt-rss/tt-rss!85
Diffstat (limited to 'vendor/thecodingmachine/safe/generated/ibmDb2.php')
| -rw-r--r-- | vendor/thecodingmachine/safe/generated/ibmDb2.php | 1221 |
1 files changed, 0 insertions, 1221 deletions
diff --git a/vendor/thecodingmachine/safe/generated/ibmDb2.php b/vendor/thecodingmachine/safe/generated/ibmDb2.php deleted file mode 100644 index f97e7b086..000000000 --- a/vendor/thecodingmachine/safe/generated/ibmDb2.php +++ /dev/null @@ -1,1221 +0,0 @@ -<?php - -namespace Safe; - -use Safe\Exceptions\IbmDb2Exception; - -/** - * Sets or gets the AUTOCOMMIT behavior of the specified connection resource. - * - * @param resource $connection A valid database connection resource variable as returned from - * db2_connect or db2_pconnect. - * @param int $value One of the following constants: - * - * - * DB2_AUTOCOMMIT_OFF - * - * - * Turns AUTOCOMMIT off. - * - * - * - * - * DB2_AUTOCOMMIT_ON - * - * - * Turns AUTOCOMMIT on. - * - * - * - * - * - * Turns AUTOCOMMIT off. - * - * Turns AUTOCOMMIT on. - * @return mixed When db2_autocommit receives only the - * connection parameter, it returns the current state - * of AUTOCOMMIT for the requested connection as an integer value. A value of - * DB2_AUTOCOMMIT_OFF indicates that AUTOCOMMIT is off, while a value of DB2_AUTOCOMMIT_ON indicates that - * AUTOCOMMIT is on. - * - * When db2_autocommit receives both the - * connection parameter and - * autocommit parameter, it attempts to set the - * AUTOCOMMIT state of the requested connection to the corresponding state. - * Returns TRUE on success. - * @throws IbmDb2Exception - * - */ -function db2_autocommit($connection, int $value = null) -{ - error_clear_last(); - if ($value !== null) { - $result = \db2_autocommit($connection, $value); - } else { - $result = \db2_autocommit($connection); - } - if ($result === false) { - throw IbmDb2Exception::createFromPhpError(); - } - return $result; -} - - -/** - * Binds a PHP variable to an SQL statement parameter in a statement resource - * returned by db2_prepare. This function gives you more - * control over the parameter type, data type, precision, and scale for the - * parameter than simply passing the variable as part of the optional input - * array to db2_execute. - * - * @param resource $stmt A prepared statement returned from db2_prepare. - * @param int $parameter_number Specifies the 1-indexed position of the parameter in the prepared - * statement. - * @param string $variable_name A string specifying the name of the PHP variable to bind to the - * parameter specified by parameter_number. - * @param int $parameter_type A constant specifying whether the PHP variable should be bound to the - * SQL parameter as an input parameter (DB2_PARAM_IN), - * an output parameter (DB2_PARAM_OUT), or as a - * parameter that accepts input and returns output - * (DB2_PARAM_INOUT). To avoid memory overhead, you can - * also specify DB2_PARAM_FILE to bind the PHP variable - * to the name of a file that contains large object (BLOB, CLOB, or DBCLOB) - * data. - * @param int $data_type A constant specifying the SQL data type that the PHP variable should be - * bound as: one of DB2_BINARY, - * DB2_CHAR, DB2_DOUBLE, or - * DB2_LONG . - * @param int $precision Specifies the precision with which the variable should be bound to the - * database. This parameter can also be used for retrieving XML output values - * from stored procedures. A non-negative value specifies the maximum size of - * the XML data that will be retrieved from the database. If this parameter - * is not used, a default of 1MB will be assumed for retrieving the XML - * output value from the stored procedure. - * @param int $scale Specifies the scale with which the variable should be bound to the - * database. - * @throws IbmDb2Exception - * - */ -function db2_bind_param($stmt, int $parameter_number, string $variable_name, int $parameter_type = null, int $data_type = 0, int $precision = -1, int $scale = 0): void -{ - error_clear_last(); - if ($scale !== 0) { - $result = \db2_bind_param($stmt, $parameter_number, $variable_name, $parameter_type, $data_type, $precision, $scale); - } elseif ($precision !== -1) { - $result = \db2_bind_param($stmt, $parameter_number, $variable_name, $parameter_type, $data_type, $precision); - } elseif ($data_type !== 0) { - $result = \db2_bind_param($stmt, $parameter_number, $variable_name, $parameter_type, $data_type); - } elseif ($parameter_type !== null) { - $result = \db2_bind_param($stmt, $parameter_number, $variable_name, $parameter_type); - } else { - $result = \db2_bind_param($stmt, $parameter_number, $variable_name); - } - if ($result === false) { - throw IbmDb2Exception::createFromPhpError(); - } -} - - -/** - * This function returns an object with read-only properties that return - * information about the DB2 database client. The following table lists - * the DB2 client properties: - * - * DB2 client properties - * - * - * - * Property name - * Return type - * Description - * - * - * - * - * APPL_CODEPAGE - * int - * The application code page. - * - * - * CONN_CODEPAGE - * int - * The code page for the current connection. - * - * - * DATA_SOURCE_NAME - * string - * The data source name (DSN) used to create the current connection - * to the database. - * - * - * DRIVER_NAME - * string - * The name of the library that implements the DB2 Call - * Level Interface (CLI) specification. - * - * - * DRIVER_ODBC_VER - * string - * The version of ODBC that the DB2 client supports. This returns a - * string "MM.mm" where MM is the major version and - * mm is the minor version. The DB2 client always - * returns "03.51". - * - * - * - * DRIVER_VER - * string - * The version of the client, in the form of a string "MM.mm.uuuu" where - * MM is the major version, - * mm is the minor version, - * and uuuu is the update. For example, "08.02.0001" - * represents major version 8, minor version 2, update 1. - * - * - * - * ODBC_SQL_CONFORMANCE - * string - * - * The level of ODBC SQL grammar supported by the client: - * - * - * MINIMUM - * - * - * Supports the minimum ODBC SQL grammar. - * - * - * - * - * CORE - * - * - * Supports the core ODBC SQL grammar. - * - * - * - * - * EXTENDED - * - * - * Supports extended ODBC SQL grammar. - * - * - * - * - * - * - * - * - * ODBC_VER - * string - * The version of ODBC that the ODBC driver manager supports. This - * returns a string "MM.mm.rrrr" where MM is the major - * version, mm is the minor version, and - * rrrr is the release. The DB2 client always returns - * "03.01.0000". - * - * - * - * - * - * - * @param resource $connection Specifies an active DB2 client connection. - * @return object Returns an object on a successful call. Returns FALSE on failure. - * @throws IbmDb2Exception - * - */ -function db2_client_info($connection): object -{ - error_clear_last(); - $result = \db2_client_info($connection); - if ($result === false) { - throw IbmDb2Exception::createFromPhpError(); - } - return $result; -} - - -/** - * This function closes a DB2 client connection created with - * db2_connect and returns the corresponding - * resources to the database server. - * - * If you attempt to close a persistent DB2 client connection created with - * db2_pconnect, the close request is ignored and the - * persistent DB2 client connection remains available for the next caller. - * - * @param resource $connection Specifies an active DB2 client connection. - * @throws IbmDb2Exception - * - */ -function db2_close($connection): void -{ - error_clear_last(); - $result = \db2_close($connection); - if ($result === false) { - throw IbmDb2Exception::createFromPhpError(); - } -} - - -/** - * Commits an in-progress transaction on the specified connection resource and - * begins a new transaction. PHP applications normally default to AUTOCOMMIT - * mode, so db2_commit is not necessary unless AUTOCOMMIT - * has been turned off for the connection resource. - * - * @param resource $connection A valid database connection resource variable as returned from - * db2_connect or db2_pconnect. - * @throws IbmDb2Exception - * - */ -function db2_commit($connection): void -{ - error_clear_last(); - $result = \db2_commit($connection); - if ($result === false) { - throw IbmDb2Exception::createFromPhpError(); - } -} - - -/** - * db2_execute executes an SQL statement that was - * prepared by db2_prepare. - * - * If the SQL statement returns a result set, for example, a SELECT statement - * or a CALL to a stored procedure that returns one or more result sets, you - * can retrieve a row as an array from the stmt resource - * using db2_fetch_assoc, - * db2_fetch_both, or - * db2_fetch_array. Alternatively, you can use - * db2_fetch_row to move the result set pointer to the - * next row and fetch a column at a time from that row with - * db2_result. - * - * Refer to db2_prepare for a brief discussion of the - * advantages of using db2_prepare and - * db2_execute rather than db2_exec. - * - * @param resource $stmt A prepared statement returned from db2_prepare. - * @param array $parameters An array of input parameters matching any parameter markers contained - * in the prepared statement. - * @throws IbmDb2Exception - * - */ -function db2_execute($stmt, array $parameters = null): void -{ - error_clear_last(); - if ($parameters !== null) { - $result = \db2_execute($stmt, $parameters); - } else { - $result = \db2_execute($stmt); - } - if ($result === false) { - throw IbmDb2Exception::createFromPhpError(); - } -} - - -/** - * Frees the system and database resources that are associated with a result - * set. These resources are freed implicitly when a script finishes, but you - * can call db2_free_result to explicitly free the result - * set resources before the end of the script. - * - * @param resource $stmt A valid statement resource. - * @throws IbmDb2Exception - * - */ -function db2_free_result($stmt): void -{ - error_clear_last(); - $result = \db2_free_result($stmt); - if ($result === false) { - throw IbmDb2Exception::createFromPhpError(); - } -} - - -/** - * Frees the system and database resources that are associated with a statement - * resource. These resources are freed implicitly when a script finishes, but - * you can call db2_free_stmt to explicitly free the - * statement resources before the end of the script. - * - * @param resource $stmt A valid statement resource. - * @throws IbmDb2Exception - * - */ -function db2_free_stmt($stmt): void -{ - error_clear_last(); - $result = \db2_free_stmt($stmt); - if ($result === false) { - throw IbmDb2Exception::createFromPhpError(); - } -} - - -/** - * Retrieves the value of a specified option value for a statement resource - * or a connection resource. - * - * @param resource $resource A valid statement resource as returned from - * db2_prepare or a valid connection resource as - * returned from db2_connect or - * db2_pconnect. - * @param string $option A valid statement or connection options. The following new options are available - * as of ibm_db2 version 1.6.0. They provide useful tracking information - * that can be set during execution with db2_get_option. - * - * - * Prior versions of ibm_db2 do not support these new options. - * - * - * When the value in each option is being set, some servers might not handle - * the entire length provided and might truncate the value. - * - * - * To ensure that the data specified in each option is converted correctly - * when transmitted to a host system, use only the characters A through Z, - * 0 through 9, and the underscore (_) or period (.). - * - * - * - * - * userid - * - * - * SQL_ATTR_INFO_USERID - A pointer to a null-terminated - * character string used to identify the client user ID sent to the host - * database server when using DB2 Connect. - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 16 characters. - * This user-id is not to be confused with the authentication user-id, it is for - * identification purposes only and is not used for any authorization. - * - * - * - * - * - * - * acctstr - * - * - * SQL_ATTR_INFO_ACCTSTR - A pointer to a null-terminated - * character string used to identify the client accounting string sent to the - * host database server when using DB2 Connect. - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 200 characters. - * - * - * - * - * - * - * applname - * - * - * SQL_ATTR_INFO_APPLNAME - A pointer to a null-terminated - * character string used to identify the client application name sent to the - * host database server when using DB2 Connect. - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 32 characters. - * - * - * - * - * - * - * wrkstnname - * - * - * SQL_ATTR_INFO_WRKSTNNAME - A pointer to a null-terminated - * character string used to identify the client workstation name sent to the - * host database server when using DB2 Connect. - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 18 characters. - * - * - * - * - * - * - * - * Prior versions of ibm_db2 do not support these new options. - * - * When the value in each option is being set, some servers might not handle - * the entire length provided and might truncate the value. - * - * To ensure that the data specified in each option is converted correctly - * when transmitted to a host system, use only the characters A through Z, - * 0 through 9, and the underscore (_) or period (.). - * - * SQL_ATTR_INFO_USERID - A pointer to a null-terminated - * character string used to identify the client user ID sent to the host - * database server when using DB2 Connect. - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 16 characters. - * This user-id is not to be confused with the authentication user-id, it is for - * identification purposes only and is not used for any authorization. - * - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 16 characters. - * This user-id is not to be confused with the authentication user-id, it is for - * identification purposes only and is not used for any authorization. - * - * SQL_ATTR_INFO_ACCTSTR - A pointer to a null-terminated - * character string used to identify the client accounting string sent to the - * host database server when using DB2 Connect. - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 200 characters. - * - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 200 characters. - * - * SQL_ATTR_INFO_APPLNAME - A pointer to a null-terminated - * character string used to identify the client application name sent to the - * host database server when using DB2 Connect. - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 32 characters. - * - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 32 characters. - * - * SQL_ATTR_INFO_WRKSTNNAME - A pointer to a null-terminated - * character string used to identify the client workstation name sent to the - * host database server when using DB2 Connect. - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 18 characters. - * - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 18 characters. - * @return string Returns the current setting of the connection attribute provided on success. - * @throws IbmDb2Exception - * - */ -function db2_get_option($resource, string $option): string -{ - error_clear_last(); - $result = \db2_get_option($resource, $option); - if ($result === false) { - throw IbmDb2Exception::createFromPhpError(); - } - return $result; -} - - -/** - * This function closes a DB2 client connection created with - * db2_pconnect and returns the corresponding resources - * to the database server. - * - * - * This function is only available on i5/OS in response to i5/OS system - * administration requests. - * - * - * - * If you have a persistent DB2 client connection created with - * db2_pconnect, you may use this function to close the - * connection. To avoid substantial connection performance penalties, this - * function should only be used in rare cases when the persistent connection - * has become unresponsive or the persistent connection will not be needed for - * a long period of time. - * - * @param resource $resource Specifies an active DB2 client connection. - * @throws IbmDb2Exception - * - */ -function db2_pclose($resource): void -{ - error_clear_last(); - $result = \db2_pclose($resource); - if ($result === false) { - throw IbmDb2Exception::createFromPhpError(); - } -} - - -/** - * Rolls back an in-progress transaction on the specified connection resource and - * begins a new transaction. PHP applications normally default to AUTOCOMMIT - * mode, so db2_rollback normally has no effect unless - * AUTOCOMMIT has been turned off for the connection resource. - * - * @param resource $connection A valid database connection resource variable as returned from - * db2_connect or db2_pconnect. - * @throws IbmDb2Exception - * - */ -function db2_rollback($connection): void -{ - error_clear_last(); - $result = \db2_rollback($connection); - if ($result === false) { - throw IbmDb2Exception::createFromPhpError(); - } -} - - -/** - * This function returns an object with read-only properties that return - * information about the IBM DB2, Cloudscape, or Apache Derby database server. - * The following table lists the database server properties: - * - * Database server properties - * - * - * - * Property name - * Return type - * Description - * - * - * - * - * DBMS_NAME - * string - * The name of the database server to which you are - * connected. For DB2 servers this is a combination of - * DB2 followed by the operating system on which - * the database server is running. - * - * - * DBMS_VER - * string - * The version of the database server, in the form of a string - * "MM.mm.uuuu" where MM is the major version, - * mm is the minor version, - * and uuuu is the update. For example, "08.02.0001" - * represents major version 8, minor version 2, update 1. - * - * - * - * DB_CODEPAGE - * int - * The code page of the database to which you are connected. - * - * - * DB_NAME - * string - * The name of the database to which you are connected. - * - * - * DFT_ISOLATION - * string - * - * The default transaction isolation level supported by the - * server: - * - * - * UR - * - * - * Uncommitted read: changes are immediately visible by all - * concurrent transactions. - * - * - * - * - * CS - * - * - * Cursor stability: a row read by one transaction can be altered and - * committed by a second concurrent transaction. - * - * - * - * - * RS - * - * - * Read stability: a transaction can add or remove rows matching a - * search condition or a pending transaction. - * - * - * - * - * RR - * - * - * Repeatable read: data affected by pending transaction is not - * available to other transactions. - * - * - * - * - * NC - * - * - * No commit: any changes are visible at the end of a successful - * operation. Explicit commits and rollbacks are not allowed. - * - * - * - * - * - * - * - * - * IDENTIFIER_QUOTE_CHAR - * string - * The character used to delimit an identifier. - * - * - * INST_NAME - * string - * The instance on the database server that contains the - * database. - * - * - * ISOLATION_OPTION - * array - * An array of the isolation options supported by the - * database server. The isolation options are described in - * the DFT_ISOLATION property. - * - * - * KEYWORDS - * array - * An array of the keywords reserved by the database - * server. - * - * - * LIKE_ESCAPE_CLAUSE - * bool - * TRUE if the database server supports the - * use of % and _ wildcard - * characters. FALSE if the database server does not - * support these wildcard characters. - * - * - * MAX_COL_NAME_LEN - * int - * Maximum length of a column name supported by the database - * server, expressed in bytes. - * - * - * MAX_IDENTIFIER_LEN - * int - * Maximum length of an SQL identifier supported by the database - * server, expressed in characters. - * - * - * MAX_INDEX_SIZE - * int - * Maximum size of columns combined in an index supported by the - * database server, expressed in bytes. - * - * - * MAX_PROC_NAME_LEN - * int - * Maximum length of a procedure name supported by the database - * server, expressed in bytes. - * - * - * MAX_ROW_SIZE - * int - * Maximum length of a row in a base table supported by the - * database server, expressed in bytes. - * - * - * MAX_SCHEMA_NAME_LEN - * int - * Maximum length of a schema name supported by the database - * server, expressed in bytes. - * - * - * MAX_STATEMENT_LEN - * int - * Maximum length of an SQL statement supported by the database - * server, expressed in bytes. - * - * - * MAX_TABLE_NAME_LEN - * int - * Maximum length of a table name supported by the database - * server, expressed in bytes. - * - * - * NON_NULLABLE_COLUMNS - * bool - * TRUE if the database server supports columns that can be - * defined as NOT NULL, FALSE if the database server does not support - * columns defined as NOT NULL. - * - * - * PROCEDURES - * bool - * TRUE if the database server supports the use of the CALL - * statement to call stored procedures, FALSE if the database - * server does not support the CALL statement. - * - * - * SPECIAL_CHARS - * string - * A string containing all of the characters other than - * a-Z, 0-9, and underscore that can be used in an identifier name. - * - * - * SQL_CONFORMANCE - * string - * - * The level of conformance to the ANSI/ISO SQL-92 specification - * offered by the database server: - * - * - * ENTRY - * - * - * Entry-level SQL-92 compliance. - * - * - * - * - * FIPS127 - * - * - * FIPS-127-2 transitional compliance. - * - * - * - * - * FULL - * - * - * Full level SQL-92 compliance. - * - * - * - * - * INTERMEDIATE - * - * - * Intermediate level SQL-92 compliance. - * - * - * - * - * - * - * - * - * - * - * - * @param resource $connection Specifies an active DB2 client connection. - * @return object Returns an object on a successful call. Returns FALSE on failure. - * @throws IbmDb2Exception - * - */ -function db2_server_info($connection): object -{ - error_clear_last(); - $result = \db2_server_info($connection); - if ($result === false) { - throw IbmDb2Exception::createFromPhpError(); - } - return $result; -} - - -/** - * Sets options for a statement resource or a connection resource. You - * cannot set options for result set resources. - * - * @param resource $resource A valid statement resource as returned from - * db2_prepare or a valid connection resource as - * returned from db2_connect or - * db2_pconnect. - * @param array $options An associative array containing valid statement or connection - * options. This parameter can be used to change autocommit values, - * cursor types (scrollable or forward), and to specify the case of - * the column names (lower, upper, or natural) that will appear in a - * result set. - * - * - * autocommit - * - * - * Passing DB2_AUTOCOMMIT_ON turns - * autocommit on for the specified connection resource. - * - * - * Passing DB2_AUTOCOMMIT_OFF turns - * autocommit off for the specified connection resource. - * - * - * - * - * cursor - * - * - * Passing DB2_FORWARD_ONLY specifies a - * forward-only cursor for a statement resource. This is the - * default cursor type, and is supported by all database - * servers. - * - * - * Passing DB2_SCROLLABLE specifies a - * scrollable cursor for a statement resource. Scrollable - * cursors enable result set rows to be accessed in - * non-sequential order, but are only supported by - * IBM DB2 Universal Database databases. - * - * - * - * - * binmode - * - * - * Passing DB2_BINARY specifies that - * binary data will be returned as is. This is the default - * mode. This is the equivalent of setting - * ibm_db2.binmode=1 in php.ini. - * - * - * Passing DB2_CONVERT specifies that - * binary data will be converted to hexadecimal encoding, - * and will be returned as such. This is the equivalent of - * setting ibm_db2.binmode=2 in php.ini. - * - * - * Passing DB2_PASSTHRU specifies that - * binary data will be converted to NULL. This is the - * equivalent of setting ibm_db2.binmode=3 - * in php.ini. - * - * - * - * - * db2_attr_case - * - * - * Passing DB2_CASE_LOWER specifies that - * column names of the result set are returned in lower case. - * - * - * Passing DB2_CASE_UPPER specifies that - * column names of the result set are returned in upper case. - * - * - * Passing DB2_CASE_NATURAL specifies that - * column names of the result set are returned in natural - * case. - * - * - * - * - * deferred_prepare - * - * - * Passing DB2_DEFERRED_PREPARE_ON turns deferred - * prepare on for the specified statement resource. - * - * - * Passing DB2_DEFERRED_PREPARE_OFF turns deferred - * prepare off for the specified statement resource. - * - * - * - * - * - * Passing DB2_AUTOCOMMIT_ON turns - * autocommit on for the specified connection resource. - * - * Passing DB2_AUTOCOMMIT_OFF turns - * autocommit off for the specified connection resource. - * - * Passing DB2_FORWARD_ONLY specifies a - * forward-only cursor for a statement resource. This is the - * default cursor type, and is supported by all database - * servers. - * - * Passing DB2_SCROLLABLE specifies a - * scrollable cursor for a statement resource. Scrollable - * cursors enable result set rows to be accessed in - * non-sequential order, but are only supported by - * IBM DB2 Universal Database databases. - * - * Passing DB2_BINARY specifies that - * binary data will be returned as is. This is the default - * mode. This is the equivalent of setting - * ibm_db2.binmode=1 in php.ini. - * - * Passing DB2_CONVERT specifies that - * binary data will be converted to hexadecimal encoding, - * and will be returned as such. This is the equivalent of - * setting ibm_db2.binmode=2 in php.ini. - * - * Passing DB2_PASSTHRU specifies that - * binary data will be converted to NULL. This is the - * equivalent of setting ibm_db2.binmode=3 - * in php.ini. - * - * Passing DB2_CASE_LOWER specifies that - * column names of the result set are returned in lower case. - * - * Passing DB2_CASE_UPPER specifies that - * column names of the result set are returned in upper case. - * - * Passing DB2_CASE_NATURAL specifies that - * column names of the result set are returned in natural - * case. - * - * Passing DB2_DEFERRED_PREPARE_ON turns deferred - * prepare on for the specified statement resource. - * - * Passing DB2_DEFERRED_PREPARE_OFF turns deferred - * prepare off for the specified statement resource. - * - * The following new i5/OS options are available in ibm_db2 version 1.5.1 - * and later. These options apply only when running PHP and ibm_db2 natively on i5 systems. - * - * - * i5_fetch_only - * - * - * DB2_I5_FETCH_ON - Cursors are read-only - * and cannot be used for positioned updates or deletes. This - * is the default unless SQL_ATTR_FOR_FETCH_ONLY - * environment has been set to SQL_FALSE. - * - * - * DB2_I5_FETCH_OFF - Cursors can be used - * for positioned updates and deletes. - * - * - * - * - * - * DB2_I5_FETCH_ON - Cursors are read-only - * and cannot be used for positioned updates or deletes. This - * is the default unless SQL_ATTR_FOR_FETCH_ONLY - * environment has been set to SQL_FALSE. - * - * DB2_I5_FETCH_OFF - Cursors can be used - * for positioned updates and deletes. - * - * The following new option is available in ibm_db2 version 1.8.0 and later. - * - * - * rowcount - * - * - * DB2_ROWCOUNT_PREFETCH_ON - Client can request - * the full row count prior to fetching, which means that - * db2_num_rows returns the number of rows selected - * even when a ROLLFORWARD_ONLY cursor is used. - * - * - * DB2_ROWCOUNT_PREFETCH_OFF - Client cannot request - * the full row count prior to fetching. - * - * - * - * - * - * DB2_ROWCOUNT_PREFETCH_ON - Client can request - * the full row count prior to fetching, which means that - * db2_num_rows returns the number of rows selected - * even when a ROLLFORWARD_ONLY cursor is used. - * - * DB2_ROWCOUNT_PREFETCH_OFF - Client cannot request - * the full row count prior to fetching. - * - * The following new options are available in ibm_db2 version 1.7.0 and later. - * - * - * trusted_user - * - * - * To switch the user to a trusted user, pass the User ID (String) - * of the trusted user as the value of this key. This option can - * be set on a connection resource only. To use this option, trusted - * context must be enabled on the connection resource. - * - * - * - * - * trusted_password - * - * - * The password (String) that corresponds to the user specified - * by the trusted_user key. - * - * - * - * - * - * To switch the user to a trusted user, pass the User ID (String) - * of the trusted user as the value of this key. This option can - * be set on a connection resource only. To use this option, trusted - * context must be enabled on the connection resource. - * - * The password (String) that corresponds to the user specified - * by the trusted_user key. - * - * The following new options are available in ibm_db2 version 1.6.0 and later. - * These options provide useful tracking information that can be accessed during - * execution with db2_get_option. - * - * - * When the value in each option is being set, some servers might not handle - * the entire length provided and might truncate the value. - * - * - * To ensure that the data specified in each option is converted correctly - * when transmitted to a host system, use only the characters A through Z, - * 0 through 9, and the underscore (_) or period (.). - * - * - * - * - * userid - * - * - * SQL_ATTR_INFO_USERID - A pointer to a null-terminated - * character string used to identify the client user ID sent to the host - * database server when using DB2 Connect. - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 16 characters. - * This user-id is not to be confused with the authentication user-id, it is for - * identification purposes only and is not used for any authorization. - * - * - * - * - * - * - * acctstr - * - * - * SQL_ATTR_INFO_ACCTSTR - A pointer to a null-terminated - * character string used to identify the client accounting string sent to the - * host database server when using DB2 Connect. - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 200 characters. - * - * - * - * - * - * - * applname - * - * - * SQL_ATTR_INFO_APPLNAME - A pointer to a null-terminated - * character string used to identify the client application name sent to the - * host database server when using DB2 Connect. - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 32 characters. - * - * - * - * - * - * - * wrkstnname - * - * - * SQL_ATTR_INFO_WRKSTNNAME - A pointer to a null-terminated - * character string used to identify the client workstation name sent to the - * host database server when using DB2 Connect. - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 18 characters. - * - * - * - * - * - * - * - * When the value in each option is being set, some servers might not handle - * the entire length provided and might truncate the value. - * - * To ensure that the data specified in each option is converted correctly - * when transmitted to a host system, use only the characters A through Z, - * 0 through 9, and the underscore (_) or period (.). - * - * SQL_ATTR_INFO_USERID - A pointer to a null-terminated - * character string used to identify the client user ID sent to the host - * database server when using DB2 Connect. - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 16 characters. - * This user-id is not to be confused with the authentication user-id, it is for - * identification purposes only and is not used for any authorization. - * - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 16 characters. - * This user-id is not to be confused with the authentication user-id, it is for - * identification purposes only and is not used for any authorization. - * - * SQL_ATTR_INFO_ACCTSTR - A pointer to a null-terminated - * character string used to identify the client accounting string sent to the - * host database server when using DB2 Connect. - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 200 characters. - * - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 200 characters. - * - * SQL_ATTR_INFO_APPLNAME - A pointer to a null-terminated - * character string used to identify the client application name sent to the - * host database server when using DB2 Connect. - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 32 characters. - * - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 32 characters. - * - * SQL_ATTR_INFO_WRKSTNNAME - A pointer to a null-terminated - * character string used to identify the client workstation name sent to the - * host database server when using DB2 Connect. - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 18 characters. - * - * - * - * DB2 for z/OS and OS/390 servers support up to a length of 18 characters. - * @param int $type Passing DB2_AUTOCOMMIT_ON turns - * autocommit on for the specified connection resource. - * - * Passing DB2_AUTOCOMMIT_OFF turns - * autocommit off for the specified connection resource. - * @throws IbmDb2Exception - * - */ -function db2_set_option($resource, array $options, int $type): void -{ - error_clear_last(); - $result = \db2_set_option($resource, $options, $type); - if ($result === false) { - throw IbmDb2Exception::createFromPhpError(); - } -} |