COBOL VSAM Analyzer

COBOL VSAM Analyzer es una herramienta desarrollada en COBOL que permite analizar archivos de texto plano (.txt) para inferir su estructura de datos y determinar su compatibilidad con los distintos tipos de almacenamiento VSAM:

• LDS (Linear Data Set).
• ESDS (Entry Sequenced Data Set).
• KSDS (Key Sequenced Data Set).
• RRDS (Relative Record Data Set).

El programa se ejecuta desde consola y realiza un análisis automático basado en la estructura del archivo y las características de sus datos.

---

Descripción del funcionamiento

El programa analiza el archivo en varias fases:

1. Detección de estructura

• Identificación de delimitadores (|, ,, ;, tabulador).
• Comprobación de consistencia entre líneas.

2. Análisis de claves

(Solo si existe estructura)

• Extracción del primer campo como posible clave.
• Evaluación de:
  • Unicidad.
  • Naturaleza numérica.
  • Orden ascendente.
  • Continuidad (sin saltos).
  • Longitud fija.

3. Clasificación VSAM

En base al análisis:

Tipo	Requisitos
LDS	Archivo sin estructura
ESDS	Archivo con estructura
KSDS	Clave única y ordenada
RRDS	Clave numérica, continua y de longitud fija

---

Uso

El programa se ejecuta desde la consola pasando como parámetro la ruta del archivo .txt que se desea analizar. En base a la localización del ejecutable y del archivo que se quiera analizar, debe colocarse en la consola las rutas correspondientes.

Ejemplo:

.\cobol_vsam_analyzer.exe test1.txt

El programa solo acepta un parámetro. Si no se introduce ningún archivo, si se introducen varios parámetros, si el archivo no tiene extensión .txt, si no puede abrirse o si está vacío, se mostrará un mensaje de error.

Ejemplo de salida:

========================================
        VSAM COMPATIBILITY REPORT
========================================
KSDS : COMPATIBLE
ESDS : COMPATIBLE
RRDS : NOT COMPATIBLE
LDS  : NOT COMPATIBLE
========================================

Instalación y ejecución

Este proyecto está desarrollado en COBOL y puede compilarse y ejecutarse en entornos modernos como Windows o Linux mediante GnuCOBOL.

Contexto de uso

El programa no trabaja con VSAM real ni con sistemas mainframe. Su función es analizar archivos de texto (.txt) y clasificar su estructura según criterios similares a los utilizados en VSAM.

Por tanto:

• Es una herramienta de aprendizaje y análisis conceptual.
• Funciona en entornos locales con archivos de texto.
• No es directamente utilizable en entornos mainframe sin adaptación.

Para un uso real en sistemas como IBM z/OS sería necesario integrarlo con acceso a datasets VSAM.

Entorno de desarrollo

• Sistema operativo: Windows 11
• IDE: OpenCOBOLIDE 4.7.6
• Compilador utilizado: GnuCOBOL (OpenCOBOL)
• Tipo de aplicación: Programa de consola (CLI)

Consideraciones

• Solo admite archivos .txt.
• El análisis se basa en estructura y patrones de texto.
• No procesa datasets reales ni formatos binarios.
• Límite de análisis: 1000 claves.

Este proyecto debe entenderse como una aproximación lógica al comportamiento de VSAM en lugar de una implementación real.

---

Licencia

Este proyecto está protegido bajo la licencia Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0).

Esto significa que:

• Puedes usar el código libremente.
• Puedes modificarlo y adaptarlo.
• Puedes compartirlo con otras personas.
• No puedes utilizarlo con fines comerciales.
• No puedes vender el código ni integrarlo en productos o servicios de pago.
• Debes atribuir al autor original en cualquier redistribución.

Permisos especiales

Si deseas un permiso específico para uso comercial, puedes solicitarlo contactando directamente conmigo.