VRP-Mtm_PI-ManualTecnico-Ncr
Anuncio
ECOPETROL S.A.
FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM
Fecha : 19 de Agosto 2009
MANUAL TÉCNICO
MONITOR NCR REESTABLECIDO MIGRACION PI
Página 1 de 8
MANUAL TÉCNICO
MONITOR NCR REESTABLECIDO
RELACIÓN DE VERSIONES
VERSIÓN
DESCRIPCIÓN
FECHA
1
(Versión inicial) No se recibió.
2
Se actualiza la aplicación para poner en
fucnionamiento después de la implementación
de alta disponibildad del servidor PI después
de la Migración.
19 Agosto de 2009
DEPENDENCIA RESPONSABLE
REVISÓ
APROBÓ
ELABORÓ:
Jorge Mario Gamez Cuadrado
Proyecto Fábrica de Software
Downstream
Víctor H. González
Líder Técnico Proyecto GRB
del
UT DOWNSTREAM
Jose Emilio Landinez
Líder
Técnico
GRB
ECOPETROL
–
ECOPETROL S.A.
FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM
Fecha : 19 de Agosto 2009
MANUAL TÉCNICO
MONITOR NCR REESTABLECIDO MIGRACION PI
Página 2 de 8
TABLA DE CONTENIDO
Contenido
1. Introducción ............................................................................................................................. 3
2. Objetivo ................................................................................................................................... 3
3. Alcance .................................................................................................................................... 3
4. Descripción del Proceso Actual ............................................................................................... 3
5. Descripción de la Solución ...................................................................................................... 4
5.1.
Configuración archivo .ini .................................................................................................... 4
5.2.
Módulos de la aplicación ..................................................................................................... 5
5.2.1.
Módulo ConsultasPI (ConsultasPI.bas) ............................................................................ 5
5.2.2.
Módulo Inicial (Inicial.bas) ................................................................................................. 5
5.2.3.
Módulo Mod_Log (Log.bas) .............................................................................................. 5
5.2.4.
Módulo Mod_PiApi (piapi32.bas) ...................................................................................... 5
5.3.
Formas de la aplicación ...................................................................................................... 6
5.4.
Mejoras a la Aplicacion ....................................................................................................... 6
ECOPETROL S.A.
FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM
Fecha : 19 de Agosto 2009
MANUAL TÉCNICO
MONITOR NCR REESTABLECIDO MIGRACION PI
Página 3 de 8
1. Introducción
El monitor NCR Reestablecido es una aplicación VB que realiza la revisón de cuando los
eventos de violaciones generadas a Pv’s numéricas (durante el monitoreo de los demás
monitores), se reestablecen, Entiéndase por restablecer el echo que la variable salga del área
en la cual generó la violación, es decir, si la violación es un Incidente alto, cualquier valor que
sea menor que la Ventana Operativa Alta servirá como reestablecido, sin importar que dicho
valor genere otra violación.
2. Objetivo
El presente documento pretende ilustrar las especificaciones técnicas generales que se aplican
para el correcto funcionamiento del Monitor.
3. Alcance
Este documento contiene una descripción técnica que permite asegurar la correcta
configuración de los diferentes componentes requeridos para la ejecución del monitor, así
como, una descripción técnica del comportamiento del mismo.
El presente documento no está completo ya que no fue proporcionado el manual técnico inicial,
por lo cual, este documento solo hace referencia a cada uno de los diferentes componentes del
aplicativo, pero si se hace énfasis en explicar detalladamente los nuevos componentes
adicionados al mismo.
4. Descripción del Proceso Actual
El monitor una vez se dispara, genera un listado de las violaciones de tipo “EVENTO
VIOLACION”, y que además no tengan fecha de reestablecido, este listado de tags tiene entre
otras columnas, las Guías de Control, Las Ventanas Operativas, el estado, el tipo y su
respectivo tag PI, para cada uno de estos tags realiza un barrido para determinar si se detecta
un valor que esté por fuera del rango donde se generó dicha violación, si se encuentra dicho
valor, se actualiza en RIS el evento cambiando el estado, la fecha de reestablecido, el valor
que reestablece y el eventend_dt de dicho evento.
ECOPETROL S.A.
FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM
Fecha : 19 de Agosto 2009
MANUAL TÉCNICO
MONITOR NCR REESTABLECIDO MIGRACION PI
Página 4 de 8
5. Descripción de la Solución
5.1. Configuración archivo .ini
Con el fin de parametrizar las variables de configuración del monitor se creo el archivo
NCR_REEST.ini, el cual contiene entre otros los datos de conexiones a la base de datos
RIS y al sistema PI de la siguiente manera:
[IDENTIFICACION]
nombre=monitor Ncr-Reestablecidos
[CONEXION]
Provider= Proveedor de la aplicacion Oracle (MSDAORA.1)
UserOracle= Usuario de la Base de Datos RIS (rdbmx_site)
PswOracle= Clave encriptada del usuario RIS
Source= Fuente de la Base de Datos (RIS4)
Usuario= Usuario del sistema PI (Interface)
Password= Clave encriptada del usuario PI
ServerPI= Sevidor del sistema PI (BJAESBPITRP)
Periodo= Meses de consulta de las violaciones que no tengan fecha de reestablecido. Si es
vacio aplica la consulta por fecha inicial y final.
Fecha_Ini = Fecha inicial de consulta de las violaciones no reestablecidas.
Fecha_Fin = Fecha final de consulta de las violaciones no reestablecidas.
IdtagIO= PointId del tag PI utilizado para hacer seguimiento al monitor (32960)
ECOPETROL S.A.
FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM
Fecha : 19 de Agosto 2009
MANUAL TÉCNICO
MONITOR NCR REESTABLECIDO MIGRACION PI
Página 5 de 8
5.2. Módulos de la aplicación
A continuación se describen los módulos que son utilizados dentro del Monitor.
5.2.1.
-
5.2.2.
Módulo ConsultasPI (ConsultasPI.bas)
Función PrimerEventoViola; Utilizada para determinar el primer evento que
cumple con una expresión dada.
Función EscribirPI; Utilizada para escribir datos al archive de PI.
Módulo Inicial (Inicial.bas)
-
Procedimiento Main; se encarga de realizar las conexiones a la Base de Datos y
de armar y ejecutar la consulta que obtiene el listado de eventos que se
encuentran sin restablecer, obtiene los límites de control para la corrida de cada
evento y arranca el proceso llamando al procedimiento validar_criterio.
-
Función NCR_Imprimir; Realiza la actualización del evento Violación en RIS,
actualiza el estado, la fecha de reestablecido, el valor de reestablecido y el
eventend_dt.
-
Procedimiento validar_criterio; procedimiento central de la aplicación, es quien
tiene la lógica que se aplica en el monitoreo. Arma la expresión teniendo en
cuenta el tipo y orientación de la violación, y la valida contra PI, buscando si esta
expresión se cumple (llamando a la función PrimerEventoViola), si la expreión
se cumple para el rango de fechas pasado, actualiza el evento de violación en
RIS llamando la función Imprimir_NCR. Este mismo algoritmo lo aplica de
nuevo para la zona entre la Guía de control baja y la Ventna Operativa Baja.
-
Función convertirfecha; Convierte una fecha recibida en otra de formato
“dd/mm/yyyy hh24:mi:ss”.
5.2.3.
-
5.2.4.
Módulo Mod_Log (Log.bas)
Función EscribirLog; Utilizado para escribir una línea en el archivo log.
Módulo Mod_PiApi (piapi32.bas)
Módulo con las funciones API para interactuar con elservidor PI.
ECOPETROL S.A.
FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM
Fecha : 19 de Agosto 2009
MANUAL TÉCNICO
MONITOR NCR REESTABLECIDO MIGRACION PI
Página 6 de 8
5.3. Formas de la aplicación
Esta aplicación no utiliza ninguna forma ya que se creó para ser ejecutado como una tarea
programada de Windows.
5.4. Mejoras a la Aplicacion
Las mejoras a la aplicación se describen a continuación:
-
Se incorporó un archivo NCR_REEST.INI para incluir los parámetros de
conexión a la base de datos RIS y al sistema PI, el tag de monitoreo en PI
(IO_NCR_Reestablecido) y el periodo de consulta en meses de los eventos de
tipo violación en RIS.
-
La conexión al sistema PI se realiza por medio del usuario “Interface” con la
clave encriptada en el archivo NCR_REEST.INI, para esto se agregó el modulo
MOD_ENCRIPTAR.BAS
-
Se actualizo la consulta de acuerdo a la nueva versión de la base de datos RIS y
con la opción para filtrar las violaciones entre 2 fechas o un periodo de tiempo
que se determine.
select e.event_id, e.event_tp, e.event_dt FechaGenera,e.eventend_dt FechaReest, lr.resource_id,
lr.resource_tp, rdbmx.resource_pkg.get_resource_nm(e.event_id, e.event_tp) evento
, rdbmx.resource_pkg.get_resource_nm(lr.resource_id, lr.resource_tp) TagRis
, rn.systemresource_nm alias
, rdbmx.reference_pkg.RSRC_CASE_CRIT_REC_Value_ch(e.event_id, e.event_tp,null,30056,'CASO OPERATIVO',null
, null,'No Aplica','Corrida Actual','No Aplica','No Aplica','Instante','Puntual', null, null,null,null)
Corrida
, rdbmx.reference_pkg.RSRC_CASE_CRIT_REC_Value_ch(e.event_id, e.event_tp,null,30056,'CASO OPERATIVO',null
, null,'No Aplica','Descripción automatica','No Aplica','No Aplica','Instante','Puntual', null, null,null
,null) Descripcion
, rdbmx.reference_pkg.RSRC_CASE_CRIT_REC_Value_ch(e.event_id, e.event_tp,null,30056,'CASO OPERATIVO',null
,null,'No Aplica','Valor Reestablece','No Aplica','No Aplica','Instante','Puntual', null, null,null,null)
valorreest
, rdbmx.reference_pkg.RSRC_CASE_CRIT_REC_Value_ch(e.event_id, e.event_tp,null,30056,'CASO OPERATIVO',null
,null,'No Aplica','Tipo','No Aplica','No Aplica','Instante','Puntual', null, null,null,null)
TipoViolacion
, rdbmx.reference_pkg.RSRC_CASE_CRIT_REC_Value_ch(e.event_id, e.event_tp,null,30056,'CASO OPERATIVO',null
,null,'No Aplica','Orientacion','No Aplica','No Aplica','Instante','Puntual', null, null,null,null)
Orientacion
, rdbmx.reference_pkg.RSRC_CASE_CRIT_REC_Value_ch(e.event_id, e.event_tp,null,30056,'CASO OPERATIVO',null
,null,'No Aplica','Estado','No Aplica','No Aplica','Instante','Puntual', null, null,null,null) Estado
, rdbmx.reference_pkg.RSRC_CASE_CRIT_REC_Value_ch(e.event_id, e.event_tp,null,30056,'CASO OPERATIVO',null
,null,'No Aplica','Documentado Por','No Aplica','No Aplica','Instante','Puntual', null, null,null,null)
Documentado
, rdbmx.reference_pkg.RSRC_CASE_CRIT_REC_Value_ch(e.event_id, e.event_tp,null,30056,'CASO OPERATIVO',null
,null,'No Aplica','Informe Operador','No Aplica','No Aplica','Instante','Puntual', null, null,null,null)
Informe
ECOPETROL S.A.
FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM
Fecha : 19 de Agosto 2009
MANUAL TÉCNICO
MONITOR NCR REESTABLECIDO MIGRACION PI
Página 7 de 8
, rdbmx.reference_pkg.RSRC_CASE_CRIT_REC_Value_Fl(lr.Resource_id,lr.Resource_tp,null,30056,'CASO
OPERATIVO',null,null,'No Aplica','No Aplica','Guía','No Aplica','Instante','Máximo', null, null,null
,null) GCH
, rdbmx.reference_pkg.RSRC_CASE_CRIT_REC_Value_Fl(lr.Resource_id,lr.Resource_tp,null,30056,'CASO
OPERATIVO',null,null,'No Aplica','No Aplica','Guía','No Aplica','Instante','Mínimo', null, null,null
,null) GCL
, rdbmx.reference_pkg.RSRC_CASE_CRIT_REC_Value_Fl(lr.Resource_id,lr.Resource_tp,null,30056,'CASO
OPERATIVO',null,null,'No Aplica','No Aplica','Ventana','No Aplica','Instante','Máximo', null, null,null
,null) VOH
, rdbmx.reference_pkg.RSRC_CASE_CRIT_REC_Value_Fl(lr.Resource_id,lr.Resource_tp,null,30056,'CASO
OPERATIVO',null,null,'No Aplica','No Aplica','Ventana','No Aplica','Instante','Mínimo', null, null,null
,null) VOL
from rdbmx.list_vt l, rdbmx.list_rsrc_vt lr, rdbmx.resource_namesystem_vn rn ,rdbmx.attachitem_vt
at,rdbmx.attachitem_vt at1,rdbmx.resource_event_vt re, rdbmx.event_vt e
where l.list_tp = 'LISTASNC' and lr.list_id = l.list_id and lr.list_tp = l.list_tp
and lr.resource_tp = 'VP NUMERICA'
and rdbmx.resource_pkg.GET_RESOURCE_NM(lr.resource_id, lr.resource_tp) not like '%Escenario'
and rn.resource_id(+) = lr.resource_id and rn.resource_tp(+) = lr.resource_tp
and rn.resourcenamesystem_nm(+) = 'PIGCB' and rn.resourcenamesystem_tp(+) = 'SISTEMA PI'
and at.attachitem_id(+) = l.list_id and at.attachitem_tp(+) = l.list_tp and at.attachment_tp(+) = 'Tiene
Listas NC'
and at1.attachitem_id = at.locationitem_id and at1.attachitem_tp = at.locationitem_tp
and at1.attachment_tp = 'Tiene Puestos de Trabajo'
and re.resource_id = lr.resource_id and re.resource_tp = lr.resource_tp
and re.resourceevent_tp = 'EVENTO VIOLACION'
and e.event_id = re.resourceevent_id and e.event_tp = re.resourceevent_tp
and e.event_dt >= add_months(trunc(sysdate,'mm'),-30) and e.event_dt <= sysdate
and eventend_dt = TO_DATE('01/01/2990', 'DD/Mm/YYYY')
-
El monitor actualiza en RIS los criterios: Valor Reestablece, Estado, Fecha
Cierre Doc y Fecha Reestablece, estos cambios se pueden verificar en el
archivo aammdd.log y con las siguientes consultas:
select rr.resource_id, rr.resource_nm, rr.resource_tp, rr.criteria_nm,
rr.property_nm, rr.value_ch
from rdbmx.rsrc_case_qpmcsi_vn rr
where rr.resource_id = 14287405
select e.event_id, e.event_tp, e.event_dt FechaGenera,e.eventend_dt FechaReest
from rdbmx.event_vt e
where e.event_id = 14287405
ECOPETROL S.A.
FABRICA DE SOFTWARE DEL DOWNSTREAM
UT DOWNSTREAM
Fecha : 19 de Agosto 2009
MANUAL TÉCNICO
MONITOR NCR REESTABLECIDO MIGRACION PI
Página 8 de 8
Para mayor información sobre este documento dirigirse a quien lo elaboró, en nombre de la dependencia responsable:
Jorge Mario Gamez Cuadrado
Profesional Junior
Tel: 4 8676
Proyecto Fábrica de Software del Downstream
DEPENDENCIA
RESPONSABLE
REVISÖ
Dirección de Tecnología de la Información
VICTOR H GONZALEZ
Líder Técnico Proyecto GRB UT - Mantenimiento SIV
APROBÓ
JOSE EMILIO LANDINEZ
Líder Técnico Proyecto GRB - ECOPETROL