Interfaz DB2Statement

La interfaz com.ibm.db2.jcc.DB2Statement amplía la interfaz java.sql.Statement.

DB2Statement implementa la interfaz java.sql.Wrapper.

Métodos DB2Statement

Los siguientes métodos se definen únicamente para el IBM® Data Server Driver for JDBC and SQLJ.

getAffectedRowCount
Formato:
public int getAffectedRowCount()
  throws java.sql.SQLException

Devuelve el número de filas que estén afectadas por la correcta ejecución de una sentencia de SQL. Si la sentencia de SQL es INSERT, UPDATE o DELETE, getAffectedRowCount devuelve el mismo valor devuelto por java.sql.Statement.getUpdateCount.

El valor devuelto por getAffectedRowCount es la misma información devuelta por el servidor de datos en la SQLCA tras la correcta ejecución de una sentencia de SQL.

getDB2ClientProgramId
Formato:
public String getDB2ClientProgramId()
  throws java.sql.SQLException

Devuelve el identificador del programa cliente definido por el usuario correspondiente a la conexión, que está almacenado en la fuente de datos.

getDB2ClientProgramId no se aplica a los servidores de datos de los sistemas Db2 en Linux®, UNIX y Windows.

setDB2ClientProgramId
Formato:
public abstract void setDB2ClientProgramId(String program-ID) 
  throws java.sql.SQLException

Establece un identificador de programa definido por el usuario correspondiente a la conexión en un servidor de datos. Dicho identificador de programa es una serie de 80 bytes que se utiliza para identificar al llamador.

setDB2ClientProgramId no se aplica a los servidores de datos de los sistemas Db2 en Linux, UNIX y Windows.

El Db2 for z/OS® servidor coloca la cadena en los registros de seguimiento IFCID 316 junto con otras estadísticas, para que pueda identificar qué programa está asociado con una instrucción SQL concreta.

getIDSBigSerial
Formato:
public int getIDSBigSerial() 
  throws java.sql.SQLException

Recupera una clave que se ha generado automáticamente en la columna BIGSERIAL después de que una sentencia INSERT ejecutada anteriormente haya insertado la clave generada automáticamente.

Se deben cumplir las condiciones siguientes para que getIDSBigSerial se ejecute satisfactoriamente:
  • La sentencia INSERT es la última sentencia de SQL que se ha ejecutado antes de invocar este método.
  • La tabla en la que se inserta la fila contiene una columna BIGSERIAL.
  • El formato del método Connection.prepareStatement o Statement.executeUpdate de JDBC por el que se prepara o ejecuta la sentencia INSERT no tiene parámetros que solicitan claves de generación automática.

Este método solo se aplica a las conexiones con IBM Informix® bases de datos.

getIDSSerial
Formato:
public int getIDSSerial() 
  throws java.sql.SQLException

Recupera una clave que se ha generado automáticamente en la columna SERIAL después de que una sentencia INSERT ejecutada anteriormente haya insertado la clave generada automáticamente.

Se deben cumplir las condiciones siguientes para que getIDSSerial se ejecute satisfactoriamente:
  • La sentencia INSERT es la última sentencia de SQL que se ha ejecutado antes de invocar este método.
  • La tabla en la que se inserta la fila contiene una columna SERIAL.
  • El formato del método Connection.prepareStatement o Statement.executeUpdate de JDBC por el que se prepara o ejecuta la sentencia INSERT no tiene parámetros que solicitan claves de generación automática.

Este método solo se aplica a las conexiones con IBM Informix bases de datos.

getIDSSerial8
Formato:
public long getIDSSerial8() 
  throws java.sql.SQLException

Recupera una clave que se ha generado automáticamente en la columna SERIAL8 después de que una sentencia INSERT ejecutada anteriormente haya insertado la clave generada automáticamente.

Se deben cumplir las condiciones siguientes para que getIDSSerial8 se ejecute satisfactoriamente:
  • La sentencia INSERT es la última sentencia de SQL que se ha ejecutado antes de invocar este método.
  • La tabla en la que se inserta la fila contiene una columna SERIAL8.
  • El formato del método Connection.prepareStatement o Statement.executeUpdate de JDBC por el que se prepara o ejecuta la sentencia INSERT no tiene parámetros que solicitan claves de generación automática.

Este método solo se aplica a las conexiones con IBM Informix fuentes de datos.

getIDSSQLStatementOffSet
Formato:
public int getIDSSQLStatementOffSet()
  throws java.sql.SQLException

Después de que se ejecute una instrucción SQL en un IBM Informix fuente de datos, si la instrucción tiene un error de sintaxis, getIDSSQLStatementOffSet devuelve el desplazamiento en el texto de la instrucción del error de sintaxis.

getIDSSQLStatementOffSet devuelve:
  • 0, si la sentencia no contiene un error de sintaxis.
  • -1, si el origen de los datos no es IBM Informix.

Este método solo se aplica a las conexiones con IBM Informix fuentes de datos.

setMAXBLKEXT
Formatos:
public void setMAXBLKEXT(int maxblkext) 
  throws SQLException

Especifica el número máximo de bloques adicionales que el cliente DRDA puede recibir del servidor de datos sin más avisos.

Parámetros:
maxblkext
El número de bloques adicionales que se devolverán. Los valores posibles son:
-1
El servidor de datos determina el número máximo de bloques adicionales que el cliente puede recibir. El valor predeterminado es -1.
0
El cliente no recibe bloques adicionales.
n
El número máximo de bloques adicionales que el cliente puede recibir. n es un número entero mayor o igual que 1 y menor o igual que 100.

El valor MAXBLKEXT que se establece a través de este método anula el valor de la propiedad MAXBLKEXT Connection o DataSource .

Esta propiedad solo es aplicable a IBM Data Server Driver for JDBC and SQLJ tipo 4 conectividad a Db2 for z/OS o Db2 en sistemas Linux, UNIX y Windows.