MacroFiche Report Export to

26
Mfw2txt/pdf el Manual Manual del usuario Version 1.4 Mayo 2006 Copyright Patricio Moracho © 2005,2006 [email protected] 1 de 26 MacroFiche Report Export to MacroFiche Report Export to p d f p d f t x t t x t

Transcript of MacroFiche Report Export to

Page 1: MacroFiche Report Export to

Mfw2txt/pdf el Manual

Manual del usuario

Version 1.4

Mayo 2006

Copyright Patricio Moracho © 2005,[email protected]

1 de 26

MacroFiche Report Export toMacroFiche Report Export to

p d fp d f t x tt x t

Page 2: MacroFiche Report Export to

Mfw2txt/pdf el Manual

Contenido

1 INTRODUCCIÓN...................................................................................................3

1.1 DE QUE SE TRATA......................................................................................................................31.2 MACROFICHE............................................................................................................................31.3 CUAL ES SU UTILIDAD..................................................................................................................31.4 ANTES DE EMPEZAR....................................................................................................................41.5 VERSIONES..............................................................................................................................4

2 USANDO MFW2TXT / PDF.....................................................................................5

2.1 OPCIONES COMUNES...................................................................................................................7

3. FORMAS DE CONVERSIÓN.................................................................................18

3.1 BAJO DEMANDA.......................................................................................................................183.2 EN LOTE..............................................................................................................................20

4. PREGUNTAS FRECUENTES.................................................................................24

2 de 26

Page 3: MacroFiche Report Export to

Mfw2txt/pdf el Manual1 Introducción

1 Introducción

1.1 De que se trata

Mfw2txt o más bien, Macrofiche Report export to Text es un programa de conversión de listados almacenados en Macrofiche COLD o en Synergy Report Manager directamente a archivos del tipo Ascii “plano”. Permite, justamente procesar todos los listados sin necesidad de utilizar las rutinas normales y lentas de exportación que ofrecen estos productos. Mfw2pdf es una herramienta similar pero orientada a la exportación de los mismos reportes pero hacia archivos del tipo Adobe Acrobat PDF, muy útiles para un archivamiento fuera de línea y por largo tiempo. Ambas herramientas han sido desarrolladas en Ansi C para obtener los mejores resultados a nivel performance y portabilidad. En la versión actual, no se suministra ninguna herramienta de administración “visual” o GUI, si bien esto podría asustar a un usuario final, cualquiera con un perfil mas cercano al de un administrador, no tendrá ningún inconveniente en utilizar esta aplicación mediante linea de comandos. El funcionamiento es sumamente sencillo y se suministrarán ejemplos fáciles de seguir.

1.2 Macrofiche

1.3 Cual es su utilidad

Las posibilidades de esta herramienta son las siguientes:

✗ Migración histórica: Claramente si por alguna decisión, se ha discontinuado el uso de Macrofiche, remplazandolo por otro producto, en algún momento se evaluará la posibilidad de migrar los listados antiguos al nuevo sistema. El mecanismo más elemental para hacer esto, es exportar los listados mediante esta herramienta y procesarlos con el nuevo sistema.

✗ Migración bajo demanda: Puede ser interesante bajo ciertas circunstancias, realizar una extracción manual de algunos listados en particular. Por ejemplo, si se tiene la necesidad de implementar un envío de reportes por mail o sencillamente se necesite disponer de una salida abierta para algunos procesos.

✗ Backup histórico: La posibilidad de exportar los reportes en archivos de formato “abierto”, como son los archivos de texto, o mucho mejor, los del tipo PDF, permiten el guardado de la información por largo tiempo, resolviendo el problema de la obsolescencia tecnológica, al menos en cuanto al software.

✗ Distribución electrónica: Aún si Macrofiche se utilizara durante largo tiempo, es posible que sea necesario disponibilizar algunos de los reportes en sucursales remotas, a auditores externos, o simplemente a la gerencia, que necesita trabajar en su hogar. Normalmente esto implicaría la instalación de un licencia de Macrofiche en cada estación de trabajo, junto con el costo asociado de ésta, tenemos el del soporte de la herramienta. El uso de Mfw2pdf, permite reducir estos costos al mínimo, ya que podríamos distribuir aquellos listados necesarios, por mas grandes que fueran, en un CD o algún otro tipo de medio y utilizar el software gratuito Acrobat Reader para la visualización. Asimismo, la información contenida en los PDF es sumamente portable y existen visualizadores para casi todas las principales plataformas (Windows, MAC, Unix, Handhelds, etc).

3 de 26

Page 4: MacroFiche Report Export to

Mfw2txt/pdf el Manual1 Introducción

1.4 Antes de empezar

Antes de empezar a ver el funcionamiento es bueno tener en cuenta algunas cosas

1. El autor de este software no tiene ninguna relación comercial con la compañía que en este momento pudiera estar distribuyendo Macrofiche, simplemente he trabajado mucho tiempo con el producto y por seguir en contacto con los clientes se me planteó la necesidad de desarrollar esta herramienta.

2. Macrofiche COLD es uno de los mejores sistemas COLD del mercado, lamentablemente ha tenido varios cambios comerciales que han despertado la necesidad de migración a otro sistema. Es opinión del autor que esto es una verdadera lástima, sé de las enormes posibilidades que tiene, pero en los últimos años no ha tenido una buena adapatación a los cambios de tecnología, un apropiado soporte ni tampoco políticas comerciales adecuadas por lo que entiendo la necesidad de migración a otros sistemas.

3. Todo el trabajo hecho sobre estas herramientas se basan en investigación y lo que se conoce como “ingeniería inversa”. No existe ninguna documentación sobre la forma en que Macrofiche almacena sus reportes, de ahí que hablamos de un formato “propietario”. Es por esto que no se puede asegurar una absoluta garantía en la descompresión de reportes en cualquiera de las posibles implementaciones de Macrofiche COLD. En la práctica, estas herramientas han procesado correctamente los reportes generados desde las plataformas mas comunes.

4. Aún si no se obtienen los resultados esperados sobre algún tipo de reporte, no desespere, envienme en lo posible una muestra pequeña de un reporte procesado por Macrofiche COLD, que con gusto lo investigaré y trataré de encontrarle la solución.

1.5 Versiones

Actualmente Mfw2txt o Mfw2pdf tiene las siguientes versiones:

• Demo: Una versión de evaluación, totalmente funcional, pero que únicamente exporta las primeras mil páginas de cada reporte y coloca un “watermark” en cada página.

• Full: Pensadas para empresas de conversión de datos.

• Remota: Esta versión es la que se distribuye a los clientes finales, en caso que se quiera realizar la conversión en sus propias instalaciones. Tiene algunas diferencias con respecto a la versión full, básicamente solo permite la conversión del conjunto de reportes que el cliente solicita. La mecánica de trabajo y las diferencias se detallarán en este manual.

4 de 26

Page 5: MacroFiche Report Export to

Mfw2txt/pdf el Manual2 Usando mfw2txt/Pdf

2 Usando mfw2txt/Pdf

Ejecutar alguna de estas herramientas sin parámetros nos permitirá observar las distintas opciones que ofrece. Todas pueden invocarse del modo corto (un guión y la letra) o del modo largo (dos guiones y un texto mas descriptivo). Tanto mfw2txt como mfw2pdf comparten la mayoría de las opciones, sin embargo hay algunas que son especifícas de cada una de estas herramientas y otras que requieren alguna consideración con respecto a sus uso, en cualquier caso se especificará especialmente esto.

Ayuda de mfw2txt

mfw2txt v1.4 (evaluation/Local) ­ Macrofiche report conversion to Ascii Txt filesCopyright (C) 2004,2005,2006 Patricio Moracho <[email protected]>

