Centro Empresarial “Site Center”

Calle E # 50, Santa Lucia Alta, Cumbayá

Quito – Ecuador
+ 593 2 380 2920

COBIS VISUAL BATCH

Configuracion de Sps
Versión 1.0.0

© Cobiscorp CONFIDENCIAL i
Configuración para la Ejecución de SP Cobiscorp
Visual Batch Versión

Información del Documento

Título: Configuración para la Ejecución de SP

Archivo: 597221458.doc
Versión: 1.0.3
Autor: Sandro Soto
Estado: Entregable

Historia de Cambios

Versión Fecha Autor Descripción

1.0.0 2016-09-21 SSO Emisión inicial
1.0.1 2011-07-20 SSO Ajustes para Unix
1.0.2 2001-07-28 SSO Ejecución de SPs remotos
1.0.3 2016-05-10 WBA Actualización Manual según alcance RFC

© 2009 Cobiscorp
TODOS LOS DERECHOS RESERVADOS

Queda reservado el derecho de propiedad de este documento, con la facultad de disponer de él, publicarlo, traducirlo
o autorizar su traducción, así como reproducirlo total o parcialmente, por cualquier sistema o medio.

No se permite la reproducción total o parcial de este documento, ni su incorporación a un sistema informático, ni su

locación, ni su transmisión en cualquier forma o por cualquier medio, sea éste escrito o electrónico, mecánico, por
fotocopia, por grabación u otros métodos, sin el permiso previo y escrito de los titulares de los derechos y del
copyright.

FOTOCOPIAR ES DELITO.

Cobiscorp, COBIS™ y Cooperative Open Banking Information System son marcas registradas de Cobiscorp

Otros nombres de compañías y productos mencionados en este documento, pueden ser marcas comerciales o
marcas registradas por sus respectivos dueños.

© Cobiscorp CONFIDENCIAL ii
Configuración para la Ejecución de SP Cobiscorp
Visual Batch Versión

TABLA DE CONTENIDO

1. INTRODUCCIÓN 1-1
2. PRE REQUISITOS 2-1
3. CONFIGURACION 3-1
2.1 A NIVEL DE SERVIDOR 3-1
2.2 A NIVEL DE MÓDULOS COBIS 3-2
2.3 Pruebas de Ejecución 3-3

Lista de Figuras
FIGURA 1: CONFIGURACIÓN DEL PROGRAMA DE TIPO SP.........................................................3-2
FIGURA 2: DEFINICIÓN DE PARÁMETROS DEL PROGRAMA SP...................................................3-3
FIGURA 4: CREACIÓN DE LOS SCRIPTS DE EJECUCIÓN DE LOS SP EN WINDOWS......................3-3
FIGURA 5: CREACIÓN DE LOS SCRIPTS DE EJECUCIÓN DE LOS SP EN UNIX..............................3-4
Figura 6: Script de Ejecución del SP...................................................................................3-4

Lista de Tablas
No table of figures entries found.

© Cobiscorp CONFIDENCIAL iii

 Configuración para la Ejecución de SPs Cobiscorp
Visual Batch Versión 1.0.0

1. INTRODUCCIÓN

Como una extensión a la ejecución de programas batch, se ha considerado oportuno y

necesario realizar la ejecución de programas de tipo Stored Procedure para que realicen un
procesamiento directo en la base de datos; esto a partir del uso de la herramienta Cobis
Visual Batch.

Para el efecto será necesario contar con varios requisitos a nivel de aplicativos y sobre todo
realizar un proceso de modificación en el caso que se vaya a reemplazar los programas de
tipo SQR por SP, o en su defecto para los nuevos programas tener en cuenta algunos
aspectos.

2. PRE REQUISITOS

Para realizar la configuración detallada en este manual se requiere:

 Conocimientos básicos de COBIS ADMIN seguridades.

 Conocimientos básicos de Lenguaje Transact-sql

 Conocimientos básicos de Programación en base de datos

3. CONFIGURACION
Este proceso de configuración está contemplado para ambientes que tienen como
plataforma central el sistema operativo Windows Server o Unix

1.1 A NIVEL DE SERVIDOR

Verificar que exista el item en el catálogo “Lenguajes de Programacion” (ba_lenguaje) con el

código “SP” y el valor “Stored Procedure”.

select * from cobis..cl_tabla ct, cobis..cl_catalogo cc where cc.tabla = ct.codigo and ct.tabla
= 'ba_lenguaje' and cc.codigo = 'SP'

Si no existe, significa que existió un error en la actualización de Visual Batch (manual UPG-
LA-04 Plan detallado de actualización Visual Batch.docx)

