Sentencia THROW

La sentencia THROW genera una excepción de usuario.

SINTAXIS

La palabra clave USER indica el tipo de excepción que se genera. (Actualmente, sólo se da soporte a las excepciones USER, y si omite la palabra clave USER, la excepción toma el valor por omisión de la excepción USER.) Especifique la palabra clave USER, aunque actualmente no tiene ningún efecto, por las siguientes razones:
  • Si futuros releases de intermediario soportan otros tipos de excepción y el tipo de valor por omisión cambia, no tendrá que cambiar su código.
  • Deja claro que esto es una excepción de usuario.

SEVERITY es una cláusula opcional que determina la gravedad asociada a la excepción. La cláusula puede contener cualquier expresión que devuelve un valor entero que no es NULL. Si omite la cláusula, toma el valor por omisión de 1.

CATALOG es una cláusula opcional; si la omite, toma por omisión el valor del catálogo de la versión actual de WebSphere Message Broker. Para utilizar explícitamente el catálogo de mensajes de la versión de WebSphere Message Broker actual, utilice BIPV600 en todos los sistemas operativos.

MESSAGE es una cláusula opcional; si la omite, toma por omisión el número del primer mensaje del bloque de mensajes proporcionado para utilizar sentencias THROW en el catálogo de WebSphere Message Broker (2951). Si especifica un número de mensaje en la sentencia THROW, puede utilizar números de mensajes de 2951 a 2999. De forma alternativa, puede generar su propio catálogo siguiendo las instrucciones en Utilización del registro de sucesos desde una extensión definida por el usuario.

Utilice el campo VALUE opcional para insertar datos en el mensaje. Puede insertar cualquier número de fragmentos de información, pero los mensajes suministrados (2951 - 2999) sólo se ocupan de ocho inserciones.

Ejemplos

Estos son algunos de los ejemplos acerca de cómo puede utilizar una sentencia THROW:
  • THROW USER EXCEPTION; 
  • THROW USER EXCEPTION CATALOG 'BIPv600' MESSAGE 2951 VALUES(1,2,3,4,5,6,7,8) ;
  • THROW USER EXCEPTION CATALOG 'BIPv600' MESSAGE 2951 VALUES('The SQL State: ', 
        SQLSTATE, 'The SQL Code: ', SQLCODE, 'The SQLNATIVEERROR: ', SQLNATIVEERROR, 
        'The SQL Error Text: ', SQLERRORTEXT ) ;
  • THROW USER EXCEPTION CATALOG 'BIPv600' MESSAGE 2951 ;
  • THROW USER EXCEPTION CATALOG 'MyCatalog' MESSAGE 2951 VALUES('Hello World') ;
  • THROW USER EXCEPTION MESSAGE 2951 VALUES('Insert text 1', 'Insert text 2') ;

Para obtener más información acerca de cómo generar una excepción y detalles de SQLSTATE, SQLCODE, SQLNATIVEERROR y SQLERRORTEXT, consulte Funciones de estado de base de datos ESQL.

Conceptos relacionados
Visión general de ESQL
Tareas relacionadas
Desarrollo de ESQL
Generar una excepción
Referencia relacionada
Diagramas de sintaxis: tipos disponibles
Sentencias ESQL
Funciones de estado de base de datos ESQL
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
ak05150_