Contributed code from Bob Stout, Mark Adler, Jean­Loup Gailly & The Regents of the University of California

usage: mfw2txt [OPTIONS]  [ ­h ] [ ­­help ]            Print help screen  [ ­r ] [ ­­report­path ]     Macrofiche Report path (**Required)  [ ­l ] [ ­­log­path ]        Path for Log file output (default: curdir)  [ ­q ] [ ­­log­level ]       Log level (default: 0 All)  [ ­u ] [ ­­station­id ]      A number for load station (default: 0)  [ ­i ] [ ­­institution ]     Institution to process (default: All)  [ ­d ] [ ­­date ]            Date to process (default: All)  [ ­a ] [ ­­application ]     Application to process (default: All)  [ ­n ] [ ­­report ]          Report to process (default: All)  [ ­o ] [ ­­output­path ]     Path to output the converted report (default: current dir)  [ ­m ] [ ­­output­mode ]     Report output mode (See help)  [ ­t ] [ ­­test­mode ]       Only show processing options  [ ­p ] [ ­­pages­inform ]    How many pages will be displayed for operator status (default: none)  [ ­x ] [ ­­rpt­list ]        Report name list from file (default: none)  [ ­z ] [ ­­zip­paths ]       Hoy many paths to zip (default: 0)  [ ­j ] [ ­­path­list ]       Path list from mkmfwlist to convert (default: none)  [ ­w ] [ ­­insert­new­page ] Insert new page using a special ascii char (default: no)  [ ­v ] [ ­­variable ]        Output variable record len? (default: fixed)  [ ­b ] [ ­­new­line­mode ]   New line mode 0=none, 1=CR, 2=CR+LF (default: 0)  [ ­f ] [ ­­host­reprint ]    Host reprint format (default: no)  [ ­e ] [ ­­append ]          Append mode for output? (default: no)  [ ­k ] [ ­­rawdjde]          Special conversion for djde/metacode ebcdic? (default: no)  [ ­g ] [ ­­ebcdic2ascii ]    Convert from ebcdic to ascii? (default: no)

5 de 26

Page 6: MacroFiche Report Export to

Mfw2txt/pdf el Manual2 Usando mfw2txt/Pdf

Ayuda de mfw2pdf

mfw2pdf v1.4 (evaluation/Local) ­ Macrofiche report conversion to Acrobat PDF filesCopyright (C) 2004,2005,2006 Patricio Moracho <[email protected]>

Contributed code from Bob Stout, Mark Adler, Jean­Loup Gailly & The Regents of the University of California

usage: mfw2pdf [OPTIONS]  [ ­h ] [ ­­help ]            Print help screen  [ ­r ] [ ­­report­path ]     Macrofiche Report path (**Required)  [ ­l ] [ ­­log­path ]        Path for Log file output (default: curdir)  [ ­q ] [ ­­log­level ]       Log level (default: 0 All)  [ ­u ] [ ­­station­id ]      A number for load station (default: 0)  [ ­i ] [ ­­institution ]     Institution to process (default: All)  [ ­d ] [ ­­date ]            Date to process (default: All)  [ ­a ] [ ­­application ]     Application to process (default: All)  [ ­n ] [ ­­report ]          Report to process (default: All)  [ ­o ] [ ­­output­path ]     Path to output the converted report (default: current dir)  [ ­m ] [ ­­output­mode ]     Report output mode (See help)  [ ­t ] [ ­­test­mode ]       Only show processing options  [ ­p ] [ ­­pages­inform ]    How many pages will be displayed for operator status (default: none)  [ ­x ] [ ­­rpt­list ]        Report name list from file (default: none)  [ ­z ] [ ­­zip­paths ]       Hoy many paths to zip (default: 0)  [ ­j ] [ ­­path­list ]       Path list from mkmfwlist to convert (default: none)  [ ­1 ] [ ­­pdf­width ]       Width of page (default: auto)  [ ­2 ] [ ­­pdf­height ]      Height of page (default: auto)  [ ­e ] [ ­­bottom­msg ]      Message at report bottom (default: none)  [ ­g ] [ ­­greenbar ]        Set greenbar properties, see help (default: none)  [ ­s ] [ ­­comp­level ]      Compresion level (default: 8)  [ ­f ] [ ­­font­size ]       Font size (default: 10)

6 de 26

Page 7: MacroFiche Report Export to

Mfw2txt/pdf el Manual2 Usando mfw2txt/Pdf

2.1 Opciones comunes

-h, --help

Bueno, no hay mucho para decir, todos los programas tienen esta opción. Sencillamente muestra una descripción del programa y sus principales opciones, o sea una ayuda ;).

-r, --report-path

Esta opción es obligatoria, a menos que se utilice el modo “batch” que veremos más adelante. Representa el path desde donde cuelgan todos los directorios de reportes de Macrofiche. Puede variar según la instalación, incluso puede haber más de uno. Normalmente estamos hablando de c:\macro\mfdata.

--report-path c:\macro\mfdata

Si se usan nombres largos que contengan espacios (nunca es una buena idea) es necesario utilizar dobles comillas para “encerrar” el path.

--report-path “c:\macro\this is not a good name for a folder”

No utilice este parámetro para procesar un gran volumen de información, para hacer esto es preferible usar el modo “batch” con el que tiene un mayor control sobre el proceso.

NOTA: Este parámetro solo se encuentra en la versión full del producto. Normalmente en caso de la versión de distribución a clientes finales, solo se puede realizar la conversión en modo “batch”.

-l, --log-path

No es obligatorio. Este programa genera en cada corrida dos archivos de auditoría, uno, donde se registra paso a paso la ejecución y eventos del procesos (mfw2txt_*.log) y en un segundo archivo se registran los reportes exportados y la cantidad de páginas de los mismos (mfw2txt_reports_*.log). Por defecto, estos archivos se salvan en el mismo directorio desde donde se ejecuta el proceso.

--log-file c:\logs

Cada administrador tiene sus políticas con respecto a este tema, algunos directamente no les interesan y los suelen borrar, otros los archivan por largo tiempo, yo recomiendo que lo conserven, pero cuidado, el detalle que guarda puede hacer que el archivo crezca demasiado, lo revisaría para saber si aconteció algún error y luego los comprimiría. Además tenga en cuenta que de darse un error poco claro y necesiten contactar al desarrollador de estas herramientas, seguramente lo primero que se les solicitaría son estos archivos. Si la ejecución va a ser desatendida, una buena medida es hacer que estos archivos vayan a un directorio compartido, o incluso a un servidor ftp o telnet, de esta forma podremos verificar en cualquier lugar del mundo, como va funcionando el proceso (esto con la magia de Internet y el comando tail).

7 de 26

Page 8: MacroFiche Report Export to

Mfw2txt/pdf el Manual2 Usando mfw2txt/Pdf

-q, --log-level

Qué cosa se registra en el archivo de auditoría es lo que se establece con este parámetro. Actualmente estas aplicaciones tienen 5 niveles de auditoría, de acuerdo al nivel que uno le indique es que se registra mayor o menor información

0 – CRITICAL : En realidad actualmente no hay elementos que se registren bajo este nivel, por lo que se puede establecer el mismo para no generar ningún detalle.

1 – ERROR: Si se selecciona este nivel, únicamente se registran los errores, algunos de ellos podrían producir el fin de la ejecución y otros no.

2 – WARNING: Además de los eventos anteriores se registran errores o problemas no del todo críticos pero que requieren algún análisis posterior.

3 – IMPORTANT: Se registran hasta los sucesos informativos importantes.

4 – INFO: Se registra con un mayor detalle toda la ejecución de la herramienta, se detallan los directorios y reportes extraídos.

