php8.5
Home/ Manual/ ibm_db2 / functions/ db2_procedure_columns

db2_procedure_columns

PHP function Edit on GitHub ✎

(PECL ibm_db2 >= 1.0.0)

Returns a result set listing stored procedure parameters

Description

db2_procedure_columns(resource $connection, string|null $qualifier, string $schema, string $procedure, string|null $parameter): resource

Returns a result set listing the parameters for one or more stored procedures.

Parameters

connection

A valid connection to an IBM DB2, Cloudscape, or Apache Derby database.

qualifier

A qualifier for DB2 databases running on OS/390 or z/OS servers. For other databases, pass null or an empty string.

schema

The schema which contains the procedures. This parameter accepts a search pattern containing _ and % as wildcards.

procedure

The name of the procedure. This parameter accepts a search pattern containing _ and % as wildcards.

parameter

The name of the parameter. This parameter accepts a search pattern containing _ and % as wildcards. If this parameter is null, all parameters for the specified stored procedures are returned.

Return Values

Returns a statement resource with a result set containing rows describing the parameters for the stored procedures matching the specified parameters. The rows are composed of the following columns:

Column nameDescription
Return valueParameter type
PROCEDURE_CATThe catalog that contains the procedure. The value is null if this table does not have catalogs.
PROCEDURE_SCHEMName of the schema that contains the stored procedure.
PROCEDURE_NAMEName of the procedure.
COLUMN_NAMEName of the parameter.
COLUMN_TYPEAn integer value representing the type of the parameter: Return valueParameter type1 (SQL_PARAM_INPUT)Input (IN) parameter.2 (SQL_PARAM_INPUT_OUTPUT)Input/output (INOUT) parameter.3 (SQL_PARAM_OUTPUT)Output (OUT) parameter.
1 (SQL_PARAM_INPUT)Input (IN) parameter.
2 (SQL_PARAM_INPUT_OUTPUT)Input/output (INOUT) parameter.
3 (SQL_PARAM_OUTPUT)Output (OUT) parameter.
DATA_TYPEThe SQL data type for the parameter represented as an integer value.
TYPE_NAMEA string representing the data type for the parameter.
COLUMN_SIZEAn integer value representing the size of the parameter.
BUFFER_LENGTHMaximum number of bytes necessary to store data for this parameter.
DECIMAL_DIGITSThe scale of the parameter, or null where scale is not applicable.
NUM_PREC_RADIXAn integer value of either 10 (representing an exact numeric data type), 2 (representing an approximate numeric data type), or null (representing a data type for which radix is not applicable).
NULLABLEAn integer value representing whether the parameter is nullable or not.
REMARKSDescription of the parameter.
COLUMN_DEFDefault value for the parameter.
SQL_DATA_TYPEAn integer value representing the size of the parameter.
SQL_DATETIME_SUBReturns an integer value representing a datetime subtype code, or null for SQL data types to which this does not apply.
CHAR_OCTET_LENGTHMaximum length in octets for a character data type parameter, which matches COLUMN_SIZE for single-byte character set data, or null for non-character data types.
ORDINAL_POSITIONThe 1-indexed position of the parameter in the CALL statement.
IS_NULLABLEA string value where 'YES' means that the parameter accepts or returns null values and 'NO' means that the parameter does not accept or return null values.

See Also

Source: reference/ibm_db2/functions/db2-procedure-columns.xml · from the official PHP manual (php/doc-en)