Ambientes UNIX

1. Contar con la versión de fullbatch liberada por el Centro de Soporte Cobis, con
soporte para ejecución de SP, ubicado en el directorio de instalación “shells” del
Visual Batch.

Ambientes Windows:

© Cobiscorp CONFIDENCIAL 1
Configuración para la Ejecución de SP Cobiscorp
Visual Batch Versión

1. Se debe contar con la última versión del programa exebatch.exe liberado por el
Centro de Soporte Cobis. Este programa debe copiarse en el directorio /kernel/bin,
con previo respaldo de la versión anterior.

2. En el mismo directorio, configurar en el archivo s_app.ini el siguiente parámetro

dentro de la sección [VBATCH-WIN]:

TIPO_BASE=SQL2005  En el caso de SQL Server 2005

SYBASE  En el caso de SYBASE 12.5.x o superior
PARAMETRO=N En caso de utilizar Stored Procedures de envoltura1
S En caso de ejecutar un Stored Procedure común

1.2 A NIVEL DE MÓDULOS COBIS

Cada módulo Cobis que deba ejecutar programas batch del tipo SP deberá tomar en cuenta
las siguientes consideraciones:

1. Realizar la siguiente configuración en el programa batch, tal como se muestra en la

siguiente pantalla de ejemplo:
2.

Figura 1: Configuración del Programa de Tipo SP

Dónde:

 Lenguaje: Corresponderá al tipo de Programa, en este caso “SP”;

 Path Ejecución: Será el directorio en donde se creará el script temporal para
ejecutar el SP. En Unix se generarán dentro del outdir.
 Archivo Fuente: Corresponderá al nombre lógico del Stored Procedure,
anteponiendo la base de datos con dos puntos, ejemplo:
cobis..sp_prueba_sp

1
Se conoce como SP de envoltura a un SP que contiene al interior stored procedures del kernel COBIS, solo existen en
ambientes Windows y de versiones SQL Server 2008 en adelante. Residen en el directorio CLR.

© Cobiscorp CONFIDENCIAL 2
Configuración para la Ejecución de SP Cobiscorp
Visual Batch Versión

3. Definir los Parámetros de Ejecución del SP. A menos que se utilice un SP de

envoltura, todos los parámetros serán de tipo Char para que internamente en el SP
sean convertidos por al tipo requerido. Si no es el caso, se utilizaran los tipos de
datos correspondientes a:

C: Char, para parámetros con tipos de datos Char o Varchar.

D: Date, para parámetros con tipos de datos Datetime
I: Integer, para parámetros con tipos de datos Tinyint, Smallint o Integer
M: Money, para parámetros con tipos de datos Money o Float.

Figura 2: Definición de Parámetros del Programa SP

4. A continuación se debe crear el lote donde se añadirá el programa de tipo SP, para
luego autorizar su ejecución y aprobar los parámetros del mismo.

1.3 PRUEBAS DE EJECUCIÓN

Realizada esta configuración se deberán realizar las pruebas para garantizar la ejecución
del programa de tipo SP. Para validar la ejecución se puede observar que en el directorio
definido /cobis/cobis/VBatch/outdir se crearán automáticamente archivo .outs. La ejecución
de este script se realizará por medio del aplicativo s_app.

Si solo se crea un archivo .out el proceso seguramente se ejecutó exitosamente, para

confirmarlo se debe visualizar el contenido del archivo .out.

© Cobiscorp CONFIDENCIAL 3
Configuración para la Ejecución de SP Cobiscorp
Visual Batch Versión

Figura 3: Creación de los Scripts de Ejecución de los SP en UNIX.

SI por el contrario se produce algún error, en la misma ruta se generarán archivos

“sp_exec….out” además del archivo de ejecución. Ejemplo:

Figura 4: Creación de los Scripts de Ejecución de los SP en Unix.

Además cuando hay algún error, se crea un archivo adicional de ejecución del
procedimiento almacenado en la ruta /cobis/cobis/vbatch/sql .Si se procede a abrir uno de
estos archivos se podrá evidenciar los datos de ejecución:

Figura 5: Script de Ejecución del SP.

© Cobiscorp CONFIDENCIAL 4
Configuración para la Ejecución de SP Cobiscorp
Visual Batch Versión

Nota Importante:

La ejecución de este script generará un archivo de salida que el programa ejecutor

(execbatch en Windows o fullbatch en Unix) va a evaluar para determinar el status de fin de
ejecución. Por lo tanto es requerido que los stored procedures hagan un control estricto del
error (con return > 0) para que este sea devuelto y correctamente interpretado.

© Cobiscorp CONFIDENCIAL 5