9 – DEBUG: Hay algunos eventos que pueden aportar mayor información, en particular al autor de este software, incluso puede ser que se preparen versiones “especiales” del software con un detalle muy amplio (en este nivel) de todo el proceso, con el fin de detectar algun tipo de falla que salga de la normalidad de cualquier error.

--log-level 4 Ejecuta la auditoría de los eventos hasta el nivel 4

El nivel por defecto es el 3, si queremos registrar los listados procesados en cada ejecución, será necesario ejecutar todo con el nivel 4.

-u, --station-id

En caso de realizar una ejecución distribuida en varios equipos, puede ser interesante que cada archivo de auditoría tenga una identificación única. Con este parámetro podremos definir un número de estación (de 0 a 9999) para indentificara correctamente cada uno de los procesos. Por defecto el número de estación es el 0.

--station-id 7

Los dos archivos de auditoria tienen el siguiente formato:

mfw2txt_<station>_<yyyymmdd_hhmmss>.logmfw2txt_reports_<station>_<yyyymmdd_hhmmss>.log

El número de estación se configura con este parámetro y la fecha y hora se toma del inicio de la ejecución.

8 de 26

Page 9: MacroFiche Report Export to

Mfw2txt/pdf el Manual2 Usando mfw2txt/Pdf

-i, --institution

En Macrofiche, uno de los primeros niveles de catalogación de los listados es lo que se denomina “institution / department”. Generalmente, es usado en el caso de una empresa, para identificar una sucursal o área, y en el caso de un empresa que dá servicios suele ser la codificación del cliente al que le procesan los listados. De cualquier forma, este parámetro, nos permite realizar la selección de los directorios de Macrofiche. Si no se usa, significa que se procesarán todos. Recuerde que los directorios donde se salvan los listados son bautizados de la siguiente forma: IIMMDDYY.II es decir 2 caracteres para el departamento, la fecha generalmente en formato americano con el año de 2 posiciones (la famosa incompatibilidad y2k) y los dos últimos caracteres para las instituciones de 4 posiciones. Veamos algunos ejemplos:

00120198 departamento 00, fecha 01 de diciembre del 9823011799.01 departamento 0123 del 17 de enero del 99

Como se ve en el caso de los departamentos de 4 caracteres los 2 últimos están en el comienzo y los primeros en el final del nombre del directorio. Esto es simplemente informativo, lo importante es que el parámetro que estamos comentando permite una selección precisa de los departamentos, además permite el uso de comodines o “wildcards”.

Veamos algunos ejemplos:

--institution 00 Procesar reportes del departamento 00 y 0000--institution 9123  Los del departamento 9123--institution 0* Los que comiencen con '0'--institution 0*3 Los que comiencen con '0' y terminen con '3'

--institution 0?1?  Los que comiencen con '0' y tengan un '1' en el medio

Por defecto, es decir si no se especifica nada, entonces se procesarán todos los departamentos.

-d, --date

El segundo nivel de jerarquía en Macrofiche es la fecha, de proceso o del listado. De la misma forma que en el caso del departamento, se pueden usar comodines para establecer qué fechas a procesar

--date *97  Solo listados del 97

--date 12*90  Solo listados de diciembre del 90

Todo esto depende de como es el formato de fecha utilizado en la instalación de Macrofiche.

-a, --application

Este parámetro, configura la aplicación de los reportes a extraer, esto es el código de 4 caracteres que define generalmente un sistema bajo el cual se agrupa un conjunto de

9 de 26

Page 10: MacroFiche Report Export to

Mfw2txt/pdf el Manual2 Usando mfw2txt/Pdf

listados. Tiene el mismo mecanismo de “matching” por comodines que hemos comentado anteriormente en selección de fechas y departamentos.

--application BILL Reportes de la aplicación BILL--application D* Reportes de cuya aplicación comiencen con una “D”

-n, --report

Este parámetro, configura qué reportes se desea exportar, funciona el mismo criterio de matching que en el resto de los parámetros de selección.

--report *balance*  Reportes cuyo nombre contenga la palabra balance

--report “balance ref journal”  Únicamente este reporte

Algo muy importante que hay que aclarar, el “matching”, en todos los casos donde se use es insensible a mayúsculas / minúsculas.

-o, --output-path

Path de salida de los reportes exportados, por defecto, el path actual, de modo que es una muy mala idea no usar este parámetro. El directorio, obviamente debe ser válido, se debe tener permisos de escritura y debe haber espacio suficiente, cualquiera de estas situaciones no se controlan de forma específica, de modo que si no se cumplen estos requisitos, es probable que pierda el trabajo, su mujer lo abandone, sus hijos no lo reconzcan, su compañero mas inútil consiga el ascenso, su equipo favorito pierda todos los partidos y este programa se finalice de manera espantosa. Espero haberlo convencido para que verifique concienzudamente el lugar donde se guardarán los reportes exportados, no se queje si tiene algún problema, ya se lo habíamos dicho.

--output-path “c:\Again this is as bad folder name ”

--output-path /var/out  (En unix sería algo así)

--output-path c:\out

-m, --output-mode

Método de salida de los reportes. Es la modalidad en que se quiere salvar los reportes exportados, establece la forma en que se separan los distintos reportes. Todos ellos se salvan de una forma u otra en el directorio especificado por el parámetro –output-path, no olvidar establecer uno especial para este trabajo.

Actualmente hay implementados 5 modos básicos:

Modo 1 : Los reportes se salvan en un único archivo por departamento y fecha, es decir cada directorio Macrofiche tendrá un archivo por ej: 0000_081298_report.txt/pdf. En un único archivo tendremos todos los reportes correspondientes a cada carpeta. No es un mod muy práctico, solo es práctico para hacer una prueba rápida

10 de 26

Page 11: MacroFiche Report Export to

Mfw2txt/pdf el Manual2 Usando mfw2txt/Pdf

Modo 2 : Muy parecido al modo anterior solo que el nombre se compone del nombre real de la carpeta de Macrofiche que se procesa, por ej. 00081298.92_report.txt/pdf

Modo 3 : En este modo se llega a construir archivos por reporte ya que el nombre de los mismos se compone del departamento, la fecha, la aplicación y el nombre del reporte. Por ej. 0000_081298_DDA_Balance_Ref_Journal.txt/pdf.

Modo 4 : El modo “O'hara”, propuesto por Bernardo O'Hara tiempo atrás con la idea de evitar cualquier posibilidad que se mezclen los reportes. Es similar al anterior salvo que la fecha se compatibiliza con el año 2000, el departamento se lo normaliza a 4 caracteres y se agrega un numerador correspondiente al número del reporte dentro de cada carpeta de Macrofiche, este modo es el que logra la mayor separación de los reportes. Los datos entonces serían, departamento, Reporte, Fecha, Número de reporte. Por ej. 0000_BILL_UB_92_s_03301997_001.pdf/txt.

Modo 5 : El modo “Macrofiche”, sencillamente intenta reproducir la estructura de directorios de este. Además es el modo que crea directorios cuando lo necesita, la estructura final es la siguiente:

<PathNormName>\<date>\<rptname>_<nrpt>.txt/pdf

El primer dato es el path de Macrofiche procesado, normalizado para producir un único directorio, por ejemplo: “C:\Macro\Data” se transformará en un único directorio llamado “C__Macro_Data”.

El segundo nivel es la fecha procesada y por último el nombre del reporte y el número interno. De esta manera un listado común de los ejemplos de Macrofiche se podría salvar en:

C__Macro_Data\00031595\000_COD_BALANCE_REF_JOURNAL_0004.txt

Algunas consideraciones:

El nombre de los reportes, cuando se usa para bautizar un archivo, se debe compatibilizar con las posibilidades que nos permite cualquier nombre de archivo, es decir, que se elimina cualquier carácter especial que pudiera tener. Se utiliza el estandar “Windows”, es decir, únicamente se permiten letras y números y los signos '-' y '_'. Cualquier carácter especial al construir el nombre de los archivos se remplaza con el carácter '_'. Así por ejemplo un listado que se llame “Cargas & Costos” se terminará bautizando como “Cargas___Costos”.

El numerador de reporte que mencionábamos es simplemente un número interno que utiliza Macrofiche para manejar los distintos reportes dentro de cada directorio, normalmente si en una carpeta se almacenaron 15 reportes, no importa si las páginas de estos estuvieran mezcladas, cada página de los reportes tendrá un identificador que irá del 1 al 15, según el reporte al que pertenezcan. El uso de este dato como variable hace mas complicado que dos reportes puedan compartir el nombre. Algo que podría ocurrir por ejemplo cuando se normaliza los nombre “Report XX*” y “Report XX#”.

Cuando utilizamos la herramienta Mfw2pdf, si bien es posible utilizar cualquiera de los 5 modos actuales, tiene poco sentido usar aquellos que implican juntar varios reportes en un único archivo, tenga en cuenta, que para construir el archivo PDF se considera la

11 de 26

Page 12: MacroFiche Report Export to

Mfw2txt/pdf el Manual2 Usando mfw2txt/Pdf

cantidad de columnas y de filas de cada reporte para establecer el tamaño de página, si juntamos varios reportes en un único archivo, el tamaño de página se definirá en base a las características del primer reporte procesado, de manera que si el resto de los reportes tuviera un tamaño distinto en filas y columnas es posible que la información no se muestre de manera correcta. Seguramente sea preferible construir archivos PDF independientes por cada reporte, para eso deberemos usar los modos 3, 4 o 5.

Para administradores: El usuario con el que se ejecuta estas aplicaciones deberá tener permisos de escritura y de creación de directorios, asimismo tener en cuenta que estas herramientas no controlan el espacio disponible (esto debería ser su trabajo), de modo que hagan un calculo apropiado, mi consejo es considerar el mismo volumen de Macrofiche a procesar, mas el tamaño del directorio mas grande, y redondeando hacía arriba, es decir, si lo que se quiere procesar midiendo el espacio de todos los directorios de fechas de Macrofiche, suma 75 Gbytes y el directorio mayor ocupa unos 100Mb, entonces calcular un espacio de 76 Gbytes, seguramente va a sobrar bastante, pero podremos dormir tranquilos.

-t, --test

Este parámetro, sencillamente muestra en pantalla la configuración del proceso pero no realiza ninguna ejecución. La utilidad, es la de poder ver previa a la ejecución real, como es la interpretación de todos los parámetros ingresados.

-p, --pages-inform

Simple, cada cuántas páginas de un mismo directorio queremos que el sistema nos informe, por defecto, ninguna. Esto es para que aquellos que no están acostumbrados a los programas “demonios” , no piensen que este programa se “colgó”. No tiene mucho sentido para corridas de larga duración, ya que normalmente en pantalla se informa cada uno de los directorios que se han procesado.

--pages-inform 0  No informar nunca (valor default)

--pages-inform 30000 Informar cada 30.000 páginas

El mensaje es sumamente detallado e informativo y da ganas de quedarse toda la noche viendolo pasar: “Processing <path> <n> pages...”

Normalmente, si se desea conocer el estatus de ejecución, lo mejor es visualizar las últimas líneas del archivo Log del proceso, por ejemplo usando el comando “tail” disponible normalmente en entornos Unix pero con varias implementaciones en Windows. Esto nos irá dando una información mucho mas detallada y clara.

-w, --insert-new-page

En algún momento puede ser necesario insertar un carácter especial para indicar un salto de página. El sistema en estos casos, inserta en la salida una línea entre página y página el carácter que le indiquemos. Por ejemplo, en DOS suele ser común, al menos para muchos editores que el Ascii 12 represente este corte. Sin embargo cada sistema puede usar caracteres distinto, de modo que simplemente indicando el carácter en

12 de 26

Page 13: MacroFiche Report Export to

Mfw2txt/pdf el Manual2 Usando mfw2txt/Pdf

forma de número decimal, lo podremos adaptar a nuestras necesidades. Por defecto no se inserta ningún carácter especial.

--insert-new-page 12

Nota: Este parámetro solo corresponde a Mfw2txt.

-z, --zip-paths

En un mundo ideal, uno hace la conversión de 80 Gbytes y tiene disponibles otros 800 Gbytes, en el mundo práctico a lo sumo dispone de otros 50 Gbytes libres, es por eso que implementamos este procedimiento.

Cada <n> directorios de Macrofiche procesados, se disparará un proceso que debería comprimir y borrar la salida convertida, de manera de mantener el espacio disponible en un número que permita procesar mayor información. El nombre de la opción no significa que solamente se ejecuta la compresión mediante el Zip, en realidad este procedimiento, cada <n> directorios procesados, hace una llamada a un script, ya sea un clásico BAT de DOS o un Shell script si está corriendo las versiones de Unix. Este script llamado post.bat o post.sh podrá editarlo a su gusto, haciendo lo que mejor le parezca, a modo de ejemplo, se armó un procedimiento que realiza la compresión de los archivos y el posterior borrado de los mismos. Lo importante a tener en cuenta es que cada <n> directorios procesados el mfw2txt/pdf llamará al script post.bat o post.sh (en el mismo directorio de esta herramienta) con una serie de parámetros que este script podría aprovechar, veamos cuáles son en el orden en que se invocan:

1. Nombre de paquete: Es un nombre genérico con fecha y hora y sirve para que cualquier programa de compresión lo use para titular el paquete comprimido.

2. El directorio de output: Es el directorio donde se están salvando los reportes una vez procesados, especificado con el parámetro –output-path.

3. Extensión: Simplemente se informa TXT o PDF según hacia donde estemos convirtiendo.

4. Output mode: es el valor númerico correspondiente al tipo de salida especificado por el parámetro: --output-mode.

Por ejemplo el archivo post.sh (en unix) podría ser algo como esto:

#! /bin/sh############################################## Post process (Zip & delete files)# in mode 5 you need to delete de directories#############################################

zip -rm "$1.zip" $2 -i "*.$3" > /dev/null

13 de 26

Page 14: MacroFiche Report Export to

Mfw2txt/pdf el Manual2 Usando mfw2txt/Pdf

Por ejemplo el archivo post.bat (en windows) podría ser algo como esto:

@rem #############################################@rem # Post process (Zip & delete files)@rem # in mode 5 you need to delete de directories@rem #############################################

@zip -rm "%1.zip" %2 -i "*.%3" > nul

--zip-paths 100

Cada 100 carpetas de Macrofiche procesadas se ejecutará el script post.bat.

Algunas consideraciones a tener en cuenta:

1. Con los archivos *.pdf no se gana mucho en espacio ya que éstos ya están comprimidos, pero se gana en comodidad para transportarlos.

2. Con los archivos *.txt se consigue reducir el espacio utilizado de manera muy significativa. Usando estos procedimientos podríamos decir que más o menos para hacer una conversión de una base Macrofiche completa, necesitaríamos algo así como el doble de espacio (y un poco más para dormir tranquilos). De todas formas usted deberá experimentar con esto ya que el nivel de compresión puede variar por muchos factores.

3. La aplicación zip.exe o cualquier otra debería estar en el mismo directorio desde donde ejecutamos mfw2txt o mfw2pdf o al menos apuntada por la variable de entorno “PATH”.

-v, --variable

Normalmente los reportes se convierten a texto, respetando la longitud de registro de éstos, es decir que si un reporte tiene 132 columnas cada línea tendrá esa longitud, posiblemente, más los caracteres de fin de línea, y se rellena con espacios en blanco a derecha si fuera necesario. Algunos sistemas requieren este tipo de tratamiento, sin embargo para que los archivos ocupen menos, puede ser interesante y recomendable usar el modo variable, donde cada línea tiene una longitud que dependerá del útimo carácter de la misma, este modo se tiene que combinar con el parámetro –new-line—mode.

Nota: Este parámetro solo esta disponible para Mfw2txt. En Mfw2pdf el modo por defecto es justamente este.

-f, --host-reprint

Macrofiche tiene un modo especial cuando exporta los reportes llamado “HOST REPRINT”, no es ni más ni menos que un formato conocido hace mucho tiempo llamado FCFC (First Column Form Control), que agrega una columna inicial a cada linea llamada canal y que es usada para incorporar caracteres de control para la impresora. Particularmente, nosotros lo utilizamos para colocar un carácter '1' a partir de donde se produce el salto de página, este parámetro produce que la salida sea de esta forma.

Nota: Este parámetro solo esta disponible para Mfw2txt.

14 de 26

Page 15: MacroFiche Report Export to

Mfw2txt/pdf el Manual2 Usando mfw2txt/Pdf

-b, --new-line-mode

Configura de qué forma queremos tratar cada línea, hay dos, o insertamos un caractér de fin de línea o no usamos ninguno porque nuestra salida va a ser un archivo con tamaño de registro fijo. La posibildades entonces son:

--new-line-mode 0 Sin salto de línea, longitud fija--new-line-mode 1 Al final de la línea se inserta el carácter 0A o sea el carriage return--new-line-mode 2 Al final de la línea se inserta el carácter 0A y 0D o sea el carriage

return más el line feed (el estandar DOS)

Nota: No tiene ningún sentido usar el modo variable sin usar el carácter de salto de línea, el resutado será un archivo que no podremos usar para nada. Este parámetro solo esta disponible para Mfw2txt. En Mfw2pdf, cada línea es indicada por un único carácter 0A.

-w, --insert-new-page

Este parámetro configura el carácter ascii a usar para indicar el corte de página, normalmente podría ser el 0C, por defecto no se inserta ningún salto de página a menos que estemos usando el modo “host reprint” mediante el parámetro –host-reprint.

--insert-new-page 12 El form feed estándar (0C)

Nota: Este parámetro solo esta disponible para Mfw2txt.

-x, --rpt-list

Es normal que en vez de exportar un único reporte necesitemos hacerlo con varios, normalmente usando --report se especifíca solo uno, sin embargo usando este parámetro podremos configurar una lista de reportes a procesar desde un archivo, el cual deberá ser un simple archivo de texto donde cada nombre de reporte deberá ir en una línea. Se podrán usar comodines como ser '*' o '?'.

--rpt-list myreports.txt

Los reportes a procesar se toman del archivo myreports.txt

-j, --path-list

Hablaremos más en detalle de este parámetro cuando avancemos en los metódos de conversión. Podemos decir que mediante su uso se podrá establecer una lista construida previamente con la herramienta mkmfwlist con los directorios a procesar. Esto sirve para armar procesos masivos de forma mas controlada

--path-list dirs.txt

15 de 26

Page 16: MacroFiche Report Export to

Mfw2txt/pdf el Manual2 Usando mfw2txt/Pdf

Procesar la lista dirs.txt de directorios de Macrofiche

-e, --append

Usando este parámetro forzaremos que el output sea en modo “append”, es decir que no se sobreescribirán los archivos de “output”, toda salida que corresponda a un determinado archivo se agregará al mismo, normalmente si se ejecuta mas de una vez el proceso de un “input”, la salida siempre será la misma, usando este parámetro la ejecución irá agregando el “output” a los mismos archivos de la ejecución anterior. No es una buena idea usar este parámetro, solamente esta disponible con motivo de investigación o “debug”.

Nota: Este parámetro solo esta disponible para Mfw2txt.

-g, --ebcdic2ascii

Macrofiche tiene un tratamiento particular con algunos tipos de spools, normalmente al procesarlos los convierte internamente a un formato ASCII, de manera que al extraerlos no es necesario realizar ningún tipo de conversión, asumiendo siempre que lo habitual es manejarlos en ASCII. Sin embargo es de esperar, que con aquellos en que la visualización es manejada por rutinas de terceros, como es el caso de los reportes Metacode, DJDE, AFP y posiblemente PCL, el comportamiento es distinto, en estos casos el input es almacenado en el formato original. Esto puede implicar que los reportes esten guardados en formato EBCDIC. Usando este parámetro podremos convertirlos al formato ASCII.

Nota: Este parámetro solo esta disponible para Mfw2txt.

-k, --rawdjde

Este parámetro sirve para procesar particularmente los reportes del tipo DJDE/Metacode que esten en formato EBCDIC y que deseamos conserven el mismo. Macrofiche agrega ciertos caracteres de fin de línea que no son conpatibles totalmente con el estándar EBCDIC, de manera que es necesario contemplarlos para que el output respete esta tabla de caracteres.

Nota: Este parámetro solo esta disponible para Mfw2txt.

-s, --comp-level

El formato PDF permite incorporar en cada página, distintos algoritmos de compresión de manera de reducir el tamaño final del archivo. Particularmente con objetos de tipo “texto”, el mejor algoritmo, es el que se conoce como “deflate”, que no es ni mas ni menos que el utilizado para construir los concidos archivos Zip. Este algoritmo desarrollado por Jean-Loup Gailly y Mark Adler puede operar con hasta 9 niveles de compresión , desde el nivel 0 (sin compresión) hasta el 9. Por defecto Mfw2pdf utiliza el nivel 8. Tenga en cuenta que mayor compresión implica un menor tamaño final para los reportes procesados pero también un mayor gasto de CPU y mayor tiempo de proceso.

--comp-level 0 No usar compresión

16 de 26

Page 17: MacroFiche Report Export to

Mfw2txt/pdf el Manual2 Usando mfw2txt/Pdf

Nota: Este parámetro solo esta disponible para Mfw2pdf.

-g, --greenbar

Este parámetro permite configurar unos sencillos “greenbars” para los reportes, a modo de los antiguos reportes impresos sobre este tipo de formulario. Estas líneas, generalmente de color verde y muy suaves, en teoría facilitan la visualización de los datos. Particularmente, mediante esta opción podremos establecer el color y cuantas líneas queremos que ocupen. El formato es el siguiente: "Red,Green,Blue,Rows", es decir el color lo estableceremos mediante la configuración de los tres colores primarios de una paleta RGB, y por último la cantidad de líneas, el ejemplo sería:

--greenbar “0.9,1.2,0.9,1” Color verde muy claro y una línea de alto

Nota: Este parámetro solo esta disponible para Mfw2pdf.

-e, --bottom-msg

Simplemente para configurar un texto en la parte final e izquierda de cada página.

--bottom-msg “Copyright Macro Bank”

Nota: Este parámetro solo esta disponible para Mfw2pdf.

-1, --pdf-width

Sirve para establecer un ancho fijo para cada página de los reportes procesados, si no se establece esto, Mfw2pdf calculará el ancho que permita mostrar la cantidad de columnas que se han definido en Macrofiche para el reporte procesado.

Nota: Este parámetro solo esta disponible para Mfw2pdf.

-2, --pdf-height

Sirve para establecer un alto fijo para cada página de los reportes procesados, si no se establece esto, Mfw2pdf calculará el alto que permita mostrar la cantidad de filas que se han definido en Macrofiche para el reporte procesado.

Nota: Este parámetro solo esta disponible para Mfw2pdf.

Normalmente si no se especifícan estos parámetros Mfw2pdf hará el trabajo de determinar el ancho o el alto de la página, normalmente esta es una buena decisión, sin embargo tenga en cuenta que el tamaño final de la página seguramente no se adaptará a un tamaño de papel estándar, es decir que el PDF será muy comódo para visualizar en el monitor pero a la hora de imprimirlo tal vez no se ajuste de manera correcta al tamaño de la hoja, no se perderán datos ya que el Adobe Acrobat lo ajustará correctamente, pero tal vez la salida final no será óptima con relación a la superficie

17 de 26

Page 18: MacroFiche Report Export to

Mfw2txt/pdf el Manual2 Usando mfw2txt/Pdf

impresa de modo que tal vez desee predefinir a sus reportes un tamaño estándar, a modo de ejemplo aquí van algunas configuraciones:

--pdf-width 595 --pdf-height 842 A4--pdf-width 792 --pdf-height 1224 11x17--pdf-width 842 --pdf-height 1191 A3--pdf-width 421 --pdf-height 594 A5--pdf-width 516 --pdf-height 729 B5--pdf-width 612 --pdf-height 1008 Legal--pdf-width 612 --pdf-height 792 Letter

-f, --font-size

Permite establecer el tamaño del fuente, tenga en cuenta que este esta prefijado por motivos de compatibilidad en “Courier New”. Por defecto el tamaño es 10.

Nota: Este parámetro solo esta disponible para Mfw2pdf.

18 de 26

Page 19: MacroFiche Report Export to

Mfw2txt/pdf el Manual3. Formas de conversión

3. Formas de conversión

Existen básicamente dos grande modos de encarar la conversión de una base Macrofiche. Bajo demanda o en Lote. En la primera, lo que se busca es ir convirtiendo los reportes a medida que se los necesite, en la segunda, se planifica una migración completa (o de una parte) como un proceso completo. Mfw2txt/pdf permite realizar ambas simplemente variando la forma en que se ejecuta esta herramienta y teniendo en cuenta que los procedimientos operativos serán bastante distintos. Cuando convertir bajo demanda o masivamente dependerá del objetivo perseguido, si vamos a exportar un conjunto reducido de reportes en varias etapas durante períodos largos, seguramente entraría dentro de una conversión bajo demanda, si por el contrario lo que buscamos es procesar el universo de reportes con motivo de una migración a otro sistemas, con seguridad usaremos una modalidad de conversión por lotes. La frontera entre uno u otro modo no es muy estricta, podremos usar mfw2txt/pdf bajo demanda pero integrado a un procedimiento o programa que lo terminen convirtiendo en un proceso masivo. Lo importante es conocer bien que nos ofrece cada modalidad.

A continuación trataremos de explicar ambas metodologías con algunos ejemplos.

3.1 Bajo demanda

Esta metodología se implementa como dijimos, cuando convertimos un conjunto más reducido de reportes, particularmente cuando no usamos el parametro --path-list, por ejemplo cuando tenemos la forma y necesidad de ubicar un determinado reporte y extraerlo para su visualización, y solo funciona en la versión Full del producto. Veamos algunos ejemplos, se asume que los directorios de reportes de Macrofiche se encuentran en c:\macro\data y la salida se envía a c:\out

✗ Búsqueda y extracción del reporte “BALANCE REF JOURNAL”, del departamento 00 y del 12 de noviembre del 96, salida al archivos reports.txt, longitud fija con carácter 0A al final, sin salto de página.

c:\mfw\bin> mfw2txt --output-path c:\out --report-path c:\macro\data --pages-inform 1000 --institution 00 --date 111296 --report “BALANCE REF JOURNAL”

✗ Búsqueda y extracción del reporte “BALANCE REF JOURNAL”, de cualquier departamento y del 12 de noviembre del 96, salida a un archivo que se llamará 0000_111296_report.txt, salida de longitud variable, con carácter 0A/0D al final de la línea, y caractér 0C como salto de página.

c:\mfw\bin> mfw2txt --output-path c:\out --report-path c:\macro\data --pages-inform 1000 --date 111296 --report “BALANCE REF JOURNAL” --variable --output-mode 1 -–insert-new-page 12 -–new-line-mode 2

19 de 26

Page 20: MacroFiche Report Export to

Mfw2txt/pdf el Manual3. Formas de conversión

✗ Búsqueda y extracción de reportes en cuyo nombre aparezca la palabra Balance, en todos los departamentos y en los reportes del año 96, salida del tipo ASA, de longitud variable, con carácter 0A/0D al final de la linea. Los archivos se llamarán como 0000_111296_DDA_BALANCE_REF_JOURNAL.txt.

c:\mfw\bin> mfw2txt --output-path c:\out --report-path c:\macro\data --pages-inform 1000 --date ????96 --report “*BALANCE*” --variable --output-mode 3 –-new-line-mode 2 --host-reprint

✗ Búsqueda y extracción de todos los reportes del 12 de noviembre del año 96, salida del tipo ASA, de longitud variable, con carácter 0A/0D al final de la linea. Los archivos se llamarán por ejemplo: 0000_111296_DDA_BALANCE_REF_JOURNAL.txt.

c:\mfw\bin> mfw2txt --output-path c:\out --report-path c:\macro\data --pages-inform 1000 --date ????96 --report “*BALANCE*” --variable --output-mode 3 –-new-line-mode 2 --host-reprint

✗ Búsqueda y extracción de todos los reportes, de cualquier fecha del departamento 00 y de la aplicación DDA, salida del tipo ASA, de longitud variable, con carácter 0A/0D al final de la linea. Los archivos se llamarán por ejemplo: 0000_111296_DDA_BALANCE_REF_JOURNAL.txt.

c:\mfw\bin> mfw2txt --output-path c:\out --report-path c:\macro\data --pages-inform 1000 --date ????96 –applicarion DDA --variable --output-mode 3 –-new-line-mode 2 --host-reprint

✗ Búsqueda y extracción de todos los reportes, de una fecha y departamento (directorio) en particular, salida del tipo ASA, de longitud variable, con carácter 0A al final de la línea. Los archivos se llamarán por ejemplo: 0000_DDA_INTEREST_PAID_03241997_0015.txt.

c:\mfw\bin> mfw2txt --output-path c:\out --report-path c:\macro\data --pages-inform 1000 --date ????96 –applicarion DDA --variable --output-mode 3 –-new-line-mode 2 --host-reprint

✗ Búsqueda y extracción de una lista de Reportes en todo un arbol de directorios de Macrofiche.Los archivos se llamarán por ejemplo: 0000_DDA_INTEREST_PAID_03241997_0015.txt.

c:\mfw\bin> mfw2txt --output-path c:\out --report-path c:\macro\data --pages-inform 1000 --variable --output-mode 3 –-new-line-mode 2 --host-reprint –rpt-list reports.txt

La lista de reportes debe ser un simple archivo de texto, donde en cada línea se coloque el nombre, pudiéndose usar comodines para definir estos. Por ejemplo:

Balance Ref*<CR>DDA Statements<CR>Auto Late Charge<CR>Transactions*<CR>

El “matching” de los reportes no es sensible a máyusculas y minúsculas, de modo que es lo mismo usar la palabra “BALANCE” que “balance”.

20 de 26

Page 21: MacroFiche Report Export to

Mfw2txt/pdf el Manual3. Formas de conversión

3.2 En Lote

Esta metodología se orienta a conversiones masivas, por ejemplo una migración de Macrofiche o otro sistema COLD. Mfw2txt/pdf tiene una mecánica que facilita el enorme trabajo de convertir un volumen importante, es posible dejar trabajando esta herramienta durante días practicamente sin atención. Sin embargo la forma de realizar esta conversión en lotes puede que no se ajuste totalmente a sus necesidades, si así fuera le sugiero solictar al autor de esta herramienta alguna funcionalidad adicional, o bien utilizar la funcionalidad de conversión bajo demanda y desarrollar un metódo propio para selección de los reportes.

La conversión en lotes implica dos etapas, un inventario previo de los directorios a procesar y el procesamiento de los mismos. Veamos en mas detalle:

1. Preparación del lote de conversión: Es claro, tenemos una gran base de datos de Macrofiche, distribuida en múltiples volúmenes y carpetas, entonces lo primero que tenemos que hacer es una especie de inventario de conversión. Este proceso se realiza con una herramienta adicional llamada mkmfwlist. Este programa, también de línea de comando, solo recibe un parámetro que es una ruta de datos de Macrofiche, inmediatamente realiza un inventario de todos los directorios que allí se ubican y por la salida estándar (o sea la pantalla) muestra por cada directorio el path base, el subdirectorio, el tamaño completo del archivo REPORTS.001 (es el archivo donde se guardán todas las páginas de los reportes) y un estatus que debería ser inicialmente “Pend” o pendiente. Ahora bien, esta lista debemos salvarla en algún archivo para su uso posterior, lo mas cómodo sería simplemente redirijir la salida de esta herramienta a un archivo, algo que veremos luego mas en detalle. En caso que usted hubiera contratado un servicio de conversión remoto a una empresa, normalmente debería enviarles esta lista, la cual sirve además para hacer una correcta cotización del trabajo, luego de lo cual recibirá un archivo “llave” que lo habilitará a realizar el proceso de conversión. Copie este archivo en el mismo directorio donde ejecutara las herramientas de conversión.

2. Conversión: El proceso de conversión no varía mucho de lo que ya hemos visto, únicamente cambia el hecho que la lectura de los directorio no se realizará usando el parámetro –report-path sino que utilizaremos –path-list indicándole el nombre del archivo de directorios a procesar que hemos generado en la etapa anterior. El proceso entonces irá leyendo cada uno de estos directorios, en particular trabajará solo en aquellos que en la lista figuren con el estatus “Pend”, cualquier otro estatus será ignorado. En cada uno de estos realizará una conversión normal, como ya hemos visto y que podremos configurar en detalle usando cualquiera de los parámetros que ya hemos visto en los ejemplos anteriores. Esta forma de trabajo nos permitirá unificar la conversión de múltiples volumenes en un solo proceso, o incluso distribuir en múltiples equipos dichas conversión simplemente con el hecho de “partir” el archivo de inventario generado anteriormente y disparar converiones en paralelo. Además, el proceso es reiniciable en cualquier momento, si por algún motivo el programa se detuvo, se puede arrancar nuevamente la conversión que esta solo procesará aquellos directorios con estatus “Pend”, luego de lo cual modificará su estatus a “Ok”.

21 de 26

Page 22: MacroFiche Report Export to

Mfw2txt/pdf el Manual3. Formas de conversión

Ejemplo:  Supongamos que nuestra situación actual es la siguientes, tenemos una base instalada de Macrofiche de aproximadamente 100 Gbytes distribuida en 4 volumenes de red separados. Tenemos espacio libre suficienta para realizar toda esta conversión en una sola ejecución, siguiendo lo mencionado anteriormente, los pasos a seguir serán:

Inventario:

Los volumenes Macrofiche por ejemplo, son los siguientes:

1. F:\Data en \\macroserver1\mfdata

2. G:\Data\General en \\macroserver2\mfdata

3. G:\Data\Special en \\macroserver2\mfdata4. H:\Data en \\macroserver1\mfdata2

En una consola ejecutaremos el proceso de inventario mediante el comando mkmfwlist para generar una lista de directorios a procesar en un archivo que llamaremos proclist.txt:

c:\mfw\bin> mkmfwlist f:\data > proclist.txtc:\mfw\bin> mkmfwlist g:\data\general >> proclist.txtc:\mfw\bin> mkmfwlist g:\data\special >> proclist.txtc:\mfw\bin> mkmfwlist g:\data\>> proclist.txt

O incluso mucho mas seguro

c:\mfw\bin> mkmfwlist \\macroserver1\mfdata\data > proclist.txtc:\mfw\bin> mkmfwlist \\macroserver2\mfdata\data\general >> proclist.txtc:\mfw\bin> mkmfwlist \\macroserver2\mfdata\data\special >> proclist.txtc:\mfw\bin> mkmfwlist \\macroserver1\mfdata\data >> proclist.txt

Algunas aclaraciones

1. Solo para aquellos para los que ejecutar un programa solo significa mover el mouse y hacer unos clicks, la redirección es un mecanismo normal que permite canalizar la salida de datos de un programa, en nuestro ejemplo a un archivo. Normalmente el programa mkmfwlist muestra en pantalla (salida estándar) una lista de datos, esa misma lista puede salvarse en un archivo, mediante la redirección usando el signo '>' que además trunca el archivo, es decir lo crea inicialmente, luego para agregar más contenidos al mismo se utiliza el modo “append” de la redirección mediante el uso de el doble signo mayor '>>'. Pido disculpas por la aburrida aclaración a todo aquel profesional de sistemas de mas de 30 años o a cualquier usuario habitual de Unix.

2. El proceso de inventario puede ser lento, vayase a preparar un café, tenga paciencia. No hay forma de hacer que corra mas rápido, todo depende sobre que medios se han salvado los reportes de Macrofiche. Este proceso es muy simple, es un análisis de cada directorio Macrofiche, en el se revisa que exista el archivo REPORTS.001 , que es donde se salvan físicamente las páginas de cada reportes, se verifica que su tamaño sea consistente. Con estos datos se genera una linea en nuestro archivo proclist.txt. Si los directorios fueron bajados a medios muy lentos como CD's o Discos ópticos al igual que si accede remotamente mediante una conexión de red muy lenta puede estar seguro que el proceso demorára bastante, lógicamente igual la conversión.

22 de 26

Page 23: MacroFiche Report Export to

Mfw2txt/pdf el Manual3. Formas de conversión

3. Cualquier directorio que no pudiera procesarse debería tener un estado “bad_dir”, esto puede tener varios motivos, básicamente se puede decir que el directorio no es consistente, ya sea por que esta vacío o esta incompleto algún archivo necesario.

Una vez finalizado el proceso, tendremos un archivo llamado proclis.txt con el inventario completo de directorios a convertir. El formato del mismo tiene alguna particularidad, como ya mencionamos se trata de un simple archivo de texto plano, pero cuidado al editarlo ya que contiene líneas de importante longitud y además contiene caracteres <TAB> o sea Ascii 8 como separador de campo, a muchos editores de texto no les gusta que los archivos tengan una longitud de columnas demasiado grande, personalmente sugiero el sencillo notepad de Windows o el Vim.

Veamos en detalle el formato de nuestro inventario:

1. Volumen a procesar: carácter [100]2. <TAB> Ascii 83. Directorio de fecha: carácter [11]4. <TAB> Ascii 85. Tamaño del reports.001: entero [10]6. <TAB> Ascii 87. Cantidad de páginas: entero [10]8. <TAB> Ascii 89. Estatus: carácter [10]

Para nuestro ejemplo esto sería así (*):

\\macroserver1\mfdata\data 00230205 23456780 9865 Pend\\macroserver1\mfdata\data 00240205 34123400 11523 Pend\\macroserver1\mfdata\data 00250205 17678098 6521 Pend\\macroserver1\mfdata\data 00260205 21980312 8659 Pend

(*) no figuran los blancos que justifican el tamaño de cada campo

Teniendo esta lista con el inventario de toda nuestra base Macrofiche, podremos implementar cualquier rutina de convesión, podremos ordenarla, seleccionar aquellos directorios importantes, podremos dividir el archivo en múltiples lotes, y procesar cada uno en distintas etapas, o incluso distribuir el trabajo en múltiples equipos. El límite es la propia creatividad, lo importante, hagamos lo que hagamos, es respetar el formato que mencionamos. Si usted contrato un servicio de conversión, debera enviar cualquiera de estos archivos a su proveedor, quien con los mismos le brindará una justa cotización. Se le retornará una archivo “llave” que lo habilitará a realizar la conversión de esos directorios, a partir de lo cual no debería modificar estas listas.

En general los directorios dentro de la lista podrán estar:

• “Pend” o sea pendientes de conversión (son los únicos que mfw2txt/pdf procesará).• “Ok” ya convertidos correctamente.• “bad_dir” cuando hay alguna inconsistencia en el directorio y este no se debería siquiera

intentar convertir.• “Error”, el que se define cuando ocurre alguna falla en la conversión.

23 de 26

Page 24: MacroFiche Report Export to

Mfw2txt/pdf el Manual3. Formas de conversión

Conversión:

Finalizado el inventario ya podremos realizar la conversión, en este caso no será necesario indicar el path de los reportes (-r, --report-path) como cuando realizabamos extracciones bajo demanda, en este caso le indicaremos a la herramienta la lista de conversión desde donde obtendrá los directorios a procesar. Esto lo haremos mediante el parámetro -j, --path-list.

c:\mfw\bin> mfw2txt --output-path c:\out –path-list proclist.txt --variable --output-mode 3 –-new-line-mode 2 --host-reprint –rpt-list reports.txt

El proceso de conversión ira leyendo la lista de directorios a procesar (proclist.txt) y aplicando el resto de los parámetros que hubieramos definido, realizará la conversión a Txt o Pdf (según la herramienta). Al finalizar el directorio, modificará el estatus del mismo en la lista.

24 de 26

Page 25: MacroFiche Report Export to

Mfw2txt/pdf el Manual4. Preguntas frecuentes

4. Preguntas frecuentes

✗ Que es Mfw2txt? : Es una muy poderosa y útil herramienta para exportar reportes de Macrofiche COLD o del Synergy COLD reports en un formato del tipo “texto plano”de manera rápida y cómoda.

✗ Para que me puede ser útil?: Backup “abierto”: Los reportes de Macrofiche no dejan de ser un formato “propietario”, por lo que poder tener una copia de los reportes ya procesados en un formato abierto e incluso comprimidos, es una buena medida para asegurar la perdurabilidad de nuestra información. Integración con otras aplicaciones: Cualquier aplicación que requiera acceder a los reportes de Macrofiche, puede hacer uso de esta herramienta para convertir “bajo demanda” cualquier reporte en particular. Migración a otros sistemas: Mfw2txt es una herramienta que ofrece una sencilla y rápida forma de exportar masivamente todos nuestros reportes Macrofiche en un formato compatible por cualquier sistema COLD.

✗ Que formatos de salida puede entregar?: Básicamente hay dos grandes modos, el variable y el fijo. En el primero, cada linea tiene una longitud variable con caracteres de fin de registro (CR o CR+LF), en el segundo cada linea tiene una longitud fija (pudiendo agregarse de todas formas los caracteres de fin de linea). Adicionalmente es posible establecer un carácter de fin de página (normalmente el ASCII 12) o utilizar la salida ASA con una primera columna de canal de impresión donde se ubicará el canal 1 con cada corte de página.

✗ Puedo usarlo en otras plataformas no Windows?: Definitivamente sí. Esta aplicación originalmente fue desarrollada en Ansi C sobre una plataforma Suse Linux, de manera que además de Windows y Linux, el software es compatible con cualquier sistema operativo que cuente con un compilador compatible con el Ansi C.

✗ Se puede establecer los tiempos de proceso? Esto depende de dos puntos muy importantes, el procesador y el sistema de archivos. A modo de ejemplo, en un equipo Intel de 2.6 Ghz, disco IDE y Windows XP hemos conseguido tiempos de conversión de unos 3.5 a 4 Gbytes por hora.

✗ Puedo exportar solo algunos de mis reportes? Por supuesto, se puede establecer una lista de nombres de reporte a exportar y mfw2txt solo extraerá estos. Asimismo, se puede definir que directorios, fechas, aplicaciones o instituciones queremos procesar, de manera que contamos con una enorme flexibilidad para cubrir cualquier necesidad.

✗ Se requiere atención en el proceso? No, el modo “batch” permite dejar funcionando la aplicación durante días, semanas o meses sin ningún tipo de atención. Cualquier situación “anómala” se registra en un archivo de auditoría para posterior consulta.

✗ Cuanto cuesta la herramienta? Esto depende, hay distintas formas de comercialización, por ejemplo para empresas de servicios de procesamiento o para instalaciones finales. De todas formas, para tener una idea certera sobre el costo de esta herramienta le sugiero que nos contacte por este medio, haga un click aquí

✗ Hay alguna empresa que preste servicios de conversión? Por supuesto, en particular le sugiero que visite la página de Intergrabo SRL. Asimismo, tenemos representantes que pueden darle alguna solución al respecto en Perú y Brasil.

✗ Y que es Mfw2pdf?: Es otra herramienta que funciona de la misma forma que Mfw2txt, la única diferencia es que produce archivos Acrobat PDF compatibles con la versión 1.3 y superiores.

25 de 26

Page 26: MacroFiche Report Export to

Mfw2txt/pdf el Manual4. Preguntas frecuentes

✗ Mfw2pdf puede colocar “greenbars”?: Si, e incluso las produce de una manera inteligente, muchas herramientas utilizan “máscaras” repetitivas que se incluyen en cada página, malgastando mucho espacio. Mfw2pdf, sencillamente utiliza una única “máscara” para representar el “greenbar” y utiliza referencias a este objeto dentro del PDF, optimizando el espacio.

✗ Que pasa con los tiempos de proceso?: Son sensiblemente mayores que los de Mfw2txt, unas 2 o 3 veces superiores. Esto se debe a que generar un PDF implica un mayor trabajo, por el formato y la compresión de páginas.

✗ Y con el tamaño de los archivos PDF?: Los archivos PDF generados con Mfw2pdf tienen un alto grado de compresión, si bien nunca van a llegar al nivel de Macrofiche, se acercan bastante, en general podemos decir que se usan entre 2 y 3 Kbytes por páginas. (1000 páginas serían un PDF de entre 2 y 3 Mbytes).

✗ Cuanto espacio necesito para convertir todos mis reportes? En general, según la publicidad de Macrofiche, es normal suponer que la compresión de los listados es de unas 9 veces el tamaño original, de manera que exportar los reportes a texto plano podrá requerir entre 9 y 10 veces el espacio usado por Macrofiche, considerando el archivo REPORTS.001 de cada directorio de fecha. Sin embargo, Mfw2txt tiene un útil modo “batch” para conversiones masivas, que permite ir comprimiendo los listados exportados, por ejemplo, en archivos del tipo ZIP. Este modo nos exigiría una menor cantidad de espacio, en el orden del 80 al 100% del espacio original en Macrofiche.

Ejemplos orientativos

1 Gbyte de reportes Macrofiche prácticamente puros representan 980 Mbytes, exportados serían unos 9 Gbytes y comprimidos con ZIP unos 900 Mbytes

1 Gbyte de reportes Macrofiche mas índices son unos 800 Mbytes reales, exportados unos 7.5 Gbytes y comprimidos unos 700 Mbytes.

26 de 26