vshare for z/os - csi international, inc

Release 4 Version 0

Manual published October 2018

VSHARE permite múltiples programas para

acceder y actualizar el mismo Archivo

VSAM simultáneamente por dando a los

trabajos por lotes la capacidad de actualizar

archivos dentro de CICS.

VSHARE™ FOR Z/OS Installation and Operations Guide Multiple Region VSAM File Sharing Product

Copyright © 2003, 2016, 2018 by CSI International

All Rights Reserved

RESTRICTEDRIGHTS LEGEND

El uso, la duplicación o la divulgación por parte del gobierno están sujetos a las

restricciones establecidas en el subpárrafo (c) (1) (ii) de los Derechos en Datos Técnicos

e Informática Cláusula de software en DFARS 252.227-7013. Este material contiene

información confidencial y material patentado de CSI International y no puede utilizarse de

ninguna manera sin autorización escrita de CSI International. Este material no puede ser

reproducido, total o parcialmente, de cualquier manera, sin el permiso previo por escrito de

CSI Internacional. Se concede permiso para copiar y distribuir este documento como sigue:

• Cada copia debe ser una copia completa y precisa.

• Todos los avisos de copyright deben conservarse.

• No se pueden hacer modificaciones.

• El uso de cada copia está restringido a la evaluación y / o promoción de El producto

VSHARETM FOR Z / OS de CSI International o de acuerdo con Un acuerdo de licencia.

VSHARE FOR Z/OS 4.0 Installation and Operations Guide

October 2018

Actualizaciones de esta edición: mensajes y códigos —FSIVSHAR-693

Publicado por CSI International

Teléfono: 800-795-4914

Fax: 740-986-6022

Email: [email protected]

[email protected]

Internet: http://www.csi-international.com

http://www.csi-international.com/

Soporte Técnico Internacional de Productos CSI

Soporte Técnico de Productos

Durante el Horario Comercial de Lunes a Viernes, 9:00 a.m. hasta las 5:00 p.m. EST / EDT

• Teléfono

Llamada gratuita en USA: 800-795-4914

En todo el mundo: 740-420-5400

• Email

Preguntas: [email protected]

• Web

http://csi-international.com/support.htm

Servicio de emergencia (24/7) después del horario comercial y 24 horas los sábados y domingos

• Teléfono

Llamada gratuita en USA: 800-795-4914

En todo el mundo: 740-420-5400

iii

1 Las llamadas se transfieren automáticamente a un servicio de respuesta 24/7 que reenvía todas las llamadas según la gravedad.

mailto:[email protected]

http://csi-international.com/support.htm

Tabla de Contenidos

Soporte Técnico Internacional de Productos CSI ........................................................................ iii

Empezando ………………................................................................................................................. 1 Entorno Actual ………................................................................................................................... 2 El Problema…............................................................................................................................... 3 Soluciones Pasadas..................................................................................................................... 3 ¿Cómo resuelve el problema un DBMS? .................................................................................... 4 VSHARE es la respuesta ............................................................................................................ 5 VSHARE’s características ........................................................................................................... 6 Facilidades de uso ....................................................................................................................... 7 Acerca de este manual ............................................................................................................... 7 Nuevo para la versión 4 .............................................................................................................. 7

Guia del Programador ………......................................................................................................... 8 Visión General ............................................................................................................................ 9 VSHARE Aruitectura................................................................................................................... 9 Una muestra de ejecución VSHARE ........................................................................................ 11 Pasos para definir n trabajo para VSHARE .............................................................................. 12 Servicios de memoria Cruzada Versus LU 6.2 ......................................................................... 13 No todos los archivos deben definirse en CICS ....................................................................... 13 Acceso a archivos en una CPU diferente ................................................................................. 13 VSAM seguridad de archivo ..................................................................................................... 14 Ejecutar un programa en un entorno compartido ..................................................................... 14 Recuperación ........................................................................................................................... 15 Actuación .................................................................................................................................. 15 Determinación de Problemas ................................................................................................... 15 Soporte de Ensamblador .......................................................................................................... 17 Claves Non-Unique con archivos de indices alternativos ........................................................ 17 Resumen .................................................................................................................................. 17

Recuperación .................................................................................................................................. 18 Visión General .......................................................................................................................... 19 Recuperación en un entorno compartido .................................................................................. 19 ¿Es Eliminar, Definir, Repro Practico para la Recuperación? .................................................. 19 ¿Quién más puede actualizar mi registro? ................................................................................ 19 ¿Cuánto tiempo debo bloquear un registro? ............................................................................. 19 ¿Qué sucede si mi programa termina? ..................................................................................... 19 Bloqueo y liberación de registros dentro de CICS...................................................................... 20

Múltiples programas que actualizan el mismo registro ……....................................................... 20

Los tres niveles de recuperación de VSHARE ........................................................................... 21

Tier 1: Sin sincronización ........................................................................................................... 22

¿Qué es Tier 1? ......................................................................................................................... 22

iv

Table of Contents

¿Qué tipo de trabajo debe usar Nivel 1? ................................................................................... 22 ¿Cómo se implementa el Nivel 1? ............................................................................................. 22 ¿Cómo se recuperan los archivos después de un final normal? ............................................... 23 Nivel 2 sincronizacion implicita ....................................................................................................... 24 ¿Qué es el Nivel 1? ................................................................................................................... 24 ¿Qué tipo de trabajo debería utilizar el Nivel 2? ....................................................................... 24 ¿Cómo se implementa el nivel 2? ............................................................................................. 24 ¿Qué es el Registro? ................................................................................................................ 24 ¿Porque usar el Registro .......................................................................................................... 24 ¿Qué es Backward Recovery? ................................................................................................. 25 Registro en diario y recuperación con el nivel 2 ....................................................................... 25 Nivel 2 Ejemplo de registro ………............................................................................................ 25 Nivel 2 Ejemplo de recuperacion .............................................................................................. 26 Definir el trabajo para usar el diario .......................................................................................... 27 Definir el nivel de Syncpoint ..................................................................................................... 27 Cree un procedimiento de recuperación de VSHARE ............................................................. 27 Creación de parámetros de recuperación de VSHARE ........................................................... 29 ¿Qué es Registro y Qué es No registrado? ............................................................................. 30 Nivel 2 Ejemplo de recuperación con un procedimiento ejecutado ......................................... 30 Ejemplo de recuperación sin un procedimiento ejecutado ....................................................... 31 Nivel 3: Sincronizacion explicita..................................................................................................... 32 ¿Qué es Tier 3? ....................................................................................................................... 32 ¿Qué tipo de trabajo debe usar Nivel 3? ................................................................................. 32 ¿Cómo se implementa el Nivel 3? ........................................................................................... 32 Determine si require VSHARE Journaling ............................................................................... 32 Modificar el programa para emitir puntos de sincronización o reversiones ............................. 32 Modo Batch-Only ..................................................................................................................... 33 Solicitar un punto de sincronización o una reversión .............................................................. 33 Ejemplo de solicitud de Syncpoint ........................................................................................... 34 Emisión de puntos de sincronización y reversiones a través de un programa de salida por lotes ….... 35 Registro de diario de punto de Syncpoint y Rollback ............................................................... 37 Crear un esquema de recuperaciones de aplicaciones ........................................................... 39 Nivel 3 Escenario de recuperación .......................................................................................... 39 Conjunto de datos de recuperación y ESDS ........................................................................... 39 Comparación de niveles de recuperación de VSHARE ............................................................. 40

Control en linea .............................................................................................................................. 41 Vision general .......................................................................................................................... 42 VSHARE menu principal .......................................................................................................... 43 Monitoreo dinámico de la actividad por lotes ........................................................................... 44 Detalles del trabajo activo ........................................................................................................ 47 Obtención de estadísticas de conjuntos de datos sobre trabajos activos ........................... 48 Definición ¿Qué trabajos pueden acceder al archive?............................................................ 51 Visualización de una lista de trabajos ya definidos ................................................................ 56 Revisión del historial de ejecuciones de trabajos anteriores .................................................. 57 Informacion detallada del historial .......................................................................................... 59

v

Table of Contents

Información detallada del historial del conjunto de datos ....................................................... 62 Definición de regiones CICS para VSHARE ........................................................................... 64 Listado de regiones CICS definidas ........................................................................................ 68

Rendimiento VSAM ...................................................................................................................... 70 Vision general .......................................................................................................................... 71 Conceptos ................................................................................................................................ 71 Medios de almacenamiento ..................................................................................................... 72 Acceso sincronico versus asincronico ..................................................................................... 73 Conceptos básicos I/O …......................................................................................................... 75 Mecánica de una VSAM KSDS I/O .......................................................................................... 76 Recursos locales compartidos versus no compartidos ............................................................ 77 ¿Cómo mejorar el rendimiento de VSAM?................................................................................ 78

Evite el intervalo de control y las divisiones del área de control......................................... 79 Reorganizar conjunto de datos con múltiples extensiones ................................................ 79 Difundir conjuntos de datos de gran acceso ...................................................................... 80 Usar índice y almacenamiento de datos en Buffering ........................................................ 80 Ajustar tamaños de intervalo de control de datos e índices ............................................... 80 Administrar conjuntos de datos VSAM de un cilindro ......................................................... 81 Analizar estadisticas de CICS End-of-Day ......................................................................... 81 Usar recursos compartidos VSAM Local ............................................................................ 82 Usar la sub tarea de CICS VSAM ...................................................................................... 84 Tenga cuidado con los conjuntos de datos que utiliza la opción compartir 3 o 4 .............. 84 Reducir el Programa I/O .................................................................................................... 84 Coloque archivos críticos en medio de almacenamiento más rápido ................................ 85

Instalacion ....................................................................................................................................... 86 Visión general de instalación de VSHARE en Z/OS ................................................................. 87 Preparación .............................................................................................................................. 87 Instalación de VSHARE desde Tape ....................................................................................... 88 Instalación de VSHARE desde una descarga Web ................................................................. 89

Descarga de conjunto de datos a una PC ......................................................................... 89 Transferir los conjuntos de datos de instalación ............................................................... 89 RECIBIR y RESTAURAR los conjuntos de datos ............................................................. 90

Instalar la clave del producto de software ................................................................................ 92 Instalación de claves de producto ..................................................................................... 93 Mensaje de autorización de productos .............................................................................. 93

Definir un conjunto de datos de control de VSHARE ............................................................... 94 Definición de conjunto de datos de Control ....................................................................... 95 Actualice el miembro del parámetro CSIVSBDS ............................................................... 95

Instalación ISC ......................................................................................................................... 96 Coloque la carga de Library en el DFHRPL ............................................................................. 96 Definiciones de entorno …….................................................................................................... 96

VTAM Definiciones .......................................................................................................... 100 CICS Definiciones ............................................................................................................ 101

Definir los trabajos y regions Eligibles CICS …...................................................................... 104

vi

Table of Contents

Instalar la interfaz de servicios de memoria cruzada ............................................................... 105 Instalación de componentes CMS Batch ........................................................................... 106 Instalación del componente CICS CMS ............................................................................ 107

Modificar el procedimiento de recuperación de archivos de Nivel 2 ........................................ 107 La facilidad de VSAM Open/Close Routing ............................................................................. 108

Introduccion ....................................................................................................................... 108 Instalacion de modulos VSAM Open/Close Routing Facility ............................................. 108 Eliminacion de VSAM Open/Close Routing Facility .......................................................... 109 Mensaje de Routing Facility .............................................................................................. 110

Activacion y desactivacion de VSHARE .................................................................................. 111 Desactivacio de archivos ......................................................................................................... 111 Seguridad de archivos ............................................................................................................. 111

Mensajes y Codigos ........................................................................................................................ 112 Mensajes FSIVSBAI ................................................................................................................. 113 Mensajes de mantenimiento en línea ....................................................................................... 113 Mensajes Batch ……................................................................................................................. 119 Mensajes Journal …….............................................................................................................. 126 Mensajes CMS (Servicios de Memoria Cruzada) ..................................................................... 141 Mensajes de servicios de presentación .................................................................................... 146 Mensajes de presentacion ........................................................................................................ 163 Mensajes CICS ......................................................................................................................... 172 Mensajes de Half Session ……….............................................................................................. 181 Mensajes del Administrador de Recursos ................................................................................. 185 Mensajes de servicios de Red LU 6.2 ....................................................................................... 188 Codigos Batch Abend …............................................................................................................ 193 Codigos CICS Abend ....................................................... ........................................................ 194

vii

Getting Started

Getting Started

Entorno Actual VSAM ha sido elegido por muchas empresas para ser el acceso a datos método

para sus aplicaciones informáticas. Su facilidad de uso, facilidad de comprensión

y eficiencia hacen que VSAM sea atractivo en un contexto más complicado

sistema de gestión de bases de datos. Desafortunadamente, VSAM proporciona

una funcionalidad y flexibilidad mínimas, lo que impone restricciones en los

sistemas que lo utilizan. La principal limitación de VSAM es la incapacidad de los

programas en línea y por lotes para actualizar el mismo Archivo VSAM

simultáneamente con integridad de datos completa. Con la corriente ambiente

de trabajo, esta restricción es inaceptable. Ascensores VSHARE esta restricción al

proporcionar aplicaciones VSAM simultáneas acceso al mismo archivo VSAM con

integridad de datos completa.

La restricción de actualización única de VSAM y la falta de funcionalidad

aumentan preocupaciones sobre cómo los sistemas VSAM encajan en un

procesamiento de datos a más largo plazo estrategia. Por ejemplo, ¿cómo

pueden estos VSAM críticos los sistemas encajan en la plataforma SAA, o cómo

se pueden utilizar en un entorno distribuido?

VSHARE proporciona una respuesta a estas preguntas ampliando Funcionalidad de VSAM. No solo permite el acceso simultáneo, sino rompe la barrera física de la CPU al permitir el acceso a cualquier Archivo VSAM dentro de una red SNA. VSHARE es la mejor solución para sus necesidades inmediatas y a largo plazo. Con una inversión tan grande en VSAM, la actualización única la restricción ya no se puede ignorar.

Con la dinámica de hoy entorno empresarial, la necesidad de un entorno VSAM compartido es obligatorio. Por ejemplo,

• Los departamentos de MIS han invertido millones de dólares y muchos miles de horas en aplicaciones VSAM CICS.

• Se requieren aplicaciones informáticas para proporcionar más disponibilidad en línea debido a la dinámica empresarial actual ambiente. Muchos objetivos corporativos incluyen las 24 horas en línea disponibilidad.

• Una mayor disponibilidad en línea conduce a mayores volúmenes procesado en un plazo cada vez menor de procesamiento por lotes.

• Las aplicaciones están tan restringidas en el procesamiento del ciclo por lotes que cualquier tipo de error durante un ciclo significa pérdida de disponibilidad en línea para los usuarios finales. Esto puede resultar en una pérdida de ingresos y un mal servicio.

• La mayor complejidad del procesamiento actual está obligando empresas para cuestionar la naturaleza estratégica de los sistemas VSAM.

2

Getting Started

El problema ¿Por qué dos trabajos por lotes no pueden actualizar el mismo archivo VSAM?

¿simultáneamente? La respuesta es simple: VSAM ofrece solo una programar la

capacidad de poseer un archivo para actualizar. Por lo tanto, cuando CICS está

activo, sus trabajos por lotes no se pueden ejecutar y cuando su ciclo por lotes

está en ejecución, los programas CICS no se pueden ejecutar. Esta restricción

básica crea el conocido conflicto de online versus batch.

La limitación de actualización única de VSAM ha provocado muchas restricciones en sus sistemas VSAM. El conflicto online versus batch ha provocado muchos problemas en el pasado:

• No hay disponibilidad en línea las 24 horas

• Ciclos de lotes largos que retrasan el siguiente día en línea

• Sin procesamiento por lotes durante el día en línea

• Reescrituras costosas para utilizar un sistema de gestión de bases de datos (DBMS)

• Problemas de integridad de lectura para informes por lotes

• Duplicación de los costos de DASD para respaldar bases de datos paralelas

• Mala respuesta en línea de las transacciones CICS en segundo plano.

• Sin acceso a archivos remotos

Soluciones pasadas Ha habido pocas opciones disponibles para manejar la presión de disponibilidad en línea o por lotes. Las soluciones fueron demasiado tiempo consumir, demasiado caro o demasiado difícil de mantener. La única actualización La restricción ha obligado a las empresas a diseñar sistemas VSAM basado en limitaciones técnicas más que en necesidades comerciales. por ejemplo, las empresas han intentado

• Vuelva a desarrollar la aplicación con un DBMS. Esta solución es el momento intensivo y costoso de implementar.

• Desarrollar transacciones CICS para realizar funciones por lotes. Esta da como resultado un tiempo de respuesta deficiente para el sistema en línea o incómodos requerimientos operacionales.

• Cree bases de datos en la sombra. Esto da como resultado un alto uso de DASD y problemas para mantener sincronizadas las bases de datos.

• Haga que el programa por lotes abra y cierre los archivos en línea para cortos periodos de tiempo. Esto provoca interrupciones en línea y no realmente una solución a largo plazo.

• Desarrolle software propio para acceder a archivos de forma remota.

3

Getting Started

¿Cómo funciona un DBMS VSHARE resuelve la restricción de actualización única preguntando un

¿Resolver el problema? simple pregunta: ¿Cómo resuelve un DBMS el problema de ¿acceso? El administrador de la base de datos está limitado por las mismas limitaciones como cualquier programa, pero hay una diferencia. El DBMS se ejecuta continuamente en su propio espacio de direcciones, recibiendo solicitudes de E / S desde trabajos por lotes o sistemas en línea. El DBMS, a su vez, realiza todas las E / S en nombre de esos programas. En esencia, el DBMS se convierte en el "policía de tráfico" para el acceso a la base de datos. Gestiona solicitudes de manera eficiente con la integridad completa de los datos. La siguiente figura muestra esto configuración.

Programa

A

Programa

B

Archivos

4

Getting Started

VSHARE es la VSHARE fue desarrollado con este mismo concepto en mente: ¿qué VSAM

Respuesta necesita es un policía de tráfico. Mirando el VSAM actual entorno, CICS es en

realidad la policía de tráfico de VSAM para programas. Centraliza todas las I/O online, garantizando datos completos integridad. VSHARE capitaliza la multiprogramación de CICS entorno para dar la misma capacidad de intercambio de archivos a lotes programas. Proporciona un vehículo transparente que intercepta todos VSAM solicita, comunica la solicitud al software VSHARE que se ejecuta en CICS y realiza las solicitudes de I/O en nombre del trabajo por lotes. De esta forma, cualquier número de programas por lotes o en línea, los programas pueden actualizar el mismo conjunto de archivos VSAM. CICS por lo tanto se convierte en el policía de tráfico para programas en línea y por lotes.

VSHARE proporciona dos rutas de comunicación entre lotes programas y CICS. El

primero es LU 6.2, que permite archivos remotos acceso. Si el trabajo por lotes y

CICS se ejecutan en la misma CPU, Se puede utilizar la interfaz de servicios de

memoria cruzada (CMS) de VSHARE para maximizar el rendimiento.

VSHARE resuelve la restricción de actualización única de VSAM de una manera

familiar de manera eficiente y técnicamente sólida. Su arquitectura abierta

fácilmente encaja en cualquier entorno de centro de datos.

CICS ha sido el policía de tráfico de VSAM para programas en línea para décadas.

VSHARE es un vehículo que brinda a los programas por lotes lo mismo ventajas.

La siguiente figura muestra cómo se conectan los programas CICS a través de

VSHARE.

5

Programa

A

Programa

B

Archivos

Getting Started

VSHARE’s VSHARE es una solución total para un entorno de intercambio de archivos VSAM.

Funciones Posee las cuatro cualidades importantes necesarias para ejecutar un VSAM

sistema en un entorno de uso compartido múltiple.

1. Integridad total de los datos

• Los trabajos en línea y por lotes pueden actualizar el mismo archivo

simultáneamente.

• Se proporciona integridad de datos completa porque todas las I/O están

centralizadas dentro de CICS.

2. Transparencia total

• No es necesario realizar cambios en la programación.

• No hay una nueva interfaz que aprender.

3. Recuperación total

VSHARE proporciona una solución escalonada para la recuperación. Todos los

cambios están registrados en un diario. En caso de fin anormal, todas las

actualizaciones se retrocedido a nivel de campo. De esta forma, ninguna

actualización realizada por se pierden otros programas por lotes o en línea.

4. Control total

• Usted determina qué trabajos pueden usar VSHARE.

• VSHARE encaja en su esquema de seguridad actual al interactuar con paquetes

de seguridad populares.

• Usted determina el número máximo de trabajos a los que puede acceder una

región CICS a la vez para un mejor control.

• VSHARE proporciona un control dinámico que le permite a) Suspender la

ejecución de un trabajo.

b) Reiniciar un trabajo suspendido.

c) Cancelar un trabajo.

d) Cambiar el número de solicitudes de I/O enviadas a CICS por un trabajo por

lotes.

• Puede ver el historial de ejecución de un trabajo utilizando VSHARE sistema en

línea.

6

Getting Started

Facilidad de uso VSHARE proporciona todas las funciones necesarias para ejecutar una Sistema

VSAM en un entorno de programación múltiple mientras se Fácil de instalar y

usar. Estas ventajas incluyen

• Transparencia total

• Sin modificaciones en el código fuente

• Sin recopilación del código actual

• No es necesario modificar el software del sistema

• No hay espacio de direcciones propietario para admitir

• Soporte para todos los lenguajes de programación

• No es necesario aprender una nueva interfaz: el programador de aplicaciones

códigos con los verbos familiares de I/O

• Conjuntos de datos VSHARE asignados dinámicamente

• Fácil instalación, activación y desactivación.

VSHARE es una solución, no solo una herramienta.

Acerca de este manual Este manual cubre toda la información necesaria para instalar y usar VSHARE.

También aborda los problemas que surgen al ejecutar programas en un entorno

compartido, como una nueva recuperación requisitos, la importancia del ajuste

de archivos VSAM y otros asuntos relacionados.

Novedades de versión 4 Se han realizado los siguientes cambios en las funciones de VSHARE para

lanzamiento 4:

• Las pantallas Mantenimiento del trabajo y Mantenimiento del sistema en la

instalación de mantenimiento en línea se ha rediseñado para más agrupar

lógicamente la información mostrada.

• La selección de APLICADOS por lotes ahora se controla con una opción y una

máscara de selección en el mantenimiento del sistema pantalla. Estas funciones

ayudan a filtrar los APLICADOS disponibles solo para aquellos que se aplican a

VSHARE.

• Se ha agregado una opción de control ROLLBACK para más cerca Gestionar

acciones durante el procesamiento de abortos de trabajos por lotes. La opción

ROLLBACK se puede controlar en el sistema o en el trabajo nivel.

7

Guía del Programador

Programmer’s Guide

Visión General VSHARE coloca poca carga en un programador de aplicaciones. Ahí no hay

nuevos comandos para aprender o modificaciones de programa realizar. De

hecho, no es necesario volver a compilar un programa existente para utilizar

VSHARE. VSHARE está detrás de escena durante ejecución del programa

interceptando todas las solicitudes de I/O. Por lo tanto, este El capítulo no

explica nuevas interfaces o reglas de sintaxis. Da un programador una

comprensión de VSHARE, cómo funciona y lo que se requiere para utilizar el

software.

Este capítulo incluye una discusión de los problemas relevantes que surgen en

un entorno compartido VSAM. Los problemas incluyen la recuperación

consideraciones, uso compartido de recursos, ajuste del rendimiento y

problemas determinación.

Arquitectura VSHARE VSHARE permite que varios programas actualicen el mismo archivo VSAM

simultáneamente. Para lograr esto, VSHARE intercepta el lote VSAM solicita y

envía las solicitudes a una región CICS. CICS luego actualiza el archivo en nombre

de los trabajos por lotes. Dando lote trabajos la capacidad de actualizar archivos

dentro de CICS, VSHARE hace CICS el administrador de datos VSAM.

VSHARE consta de tres componentes básicos. Consulte la figura abajo:

1. El primer componente se ejecuta en la dirección del programa por lotes.

espacio. Intercepta las solicitudes de I/O y las envía al segundo componente de

VSHARE que reside en CICS.

2. El segundo componente de VSHARE reside en la región CICS poseer los

archivos VSAM. Realiza todas las I/O de VSAM en nombre del trabajo por lotes.

Los primeros y segundos componentes comunicarse a través de VTAM o

servicios de memoria cruzada. VTAM se puede utilizar cuando el trabajo por

lotes y la región CICS residen en la misma CPU o en diferentes CPU. Cruzar

Memory Services proporciona un aumento de rendimiento, pero el lote El

trabajo y la región CICS deben estar en la misma CPU.

3. El tercer componente de VSHARE también reside en CICS región. Se compone

de una serie de programas de pantalla en línea. proporcionando las siguientes

funciones:

• Definir regiones CICS para utilizar VSHARE.

• Definir trabajos elegibles para usar VSHARE.

• Supervisar los trabajos activos que actualmente utilizan VSHARE.

• Suspender un trabajo que está actualmente activo.

• Reiniciar un trabajo previamente suspendido.

9


• Cancelar un trabajo.

• Reducir la cantidad de solicitudes de I/O que se envían al CICS región en caso

de una intensa actividad en línea.

• Revisar ejecuciones previas de trabajos por lotes.

Consulte el capítulo "Control en línea" en la página 41 para obtener detalles

sobre las funciones en línea.

Servicios de

memoria

cruzada

Programa de

aplicación

10


Una muestra VSHARE El siguiente es un ejemplo de ejecución de un programa usando VSHARE.

Ejecución Describe los pasos dados y ofrece una mejor comprensión del papel que

desempeña VSHARE. Consulte la figura abajo.

• El programa comienza a ejecutarse.

• El programa abre un archivo.

• Durante la primera apertura de un archivo, VSHARE obtiene el control y lee el

archivo de control de VSHARE para un registro de trabajo.

• Después de leer el registro del trabajo, VSHARE recupera el APPLID de la región

CICS que posee los archivos. Este CICS APPLID se encuentra en el registro de

trabajo.

• VSHARE lee el registro del sistema para la región CICS y recupera la

información necesaria para comunicarse con CICS.

• VSHARE se comunica con la región CICS e inicia la Componente en línea de

VSHARE. Si el trabajo está definido para usar Cross Servicios de memoria, VTAM

no se usa para el resto del trabajo ejecución.

• VSHARE envía el nombre del conjunto de datos al componente en línea a

determinar si el archivo está asignado a CICS.

• El componente en línea encuentra el archivo y envía la positiva respuesta al

componente del lote.

• El componente por lotes marca el archivo como un archivo interceptado y

devuelve un código de retorno de buena apertura al programa por lotes.

• Cualquier I/O relacionada con el archivo durante la ejecución del lote el

programa es interceptado por VSHARE y enviado al CICS. región. El componente

CICS de VSHARE realiza la I/O en nombre del programa por lotes y devuelve los

registros y / o información de estado.

• Cuando finaliza el programa por lotes, VSHARE detiene el CICS componente y

termina la comunicación con el CICS región.

11


Pasos para definir un Definir un trabajo o un conjunto de trabajos es sencillo. Definición de los

Trabajo a VSHARE conjuntos de datos elegibles se realizan a nivel de trabajo o grupo de trabajo que a nivel del conjunto de datos. Esto permite una activación rápida o desactivación de VSHARE sin afectar otros trabajos. Porque VSHARE no necesita modificaciones en el software del sistema, es fácil desactivado desde una aplicación.

Los siguientes son los pasos para definir un trabajo para VSHARE.

• Inicie sesión en la región CICS ejecutando VSHARE y ejecute el Sistema en línea VSHARE (transacción CICS 'TCC'). Selecciona el Opción de mantenimiento de trabajos del menú principal. Tu defines un trabajo o un conjunto de trabajos de la pantalla Mantenimiento de trabajos. Referirse a capítulo "Control en línea" en la página 41 para obtener detalles sobre el trabajo definición. El nombre definido puede ser el nombre completo del trabajo o cualquier número de caracteres a partir del primero. Por ejemplo, si un programador quiere que todos los trabajos que comienzan con PROD utilicen VSHARE, solo se define el nombre PROD.

• Concatenar la biblioteca de carga por lotes VSHARE al comienzo de la JOBLIB o STEPLIB.

• Envíe el trabajo por lotes.

Observe lo fácil que es implementar VSHARE. La desactivación puede ser logrado eliminando las bibliotecas de carga por lotes de VSHARE de la concatenación o eliminar la definición de trabajo a través de la Pantalla de mantenimiento de trabajos.

12


Memoria cruzada VSHARE proporciona dos formas en las que el trabajo por lotes puede

Servicios Versus comunicarse las solicitudes de VSAM a CICS. El primero es LU 6.2 o APPC. Esto es

LU 6.2 Protocolo de comunicaciones de IBM que permite que dos programas comunicarse entre sí a través de VTAM. La ventaja de usar VTAM es que los dos programas se pueden ubicar en cualquier lugar dentro de una red SNA. Al utilizar LU 6.2, el trabajo por lotes se puede ubicado en una CPU diferente a la región CICS. Por primera vez, una aplicación VSAM realmente se puede ejecutar en un entorno distribuido. Puede ejecutar un trabajo por lotes que actualice un archivo en un centro de datos en otro estado o país. Si utiliza PR / SM, el trabajo por lotes se puede ejecutándose en una imagen mientras la región CICS se está ejecutando en otra imagen.

El segundo vehículo de comunicaciones que puede usar VSHARE es Servicios de memoria cruzada (CMS). CMS es una comunicación más rápida vehículo que LU 6.2, pero hay una limitación. El trabajo por lotes y la región CICS debe ejecutarse en la misma imagen física de z / OS.

Usted especifica qué vehículo de comunicaciones usar en el trabajo Pantalla de mantenimiento. Si el trabajo pudiera enviarse ya sea la misma CPU o una diferente a la región CICS, definir el trabajo para utilizar CMS. Si VSHARE determina que el lote el trabajo y la región CICS están en diferentes CPU o imágenes PR / SM, utilizará automáticamente LU 6.2.

Not All the Files Have Durante la apertura de un archivo, VSHARE determina si el archivo es elegible

to Be Defined to CICS para ser interceptado. Compara el nombre del clúster contenido en la tarjeta DD con los archivos CICS VSAM asignados. Si un clúster es ubicado en la región CICS con el mismo nombre, el archivo es interceptado. Si no se encuentra una coincidencia, el archivo no se intercepta y VSAM actualiza el archivo directamente. VSHARE no requiere todos Archivos VSAM que se asignarán a CICS. La mezcla de ambos Los archivos interceptados y solo por lotes permiten una mayor flexibilidad.

VSHARE no requiere que el nombre de FCT CICS coincida con el DDNAME en el programa por lotes. VSHARE pregunta contra el CICS FCT en un nombre de clúster completo.

Acceder a Files en un Acceder a un archivo remoto es fácil. Primero, la región CICS remota la

CPU diferente propiedad del archivo remoto debe definirse para la propiedad del lote sistema. Esto se logra a través del sistema en línea pantalla de mantenimiento. Consulte el capítulo "Control en línea" en página 41 para obtener detalles sobre cómo definir una región CICS para VSHARE.

En segundo lugar, defina el trabajo para conectarse al sistema CICS remoto.

13


En tercer lugar, defina un conjunto de datos VSAM para el sistema de propiedad

de lotes con el mismo nombre y características de archivo. Definir el conjunto de

datos es necesario para que VSHARE pueda obtener algunas características del

conjunto de datos y para que la instalación pueda integrar el nombre del

conjunto de datos remoto en su sistema de seguridad. Ahora el archivo VSAM

remoto se puede accedido por cualquier trabajo elegible.

VSAM File seguridad No es necesario cambiar la configuración de seguridad de los archivos. VSHARE

encaja en su esquema de seguridad actual. Antes de que se intercepte cada

archivo, El componente por lotes de VSHARE interactúa con su sistema de

seguridad. Si el sistema de seguridad determina que el ID de usuario asociado

con el trabajo por lotes no tiene autoridad para actualizar o leer el archivo,

VSHARE termina el trabajo por lotes con un error U2000. Leyendo el VSHARE log,

puede aislar el conjunto de datos que causa el problema.

Ejecutar un programa Muchos programas por lotes de VSAM y flujos de ciclo se desarrollado con el

En un Shared procesamiento secuencial en mente porque solo una el programa podría tener

Environment un archivo para actualizarlo. Con esta restricción eliminada, el diseño del

programa debe reevaluarse para considerar el intercambio de archivos. Dado

que VSHARE proporciona un nivel de intercambio de archivos idéntico a un

sistema de gestión de bases de datos (DBMS), un programador debe ser

consciente de un nuevo conjunto de problemas que surgen al acceder a archivos

en un ambiente. Por ejemplo,

• ¿Qué otros programas se ejecutan mientras se ejecuta mi programa?

¿Cambiarán esos programas un campo que pueda afectar mi ¿programa? ¿Les

impactaré?

• ¿Mi código abre el potencial de un abrazo mortal? UNA El abrazo mortal es una

situación en la que un programa está esperando registrar que otro programa se

ha bloqueado y el otro programa está esperando en un registro que el primer

programa ha bloqueado. Ambos los programas están esperando unos a otros

para liberar un recurso, que nunca ocurre.

• Dado el diseño actual de la aplicación, ¿qué funciones pueden ejecutar

simultáneamente y qué funciones no se pueden ejecutar ¿simultáneamente?

• ¿Los registros que bloqueo con una lectura para actualizar afectarán

desempeño de otros programas? ¿Cuánto tiempo debe durar un registro?

bloqueado?

Estos problemas se tratan con mayor detalle en el capítulo Recuperación. en la

página 18.

14


Recuperación En los sistemas de lotes VSAM anteriores, siempre que un programa termina, los

archivos se eliminan, redefinen y restauran a un punto en el tiempo. Esta El tipo de recuperación no es práctico en un entorno compartido porque los archivos deben desconectarse. VSHARE ofrece muchas recuperaciones alternativas para recuperarse de una terminación anormal en un VSAM compartido ambiente. El capítulo de Recuperación en la página 18 analiza todas las opciones de recuperación en detalle.

Actuación VSHARE se diseñó pensando en el rendimiento. Un objetivo de VSHARE es para dar al personal de programación control total sobre actuación. Primero, si el sistema en línea necesita prioridad de rendimiento, la transacción en línea de VSHARE puede tener una prioridad más baja dentro de CICS. De esta manera, los programas en línea son atendidos por CICS antes de cualquier trabajo por lotes. En segundo lugar, los programadores del sistema pueden definir el número máximo de trabajos por lotes simultáneos que pueden acceder a los archivos de una región CICS. Al establecer el máximo, el sistema los programadores pueden anticipar el peor de los casos. De hecho, el número máximo de trabajos simultáneos se puede variar dinámicamente durante el día. En tercer lugar, la cantidad de solicitudes enviadas por un trabajo por lotes se puede reducir antes de la ejecución o dinámicamente durante la ejecución para un mejor control. Cuarto, la transacción en línea de VSHARE utiliza como pocos recursos CICS como sea posible. La mayor parte del tiempo es suspendido esperando que se complete la I/O. El impacto en el online el sistema será mínimo. Quinto, cuando no se accede a un trabajo por lotes archivos propiedad de la región CICS, VSHARE no tiene ningún impacto en su Región CICS. Cuando VSHARE no se está ejecutando, puede esperar mismo rendimiento en línea logrado hoy.

Ahora que los programas CICS y los programas por lotes pueden acceder al mismo archivo simultáneamente, la necesidad de ajustar un archivo VSAM en CICS se vuelve importante. Consulte el capítulo "Rendimiento de VSAM" en página 70 para obtener sugerencias sobre cómo mejorar el rendimiento de VSAM en su región CICS y dentro de su sistema de aplicaciones. Ahora eso CICS es el administrador de bases de datos de VSAM, debe ajustarse para ejecutarse como eficientemente como sea posible. Póngase en contacto con el grupo de desempeño interno o el personal de programación del sistema para sugerencias sobre mejores VSAM actuación. Cuanto mejor esté ajustada una región CICS para VSAM, VSHARE funcionará más rápido.

Problema ¿Qué sucede cuando un programa termina? ¿Cómo puedo determinar eso? el

Determinación problema fue un problema de aplicación o un problema con la conexión entre el trabajo por lotes y la región CICS? Estas Las preguntas son importantes y fáciles de responder. VSHARE proporciona mucha información sobre la conexión CICS por lotes. En el caso de una terminación anormal, utilice los siguientes pasos:

• Lea el registro de trabajos en el trabajo por lotes para determinar el código de terminación anormal. Si es un fin anormal del sistema, determine dónde ocurrió el fin anormal. Si se estaba en la aplicación, realiza la resolución normal del problema Técnicas, Además, lea el registro de CICS. VSHARE escribe mensajes a este registro cuando los trabajos comienzan y se completan, así como otros mensajes relacionados con los servicios de memoria cruzada.

15


• Si la terminación anormal fue una terminación anormal del usuario 2000, 1000

o 999, VSHARE aben por una razón específica. Lea el registro de VSHARE y el

Registro CICS para posibles mensajes de error. Todos los mensajes son

documentados en el capítulo Mensajes y códigos de este manual (página 125).

Los mensajes proporcionan toda la información necesaria para resolver el

problema.

• Si el mensaje apunta a un error de VTAM, consulte el registro de CICS para

determinar si el problema estaba en CICS o en el lote región. Además, busque los

códigos de detección que se muestran en el VTAM Capítulo Mensajes y códigos

para obtener más información. Puedes necesitar consultar a un programador de

sistemas ya que muchos de las explicaciones de los mensajes VTAM son crípticas.

• VSHARE contiene un seguimiento interno y un seguimiento auxiliar externo

instalaciones. En el caso de un problema, un volcado contendrá una tabla de

seguimiento interno. Además, se puede activar un seguimiento auxiliar a través

de las pantallas en línea para ayudar al soporte técnico de CSI en resolviendo

cualquier problema.

16


Soporte de Ensamblador Dado que Assembler permite el acceso directo a ciertos controles VSAM

áreas, algunas capacidades de ensamblador no son compatibles con

VSHARE. Las áreas de control de VSAM residen en CICS en lugar de por

lotes espacio de dirección. Las funciones de ensamblador que no son

compatibles son como sigue:

• Acceso a intervalos de control

• Acceso direccionado para archivos KSDS

• RPL encadenados

• Varias RPL para un archivo

• Operaciones AIXPUT

• Operaciones AIXGET

• Múltiples TCB

Claves Non-Unique Debido a las restricciones impuestas por CICS, la actualización no

Con índice alternativo exclusiva Los registros con clave de un archivo alternativo tienen algunas

Files limitaciones. Por un índice alternativo construido sobre un archivo KSDS,

un programa por lotes puede actualizar o elimine solo uno de los

registros duplicados. Después de la operación es realizado, la posición de

registro se establece en el siguiente registro con clave no el siguiente

registro duplicado. Para un índice alternativo construido sobre un

archivo ESDS, un programa por lotes puede actualizar solo el primer

duplicado grabar. Si se intenta actualizar cualquier otro registro

duplicado, se emite un código de retorno de 92 (X'5C ') que indica que un

get anterior para la actualización no se emitió antes de una reescritura.

Al actualizar nonunique archivos de índice alternativos con clave, intente

actualizar o eliminar registros contra el grupo base.

Resumen VSHARE coloca poca carga en el programador de aplicaciones. VSHARE

es verdaderamente transparente. El programador solo necesita

comprender cómo VSHARE usa CICS como la base de datos de VSAM

gerente y las implicaciones de ejecutar un programa en un ambiente.

VSHARE permite a los desarrolladores acercarse a un VSAM sistema

exactamente como un sistema que utiliza un DBMS. El resultado es

mayor flexibilidad y funcionalidad.

VSHARE también proporciona a los programadores de sistemas una

arquitectura familiar. VSHARE les da un control total, un familiar Entorno

de tuning e instalaciones de depuración para solucionar cualquier

problema.

17

Recuperación

Recovery

Visión General Este capítulo explica cómo cambia la recuperación en un VSAM compartido

entorno, y explica cómo recuperarse después de una terminación anormal con VSHARE.

VSHARE ofrece una solución escalonada para la recuperación, que proporciona tres posibles alternativas de recuperación. El que elijas depende de las características del programa por lotes.

Recuperación en Shared Sin un entorno compartido VSAM, se actualiza un programa por lotes

Environment Archivos VSAM al vacío. Ningún otro programa actualiza los archivos que posee por el programa por lotes debido a las opciones para compartir. En un compartido medio ambiente, este no es el caso. Ahora más de un programa puede actualice y lea el mismo archivo VSAM. ¿Cómo afecta esto ¿recuperación? Al responder a las siguientes preguntas, la diferencia de se puede ver la ejecución y recuperación en un entorno compartido.

Is Delete, Define, Repro En el pasado, la forma típica de recuperarse después de una terminación Practico para la recuperación? anormal era eliminar los archivos actualizados, redefinirlos y volver a cargarlos desde una copia de seguridad previamente tomada. ¿Es esto práctico en un VSAM compartido? ¿ambiente? La respuesta es no. Si más de un programa puede actualizar un archivo VSAM, eliminarlo requiere que el archivo se desconecte. Esto da como resultado la incapacidad de cualquier otro programa para acceder a los archivos. durante la recreación del archivo. Esto no es práctico en un entorno compartido y frustra el propósito de compartir V VSAM. Un nuevo esquema otro de lo que se requiere eliminar-definir- reproducir.

Who Else Can Update En un entorno compartido, los programadores deben tener en cuenta

Mi registro? considerar la posibilidad de que otros programas actualicen el mismo archivos, actualizando los mismos registros o actualizando los mismos campos. La posibilidad de que otro programa actualice el mismo archivo, registro o campo al mismo tiempo tiene un impacto directo en cómo

recuperarse después de un abend.

Cuanto tiempo debo bloquear No solo es necesario comprender quién puede actualizar el mismo

Un registro? VSAM, pero los programadores también deben ser sensibles a cuánto tiempo sus programas bloquean un registro. Si un programa actualiza todos los registros de un archivo crítico y nunca libera el control, todo el archivo se bloqueará al final del programa. Bloquear un archivo completo o una parte de un file anula todo el propósito de un entorno compartido. También tiene implicaciones de rendimiento porque otros programas esperan registros bloqueados.

What Happens If My Dado que no se pueden utilizar Eliminar, Definir y Reproducir, y Los

Program Abends? programas tienen que ser sensibles a los programas externos que actualizan el mismo archivo VSAM, ¿qué sucede en caso de terminación anormal? ¿Cómo puede un recuperar el archivo en un entorno VSAM compartido? VSHARE tiene la capacidad de recuperar un archivo en un entorno VSAM compartido. Para explicar las opciones de recuperación de VSHARE, una comprensión básica de cómo CICS maneja el bloqueo de registros y la integridad de los datos es necesaria.

19

Recovery

Bloqueo y Para proporcionar integridad a los datos, CICS bloquea cualquier registro

Liberación de Registros actualizado, eliminado, agregado, o leído para actualización por un programa

Dentro de CICS Al bloquear los registros, CICS garantiza la integridad de los datos al no permitir

que ningún otro programa acceder a los registros bloqueados. Los registros están bloqueados hasta que el programa notifica a CICS que es seguro desbloquear los registros para que otros accedan. El tiempo desde que se bloquea el primer registro hasta que el programa informa a CICS para que entregue los registros se llama Unidad Lógica of Work, o LUW.

Los registros se desbloquean mediante la emisión de un punto de sincronización para CICS. Cuando CICS recibe un punto de sincronismo, CICS libera el control exclusivo de todos los registros bloqueados por ese programa. Un punto de sincronización se puede emitir en dos formas. La primera es a través de una llamada directa al punto de sincronización a CICS desde el programa. La segunda forma es después de completar con éxito el programa. Cuando un programa termina normalmente, CICS asume que La unidad lógica de trabajo del programa está completa y CICS libera todos los registros actualizados.

La operación opuesta a un punto de sincronización es una reversión. Desde CICS bloquea todos los registros modificados durante una Unidad Lógica de Trabajo, un programa tiene la capacidad de retroceder los cambios emitiendo una reversión a CICS. Al igual que el punto de sincronización, una reversión se puede emitir de dos formas. El primero es mediante una llamada de retrotracción directa a CICS desde el programa. La segunda forma es después de que el programa finalice. Cuando CICS siente que un programa ha fallado, llama a una instalación llamada Transacción dinámica Backout o DTB. DTB retrocede o revierte todos los cambios realizados en todos los archivos VSAM durante una unidad lógica de trabajo.

Actualización de varios programas ¿Qué sucede cuando dos programas le piden a CICS que actualice el

En el mismo registro mismo? ¿grabar? CICS permite que el primer programa acceda y actualice el grabar. Dado que el registro se actualiza, CICS bloquea el registro hasta que la unidad lógica de trabajo del programa está completa. El segundo programa tiene que esperar hasta que el primer programa otorgue permiso a CICS para liberar y confirmar el cambio. En ese momento, el segundo programa puede acceder al registro y realizar su operación.

Si el primer programa no emite un punto de sincronización hasta que se completa ejecución, no habría ninguna exposición de integridad porque todos los. El trabajo del programa se completa antes de que se confirmen las actualizaciones. Si el programa termina anormalmente durante la ejecución, CICS retrocederá el cambia a través de DTB con un 100 por ciento de confianza de que ningún otro se realizaron cambios en los registros bloqueados.

Esta parece la solución ideal. Entonces, ¿por qué preocuparse por la recuperación? El efecto secundario de no publicar registros durante un período prolongado es el impacto en el rendimiento. Otros programas se ven obligados a esperar registros bloqueados hasta que se publiquen. Si un programa se actualiza cada grabar en un archivo durante un período de una hora, cualquier programa que desee actualizar un registro se vería obligado a esperar hasta una hora. Podría ser inaceptable que alguien espere una respuesta del terminar incluso durante dos minutos. Por esta razón, existe la necesidad de

20

programas para publicar registros de forma regular. Pero cuando los

registros son publicados, otros programas pueden actualizar los registros

publicados antes del programa finaliza la ejecución. ¿Qué pasa ahora si el

programa abends? ¿Cómo se eliminarán los cambios sin afectar a otros

programas que pueden haber actualizado los registros?

Tres de VSHARE’s El conflicto entre la facilidad de implementar la recuperación mediante

Niveles de recuperación el bloqueo todos los registros actualizados por un programa hasta que se

completa normalmente, y la necesidad práctica de publicar registros a

intervalos regulares para razones de rendimiento, no se recupera de

forma compartida medio ambiente sencillo. VSHARE ofrece tres

alternativas a la recuperación. Te dan la flexibilidad de elegir el adecuado

para tu situación. El método que elija depende de cuánto tiempo el

programa se ejecuta, cuántos registros se actualizan y quién se ve

afectado por registros bloqueados. El primero, el Nivel 1, ofrece la

posibilidad de bloquear todos los registros de todo el trabajo, mientras

que los dos segundos, Niveles 2 y 3, proporcionan una forma de emitir

puntos de sincronización de forma regular.

El nivel 1 es el más sencillo de implementar, mientras que el nivel 3

requiere algo de trabajo, pero puede ser necesario en función de su

carga de trabajo actual. Con este enfoque escalonado, puede

implementar la mayor parte de su sistema rápidamente mientras

proporciona una capacidad de recuperación total.

El resto de este capítulo revisa cada método de recuperación. Referir

también a “Comparación de niveles de recuperación de VSHARE” en la

página 44.

Nivel 3

Sincronización

Explicita

Nivel 2

Sincronización

Implícita

Nivel 1

No

Sincronización

21

Recovery

Nivel 1: No

Sincronización

¿Qué es el nivel 1? La recuperación de nivel 1 permite a CICS bloquear todos los registros actualizados todo un paso de trabajo. Esto se logra al no emitir un syncpoint hasta que el paso se complete normalmente. Al no soltar ningunos registros actualizados hasta que el trabajo se complete normalmente, no hay peligro de cualquier otro programa que cambie los registros actualizados. 100 por ciento se proporciona integridad de datos.

¿Qué tipo de trabajo debería Cualquier trabajo puede usar el Nivel 1 en teoría, pero hay un límite Usar el nivel 1? práctico para qué trabajos deberían utilizarlo. Dado que no se proporcionan puntos de sincronismo, CICS Bloquear todos los registros actualizados y no permitirá que ningún otro programa acceder a los registros bloqueados hasta que finalice el programa. Por tanto, si un trabajo se ejecuta durante una hora actualizando muchos registros en un archivo crítico, otros los programas que acceden a cualquiera de los registros esperarán hasta una hora. En un entorno de producción en línea, esto puede no ser deseable para razones de rendimiento. El nivel 1 es utilizado por programas o programas de larga duración que no bloquean registros críticos.

¿Cómo se implementa el nivel 1? La implementación de Nivel 1 es fácil. Cuando un trabajo se define mediante el Pantalla de mantenimiento de trabajos, el campo llamado NIVEL DE SINCRONIZACIÓN se establece en cero. Este campo está resaltado en la siguiente figura. Referirse a capítulo “Control en línea” en la página 41 para obtener más detalles. Un valor de cero en este campo significa que VSHARE no emite ningún punto de sincronización hasta el trabajo se completa normalmente. Aparte de definir el trabajo, hay nada más que hacer.

22

Recovery

¿Cómo se recuperan los archivos Recovered Dado que el Nivel 1 se basa en CICS para bloquear los registros por

Después de un Abend? completo, también en CICS para anular los cambios en caso de una

terminación anormal. Cuando un VSHARE detecta una terminación

anormal, emite una reversión a CICS. Esta rollback informa a CICS que

anule todos los cambios antes de lanzar los registros a otros. De esta

manera, no hay necesidad de recuperación. Es totalmente automático.

Después de aislar el motivo de la terminación anormal y resuelto, vuelva

a ejecutar el trabajo al comienzo del paso erróneo.

23

Recovery

Nivel 2: Sincronización

Implícita

¿Qué es el nivel 2? La recuperación de nivel 2 proporciona la capacidad de sincronización implícita. Esta significa que VSHARE emite puntos de sincronización en nombre del trabajo por lotes en intervalos predefinidos sin ninguna modificación del programa. Emitiendo puntos de sincronización, los registros actualizados por el trabajo se liberan, lo que permite otros programas para acceder a ellos. Para realizar un seguimiento de todos los cambios realizado por el programa con fines de recuperación, el Nivel 2 proporciona un sistema de registro y recuperación. En caso de fin anormal, Se ejecuta el trabajo de recuperación de VSHARE que anula todos los cambios realizado por el programa por lotes. El trabajo de recuperación se ejecuta mientras otros los programas siguen accediendo a los archivos. La recuperación de VSHARE retrocede solo los bytes o campos en los registros cambiados por el programa. Esta significa que cualquier otro campo modificado en estos registros por otros los programas no se ven afectados.

¿Qué tipo de trabajo debería El nivel 2 es adecuado para trabajos de larga duración que actualizan registros

Usar el nivel 2? críticos y archivos. VSHARE emite puntos de sincronización periódicamente, por lo que no hay peligro de bloquear programas durante un largo período de tiempo. Desde VSHARE realiza un seguimiento de todos los cambios, hay una m manera de anular los cambios en caso de fin anormal. Cuando dos programas actualizan el mismo registro, hay dos escenarios posibles. La primera es cuando ambos actualizar el mismo registro, pero diferentes campos, y el segundo es cuando ambos actualizan el mismo registro y los mismos campos. El nivel 2 solo es adecuado para el primer escenario, donde dos programas actualizan el m mismo registro, pero campos diferentes. Dado que la recuperación de VSHARE recupera los bytes en el registro que cambia, otros campos actualizados en el registro no son afectado. Al igual que el Nivel 1, no se requieren modificaciones del programa. Pero dado que la recuperación anula los cambios en un campo, otras modificaciones realizadas en el mismo campo entre la publicación del record y la terminación anormal del programa se perdería. En este caso, Tier 3 se debe utilizar la recuperación.

¿Cómo se implementa el nivel 2? La implementación de Nivel 2 es sencilla ya que no es necesario realizar cualquier modificación del programa. Dado que el Nivel 2 usa VSHARE función de registro en diario, es necesario revisar rápidamente el registro en diario básico y principios de recuperación.

¿Qué es Journaling? El Journaling es el proceso de registrar todos los cambios realizados en los archivos por un programa. Una revista debe contener suficiente información para revertir cambios. Esto incluye una lista de todos los registros agregados,

todos los registros eliminados, y todos los registros actualizados.

Porqué usar Journaling Dado que el Nivel 2 emite puntos de sincronización con CICS, CICS libera los registros y permite que otros programas actualicen los mismos registros. Para esto razón, es necesario realizar un seguimiento de todas las modificaciones realizado por un programa por lotes. Llevar un diario es la forma de realizar un seguimiento de los cambios.

24

Recovery

¿Qué es Backward La recuperación hacia atrás es el proceso de revertir todos los cambios Recuperación? realizados en archivos. El conjunto de datos de la revista proporciona toda la información necesaria para lograr esto. Los registros agregados se pueden eliminar, los registros eliminados se pueden agregado, y los registros actualizados pueden recuperar su contenido original.

Registro y recuperación VSHARE contiene su propio sistema de registro en diario para la Con nivel 2 recuperación de Nivel 2. VSHARE registra todos los cambios de archivo realizados por VSHARE en un diario expediente. El diario es automático y transparente para la aplicación programa.

Las solicitudes de cambio se registran por diario de la misma manera que CICS realiza un seguimiento de cambios en sus revistas, con una excepción importante: para actualizar solicitudes, tanto el registro de pre-actualización (antes de la imagen) como el post-actualización registro (después de la imagen) se registran. Tanto con el antes como con Las imágenes posteriores guardadas, los bytes específicos cambiados son identificables. VSHARE también contiene su propio sistema de recuperación. Los registros agregados son eliminados y se agregan registros eliminados. Las actualizaciones se recuperan en el nivel de campo en lugar de a nivel de registro.

La recuperación de VSHARE el sistema compara la imagen de antes y después del archivo de diario y restaura solo los bytes que han cambiado. El archivo debe tomarse fuera de línea a CICS para fines de recuperación, de modo que, si el trabajo de recuperación falla, no tiene que intentar recuperarse por encima de otra recuperación trabajo.

Nivel 2 Ejemplo de Journaling El siguiente ejemplo muestra los pasos tomados durante el registro en diario. proceso. Refiérase a la figura de abajo.

• Comienza a ejecutarse una secuencia de trabajos que contiene programas de aplicación A y B.

• El programa A comienza a ejecutarse, activando así la interfaz VSHARE.

• VSHARE activa el procesamiento del diario. Dado que el programa A es el primer programa en la secuencia de trabajos, el sistema de registro por diario crea, asigna y cataloga dinámicamente un nuevo conjunto de datos de diario.

• A medida que el programa A realiza solicitudes de I/O, VSHARE llama al sistema de diario para registrar cada adición, cambio o eliminación. El sistema de diario escribe registros de diario para cada uno de estas peticiones.

• El programa A finaliza el procesamiento. VSHARE termina el registro en diario actividad y el archivo de diario se cierra.

• El programa B comienza a procesarse, activando así la interfaz de VSHARE.

• Una vez más, VSHARE activa el procesamiento del diario. Desde un El conjunto de datos de diario ya está catalogado para esta secuencia de trabajos, el sistema de registro por diario asigna dinámicamente el diario existente conjunto de datos con MOD para disposición.

25

Recovery

• Al igual que con el programa A, las solicitudes de I/O se registran en el diario conjunto de datos como el programa B los hace.

• El programa B finaliza el procesamiento y el archivo de diario se cierra una vez de nuevo. En este punto, el archivo de diario contiene todos los cambios realizados por los programas A y B, y la secuencia de trabajos finaliza.

Nivel 2 Ejemplo Recovery El siguiente ejemplo describe los pasos del proceso de recuperación.

• Suponga que el programa B del trabajo de ejemplo anterior está a la mitad a través de su procesamiento y terminaciones anormales. En este punto, el archivo de diario contiene un registro de todos los cambios realizados por el programa A más todos cambios por el programa B antes de la terminación anormal. Se determina que esos cambios deben eliminarse de los archivos antes de que el trabajo pueda ser reiniciado.

• La secuencia de trabajos de recuperación de VSHARE se inicia utilizando el diario conjunto de datos.

• El sistema de recuperación procesa el archivo de diario hacia atrás usando VSHARE para eliminar los cambios. El archivo de diario completo es procesado, eliminando así todos los cambios realizados por los programas A y B.

• Los archivos se restauran a su estado original, lo que permite la nueva ejecución. del trabajo. También sería posible retroceder solo los cambios del programa B y luego reinicie el trabajo al comienzo del programa B. Esta opción es discutida más adelante en este capítulo.

Programa

A

Programa

A

26

Recovery

Definir el trabajo a utilizar El journal es opcional con VSHARE. Puede habilitar el diario en el trabajo o Journaling el nivel de grupo de trabajo. ¿Coloque una Y en el JOURNAL UPDATES? campo en la pantalla Mantenimiento del trabajo. Consulte la figura abajo. Las características del conjunto de datos del archivo de diario se pueden modificar en esta pantalla también. Consulte la sección " “Definición de los trabajos Puede acceder a los archivos” en la página 56 para obtener detalles sobre cómo definir un trabajo. a VSHARE.

Definir el nivle Syncpoint Para que VSHARE pueda saber cuándo emitir un punto de sincronización implícito, un El nivel del punto de sincronización debe definirse en la pantalla Mantenimiento del trabajo. El valor SYNC LEVEL le dice a VSHARE cuántos bloqueos hay permitido antes de que se tome un punto de sincronización. Refiérase a la figura de abajo.

Tenga en cuenta que VSHARE puede emitir un punto de sincronización solo cuando no hay lectura excepcional para actualización. Si emitió un punto de sincronización cuando una lectura para la actualización fue pendiente, el registro leído para la actualización sería publicado. Como resultado, no estaría bajo el control del lote. programa. Por lo tanto, si se lee un registro en un archivo para actualizarlo en el comienzo de un trabajo y no se actualiza hasta el final del trabajo, VSHARE no puede emitir un punto de sincronización. Si los mensajes en el registro de VSHARE informarle que se están realizando bloqueos extensos y usted definió el trabajo con sincronización implícita, esta situación puede ser la razón por la cual los bloqueos se mantienen después de que se alcanza el umbral del punto de sincronización.

Cree una recuperación de VSHARE Un miembro de recuperación de muestra llamado RECOVER está en Procedimiento VSHARE biblioteca de instalación. Este JCL se personaliza durante la instalación proceso. Comuníquese con la persona responsable de instalar VSHARE para el nombre del miembro de JCL o el procedimiento creado para la recuperación. Si no se ha creado un miembro personalizado, copie el miembro RECUPERAR de la biblioteca de instalación de VSHARE.

27

Recovery

El procedimiento de recuperación consta de tres pasos de trabajo.

Consulte la tabla abajo.

Job

Paso Función

1 Este paso elimina y redefine un VSAM ESDS conjunto de datos de recuperación.

2 Este paso carga el diario secuencial creado durante el trabajo por lotes en el conjunto de datos VSAM creado en el paso 1 del trabajo. El nombre de archivo del diario secuencial se basa en tres artículos: • El calificador de alto nivel es el nombre definido en la pantalla Mantenimiento del sistema para CICS región. • El segundo calificador del nombre es el nombre del trabajo ejecutado. • El último calificador es el literal "ITIJRNL". por ejemplo, si un calificador de alto nivel para todos los trabajos comunicarse con la región CICS de producción se definió como PROD.CICS, y un trabajo llamado Se ejecutó PRODUPDT, el conjunto de datos del diario para este trabajo sería ‘PROD.CICS.PRODUPDT.ITIJRNL’

Este journal se carga en un conjunto de datos ESDS para que el registro de diario se puede leer al revés. Todos los cambios tienen retroceder de la más reciente a la menos reciente.

3 El tercer paso ejecuta el programa de recuperación VSHARE para retroceder los cambios basados en la recuperación comandos.

El programa de recuperación acepta parámetros que controlan la

recuperación. proceso. Estos parámetros se pasan al programa de

recuperación como tarjetas de control en el conjunto de datos SYSIN. La

siguiente sección explica el formato y significado de estos parámetros de

recuperación.

28

Recovery

Creación de VSHARE Recovery El proceso de recuperación siempre comienza con los registros de diario Parámetros del último paso de trabajo ejecutado y trabaja hacia atrás a través de los registros de pasos que utilizaron VSHARE. Las tarjetas de control para la recuperación el programa se utiliza para especificar cuándo debe detenerse el proceso de recuperación. Los parámetros identifican el ultimo paso del trabajo para el que se realizará la recuperación. realizado. Los cambios se pueden anular para el último paso registrado o para cualquier número de pasos anteriores en el trabajo que utilizó VSHARE, dependiendo de los requisitos de la aplicación.

Las tarjetas de control tienen 80 caracteres cada una y son leídas por la

recuperación. programa del conjunto de datos SYSIN. Cada tarjeta de

control puede contener un parámetro de recuperación.

El formato de cada parámetro se describe en la siguiente tabla.

Parámetro Descripción JOBNAME=XXXXXXXX Este es el nombre del trabajo de la tarjeta de trabajo. No es

necesario si el JOBNUM = se utiliza el parámetro. Es útil si los archivos de diario están combinados a medida que se ejecutan los trabajos.

JOBNUM=NNNN Este es el número de trabajo de JES asignado por el sistema operativo. Eso no es necesario si se utiliza el parámetro JOBNAME =. Es útil en los casos en que un diario contiene registros para varios trabajos ejecuciones.

PGMSTEP=XXXXXXXX Esta es la etiqueta de la tarjeta JCL EXEC PGM = xxxxxxxx. Por ejemplo, STEP100 se utilizaría como parámetro PGMSTEP para el siguiente:

//STEP100 EXEC PGM=YOURPGM,COND=(0,NE) PROCSTEP=XXXXXXXX Esta es la etiqueta de la tarjeta EXEC PROC = xxxxxxxx JCL. Por

ejemplo, PROC100 se utilizaría como PROCSTEP parámetro para lo siguiente:

//PROC100 EXEC PROC=YOURPROC,UNIT1=SYSDA RECOVERALL Este parámetro hace que el programa de recuperación procese la

archivo de diario completo. No se aceptan otras tarjetas de parámetros con éste porque la combinación sería inconsistente.

* comment Si el primer carácter de una tarjeta de control es un asterisco (*), la línea se trata como un comentario.

Siempre que se ejecuta un paso de trabajo mediante VSHARE, se

muestra un registro de mensajes. incluido en el SYSOUT para el paso.

Todo el parámetro de recuperación los valores del paso se imprimen

como un mensaje en el registro. Esto proporciona un medio fácil para

identificar qué valores usar y para verificar que son correctos. Tenga en

cuenta que si los parámetros especificados no encontrado durante el

proceso de recuperación, todo el archivo de diario estar procesado.

29

Recovery

¿Qué es Journaled y Qué Los diarios de VSHARE cambian solo para los archivos propiedad de CICS No esta Journaled? región y controlado por VSHARE. Por ejemplo, si un trabajo se actualiza un archivo propiedad de CICS y otro que no es propiedad de CICS (un “lote solo” archivo), VSHARE publica solo las actualizaciones de los a archivos de propiedad de CICS expediente. El archivo "solo por lotes" se actualiza directamente mediante el trabajo por lotes y se no controlado por VSHARE. Por lo tanto, no se realiza ningún registro en diario para estos archivos, y la recuperación debe realizarse mediante métodos alternativos.

Nivel 2 ejemplo de Recovery El trabajo PRODJOB1 contiene dos procesos. El primer proceso, Con un procedimiento Executed etiquetado JOB1001, ejecuta el procedimiento PROC1. El segundo proceso, JOB1002, ejecuta el procedimiento PROC2. PROC1 (JOB1001) es consta de tres pasos — STEP001 a STEP003 — y PROC2 consta de cuatro pasos: STEP001 a STEP004. Suponga que PRODJOB1 se envía y termina en STEP003 de PROC2. Después de analizar la terminación anormal, se determina reiniciar el trabajo en el PASO002 de PROC1.

Para anular todos los cambios realizados a través de VSHARE, excepto aquellos antes del punto de reinicio, son necesarios los siguientes pasos: 1. Agregue las declaraciones DD al RECOVER JCL para todos los archivos siendo recuperado. 2. Agregue las siguientes tarjetas de control al conjunto de datos SYSIN:

//SYSIN DD * * Back out changes through STEP002 of PROC1 JOBNAME=PRODJOB1 PROCSTEP=JOB1001 PGMSTEP=STEP002 /*

3. Ejecute el trabajo de recuperación para restaurar los cambios.

4. Recupere los archivos no procesados por VSHARE.

5. Haga una copia de seguridad del archivo de diario secuencial si lo desea.

6. Elimine el archivo de diario secuencial. Si no lo hace, el siguiente La ejecución del trabajo agregará cambios a la misma secuencia diario. Acumulación de registros de diario para varios trabajos Las ejecuciones pueden hacer que la recuperación sea confusa y también aumenta la probabilidad de quedarse sin espacio en el archivo de diario. Un nuevo Se recomienda el archivo para cada ejecución de un trabajo.

7. Vuelva a ejecutar el trabajo reiniciando STEP002 en PROC1.

El trabajo de recuperación se puede ejecutar con la región CICS activada o abajo.

30

Recovery

Ejemplo de recuperación sin En este ejemplo, hay un trabajo ADDCUST que contiene tres pasos. El Un procedimiento ejecutado primer paso ejecuta PROG1, el segundo paso ejecuta PROG2, y el tercero ejecuta PROG3. Suponga que se envía ADDCUST y termina en STEP3. Después de algunos análisis, se decide reiniciar. el trabajo en STEP3. Para reiniciar el trabajo en este paso, los siguientes pasos están tomados:

1. Agregue los conjuntos de datos VSAM actualizados en el PASO 3 a RECUPERAR JCL. 2. Agregue las siguientes tarjetas de control al conjunto de datos SYSIN: //SYSIN DD * * * Back out changes through STEP3 of ADDCUST * JOBNAME=ADDCUST PGMSTEP=STEP3 /*

3. Ejecute el trabajo RECUPERAR.

4. Realice una copia de seguridad del diario secuencial ADDCUST si es

necesario.

5. Elimine el diario secuencial.

6. Reinicie ADDCUST en el PASO 3.

31

Recovery

Nivel 3: Sincronización

Explicita

¿Qué es el nivel 3? La recuperación de nivel 3 proporciona la capacidad para que un programa llame directamente VSHARE para emitir un punto de sincronización o una reversión. A diferencia de Tier 2, Tier 3 los trabajos actualizan los campos que otros programas pueden actualizar después de un punto de sincronización se toma. Para proporcionar la integridad completa de los datos, el programa debe tener total control sobre su unidad lógica de trabajo, y debe llamar directamente a CICS para emitir puntos de sincronización. Los puntos de sincronización implícitos del Nivel 2 no proporcionan para la sincronización exacta en puntos específicos de la ejecución de un programa. En otros entornos compartidos como un DBMS, el DBMS proporciona la capacidad de emitir un punto de sincronización desde dentro de un programa de aplicación. La recuperación de nivel 3 proporciona esta misma capacidad. Una interfaz es siempre que permita que un programa llame a VSHARE directamente.

Cuando dos programas actualizan el mismo campo en el mismo registro, es importante nunca retroceder un cambio después de que se haya dado un punto de sincronización debido a la posibilidad de anular los cambios de otro programa. Por eso es importante el control total de la sincronización. Con el Nivel 3, un El programa debe modificarse para emitir puntos de sincronización y una aplicación Se necesita un procedimiento de recuperación para comenzar a procesar después del último bien syncpoint. Entonces no hay peligro de anular las actualizaciones realizadas por otros programas.

¿Qué tipo de trabajo debería El nivel 3 es adecuado para trabajos de larga duración que actualizan Usar Nivel 3? registros críticos y archivos. Además, estos trabajos actualizan los mismos archivos que otros programas pueden actualizar. A diferencia de los niveles 1 y 2, se requieren modificaciones del programa. Como cualquier entorno compartido, los programas de nivel 3 requieren algo de trabajo para proporcionar integridad completa de los datos.

¿Cómo se implementa el nivel 3? El primer requisito es asegurarse de que el campo SYNC LEVEL en la pantalla de Definiciones de trabajo se establece en cero; de lo contrario, implícito se invoca la sincronización. La sincronización implícita no es deseable ya que el programa perdería el control sobre la actividad del punto de sincronismo.

Determine si VSHARE Si no hay forma de determinar dónde estaba el último punto de sincronización

Se require llevar Journaling correcto tomadas durante la recuperación, active el registro en diario de VSHARE. VSHARE registra cualquier punto de sincronización que se tome. El nivel 3 de la aplicación El procedimiento de recuperación puede leer el diario al revés para encontrar el último punto de sincronización tomado, que puede determinar dónde continuar con el procesamiento. Si la aplicación tiene otro mecanismo, como un archivo secuencial, que puede determinar la última buena unidad lógica de trabajo, VSHARE el registro por diario no es necesario y debe desactivarse para los trabajos de nivel 3.

Modificar el programa para emitir VSHARE proporciona un módulo de interfaz de programa de aplicación que

Los Syncpoints o Rollbacks puede ser llamado desde un programa de usuario para solicitar un punto de sincronismo o una reversión del punto de sincronización. Esta interfaz se proporciona para programadores que quieren definir sus propias unidades lógicas de trabajo. Solicitando un syncpoint o una reversión usando la interfaz hace que VSHARE transacción asociada con el programa por lotes para ejecutar la

32

Recovery

respectiva solicitud bajo CICS. La solicitud se ejecutará

independientemente de si se mantienen bloqueos de archivos. Por

ejemplo, si el programa lee un registro para actualizarlo y

posteriormente solicita un syncpoint, se perderá el bloqueo de

actualización de lectura en el registro. Es la responsabilidad del

programador de asegurarse de que los archivos estén en el estado

esperado estado antes de emitir solicitudes de punto de sincronización o

reversión.

Modo Batch-Only Los programas que usan servicios de punto de sincronización aún se

pueden ejecutar en lotes modo (es decir, sin la interfaz VSHARE). En este

caso, las solicitudes de punto de sincronización o reversión no tienen

ningún efecto en la ejecución del programa.

Para programas que se ejecutan en modo solo por lotes al eliminar la

Biblioteca de carga VSHARE desde JOBLIB o STEPLIB concatenación, el

módulo BIMVSBAI deberá moverse a uno de las otras bibliotecas en la

concatenación. Esto es necesario para programas que se vinculan

dinámicamente a la interfaz de la aplicación (es decir, utilizan la opción

COBOL DYNAM).

Solicitor un Syncpoint o Para solicitar un punto de sincronización o una reversión, el programa

Rollback configura una solicitud lista de parámetros y luego llama al programa de

aplicación VSHARE módulo de interfaz BIMVSBAI. A su regreso de

BIMVSBAI, el programa de aplicación debe interrogar el área de código

de retorno para asegúrese de que la solicitud se haya realizado

correctamente. Si un error crítico se encuentra durante el procesamiento

del punto de sincronización o la reversión solicitud, se emitirá un fin

anormal y no se devolverá el control a el programa de aplicación. La lista

y solicitud de parámetros COBOL los literales de código se incluyen como

cuadernos CCONPRM y CCONVAL en la biblioteca de instalación,

CICS.CONN. INSTALL.

33

Recovery

Ejemplo de solicitud de Syncpoint

WORKING-STORAGE SECTION. (A) COPY CCONPRM. COPY CCONVAL. PROCEDURE DIVISION. (B) MOVE CCON-PV-SYNCPOINT TO CCON-REQUEST. (C) CALL CCON-API-PGM USING CICS-CONN-PARM-LIST. (D) IF CCON-MSG-RETURNED DISPLAY CCON-MSG-TEXT. (E) IF CCON-STATUS-OK DISPLAY 'SYNCPOINT SUCCESSFULLY EXECUTED' ELSE DISPLAY 'SYNCPOINT FAILED' GO TO ABEND.

Las líneas con letras se explican en la siguiente tabla.

Línea Función A Copie la lista de parámetros y los valores de la lista de

parámetros en programa de almacenamiento de trabajo. Consulte el JCL a continuación.

B Establezca el tipo de solicitud en punto de sincronización.

C Llame al programa BIMVSBAI, pasando la lista de parámetros.

D Muestra los mensajes devueltos.

E Verifique si la solicitud se completó correctamente. por errores críticos, la interfaz VSHARE termina el proceso inmediatamente sin devolver el control a la aplicación programa.

34

Recovery

********************************************************** * FSI-VSHARE - THE CICS CONNECTION * * * * CCONPRM - APPLICATION INTERFACE COBOL PARAMETER LIST * ********************************************************** 01 CICS-CONN-PARM-LIST. 05 CCON-VERSION PIC X(04) VALUE 'R112'. 05 CCON-REQUEST PIC X(04). 88 CCON-REQ-SYNCPOINT VALUE 'SYNC'. 88 CCON-REQ-ROLLBACK VALUE 'ROLL'. 05 CCON-STATUS PIC X(02). 88 CCON-STATUS-OK VALUE '00'. 88 CCON-STATUS-FAILED VALUE '08'. 05 CCON-OPTION PIC X(02). 05 CCON-MESSAGE-AREA. 10 CCON-MSG-IND PIC X(01). 88 CCON-MSG-RETURNED VALUE 'Y'. 88 CCON-MSG-NOT-RETURNED VALUE 'N'. 10 CCON-MSG-TEXT PIC X(132). 05 CCON-PARM-END. 10 CCONN-PARM-END CON PIC X(04) VALUE 'PEND'. * * END OF CCONPRM

********************************************************** * FSI-VSHARE - THE CICS CONNECTION * * CCONVAL - APPLICATION INTERFACE PAARMETER VALUES * ********************************************************** 01 CICS-CONN-API-VALUES. 05 CCON-API-PGM PIC X(08) VALUE 'BIMVSBAI'. 05 CCON-API-PARM-VALUES. 10 CCON-PV-SYNCPOINT PIC X(04) VALUE 'SYNC'. 10 CCON-PV-ROLLBACK PIC X(04) VALUE 'ROLL'. * * END OF CCONVAL

Issuing Syncpoints and En el caso de que el código fuente del programa por lotes no se pueda

Rollbacks Through a Batch modificar para emitir puntos de sincronización y retrocesos, directamente se

Exit Program puede notificar a VSHARE para que emita un punto de sincronización o retroceso

mediante un programa de salida por lotes escrito por el usuario. Después de

cada I/O de VSAM, VSHARE se vincula a un programa de salida llamado

BIMVSBEX. Una lista de parámetros como la que se muestra en la siguiente

figura se pasa al programa de salida del usuario, BIMVSBEX. Cuando el programa

de salida devuelve el control a VSHARE, VSHARE interroga la lista de parámetros

y emite un punto de sincronización o una reversión según la configuración de la

solicitud.

35

Recovery

EXITPRMC Copybook For The Batch Exit Program

01 CICS-CONN-EXIT-LIST. 05 CCON-IDENT PIC X(04). 05 CCON-REQUEST PIC X(04). 88 CCON-REQ-SYNCPOINT VALUE 'SYNC'. 88 CCON-REQ-ROLLBACK VALUE 'ROLL'. 05 CCON-LAST-IO-REQUEST PIC S9(4) COMP. 88 CCON-GET VALUE +0. 88 CCON-PUT VALUE +1. 88 CCON-CHECK VALUE +2. 88 CCON-POINT VALUE +3. 88 CCON-END VALUE +4. 88 CCON-ERASE VALUE +5. 05 CCON-DDNAME PIC X(08). 05 CCON-RPL-FEEDBACK-CODE PIC X(03). 05 CCON-PROGRAM-NAME PIC X(08). 05 CCON-JOB-NAME PIC X(08). 05 CCON-STEP-NAME PIC X(08). 05 CCON-JOB-NUMBER PIC X(05). 05 CCON-DATASET-NAME PIC X(44).

El libro de copias EXITPRMC proporciona el diseño de la lista de parámetros de salida por lotes de VSHARE. Este cuaderno se encuentra en la biblioteca de instalación. Puede copiarlo en los programas de su aplicación. La versión Assembler se llama EXITPRMA.

La salida de usuario se puede escribir en COBOL 2.4 o Assembler. En la siguiente figura se muestra un ejemplo de programa. Al ingresar, al programa de salida se le pasa una lista de parámetros con el nombre del trabajo, la solicitud VSAM recién ejecutada, el código de retroalimentación VSAM, el nombre del programa que solicita la solicitud VSAM, el nombre DD que se está procesando, el nombre del paso, el nombre del clúster, y el número de trabajo. El programa de salida puede entonces interrogar la información y determinar si se necesita un punto de sincronización o una reversión. Si se necesita un punto de sincronización, mueva el literal "SYNC" al campo de solicitud. Si se necesita una reversión, mueva el literal "ROLL" al campo de solicitud. Si no se requiere ninguna acción, mueva espacios al campo de solicitud. Una vez establecido el tipo de solicitud, salga del programa. Entonces, VSHARE tomará el control y realizará la solicitud correspondiente.

El programa de salida puede realizar cualquier tipo de procesamiento excepto emitir una operación VSAM. La emisión de una solicitud VSAM dará como resultado resultados impredecibles. Además, VSHARE carga dinámicamente el programa de salida en el momento de la ejecución; por lo tanto, cada aplicación puede tener su propia rutina de salida si el programa llamado BIMVSBEX se coloca al comienzo de la concatenación de las bibliotecas de carga. Si no existe un programa de salida, VSHARE ignorará el proceso de salida. Por último, no llame al programa BIMVSBAI utilizado para emitir puntos de sincronización y reversiones de BIMVSBEX porque los resultados serán

36

Recovery

impredecible. El programa de salida por lotes fue diseñado para recibir el control

después de cada I/O de VSAM y antes de que el control vuelva al programa de

aplicación. Si llama a BIMVSBAI, VSHARE se invocará al principio, lo que dará

como resultado una llamada recursiva.

Ejemplo de programa de salida por lotes TCCBTEXT

*************************************************************** * L I N K A G E S E C T I O N * *************************************************************** LINKAGE SECTION. COPY EXITPRMC. PROCEDURE DIVISION USING CICS-CONN-EXIT-LIST. *************************************************************** * M A I N L I N E * *************************************************************** * 1) CHECK RETURN CODE. IF IT IS NOT GOOD, EXIT. * * 2) CHECK THE JOB NAME, IF IT IS PROD001 CONTINUE ELSE * * EXIT. * * 3) CHECK THE DDNAME, IF IT IS FROM THE DATASET DD01, * * CONTINUE SEARCHING. * * 4) CHECK THE VSAM REQUEST, IF IT IS A ERASE THEN REQ A * * SYNCPOINT. * *************************************************************** IF CCON-RPL-FEEDBACK-CODE = LOW-VALUES IF CCON-JOB-NAME = WS-PROD001 IF CCON-DDNAME = WS-DD01 IF CCON-ERASE MOVE WS-SYNCPOINT TO CCON-REQUEST ELSE NEXT SENTENCE ELSE NEXT SENTENCE ELSE NEXT SENTENCE ELSE NEXT SENTENCE. GOBACK.

El JCL anterior es un ejemplo de un programa de salida. Al programa se le pasa una lista de parámetros en la entrada. Al ingresar, verifica para asegurarse de que la operación VSAM fue exitosa. Luego solicita un punto de sincronización si el conjunto de datos DD01 emitió un borrado en STEP001 del trabajo PROD001.

Syncpoint and Rollback Las solicitudes de punto de sincronización y reversión se registran en el archivo Journal Records de diario de VSHARE asociado con el trabajo por lotes. Los puntos de sincronización implícitos o automáticos también se registran en el diario. Estos se proporcionan para usuarios que escriben programas de recuperación personalizados. Consulte el JCL a continuación.

37

Recovery

*********************************************************************** * * * * JOURNAL CONTROL - JOURNAL RECORD LAYOUT * * * *********************************************************************** * JCRL DSECT ****************************************************************** * H E A D E R * ************************************************************************ JCRLHDR EQU * START OF HEADER JCRLHDRL DS H HEADER LENGTH * * FIXED AREA (RESERVED) * * *...FIXED PREFIX AREA DS CL49 RESERVED JCRLDSN DS CL44 BASE CLUSTER NAME DS CL45 RESERVED * * CONTROL INFORMATION * JCRLCNTL EQU * START OF CONTROL INFO *...STOP KEY INFO JCRLJNUM DS CL5 JOBNUMBER JCRLJOB DS CL8 JOBNAME JCRLPROC DS CL8 EXEC PROC STEPNAME JCRLPGM DS CL8 EXEC PGM= STEPNAME DS CL3 RESERVED *...RECORD IDENTIFICATION JCRLDDN DS CL8 FILE DDNAME JCRLDATE DS PL4 00YYDDD+ (JULIAN SIGNED) JCRLTIME DS CL4 HHMMSSTH (TENTHS,HUNDRETTHS) JCRLSEQ DS PL4 SEQUENCE NUMBER * JCRLTYPE DS C DATA TYPE JCRLADD EQU C'1' 1=ADD JCRLDEL EQU C'2' 2=DEL JCRLREAD EQU C'3' 3=READ JCRLREW EQU C'4' 4=REWRITE JCRLINIT EQU C'5' 5=STEP INITIATION RECORD JCRLTERM EQU C'6' 6=STEP TERMINATION RECORD JCRLSYNU EQU C'7' 7=USER SYNCPOINT RECORD JCRLSYNA EQU C'8' 8=USER SYNCPOINT RECORD JCRLROLU EQU C'9' 9=USER ROLLBACK RECORD JCRLROLA EQU C'A' A=AUTO ROLLBACK RECORD JCRLSTAT DS X STATUS BYTE JCRLABND EQU X'80' 1... .... JOURNALED DURING ABEND JCRLRKP DS H FCT RELATIVE KEY POSITION JCRLKEYL DS H FCT KEYLENGTH JCRLRECL DS H FCT RECLENGTH JCRLDATL DS H DATA LENGTH *********************************************************************** * DATA * *********************************************************************** JCRLDATA EQU * DATA PORTION

38

Recovery

Crear un esquema de Ahora que los programas emiten los puntos de sincronización directamente, es

recuperación de aplicaciones necesario determinar cómo comenzar después de la última Unidad Lógica de

Trabajo en buen estado en caso de un fin anormal. La clave para hacer esto es encontrar primero una manera de determinar el último LUW bueno. El diario de VSHARE se puede usar leyéndolo hacia atrás para obtener el último LUW bueno, o se puede usar un archivo secuencial creado a partir del programa. Finalmente, un programa debe poder iniciarse donde se detuvo a través de una función como reinicio en el punto de control o mediante un método personalizado. Esta parte de la recuperación de Nivel 3 es la que requiere más tiempo de diseño.

Nivel 3 Recovery Scenario Los siguientes eventos ocurren durante la ejecución de un programa de Nivel 3,

durante una terminación anormal y durante la recuperación después de una terminación anormal.

• El programa A es un sistema de entrada de pedidos. Se utiliza para actualizar un archivo de inventario. Cada pedido puede requerir entre 5 y 15 actualizaciones de la base de datos VSAM. Se determinó que una Unidad Lógica de Trabajo sería una orden; por lo tanto, los puntos de sincronización se colocaron en el código después de que se procesó un pedido. El programa A comienza a ejecutarse. Después de cada pedido completado, el programa escribe información en un archivo secuencial con toda la información necesaria para comenzar a procesar después del último pedido en buen estado procesado.

• El programa A emite puntos de sincronización durante la ejecución después de cada comando. El programa A comienza a procesar la orden 245 y actualiza 5 de los 11 registros necesarios para esa orden. Desafortunadamente, un campo de cantidad en un registro en el archivo de entrada secuencial contiene datos no numéricos. El programa termina con un código de fin anormal 0C7.

• VSHARE detecta la terminación anormal y emite una reversión a CICS. CICS, a su vez, revierte las cinco actualizaciones realizadas en la Unidad lógica de trabajo actual. En este punto, no quedan pedidos sin terminar. Todos los pedidos del 1 al 244 se han completado y están archivados. VSHARE finaliza.

• El programador de la aplicación realiza un análisis de errores y encuentra los datos incorrectos en el archivo de entrada. Los datos son fijos.

• Se inicia un trabajo de restablecimiento de entrada de pedidos. Dado que se

encuentra el archivo de recuperación secuencial, el programa de entrada de pedidos lee el archivo, reposiciona todos los archivos para continuar con el procesamiento y comienza a procesar el pedido 245. El trabajo se completa correctamente.

Recovery and ESDS Los archivos ESDS son archivos VSAM secuenciales a los que se accede mediante

Datasets una dirección de byte relativa o de forma secuencial de principio a fin. Los

registros que se agregan se colocan al final del conjunto de datos, similar a los conjuntos de datos QSAM. Una restricción con los conjuntos de datos ESDS es que los registros agregados no se pueden eliminar. Esta restricción tiene implicaciones con respecto a la recuperación de archivos ESDS en un entorno compartido.

39

Recovery

En el Nivel 1, CICS DTB no restituye los registros agregados a un conjunto de datos ESDS. En el Nivel 2, el programa de recuperación VSHARE no puede eliminar registros agregados a un conjunto de datos ESDS. Se escribe un mensaje de error que indica que se intentó eliminar un conjunto de datos ESDS para cada intento de eliminación. En el Nivel 3, CICS confirma un registro agregado incluso antes de que se escriba un punto de sincronización.

Esta limitación en ESDS debe tenerse en cuenta al revisar los procedimientos de recuperación. Una alternativa es convertir el conjunto de datos ESDS en un conjunto de datos KSDS si puede ser necesario deshacer las adiciones.

Comparación de La siguiente tabla resume las diferencias clave entre los niveles de

VSHARE Recovery recuperación de VSHARE y las definiciones requeridas para cada uno.

Tiers

Nivel Best For. Sync Level

Se requiere el registro en VSHARE Journaling?

Se requiere codificación de la aplicación?

Syncpoints Issued?1

Método de recuperación de fin normal

1 • Trabajos cortos • Datos no críticos

0 No No No Automático: VSHARE solicita una reversión

2 • Trabajos largos • Datos críticos • No se comparte el control de los campos de destino

1–999 Si2 No Si3 El usuario ejecuta un trabajo de recuperación de VSHARE

3 • Trabajos largos • Datos críticos • Control sobre los campos de destino compartidos con otras aplicaciones

04 No5 Si6 Si7 El usuario ejecuta un trabajo de recuperación de VSHARE si se usa el registro en diario de VSHARE

1 VSHARE siempre emite una solicitud de punto de sincronización en EOJ si un trabajo se completa normalmente. Si ocurre una terminación anormal, el método de recuperación apropiado se indica en la última columna. 2 No se recomienda establecer el registro en diario de VSHARE en NO porque limita los métodos de recuperación de VSHARE a usar solo el LUW más reciente. 3 VSHARE emite una solicitud de punto de sincronización automática cada vez que se alcanza un nivel de sincronización. 4 Para el nivel 3, el nivel de sincronización debe establecerse en cero. 5 Se recomienda el registro en diario de VSHARE, pero no es obligatorio si se utiliza un método de recuperación alternativo. 6 La aplicación requiere lógica para llamar a una función VSHARE para ejecutar un punto de sincronización y / o una solicitud de reversión. 7 Se emite una solicitud de punto de sincronización cuando la lógica del programa llama a CSIVSBAI con una solicitud SYNC.

40

Control en línea

Online Control

Visión general VSHARE está diseñado para ser fácil de usar al mismo tiempo que proporciona

toda la funcionalidad necesaria para que las aplicaciones críticas se ejecuten en

un entorno VSAM compartido. Una de las características importantes que se

requieren en un entorno compartido es la capacidad de tener un control total.

Este capítulo cubre los programas en línea proporcionados con VSHARE. Es a

través de estos programas que se proporciona gran parte del control. El control

se implementa a través de definiciones estáticas establecidas antes de la

ejecución de un trabajo o por medios dinámicos mientras se ejecuta el trabajo.

Incluso con todas las funciones que ofrece VSHARE, las pantallas son fáciles de

usar y de entender. No hay parámetros crípticos que aprender ni demasiados

parámetros que complican la implementación.

Los programas en línea de VSHARE proporcionan cuatro funciones básicas: 1.

Monitorear trabajos activos usando VSHARE.

2. Defina trabajos que puedan utilizar VSHARE. 3. Examine las estadísticas sobre

trabajos ejecutados anteriormente.

4. Defina todas las regiones CICS que ejecutan VSHARE.

Cada función se explica en detalle a lo largo de esta sección. En cada descripción

se incluye un resumen funcional y una descripción de todos los campos y claves

de atención.

Para ejecutar el sistema en línea de VSHARE, inicie sesión en la región CICS

donde VSHARE se está ejecutando e ingrese la transacción TCC. La primera

pantalla que se muestra es el menú principal de VSHARE.

Todas las pantallas de VSHARE tienen el mismo formato. El encabezado de cada

pantalla contiene el CICS APPLID, el programa VSHARE que genera la pantalla, la

fecha, la hora y el título de la pantalla. La línea 23 es la línea de mensajes donde

se muestran todos los mensajes de error y mensajes informativos. Para obtener

una explicación de las claves de atención válidas, lea la línea del mensaje para

obtener más detalles.

42

Online Control

VSHARE Menú principal

El programa de pantalla en línea de VSHARE se ejecuta ingresando el ID de

transacción TCC. El menú principal le permite seleccionar una de las cuatro

funciones básicas:

1. PANTALLA DE TRABAJOS ACTIVOS

a) Ver estadísticas de los trabajos en ejecución.

b) Cancele un trabajo usando VSHARE. c) Suspender temporalmente un trabajo.

d) Reiniciar un trabajo previamente suspendido.

e) Cambie el número de I/Os que un trabajo por lotes envía a CICS.

2. MANTENIMIENTO DEL TRABAJO

a) Defina un nuevo trabajo elegible para usar VSHARE y sus opciones de proceso.

b) Cambiar las opciones de procesamiento de un trabajo previamente definido

para usar VSHARE.

c) Eliminar un trabajo previamente definido para usar VSHARE.

43

Online Control

3. HISTORIAL DE TRABAJOS

a) Ver estadísticas de trabajos ejecutados anteriormente en el nivel de paso o

conjunto de datos.

4. MANTENIMIENTO DEL SISTEMA

a) Agregue la definición de una nueva región CICS que ejecute VSHARE.

b) Cambiar las opciones de proceso predeterminadas de una región CICS

previamente definida para usar VSHARE.

c) Eliminar una región del uso de VSHARE.

Monitoreo dinámico de

la actividad Batch

44

Online Control

La pantalla de resumen de trabajos activos muestra todos los trabajos

que se están ejecutando actualmente utilizando VSHARE en orden

cronológico. Esta pantalla permite cambiar dinámicamente ciertas

opciones de procesamiento y le permite monitorear el entorno

compartido de VSAM. Cada línea de detalle de la pantalla muestra

información sobre cada trabajo.

Si necesita información más detallada sobre un trabajo, escriba una S en

el campo de comando junto al trabajo y presione Entrar. Se muestra una

pantalla de detalles del trabajo. Desde esa pantalla, un trabajo se puede

detener, reiniciar, cancelar o modificar con una nueva velocidad de I/O.

Estas operaciones se logran ingresando el comando apropiado junto al

nombre del trabajo. Para actualizar la pantalla, presione Entrar. A

medida que se completa cada paso, la línea de detalle de ese trabajo

desaparece. Cada campo se explica a continuación.

Field Descripción

CMD Cada línea de detalle tiene un campo de comando. Los siguientes valores son posibles y se puede ingresar más de un comando en una pantalla. Por ejemplo, colocar una X en todos los campos de CMD detiene todos los trabajos que se muestran en la pantalla. S Muestra una nueva pantalla de detalles del trabajo. Esta pantalla muestra información más detallada sobre el paso del trabajo seleccionado. X Envía una solicitud a VSHARE para detener o reiniciar un trabajo según su estado actual. R Permite al operador cambiar la tasa de solicitud de EIO por lotes. Al escribir una R y presionar Enter, el campo de tasa de solicitud queda desprotegido, lo que permite cambiar el valor. C Envíe una solicitud a VSHARE para cancelar un trabajo por lotes.

JOB NAME El nombre del trabajo tal como aparece en la tarjeta TRABAJO.

STEP NAME El nombre del paso tal como aparece en la tarjeta EXEC en el JCL de ejecución.

REQS/MIN El número máximo de solicitudes de I/O enviadas por minuto a la región CICS. Cuando coloque una R en el campo de comando, presione Entrar, el campo está desprotegido. Ingrese cualquier número que represente la nueva tarifa. Si se ingresa cero, el trabajo por lotes envía solicitudes lo más rápido posible.

REGION El APPLID de la región CICS que ejecuta VSHARE. No es necesariamente el mismo que el nombre del trabajo CICS.

45

Online Control

Field Descripción

START TIME

La hora de inicio del paso mostrado.

VSAM REQUESTS

La cantidad total de solicitudes VSAM procesadas en el paso del trabajo.

STATUS El estado del trabajo en ejecución. Este mensaje cambia a medida que se ingresan comandos desde esta pantalla. Los valores posibles son ACTIVO El trabajo por lotes está activo sin comandos pendientes. DETENIDO El trabajo por lotes se ha suspendido. El trabajo mantiene este estado hasta que se ingresa otro comando. INICIO PEND El inicio del trabajo está pendiente. C PENDIENTE Se ingresó una cancelación, pero el trabajo por lotes no ha recibido la solicitud. ACTUALIZAR REQ Este mensaje se muestra después de colocar una R en la línea de comando. En este punto, el campo de tasa de solicitud está desprotegido. REQ UPDATE Se ha introducido la nueva tasa de solicitud, pero el trabajo por lotes no ha procesado la nueva tasa.

ACCESS TYPE

El tipo de comunicaciones que se utilizan para comunicarse entre los trabajos por lotes y la región CICS. CMS es el tipo de comunicaciones más rápido, pero solo se puede utilizar cuando tanto el trabajo por lotes como la región CICS se ejecutan en la misma CPU. Los valores válidos son LU62 LU 6.2 está siendo usado CMS Se está utilizando la interfaz de servicios de memoria cruzada

46

Online Control

Attention Keys

Enter Procese los comandos ingresados o actualice la pantalla con

información actualizada.

Clear Volver al menú principal.

PF7 Desplazarse hacia atrás por la lista de trabajos activos.

PF8 Desplazarse hacia adelante por la lista de trabajos activos.

PF9 Muestra el comienzo de la lista de trabajos activos.

Detalles del trabajo activo

Según la selección que realizó en la pantalla de resumen de trabajos

activos, esta pantalla muestra más detalles, incluida una lista de

DDNAME abiertos actualmente. Al seleccionar uno de los DDNAME, se

muestra una pantalla detallada que brinda información específica del

conjunto de datos. La información que se muestra se explica a

continuación.

Field Descripción

Nombre del trabajo

El nombre del trabajo tal como aparece en la tarjeta JOB del JCL por lotes.

Nombre del paso

El nombre del paso tal como aparece en la tarjeta EXEC del JCL del lote.

Nombre CICS

El CICS APPLID de la región donde se ejecuta VSHARE.

Número JES El número de trabajo asignado al trabajo por lotes por el sistema operativo.

# OF El número de registros eliminados en el actual

47

Field Descripción

DELETES paso. Al presionar Enter, se actualiza el número.

# OF STARTS El número de inicios solicitados por el paso actual. Al presionar Enter, se actualiza el número.

# OF ENDS El número de solicitudes finales. Al presionar Enter, se actualiza el número.

Attention Keys

Enter Actualizar las estadísticas de I/O de VSAM.

Clear Volver a la pantalla detallada del trabajo activo. Si se

seleccionó más de un DDNAME en la pantalla detallada

del trabajo activo anterior, muestre las estadísticas del

DDNAME elegido.

PF7 Desplazarse hacia atrás por la lista DDNAME.

PF8 Desplácese hacia adelante por la lista DDNAME.

PF9 Muestra el comienzo de la lista DDNAME.

Obtaining Dataset Statistics

on Active Jobs

48

Online Control

La pantalla Estadísticas del conjunto de datos muestra información sobre el

conjunto de datos elegido en la pantalla detallada Trabajos activos. Junto con la

cantidad de operaciones VSAM realizadas en el conjunto de datos, también se

muestran las características del conjunto de datos. Si se ingresa a esta o

cualquier otra pantalla de trabajo activo y finaliza el paso de trabajo mostrado, la

información correspondiente a ese paso desaparece. La información se puede

recuperar si el trabajo se definió para recopilar el historial. Consulte la sección

“Información detallada del historial” en la página 59 o la sección “Definición de

qué trabajos pueden acceder a los archivos” en la página 51 para obtener más

detalles. La información que se muestra se explica a continuación.

Field Descripción

DDNAME El DDNAME del conjunto de datos tal como aparece en el JCL por lotes.

FCTNAME El nombre CICS FCT del conjunto de datos. No es necesario que el nombre DDNAME y el FCT coincidan. VSHARE coincide con los dos por el nombre del clúster VSAM.

CLUSTER NAME

El nombre del clúster del conjunto de datos. Este nombre coincide con el nombre en el JCL así como con el nombre en la tabla CICS FCT. Si no se encuentra una coincidencia, VSHARE considera el archivo como un archivo solo por lotes y le da el control a VSAM.

ACCESS El acceso permitido por CICS contra este archivo. Se muestran cinco letras posibles. Si no se muestra alguna de las letras (a continuación), la operación correspondiente no está permitida contra el conjunto de datos. R — se permite el acceso de lectura. U — se permite el acceso a la actualización. B — se permite la navegación. A — se permite agregar nuevos registros. D — Se permite borrar registros.

LSR POOL El número del grupo de LSR donde se define el conjunto de datos. Consulte el capítulo “Rendimiento de VSAM” en la página 70 para obtener detalles sobre LSR en CICS. Si se usa NSR, el valor es cero.

STRINGS El número de cadenas definidas para este conjunto de datos. Una cadena equivale a una operación de I/O en un momento dado. Por ejemplo, si un conjunto de datos se define para tener cinco cadenas, se permiten cinco operaciones diferentes en el archivo a la vez.

49

Online Control

Field Descripción

# OF READS El número de lecturas realizadas contra el conjunto de datos en el paso actual.

# OF ADDS El número de adiciones realizadas contra el conjunto de datos en el paso actual.

# OF UPDATES El número de actualizaciones realizadas contra el conjunto de datos en el paso actual.

# OF DELETES El número de registros eliminados en el paso actual.

# OF STARTS El número de inicios solicitados por el paso actual.

# OF ENDS El número de solicitudes finales.

Attention Keys

Enter Actualizar las estadísticas de I/O de VSAM para el archivo.

Clear Volver a la pantalla detallada de trabajos activos. Si se seleccionó

más de un DDNAME en la pantalla detallada anterior de trabajos

activos, muestre las estadísticas del DDNAME elegido.

50

Online Control

Definición de qué trabajos

pueden acceder a los archivos

La pantalla Mantenimiento de trabajos (opción 2 en el menú principal) le permite definir los trabajos o grupos de trabajos que pueden acceder al sistema CICS que posee los archivos VSAM compartidos. La pantalla le permite controlar qué trabajos pueden acceder a los archivos VSAM. Este proceso de definición le permite personalizar las opciones de procesamiento de trabajos, como el tipo de recuperación o el tipo de comunicación que se utilizará.

Cada campo de los grupos Información del trabajo e Información del diario tiene valores predeterminados de región CICS. Los valores predeterminados se definen en la pantalla Definición del sistema y se muestran cuando se muestra la pantalla por primera vez.

Si se anula un campo predeterminado, el campo se resalta. Si borra el valor de anulación, se mostrará el valor predeterminado del sistema. Cuando se cambian los valores predeterminados en la pantalla de definición del sistema, todos los trabajos definidos para esa región CICS obtienen el valor predeterminado modificado. De esta manera, no tiene que cambiar trabajos individuales cuando se necesita un cambio global. Si se olvida el nombre del trabajo, ingrese un comando junto con el carácter inicial del nombre del trabajo. VSHARE muestra todos los trabajos comenzando con el carácter ingresado. Al seleccionar un trabajo de la lista, se vuelve a mostrar la pantalla Mantenimiento del trabajo. Los campos de la pantalla Mantenimiento del trabajo se explican a continuación.

51

Online Control

Field/Grupo Descripción

FUNCTION: Determina qué función realizar. Los valores posibles son A—agregar un nuevo trabajo a VSHARE. C—cambiar los valores de un trabajo definido previamente. D—eliminar un trabajo del archivo de control de VSHARE.

JOB NAME: El nombre parcial o completo de los trabajos elegibles para usar VSHARE. El nombre del trabajo definido para VSHARE no tiene que ser el nombre completo. Se puede definir cualquier número de caracteres que comiencen con el primer carácter. Por ejemplo, si una instalación quiere que todos los trabajos que comienzan con "BT" utilicen VSHARE, el nombre del trabajo se define como BT. De esta manera, solo se debe definir una entrada en lugar de cada nombre de trabajo que comience con BT.

Grupo de INFORMACIÓN DE TRABAJO

CICS REGION El CICS APPLID donde se define VSHARE y donde se definen todos los archivos utilizados por el trabajo.

TRANID Este campo le dice a VSHARE qué ID de transacción ejecutar cuando se establece una conexión con CICS. Se trata de una anulación del valor predeterminado del sistema. El cambio de TRANID permite que diferentes aplicaciones dentro de la misma región CICS tengan sus propios ID de transacción de VSHARE para fines de contracargo. Si cada aplicación tiene su propio TRANID, se puede cobrar un cargo de CICS por I/Os por lotes utilizando los sistemas de cargo en línea actuales. Asegúrese de que cada TRANID ejecute el programa VSHARE CSIVSC00. Consulte la sección “Definiciones PCT” en la página 102 para obtener más detalles.

SYNC LEVEL Este campo controla la función de punto de sincronización implícita (automática). Es el número de colas de archivos CICS permitidas antes de que VSHARE intente un punto de sincronización. Este es solo un nivel de umbral. Antes de que VSHARE pueda emitir un punto de sincronización, ninguno de los archivos propiedad del programa por lotes puede tener una actualización pendiente de lectura. Es importante no retener un recurso durante mucho tiempo. Un valor de cero desactiva la función de punto de sincronización automático. Ingrese cero si el programa de aplicación usa la función de punto de sincronización implícita (recuperación de Nivel 3) o si no se usa ningún punto de sincronización (recuperación de Nivel 1).

52

Online Control


REQS/MINUTE El número máximo de solicitudes de I/O que el trabajo por lotes puede enviar a la región CICS por minuto. Si se ingresa cero, el trabajo por lotes envía las solicitudes lo más rápido posible. VSHARE da prioridad a los programas CICS. Por lo tanto, si es necesario dar servicio a un programa CICS, CICS da servicio al programa en línea antes que al trabajo por lotes. Por este motivo, este campo necesita un valor distinto de cero solo cuando la región CICS está muy activa.

ACCESS TYPE Este es el tipo de comunicación que se utiliza para enviar las solicitudes de VSAM entre el trabajo por lotes y la transacción VSHARE. Los valores posibles son LU62 (para comunicaciones LU 6.2) y CMS (para servicios de memoria cruzada). Puede utilizar CMS solo cuando el trabajo por lotes y la región CICS se estén ejecutando en el mismo sistema z/OS. Puede utilizar LU 6.2 cuando el trabajo por lotes y CICS están en el mismo sistema z/OS o en sistemas z/OS diferentes. Si elige CMS y VSHARE determina que el trabajo por lotes y la región CICS están en diferentes sistemas z/OS, VSHARE utiliza automáticamente LU 6.2. CMS es el tipo de acceso más rápido, por lo que si un trabajo por lotes se ejecuta en la misma CPU que la región CICS, elija CMS.

Grupo de INFORMACIÓN HISTÓRICA

RECORD? Los valores posibles son Y o N. Este campo le dice a VSHARE si debe mantener información histórica sobre la ejecución del trabajo.

GENERATIONS El número de generaciones de historia a conservar. Hay un registro histórico en el archivo de control de VSHARE por paso. Por ejemplo, si se ingresan cinco generaciones y hay seis pasos en el trabajo, habrá 30 registros en el archivo de control.

JOURNAL INFORMATION Grupo

JOURNAL UPDATES? Una Y le dice a VSHARE que registre todos los cambios realizados durante la ejecución del trabajo. Al especificar Y, todos los cambios se pueden restituir si se produce una terminación anormal. Una N le dice a VSHARE que no registre los cambios en los archivos. Consulte el capítulo “Recuperación” en la página 18 para obtener detalles sobre el registro en diario de VSHARE.

53

Online Control


PROCESSING INFORMATION Grupo

ABEND IF NO CICS? Si se ingresa una Y y el trabajo se ejecuta mientras CICS no se está ejecutando, VSHARE termina con una terminación anormal de usuario 2000. Si esta opción se define con una N y CICS no se está ejecutando, VSHARE pasa el control directamente a VSAM.

DO INPUT FILES? Si se ingresa una Y, VSHARE lee todos los archivos abiertos para entrada a través de la región CICS. Si se ingresa una N, el trabajo por lotes lee el archivo VSAM directamente.

ABEND IF DISABLED? Si se ingresa una Y, VSHARE termina el trabajo por lotes si alguno de los archivos abiertos por el trabajo por lotes está inhabilitado en la región CICS. Si se ingresa una N, VSHARE no terminará anormalmente el trabajo. En cambio, el trabajo asignará el archivo directamente.

TURN TRACE ON? Establezca siempre este campo en N a menos que el Soporte técnico de CSI solicite un seguimiento para la resolución del problema. Esta opción le dice a VSHARE en la región por lotes que rastree ciertos eventos durante la ejecución de un programa.

FORCE ROLLBACK? Si se ingresa una Y, se forzará una reversión si el trabajo por lotes termina anormalmente durante el procesamiento.

SRCH OTHER REGIONS?

La opción BUSCAR OTRAS REGIONES está diseñada para habilitar o deshabilitar la búsqueda de archivos VSAM en regiones remotas. VSHARE permite operaciones en archivos VSAM en regiones CICS remotas que tienen definiciones de archivo en el FCT local. Si el archivo VSAM de destino no se puede encontrar en la región local en la que se está ejecutando VSHARE, una respuesta Y a esta opción hará que el FCT en regiones remotas se busque el nombre del conjunto de datos. La transacción TCCR debe definirse en las regiones remotas que se buscan. Si se sabe que la región en la que opera VSHARE posee el archivo VSAM, una respuesta N a esta pregunta puede ahorrar un tiempo considerable en la búsqueda de otras regiones. Esta es la opción por defecto.

54

Online Control


DYNAMIC JOURNAL NAME Grupo

DSN= El calificador de alto nivel del nombre del conjunto de datos del diario creado por VSHARE. Consulte el capítulo “Recuperación” en la página 18 para obtener más información sobre el conjunto de datos del diario.

BLKSIZE= El tamaño de bloque del conjunto de datos de la revista.

LRECL= El tamaño de registro del conjunto de datos de la revista.

BUFNO= El número de búferes que se asignarán al conjunto de datos del diario.

SPACE= El tamaño principal y secundario del conjunto de datos de la revista. El tamaño es el número de cilindros.

UNIT= El valor unitario del conjunto de datos.

Attention Keys

Enter Realizar la edición de los datos introducidos.


PF3 Procesa la función deseada.

55

Online Control

Visualización de una Lista de

Trabajos ya Definidos

Si se ingresa un nombre de trabajo incorrecto en la pantalla detallada de

Resumen de trabajo, VSHARE muestra la pantalla de arriba con una lista

de trabajos que comienzan con los caracteres ingresados. Puede

desplazarse por esta lista para encontrar el trabajo que desea. Al escribir

una S junto al nombre de un trabajo, se muestra la pantalla detallada del

trabajo con la definición del nombre del trabajo elegido. El nombre de

búsqueda de trabajo se puede cambiar para mostrar otros trabajos

definidos.

Para mostrar una lista de los trabajos definidos, vaya a la pantalla

Mantenimiento de trabajos, seleccione la opción C, coloque cualquier

letra en el campo NOMBRE DEL TRABAJO y presione la tecla Intro.

Field Descripción

JOB NAME: El nombre del trabajo no definido ingresado en la pantalla Mantenimiento del trabajo. La modificación de este nombre muestra los trabajos que comienzan con el nombre ingresado.

CMD Al colocar una S en este campo, se muestra la definición detallada del trabajo.

56

Online Control

Attention Keys

Enter Procese el nombre del trabajo recién ingresado o regrese a la pantalla Mantenimiento del trabajo con la definición de trabajo elegida. Clear Volver a la pantalla detallada Mantenimiento del trabajo. PF7 Desplazarse hacia atrás en la lista. PF8 Desplazarse hacia adelante en la lista. PF9 Muestra la lista comenzando con el nombre ingresado en el campo JOB NAME.

Revisión del Historial de Ejecuciones de Trabajos Anteriores

Si un trabajo está definido para guardar el historial, puede usar la pantalla Resumen del historial del trabajo para explorar todas las generaciones guardadas por VSHARE. Para obtener la información del historial deseada, elija la opción 3 en el menú principal de VSHARE. La pantalla Resumen del historial de trabajos muestra una lista de información del historial de trabajos. La ejecución de trabajo deseada se puede encontrar desplazándose por la lista del historial o cambiando el campo NOMBRE DEL TRABAJO en la parte superior de la pantalla. Para purgar los registros del historial, establezca el número de generación en cero. La siguiente ejecución del trabajo purga todos los registros del historial del trabajo.

Consulte la sección “Definición de qué trabajos pueden acceder a los archivos” en la página 51 para obtener detalles sobre cómo guardar la información del historial. Los campos de la pantalla Resumen del historial de trabajos se explican a continuación.

57

Online Control

Field Descripción

JOB NAME: El nombre del trabajo utilizado para formar la lista. Este valor son espacios o el nombre del trabajo procesado por una pantalla anterior. Puede cambiarse en cualquier momento.

CMD Cada línea de detalle tiene un campo de comando. Al colocar cualquier carácter en este campo, se muestra la pantalla del historial de detalles. Se puede ingresar más de una selección a la vez. Después de salir de la primera pantalla del historial de detalles, se muestra la información detallada de la segunda selección. Esto continúa hasta que se muestran todas las selecciones.

JOB NAME El nombre del trabajo tal como aparece en la tarjeta JCL JOB.

STEP NAME El nombre del paso tal como apareció en la tarjeta JCL EXEC.

JES NUMBER El número de trabajo asignado al trabajo por el sistema operativo.

DATE La fecha en que se ejecutó el paso del trabajo.

TIME La hora de inicio del paso.

Attention Keys

Enter Actualiza la pantalla, muestra una nueva lista cuando se cambia

el campo JOB NAME o procesa los nombres de los pasos

seleccionados.


PF7 Desplazarse hacia atrás por la lista.

PF8 Desplazarse hacia adelante por la lista.

PF9 Muestra la lista comenzando con el trabajo contenido en el campo

JOB NAME.

58

Online Control

Información Detallada

del Historial

Según la selección que realice en la pantalla Resumen del historial del

trabajo, la pantalla Detalle del historial del trabajo muestra más detalles,

incluida una lista de DDNAME abiertos durante la ejecución. Al

seleccionar uno de los DDNAME, se muestra una pantalla detallada que

brinda información específica del conjunto de datos. La información que

se muestra en esta pantalla se explica a continuación.

Field Descripción

JOB NAME: El nombre del trabajo tal como aparece en la tarjeta JCL JOB.

JES NUMBER:

El número de trabajo asignado a este trabajo.

DATE: El número de trabajo asignado t La fecha de ejecución del trabajo. o este trabajo.

STEP NAME: El nombre del paso tal como apareció en la tarjeta JCL EXEC.

TIME: La hora de inicio del paso.

59

Online Control

Field Descripción

UPDATES JOURNALED?

La opción de procesamiento de diario. Una Y indica que se realizó el registro en diario. Una N indica que no se realizó el registro en diario. Este valor y otros campos de registro en diario que se enumeran a continuación están determinados por los valores predeterminados del sistema y las modificaciones de la definición del trabajo. Los campos ITIJRNL DD están en blanco si el diario no estaba activo. Consulte la sección “Definición de qué trabajos pueden acceder a los archivos” en la página 51 y la sección “Definición de regiones CICS para VSHARE” en la página 64 para obtener detalles.

DSN= El calificador de alto nivel del nombre del conjunto de datos del diario creado por VSHARE. Consulte el capítulo “Recuperación” en la página 18 para obtener más información sobre el conjunto de datos.

BLKSIZE= El tamaño de bloque del conjunto de datos de la revista.

LRECL= El tamaño de registro del conjunto de datos de la revista.

BUFNO= La cantidad de búferes asignados al conjunto de datos del diario.

SPACE= El tamaño de cilindro primario y secundario del conjunto de datos del diario.

UNIT= La unidad del conjunto de datos.

CICS REGION: El VTAM APPLID del CICS donde se ejecutó VSHARE.

REQS/MIN: El número inicial de solicitudes de I/O por minuto definido para el trabajo. Este es el número máximo de solicitudes de I/O de VSAM que VSHARE puede procesar por minuto.

FILES OPENED: El número de archivos abiertos en el paso. Tenga en cuenta que este es el número de archivos bajo el control de VSHARE. Los archivos de solo lote no se enumeran.

ACCESS TYPE: El tipo de comunicaciones utilizadas durante la ejecución de este trabajo. Los valores pueden ser LU62 si se utilizó LU 6.2 o CMS si se utilizó la interfaz de servicios de memoria cruzada.

60

Online Control

Field Descripción

USER SYNCPOINTS:

El número de puntos de sincronización emitidos por el programa de usuario al llamar a VSHARE directamente para ese propósito. Un valor distinto de cero indica que se está utilizando la recuperación de Nivel 3.

AUTO SYNCPOINTS:

El número de puntos de sincronización emitidos por VSHARE automáticamente en nombre del programa del usuario. Un valor de 0 indica que se está utilizando la recuperación de Nivel 1. Un valor mayor que 0 indica que se está utilizando la recuperación de Nivel 2, según el campo NIVEL DE SINCRONIZACIÓN en la pantalla Mantenimiento del trabajo.

TOTAL VSAM REQUESTS:

El número total de I/O de VSAM que VSHARE interceptó y emitió en nombre del programa por lotes.

DDNAMES: Una lista de DDNAMES abierta durante la ejecución del paso y bajo el control de VSHARE. Para obtener información más detallada sobre un conjunto de datos, escriba una S junto al DDNAME. Se muestra una pantalla DDNAME detallada.

Attention Keys

Enter Procese los DDNAME seleccionados o actualice la pantalla.

Clear Volver a la pantalla Resumen del historial de trabajos o mostrar

el siguiente paso seleccionado en la pantalla Resumen del

historial de trabajos anterior

PF7 Desplazarse hacia atrás por la lista DDNAME.

PF8 Desplácese hacia adelante por la lista DDNAME.

PF9 Muestra el comienzo de la lista DDNAME.

61

Online Control

Información Detallada del

Historial del Conjunto de Datos

La pantalla Estadísticas del conjunto de datos muestra información sobre

el conjunto de datos que eligió. Junto con la cantidad de operaciones

VSAM realizadas en el conjunto de datos, también se muestran las

características del conjunto de datos.

Field Descripción

DDNAME El DDNAME del conjunto de datos tal como apareció en el JCL por lotes.

FCTNAME El nombre CICS FCT del conjunto de datos en el momento de la ejecución.

CLUSTER NAME

El nombre del clúster del conjunto de datos.

ACCESS El acceso permitido por CICS contra el archivo. Se muestran cinco letras posibles. Si no se muestra alguna de las letras (a continuación), la operación correspondiente no está permitida contra el conjunto de datos. R—se permite el acceso de lectura. U—se permite el acceso a la actualización. B—se permite la navegación. A—se permite agregar nuevos registros. D—Se permite borrar registros.

62

Online Control

Field Descripción

LSR POOL El número del grupo de LSR donde se definió el conjunto de datos. Consulte el capítulo “Rendimiento de VSAM” en la página 70 para obtener detalles sobre LSR en CICS. Si se usa NSR, el número es cero.

STRINGS El número de cadenas definidas para este conjunto de datos. Una cadena permite una operación de I/O en un momento dado. Por ejemplo, si un conjunto de datos se define para tener cinco cadenas, se permiten cinco operaciones diferentes en el archivo en un momento determinado.

# OF READS

El número de lecturas realizadas contra el conjunto de datos en el paso.

# OF ADDS

El número de adiciones realizadas contra el conjunto de datos en el paso.

# OF UPDATES

El número de actualizaciones realizadas en el conjunto de datos en el paso.

# OF DELETES

El número de registros eliminados en el paso.

# OF STARTS

El número de arranques solicitados por el paso.

# OF ENDS

El número de solicitudes finales procesadas.

Attention Key

Clear Volver a la pantalla Detalle del historial de trabajos. Si se

seleccionó más de un DDNAME en la pantalla del historial de

detalles anteriores, muestre la siguiente pantalla de Estadísticas

del conjunto de datos.

63

Online Control

Definición de Regiones CICS para VSHARE

La pantalla Mantenimiento del sistema define qué regiones CICS pueden utilizar

VSHARE. Cuando VSHARE encuentra un registro de definición de trabajo en el

archivo de control, recupera el nombre de la región CICS del registro del trabajo

y lee el registro del sistema CICS. El registro del sistema se define en la pantalla

Mantenimiento del sistema. Esta pantalla contiene toda la información

requerida por VSHARE para comunicarse con la región CICS. Junto con esta

información de control, todos los campos de registro por diario e historial

predeterminados se definen para la región CICS. Estos valores predeterminados

se utilizan durante la definición de un trabajo cuando no se ingresan valores de

reemplazo.

Si olvida CICS APPLID, entre cualquier mandato junto con el carácter inicial de

CICS APPLID. VSHARE muestra todos los sistemas CICS comenzando con los

caracteres que ingresó. Al seleccionar un sistema de la lista, se vuelve a mostrar

la pantalla Mantenimiento del sistema con la definición del sistema.

64

Online Control


FUNCTION: Esta función para ejecutar. Los valores posibles son A—agregue una nueva definición de sistema a VSHARE. C—cambiar los valores de un sistema definido previamente. D—elimine una definición de sistema del archivo VSHARE.

CICS APPLID: El CICS APPLID completo elegible para usar VSHARE.

SYSTEM INFORMATION Grupo

TRANID: El nombre de la transacción definida para ejecutar el programa VSHARE CSIVSC00. Consulte la sección “Definiciones PCT” en la página 102 para obtener detalles sobre la definición de esta transacción. Cada aplicación en una región CICS puede tener su propio VSHARE TRANID definiendo múltiples transacciones que ejecutan CSIVSC00 y definiendo el TRANID exclusivo en la pantalla de definición del trabajo. Esto permite volver a cobrar a la aplicación adecuada por el trabajo realizado por el trabajo por lotes en CICS.

MODE NAME: El nombre de entrada de modalidad tal como se define en CICS y VTAM. Consulte la sección “Definiciones de entorno” en la página 107 para obtener detalles sobre la definición de entrada de modo. Si la instalación automática de CICS no se utiliza en CICS, la entrada de modalidad SMSNA100 se puede utilizar como nombre de modalidad con VSHARE. SMSNA100 es una definición en la tabla de entrada de modo predeterminada.

ROLLBACK: Si se ingresa Y, se forzará un ROLLBACK si los trabajos por lotes terminan anormalmente durante el procesamiento.

APPLID SEL: Si se ingresa Y en este campo, y se ingresa una máscara de selección de APLICACIÓN en el campo SELECCIONAR MSK :, solo aquellos APLICADOS que coincidan con la máscara se mostrarán en los campos de APLICACIONES DE LOTE.

ACCESS TYPE: El vehículo de comunicaciones predeterminado del sistema. Este campo le dice a VSHARE cómo comunicarse entre el trabajo por lotes y la región CICS. Los valores posibles son LU62 o CMS (Cross Memory Services). Incluso si elige CMS, LU 6.2 se utiliza para iniciar la transacción VSHARE; por lo tanto, los APPLID de lote aún son necesarios si CMS se usa únicamente. CMS solo se puede utilizar cuando el trabajo por lotes y la región CICS se ejecutan en el mismo sistema z/OS. LU62 debe utilizarse si el trabajo por lotes y la región CICS están en CPU diferentes. CMS proporciona un método de acceso a las comunicaciones más rápido entre el trabajo por lotes y CICS.

65

Online Control


SYNC LEVEL: Este campo controla la función de punto de sincronización implícita (automática). Es el número de colas de archivos CICS permitidas antes de que VSHARE intente un punto de sincronización. Tenga en cuenta que este es solo un nivel de umbral. Antes de que VSHARE pueda emitir un punto de sincronización, ninguno de los archivos propiedad del programa por lotes puede tener una lectura de actualización pendiente. Es importante no retener un recurso durante un período prolongado. Un valor de cero desactiva la función de punto de sincronización automático. Se debe usar cero si se usa recuperación de nivel 1 (sin sincronización) o recuperación de nivel 3 (sincronización explícita del usuario).

REQ/MIN: El número máximo de solicitudes que el trabajo por lotes puede enviar a la región CICS por minuto. Si se ingresa 0, el trabajo por lotes envía las solicitudes lo más rápido posible. VSHARE da prioridad a los programas CICS. Por lo tanto, si es necesario dar servicio a un programa CICS, CICS da servicio al programa en línea antes que al trabajo por lotes. Por este motivo, este campo necesita un valor distinto de cero solo cuando la región CICS está muy activa.

SELECT MSK: Especifica la máscara de selección APPLID para los campos BATCH APPLID. Este campo puede comenzar y / o terminar con un "*" para indicar que se desea una especificación genérica.

HISTORY INFORMATION Grupo

RECORD HISTORY: Los valores posibles son Y o N. Si ingresa una Y, le indica a VSHARE que mantenga la información del historial sobre la ejecución del trabajo.

GENERATIONS: Ingrese el número predeterminado de generaciones de historia. Se agrega un registro histórico al archivo de control de VSHARE por cada paso de ejecución. Por ejemplo, si se ingresan cinco generaciones y hay seis pasos en el trabajo, habrá un máximo de 30 registros en el archivo de control por trabajo.

JOURNAL INFORMATION

JOURNAL UPDATES:

Los valores posibles son Y o N. Si ingresa una Y, le indica a VSHARE que registre todos los cambios realizados durante la ejecución del trabajo. Al especificar Y, todos los cambios se pueden restituir en caso de finalización anormal del programa. Consulte el capítulo “Recuperación” en la página 18 para obtener detalles sobre el registro en diario de VSHARE.

DYNAMIC JOURNAL NAME: Grupo

DSN= El calificador de alto nivel predeterminado del nombre del conjunto de datos del diario creado por VSHARE. Consulte el capítulo “Recuperación” en la página 18 para obtener más información sobre el conjunto de datos del diario.

BLKSIZE= El tamaño de bloque predeterminado del conjunto de datos de la revista.

66

Online Control


LRECL= El tamaño de registro predeterminado del conjunto de datos de la revista.

BUFNO= El número predeterminado de búferes que se asignarán al conjunto de datos del diario.

SPACE= El tamaño primario y secundario predeterminado del conjunto de datos del diario en cilindros.

UNIT= El valor unitario predeterminado para el conjunto de datos.

BATCH APPLIDS: Los VTAM APPLIDS definidos durante la instalación. Estos son los APPLIDS que VSHARE abre para comunicarse con la región CICS a través de un enlace LU 6.2. Consulte la sección “Definiciones de entorno” en la página 107 para obtener detalles sobre las definiciones de APPLID por lotes. Si desea más de una página de APPLIDS, la lista se puede desplazar hacia adelante y hacia atrás. VSHARE permite un máximo de 90 APPLIDS por sistema CICS. Los APPLIDS por lotes son necesarios incluso si se elige CMS como tipo de acceso. LU 6.2 siempre se utiliza para iniciar una transacción VSHARE en CICS; no es hasta que se establece una conexión con CICS a través de LU 6.2 que se utiliza el acceso a CMS. Puede limitar el número de APPLIDS que se muestran aquí durante la adición inicial de una nueva región CICS: • Especificando una Y en el campo APPLID SEL: y • Ingresando una máscara de selección APPLID en el campo SELECT MSK :.

Attention Keys

Enter Realizar ediciones en los campos ingresados.

Clear Regresar al menú principal.

PF3 Procesa la función deseada.

PF7 Desplácese hacia atrás por la lista APLICACIÓN.

PF8 Desplácese hacia adelante por la lista APLICAR.

PF9 Muestra el comienzo de la lista APPLID.

67

Online Control

Listado de Regiones CICS

Definidas

Si se ingresa un nombre de sistema incorrecto en la pantalla detallada de

Mantenimiento del sistema, VSHARE muestra la pantalla de arriba. La

pantalla enumera los nombres de las regiones CICS definidas

comenzando con los caracteres que ingresó. Puede desplazarse por la

lista para encontrar el nombre CICS apropiado o puede cambiar el

nombre de búsqueda del sistema para reposicionar la lista. Al colocar

una S junto al nombre de un sistema, se muestra la pantalla detallada del

sistema con la definición elegida. También puede utilizar la pantalla

Mantenimiento del sistema para definir las regiones CICS que están

asociadas con un archivo de control VSHARE en particular. Al elegir la

función Cambiar y colocar una letra en el campo CICS APPLID, se muestra

una lista de todos los sistemas definidos en esta pantalla de resumen.

Field Descripción

APPLID: Se muestra el nombre inicial introducido. El nombre se puede cambiar para reposicionar la lista.

CMD Al colocar una S junto a CICS APPLID, se muestra la definición detallada del sistema.

68

Online Control

Attention Keys

Enter Procese el nuevo ingrese APLICADO o regrese a Mantenimiento

del sistema.

Clear Volver a la pantalla detallada Mantenimiento del sistema.

PF7 Desplazarse hacia atrás por la lista.

PF8 Desplazarse hacia adelante por la lista.

PF9 Muestra la lista comenzando con el nombre ingresado en el

campo APLICAR.

69

Rendimiento VSAM

VSAM Performance

Visión General El uso de VSHARE centra la importancia en el rendimiento de I/O de VSAM

porque más programas pueden acceder al mismo archivo simultáneamente. Este

capítulo trata sobre el rendimiento de VSAM tanto desde el punto de vista de la

aplicación como del sistema, de modo que una instalación pueda ajustar sus

bases de datos de VSAM de la manera más eficiente posible. Este capítulo

analiza inicialmente los conceptos básicos de I/O y VSAM. Por último, describe

recomendaciones de ajuste específicas para mejorar el rendimiento. Estas

recomendaciones se centran en los archivos KSDS porque KSDS es la estructura

de archivos VSAM más utilizada.

Conceptos El número de operaciones de I/O suele ser el elemento más importante en el

rendimiento del programa. El mayor porcentaje del tiempo transcurrido del

programa se debe al tiempo de espera de I/O. Eliminar o reducir este tiempo

mediante el ajuste de I/O, o eliminar I/O innecesarias, tiene un efecto

importante en el rendimiento del programa.

Para comunicar la importancia del ajuste de I/O y la eliminación de I/O,

considere este ejemplo. Un procesador IBM 3090-300S es capaz de ejecutar

aproximadamente 54 millones de instrucciones por segundo. Por otro lado, una

I/O de disco promedio tarda aproximadamente 25 milisegundos en completarse.

Esto significa que, si un programa no tiene que esperar en una I/O, puede

completar 1,35 millones de instrucciones adicionales durante el tiempo

ahorrado. El concepto de reducir las I/O del programa al mínimo es fundamental

para lograr un buen rendimiento del programa y maximizar el recurso de la CPU.

Antes de describir recomendaciones de rendimiento específicas, este capítulo

cubre los conceptos básicos de I/O para que aquellos que no estén familiarizados

con los conceptos puedan apreciar mejor el impacto del ajuste del rendimiento

de I/O. A continuación, se muestra una lista de los temas tratados. Incluso

aquellos que estén familiarizados con estos conceptos deberían revisar esta

sección como recordatorio.

1. Medios de almacenamiento

2. Concepto de I/O asíncrona versus síncrona

3. Mecánica de una I/O física

4. Mecánica de una solicitud de I/O KSDS VSAM

5. Recursos no compartidos versus recursos compartidos locales

71

VSAM Performance

Medio de Almacenamiento En el pasado, los datos se podían ubicar en el almacenamiento principal o en un

disco externo. Ahora se pueden encontrar datos en muchas ubicaciones

intermedias entre el almacenamiento principal y DASD:

• Buffers in Main Storage. Los datos solicitados recientemente por un programa

permanecen en búfer de almacenamiento hasta que se modifican o se eliminan

porque el sistema operativo requiere el espacio del búfer. El sistema operativo

busca estos búferes antes de que los datos solicitados se lean del disco. Este

proceso se conoce como lookaside.

• Expanded Storage. Muchos procesadores tienen almacenamiento ampliado,

que es una extensión del almacenamiento principal. Para que un programa

acceda a los datos en el almacenamiento expandido, el sistema operativo

primero debe mover los datos al almacenamiento principal. El almacenamiento

ampliado proporciona un acceso rápido a los datos.

• Cache. Muchos controladores de disco contienen almacenamiento en caché,

que es similar al almacenamiento principal, excepto que se encuentra dentro del

controlador de disco. Este almacenamiento es administrado por el micro código

del controlador y se busca antes de que el controlador intente leer un registro

del disco.

• Solid State Disks (SSD). Un SSD aparece ante la CPU como un dispositivo de

disco convencional, pero no contiene componentes mecánicos de un disco

giratorio. Como resultado, un SSD ofrece un tiempo de respuesta bajo constante

para leer y escribir datos. Las operaciones de lectura / escritura de disco en un

SSD son tan rápidas como la caché. El SSD es un buen candidato para conjuntos

de datos pequeños y críticos.

• Conventional Rotating Disk. Leer y escribir datos de discos giratorios es la

operación más lenta porque se basa en el movimiento mecánico.

Los tiempos de recuperación de datos son dramáticamente diferentes según el

medio de almacenamiento utilizado. Esto se muestra en la siguiente figura.

72

VSAM Performance

Acceso Sincrónico Los datos se pueden recuperar de los medios de almacenamiento de forma

Versus Asincrónico sincrónica o asincrónica. A continuación, se muestra una descripción de cómo se

leen los datos con cada método:

Synchronous I/O: los datos que se van a leer se recuperan físicamente del disco

solo después de que un programa lo solicite.

Asynchronous I/O: el sistema operativo o el controlador de disco anticipa la

siguiente solicitud de datos y lee los datos del disco antes de recibir la solicitud

del programa. Esto ocurre durante el procesamiento secuencial donde se realiza

la lectura anticipada. Por lo tanto, cuando el programa solicita los datos, se

mueven del búfer de almacenamiento principal del sistema operativo al

programa de usuario, lo que se traduce en un ahorro de tiempo considerable.

En el pasado, la escritura de datos en el disco siempre era sincrónica debido a la

importancia de la integridad de los datos. Los controladores de disco no tenían

respaldo de batería y el controlador tuvo que esperar a que finalizara la I/O física

antes de indicar a la CPU que se completó la I/O. Esto era importante para

garantizar la integridad de los datos. La situación cambió con la llegada del

controlador de disco IBM 3990. El controlador de disco 3990 tiene caché no

volátil (respaldo de batería). Los datos escritos en el disco se almacenan en la

memoria caché temporalmente y se informa a la CPU de la finalización normal

de I/O. Esta operación tarda 3 ms en lugar de los 25 ms de una I/O de disco

normal (física). A medida que el programa continúa, el controlador completa la

I/O física.

La siguiente figura compara los procesos asíncronos y síncronos.

73

VSAM Performance

74

VSAM Performance

Conceptos Basicos de I/O La I/O de disco normal se puede dividir en tres operaciones:

1. La primera operación es mover la cabeza del disco sobre la superficie del

disco. La cabeza se coloca sobre el cilindro apropiado donde residen los datos. El

tiempo medio para completar esta operación de búsqueda es de unos 15 ms.

2. Una vez que se completa la operación de búsqueda, el canal desconecta el

enlace a la unidad y atiende otras solicitudes hasta que el registro solicitado pasa

por debajo del encabezado. Esto se conoce como detección de posición

rotacional (RPS). Cuando el registro solicitado pasa por debajo de la cabeza, el

canal vuelve a conectar el disco y el registro se transfiere a la CPU. Si el canal

está ocupado atendiendo otra solicitud y no puede volver a conectarse en el

momento en que el registro pasa por debajo del cabezal, el canal debe esperar

16 ms adicionales de rotación del disco antes de intentar volver a conectarse y

transferir el registro. La falta del registro se conoce como una falta de RPS. Un

error de RPS tiene un impacto significativo en el rendimiento del disco.

3. Una vez que el canal se conecta al disco, los datos se transfieren por el canal

al host. El tiempo que tarda en completarse depende de la velocidad de

transferencia de datos del canal (actualmente de 3 a 4,5 MB por segundo).

Como se muestra en la figura siguiente, la transferencia de datos representa solo

un pequeño porcentaje del tiempo total de I/O. Por eso es importante reducir el

número de lecturas físicas a DASD al acceder a un archivo VSAM.

75

VSAM Performance

Mecánica de una I/O Es importante comprender los pasos que toma VSAM cuando un programa

VSAM KSDS solicita una I/O. El primer punto a entender es la diferencia entre una I/O l

lógica y una I/O física. Cuando un programa emite una lectura, se denomina I/O

lógica. Una I/O física es una solicitud emitida por el sistema operativo a un

controlador para recuperar datos de DASD. Dado que VSAM accede a los datos

con clave mediante un índice, es necesario realizar varias I/O físicas para obtener

el registro adecuado. La siguiente figura muestra un ejemplo de un archivo

VSAM KSDS con tres niveles de índice. Para satisfacer una I/O lógica, VSAM

puede tener que realizar cuatro I/O físicas para recuperar el registro solicitado.

Por lo tanto, la solicitud del programa de una I/O lógica se traduce en varias

operaciones de I/O físicas.

Durante una operación de lectura directa, VSAM primero lee el índice del

conjunto de datos para identificar qué intervalo de control contiene el registro

solicitado. Un conjunto de datos de VSAM normalmente tiene varios niveles de

índice, y VSAM comienza leyendo el nivel más alto del conjunto de índices

llamado raíz. VSAM luego lee cada nivel de conjunto de índices hasta que alcanza

el nivel más bajo del índice, llamado conjunto de secuencias de índices. El

conjunto de secuencia de índice apunta al intervalo de control de datos

apropiado donde se encuentra el registro. El intervalo de control de datos

finalmente se lee en el almacenamiento y el programa pasa el registro.

Un índice VSAM a menudo consta de dos o tres niveles. Suponiendo tres niveles,

el 75 por ciento de la I/O física relacionada con una I/O lógica es para el índice y

solo el 25 por ciento es para datos. Esto supone que ningún nivel del índice se

almacena en búfer. La clave para un excelente rendimiento de I/O es reducir el

número de I/O físicas mediante un almacenamiento en búfer eficiente.

Durante el procesamiento secuencial o de salto secuencial, el conjunto de

secuencias de índice se utiliza para localizar el siguiente intervalo de control

lógico. Por lo tanto, la navegación también requiere leer el índice.

El archivo VSAM KSDS en la figura siguiente tiene un nivel de índice de tres. Para

realizar una I/O lógica, VSAM puede tener que realizar cuatro I/O físicas para

recuperar un registro.

76

VSAM Performance

Recursos locales compartidos VSAM proporciona dos métodos para reservar búferes de

versus no compartidos almacenamiento principal para conjuntos de datos VSAM. El primer

método se llama Recursos no compartidos (NSR). Como su nombre lo

indica, un conjunto de búferes de datos e índices están reservados para

el uso exclusivo de un conjunto de datos VSAM. Ningún otro conjunto de

datos puede compartir esos búferes. El segundo método se llama

Recursos compartidos locales (LSR). Este método crea una serie de

grupos de búfer que pueden ser compartidos por varios archivos VSAM.

La siguiente figura compara los dos métodos en su relación con CICS.

En el pasado, los programas COBOL por lotes solo podían usar el

almacenamiento en búfer NSR, y solo los programas ensambladores

podían usar LSR. CICS, por otro lado, utiliza ambas técnicas y permite al

programador del sistema CICS ajustar cada técnica en función de la

actividad y utilización del archivo VSAM. Con el producto DFP de IBM, los

programadores pueden agregar nuevos parámetros JCL para dar a los

programas COBOL por lotes la capacidad de explotar el almacenamiento

en búfer LSR.

77

VSAM Performance

Cómo Mejorar el El resto de este capítulo explica las pautas que, si se aplican correctamente,

Rendimiento de VSAM pueden mejorar el rendimiento del conjunto de datos VSAM. Estas pautas son

las siguientes.

1. Evite el intervalo de control y las divisiones del área de control (página 87)

2. Reorganice los conjuntos de datos con varias extensiones (página 87)

3. Distribuya los conjuntos de datos con mucho acceso en varios dispositivos

(página 88)

4. Utilice el índice y el almacenamiento en búfer de datos (página 88)

5. Ajustar tamaños de intervalo de control de datos e índices (página 88)

6. Administrar conjuntos de datos VSAM de un cilindro (página 89)

7. Analizar estadísticas de fin de día de CICS (página 89)

8. Usar recursos compartidos locales de VSAM (página 90)

9. Utilice la subtarea VSAM de CICS (página 92)

10. Tenga cuidado con los conjuntos de datos mediante las opciones 3 o 4 para

compartir (página 92)

11. Reduzca la I/O del programa (página 92)

12. Coloque los archivos críticos en medios de almacenamiento más rápidos

(página 93)

78

VSAM Performance

Evite el Intervalo de Control y Las divisiones del área de control (CA) y del intervalo (CI) son fácilmente

las Divisiones del área de detectables y pueden resultar en un rendimiento deficiente. El número de

Control divisiones de CI y CA se etiquetan como SPLITS-CI y SPLITS-CA, respectivamente,

en un informe IDCAMS LISTCAT (consulte el ejemplo a continuación). Cuando se

produce una división, los distintos niveles de índice se actualizan para reflejar la

existencia de un nuevo intervalo de control. VSAM incluye parte del índice para

garantizar que no se procesen otras solicitudes mientras se dividen el índice y los

datos. Esto afecta no solo al programa que causa la división, sino también a otros

programas que acceden al mismo archivo VSAM. Las divisiones hacen que se

muevan grandes cantidades de datos en DASD y pueden causar retrasos

considerables.

Los posibles remedios para la actividad de división alta son (1) asignar suficiente

espacio libre y (2) reorganizar regularmente el conjunto de datos.

Reorganizar conjuntos de datos Si un conjunto de datos está en varias extensiones, los registros lógicamente

con múltiples extensiones adyacentes no son físicamente adyacentes en el disco. Esto requiere tiempo de

búsqueda adicional para recuperar el siguiente registro, lo que resulta en un

mayor tiempo de acceso. El tiempo mínimo de búsqueda en un dispositivo 3380

es de 2 a 3 ms y el promedio es de 12 a 15 ms. El tiempo de búsqueda es el

componente más grande de I/O y se puede minimizar manteniendo los

conjuntos de datos en la menor extensión posible.

Si identifica varias extensiones analizando el informe IDCAMS LISTCAT (consulte

el ejemplo a continuación), reorganice el archivo VSAM. Si el archivo ha crecido

fuera de la extensión principal, cambie la tarjeta de definición de IDCAMS para

asignar un tamaño principal lo suficientemente grande para los datos existentes

y el crecimiento futuro. La cantidad necesaria para un crecimiento adicional

depende de las características de la actividad del archivo VSAM.

79

VSAM Performance

Difundir conjuntos de Si en un volumen hay más de un conjunto de datos con mucho acceso, el datos de gran acceso rendimiento del programa se ve afectado. En un volumen con un conjunto de datos muy utilizados, los cabezales de disco tienden a permanecer cerca de los datos de mayor acceso. Si hay dos conjuntos de datos con mucho acceso, los cabezales pasan mucho tiempo recorriendo el ancho de la superficie del disco atendiendo solicitudes de I/O para ambos conjuntos de datos. La cabeza rara vez se acercan a los datos solicitados. Este tiempo de búsqueda extendido resulta en un tiempo de respuesta extendido.

¿Cuánto es el tiempo de búsqueda extended y cómo se puede monitorear? Dado que una I/O de disco promedio se completa en 25 ms, se deben investigar los tiempos de I/O que excedan este valor. Estos tiempos se obtienen de la Instalación de medición de recursos de IBM o productos similares. Los tiempos de búsqueda prolongados y constantes producen un cuello de botella crítico en el rendimiento. Cuando se producen tiempos de búsqueda extendidos para una solicitud de I/O, todas las demás solicitudes de datos en el mismo disco se ponen en cola hasta que se completa la primera solicitud. Por lo tanto, todos los programas se ven afectados y el rendimiento se ve afectado.

Utilizar índice y almacenamiento La I/O lógica más eficiente es, obviamente, ninguna I/O física. El uso de en búfer de datos almacenamiento en búfer de índices y datos en el almacenamiento principal puede provocar una reducción de I/O físicas. La especificación de BUFNI (número de búferes de índice) y BUFND (número de búferes de datos) en la tabla de control de archivos CICS debe analizarse cuando se utiliza la técnica de almacenamiento en búfer NSR. BUFNI debe ser al menos igual al número de niveles en el índice del conjunto de datos más 1. Nunca ingrese un valor menor; de lo contrario, el rendimiento se verá afectado.

El uso del almacenamiento en búfer debe moderarse porque el exceso de búfer hace que aumente la paginación, lo que reduce el efecto del almacenamiento en búfer. En un entorno CICS, paginar un registro desde un conjunto de datos de página es eficaz, pero nunca es preferible a una I/O normal. La operación de paginación coloca a toda la región CICS en espera, afectando a todos los programas, mientras que una I/O de conjunto de datos afecta solo al programa que solicita la I/O.

Ajustar tamaños de intervalo de Los conjuntos de datos con una alta actividad de navegación deben tener un control de datos e índices CISIZE de datos más grande. Los conjuntos de datos a los que se accede aleatoriamente deben tener un CISIZE más pequeño. Si un archivo se utiliza en modo mixto, determine el tamaño según el porcentaje entre el acceso directo y secuencial.

El índice CISIZE rara vez es mayor que los datos CISIZE. Se debe investigar la definición de cualquier conjunto de datos para el cual el índice CISIZE es mayor que los datos CISIZE. Una regla general es permitir que VSAM elija el índice CISIZE. VSAM generalmente determina el mejor tamaño según los datos CISIZE, la longitud de la clave y la longitud del registro.

80

VSAM Performance

Administrar One-Cylinder Los conjuntos de datos de VSAM pequeños de un cilindro o menos deben tener

VSAM Datasets solo un nivel de índice. VSAM requiere un registro de índice por CA de datos. El

tamaño máximo de una CA de datos es un cilindro; por lo tanto, si el archivo se

define correctamente, solo se necesita un nivel de índice. El tamaño mínimo de

una CA de datos es una pista. VSAM decide el tamaño de la CA de datos por los

valores contenidos en los parámetros de asignación de datos primarios o

secundarios. VSAM utiliza el menor de los dos valores como tamaño de CA de

datos.

Si los tamaños de asignación de datos primarios o secundarios están codificados

incorrectamente, VSAM crea otro registro de índice. VSAM permite solo un nivel

de índice en la raíz; por lo tanto, la creación del nuevo registro de índice fuerza la

creación de un nuevo nivel. Si el conjunto de datos tiene más de un nivel de

índice, está definido incorrectamente y se está realizando un 50 por ciento más

de I/O de lo necesario.

Para determinar el número de niveles contenidos en un conjunto de datos

VSAM, consulte IDCAMS LISTCAT. Consulte el ejemplo a continuación.

Analizar las estadísticas Cuando CICS se cierra, crea una serie de estadísticas al final del día. Las

de fin del día de CICS estadísticas de final del día de CICS son útiles para detectar cuellos de botella o

situaciones de escasez de recursos. Se enumeran los números de índice y datos

EXCPS por conjunto de datos, así como cadenas de espera y otra información

valiosa. Estas estadísticas deben verificarse para detectar situaciones fuera de

línea. Vea el ejemplo a continuación.

81

VSAM Performance

Usar recursos compartidos VSAM LSR bajo CICS permite que varios archivos compartan un grupo común de

locales de VSAM buffers y cadenas. Antes de emitir una lectura en disco, VSAM escanea los

buffers LSR para verificar si el intervalo de control ya está almacenado. Si está

disponible, CICS no emite la lectura. Esta capacidad de búsqueda de búfer reduce

significativamente el tiempo de I/O. Además, solo se almacena una copia del CI

(a diferencia de las copias múltiples que se usan con NSR). Esto reduce el uso del

almacenamiento virtual y permite una mejor integridad de lectura.

Si bien LSR puede mejorar enormemente el rendimiento, puede producirse una

degradación del rendimiento si se especifica incorrectamente. La asignación de

demasiados búferes provoca una paginación excesiva, mientras que la asignación

de muy pocos búferes reduce las relaciones de búsqueda, lo que aumenta la

actividad de I/O. Como se indicó anteriormente, la mayor reducción del tiempo

de procesamiento transcurrido de un programa es la reducción de I/O. VSAM LSR

puede ayudar a lograrlo. El uso de LSR debe analizarse porque no todos los

archivos son buenos candidatos para él. Los archivos grandes producirían una

"tasa de aciertos" de búfer baja y no se beneficiarían de LSR. Los conjuntos de

datos que se examinan con frecuencia deben separarse de otros conjuntos de

datos mediante NSR. Esto se debe a que la exploración hace que otros intervalos

de control de conjuntos de datos se eliminen de los búferes y altera la capacidad

de búsqueda de LSR.

Los conjuntos de datos que experimentan una gran cantidad de divisiones de CA

serían buenos candidatos para LSR, ya que la sub tarea o tarea principal de CICS

no se coloca en un estado de espera mientras se procesa la división. Con NSR, la

sub tarea o tarea principal de CICS se pone en estado de espera. La discusión a

continuación es una técnica sugerida para organizar y ajustar el grupo de LSR.

Suponga que para cada solicitud de VSAM se realizan normalmente tres I/O

físicas. Dos de ellos son para los dos niveles de índice y el tercero es para los

datos en sí. El objetivo al ajustar el grupo de LSR debe ser eliminar o limitar la I/O

de índice. Esto equivale al 67 por ciento de la I/O.

Al asegurarse de que haya suficiente espacio de búfer para mantener el índice en

almacenamiento y asegurarse de que el índice no se vacíe por la I/O de datos, se

puede lograr el objetivo. Desafortunadamente, según el diseño actual de LSR, el

índice y los componentes de datos deben residir en el mismo grupo de LSR. Si se

les permitiera estar en grupos diferentes, sería bastante sencillo asegurarse de

que no interfirieran entre sí. Sin embargo, este no es el caso y debe utilizarse

otra solución. Aquí hay un enfoque alternativo:

82

VSAM Performance

1. Cree varios grupos de LSR. Cada grupo es utilizado por conjuntos de datos con un índice CISIZE particular.

2. Defina los conjuntos de datos con diferentes índices y CISIZEs de datos. 3. Coloque conjuntos de datos con el mismo índice CISIZE en el mismo grupo.

Esto permite el uso exclusivo de intervalos de control de índice de un conjunto de búferes en el grupo sin impacto de la porción de datos del conjunto de datos. Esto resuelve el problema de manera eficiente.

Actualmente, se permiten ocho agrupaciones de LSR en CICS 1.7 y 2.1. Si DFP 2.3 o superior está instalado, los buffers residen por encima de la línea de 16 megabytes, lo que alivia la restricción de almacenamiento virtual dentro de CICS.

El uso de LSR no solo ahorra almacenamiento virtual dentro de CICS, sino que también requiere menos almacenamiento en otras áreas de z / OS, como se indica a continuación:

• Cada archivo NSR requiere de 5k a 8k de OSCOR, mientras que cada archivo LSR requiere solo 3k.

• Cada archivo NSR requiere de 1200 a 1500 bytes de CSA, mientras que cada archivo LSR no requiere almacenamiento en CSA.

• Cada archivo NSR requiere 240 bytes de SQA por cadena, mientras que cada archivo LSR no requiere almacenamiento SQA por cadena.

• El número de búferes necesarios para NSR es el número de cadenas más uno. Este buffer adicional se usa para divisiones y generalmente se desperdicia. El número de buffers necesarios para LSR puede ser igual al número de cadena, lo que no genera desperdicio.

Tenga cuidado al definir la macro SHRCTL (las agrupaciones LSR). Los sistemas PreDFP 2.3 no deben tener más de 55 buffers por grupo porque la sobrecarga de exploración de un registro en el buffer se vuelve excesiva. DFP 2.3 y superior tiene un nuevo algoritmo de hash de búfer que utiliza para escanear los buffers. Las pruebas que utilizan más de 800 búferes indican que no hay degradación del rendimiento.

Al especificar el número de búferes 512, 1024 y 2048, asegúrese de que sean un múltiplo del tamaño de página de z / OS. De lo contrario, se desperdicia el espacio restante de la página.

Para monitorear los resultados del ajuste de LSR, consulte las estadísticas de apagado de CICS como se muestra en el ejemplo siguiente. Estas estadísticas muestran las tasas de aciertos de búsqueda de búfer logradas. Las tasas objetivo deben ser del 90 por ciento o más para el índice y del 80 por ciento o más para los datos. Esta es solo una regla general, y los porcentajes pueden variar mucho según los patrones y la frecuencia de acceso a los datos.

83

VSAM Performance

Use CICS VSAM Subtasking El uso de la sub tarea VSAM indica a CICS que adjunte una sub tarea z/OS para realizar VSAM y otras I/O de conjuntos de datos. Dado que esta I/O no se realiza dentro de la tarea principal de CICS, CICS es libre de dar servicio a otras actividades de transacciones de CICS. Esto proporciona multiprocesamiento dentro de la misma región. Aunque el principal beneficio de utilizar las sub tareas de VSAM es un mayor rendimiento, también reduce el tiempo de respuesta.

La opción de sub tarea VSAM se especifica en la tabla de inicialización del sistema (SIT) de CICS mediante el parámetro VSP = YES. VSP = NO es el predeterminado.

Para CICS 3.3, establezca SUBTSKS = 1 para sub tareas. SUBTSKS = 0 es el valor predeterminado.

Beware of Datasets Using Evite el uso de conjuntos de datos de VSAM definidos con la opción Compartir 3 Share Option 3 or 4 o 4. Aparte de las exposiciones de integridad que impone la opción Compartir 3, el uso de conjuntos de datos definidos con la opción Compartir 3 da como resultado un rendimiento degradado dentro de CICS. Fuerza la ejecución de la lógica z/OS ENQ, lo que provoca retrasos adicionales en el sistema CICS. Además, el uso de Share Option 4 fuerza una actualización del búfer para cada solicitud de lectura. Esto aumenta la tasa de I/O física y anula el beneficio de la búsqueda de buffer. En general, el uso de estas opciones para compartir degrada el rendimiento en todas las circunstancias.

Reducir la I/O del programa Hasta este punto, toda la discusión se ha centrado en mejorar el rendimiento ajustando el entorno, por ejemplo, la utilización del búfer y la ubicación del conjunto de datos. Cuando se agotan todas estas opciones, la única forma restante de reducir la I/O es dentro de la aplicación. Es necesario analizar la aplicación para eliminar las I/O innecesarias. Al reducir las solicitudes de I/O de la aplicación, logra dos ahorros. Primero, están los ahorros sustanciales del tiempo de espera de I/O. En segundo lugar, hay un ahorro de 7000 instrucciones por I/O.

84

VSAM Performance

El esfuerzo necesario para analizar la aplicación y eliminar las I/O requiere

mucho tiempo y es caro. Debe realizar este trabajo solo después de que se hayan

agotado todas las opciones de ajuste del entorno y si se necesitan más ahorros.

Coloque Archivos Críticos en Medios Coloque los conjuntos de datos críticos en un medio de almacenamiento más

de Almacenamiento más Rápidos rápido. Como se describió anteriormente en esta sección, existen varios medios

de almacenamiento que brindan una mejor velocidad de acceso que un DASD

giratorio tradicional. Al utilizar estos dispositivos, el rendimiento se puede

mejorar enormemente.

Los diferentes medios de almacenamiento y sus velocidades se representan en la

siguiente figura.

85

Installation

Installation

Descripción General de la Esta sección describe el proceso de instalación de VSHARE ™ para z/OS. Instalación de VSHARE en z/OS El proceso consta de los siguientes pasos, que se describen con más detalle a continuación.

• Preparación:

- Asegúrese de que los niveles VTAM y CICS sean adecuados. - Obtenga un número de cuenta y una clave de producto.

• Revise los tipos de módulos y cargue el contenido en DASD. Para hacer esto, puede:

- Cargar las bibliotecas VSHARE desde la cinta.

O

- Descargue la distribución de la Web a su PC, transfiera los módulos a su sistema z / OS e instálelos.

• Instale la clave del producto de software.

• Cree el conjunto de datos de control de VSHARE.

• Si aún no está implementado, defina la región CICS para usar ISC.

• Agregue la biblioteca VSHARE a DFHRPL en el JCL de inicio de CICS.

• Cree las definiciones de VTAM y CICS para VSHARE.

• Definir regiones CICS elegibles y trabajos por lotes para VSHARE.

• Instale los servicios de memoria cruzada.

• Modificar los procedimientos de recuperación de Nivel 2.

• Implementar la función de enrutador VSAM.

• Utilice la activación y desactivación de VSHARE.

• Revisar las necesidades de seguridad y modificar el módulo CSIVSBSC.

Preparación • Asegúrese de que los niveles de versión del sistema sean los adecuados:

- VSHARE se ejecuta bajo CICS / VSE 2.1.2 o superior. - VSHARE puede ejecutarse en VTAM nivel 3.2 o superior.

• Póngase en contacto con su representante de ventas para obtener un número de cuenta y una clave de producto. Puede comunicarse con un representante de ventas de CSI International al 800-795-4914 o enviar un correo electrónico a [email protected].

87

mailto:[email protected]

Installation

Instalación de VSHARE Si recibió VSHARE en una cinta IEBCOPY, la cinta contiene las siguientes

desde cinta bibliotecas:

Library Descripción

VSHARE.INSTALL Este PDS contiene el JCL necesario para realizar este proceso de instalación.

VSHARE.LOAD Este PDS contiene los módulos de carga que utilizan los programas por lotes.

VSHARE.CICSLOAD Este PDS contiene los módulos de carga utilizados por CICS.

VSHARE.APF.LOAD Este PDS contiene los módulos de carga autorizados; debe definirse como APF autorizado. Es necesario para los servicios de memoria cruzada y las instalaciones de interfaz abierta de bajo nivel.

Utilice los siguientes pasos para cargar estas bibliotecas desde una cinta.

1. Modifique y ejecute el JCL siguiente para cargar la biblioteca de instalación

(“.INSTALL”).

2. Utilice el miembro LOADTAPE, que se encuentra en la biblioteca de instalación, para

cargar las bibliotecas restantes (“.LOAD”, “.CICSLOAD” y “.APF.LOAD”).

88

Installation

Instalación de VSHARE

desde una Descarga Web

Descargue los Conjuntos Con su número de cuenta, descargue el enrutador CSI VSAM y el archivo ZIP de

de Datos de Instalación instalación de VSHARE desde el sitio web de CSI International a su PC. Usa está

a una PC dirección:

http://www.csi-international.com/products/zOS/VSHARE/VSHARE.htm

Descomprime el archivo de instalación que descargaste. La carpeta contiene los

conjuntos de datos que se enumeran en la siguiente tabla.

Library Descripción

VSHARE.INSTALL Contiene el JCL necesario para el proceso de instalación.

VSHARE.LOAD Contiene los módulos de carga que utilizan los programas por lotes.

VSHARE.CICSLOAD Contiene los módulos de carga utilizados por CICS.

VSHARE.APF.LOAD Contiene los módulos de carga autorizados; debe definirse como APF autorizado. Es necesario para servicios de memoria cruzada e instalaciones de interfaz abierta de bajo nivel.

ROUTER.APF.LOAD Contiene los módulos de carga para el enrutador.

Transferir los conjuntos de Los archivos móviles de z/OS de este conjunto de distribución se crearon con la

datos de instalación función IBM NJE 'XMIT' para garantizar que el archivo descargado sea un archivo

secuencial con registros de longitud fija (LRECL = 80, BLKSIZE = 3120). Esto

garantiza que el archivo se pueda cargar en la plataforma z / OS mediante

cualquier programa de utilidad de transferencia de archivos que pueda transferir

datos en formato binario. Las condiciones y procedimientos del sitio de z/OS

dictan qué archivos, nombres y condiciones de seguridad se aplican a dichas

transferencias.

Configuración del perfil de transferencia IND $

Si utiliza la función de z/OS IND $ en cualquiera de los programas de emulación

3270 como método de transferencia, asegúrese de que se defina un tipo de

transferencia binaria en los perfiles del software de emulación. Si no se ha

definido previamente un perfil en el software de emulación 3270, siga las

instrucciones de su software para configurar los valores de los parámetros en la

tabla siguiente. Su software puede etiquetar los parámetros de manera

diferente.

Parámetros de transferencia IND$

Parámetro Valor

Transferir nombre Según sea apropiado

89

http://www.csi-international.com/products/zOS/VSHARE/VSHARE.htm

Installation

Parámetros de transferencia IND$

Parámetro Valor

Formato de registro Fijo

Longitud de registro 80

Tamaño de Block 3120

ASCII Apagado

CLRF Apagado

Primary allocation amount

Según sea apropiado

Secondary allocation amount

Según sea apropiado

Unidades de asignacion Cylinders or tracks

Asegúrese de guardar esta definición.

Usando IND $ para transferir el archivo

Para transferir un conjunto de datos binarios secuenciales descargados desde la

PC al sistema mainframe z/OS usando IND $, navegue en el emulador 3270 al

panel de la Opción 6 de ISPF o al indicador TSO READY. Especifique la siguiente

información de acuerdo con las instrucciones de su emulador para enviar un

archivo binario secuencial:

• La unidad de origen, el directorio y el nombre del archivo (en la PC)

• El nombre del archivo de destino (en el mainframe)

• El perfil de transferencia (configurado anteriormente)

Luego transmita el archivo.

RECEIVE y RESTORE el Después de transferir los conjuntos de datos al mainframe z/OS, siguen siendo

Conjunto de Datos conjuntos de datos secuenciales. Siga los siguientes pasos para instalar cada

conjunto de datos.

Paso Acción

1 Navegue hasta el panel ISPF Option 6 o al indicador TSO READY e ingrese el siguiente comando: RECEIVE INDSN('sequential.dataset.name') Durante la configuración de TSO del comando, se muestra el siguiente mensaje: Restore parameter or DELETE or END +

90

Installation

Paso Acción

2 Ingrese RESTORE con cualquiera de las siguientes opciones: DSNAME, SPACE, UNIT, VOL, OLD / NEW. El uso recomendado es el siguiente: RESTORE DSNAME('your.dsname') UNIT(sysda) NEW En el ejemplo anterior, se crea un nuevo conjunto de datos particionado en unit sysda. Si la transferencia se realiza correctamente, se muestra el siguiente mensaje: Restore successful to data set 'your.dsname'

3 Repita desde el paso 1 para cada archivo descargado en el conjunto de distribución descargado. Vea el trabajo de ejemplo a continuación.

91

Installation

Ejemplo de Job

El siguiente trabajo por lotes de ejemplo RECIBE el conjunto de datos secuencial

cargado ROUTER.TEMP.LOADLIB y lo RESTAURA en el conjunto de datos

ROUTER.P390.LOADLIB

Instale la clave del Todos los productos de software de CSI International están protegidos por una producto de software clave de producto. Estas claves de producto deben instalarse en su sistema mediante el proceso que se describe a continuación.

Se le otorga una clave de producto separada para cada producto de CSI International que tenga licencia. Cada clave es para un producto específico y autoriza el uso de ese producto en una CPU específica hasta una fecha específica, según el tipo de acuerdo de licencia que haya firmado.

Si tiene licencia para ejecutar un producto en más de una CPU física, se le emitirá una clave de producto separada para cada número de serie de la CPU. Tenga en cuenta que las LPAR se consideran la misma CPU física. Si no recibió una clave de producto para cada uno de sus productos, comuníquese con su representante de ventas de CSI International.

92

Installation

Instalación de claves de productos Cada producto de CSI International busca su clave de producto en un módulo de

carga llamado FSIPKEYS. Genere este módulo de carga en su sitio utilizando el

JCL a continuación.

Notas:

• El product.source que se muestra en la declaración SYSLIB DD es la ubicación

utilizada para encontrar la macro PRODKEY. La macro PRODKEY se suministra

con cada producto de CSI International.

• Cambie la declaración PRODKEY para usar el valor de clave de producto que

obtuvo de su representante de ventas de CSI International.

• El your.auth.linklib que se muestra en la declaración SYSLMOD DD es el lugar

donde desea que se vincule el módulo de carga FSIPKEYS. Para estar

correctamente disponible para todos los productos de CSI International, debe

estar autorizado por APF y en el LNKLST.

• Si usa una biblioteca de carga LNKLST, deberá emitir un comando LLA, REFRESH

cada vez que cambie la tabla.

Mensajes de autorización Cuando intenta utilizar un producto de CSI International, puede recibir uno de

de productos los siguientes mensajes:

Este mensaje se genera cuando la autorización vence en 30 días o menos.

93

Installation

Este mensaje se genera si el producto no puede validar una clave de producto. El

código REASON puede ser uno de los siguientes:

12 GETMAIN falló

20 La carga de la tabla FSIPKEYS falló

24 No se encontró la clave de producto para el producto y/o el número de serie

de la CPU.

28 La clave de producto ha caducado.

Según el producto, estos mensajes pueden aparecer en la consola del sistema,

en la salida SYSPRINT del trabajo o en la pantalla si está utilizando un producto

CICS.

Si ve uno de estos mensajes, comuníquese con su representante de ventas de

CSI International para obtener una nueva clave de producto.

Definir un conjunto de El conjunto de datos de control contiene toda la información del sistema, el

datos de control de VSHARE trabajo y el historial. El número de conjuntos de datos de control que elija crear

depende del usuario. Puede haber uno por región CICS o uno para todas las

regiones CICS. Si se utiliza un conjunto de datos para muchas regiones, todas las

regiones CICS que utilizan el conjunto de datos de control deben tener acceso al

conjunto de datos a través de MRO o ISC. La biblioteca de instalación contiene

un miembro llamado DEFCTL que define este conjunto de datos VSAM KSDS.

Cambie los nombres de los conjuntos de datos para que se ajusten a los

estándares de instalación.

94

Installation

Definición de conjunto de datos de control

Actualice el miembro del El miembro CSIVSBDS se utiliza para especificar el nombre del conjunto de datos

parámetro CSIVSBDS de control para VSHARE. Dado que el nombre del conjunto de datos de control

definido puede variar, se crea un módulo para cada conjunto de datos de control

definido. Edite el miembro CSIVSBDS. Ensamble este módulo y edítelo con el

enlace a la VSHARE library.

VSHARE carga el módulo de carga CSIVSBDS en el momento de la inicialización

para determinar qué conjunto de datos de control abrir. Si se utilizan varios

archivos de control, un módulo CSIVSBDS debe ensamblarse y editarse mediante

enlaces en diferentes bibliotecas. También necesitará un trabajo de activación

independiente para cada conjunto de datos de control. Consulte la sección

“Activación y desactivación de VSHARE” en la página 111 para obtener más

información.

A continuación, se muestra un ejemplo del módulo CSIVSBDS codificado.

Modifique el nombre del conjunto de datos según lo requieran los estándares de

instalación. Asegúrese de que este sea el mismo nombre que se utilizó en la

definición del conjunto de datos de control discutido anteriormente.

95

Installation

Instalación de ISC VSHARE utiliza LU 6.2 para comunicarse con la región CICS. La región CICS debe definirse para utilizar CICS ISC. Asegúrese de que la tabla de inicialización del sistema CICS contenga el operando ISC = YES. Los detalles sobre ISC se pueden encontrar en la "Guía de intercomunicación CICS" de IBM. Si ISC ya está implementado, este paso puede omitirse.

Place the Load Agregue de carga VSHARE Librery CICS al DFHRPL de todas las regiones CICS Library in the utilizando VSHARE. DFHRPL

Definiciones de entorno La siguiente figura muestra el diseño general de VSHARE. VSHARE se encuentra tanto en la región CICS que posee los archivos VSAM como en la región por lotes. Los programas CICS y por lotes pueden comunicar la solicitud VSAM a través de LU 6.2 o Servicios de memoria cruzada (CMS). LU 6.2 permite que la región por lotes y la región CICS se ejecuten en diferentes CPU, mientras que CMS proporciona una transferencia de datos más rápida cuando la región por lotes y la región CICS residen en la misma CPU.

VSHARE siempre utiliza LU 6.2 para iniciar su conversación entre la región por lotes y CICS. Una vez que se establece el enlace de comunicaciones entre la región por lotes y CICS, la interfaz CMS se puede utilizar si se ha solicitado y ambas partes están en la misma CPU.

96

Installation

Teniendo esto en cuenta, se necesitan las siguientes definiciones:

1. VTAM:

Defina un APPLID para los programas por lotes. Este APPLID lo abren los

programas por lotes VSHARE para establecer una sesión LU 6.2 con la región

CICS. El número de APPLID determina el número de trabajos simultáneos

que se pueden ejecutar.

2. CICS:

Defina las entradas de CICS para las transacciones, los programas y las

sesiones de LU 6.2 de VSHARE.

3. Actualizaciones en línea de VSHARE:

defina la región CICS y las opciones de proceso predeterminadas para

VSHARE a través de los paneles en línea de VSHARE. Esto se analiza con más

detalle más adelante en este capítulo, así como en el capítulo Control en

línea (página 41).

Las definiciones necesarias para permitir que VSHARE se comunique entre la

región por lotes y CICS están interrelacionadas. Si ciertos parámetros no están

correctamente vinculados entre sí, CICS o VTAM rechazarán la conexión entre las

dos regiones.

Antes de describir cada definición en detalle, las siguientes figuras muestran las

relaciones entre las definiciones. La primera figura muestra las definiciones

necesarias cuando se utilizan definiciones de sesión y conexión en CICS. La

segunda figura muestra las definiciones necesarias cuando se utiliza una

definición de terminal de sesión única dentro de CICS.

97

Installation

Definiciones necesarias cuando se utilizan sesiones y conexiones en CICS

98

Installation

Definiciones necesarias cuando se utilizan definiciones de terminal en CICS

99

Installation

VTAM Definiciones Hay dos definiciones necesarias para VSHARE. La primera son las definiciones de

los nuevos APPLID VTAM. Dado que se utiliza LU 6.2, el trabajo por lotes necesita

un APPLID por lotes para abrirse con el fin de comunicarse con VTAM.

Un ejemplo de una definición APPLID para VSHARE es el siguiente:

name APPL ACBNAME=applid1, AUTH=(ACQ,VPACE),

EAS=1,

MODETAB=tabname,

DLOGMOD=entname,

PARSESS=NO,

VPACING=n

ACQ: Debe especificarse la opción de adquirir autoridad.

VPACING: establece el número de estimulación según las especificaciones

de instalación.

APPLID: utilice convenciones de nomenclatura de instalación.

MODETAB: Código solo cuando SMSNA100 no está en la tabla de modo

predeterminado.

DLOGMOD: Solo codifica cuando SMSNA100 no está en la tabla de modo

predeterminado.

Se necesita una definición de APPLID para cada trabajo por lotes simultáneo. Si se requieren cuatro trabajos por lotes para ejecutarse simultáneamente, entonces se deben definir cuatro APPLID únicos. No es necesario definir un APPLID único para cada trabajo por lotes. Defina solo el número máximo de trabajos simultáneos que se pueden ejecutar a la vez. Actualmente, existe un límite lógico de 90 trabajos simultáneos por región CICS. También puede compartir los mismos APPLID por lotes entre las regiones CICS, pero solo un trabajo por lotes puede utilizar un APPLID por lotes a la vez.

En APPLID hay una referencia a MODETAB. Este es el nombre de la tabla de entrada de modo en VTAM. En la tabla de entrada del modo predeterminado proporcionada por VTAM, hay un miembro llamado SMSNA100. Utilice esta entrada para el valor de entrada de modo. Si no forma parte de la tabla de entrada del modo predeterminado, cree una entrada ficticia como la definición que se encuentra en la página opuesta. Es importante que la entrada de modalidad utilizada esté disponible para CICS APPLID y para el lote APPLID; de lo contrario, CICS rechaza el intento de conexión.

Al final de este capítulo hay una lista de códigos de retorno de VTAM que son comunes cuando las definiciones de las sesiones y conexiones no son correctas. Consulte esta lista para aislar posibles problemas con la conexión entre CICS y el trabajo por lotes. Recuerde mirar no solo el registro de lotes de VSHARE, sino también el registro de CICS.

100

Installation

CICS Definiciones

TCT Definiciones

Las definiciones CICS TCT necesarias para definir el enlace LU 6.2 entre el trabajo

por lotes y la región CICS se denominan sesiones y conexiones. Estas definiciones

definen cada lote APPLID para la región CICS.

La conexión define los atributos del sistema LU 6.2 remoto.

Recuerde: hay una definición de conexión por lote APPLID.

La segunda definición de TCT necesaria para cada definición de conexión es una

sesión. Observe en la figura siguiente que la sesión se define como una sola

sesión. También defina SENDSIZE y RECEIVESIZE como 30720. Tenga en cuenta

que este es el máximo permitido; por lo tanto, si el registro más grande es 1024,

la cantidad real de datos enviados es 1024 más algunos cientos de bytes de

información de control, no 30720 bytes.

Recuerde: hay una definición de sesión por lote APPLID.

101

Installation

PCT Definiciones

La definición de todas las transacciones de VSHARE se enumeran a continuación.

La primera definición del PCT, TCC, es para el sistema en línea VSHARE.

La segunda definición, TCCB, es para el programa LU 6.2 que se comunica con la región por lotes. A esta transacción se le puede dar el nombre que se desee. Puede definirse cualquier número de estos transidos por lotes. Al hacer que cada aplicación dentro de la región CICS utilice un tranid de lote exclusivo, los sistemas de devolución de cargo se pueden utilizar para cobrar al grupo apropiado por los recursos CICS utilizados. No dé seguridad a esta transacción o CICS rechazará la solicitud de conexión. VSHARE proporciona seguridad al conjunto de datos al proporcionar al usuario el módulo de salida de seguridad, CSIVSBSC. Consulte la sección "Seguridad de archivos" en la página 111 para obtener más detalles.

Al definir el TCCB de tranid por lotes con un nivel de prioridad de 0, CICS da servicio a los programas en línea antes que, a los programas por lotes, y el impacto en los programas en línea se mantiene al mínimo. La tercera definición, TCCR, es para acceder a información sobre un archivo VSAM definido de forma remota dentro de CICS. Esta transacción debe definirse para todas las regiones CICS que poseen archivos remotos. Por ejemplo, un trabajo por lotes está conectado a CICSPRD1 y está accediendo a un archivo VSAM propiedad de una región CICS denominada CICSPRD2. La transacción TCCR debe definirse en CICSPRD2 para que VSHARE pueda obtener información sobre el archivo. El archivo remoto se puede definir para usar ISC o MRO.

102

Installation

La cuarta definición es para inicializar la interfaz CMS en la región CICS. La

transacción TCXI debe ejecutarse en todas las regiones CICS utilizando la interfaz

CMS. Consulte la sección “Instalación del componente CICS CMS” en la página

107.

PPT Definición

VSHARE tiene una serie de programas y mapas que necesitan definiciones PPT.

La siguiente figura muestra una definición de Ensamblador y COBOL. Hay tres

columnas enumeradas a continuación con los encabezados Assembler, COBOL y

BMS Maps. Utilice el primer formato DEFINE para las columnas con los títulos

"Ensamblador" y "Mapas BMS". Sustituya cada nombre de estas columnas por

"nombre1" en el parámetro PROGRAMA. Para cada nombre de la columna con el

título "COBOL", utilice el segundo formato DEFINE. Sustituya cada nombre de la

columna COBOL por "nombre2" en el parámetro PROGRAMA. Además de definir

estos programas en la región CICS que ejecuta VSHARE, el programa CSIVSC06

debe definirse en todas las regiones que poseen archivos VSAM definidos de

forma remota a los que se accederá mediante VSHARE.

Nota 1: para CICS 3.3 y superior

FCT Definición

VSHARE guarda toda la información del sistema, el trabajo y el historial en un

conjunto de datos de control de KSDS. Este conjunto de datos debe definirse con

el nombre FCT CSIVSFL. La siguiente figura contiene la definición necesaria.

103

Installation

Definir los Trabajos y las El siguiente paso es definir todas las regiones CICS y los nombres de trabajos

Regiones CICS Elegibles elegibles para ejecutar VSHARE. Esto se logra a través del sistema en línea V

VSHARE. Consulte el capítulo “Control en línea” en la página 41.

La pantalla Mantenimiento del sistema se utiliza para definir toda la información

que necesita un trabajo por lotes para comunicarse con la región CICS. Recuerde

definir el CICS APPLID, no el nombre del trabajo CICS.

104

Installation

La pantalla Mantenimiento de trabajos, a continuación, se utiliza para definir los

nombres de los trabajos por lotes elegibles. Tenga en cuenta que no es necesario

definir todos los nombres de trabajos individuales. Por ejemplo, si todos los

nombres de trabajos que comienzan con "FSI" son elegibles para usar VSHARE,

solo defina un nombre de trabajo en la pantalla Mantenimiento de trabajos con

el nombre "FSI". VSHARE luego intercepta cualquier nombre de trabajo que

comience con "FSI".

Instalar la Interfaz de Servicios de Memoria Cruzada

La interfaz Cross Memory Services (CMS) permite el movimiento de datos entre

la región CICS y el trabajo por lotes directamente a través de la memoria de la

computadora. Esto proporciona un vehículo de comunicaciones más rápido que

LU 6.2. La restricción de los servicios de memoria cruzada es que el trabajo por

lotes y la región CICS deben estar ubicados en la misma CPU. Si el trabajo y CICS

están en diferentes CPU o en diferentes imágenes PR / SM, se debe utilizar LU

6.2 como dispositivo de comunicaciones. Tenga en cuenta que incluso si CMS se

utiliza todo el tiempo, LU 6.2 todavía se utiliza para iniciar la transacción VSHARE

en CICS. Por este motivo, las definiciones de VTAM y las definiciones de sesión y

conexión CICS siguen siendo necesarias.

Hay dos componentes en la interfaz CMS. Siga los siguientes pasos para instalar

cada componente.

105

Installation

Instalación del componente 1. Autorización de la biblioteca

de Batch CMS

El proceso de instalación debe ejecutarse desde una biblioteca de carga

autorizada por APF. Todos los módulos VSHARE que requieren autorización

APF se encuentran en la biblioteca de carga de productos

VSHARE.APF.LOAD. Los módulos de este conjunto de datos se pueden

copiar a una biblioteca de carga APF existente, o se puede autorizar la

propia biblioteca de productos.

2. Selección de SVC

La rutina de SVC de CMS puede funcionar como el único módulo asociado con un

SVC o como una "interfaz" para una rutina de SVC existente. Por lo tanto, si hay

pocas o ninguna entrada SVC libre, se puede elegir una que ya esté en uso en el

sistema, sin afectar la rutina existente. Sin embargo, no utilice un SVC de tipo 1 o

tipo 6 como front-end.

3. Instalación dinámica de SVC

Para instalar el programa de interfaz de usuario de CMS, es necesario ejecutar un

trabajo ubicado en la biblioteca de instalación llamado INSTCMS después de

cada IPL. El JCL de ejecución para el programa y sus parámetros son los

siguientes:

En el ejemplo anterior, CMS se está instalando como SVC 219. El programa de

instalación y los otros programas a los que llama están en VSHARE.APF.LOAD.

Los parámetros son posicionales y no deben incluir espacios en blanco o

caracteres innecesarios. Los posibles valores de los parámetros y sus significados

son los siguientes:

106

Installation

Parm1: Tipo de solicitud I— Instale el CMS especificado en parm2 usando el número SVC en parm3 R — Elimine el CMS especificado en parm2; no se requiere el número SVC E — Habilita el CMS D — Deshabilita el CMS S— Imprime el estado de todos los sistemas, incluido el historial de instalación

Parm2: Componente del sistema CMS: comunicación de servicios de memoria cruzada

Parm3: número de SVC # de SVC: número de SVC utilizado para los servicios de memoria cruzada.

Instalación del componente Se debe inicializar cualquier región que use la interfaz VSHARE CMS. La CICS CMS inicialización de CMS la realiza el programa CICS CSIVSCXI. CSIVSCXI se puede ejecutar de dos formas. Primero, se puede ejecutar a través de la transacción TCXI de CICS. Consulte las definiciones de PCT para conocer los requisitos de TCXI. La segunda forma es poner el programa CSIVSCXI en el PLT de inicio para su ejecución. A continuación, se muestra un ejemplo de la entrada PLT.

Modificar el procedimiento de En la biblioteca de instalación hay un miembro llamado RECOVER. Este recuperación de archivos es el JCL necesario para realizar copias de seguridad de todos los de nivel 2 cambios de archivo durante la recuperación de Nivel 2. Si decide no implementar la recuperación de Nivel 2, omita este paso. Esta plataforma JCL debe personalizarse según los requisitos de instalación. El JCL también se puede convertir en un procedimiento. A continuación, se ofrece una explicación del trabajo de tres pasos.

Paso 1: este paso elimina y define un conjunto de datos ESDS VSAM. Este conjunto de datos ESDS se usa temporalmente dentro de este trabajo. Cambie el nombre del archivo para cumplir con los estándares de instalación.

Paso 2: este paso carga el diario secuencial creado durante la ejecución del trabajo por lotes en el archivo ESDS recién definido.

Paso 3: este paso anula todas las actualizaciones según los parámetros dados. Consulte el capítulo “Recuperación” en la página 18 para obtener más detalles.

107

Installation

The VSAM Open/Close Routing Facility

Introducción El BIMVSR / MVS es una función de enrutamiento VSAM Open / Close que intercepta el procesamiento VSAM OPEN y CLOSE. Esta instalación permite que varios productos de CSI International intercepten el procesamiento Open y/o Close en un orden prescrito. La función de enrutamiento se inicia y detiene automáticamente cuando se inician o detienen los productos individuales de CSI International.

En la actualidad, los siguientes productos de CSI International requieren esta función de enrutamiento:

• OVERRIDE-BUFF Dynamic VSAM Buffering • RELIANT-JOURNAL VSAM Batch Journaling • M-PACT-PACK Automatic VSAM File Compression • VSHARE Multiple Region VSAM File Sharing

Installing the VSAM Los programas para VSHARE deben ejecutarse desde una biblioteca de Open/Close Routing Facility carga autorizada de APF. Esta biblioteca también debe incluirse en la Modules lista de enlaces. Esto significa que la biblioteca debe aparecer en both miembros IEAAPFxx y LNKLSTxx en SYS1.PARMLIB.

Puede descargar la función de enrutamiento de la web (consulte “Instalación de VSHARE desde una descarga web” en la página 89) o recibirla en una cinta separada con la etiqueta “BIMVSR / MVS”. Una carta de presentación con la cinta proporciona más información.

Para instalar el recurso de enrutamiento desde cinta, cree y envíe el siguiente JCL:

No continúe con el siguiente paso de instalación hasta que confirme que

el Routing Facility está instalado ejecutando el programa BIMVSRCM con

parm = 'INIT'.

108

Installation

Eliminacion de VSAM Solo necesita quitar el enrutador si tiene problemas con su sistema que no se

Open/Close Routing Facility corrigen desactivando los productos individuales. Puede activar y desactivar los

productos que utilizan el enrutador, como VSHARE, mediante las interfaces

proporcionadas con cada producto.

El siguiente ejemplo contiene el JCL necesario para eliminar el enrutador de su

sistema:

El módulo de comando del enrutador (BIMVSRCM) puede realizar varias

funciones según el valor de PARM especificado. Cada valor se describe en la

tabla siguiente.

PARM=Valor Función

SHUT Impide que el enrutador envíe productos CSI, pero deja el enrutador en su sistema.

INIT Inicia el enrutador y reanuda el envío de los productos CSI. Esta función se puede realizar para invertir la función SHUT.

DELT01 Elimina el enrutador de su sistema y restaura los punteros de dirección originales. Este proceso "desengancha" cualquier producto del vendedor que se inició después del primer producto CSI que utiliza este enrutador.

DELT02 Elimina el enrutador de su sistema y restaura los punteros de dirección originales de IBM. Este proceso "desengancha" todos los productos del vendedor que "enganchan" el proceso de apertura / cierre de VSAM.

109

Installation

Routing Facility Messages Los siguientes mensajes son emitidos por VSAM Open / Close Routing Facility.

VSAM Open/Close Routing Facility Messages

FSIVSR-001 xxxxxxxx MODULE NOT FOUND Explicación: El enrutador no pudo encontrar el módulo “xxxxxxxx”. Acción del usuario: asegúrese de que la biblioteca que contiene el programa “xxxxxxxx” sea una biblioteca de lista de enlaces.

FSIVSR-003 NO INIT PARMS (error description) Acción del usuario: solicite asistencia técnica para este mensaje.

FSIVSR-005 TABLE xxxxxxxx NOT FOUND Explicación: El enrutador no pudo encontrar la tabla “xxxxxxxx”. Acción del usuario: asegúrese de que la biblioteca que contiene la tabla “xxxxxxxx” sea una biblioteca de lista de enlaces.

FSIVSR-006 FSIVSR NOT ACTIVE Acción del usuario: solicite asistencia técnica para este mensaje.

FSIVSR-008 PAGE ERROR (error description) Acción del usuario: solicite asistencia técnica para este mensaje.

FSIVSR-009 MODULE xxxxxxxx FOR MOD yyyyyyyy SUBROUTINE ERROR Acción del usuario: solicite asistencia técnica para este mensaje.

FSIVSR-010 GETMAIN ERROR (error description) Acción del usuario: solicite asistencia técnica para este mensaje.

FSIVSR-011 ROUTER ALREADY ACTIVE Explicación: El enrutador ya se ha activado.

FSIVSR-013 ERROR RETURNED FROM SWAREQ (error description) Acción del usuario: solicite asistencia técnica para este mensaje.

FSIVSR-014 NO ACB AND TIOT MATCH Acción del usuario: solicite asistencia técnica para este mensaje.

FSIVSR-015 FREEMAIN ERROR (error description) Acción del usuario: solicite asistencia técnica para este mensaje.

FSIVSR-016 NO ENTRY IN TABLE FSIVSRTB FOR APPL Acción del usuario: solicite asistencia técnica para este mensaje.

110

Installation

Activación y desactivación La biblioteca de instalación contiene los miembros STRTVSB, STOPVSB y

de VSHARE STOPRTR. El miembro STRTVSB activa VSHARE y el miembro STOPVSB detiene

VSHARE.

Debe ejecutar el trabajo STRTVSB para cada conjunto de datos de control

creado, con el DD CSIVSFL apuntando al conjunto de datos de control. Consulte

la sección “Actualizar el miembro de parámetro CSIVSBDS” en la página 95 para

obtener más información.

Si realiza cambios en el conjunto de datos de control después de que se haya

iniciado VSHARE, deberá ejecutar el trabajo REFRVSB para actualizar una tabla

incore.

Para activar VSHARE para un trabajo en particular, se debe incluir un STEPLIB en

el JCL que apunte a la biblioteca VSHARE.LOAD.

Puede desactivar VSHARE de tres formas:

• La primera forma: elimine STEPLIB del JCL.

• La segunda forma: elimine el nombre del trabajo del sistema VSHARE. Consulte

el capítulo “Control en línea” en la página 41 para obtener detalles sobre cómo

definir y eliminar nombres de trabajos de VSHARE.

• La tercera forma: ejecute el trabajo STOPVSB. Este trabajo simplemente evita

que se invoque a VSHARE. No se recomienda ejecutar el trabajo STOPRTR. Este

trabajo restablece los punteros y puede detener la ejecución de productos de

otros proveedores si se iniciaron después de VSHARE.

Desactivación de archivos El procesamiento de archivos DeVSHARE se puede excluir para archivos

específicos dentro de un trabajo codificando un operando de fecha de

vencimiento de EXPDT = 1993/333 en sus declaraciones MVS DD.

La desactivación de archivos debe utilizarse sólo si existe la certeza de que CICS

no está actualizando el archivo durante la ejecución por lotes excluidos.

Seguridad de archivos Durante la apertura de un conjunto de datos, VSHARE llamará al módulo

CSIVSBSC. CSIVSBSC emite una macro RACROUTE para determinar si el trabajo

tiene la autoridad adecuada para acceder al conjunto de datos. Este módulo

tendrá el nombre del conjunto de datos, el tipo de acceso y el volumen en el que

reside el conjunto de datos. Hay un ejemplo de esta fuente en la biblioteca de

instalación que puede ser modificado por la instalación para cumplir con sus

necesidades de seguridad. Cuando se modifica, el módulo de enlace editado

debe colocarse en su biblioteca de ejecución de VSHARE. CSIVSBSC solo debe

modificarse si hay un problema con el paquete de seguridad existente.

111

Mensajes y códigos

Messages and Codes FSIVSBAI Mensajes

FSIVSBAI01 FSI-VSHARE NOT ACTIVE, DIRECT CALLS WILL BE IGNORED.

Explicación: Durante la ejecución por lotes, se solicitó un punto de sincronización o una reversión explícita, pero VSHARE determinó que el trabajo se estaba ejecutando en modo autónomo. Este mensaje informa al usuario que cualquier punto de sincronización o solicitud de retrotracción se ignorará porque CICS no gestiona la I/O. Acción del sistema: solo mensaje informativo y el procesamiento continúa. Respuesta del usuario: ninguna.

Mensajes de Mantenimiento en Línea

VSHARM1n-001 COMMAREA LENGTH IS INVALID.

Explicación: Los programas en línea de VSHARE recibieron un error de longitud COMMAREA. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: este es un mensaje interno de VSHARE. Póngase en contacto con el soporte técnico de CSI.

VSHARM1n-002 ENTER THE DESIRED SEARCH NAME AND PRESS ENTER.

Explicación: No se ingresó el nombre de búsqueda para la pantalla que se está ejecutando. Acción del sistema: la pantalla se vuelve a mostrar y el programa espera a que se ingrese un nombre. Respuesta del usuario: introduzca los criterios de búsqueda deseados. Consulte el capítulo “Control en línea” en la página 41 para obtener más detalles.

VSHARM1n-003 INVALID FUNCTION WAS ENTERED. ENTER AN A, D, OR C ONLY.

Explicación: Durante el mantenimiento del sistema o del trabajo, se ingresó un código de función no válido. Acción del sistema: se muestra un mensaje y el campo está resaltado. Respuesta del usuario: introduzca una letra de función correcta. Consulte el capítulo "Control en línea" en página 41 para obtener detalles sobre el campo.

VSHARM1n-004 INVALID PF KEY. MAKE SELECTION AND PRESS ENTER.

Explicación: Se ingresó una clave PF que no es utilizada por el programa en línea. Acción del sistema: vuelva a mostrar la pantalla con el mensaje. Respuesta del usuario: Ingrese la clave PF adecuada. Consulte el capítulo “Control en línea” en la página 41 para obtener detalles sobre las teclas de atención adecuadas.

VSHARM1n-005 PROGRAM <progid> WAS NOT FOUND. CONTACT SYSTEMS PROGRAMMER.

Explicación: El programa PROGID de VSHARE no estaba disponible cuando otro programa de VSHARE intentó establecer un vínculo. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: póngase en contacto con el programador del sistema CICS. Es posible que la definición de CICS para este programa no esté completa o que la biblioteca VSHARE no esté disponible para CICS.

VSHARM1n-006 MAP FAILURE IN PROGRAM <progid>.

Explicación: El programa en línea VSHARE PROGID recibió una respuesta de error de correlación de CICS. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: póngase en contacto con un programador de sistemas CICS. Es posible que no se complete la definición de CICS para el mapa o que la biblioteca VSHARE no esté disponible para CICS.

113

Messages and Codes

VSHARM1n-007 PRESS PF3 TO PROCESS THE ADDITION.

Explicación: La edición se realizó correctamente para la adición del trabajo o sistema. Al presionar PF3, el trabajo o sistema se agregará al conjunto de datos de control. Acción del sistema: solo informativo. Respuesta del usuario: si desea agregar el trabajo o el sistema, presione PF3. Consulte el capítulo “Control en línea” en la página 41 para obtener más detalles.

VSHARM1n-008 PRESS PF3 TO PROCESS THE MODIFICATION.

Explicación: La edición se realizó correctamente para una modificación de un trabajo o una definición del sistema. Al presionar PF3, el trabajo o sistema se modificará con los cambios ingresados. Acción del sistema: solo informativo. Respuesta del usuario: si desea modificar el trabajo o la definición del sistema, presione PF3. Consulte el capítulo “Control en línea” en la página 41 para obtener más detalles.

VSHARM1n-009 PRESS PF3 TO PROCESS THE DELETION.

Explicación: La edición se realizó correctamente para la eliminación del trabajo o sistema ingresado. Al presionar PF3, el trabajo o sistema se eliminará del conjunto de datos de control. Acción del sistema: solo informativo. Respuesta del usuario: si desea eliminar el trabajo o el sistema, presione PF3. Consulte el capítulo “Control en línea” en la página 41 para obtener más detalles.

VSHARM1n-010 ENTER REQUIRED FIELD.

Explicación: No se ingresó un campo obligatorio durante una definición de trabajo o sistema. Acción del sistema: solo información. La definición no se procesará hasta que se ingrese el valor para el campo resaltado. Respuesta del usuario: ingrese el campo requerido. Consulte el capítulo “Control en línea” en la página 41 para obtener detalles sobre el terreno.

VSHARM1n-011 FIELD MUST BE NUMERIC.

Explicación: El campo resaltado debe contener un valor numérico. Acción del sistema: solo informativo. La definición no se procesará hasta que el valor sea numérico. Respuesta del usuario: introduzca un valor numérico. Consulte el capítulo “Control en línea” en la página 41 para obtener detalles sobre el campo en cuestión.

VSHARM1n-012 THE INDICATOR MUST BE A Y OR N ONLY

Explicación: El campo resaltado debe ser una Y o una N. Acción del sistema: Solo informativo. La definición no se procesará hasta que el valor sea correcto. Respuesta del usuario: Ingrese una Y o una N. Consulte el capítulo “Control en línea” en la página 41 para obtener detalles sobre el campo en cuestión.

VSHARM1n-013 THIS FUNCTION KEY IS NOT ACTIVE.

Explicación: Se ingresó una clave PF que no es utilizada por el programa en línea.

Acción del sistema: vuelva a mostrar la pantalla con el mensaje.

Respuesta del usuario: Ingrese la clave PF adecuada. Consulte el capítulo “Control en línea” en la página

41 para obtener detalles sobre las teclas de atención adecuadas.

114

Messages and Codes

VSHARM1n-014 THE CONTROL DATASET <fctname> IS NOT DEFINED TO CICS.

Explicación: Un programa en línea de VSHARE recibió un DSIDERR de CICS al acceder al conjunto de datos de control de VSHARE. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: póngase en contacto con el programador de sistemas CICS. Es posible que no se complete la definición de CICS para el conjunto de datos.

VSHARM1n-015 THE CONTROL DATASET <fctname> IS DISABLED.

Explicación: Un programa en línea VSHARE recibió una respuesta DESHABILITADA de CICS al acceder al conjunto de datos de control de VSHARE. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: determine por qué el conjunto de datos está deshabilitado y habilite el conjunto de datos de control de VSHARE.

VSHARM1n-016 I/O ERROR WAS DETECTED WHILE READING CONTROL FILE.

Explicación: Las pantallas en línea de VSHARE detectaron un error de I/O al acceder al conjunto de datos de control. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: determine la causa del error de I/O del conjunto de datos de control.

VSHARM1n-017 NOT AUTHORIZED TO ACCESS THE CONTROL DATASET

Explicación: El usuario que ejecuta los programas en línea de VSHARE no tiene la autoridad adecuada para acceder al conjunto de datos de control. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: Comuníquese con la administración de seguridad para obtener la autoridad adecuada.

VSHARM1n-018 THE CONTROL DATASET <fctname> IS NOT OPENED.

Explicación: Los programas en línea de VSHARE recibieron una respuesta no abierta de CICS al acceder al conjunto de datos de control. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: determine la razón por la que el conjunto de datos de control está cerrado y ábralo.

VSHARM1n-019 THE <JOB>|<SYSTEM>|<HISTORY> RECORD FOR THIS <JOB>|<SYSTEM>|<HISTORY> WAS NOT FOUND

Explicación: Si se define un trabajo, se ingresó un nombre de región CICS que no se definió previamente. Si está revisando el historial, se ingresó un nombre de trabajo que no tenía un historial correspondiente. Acción del sistema: la pantalla se vuelve a mostrar y el programa espera nuevos datos. Respuesta del usuario: al definir un trabajo, asegúrese de que el nombre de CICS se haya introducido correctamente o de que la región se haya definido previamente. Si está revisando el historial, no se requiere nada.

VSHARM1n-020 THIS <JOB>|<SYSTEM> IS ALREADY DEFINED IN THE CONTROL FILE.

Explicación: Se intentó agregar un trabajo o una región CICS previamente definida a VSHARE. Acción del sistema: vuelva a mostrar la pantalla con el mensaje. Respuesta del usuario: asegúrese de que el trabajo o el nombre de la región CICS sea correcto o consulte la definición actual para el trabajo / región CICS.

115

Messages and Codes

VSHARM1n-021 A VSAM LENGERR HAS BEEN DETECTED

Explicación: Un programa VSHARE recibió un LENGERR de CICS mientras accedía al conjunto de datos de control. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: este es un error interno. Póngase en contacto con el soporte técnico de CSI.

VSHARM1n-022 THE CONTROL FILE HAS RUN OUT OF SPACE.

Explicación: Un programa VSHARE recibió una condición de falta de espacio de CICS al escribir en el archivo de control. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: el archivo de control debe definirse más grande.

VSHARM1n-023 THE <JOB>|<CICS REGION> WAS SUCCESSFULLY ADDED TO THE CONTROL FILE.

Explicación: El trabajo o la región CICS ingresada se agregó correctamente a VSHARE. Acción del sistema: solo informativo. Respuesta del usuario: ninguna

VSHARM1n-024 THE <JOB>|<CICS REGION> DATA WAS SUCCESSFULLY MODIFIED.

Explicación: El trabajo o la región CICS que se está modificando se procesó satisfactoriamente. Acción del sistema: solo informativo. Respuesta del usuario: ninguna

VSHARM1n-025 THE <JOB>|<CICS REGION> WAS SUCCESSFULLY DELETED.

Explicación: Mientras se realizaba el mantenimiento del sistema, la definición de trabajo o región seleccionada se eliminó correctamente. Acción del sistema: solo informativo. Respuesta del usuario: ninguna.

VSHARM1n-026 THE CICS REGION NAME ENTERED IS NOT DEFINED.

Explicación: El nombre de la región ingresado al definir un trabajo no se definió previamente en VSHARE. Acción del sistema: solo informativo. El trabajo no se agregará hasta que se ingrese una región válida. Respuesta del usuario: asegúrese de que el nombre esté escrito correctamente o agregue el sistema a VSHARE a través de la pantalla de mantenimiento del sistema.

VSHARM1n-027 THE BLOCK SIZE IS INCORRECT BASED ON THE LRECL.

Explicación: El tamaño de bloque elegido para el archivo de diario no es correcto. Acción del sistema: solo informativo. La nueva definición del archivo de diario no se actualizará sin un tamaño de bloque válido. Respuesta del usuario: ingrese un valor que sea múltiplo o el tamaño de registro ingresado más 4 bytes.

VSHARM1n-029 INVALID ACCESS TYPE. ENTER CMS OR LU62 ONLY

Explicación: El tipo de acceso ingresado no es válido. Acción del sistema: solo informativo. Se debe ingresar un tipo válido antes de aplicar la definición. Respuesta del usuario: introduzca LU62 o CMS. Consulte el capítulo “Control en línea” en la página 41 para obtener detalles sobre estos tipos.

116

Messages and Codes

VSHARM1n-031 I/O ERROR WAS DETECTED WHILE READING TEMP STORAGE.

Explicación: VSHARE recibió una respuesta de error de I/O de CICS después de acceder al almacenamiento temporal. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: póngase en contacto con los programadores del sistema. Hay algún problema con el almacenamiento temporal de CICS.

VSHARM1n-032 LENGTH ERROR WAS DETECTED WHILE READING TEMP STORAGE.

Explicación: VSHARE recibió una respuesta de error de longitud de CICS después de acceder al almacenamiento temporal. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: este es un error interno de VSHARE. Póngase en contacto con el soporte técnico de CSI.

VSHARM1n-033 QID ERROR WAS DETECTED WHILE READING TEMP STORAGE.

Explicación: VSHARE recibió un error QID de CICS después de acceder al almacenamiento temporal. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: este es un error interno de VSHARE. Póngase en contacto con el soporte técnico de CSI.

VSHARM1n-034 NOT AUTHORIZED TO ACCESS TEMPORARY STORAGE.

Explicación: La persona que ejecuta los programas en línea de VSHARE no tiene la autorización adecuada para leer el almacenamiento temporal. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: póngase en contacto con el programador de sistemas CICS para averiguar por qué es así.

VSHARM1n-035 THE REQUEST TO STOP THIS JOB HAS BEEN ISSUED.

Explicación: Se envió una solicitud en la pantalla de trabajo activo para detener un trabajo. Acción del sistema: solo informativo. Respuesta del usuario: ninguna. Consulte el capítulo “Control en línea” en la página 41 para obtener más detalles.

VSHARM1n-036 THE REQUEST TO CANCEL THIS JOB HAS BEEN ISSUED.

Explicación: Se presentó una solicitud en la pantalla de trabajo activo para cancelar un trabajo. Acción del sistema: solo informativo. Respuesta del usuario: ninguna. Consulte el capítulo “Control en línea” en la página 41 para obtener más detalles.

VSHARM1n-037 THE REQUEST TO RESTART THIS JOB HAS BEEN ISSUED.

Explicación: Se presentó una solicitud en la pantalla de trabajo activo para reiniciar un trabajo detenido anteriormente. Acción del sistema: solo informativo. Respuesta del usuario: ninguna. Consulte el capítulo “Control en línea” en la página 41 para obtener más detalles.

VSHARM1n-038 THIS JOB IS NO LONGER ACTIVE.

Explicación: Se estaba analizando un trabajo en el proceso de trabajo activo de VSHARE y el trabajo se completó.

Acción del sistema: la información sobre el trabajo ya no está disponible. Se muestra una pantalla sin información.

Respuesta del usuario: ninguna. Consulte el capítulo “Control en línea” en la página 41 para obtener más detalles.

117

Messages and Codes

VSHARM1n-039 THE REQUEST RATE HAS BEEN SUCCESSFULLY CHANGED

Explicación: Se procesó correctamente una solicitud para cambiar la tasa de solicitud de un trabajo. Acción del sistema: solo información. Respuesta del usuario: ninguna. Consulte el capítulo “Control en línea” en la página 41 para obtener más detalles.

VSHARM1n-040 THE REQUEST RATE MUST BE NUMERIC.

Explicación: Se ingresó una tasa de solicitud no numérica. Acción del sistema: resalte el campo y vuelva a mostrar la pantalla. Respuesta del usuario: introduzca un valor numérico.

VSHARM1n-042 NOT AUTHORIZED TO INQUIRE ON FILE CONTROL TABLE.

Explicación: Mientras intentaba mostrar una pantalla de estadísticas de conjunto de datos, VSHARE recibió una respuesta no autorizada de CICS mientras consultaba al FCT. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: póngase en contacto con los programadores del sistema y averigüe por qué su ID de usuario no tiene autorización para consultar con CICS FCT.

VSHARM1n-043 THIS FCT NAME IS NOT IN THE CICS TABLES.

Explicación: Al intentar mostrar una pantalla de estadísticas de conjunto de datos en el historial, VSHARE no pudo encontrar el FCT del archivo escrito en el historial. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: ninguna. La entrada FCT se eliminó desde la ejecución de trabajos como se indica en el registro histórico de VSHARE.

VSHARM1n-044 AN INVALID REQUEST RETURNED AFTER A TS READ.

Explicación: VSHARE recibió una respuesta no válida de CICS al leer su registro de almacenamiento temporal. Acción del sistema: el procesamiento se detiene. Respuesta del usuario: esto puede deberse a una infracción de almacenamiento. Póngase en contacto con los programadores del sistema. Si el problema persiste, comuníquese con el soporte técnico de CSI.

VSHARM1n-045 FSI-VSHARE HAS COMPLETED.

Explicación: El sistema en línea VSHARE se completó correctamente. Acción del sistema: este es un mensaje informativo. No ocurrió ningún error. Respuesta del usuario: ninguna.

118

Messages and Codes

Batch Mensajes

FSIVSHAR-100 NOT ENOUGH PCBS DEFINED.

Explicación: Un módulo solicitó una placa de circuito impreso y descubrió que estaban todas usadas. Acción del sistema: el programa se cancela. Respuesta del usuario: póngase en contacto con el soporte técnico de CSI.

FSIVSHAR-101 MODULE XXXXXXXX NOT FOUND

Explicación: Se solicitó el módulo xxxxxxxx y no se pudo encontrar. Acción del sistema: el programa se cancela. Respuesta del usuario: asegúrese de que las tarjetas STEPLIB DD adecuadas estén en su lugar y vuelva a ejecutar el trabajo. Cuando el módulo no encontrado es BIMVSBTB, asegúrese de que el nombre del conjunto de datos para el archivo de control TCCVSCTL, tal como está ensamblado en BIMVSBDS y vinculado a la biblioteca de carga VSHARE por lotes, coincida con el nombre del conjunto de datos de la tarjeta DD utilizado por CICS para definir el conjunto de datos de control.

FSIVSHAR-102 DDNAME NOT FOUND ON DST CHAIN.

Explicación: Se perdió un bloque de control para una tarjeta DD. Acción del sistema: el programa se cancela. Respuesta del usuario: intente volver a ejecutar el trabajo. Si el error se repite, recopile los volcados y comuníquese con el soporte técnico de CSI.

FSIVSHAR-103 ERROR RETURNED FROM XXXXXXXX

Explicación: Un programa xxxxxxxx devolvió el control al llamante con un código de retorno distinto de cero. Acción del sistema: depende de las circunstancias. Respuesta del usuario: busque otros mensajes pertinentes y siga sus instrucciones, si las hay. Si el programa termina, intente ejecutarlo de nuevo. Si el error ocurre nuevamente, llame al soporte técnico de CSI con volcados.

FSIVSHAR-104 ERROR INITIALIZING JOURNALING.

Explicación: La inicialización del diario encontró un problema. Acción del sistema: depende del problema. Respuesta del usuario: consulte otros mensajes relacionados.

FSIVSHAR-105 ESTAE ERROR.

Explicación: El programa ESTAE encontró un error. Acción del sistema: el programa se cancela. Respuesta del usuario: póngase en contacto con el soporte técnico de CSI.

FSIVSHAR-106 NO PARMS SPECIFIED ON EXECUTE CARD.

Explicación: Se ejecutó un programa que requería que se pasaran los parámetros, pero ninguno. Acción del sistema: el programa se cancela. Respuesta del usuario: revise la sección del manual que trata de esta función.

119

Messages and Codes

FSIVSHAR-107 GETMAIN ERROR.

Explicación: Un programa emitió un almacenamiento GETMAIN y MVS devuelve un error. Acción del sistema: el programa se cancela. Respuesta del usuario: consulte el mensaje de IBM relacionado con esto. Si no tiene ninguno, comuníquese con el soporte técnico de CSI.

FSIVSHAR-108 INVALID PARM SPECIFIED.

Explicación: Un programa pasó un parámetro que no reconoció. Acción del sistema: el programa se cancela. Respuesta del usuario: revise la sección del manual que trata de esta función.

FSIVSHAR-109 FREEMAIN FAILED

Explicación: Un programa emitió un FREEMAIN de almacenamiento y MVS devolvió un error. Acción del sistema: dependiente. Respuesta del usuario: si el programa se cancela, llame al soporte técnico de CSI. Si el programa finaliza normalmente, ignórelo.

FSIVSHAR-110 TABLE NOT REFRESHED, NOT LOADED.

Explicación: Se emitió una solicitud para actualizar la tabla de control y aún no se cargó. Acción del sistema: el programa devuelve un código de retorno incorrecto. Respuesta del usuario: ejecute el trabajo para cargar la tabla.

FSIVSHAR-111 TABLE ALREADY LOADED.

Explicación: Se emitió una solicitud para cargar la tabla de control cuando ya estaba cargada. Acción del sistema: el programa devuelve un código de retorno incorrecto. Respuesta del usuario: ignore si la tabla ya se cargó o ejecute el trabajo de actualización.

FSIVSHAR-112 CDE LOAD ERROR.

Explicación: El programa encontró un error al intentar agregar una entrada a la cadena CDE. Acción del sistema: el programa devuelve un código de retorno incorrecto. Respuesta del usuario: intente volver a ejecutar el programa. Si el error se repite, llame al soporte técnico de CSI.

FSIVSHAR-113 CDE UNLOAD ERROR.

Explicación: El programa encontró un error al intentar eliminar una entrada de la cadena CDE. Acción del sistema: el programa devuelve un código de retorno incorrecto. Respuesta del usuario: intente volver a ejecutar el programa. Si el error se repite, llame al soporte técnico de CSI.

FSIVSHAR-114 SUBPOOL NOT FOUND.

Explicación: Un programa solicitó una función de almacenamiento de una sub agrupación en particular y el almacenamiento no se encontró allí. Acción del sistema: los programas devuelven un código de retorno incorrecto. Respuesta del usuario: intente volver a ejecutar el programa. Si el error vuelve a ocurrir, llame al soporte técnico de CSI

FSIVSHAR-115 DEQ INVOKED RETURN=XXXXXXXX.

Explicación: un programa llamado módulo DEQ y recibió un código de retorno distinto de cero. Acción del sistema: el programa se cancela. Respuesta del usuario: intente volver a ejecutar el programa. Si el error se repite, llame al soporte técnico de CSI.

120

Messages and Codes

FSIVSHAR-116 INTERNAL ERROR: (DESCRIPTION).

Explicación: se produjo un error interno. Acción del sistema: el programa se cancela. Respuesta del usuario: póngase en contacto con el soporte técnico de CSI.

FSIVSHAR-117 UPDATE HAS/HAS NOT OCCURED - RECOVERY REQUIRED/NOT REQUIRED ON ABEND.

Explicación: describe si se ha producido una actualización y, como resultado, si será necesaria la recuperación si se produce una terminación anormal. Acción del sistema: ninguna. Respuesta del usuario: ninguna.

FSIVSHAR-118 MODULE CSIVSBSG FOUND CMCB ADDRESS 0.

Explicación: Se encontró el módulo de almacenamiento, pero la dirección CMCB era 0. Acción del sistema: Ninguna. Respuesta del usuario: ninguna.

FSIVSHAR-119 ENQ FAILED RETURN=XXXXXXXX.

Explicación: Error en una función de puesta en cola. Acción del sistema: el programa se cancela. Respuesta del usuario: póngase en contacto con el soporte técnico de CSI.

FSIVSHAR-120 CSIVSBER FORCING ABEND.

Explicación: El módulo de manejo de errores forzó una terminación anormal. Acción del sistema: el programa se cancela. Respuesta del usuario: consulte otros mensajes relacionados.

FSIVSHAR-121 LOAD ERROR IN MODULE CSIVSBLD FOR MOD XXXXXXXX

Explicación: El programa CSIVSBLD encontró un error al cargar el módulo xxxxxxxx. Acción del sistema: el programa se cancela. Respuesta del usuario: consulte otros mensajes relacionados.

FSIVSHAR-122 ZERO LENGTH SPECIFIED ON MSG REQUEST.

Explicación: Se realizó una solicitud al manejador de mensajes con un mensaje de longitud cero. Acción del sistema: ninguna. Acción del usuario: póngase en contacto con el soporte técnico de CSI.

FSIVSHAR-123 ERROR RETURN FOR APPLID XXXXXXXX PROCESSING CONTINUES.

Explicación: Se devolvió un error para APPLID xxxxxxxx, pero el procesamiento continuó. Acción del sistema: ninguna. Respuesta del usuario: ninguna.

FSIVSHAR-124 NO JOURNAL REC AFTER JOB REC.

Explicación: Se solicitó el registro en diario para este trabajo, pero no se encontró ningún registro en el área de almacenamiento de control. Acción del sistema: el programa se cancela. Respuesta del usuario: Ejecute el trabajo para actualizar el área de almacenamiento de control y luego vuelva a ejecutar el trabajo.

121

Messages and Codes

FSIVSHAR-125 NO JOB/CICS RECORD FOUND IN CSIVSBTB.

Explicación: Faltaba un registro de trabajo o CICS en el área de almacenamiento de control.

Acción del sistema: el programa se cancela.

Respuesta del usuario: Ejecute el trabajo para actualizar el área de almacenamiento de control y luego vuelva a

ejecutar el trabajo.

FSIVSHAR-126 NOT ABLE TO SET EOJ JOB HOOK, PROCESSING IS ABENDED.

Explicación: El programa no pudo establecer la dirección de fin de rutina de trabajo.


Respuesta del usuario: vuelva a ejecutar el trabajo. Si el error se repite, llame al soporte técnico de CSI.

FSIVSHAR-127 NOT ABLE TO ACTIV/ALLOC/SEND BATCH APPL, PROCESSING IS ABENDED.

Explicación: El programa encontró un error con el lote APPLID.


Respuesta del usuario: consulte otros mensajes relacionados.

FSIVSHAR-128 NOT ABLE TO ACTIV/ALLOC/SEND BATCH APPL.

Explicación: El programa encontró un error con el lote APPLID.

Acción del sistema: ninguna.

Respuesta del usuario: ninguna.

FSIVSHAR-129 ERROR FOR MOD XXXXXXXX RTC WAS XXXXXXXX RSN XXXXXXXX.

Explicación: Se encontró un módulo y se produjo un error, y se devolvieron los códigos de devolución y motivo.

Acción del sistema: dependiente.


FSIVSHAR-130 DSN INPUT ONLY.

Explicación: Se interceptó la apertura y el conjunto de datos estaba abierto solo para entrada.



FSIVSHAR-131 XXXXXXXX DDNAME DISABLED.

Explicación: Se encontró que xxxxxxxx DDNAME estaba inhabilitado en CICS.


Respuesta del usuario: habilite el archivo en CICS y vuelva a ejecutar el trabajo.

FSIVSHAR-132 XXXXXXXX NOT INTERCEPTED

Explicación: No se interceptó xxxxxxxx DDNAME.



FSIVSHAR-133 BLDL FAILED FOR MOD XXXXXXXX.

Explicación: El programa emitió un BLDL para el mod xxxxxxxx y falló.


Respuesta del usuario: asegúrese de que se incluye el JOBLIB / STEPLIB adecuado.

122

Messages and Codes

FSIVSHAR-134 CMCB ADDRESS NOT FOUND.

Explicación: El programa estaba buscando el bloque de control CMCB y no pudo encontrarlo.


Respuesta del usuario: llame al soporte técnico de CSI.

FSIVSHAR-135 ACB DID NOT OPEN.

Explicación: El programa verificó el ACB después de abrir, y no estaba abierto.


Respuesta del usuario: consulte los mensajes de IBM para ver por qué no se abrió el archivo.

FSIVSHAR-136 FSI-VSHARE I/O ROUTINE NOT LOADED.

Explicación: El programa obtuvo la dirección de la rutina de I/O de VSHARE VSAM y era cero.



FSIVSHAR-137 ERROR TYPE IN VSAM RECORD.

Explicación: El programa encontró un tipo de registro no válido en el archivo de control.



FSIVSHAR-138 INVALID RECORD IN CONTROL FILE.

Explicación: El programa encontró un registro no válido en el archivo de control.


Respuesta del usuario: póngase en contacto con el soporte técnico de CSI.

FSIVSHAR-139 SWA ERROR INCOUNTERED.

Explicación: El programa intentó acceder al área de trabajo del sistema y encontró un error.



FSIVSHAR-140 VSAM ERROR.

Explicación: El programa intentó ejecutar una función VSAM y falló.



FSIVSHAR-141 SEND/RECEIVE FAILED - RETRY BEING ATTEMPTED.

Explicación: El programa emitió un envío o recepción y falló.

Acción del sistema: reintentos del programa.


FSIVSHAR-142 SEND/RECEIVE FAILED.

Explicación: El programa emitió un envío o recepción y falló.



123

Messages and Codes

FSIVSHAR-143 EXLST ERROR - LIST ADDR XXXXXXXX.

Explicación: VSAM encontró un error con EXLST en la dirección xxxxxxxx.



FSIVSHAR-144 REQUEST ERROR - REQUEST XXXXXXXX.

Explicación: Se emitió una solicitud interna no válida en la dirección xxxxxxxx.



FSIVSHAR-145 KEY LENGTH ZERO.

Explicación: Se encontró una longitud de clave de cero para el archivo.



FSIVSHAR-146 SUBROUTINE ERROR (SUBROUTINE).

Explicación: Se encontró un error en la subrutina.



FSIVSHAR-147 RACF ERROR RETURN - XXXXXXXX REASON - XXXXXXXX.

Explicación: La verificación de seguridad devolvió una devolución y un código de motivo.


Respuesta del usuario: asegúrese de que se permita el acceso al conjunto de datos.

FSIVSHAR-148 RECEIVE ERROR RETURNED.

Explicación: El programa de comunicación tuvo un error durante la recepción.



FSIVSHAR-149 INVALID REQUEST CODE IN USER CALL.

Explicación: El programa de usuario realizó una llamada directa no válida a VSHARE.


Respuesta del usuario: corrija la solicitud y vuelva a ejecutarla.

FSIVSHAR-150 FSIVSHARE NOT ACTIVE, DIRECT CALLS WILL BE IGNORED.

Explicación: El programa de usuario realizó una llamada directa a VSHARE sin que estuviera activo.


Respuesta del usuario: active VSHARE o ignore el mensaje.

FSIVSHAR-154 USER EXCLUDED DATASET

Explicación: DD especificó 99/333 para la fecha de vencimiento.

Acción del sistema: el conjunto de datos está excluido de VSHARE.


124

Messages and Codes

FSIVSHAR-199 (Informational Messages).

Explicación: Estos son solo mensajes informativos.



125

Messages and Codes

Journal Mensajes

FSIVSHAR-200 WARNING - UPDATE IN PROGRESS INDICATED AT TERMINATION BUT I/O TYPE WAS NOT DELETE, ADD, OR REWRITE.

Explicación: El programa por lotes indicó que había una I/O en curso en el momento de la terminación. Sin embargo,

la operación de I/O no habría cambiado el archivo de usuario.

Acción del sistema: no se creará ningún registro de diario para las I/O en curso al finalizar. Esto es solo una

advertencia y el procesamiento de terminación continuará normalmente.

Respuesta del usuario: ninguna. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-201 RECOVERY PARAMETER VALUES FOR THIS STEP ARE: JOBNAME=xxxxxxxx JOBNUM=xxxx PGMSTEP=xxxxxxxx

PROCSTEP=xxxxxxxx.

Explicación: Algunos o todos los parámetros enumerados podrían usarse como entrada para el trabajo de

recuperación para realizar copias de seguridad de los cambios hasta el comienzo de este paso. Tenga en cuenta que

PGMSTEP es el nombre del paso que contiene la instrucción EXEC PGM =. PROCSTEP es el nombre del paso que

contiene la instrucción EXEC PROC, si se utiliza.

Acción del sistema: solo informativo.

Respuesta del usuario: ninguna

FSIVSHAR-202 JOURNAL MODULE CALLED WITH INVALID OPERATION CODE.

Explicación: El programa por lotes llamó al módulo de registro por diario con un código de operación no válido en su

lista de parámetros. Es posible que el almacenamiento de la lista de parámetros esté dañado.

Acción del sistema: conjunto de códigos de retorno y control devuelto al programa por lotes.

Respuesta del usuario: consulte el programa de aplicación para ver si hay posibles infracciones de almacenamiento. Si

el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-203 JOURNAL FILE OPEN REQUEST FAILED.

Explicación: Este módulo llamó al módulo de I/O de diario para abrir el archivo de diario, pero recibió un código de

retorno distinto de cero. El registro de trabajos puede mostrar más mensajes.

Acción del sistema: establezca el código de retorno y regrese a la persona que llama.

Respuesta del usuario: revise el registro de trabajos para ver los mensajes relacionados. Revise la información de la

revista en línea para asegurarse de que las definiciones de los archivos de la revista sean correctas. Además, intente

examinar el archivo de diario o mostrar sus atributos utilizando otros medios (por ejemplo, con TSO) para asegurarse

de que se creó correctamente. Revise el registro de mensajes del sistema para ver el nombre del conjunto de datos

asignado. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-204 JOURNAL FILE WRITE REQUEST FAILED.

Explicación: Este módulo llamó al módulo de I/O de diario para escribir en el archivo de diario, pero recibió un código

de retorno distinto de cero. El registro de trabajos puede mostrar más mensajes.


Respuesta del usuario: consulte las instrucciones en la sección Error de solicitud abierta anterior. Además, asegúrese

de que se haya asignado suficiente espacio para el archivo. De lo contrario, cambie la asignación de espacio del diario

en línea. Tenga en cuenta que, si ya se han escrito registros en el archivo de diario, es posible que sea necesario

realizar una recuperación antes de volver a ejecutar la aplicación. Consulte el capítulo “Recuperación” en la página 18

para obtener más información. Si el problema persiste, comuníquese con el soporte técnico de CSI.

126

Messages and Codes

FSIVSHAR-205 JOURNAL FILE CLOSE REQUEST FAILED.

Explicación: Este módulo llamó al módulo de I/O de diario para cerrar el archivo de diario secuencial, pero recibió un

código de retorno distinto de cero. El registro de trabajos puede mostrar más mensajes.


Respuesta del usuario: consulte las instrucciones en la sección Error de solicitud abierta anterior. Si el problema

persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-206 REQUEST FOR SYSTEM TIME FAILED.

Explicación: Este módulo intentó obtener la fecha y la hora actuales del sistema operativo mediante la macro TIME. La

solicitud falló según lo indicado por un código de retorno distinto de cero en el registro 15.

Acción del sistema: Fin con el usuario 999.

Respuesta del usuario: Vuelva a ejecutar la aplicación después de realizar las funciones de recuperación si es

necesario. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-207 DD=<ddname> NOT FOUND IN TIOT.

Explicación: mientras procesaba una solicitud de diario, este módulo intentó buscar el DDNAME en la tabla de I/O de

tareas para ubicar el nombre del conjunto de datos correspondiente. Sin embargo, no se pudo localizar el DDNAME

proporcionado. Es posible que el bloque de control interno que contiene el DDNAME esté dañado.




FSIVSHAR-208 FOUND INVALID JFCB FOR TIOT DD=<ddname>.

Explicación: Mientras procesaba una solicitud de diario, este módulo ubicó el DDNAME apropiado en la Tabla de I/O

de tareas, sin embargo, el Bloque de control de archivo de trabajo correspondiente contenía un identificador de

bloque de control no válido. Es posible que el almacenamiento esté dañado.




FSIVSHAR-210 OPENING JOURNAL DATASET <dsname>.

Explicación: El módulo de I/O del diario emite este mensaje durante el proceso de recuperación justo antes de abrir el

conjunto de datos del diario.

Acción del sistema: solo mensaje informativo.


FSIVSHAR-211 ALLOCATING <OLD/NEW> JOURNAL <dsname>.

Explicación: este mensaje lo emite el módulo de I/O del diario justo antes de asignar dinámicamente el conjunto de

datos del diario. "VIEJO" indica que el conjunto de datos de la revista ya está catalogado y los nuevos registros se

agregarán al final del conjunto de datos. "NUEVO" indica que el conjunto de datos de la revista no se catalogó y se

creará en el paso actual.



127

Messages and Codes

FSIVSHAR-212 I/O MODULE CALLED WITH INVALID OPERATION CODE.

Explicación: Los parámetros recibidos por este módulo contenían un código de operación no válido. Es posible que el

almacenamiento de la lista de parámetros se haya dañado.


Respuesta del usuario: compruebe la aplicación en busca de posibles infracciones de almacenamiento. Si el problema


FSIVSHAR-213 JOURNAL FILE <OPEN/CLOSE> <FAILURE/WARNING> R15=nn ACBERROR=nn.

Explicación: Durante el proceso de recuperación, el módulo de I/O de diario abrió el archivo de diario VSAM para la

entrada y encontró un código de retorno distinto de cero. Se muestra el valor hexadecimal del registro 15, así como el

valor del campo ERROR del ACB. Se puede encontrar información específica sobre la causa de la advertencia o falla en

la Guía del programador de OS / VS VSAM.

Acción del sistema: la falla hará que la tarea termine anormalmente con un usuario 999. Las advertencias no

interrumpirán el procesamiento.

Respuesta del usuario: Es posible que las advertencias no requieran ninguna acción. Por ejemplo, es posible que el

conjunto de datos se haya verificado implícitamente en abierto. En caso de fallas, asegúrese de que el conjunto de

datos de diario de VSAM se haya definido correctamente cuando se copió el archivo de diario de QSAM. Si el

problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-214 JOURNAL FILE <READ/POINT> FAILED - R15= nn FDBK= nn FTNCD= nn.

Explicación: El módulo de I/O de diario emitió una solicitud de lectura o de punto para el conjunto de datos de

recuperación de VSAM y la solicitud falló. El mensaje incluye valores hexadecimales del campo de retroalimentación

del RPL utilizado. Puede encontrar información específica sobre estos campos en la Guía del programador de VSAM de

OS / VS.


Respuesta del usuario: busque mensajes relacionados en el registro de trabajos. Asegúrese de que el conjunto de

datos de recuperación de VSAM se haya definido correctamente cuando se copió el archivo de diario QSAM. Si el


FSIVSHAR-215 CATALOG ERROR TRYING TO LOCATE JOURNAL FILE - R15=nn.

Explicación: Este módulo intentó ubicar el nombre del conjunto de datos del archivo de diario QSAM en el catálogo,

pero la solicitud falló. El código de retorno en el registro 15 de la macro LOCATE era "nn" (hexadecimal).


Respuesta del usuario: Compruebe si el archivo de diario QSAM está definido y listado en el catálogo. Consulte el

capítulo “Recuperación” en la página 18 para obtener información sobre los nombres de los conjuntos de datos del

diario. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-216 JOURNAL ALLOCATION ERROR - R15=nn INFO=nnnn REASON=nnnn.

Explicación: Falló la asignación dinámica del archivo de diario. Registro 15, la información y los códigos de motivo se

devolvieron desde la función de asignación dinámica (en hexadecimal). Tenga en cuenta que, si el módulo de

asignación falló por un motivo no relacionado con la llamada de asignación dinámica, los campos R15, INFO y REASON

serán irrelevantes.


Respuesta del usuario: busque mensajes de la rutina de asignación, CSIVSJ08. Revise la información de la revista en

línea para asegurarse de que las definiciones de los archivos de la revista sean correctas. Si el problema persiste,

comuníquese con el soporte técnico de CSI.

128

Messages and Codes

FSIVSHAR-217 JOURNAL FILE (DD=JNLIN) NOT FOUND IN JCL.

Explicación: Los parámetros recibidos por este módulo contenían un código de operación no válido. Es posible que el almacenamiento de la lista de parámetros se haya dañado. Acción del sistema: establezca el código de retorno y regrese a la persona que llama. Respuesta del usuario: compruebe la aplicación en busca de posibles infracciones de almacenamiento. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-218 RDJFCB MACRO CALL FAILED FOR DD = <ddname>.

Explicación: este mensaje se produce durante el proceso de recuperación. La entrada DDNAME (DD = JNLIN) estaba ubicada en el TIOT, pero se encontró un error al acceder a la entrada correspondiente del Bloque de control de archivos de trabajo a través de la macro RDJFCB. Acción del sistema: Fin con el usuario 999. Respuesta del usuario: Vuelva a ejecutar el proceso de recuperación. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-219 STORAGE MANAGER CALLED WITH INVALID OPERATION CODE.

Explicación: Los parámetros recibidos por este módulo contenían un código de operación no válido. Es posible que el almacenamiento de la lista de parámetros se haya dañado. Acción del sistema: establezca el código de retorno y regrese a la persona que llama. Respuesta del usuario: compruebe la aplicación en busca de posibles infracciones de almacenamiento. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-220 INVALID MIN STORAGE REQUESTED - LESS THAN OR EQUAL ZERO.

Explicación: El campo de solicitud de almacenamiento mínimo de la lista de parámetros no era válido. Es posible que el almacenamiento de la lista de parámetros se haya dañado. Acción del sistema: establezca el código de retorno y regrese a la persona que llama. Respuesta del usuario: compruebe la aplicación en busca de posibles infracciones de almacenamiento. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-221 INVALID MAX STORAGE REQUESTED - LESS THAN OR EQUAL ZERO.

Explicación: El campo de solicitud de almacenamiento máximo de la lista de parámetros no era válido. Es posible que el almacenamiento de la lista de parámetros se haya dañado. Acción del sistema: establezca el código de retorno y regrese a la persona que llama. Respuesta del usuario: compruebe la aplicación en busca de posibles infracciones de almacenamiento. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-222 INVALID STORAGE REQUESTED - MINIMUM GREATER THAN MAXIMUM.

Explicación: El parámetro del campo de solicitud de almacenamiento mínimo era mayor que el máximo. Esto daría como resultado una solicitud GETMAIN no válida. Es posible que el almacenamiento de la lista de parámetros se haya dañado. Acción del sistema: establezca el código de retorno y regrese a la persona que llama. Respuesta del usuario: compruebe la aplicación en busca de posibles infracciones de almacenamiento. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-223 GETMAIN FAILED - INSUFFICIENT VIRTUAL STORAGE.

Explicación: No había suficiente almacenamiento virtual disponible para que el administrador de almacenamiento creara su búfer de solicitud. Acción del sistema: establezca el código de retorno y regrese a la persona que llama. Respuesta del usuario: Aumente el almacenamiento disponible para el trabajo de recuperación mediante el parámetro REGION en la tarjeta JOB o EXEC.

129

Messages and Codes

FSIVSHAR-224 FREEMAIN FAILED - NOT ALL STORAGE RELEASED.

Explicación: Este módulo recibió una solicitud para liberar el búfer de solicitud, pero el almacenamiento FREEMAIN

falló.


Respuesta del usuario: si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-225 ELEMENT SIZE EXCEEDS TOTAL BUFFER SIZE.

Explicación: Se le pidió al administrador de almacenamiento que almacenara un elemento que fuera más grande que

el búfer total adquirido cuando se creó la cola de solicitudes. Es posible que el campo de tamaño de buffer o el campo

de tamaño de elemento estén dañados.




FSIVSHAR-226 RECOVERY MANAGER HAS COMPLETED <normally/abnormally>.

Explicación: El administrador de recuperación terminó de procesar todos los registros del conjunto de datos de

recuperación de VSAM.

Acción del sistema: devuelva el control al sistema operativo.

Respuesta del usuario: solo mensaje informativo. Si se indicó algo anormal, revise los mensajes anteriores en el

registro para ver si hay condiciones de error.

FSIVSHAR-227 RECOVERY MANAGER WAITING - REQUEST BUFFER IS FULL.

Explicación: El administrador de recuperación intentó poner en cola un bloque de solicitud, pero el administrador de

almacenamiento indicó que el buffer estaba lleno.

Acción del sistema: cuando finaliza la espera, el administrador de recuperación vuelve a intentar poner en cola el

bloque de solicitud.

Respuesta del usuario: solo mensaje informativo.

FSIVSHAR-228 <attaching/detaching> I/O SUBTASK.

Explicación: El administrador de recuperación está a punto de conectar o desconectar la sub tarea de I/O. Acción del

sistema: solo informativo. Respuesta del usuario: ninguna.

FSIVSHAR-229 RID - DD=<ddname> DATE=<yyddd> TIME=<hh:mm:ss:ht> SEQ=<seq#>.

Explicación: Este mensaje se utiliza para complementar otros mensajes en los que resulta útil para identificar el

registro del archivo de diario que se está procesando. El DDNAME identifica el archivo para el que se registró la

actualización. Se incluyen la fecha y hora julianas en que se creó el registro de diario, así como un número de

secuencia interno. El diseño de registro de diario incluido en el capítulo Recuperación muestra la ubicación de cada

uno de los campos.


Respuesta del usuario: consulte el mensaje anterior a este en el registro para obtener más información.

130

Messages and Codes

FSIVSHAR-230 I/O SUBTASK ENDED <NORMALLY/ABNORMALLY> - RC = nnn.

Explicación: El administrador de recuperación ha recibido una notificación de que la sub tarea de I/O ha finalizado con

el código de retorno mostrado.

Acción del sistema: si la sub tarea finalizó normalmente, el administrador de recuperación continúa con la finalización

normalmente. Si la sub tarea terminó con un código de retorno distinto de cero, el administrador de recuperación

emite una terminación anormal del usuario.

Respuesta del usuario: si la sub tarea finalizó de manera anormal, revise los mensajes anteriores en el registro para

obtener más información. Si no se encuentra suficiente información, revise las anotaciones de trabajo de CICS para ver

los mensajes relacionados con el trabajo, y también las anotaciones de trabajo para otros mensajes, y actúe en

consecuencia.

FSIVSHAR-231 PROCESSING STOPPED ON FOLLOWING JOURNAL RECORD:

Explicación: Este mensaje se utiliza para complementar otros mensajes en los que resulta útil identificar el registro del

archivo de diario actual que se está procesando. Le sigue un mensaje que identifica el registro de diario específico.



FSIVSHAR-232 RECOVERY <STARTED/FINISHED> FOR PGMSTEP=xxxxxxxx PROCSTEP=xxxxxxxx JOBNAME=xxxxxxxx JOBNUM=xxxx.

Explicación: La recuperación ha comenzado o finalizado para el paso de trabajo identificado en el mensaje.

Acción del sistema: Continúe normalmente.

Respuesta del usuario: solo informativo.

FSIVSHAR-233 <REWRITE/DELETE> RECORD JOURNALED DURING ABEND AND DOES NOT MATCH BEFORE IMAGE - RECORD

BYPASSED.

Explicación: Se encontró un registro de diario de reescritura o eliminación, pero su clave no coincidía con la del

registro de actualización de lectura anterior (antes de la imagen) encontrado. Este mensaje va acompañado de

mensajes adicionales que identifican tanto el registro de imagen anterior como el registro de reescritura o

eliminación.

Acción del sistema: esto normalmente haría que el proceso de recuperación terminara anormalmente, pero la

reescritura o eliminación se registró durante una situación de terminación anormal, por lo que se omite el par de

registros.

Respuesta del usuario: si se requiere más información sobre los registros en cuestión, búsquelos en el archivo de

diario utilizando la información de los mensajes.

FSIVSHAR-234 CURRENTLY PROCESSING FOLLOWING JOURNAL RECORD.

Explicación: Este mensaje va seguido de otro mensaje que identifica el registro de diario actual que se está

procesando. Se emite en circunstancias en las que la posición en el archivo del diario puede ser pertinente.


Respuesta del usuario: solo informativo. Consulte los mensajes adjuntos.

FSIVSHAR-235 RECOVERY STOPPING AT LAST USER SYNCPOINT.

Explicación: Recovery ha encontrado un registro SYNCPOINT de usuario y está interrumpiendo su procesamiento.

Acción del sistema: el procesamiento se detiene.


131

Messages and Codes

FSIVSHAR-236 ROLLBACK RECORD FOUND< SKIPPING TO NEXT SYNCPOINT.

Explicación: La recuperación encontró un registro de retrotracción y asumirá que CICS se ha recuperado al registro

SYNCPOINT.

Acción del sistema: el procesamiento continúa.


FSIVSHAR-237 I/O ERROR ENCOUNTERED OPENING JOURNAL FILE.

Explicación: Se llamó al módulo de I/O de diario para abrir el archivo de recuperación de diario de VSAM, pero la

solicitud falló.

Acción del sistema: Finalización anormal con el usuario 999.

Respuesta del usuario: busque más mensajes del módulo de I/O de diario. Asegúrese de que el conjunto de datos de

recuperación de VSAM se haya definido correctamente cuando se copió el archivo de diario QSAM. Busque más

mensajes en el registro de trabajos relacionados con el conjunto de datos de recuperación. Si el problema persiste,


FSIVSHAR-238 END OF FILE ON START OF JOURNAL FILE.

Explicación: Se llamó al módulo de I/O de diario para colocar el archivo de recuperación de diario de VSAM en el

último registro y se encontró el final del archivo.


Respuesta del usuario: asegúrese de que el conjunto de datos de recuperación de VSAM se haya definido

correctamente cuando se copió el archivo de diario QSAM. Además, asegúrese de que el archivo de diario QSAM no

esté vacío. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-239 I/O ERROR STARTING JOURNAL FILE.

Explicación: Se llamó al módulo de I/O de diario para colocar el archivo de recuperación de diario de VSAM en el

último registro y se encontró un error de I/O irrecuperable.






FSIVSHAR-240 STORAGE MGR CREATE OPERATION FAILED.

Explicación: Se llamó al administrador de almacenamiento para crear el búfer de solicitud, pero no pudo completar la

operación normalmente.


Respuesta del usuario: Verifique si hay más mensajes del administrador de almacenamiento. Si el problema persiste,


FSIVSHAR-241 I/O ERROR DURING JOURNAL FILE READ OPERATION.

Explicación: Se llamó al módulo de I/O de diario para leer un registro del archivo de recuperación de diario de VSAM,

pero la solicitud falló. No se alcanzó el final del archivo.






132

Messages and Codes

FSIVSHAR-242 TYPE FIELD ON JOURNAL RECORD IS UNKNOWN.

Explicación: Se encontró un registro de diario con un campo de tipo desconocido en la sección de encabezado. El archivo de diario QSAM o el archivo de recuperación del diario VSAM pueden estar dañados. Acción del sistema: Finalización anormal con el usuario 999. Respuesta del usuario: asegúrese de que el conjunto de datos de recuperación de VSAM se haya definido correctamente cuando se copió el archivo de diario QSAM. Reconstruya el conjunto de datos de recuperación de VSAM si es necesario. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-243 BAD RETURN CODE FROM STIMER SERVICES (WAIT).

Explicación: Este módulo solicitó servicios de temporizador del sistema operativo, pero la solicitud no se pudo completar normalmente. Acción del sistema: Fin con el usuario 999. Respuesta del usuario: Verifique el registro de trabajos para ver si hay otros mensajes que puedan haber sido emitidos por el sistema operativo. Vuelva a ejecutar el proceso de recuperación y, si el problema persiste, póngase en contacto con el soporte técnico.

FSIVSHAR-244 STORAGE MGR ENQUEUE OPERATION FAILED.

Explicación: El administrador de almacenamiento falló al intentar poner en cola un bloque de solicitud de I/O para la sub tarea de I/O. Acción del sistema: Finalización anormal con el usuario 999. Respuesta del usuario: Compruebe si hay otros mensajes del administrador de almacenamiento. Vuelva a ejecutar el proceso de recuperación y, si el problema persiste, póngase en contacto con el soporte técnico.

FSIVSHAR-245 STORAGE MGR DESTROY OPERATION FAILED.

Explicación: El administrador de recuperación y el administrador de solicitudes de I/O habían terminado de usar la cola de almacenamiento de solicitudes, pero el administrador de almacenamiento no pudo liberar el almacenamiento correctamente. Acción del sistema: Regrese normalmente. Respuesta del usuario: este mensaje es solo informativo y no afectará la operación de recuperación. Si el mensaje vuelve a aparecer, comuníquese con el soporte técnico.

FSIVSHAR-246 <REWRITE/DELETE> TYPE JOURNAL RECORD FOUND WITH NO MATCHING BEFORE IMAGE.

Explicación: Se esperan dos registros de diario por cada tipo de I/O de reescritura o eliminación realizada: una imagen antes y una imagen posterior. En este caso, solo se encontró la imagen posterior. Este mensaje va acompañado de mensajes adicionales que identifican tanto el registro de imagen anterior como el registro de reescritura o eliminación. Acción del sistema: Finalización anormal con el usuario 999. Respuesta del usuario: asegúrese de que el conjunto de datos de recuperación de VSAM se haya definido correctamente cuando se copió el archivo de diario QSAM. Reconstruya el conjunto de datos de recuperación de VSAM si es necesario. Si el problema persiste, busque el registro de reescritura o eliminación en el archivo de diario utilizando la información de los mensajes y el diseño del registro de diario incluido en el capítulo Recuperación. Este registro se puede eliminar del diario y el proceso se puede volver a ejecutar. El contenido del registro debe guardarse para una mayor investigación. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-247 ERROR ON CALL TO JOURNAL I/O MODULE.

Explicación: El módulo de I/O de diario no pudo completar una solicitud debido a un error inesperado. Es posible que el almacenamiento del programa esté dañado. Acción del sistema: Finalización anormal con el usuario 999. Respuesta del usuario: busque mensajes del módulo de I/O de diario. Si volver a ejecutar la recuperación produce el mismo mensaje, póngase en contacto con el soporte técnico.

133

Messages and Codes

FSIVSHAR-248 ERROR ON CALL TO STORAGE MANAGER.

Explicación: El administrador de almacenamiento no pudo completar una solicitud debido a un error inesperado. Es

posible que el almacenamiento del programa esté dañado.


Respuesta del usuario: busque mensajes en el módulo del administrador de almacenamiento. Si volver a ejecutar la

recuperación produce el mismo mensaje, póngase en contacto con el soporte técnico.

FSIVSHAR-249 ERROR ON CALL TO CHANGE LIST FORMATTER.

Explicación: El módulo de formateador de lista de cambios no pudo completar una solicitud debido a un error

inesperado. Es posible que el almacenamiento del programa esté dañado.


Respuesta del usuario: busque mensajes en el módulo de formateador de lista de cambios. Si volver a ejecutar la


FSIVSHAR-250 GETMAIN <nnnnnnnn> HEX BYTES FAILED FOR <area>.

Explicación: No había suficiente almacenamiento virtual disponible para una solicitud GETMAIN. Se muestra el

número de bytes (en hexadecimal) solicitados, así como el área de datos para la que se estaba ejecutando GETMAIN.


Respuesta del usuario: Aumente el almacenamiento disponible para el trabajo de recuperación utilizando el

parámetro de región en la tarjeta de trabajo o en la tarjeta de paso. Si el problema persiste y la cantidad de bytes

solicitados parece excesiva, comuníquese con el soporte técnico de CSI.

FSIVSHAR-251 CALL TO TABLE MANAGER FAILED ON JOURNAL RECORD.

Explicación: Se llamó al administrador de la tabla para ubicar o crear una entrada para el conjunto de datos

especificado en el registro de diario actual, pero no se pudo completar la solicitud. Un mensaje que identifica el

registro del diario acompaña a este.

Acción del sistema: Fin con el usuario 999. Respuesta del usuario: Revise el registro de mensajes para ver si hay más

mensajes del administrador de la mesa y actúe en consecuencia. Si el problema persiste, comuníquese con el soporte

técnico.

FSIVSHAR-252 UNABLE TO PROCESS RECOVERY PARAMETERS.

Explicación: El procesador de lista de parámetros se invocó desde este programa, pero no se completó normalmente.


Respuesta del usuario: Revise el registro de mensajes para ver más mensajes del procesador de la lista de

parámetros. Si el problema persiste, comuníquese con el soporte técnico.

FSIVSHAR-253 CHANGE LIST EXCEEDS ALLOCATED CHANGE LIST BUFFER.

Explicación: El buffer interno adquirido para contener un elemento de la lista de cambios que se pasará al

administrador de almacenamiento no era lo suficientemente grande para contener la lista de cambios actual que se

estaba creando. Acción del sistema: Fin con el usuario 999. Respuesta del usuario: Vuelva a intentar el proceso de

recuperación. Si el problema persiste, comuníquese con el soporte técnico de CSI.

134

Messages and Codes

FSIVSHAR-254 I/O SUBTASK WAITING FOR WORK.

Explicación: La sub tarea de I/O de recuperación intentó quitar la cola de un bloque de solicitud, pero el administrador

de almacenamiento indicó que el buffer estaba vacío.

Acción del sistema: cuando finaliza la espera, la sub tarea de I/O de recuperación intenta de nuevo quitar de la cola un

bloque de solicitud.


FSIVSHAR-255 I/O SUBTASK HAS BEEN STARTED.

Explicación: La sub tarea de I/O se ha adjuntado correctamente a la tarea principal del administrador de recuperación.



FSIVSHAR-256 RID - DD=<ddname> DATE=<yyddd> TIME=<hh:mm:ss:ht> SEQ=<seq#>.

Explicación: Este mensaje se utiliza para complementar otros mensajes en los que resulta útil para identificar el

registro del archivo de diario que se está procesando. El DDNAME identifica el archivo para el que se registró la

actualización. Se incluyen la fecha y hora julianas en que se creó el registro de diario, así como un número de

secuencia interno. El diseño de registro de diario incluido en el capítulo Recuperación muestra la ubicación de cada

uno de los campos.



FSIVSHAR-257 WARNING - FREEMAIN FAILED FOR READ BUFFER.

Explicación: Mientras aumentaba el búfer de lectura para acomodar una longitud de registro mayor, el administrador

de recuperación intentó liberar el búfer anterior, pero la solicitud falló.


Respuesta del usuario: esta es solo una advertencia y no afectará el procesamiento a menos que las solicitudes de

almacenamiento posteriores fallen debido a la falta de almacenamiento virtual. Si el problema persiste, comuníquese

con el soporte técnico de CSI.

FSIVSHAR-258 ERROR ON CALL TO STORAGE MANAGER.

Explicación: El administrador de almacenamiento no pudo completar una solicitud debido a un error inesperado. Es

posible que el almacenamiento del programa esté dañado.


Respuesta del usuario: busque mensajes en el módulo del administrador de almacenamiento. Si volver a ejecutar la


FSIVSHAR-259 BAD RETURN CODE FROM STIMER SERVICES (WAIT).

Explicación: Este módulo solicitó servicios de temporizador del sistema operativo, pero la solicitud no se pudo

completar normalmente.


Respuesta del usuario: Verifique el registro de trabajos para ver si hay otros mensajes que puedan haber sido

emitidos por el sistema operativo. Vuelva a ejecutar el proceso de recuperación y, si el problema persiste, póngase en

contacto con el soporte técnico.

135

Messages and Codes

FSIVSHAR-260 FOUND UNKNOWN REQUEST BLOCK TYPE.

Explicación: El administrador de almacenamiento devolvió un bloque de solicitud que tenía un campo de tipo

desconocido en la sección de encabezado. Es posible que el almacenamiento esté dañado.


Respuesta del usuario: Vuelva a intentar el proceso de recuperación. Si el problema persiste, comuníquese con el

soporte técnico de CSI.

FSIVSHAR-261 ERROR ON CALL TO CHANGE LIST PROCESSOR.

Explicación: El módulo procesador de la lista de cambios no pudo completar una solicitud debido a un error

inesperado. Es posible que el almacenamiento del programa esté dañado.


Respuesta del usuario: busque mensajes en el módulo procesador de la lista de cambios. Si volver a ejecutar la


FSIVSHAR-262 WARNING, <operation> FAILED - R15=<nnn> FDBK=<nnn> FTNCD=<nnn>.

Explicación: La sub tarea de I/O ejecutó una solicitud de I/O de VSAM que falló. El mensaje identifica la operación que

se está realizando, así como los campos del código de retorno VSAM (decimal). Puede encontrar información

específica sobre estos campos en la Guía del programador de VSAM de OS / VS. Este mensaje debe ir seguido de otro

mensaje que identifique el registro de diario para el que se estaba realizando la solicitud de I/O.

Acción del sistema: esto es solo una advertencia y la recuperación continúa.

Respuesta del usuario: si la mayoría o todas las solicitudes fallaron, verifique que se esté utilizando el archivo de

diario adecuado para el proceso de recuperación. De lo contrario, verifique dentro del contexto de la aplicación para

ver si la actividad en línea podría explicar las fallas. Si el problema persiste, comuníquese con el soporte técnico de CSI.


Explicación: No había suficiente almacenamiento virtual disponible para una solicitud GETMAIN. Se muestra el

número de bytes (en hexadecimal) solicitados, así como el área de datos para la que se estaba ejecutando GETMAIN.


Respuesta del usuario: Aumente el almacenamiento disponible para el trabajo de recuperación utilizando el

parámetro de región en la tarjeta de trabajo o en la tarjeta de paso. Si el problema persiste y la cantidad de bytes

solicitados parece excesiva, comuníquese con el soporte técnico de CSI.

FSIVSHAR-264 INVALID CHANGE LIST LENGTH: <nnnn> (HEX).

Explicación: Al procesador de la lista de cambios se le pasó una lista de cambios con una longitud no válida. La

longitud está impresa en hexadecimal.


Respuesta del usuario: Es posible que se hayan producido daños en el almacenamiento. Si el problema persiste,

comuníquese con el soporte técnico.

FSIVSHAR-265 GETMAIN FOR DYNAMIC ALLOCATION PARM LIST FAILED.

Explicación: No había suficiente almacenamiento virtual disponible cuando este módulo intentó adquirir

almacenamiento para crear su lista de parámetros de asignación dinámica.

Acción del sistema: Regrese a la persona que llama con un código de retorno incorrecto.

Respuesta del usuario: Aumente el almacenamiento disponible para el trabajo de recuperación mediante el

parámetro REGION en la tarjeta JOB o EXEC.

136

Messages and Codes

FSIVSHAR-266 FREEMAIN OF DYNALLOC PARM LIST AREA FAILED.

Explicación: este mensaje es solo una advertencia. La asignación dinámica se completó normalmente, pero no se

liberó el almacenamiento de la lista de parámetros.

Acción del sistema: continuar procesando.

Respuesta del usuario: este mensaje no debería repetirse. Si persiste, comuníquese con el soporte técnico.

FSIVSHAR-267 DYNAMIC FILE ALLOCATION FAILED.

Explicación: Se llamó a este módulo para asignar dinámicamente un archivo, pero la asignación falló.

Acción del sistema: la información sobre la falla se devuelve a la persona que llama.

Respuesta del usuario: compruebe si hay otros mensajes de la persona que llama a este módulo. Si el problema


FSIVSHAR-268 <OPENED/CLOSED> <ddname> NORMALLY.

Explicación: El conjunto de datos VSAM identificado por "DDNAME" se abrió o cerró sin errores.



FSIVSHAR-269 GENCB FAILED FOR DD=<ddname>.

Explicación: Se ejecutó una macro GENCB para crear una ACB para un archivo que se estaba recuperando y la solicitud

falló.


Respuesta del usuario: esta condición es más probable que ocurra si no hay suficiente espacio virtual asignado al

trabajo de recuperación para construir todos los bloques de control necesarios. Esto puede ocurrir si se recupera una

gran cantidad de archivos. Aumente el espacio solicitado en el parámetro REGION de la tarjeta JOB o la tarjeta EXEC y

vuelva a ejecutar. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-270 <OPEN/CLOSE> FAILED FOR <ddname> R15=<nnn> ACBERROR=<nnn>.

Explicación: Falló una operación de apertura o cierre para el conjunto de datos identificado. Se incluyen el registro 15

y los valores del campo VSAM ACBERROR (en decimal).

Acción del sistema: para solicitudes abiertas, finalice anormalmente el proceso. Para solicitudes de cierre, continúe

cerrando el resto de los archivos.

Respuesta del usuario: consulte la Guía del programador de VSAM de OS / VS para obtener más información sobre los

códigos de retorno que se muestran. Si la operación fue un cierre, ya se han realizado todas las operaciones de I/O

para la recuperación y, según la gravedad del error de cierre, es posible que no se requiera ninguna acción. Si la

operación fue abierta, el error del archivo debe resolverse y el proceso de recuperación debe volver a ejecutarse. Si el


FSIVSHAR-271 SEGMENT TABLE FULL.

Explicación: La tabla utilizada para registrar la información del archivo está llena y el procesamiento no puede

continuar.


Respuesta del usuario: Es posible que el almacenamiento del programa se haya dañado o se esté recuperando una

cantidad excesivamente grande de conjuntos de datos. Vuelva a ejecutar la recuperación y, si el problema persiste,

póngase en contacto con el soporte técnico.

137

Messages and Codes


Explicación: No había suficiente almacenamiento virtual disponible para una solicitud GETMAIN. Se muestra el número de bytes (en hexadecimal) solicitados, así como el área de datos para la que se estaba ejecutando GETMAIN. Acción del sistema: Finalización anormal con el usuario 999. Respuesta del usuario: Aumente el almacenamiento disponible para el trabajo de recuperación mediante el parámetro REGION en la tarjeta JOB o EXEC. Si el problema persiste y la cantidad de bytes solicitados parece excesiva, comuníquese con el soporte técnico de CSI.

FSIVSHAR-273 MISSING DSN=<dsname>.

Explicación: Se llamó a este módulo para abrir un conjunto de datos (dsname) para la recuperación, pero el conjunto de datos no se incluyó en el JCL de recuperación. Acción del sistema: Finalización anormal con el usuario 999. Respuesta del usuario: asegúrese de que se estén utilizando el archivo de diario y el JCL de recuperación adecuados. Si es así, agregue el archivo necesario al trabajo de recuperación. Si el problema persiste, comuníquese con el soporte técnico.

FSIVSHAR-274 RDJFCB MACRO CALL FAILED FOR DD = <ddname>.

Explicación: El administrador de recuperación estaba intentando ubicar el DDNAME para un conjunto de datos VSAM listado en el archivo de diario. La llamada de macro RDJFCB falló para <DDNAME> en el JCL de recuperación. Acción del sistema: Fin con el usuario 999. Respuesta del usuario: Vuelva a ejecutar el proceso de recuperación. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-275 PROCESSING PARAMETER CARDS FROM DD=<ddname>.

Explicación: este mensaje se emite antes de procesar las tarjetas de parámetros de recuperación del conjunto de datos asociado con "DDNAME". Este DDNAME suele ser SYSIN. Acción del sistema: Continúe normalmente. Respuesta del usuario: solo mensaje informativo.

FSIVSHAR-276 ‘RECOVERALL’ OPTION SPECIFIED - ENTIRE JOURNAL WILL BE RECOVERED.

Explicación: El archivo de diario completo se procesará durante esta ejecución de recuperación. Acción del sistema: Continúe normalmente. Respuesta del usuario: solo mensaje informativo.

FSIVSHAR-277 PARMS ACCEPTED - <JOBNAME=xxxxxxxx JOBNUM=xxxx PGMSTEP=xxxxxxxxPROCSTEP=xxxxxxxx>.

Explicación: Los valores de los parámetros enumerados en este mensaje se incluyeron en las tarjetas de parámetros suministradas al trabajo de recuperación. Se utilizan para establecer las condiciones de detención del proceso de recuperación. Acción del sistema: solo informativo. Respuesta del usuario: ninguna.

FSIVSHAR-278 PROCESSING STOPPED ON CARD <nnn> (INCLUDING COMMENT CARDS).

Explicación: Este mensaje acompaña a otros mensajes cuando se encuentran errores o inconsistencias con las tarjetas de parámetros de entrada para el proceso de recuperación. Identifica la tarjeta de parámetros que se está procesando cuando se detectó el error. Acción del sistema: solo informativo. Respuesta del usuario: revise otros mensajes en el registro de mensajes de recuperación para obtener más información sobre la causa del error.

138

Messages and Codes

FSIVSHAR-279 SYNCPOINT OPTION SPECIFIED - RECOVER TO LAST.

Explicación: El parámetro especificó la recuperación hasta el último punto de sincronización.

Acción del sistema: recuperación al último punto de sincronización.


FSIVSHAR-280 CALL TO PARM CARD READER FAILED.

Explicación: Este módulo llamó al módulo lector de tarjetas de parámetros para recuperar la siguiente tarjeta de

parámetros o para cerrar el conjunto de datos de parámetros, y no se completó normalmente.


Respuesta del usuario: Compruebe si hay más mensajes del módulo lector de tarjetas de parámetros. Revise el JCL

que se está utilizando para ejecutar el proceso de recuperación y asegúrese de que se proporcione el conjunto de

datos de parámetros SYSIN. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-281 INVALID PARAMETER CARD FOUND.

Explicación: La tarjeta de parámetros recuperada no es válida o es desconocida. Un mensaje que identifica la tarjeta

errónea acompaña a este.

Acción del sistema: Finalizar con el usuario 999.

Respuesta del usuario: Revise las tarjetas de parámetros de entrada y corrija cualquier error de formato u ortografía.

FSIVSHAR-282 DUPLICATE ‘<keyword>’ PARAMETER CARD FOUND.

Explicación: Se usó una tarjeta de parámetro de palabra clave más de una vez en el conjunto de datos de entrada de

la tarjeta. Un mensaje que identifica la tarjeta duplicada acompaña a este.


Respuesta del usuario: Corrija las tarjetas de parámetros de entrada y vuelva a ejecutar.

FSIVSHAR-283 ‘RECOVERALL’ OPTION NOT ALLOWED WHEN OTHER PARMS ARE USED.

Explicación: Se encontró la tarjeta de opción RECOVERALL, pero también se encontraron otras tarjetas de condición

de parada.


Respuesta del usuario: La opción RECUPERAR TODO no se puede utilizar con otras opciones. Corrija las tarjetas de

entrada y vuelva a ejecutar.

FSIVSHAR-284 <keyword> PARAMETER IS TOO LONG.

Explicación: El valor del parámetro de palabra clave especificado es más largo de lo permitido. Un mensaje que

identifica la tarjeta errónea acompaña a este.


Respuesta del usuario: Corrija la tarjeta con error y vuelva a ejecutarla.

FSIVSHAR-285 <keyword> PARAMETER VALUE IS INVALID.

Explicación: El valor especificado con el parámetro de palabra clave contiene caracteres no válidos. Un mensaje que

identifica la tarjeta errónea acompaña a este.


Respuesta del usuario: Corrija la tarjeta con error y vuelva a ejecutarla.

139

Messages and Codes

FSIVSHAR-286 JOBNAME OR JOBNUM PARAMETER REQUIRED BUT NOT FOUND.

Explicación: No se encontraron ni JOBNAME ni la tarjeta de parámetro JOBNUM. Se requiere al menos uno para

especificar las condiciones de parada.


Respuesta del usuario: Agregue las tarjetas apropiadas al conjunto de datos de parámetros de entrada y vuelva a

ejecutar.

FSIVSHAR-287 ERROR <OPENING/CLOSING/READING> PARAMETER FILE DD=<ddname>.

Explicación: El módulo de entrada de la tarjeta de parámetros falló al abrir, cerrar o leer el conjunto de datos de

parámetros de entrada.


Respuesta del usuario: asegúrese de que el conjunto de datos de parámetros esté especificado correctamente en el

JCL de recuperación. Busque más mensajes en el registro de trabajos.

140

Messages and Codes

CMS (Cross Memory Services) Mensaje

FSIVSHAR-301 CMS CONVERSATION ALLOCATION FAILED.

Explicación: el programa intentó establecer una conversación CMS y la asignación falló.


Respuesta del usuario: vuelva a intentar el trabajo; Si el error se repite, comuníquese con el soporte técnico de CSI.

FSIVSHAR-302 CMS SEND/RECEIVE FAILED.

Explicación: CMS estaba intentando realizar una función de envío / recepción y falló.



FSIVSHAR-302 CMS SEND/RECEIVE FAILED.

Explicación: El programa intentó finalizar una conversación de CMS y la desasignación falló.



FSIVSHAR-304 ATTEMPTED SEND ON UNALLOCATED CONVERSATION.

Explicación: El programa intentó emitir un envío cuando la conversación no se había asignado o se había desasignado.



FSIVSHAR-305 INVALID REQUEST CODE.

Explicación: un programa emitió un código de solicitud a CMS que no era válido.

Acción del sistema: el programa finaliza anormalmente.


FSIVSHAR-306 (CMS INFORMATION MESSAGES).

Explicación: El programa emitió mensajes informativos sobre su procesamiento.



FSIVSHAR-307 INVALID /MISSING PARM: function parm.

Explicación: El programa encontró una solicitud de función que no era válida.


Respuesta del usuario: revise y corrija la solicitud de función y vuelva a enviar el trabajo.

FSIVSHAR-308 GETMAIN XXXXXXXX BYTES FROM SUBPOOL XXX FAILED AT XXXXXXXX.

Explicación: El programa emitió un GETMAIN para almacenamiento desde una sub agrupación especificada y falló en

la dirección del programa.



141

Messages and Codes

FSIVSHAR-309 INVALID LENGTH OF SVC MODULE XXXXXXXX YYYYYYYY.

Explicación: El programa encontró un error en la longitud del módulo xxxxxxxx, donde yyyyyyyy es la longitud.



FSIVSHAR-310 SVCUPDTE REQUEST FAILED, R15=XX, SVC INSTALL TERMINATED.

Explicación: El programa intentó emitir la macro SVCUPDTE y falló con el registro 15 igual a xx.



FSIVSHAR-311 INITIALIZATION FAILED FOR MODULE AT XXXXXXXX.

Explicación: Se cargó un módulo e intentó inicializarse y falló en la ubicación xxxxxxxx.



FSIVSHAR-312 LOAD OF SVC MODULE INTO ACQUIRED STORAGE FAILED.

Explicación: El CMS SVC se estaba cargando en el almacenamiento adquirido por el programa y falló.



FSIVSHAR-313 FAILURE EXECUTING CMS OPERATION XXXXX.

Explicación: CMS estaba ejecutando una operación xxxxx y falló.



FSIVSHAR-314 SST UTILITY, REQUEST CODE PARM IS INVALID.

Explicación: Se llamó a la utilidad SST de CMS con un parámetro no válido.



FSIVSHAR-315 GETMAIN FOR SSCVT ENTRY, SP 241 FAILED.

Explicación: El programa emitió un GETMAIN para almacenamiento fuera de la subagrupación 241 para construir un

bloque de control SSCVT y el GETMAIN falló.



FSIVSHAR-316 SSCVT ADD FAILED, CONTENTION FOR TABLE, TRY AGAIN.

Explicación: El programa intentó agregar un SSCVT mientras otro trabajo estaba haciendo lo mismo.



FSIVSHAR-317 NO JES COMMUNICATION TABLE FOUND, CVTJESCT = 0.

Explicación: El programa estaba buscando CVTJESCT pero la dirección de carga era 0.

Acción del sistema: El programa se aborta.


142

Messages and Codes

FSIVSHAR-318 NO ENT JES COMMUNICATION TABLE FOUND, JESSSCT = 0.

Explicación: El programa estaba buscando el JESSSCT y la dirección de carga era 0.

Acción del sistema: El programa se aborta.


FSIVSHAR-319 SSCVT NAME: XXXXXXXX IS INVALID.

Explicación: Al programa se le pasó un nombre no válido para SSCVT.



FSIVSHAR-320 REQUIRED MESSAGE ROUTINE: XXXXXXXX NOT AVAILABLE.

Explicación: El programa intentó cargar la rutina de mensajes xxxxxxxx y no la encontró disponible.



FSIVSHAR-321 SSCVT CHAIN INVALID, MULT. ENTRIES ARE MISSING SSCT ID.

Explicación: El programa encontró entradas SSCVT no válidas.



FSIVSHAR-322 NO OR INVALID PARMS SPECIFIED ON EXECUTE CARD.

Explicación: El programa no pudo reconocer los parámetros en la tarjeta EXEC.



FSIVSHAR-323 INVALID UTILITY REQUEST NUMBER.

Explicación: El programa solicitó una función de otro programa, pero el número de función no era válido.



FSIVSHAR-324 SVC NUMBER XXXXXXXXXXXX.

Explicación: El SVC numerado en el mensaje también tenía un problema identificado en el mensaje.



FSIVSHAR-325 SYSTEM NAME XXXXXXXXXXXX.

Explicación: El nombre del sistema en el mensaje tenía un problema también identificado en el mensaje



FSIVSHAR-326 TIME OPTION xxxxxxxxxxxx.

Explicación: La opción de hora identificada en el mensaje también tenía un problema identificado en el mensaje.



143

Messages and Codes

FSIVSHAR-327 ERROR EXECUTING MODULE: XXXXXXXX.

Explicación: El programa recibió un código de retorno incorrecto del módulo xxxxxxxx.



FSIVSHAR-328 XXXXXXXX OF SUBSYSTEM NAME TABLE ENT XXXXXXXX.

Explicación: La adición o supresión de la entrada de la tabla de nombres de subsistema se ha completado o ha fallado.

Acción del sistema: dependiente.

Respuesta del usuario: dependiente.

FSIVSHAR-329 XXXX FAILED, OPERATION TERMINATED XXXXXXXXX.

Explicación: Error en una solicitud del sistema y se describe la operación que terminó.



FSIVSHAR-330 ERROR ACCESSING FSI-VSHARE SYSTEM INFORMATION BLOCK.

Explicación: El programa intentó acceder a un bloque de control y falló.



FSIVSHAR-331 XXXX ALREADY INSTALLED.

Explicación: El programa intentó instalar el CMS SVC y ya se encontró.

Acción del sistema: el programa finaliza.


FSIVSHAR-332 CONTENTION FOR FSI-VSHARE SYSTEM TABLE, OPERATION ABORTED.

Explicación: El programa intentó acceder a la tabla del sistema y otro trabajo lo estaba actualizando.



FSIVSHAR-333 SYSTEM NOT INSTALLED YET, CANNOT EXECUTE REQUEST.

Explicación: El programa intentó realizar una solicitud a CMS, pero no se encontró que CMS estuviera instalado.


Respuesta del usuario: instale CMS.

FSIVSHAR-334 INSTALLATION FACILITY IN USE, TRY LATER.

Explicación: El programa intentó utilizar la función de instalación y encontró que otro usuario la tenía.



FSIVSHAR-335 A TIMER INITIATED REQUEST FOR XXXX IS OUTSTANDING.

Explicación: Se realizó una solicitud de puesta en cola y se encontró que había una pendiente.



144

Messages and Codes

FSIVSHAR-336 INVALID REQUEST CODE IN SVC PARMLIST.

Explicación: El programa realizó una solicitud al módulo SVC y este módulo encontró un error en el código de

solicitud.



FSIVSHAR-337 SVC PARMLIST IS INVALID.

Explicación: El programa hizo una solicitud al módulo SVC y este módulo encontró un error en la lista de parámetros.



FSIVSHAR-338 MODULE XXXXXXXX NOT FOUND.

Explicación: El programa realizó una solicitud de carga y no pudo encontrar el módulo.



145

Messages and Codes

Mensajes de Servicios de Presentación

FSIVSHAR-401 FSM WAS PASSED AN INVALID FSM ID.

Explicación: El módulo de la máquina de estados finitos se invocó con un ID de máquina de estados finitos

desconocido. Es posible que se hayan producido daños en el almacenamiento.

Acción del sistema: terminación de la sesión.



FSIVSHAR-402 FSM WAS PASSED AN INVALID INPUT STATE.

Explicación: El estado de entrada para la máquina de estados finitos especificada no estaba dentro del rango de

valores posibles. Es posible que se hayan producido daños en el almacenamiento.




FSIVSHAR-403 FSM WAS PASSED AN INVALID OPERATION.

Explicación: El módulo de la máquina de estados finitos recibió una solicitud para realizar una operación indefinida. Es

posible que se hayan producido daños en el almacenamiento.




FSIVSHAR-404 FSM ENCOUNTERED AN EXECUTION TIME ERROR.

Explicación: La entrada especificada al módulo de la máquina de estados finitos no era válida dado el estado actual de

la máquina de estados finitos especificada. Es posible que se hayan producido daños en el almacenamiento.




FSIVSHAR-405 INVALID CONTROL BLOCK NUMBER REQUESTED.

Explicación: El módulo formateador de bloques de control recibió una solicitud de la dirección de un bloque de

control desconocido. Es posible que se hayan producido daños en el almacenamiento.

Acción del sistema: terminación de la sesión. Respuesta del usuario: consulte el programa de aplicación para ver si hay

posibles infracciones de almacenamiento. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-406 CONTROL FILE PROGRAM FAILED ON <oper>. FILE STATUS = <nn>.

Explicación: Se produjo un error de I/O al acceder al archivo de control de información de la sesión. <oper> indica la

operación que falló (abrir, cerrar o leer) y <nn> es el código de estado del archivo COBOL. Consulte la guía de

referencia del programador de COBOL para obtener más información sobre el código de estado.


Respuesta del usuario: El código de estado del archivo debe revelar la naturaleza del problema (es decir, registro de

control no encontrado, definición de archivo incorrecta, etc.).

146

Messages and Codes

FSIVSHAR-407 CONTROL FILE PROGRAM FAILED - RETURN CODE WAS NOT SET.

Explicación: Este módulo invocó el Programa de archivo de control, pero no estableció un código de retorno. Es

posible que el campo del código de retorno esté dañado.




FSIVSHAR-408 CONTROL FILE PROGRAM FAILED - UNKNOWN RETURN CODE.

Explicación: Este módulo invocó el Programa de archivo de control, pero terminó con un código de retorno

desconocido. Es posible que el campo del código de programa esté dañado.




FSIVSHAR-409 REQUEST TO EXECUTE UNKNOWN ROUTINE.

Explicación: Se invocó el enrutador de verbos desde el Programa de transacciones, pero la lista de parámetros

contenía un número de rutina desconocido. Es posible que el almacenamiento del programa esté dañado.




FSIVSHAR-410 INVALID RETURN CODE FROM CONTROL BLOCK FORMATTER.

Explicación: Este módulo invocó el programa formateador de bloques de control, pero terminó de forma anormal.



FSIVSHAR-411 INVALID PARM - LU NAME.

Explicación: El ID de la aplicación remota pasada como parámetro a este módulo contenía caracteres no válidos. El

registro de información de la sesión en el archivo de control puede no ser válido o el almacenamiento del programa

puede estar dañado.


Respuesta del usuario: compruebe el registro de información de la sesión del archivo de control para garantizar la

validez de la información de la sesión. Consulte el capítulo Instalación para conocer el formato de este registro. Si el

registro parece válido y el error persiste, consulte el programa de aplicación para ver si hay posibles violaciones de

almacenamiento. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-412 LU_NAME NOT ON PARTNER LU LIST.

Explicación: El ID de aplicación remota pasado como parámetro a este módulo no se encontró en la lista de socios

válidos para esta LU. El registro de información de la sesión en el archivo de control puede ser incorrecto o el

almacenamiento del programa puede estar dañado.






147

Messages and Codes

FSIVSHAR-413 INVALID PARM - MODE_NAME.

Explicación: El ID de nombre de entrada de la tabla de modo pasado como parámetro a este módulo contenía

caracteres no válidos. El registro de información de la sesión en el archivo de control puede ser incorrecto o el

almacenamiento del programa puede estar dañado.



validez de la información de la sesión. Consulte el manual de instalación para conocer el formato de este registro. Si el


almacenamiento. Si el problema persiste, comuníquese con su grupo de soporte técnico.

FSIVSHAR-414 MODE NAME NOT ON PARTNER LU MODELIST.

Explicación: El ID de nombre de entrada de la tabla de modalidad que se pasó como parámetro a este módulo no se

incluyó como una entrada de modalidad válida para la ID de aplicación remota especificada. El registro de información

de la sesión en el archivo de control puede ser incorrecto o el almacenamiento del programa puede estar dañado.


Respuesta del usuario: Verifique el registro de información de la sesión del archivo de control para garantizar la

validez de la información de la sesión. Consulte el manual de instalación para conocer el formato de este registro. Si el


almacenamiento. Si el problema persiste, comuníquese con el soporte técnico.

FSIVSHAR-415 NO PARMLIST RETURNED FROM RM.

Explicación: Se devolvió una dirección de lista de parámetros no válida de una llamada al Administrador de recursos.



FSIVSHAR-416 WRONG REC TYPE RETURNED FROM RM.

Explicación: Este módulo recibió un tipo de registro desconocido o no válido del Administrador de recursos. Es posible

que se hayan producido daños en el almacenamiento.



FSIVSHAR-417 UNKNOWN RETCODE FROM RM.

Explicación: Este módulo recibió un código de retorno desconocido/no válido del Administrador de recursos. Es




FSIVSHAR-418 ABEND REQUESTED BY RM.

Explicación: El código de retorno de una llamada al Administrador de recursos indica que se encontró una situación de

finalización anormal.


Respuesta del usuario: busque más mensajes del Administrador de recursos y actúe en consecuencia. Si no se

encuentra ninguno, es posible que el almacenamiento esté dañado. Si el problema persiste, comuníquese con el


148

Messages and Codes

FSIVSHAR-419 INVALID SESSION ID SPECIFIED.

Explicación: El parámetro de ID de sesión pasado a este módulo contenía caracteres ilegales. Es posible que el área de

almacenamiento del programa de transacciones se haya dañado.




FSIVSHAR-420 TYPE PARAMETER CONTAINS INVALID VALUE.

Explicación: El parámetro pasado a este módulo que especifica el tipo de desactivación era un valor desconocido. Es

posible que el área de almacenamiento del programa de transacciones se haya dañado.




FSIVSHAR-421 NO PARMLIST RETURNED FROM RM.




FSIVSHAR-422 WRONG REC TYPE RETURNED FROM RM.

Explicación: Este módulo recibió un tipo de registro desconocido o no válido del Administrador de recursos. Es posible

que se hayan producido daños en el almacenamiento.



FSIVSHAR-423 UNKNOWN RETCODE FROM RM.

Explicación: Este módulo recibió un código de retorno desconocido / no válido del Administrador de recursos. Es




FSIVSHAR-424 SESSION DEACT MAY NOT HAVE COMPLETED.

Explicación: La llamada al Administrador de recursos para desactivar la sesión se completó con un código de retorno

distinto de cero. Esto es solo una advertencia ya que la sesión terminará de todos modos cuando finalice el programa

de transacciones. La LU remota puede generar mensajes relacionados.

Acción del sistema: Continuar normalmente, solo advertencia.


FSIVSHAR-425 RECEIVED INVALID ADDRESS OF PARM LIST.

Explicación: La dirección de la lista de parámetros pasada a este programa no es válida. Es posible que se hayan

producido daños en el almacenamiento.




149

Messages and Codes

FSIVSHAR-426 OWN (LOCAL) IS UNSUPPORTED PARAMETER.

Explicación: El parámetro "propio" especifica que el programa de transacciones que se asignará reside en la LU local.

Esta es una opción no admitida, pero es posible que se haya especificado erróneamente debido a daños en el

almacenamiento.




FSIVSHAR-427 LUNAME PARM CONTAINS INVALID CHARACTERS.

Explicación: El ID de la aplicación remota pasada como parámetro a este módulo contenía caracteres no válidos. Dado

que este error no se encontró durante la activación de la sesión, es posible que el almacenamiento del programa esté

dañado.




FSIVSHAR-428 MODE PARM CONTAINS INVALID CHARACTERS.

Explicación: El ID de nombre de entrada de la tabla de modo pasado como parámetro a este módulo contenía

caracteres no válidos. Dado que este error no se encontró durante la activación de la sesión, es posible que el

almacenamiento del programa esté dañado.




FSIVSHAR-429 TPNAME PARM CONTAINS INVALID CHARACTERS.

Explicación: El ID de transacción remota pasado como parámetro a este módulo contenía caracteres no válidos. El

registro de información de la sesión en el archivo de control puede no ser válido o el almacenamiento del programa

puede estar dañado.






FSIVSHAR-430 MODE=SNASVCMG INVALID FOR THIS PROGRAM.

Explicación: La modalidad especificada solo es válida para programas de transacciones de servicios de LU.


Respuesta del usuario: ponga un nombre de entrada de modo válido en el registro de información de la sesión del

archivo de control. Consulte el capítulo Instalación para conocer el formato de este registro. Si el registro parece

válido y el error persiste, comuníquese con el soporte técnico.

FSIVSHAR-431 UNSUPPORTED PARM - MAPPED CONVERSATION.

Explicación: Este programa recibió una solicitud para una conversación mapeada que es una opción no admitida. Es

posible que el almacenamiento de la lista de parámetros se haya dañado.




150

Messages and Codes

FSIVSHAR-432 RM RETURNED RECORD WITH INVALID SOURCE.

Explicación: Este módulo llamó al Administrador de recursos que devolvió un registro con un campo de origen no

válido. Es posible que se hayan producido daños en el almacenamiento.




FSIVSHAR-433 NONZERO RETURN CODE FOUND IN RECORD FROM RM.

Explicación: El administrador de recursos encontró una condición anormal al procesar una solicitud de este módulo.


Respuesta del usuario: busque más mensajes del Administrador de recursos y actúe en consecuencia. Si no se

encuentra ninguno, es posible que el almacenamiento esté dañado. Si el problema persiste, comuníquese con el


FSIVSHAR-434 INVALID RECORD ADDR RETURNED FROM RM.




FSIVSHAR-435 LUNAME PARM NOT FOUND IN PCB.

Explicación: El ID de la aplicación remota pasado como parámetro a este módulo no figuraba como una LU asociada

válida en el Bloque de control de partners. El registro de información de la sesión en el archivo de control puede no

ser válido o el almacenamiento del programa puede estar dañado.






FSIVSHAR-436 MODE PARM NOT FOUND IN MCB.

Explicación: El nombre de entrada de modalidad pasado como parámetro a este módulo no se incluyó en el Bloque de

control de modalidad para esta LU. El registro de información de la sesión en el archivo de control puede no ser válido

o el almacenamiento del programa puede estar dañado.






FSIVSHAR-437 ALLOCATE FAILED - RCB NOT CREATED.

Explicación: Resource Manager devolvió un registro de error de conversación en una solicitud de asignación y no se

encontró el ID de conversación en el bloque de control de recursos. Por lo tanto, no se realizó ningún otro

procesamiento de errores para la conversación.


Respuesta del usuario: busque más mensajes del Administrador de recursos y actúe en consecuencia. Si no encuentra

ninguno y el problema persiste, comuníquese con el soporte técnico.

151

Messages and Codes

FSIVSHAR-438 ALLOCATE FAILED - PROTOCOL VIOLATION.

Explicación: Resource Manager devolvió un registro de error de conversación en una solicitud de asignación y el

código de motivo indicó que se detectó una infracción de protocolo.


Respuesta del usuario: si el problema persiste, comuníquese con el soporte técnico.

FSIVSHAR-439 ALLOCATE FAILED - SESSION OUTAGE.

Explicación: Resource Manager devolvió un registro de error de conversación en una solicitud de asignación y el

código de motivo indicó que se detectó una interrupción de la sesión.


Respuesta del usuario: si el problema persiste, comuníquese con el soporte técnico.

FSIVSHAR-440 ALLOCATE FAILED RETURNED FROM RM.

Explicación: El administrador de recursos estableció el código de retorno en una solicitud de asignación en "asignación

fallida".

Acción del sistema: El código de retorno del verbo de asignación se establece en "asignación fallida" y el control se

devuelve al programa de transacciones.

Respuesta del usuario: compruebe si hay más mensajes. Si no encuentra ninguno y el problema persiste,


FSIVSHAR-441 SYNC LEVEL UNSUPPORTED ON ALLOCATE.

Explicación: El administrador de recursos estableció el código de retorno en una solicitud de asignación en "nivel de

sincronización no admitido". Es posible que la lista de parámetros esté dañada.

Acción del sistema: el código de retorno del verbo de asignación se establece en 'synclevel unsupported' y el control

se devuelve al programa de transacciones.



FSIVSHAR-442 UNKNOWN RETCODE FROM RM ON ALLOCATE.

Explicación: Se desconoce el código de retorno establecido por Resource Manager en una solicitud de asignación. Es

posible que el almacenamiento esté dañado.




FSIVSHAR-443 FSM CONVERSATION ENCOUNTERED ABEND.

Explicación: El estado de la conversación no se pudo cambiar a "RCB asignado" desde su estado actual. Esto puede

suceder si el área del código de retorno o el almacenamiento de la máquina de estado finito se ha dañado.




152

Messages and Codes

FSIVSHAR-444 HS FAILED SENDING FMH-5 RECORD - NONZERO RETCODE FOUND.

Explicación: Este módulo se denomina Half Session para enviar un encabezado de gestión de funciones de tipo

adjunto (FMH-5) a la LU remota para iniciar un TP remoto. Half Session no pudo completar esta solicitud

normalmente.


Respuesta del usuario: compruebe si hay más mensajes de Half Session. Si no encuentra ninguno, consulte el

programa de aplicación para ver si hay posibles infracciones de almacenamiento. Si el problema persiste,


FSIVSHAR-445 RETURN CONTROL PARM NOT WHEN_SESS_ALLOC (REQUIRED).

Explicación: El parámetro de control de retorno del verbo de asignación no se estableció en "cuando se asignó la

sesión", lo que requiere la LU de lote. Es posible que la lista de parámetros esté dañada.




FSIVSHAR-446 FSM CONVERSATION LOGIC OR PARM ERROR.

Explicación: La máquina de estado finito de la conversación no pudo completar la operación solicitada porque los

parámetros pasados eran incorrectos o porque los datos de la máquina de estado finito estaban dañados.




FSIVSHAR-447 INVALID RECORD ADDR RETURNED FROM HS.

Explicación: La dirección del registro que se esperaba del administrador de media sesión en una solicitud de

desasignación no se pudo utilizar. Es posible que se hayan producido daños en el almacenamiento.




FSIVSHAR-448 NONZERO RETCODE FROM DEALLOCATION_CLEANUP.

Explicación: Se llamó al programa de limpieza de desasignación para desasignar la conversación de forma anormal,

pero tampoco se pudo completar normalmente. Es posible que el almacenamiento del programa esté dañado.




FSIVSHAR-449 INVALID PARM LIST ADDRESS FOUND.

Explicación: El programa de transacciones pasó una dirección de lista de parámetros que era negativa o cero.


Respuesta del usuario: busque otros mensajes relacionados. Si el problema persiste, comuníquese con el soporte

técnico de CSI.

153

Messages and Codes

FSIVSHAR-450 RCBID PARM DOES NOT MATCH ALLOCATED RCB.

Explicación: El parámetro del identificador de conversación (RCBID) del programa de transacciones no coincide con el

RCBID de la conversación asignada actualmente. Es posible que se hayan producido daños en el almacenamiento del

programa.




FSIVSHAR-451 TYPE PARM NOT IN VALID RANGE.

Explicación: El parámetro de tipo de desasignación pasado por el programa de transacciones no estaba dentro del

rango de valores posibles. Es posible que se hayan producido daños en el almacenamiento.




FSIVSHAR-452 RM RETURNED OTHER THAN RCB-DEALLOCATED REC.

Explicación: El parámetro de tipo de desasignación pasado por el programa de transacciones no estaba dentro del

rango de valores posibles. Es posible que se hayan producido daños en el almacenamiento.




FSIVSHAR-453 INVALID SOURCE FOUND ON RECORD FROM RM.

Explicación: El registro devuelto por el administrador de recursos en una solicitud de desasignación contenía un valor

inesperado o desconocido en el campo "fuente". Es posible que se hayan producido daños en el almacenamiento.


Respuesta del usuario: compruebe el programa de aplicación para ver si hay posibles infracciones de


FSIVSHAR-454 NONZERO RETURN CODE FROM CALL TO RM.

Explicación: El administrador de recursos no pudo al intentar desasignar la conversación. Esto fue indicado por un

código de retorno distinto de cero establecido en el registro recibido del administrador de recursos.


Respuesta del usuario: compruebe si hay más mensajes del administrador de recursos. Si el problema persiste,


FSIVSHAR-455 INVALID REC ADDRESS RETURNED FROM RM.

Explicación: La dirección del registro que se esperaba del administrador de recursos en una solicitud de desasignación

no se pudo utilizar. Es posible que se hayan producido daños en el almacenamiento del programa.




154

Messages and Codes

FSIVSHAR-456 UNSUPPORTED PARM: TYPE = CONFIRM.

Explicación: El programa de transacciones solicitó la desasignación de la conversación con sincronización de nivel de

confirmación. Este tipo no es compatible. Es posible que se hayan producido daños en el almacenamiento del

programa.




FSIVSHAR-457 UNSUPPORTED PARM: TYPE = SYNCLEVEL.

Explicación: El programa de transacciones solicitó la desasignación de la conversación con sincronización "synclevel".

Este tipo no es compatible. Es posible que se hayan producido daños en el almacenamiento del programa.




FSIVSHAR-458 UNSUPPORTED PARM: TYPE = ABEND SVC.

Explicación: El tipo de desasignación solicitado no es válido para el programa de transacciones, ya que solo lo utilizan

las transacciones de servicio de LU. Es posible que se hayan producido daños en el almacenamiento del programa.




FSIVSHAR-459 UNSUPPORTED PARM: TYPE = ABEND TIMER.

Explicación: El tipo de desasignación solicitado no es válido para el programa de transacciones, ya que solo lo utilizan

las transacciones de servicio de LU. Es posible que se hayan producido daños en el almacenamiento del programa.




FSIVSHAR-460 UNSUPPORTED PARM: TYPE = LOCAL.

Explicación: No se admite la desasignación local. Este tipo solo se utiliza cuando el programa de transacciones desea

limpiar la LU local después de haber sido informado de que la desasignación tuvo lugar durante un verbo emitido

anteriormente. Es posible que se hayan producido daños en el almacenamiento del programa.




FSIVSHAR-461 UNKNOWN OUTPUT CODE FROM FSM CONVERSATION.

Explicación: Se encontró una verificación de estado al intentar cambiar el estado de la conversación a desasignado. En

este caso, la única acción que se espera tomar (como se indica en el código de salida) es realizar la limpieza de la

desasignación. Este código no se recibió posiblemente debido a un almacenamiento dañado.




155

Messages and Codes

FSIVSHAR-462 DEALLOCATION CLEANUP PERFORMED.

Explicación: La limpieza de la desasignación se realiza cuando se encuentra un error para el que se debe desasignar la

conversación. También deberían aparecer otros mensajes que indiquen la naturaleza del problema.


Respuesta del usuario: busque otros mensajes para identificar más el problema. Si el problema persiste, comuníquese


FSIVSHAR-463 SEND DATA NOT ON LOGICAL RECORD BOUNDARY.

Explicación: El campo de longitud de envío indicó que quedaban algunos datos por enviar cuando el programa de

transacciones realizó la solicitud de desasignación. Es posible que se hayan producido daños en el almacenamiento.

Acción del sistema: se realizará la limpieza de la desasignación y se terminará la sesión.



FSIVSHAR-464 INVALID REC ADDRESS RETURNED FROM HS.

Explicación: La dirección del registro que se esperaba del administrador de media sesión en una solicitud de

desasignación no se pudo utilizar. Es posible que se hayan producido daños en el almacenamiento del programa.




FSIVSHAR-465 NONZERO RETURN CODE FROM CALL TO HS.

Explicación: El gestor de media sesión no pudo enviar una solicitud de desasignación a la LU remota. Esto fue indicado

por un código de retorno distinto de cero establecido en el registro recibido de la media sesión.











Explicación: La máquina de estado finito de la conversación marcó una situación de fin anormal en función del estado

actual de la conversación y el estado al que se estaba cambiando. Algunas operaciones internas se realizaron fuera de

secuencia o el almacenamiento del programa se corrompió.




156

Messages and Codes

FSIVSHAR-468 NONZERO RETCODE FROM DEALLOCATION CLEANUP.










técnico de CSI.




programa.











FSIVSHAR-472 UNKNOWN OUTPUT FROM FSM CONVERSATION.

Explicación: La salida de la conversación Finite State Machine no es uno de los valores posibles (verificación de estado,

normal o final anormal). Es posible que el almacenamiento de la lista de parámetros o el almacenamiento de la

máquina de estado finito estén dañados.










157

Messages and Codes

FSIVSHAR-474 FSM_ERROR_OR_FAILURE LOGIC OR PARM ERROR.

Explicación: El error / fallo de la máquina de estado finito no pudo completar la operación solicitada porque los





FSIVSHAR-475 FSM_ERROR_OR_FAILURE ENCOUNTERED ABEND.

Explicación: La máquina de estado finito de error / falla marcó una situación de finalización anómala según el estado






FSIVSHAR-476 LL FIELD OF SEND DATA IS INVALID.

Explicación: El campo de longitud de dos bytes que precede a los datos que se enviarán se puede configurar hasta

32765. Este valor incluye el campo de longitud, por lo que debe ser al menos 2. Además, el primer bit de la longitud

está reservado, por lo que uno de los siguientes Se encontraron valores no válidos: x'0000 ', x'0001', x'8000 'o x'8001'.

Es posible que los bytes de longitud estén dañados.




FSIVSHAR-477 HS FAILED SENDING TP DATA RECORD (NONZERO RETCODE).

Explicación: El gestor de media sesión falló durante una solicitud para enviar datos a la LU remota. Esto fue indicado

por un código de retorno distinto de cero establecido en el registro recibido de la media sesión.


Respuesta del usuario: compruebe si hay más mensajes del administrador de media sesión. Si el problema persiste,



Explicación: Se encontró una verificación de estado al intentar cambiar el estado de la conversación a "enviar". En

este caso, la única acción que se espera tomar (como se indica en el código de salida) es realizar la limpieza de la

desasignación. Este código no se recibió posiblemente debido a un almacenamiento dañado.





Explicación: La dirección del registro que se esperaba del administrador de media sesión no se pudo utilizar. Es posible

que se hayan producido daños en el almacenamiento del programa.




158

Messages and Codes







FSIVSHAR-481 STATE CHECK CHANGING FSM TO SEND STATE.

Explicación: Se encontró una verificación de estado al intentar cambiar el estado de la conversación a "enviar". Este

mensaje es solo una advertencia, ya que el programa intentará procesar el código de salida de la máquina de estado.

Pueden generarse otros mensajes.

Acción del sistema: inicie el procesamiento de errores que conduzca a la finalización de la sesión.

Respuesta del usuario: busque otros mensajes relacionados y actúe en consecuencia. Si el problema persiste,


FSIVSHAR-482 FOUND NONZERO VTAM SENSE CODE IN LULUCB.

Explicación: Se encontró un problema de sesión antes de la invocación de este módulo. La sesión probablemente se

desactivó de forma anormal como resultado.

Acción del sistema: Continúe con el procesamiento de errores que provocará la finalización del programa.

Respuesta del usuario: busque otros mensajes relacionados y actúe en consecuencia. Si el problema persiste,






técnico de CSI.




programa.




FSIVSHAR-485 INVALID TYPE PARAMETER FOUND.

Explicación: El parámetro de tipo pasado a este módulo no era válido (no FLUSH, CONFIRM ni SYNC_LEVEL).




159

Messages and Codes

FSIVSHAR-486 TYPE = CONFIRM NOT SUPPORTED.

Explicación: El parámetro de tipo que se pasó al módulo Preparar para recibir fue CONFIRMAR. Esta opción no es

compatible.




FSIVSHAR-487 TYPE UNSUPPORTED (SYNCPT AND RCB.LEVEL NOT NONE).

Explicación: El parámetro de tipo que se pasó al módulo Preparar para recibir fue SYNCPT. Esta opción solo se admite

si RCB SYNCLEVEL es ninguno.




FSIVSHAR-488 DEALLOCATION CLEANUP INVOKED.


conversación. Otros mensajes que indiquen la naturaleza del problema deberían acompañar a este.


Respuesta del usuario: busque otros mensajes para identificar mejor el problema. Si el problema persiste,



Explicación: Se encontró una verificación de estado al intentar cambiar el estado de la conversación. En este caso, la

única acción que se espera tomar (como se indica en el código de salida) es realizar la limpieza de la desasignación.

Este código no se recibió posiblemente debido a un almacenamiento dañado.





Explicación: El error / falla de la máquina de estado finito no pudo completar la operación solicitada porque los






Explicación: El procesador de la máquina de estados finitos encontró un error de tiempo de ejecución al cambiar el

FSM ERROR_OR_FAILURE al estado RESET.




160

Messages and Codes

FSIVSHAR-492 FSM_CONVERSATION LOGIC OR PARM ERROR.


parámetros pasados eran incorrectos o los datos de la máquina de estado finito estaban dañados.




FSIVSHAR-493 STATE CHECK CHECKING FSM WITH PREP_TO_RCV_FLUSH.

Explicación: El estado de la conversación no se pudo cambiar a PREPARE_TO_RECEIVE_FLUSH por lo que se ejecuta el

código de salida correspondiente. El código de salida probablemente implica una limpieza de desasignación.

Acción del sistema: Continúe procesando el código de salida de FSM.


técnico de CSI.







FSIVSHAR-495 HS FAILED HANDLING PREP_TO_RCV_FLUSH RECORD.

Explicación: Se llamó a HS para manejar una solicitud PREPARE_TO _RECEIVE_FLUSH pero no completó la solicitud

normalmente.


Respuesta del usuario: compruebe si hay más mensajes de Half Session. Si el problema persiste, comuníquese con el


FSIVSHAR-496 FSM_CONVERSATION ENCOUNTERED ABEND.













161

Messages and Codes





técnico de CSI.




programa.




162

Messages and Codes

Mensajes de Protección


Explicación: La máquina de estado finito de la conversación marcó una situación de fin anormal en función del estado actual de la conversación y el estado al que se estaba cambiando. Algunas operaciones internas se realizaron fuera de secuencia o el almacenamiento del programa se corrompió. Acción del sistema: terminación de la sesión. Respuesta del usuario: consulte el programa de aplicación para ver si hay posibles infracciones de almacenamiento. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-502 UNKNOWN OUTPUT FROM FSM_CONVERSATION.

Explicación: La salida de la conversación Finite State Machine no es uno de los valores posibles (verificación de estado, normal o final anormal). Es posible que el almacenamiento de la lista de parámetros o el almacenamiento de la máquina de estado finito estén dañados. Acción del sistema: terminación de la sesión. Respuesta del usuario: consulte el programa de aplicación para ver si hay posibles infracciones de almacenamiento. Si el problema persiste, comuníquese con el soporte técnico de CSI.


Explicación: La máquina de estado finito de la conversación no pudo completar la operación solicitada porque los parámetros pasados eran incorrectos o porque los datos de la máquina de estado finito estaban dañados. Acción del sistema: terminación de la sesión. Respuesta del usuario: consulte el programa de aplicación para ver si hay posibles infracciones de almacenamiento. Si el problema persiste, comuníquese con el soporte técnico de CSI.


Explicación: El error / fallo de la máquina de estado finito no pudo completar la operación solicitada porque los parámetros pasados eran incorrectos o porque los datos de la máquina de estado finito estaban dañados. Acción del sistema: terminación de la sesión. Respuesta del usuario: consulte el programa de aplicación para ver si hay posibles infracciones de almacenamiento. Si el problema persiste, comuníquese con el soporte técnico de CSI.


Explicación: La máquina de estado finito de error / falla marcó una situación de finalización anómala según el estado actual de la conversación y el estado al que se estaba cambiando. Algunas operaciones internas se realizaron fuera de secuencia o el almacenamiento del programa se corrompió. Acción del sistema: terminación de la sesión. Respuesta del usuario: consulte el programa de aplicación para ver si hay posibles infracciones de almacenamiento. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-506 NONZERO RETURN FROM PS_PROTOCOL_ERROR.

Explicación: Se llamó al programa de procesamiento de errores de protocolo para procesar un error de protocolo encontrado durante una operación de recepción y no se completó normalmente. Es posible que el almacenamiento del programa esté dañado. Acción del sistema: terminación de la sesión. Respuesta del usuario: compruebe si hay más mensajes relacionados con el problema. También consulte el programa de aplicación para ver si hay posibles violaciones de almacenamiento. Si el problema persiste, comuníquese con el soporte técnico de CSI.

163

Messages and Codes

FSIVSHAR-507 NONZERO RETCODE FROM HS AFTER RECEIVE.

Explicación: El gestor de media sesión falló durante una solicitud para recibir la fecha de la LU remota. Esto fue

indicado por un código de retorno distinto de cero establecido en el registro recibido de la media sesión.


Respuesta del usuario: compruebe si hay más mensajes del administrador de media sesión. Si el problema persiste,


FSIVSHAR-508 NONZERO RETCODE FROM PERFORM_RECEIVE_PROC.

Explicación: Se llamó al programa de procesamiento de recepción para procesar un registro recibido, pero no se

completó normalmente (R15 era distinto de cero). Es posible que se hayan generado más mensajes.


Respuesta del usuario: compruebe si hay más mensajes. Si el problema persiste, comuníquese con el soporte técnico

de CSI.

FSIVSHAR-509 NONZERO RETCODE FROM DEALLOCATION_CLEANUP.






FSIVSHAR-510 UNKNOWN OUTPUT CODE FROM FSM_CONVERSATION.

Explicación: Se encontró una verificación de estado y el programa estaba intentando procesar el código de salida

resultante de la conversación Finite State Machine. Sin embargo, el código de salida tenía un valor desconocido,

posiblemente debido a daños en el almacenamiento.










FSIVSHAR-512 INVALID SOURCE FOUND ON RECORD FROM HS.

Explicación: El registro devuelto por el administrador de media sesión en una solicitud de recepción contenía un valor





164

Messages and Codes

FSIVSHAR-513 PROTOCOL ERROR AFTER RECEIVE BY HS.

Explicación: Se invocó el programa de procesamiento de errores de protocolo basándose en los datos recibidos de la

media sesión. Deben incluirse más mensajes. Acción del sistema: terminación de la sesión. Respuesta del usuario:

busque más mensajes para ayudar a identificar el problema. Si el problema persiste, comuníquese con el soporte

técnico de CSI.

FSIVSHAR-514 PROTOCOL ERROR - DIDNT GET EXPECTED FMH7.

Explicación: Se produjo un error de recepción para el cual este módulo esperaba un registro de encabezado de

administración de función de tipo de error (FMH7). Los datos recibidos no eran un FMH7.


Respuesta del usuario: busque más mensajes que puedan identificar la naturaleza del error. Los mensajes pueden

indicar por qué se envió el FMH7. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-515 NONZERO RETCODE FROM PROCESS_FMH7_PROC.

Explicación: Este módulo recibió un FMH7 de la LU remota y llamó al módulo de procesamiento FMH7 para

manejarlo. El procesador FMH7 no se completó normalmente y puede haber generado más mensajes.

Acción del sistema: Regrese al programa por lotes con los códigos de retorno apropiados.

Respuesta del usuario: busque más mensajes para identificar el problema. Si el error persiste, comuníquese con el

soporte técnico.

FSIVSHAR-516 INVALID PARM LIST ADDR FROM PROCESS_FMH7.

Explicación: Se recibió una cabecera de gestión de función de error (FMH7) de la LU remota y fue procesada por el

módulo de procesamiento FMH7. La dirección de la lista de parámetros de retorno del procesador FMH7 no se podía

utilizar.


Respuesta del usuario: busque más mensajes que puedan identificar el origen del problema. Si el error persiste,


FSIVSHAR-517 TWO REQ_2_SEND SIGNALS RECEIVED FROM HS.

Explicación: Se recibió una señal de solicitud de envío desde la LU remota, después de lo cual, este programa

esperaba recibir un registro de datos. Sin embargo, en su lugar se recibió otra señal de solicitud de envío.



técnico de CSI.

FSIVSHAR-518 UNEXPECTED CONFIRMED REC RECVD FROM HS.

Explicación: Los datos no se envían con solicitudes de confirmación, por lo que este módulo no espera recibir acuses

de recibo de confirmación (registros confirmados). Sin embargo, este módulo recibió uno. Es posible que el área de

almacenamiento de registros se haya dañado.




165

Messages and Codes

FSIVSHAR-519 UNEXPECTED RTS RESPONSE RECVD FROM HS.

Explicación: No se emitió la solicitud de envío, por lo que el programa no esperaba recibir una respuesta. El área de datos de registro puede estar dañada o la LU remota puede estar experimentando problemas. Acción del sistema: terminación de la sesión. Respuesta del usuario: busque mensajes que identifiquen más el problema, incluido el registro de CICS. Además, consulte el programa de aplicación para ver si hay posibles violaciones de almacenamiento. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-520 UNKNOWN RECORD TYPE FROM RECVD FROM HS.

Explicación: Se recibió un registro de la media sesión, pero se desconocía su tipo y, por lo tanto, no se pudo procesar. Es posible que el área de almacenamiento de registros se haya dañado. Acción del sistema: terminación de la sesión. Respuesta del usuario: consulte el programa de aplicación para ver si hay violaciones de almacenamiento. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-521 STATE CHECK CHANGING TO RCV_IMMED STATE.

Explicación: Se encontró una verificación de estado al intentar cambiar el estado de la conversación a "recibir inmediatamente". Este mensaje es solo una advertencia, ya que el programa intentará procesar el código de salida de la máquina de estado. Pueden generarse otros mensajes. Acción del sistema: inicie el procesamiento de errores que conduzca a la finalización de la sesión. Respuesta del usuario: busque otros mensajes relacionados y actúe en consecuencia. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-522 FOUND NONZERO VTAM SENSE CODE IN LULUCB.

Explicación: Se encontró un problema de sesión antes de la invocación de este módulo o durante el procesamiento de recepción. La sesión probablemente se desactivó de forma anormal como resultado. Acción del sistema: Continúe con el procesamiento de errores que provocará la finalización del programa. Respuesta del usuario: busque otros mensajes relacionados y actúe en consecuencia. Si el problema persiste, comuníquese con el soporte técnico de CSI.


Explicación: El programa por lotes pasó una dirección de lista de parámetros que era negativa o cero. Acción del sistema: terminación de la sesión. Respuesta del usuario: busque otros mensajes relacionados. Si el problema persiste, comuníquese con el soporte técnico de CSI.


Explicación: La dirección del registro que se esperaba del administrador de recursos no se pudo utilizar. Es posible que se hayan producido daños en el almacenamiento del programa. Acción del sistema: terminación de la sesión. Respuesta del usuario: consulte el programa de aplicación para ver si hay posibles infracciones de almacenamiento. Si el problema persiste, comuníquese con el soporte técnico de CSI.


Explicación: El administrador de recursos no pudo procesar un registro de error de protocolo de desvinculación. Esto fue indicado por un código de retorno distinto de cero establecido en el registro recibido del administrador de recursos. Acción del sistema: terminación de la sesión. Respuesta del usuario: compruebe si hay más mensajes del administrador de recursos. Si el problema persiste, comuníquese con el soporte técnico de CSI.

166

Messages and Codes


Explicación: El registro devuelto por el administrador de recursos en una solicitud de recepción contenía un valor


















FSIVSHAR-530 PROTOCOL ERROR WITH SENSE = nnnnnnnn.

Explicación: Los servicios de presentación detectaron un error de protocolo. Este mensaje debe ir acompañado de

otros que describan con más detalle el error. Los valores del código de sentido y sus significados se pueden encontrar

en la publicación de IBM "SNA Format and Protocol Manual for LU Type 6.2".

Acción del sistema: Se llama al administrador de recursos para desactivar la sesión. El control se devuelve al programa

de transacciones después de la terminación de la sesión.

Respuesta del usuario: compruebe si hay más mensajes de los servicios de presentación. Si el problema persiste,






técnico de CSI.

FSIVSHAR-532 INVALID REC ADDRESS RETURNED FROM HS.






167

Messages and Codes

FSIVSHAR-533 NONZERO RETURN CODE FROM CALL TO HS.

Explicación: El administrador de media sesión falló al intentar recibir un encabezado de administración de función de

tipo de error (FMH7). Esto fue indicado por un código de retorno distinto de cero establecido en el registro recibido de

media sesión.


Respuesta del usuario: compruebe si hay más mensajes relacionados con el problema. Si el problema persiste,


FSIVSHAR-534 INVALID SOURCE FOUND ON RECORD FROM HS.

Explicación: Al intentar recibir un registro FMH7 de media sesión, este módulo recibió un registro con un valor











FSIVSHAR-536 FSM_CONVERSATION ENCOUNTERED AN ABEND.







FSIVSHAR-538 NONZERO RETCODE FROM PS_PROTOCOL_ERROR.

Explicación: Se llamó al programa de procesamiento de errores de protocolo para procesar un error de protocolo

encontrado en este módulo, pero no se completó normalmente. Es posible que el almacenamiento del programa esté

dañado.


Respuesta del usuario: compruebe si hay más mensajes relacionados con el problema. También consulte el programa

de aplicación para ver si hay posibles violaciones de almacenamiento. Si el problema persiste, comuníquese con el








168

Messages and Codes


Explicación: Se encontró una verificación de estado y el programa estaba intentando procesar el código de salida

resultante de la conversación Finite State Machine. Sin embargo, un código de salida tenía un valor desconocido

posiblemente debido a daños en el almacenamiento.





Explicación: FSM_OR_FAILURE LOGIC OR PARM ERROR.


Respuesta del usuario: busque cualquier mensaje de error anterior y corríjalo según sea necesario. Si el problema

persiste, llame al soporte técnico de CSI.


Explicación: FSM_OR_FAILURE ENCONTRADO ABEND.


Respuesta del usuario: busque cualquier mensaje de error anterior y corríjalo según sea necesario. Si el problema

persiste, llame al soporte técnico de CSI.


Explicación: La dirección del registro que se esperaba del administrador de recursos después de solicitar la

desasignación no se podía utilizar. Es posible que se hayan producido daños en el almacenamiento del programa.





Explicación: Al verificar el registro devuelto por el administrador de recursos después de una solicitud de

desasignación, este módulo encontró un valor inesperado o desconocido en el campo "fuente". Es posible que se

hayan producido daños en el almacenamiento.





Explicación: El administrador de recursos falló al procesar una solicitud de desasignación. Esto fue indicado por un

código de retorno distinto de cero establecido en el registro recibido de media sesión.




169

Messages and Codes

FSIVSHAR-546 RM RETURNED OTHER THAN RCB-DEALLOCATED REC.

Explicación: Después de solicitar que el administrador de recursos desasigne la conversación, este programa esperaba

que se volviera a sintonizar un registro de tipo "RCB-DEALLOCATED" del administrador de recursos. Se devolvió otro

tipo de registro inesperado o desconocido. Es posible que se hayan producido daños en el almacenamiento.




FSIVSHAR-547 DEALLOCATION CLEANUP INVOKED.


conversación. También deberían aparecer otros mensajes que indiquen la naturaleza del problema.


Respuesta del usuario: busque otros mensajes para identificar más el problema. Si el problema persiste, comuníquese


FSIVSHAR-548 INVALID ADDR OF HS RECORD PASSED IN REG01.




técnico de CSI.

FSIVSHAR-549 INVALID PARM LIST ADDRESS PASSED IN PARMBAR.

Explicación: Este módulo esperaba obtener la dirección de la lista de parámetros del verbo de recepción en un

registro ('parmbar') pero la dirección en ese registro no era válida.



técnico de CSI.

FSIVSHAR-550 NONZERO RETCODE FROM PS_PROTOCOL_ERROR.



dañado.




soporte técnico.

FSIVSHAR-551 RECEIVED PS_HEADER - UNSUPPORTED.

Explicación: El campo de tipo del registro recibido indicó que era un PS_HEADER que se utiliza para servicios de punto

de sincronización. Estos tipos de registro no son compatibles y pueden indicar que el área de registro está dañada.




170

Messages and Codes

FSIVSHAR-552 PROTOCOL ERROR - INV LL IN RECEIVED DATA.

Explicación: El campo de longitud de dos bytes que precede a los datos recibidos se puede configurar hasta 32765.

Este valor incluye el campo de longitud, por lo que debe ser al menos 2. Además, el primer bit de la longitud está

reservado, por lo que uno de los siguientes valores no válidos se encontró: x'0000 ', x'0001', x'8000 'o x'8001'. Es

posible que los bytes de longitud estén dañados.




FSIVSHAR-553 NONZERO RETURN FROM PS_PROTOCOL_ERROR.



dañado.


















FSIVSHAR-556 NONZERO RETURN FROM PROCESS_FMH7_PROC.

Explicación: Este módulo recibió un FMH7 y se denominó módulo de procesamiento FMH7 para manejarlo. El

procesador FMH7 no se completó normalmente y puede haber generado más mensajes.


Respuesta del usuario: busque más mensajes para identificar el problema. Si el error persiste, comuníquese con el

soporte técnico.

FSIVSHAR-557 BAD RETURN PARM ADDR FROM PROCESS_FMH7.

Explicación: Se recibió una cabecera de gestión de función de tipo de error (FMH7) de la LU remota y fue procesada

por el módulo de procesamiento FMH7. La dirección de la lista de parámetros de retorno del procesador FMH7 no se

podía utilizar.


Respuesta del usuario: busque más mensajes que puedan identificar el origen del problema. Si el error persiste,


171

Messages and Codes

CICS Mensajes

FSIVSHAR-601 JOB <jobname> WAS CANCELLED BY OPERATOR <user-id> FROM TERMID <termid> <date/time>.

Explicación: El trabajo por lotes se canceló desde el sistema en línea a través de la pantalla de visualización del trabajo

activo. User-id es el campo de identificador de usuario de CICS que se asigna en el momento del inicio de sesión y

termid es el identificador de terminal de CICS.

Acción del sistema: Terminación anormal del trabajo por lotes.


FSIVSHAR-602 ON-LINE END-OF-SESSION <normal/abnormal> <date/time>.

Explicación: El TP por lotes indicó que la sesión debía finalizar, normalmente al finalizar el trabajo por lotes. <normal /

anormal> indica que el trabajo por lotes finalizaba normalmente o terminaba anormalmente. La terminación normal

incluye la confirmación de cambios desde el último punto de sincronización, pero la terminación anormal no.



FSIVSHAR-603 <user/auto><syncpoint/rollback><succeeded/failed> IN THE ON-LINE PARTNER <date/time>.

Explicación: La tarea en línea intentó un punto de sincronización o una reversión. Se inició de forma automática o por

solicitud del programa de aplicación. La solicitud se procesó correctamente o falló.

Acción del sistema: continúe a menos que haya fallado.


FSIVSHAR-604 ON-LINE FILE RESOURCES HELD LEVEL HAS REACHED <nnnnnnn>.

Explicación: Esta es una advertencia que indica que la tarea que se ejecuta en CICS está reteniendo posiblemente

recursos de archivo excesivos. Puede ocurrir si se han realizado muchas actualizaciones sin la ejecución de un punto

de sincronización, ya sea iniciado por el usuario o automático.


Respuesta del usuario: esta es solo una advertencia. Si la respuesta en línea se degrada, revise las opciones de punto

de sincronización para el trabajo y realice los ajustes necesarios.

FSIVSHAR-605 ON-LINE FILE RESOURCES FREED BY <user/auto> <syncpoint/rollback>.

Explicación: CICS contenía recursos de archivo excesivos. El cuello de botella se alivió mediante un punto de

sincronización o una reversión iniciada automáticamente o desde el programa de aplicación.



FSIVSHAR-606 SYNCPOINTS PERFORMED - USER: nnnn AUTO: nnnn ENQ FREED: nnnnn.

Explicación: Al finalizar el trabajo, VSHARE muestra el número de puntos de sincronización automáticos tomados, el

número de puntos de sincronización de usuario tomados y el número de puntos de sincronización tomados para

liberar elementos de puesta en cola no utilizados en CICS.



172

Messages and Codes

FSIVSHAR-607 USER ROLLBACK FOLLOWED AUTO SYNCPOINT, ROLLBACK IGNORED.

Explicación: El programa de aplicación solicitó un punto de sincronización de usuario inmediatamente después de una

reversión. Dado que no hay cambios para confirmar, la reversión se ignora.



FSIVSHAR-608 CURRENT CPU/LPAR ID is <xxxxx>.

Explicación: Este programa ha determinado la identidad de la CPU en la que se está ejecutando.



FSIVSHAR-610 FILE TYPE UNSUPPORTED, DDNAME= '<ddname>' FCT= '<fctname>', RETURN CODE = <xxxx>, ignored.

Explicación: El archivo identificado por el DDNAME del lote y el nombre de la entrada CICS FCT es un tipo que no se

admite en este momento.


Respuesta del usuario: compruebe la definición del archivo para asegurarse de que sea un tipo admitido. Si es así, es

posible que se haya producido una infracción de almacenamiento. Si el problema persiste, comuníquese con el


FSIVSHAR-615 CMS INITIALIZATION HAS BEEN STARTED <date/time>.

Explicación: El programa de inicialización de CICS CMS ha ejecutado la solicitud necesaria para iniciar el servicio de

memoria cruzada para VSHARE.



FSIVSHAR-616 CMS INITIALIZATION HAS BEEN COMPLETED <date/time>.

Explicación: El programa de inicialización de CICS CMS ha completado la solicitud necesaria para iniciar el servicio de

memoria cruzada para VSHARE.



FSIVSHAR-617 ABEND EXIT ENTERED WITH ERROR CODE '<abcode>'.

Explicación: El programa de inicialización de CICS CMS ha encontrado una condición anormal. Se ha introducido la

salida HANDLE ABEND. El "abcode" que se muestra es el fin anormal de CICS encontrado.

Acción del sistema: programa terminado.

Respuesta del usuario: determine a partir del código de finalización anormal qué causó el error. Corrija la condición

de falla y vuelva a ejecutar la transacción.

FSIVSHAR-618 SVC NUMBER FOR CMS INITIALIZATION IS INVALID PROCESSING TERMINATED.

Explicación: El programa de inicialización de CICS CMS ha encontrado una condición anormal. El número SVC conocido

por el sistema CICS no está definido en el sistema operativo.

Acción del sistema: programa terminado.

Respuesta del usuario: determine por qué los números de SVC no coinciden. Corrija la discrepancia y vuelva a ejecutar

la transacción.

173

Messages and Codes

FSIVSHAR-619 CMS INITIALIZATION REQUEST REFUSED BY OS, REASON: SEE MESSAGE ABOVE. PROCESSING TERMINATED.

Explicación: El programa de inicialización de CICS CMS ha encontrado una condición anormal. El sistema operativo

rechazó la solicitud de Cross Memory Services. El motivo del rechazo se explica en el mensaje que se muestra encima

de este en el SYSLOG.

Acción del sistema: el programa termina.

Respuesta del usuario: determine a partir del mensaje anterior qué causó el rechazo. Corrija la discrepancia y vuelva a

ejecutar la transacción.

FSIVSHAR-620 SYSTEM GETMAIN FOR '<function>' FAILED WITH RC='<xxxx>' PROCESSING TERMINATED.

Explicación: El programa de inicialización de CICS CMS ha encontrado una condición anormal. Una solicitud de

almacenamiento CICS ha fallado con un código de retorno de xxxx en la rutina "función".


Respuesta del usuario: determine por qué CICS rechazó la solicitud examinando el código de retorno. Corrija el

problema y vuelva a ejecutar la transacción.

FSIVSHAR-621 LOCATED DCB: <dcbname>.

Explicación: El programa de inicialización de CICS CMS ha localizado el bloque de control de datos para el archivo

"dcbname".



FSIVSHAR-622 WARNING -- UNSUCCESSFUL FREEMAIN FOR IRC.

Explicación: El programa de inicialización de CICS CMS ha encontrado una condición anormal. Se devolvió una solicitud

de almacenamiento gratuito con una condición de error.


Respuesta del usuario: solo mensaje informativo. El almacenamiento de CICS puede reducirse debido al error

FREEMAIN.

FSIVSHAR-623 <read><write> TO TEMPSTOR QUEUE <queuename> FAILED, PROCESSING TERMINATED.

Explicación: El programa de inicialización de CICS CMS ha encontrado una condición anormal. Ha fallado una solicitud

de lectura o escritura a la cola de almacenamiento temporal identificada.

Acción del sistema: el proceso termina.

Respuesta del Usuario: Determine a partir de los mensajes CICS asociados por qué puede haber fallado la lectura.

Corrija el problema y vuelva a ejecutar la transacción.

FSIVSHAR-624 LOAD FAILED FOR MODULE <modname>.

Explicación: El programa de inicialización de CICS CMS ha encontrado una condición anormal. Ha fallado la carga del

sistema operativo para el módulo "modname".


Respuesta del usuario: determine a partir de los mensajes de CICS asociados por qué puede haber fallado la carga. La

falla de carga no terminará el proceso hasta que se hayan intentado todas las cargas requeridas.

174

Messages and Codes

FSIVSHAR-625 LOAD OF ALL REQUIRED MODULES FAILED. PROCESSING TERMINATED.

Explicación: El programa de inicialización de CICS CMS ha encontrado una condición anormal. Las cargas del sistema

operativo para los módulos de memoria cruzada necesarios han fallado. El mensaje FSIVSHAR-624 habrá identificado

los módulos no cargados.

Acción del sistema: el procesamiento termina.

Respuesta del usuario: determine a partir de los mensajes de CICS asociados por qué puede haber fallado la carga.

Corrija la condición y vuelva a ejecutar la transacción.

FSIVSHAR-627 EXECUTION of GIVEN SVC FAILED, PROCESSING TERMINED.

Explicación: El programa de inicialización de CICS CMS ha encontrado una condición anormal. El SVC proporcionado

para los servicios de memoria cruzada no se ha ejecutado correctamente o ha devuelto condiciones anormales al

ejecutarse.


Respuesta del usuario: determine a partir del mensaje asociado por qué falló la ejecución de SVC. Corrija el problema

y vuelva a ejecutar la transacción.

FSIVSHAR-628 CMS INITIALIZATION ALREADY <accomplished/failed>.

Explicación: El programa de inicialización de CICS CMS ha encontrado una condición anormal. Se ha ejecutado otro

intento de iniciar los servicios CMS. Solo se permite una ejecución por inicialización de CICS.


Respuesta del usuario: si se logró la inicialización de CMS, continúe con las operaciones. Si la inicialización de CMS ha

fallado anteriormente, realice un ciclo de CICS o borre manualmente las colas de almacenamiento temporal retenidas.

FSIVSHAR-629 OPEN FOR DFHRPL FAILED WITH RC='<nnnn>' PROCESSING TERMINATED.

Explicación: El programa de inicialización de CICS CMS ha encontrado una condición anormal. Durante una solicitud

abierta para DDNAME DFHRPL, se detectó una falla.

Acción del sistema: el programa termina. Los módulos necesarios no se pueden cargar.

Respuesta del usuario: determine a partir de los mensajes asociados por qué falló el intento de apertura. Corrija el

problema y vuelva a ejecutar la transacción.

FSIVSHAR-630 CLOSE FOR DFHRPL FAILED WITH RC'=<nnnn>', PROCESSING TERMINATED.

Explicación: El programa de inicialización de CICS CMS ha encontrado una condición anormal. Durante una solicitud de

cierre del DDNAME DFHRPL se detectó una falla.


Respuesta del usuario: determine a partir de los mensajes asociados por qué falló el intento de apertura. Corrija el

problema y recicle CICS según sea necesario.

FSIVSHAR-640 INITIAL GETMAIN FAILED FOR <nnnn> BYTES REQUESTED.

Explicación: El programa de transacciones en línea ejecutó un CICS GETMAIN para un área de datos internos.


Respuesta del usuario: Si el número de bytes hexadecimales no es excesivo, consulte con el programador del sistema

CICS sobre la disponibilidad de almacenamiento en la región CICS. Si el problema persiste y la cantidad de

almacenamiento solicitada parece excesiva, comuníquese con el soporte técnico.

175

Messages and Codes

FSIVSHAR-641 UNKNOWN INTERNAL REQUEST CODE, <xxxxxx> WAS USED.

Explicación: Se desconoce un código de solicitud interno que se pasó del programa de transacciones por lotes al

programa de transacciones en línea.


Respuesta del usuario: Es posible que el almacenamiento se haya dañado en el lote o en línea. Verifique la solicitud

para ver si hay posibles violaciones de almacenamiento. Si el problema persiste, comuníquese con el soporte técnico

de CSI.

FSIVSHAR-642 REQUEST CODE <xxxxx> IS INVALID AT START OF SESSION.

Explicación: El código de solicitud interno <nnnn> pasado del programa de transacciones por lotes al programa de

transacciones en línea no es válido al comienzo de una sesión.


Respuesta del usuario: Es posible que el almacenamiento se haya dañado en el lote o en línea. Verifique la aplicación

para detectar posibles violaciones de almacenamiento y vuelva a ejecutarla. Si el problema persiste, comuníquese con

el soporte técnico de CSI.

FSIVSHAR-643 INVALID CHARACTERS RECEIVED IN DDNAME: <ddname>.

Explicación: El programa en línea recibió una solicitud del programa por lotes que no se pudo procesar porque el

DDNAME utilizado para identificar el conjunto de datos de destino contenía caracteres no válidos.





FSIVSHAR-644 LINK FAILED. PROGRAM NAME '<pgname>' IS INVALID.

Explicación: Se intentó establecer un vínculo con el programa indicado, pero el vínculo falló.


Respuesta del Usuario: Consulte las definiciones de CICS del programa para ver si está instalado correctamente en la

región CICS a la que se accede.

FSIVSHAR-645 ACKNOWLEDGEMENT MISSING FOR "READY-TO-SYNC" REQUEST.

Explicación: El programa en línea indicó que estaba listo para emitir un punto de sincronización, pero el programa por

lotes no confirmó que también estaba listo.





FSIVSHAR-646 MAX ON-LINE RESOURCES HELD LEVEL HAS BEEN REACHED. TASKID '<tasknr>' ABENDING.

Explicación: La transacción CICS por lotes detectó que VSHARE mantiene un nivel anormalmente alto de bloqueos de

registros.


Respuesta del usuario: si esto no se esperaba, considere la posibilidad de liberar recursos mediante sincronización.

Consulte el capítulo “Recuperación” en la página 18 para obtener más detalles. Esto es solo informativo para un

mecanismo de advertencia. Demasiados bloqueos ocupan almacenamiento CICS.

176

Messages and Codes

FSIVSHAR-647 END-SESSION REQUESTED MORE THAN ONCE. TRANSACTION <tranid> ABENDING.

Explicación: El programa en línea recibió dos solicitudes para finalizar la sesión del programa por lotes.





FSIVSHAR-648 CMS NOT AVAILABLE IN TARGET CICS REGION.

Explicación: Durante la inicialización del paso, el trabajo por lotes se definió para utilizar Cross Memory Services pero

después de conectarse a la región CICS, se encontró que CMS no estaba instalado en la región CICS.

Acción del sistema: terminar el trabajo de forma anómala.

Respuesta del usuario: inicialice CMS en la región CICS y vuelva a ejecutar el trabajo. Consulte la sección “Instalar la

interfaz de servicios de memoria cruzada” en la página 105.

FSIVSHAR-650 CMS RECEIVE EXIT TAKEN ON XXXX ABEND.

Explicación: Se llamó a la salida de recepción del gestor de servicios de memoria cruzada de CICS después de que se

emitió la terminación anómala XXXX.

Acción del sistema: muestra el mensaje y realiza el procesamiento de errores.

Respuesta del usuario: determine el motivo de la terminación anormal y realice el procedimiento de recuperación

antes de volver a ejecutar el trabajo.

FSIVSHAR-651 <tranid> <termid> <taskid> <connecting/disconnecting> JOB: <jobname> <jobnum> <step> <procstep> <errors??>.

Explicación: Este es el mensaje del registro de CICS que explica el inicio o la finalización de un trabajo por lotes de

VSHARE. El ID de transacción de CICS utilizado, el ID de terminal, la hora, el nombre del trabajo, el número de trabajo

JES y el nombre del paso se enumeran en el mensaje.


Respuesta del usuario: ninguna. Se trata de una pista de auditoría para determinar la actividad del lote durante el día

o las horas de inicio / finalización del trabajo.

FSIVSHAR-652 CICS REGION IS RUNNING ON CPU/LPAR ID(<CPUID>) USING LU62 CONNECTIVITY.

Explicación: El trabajo por lotes se definió para utilizar CMS, pero VSHARE determinó que el trabajo por lotes y la

región CICS se estaban ejecutando en una CPU o LPAR diferente. Se muestra el ID de CPU de CICS. Debido a esto,

VSHARE no puede usar CMS; por lo tanto, cambia automáticamente a LU 6.2.

Acción del sistema: cambie al modo LU 6.2.

Respuesta del usuario: Ninguna a menos que se suponga que el trabajo se ejecute en la misma CPU.

FSIVSHAR-653 CICS FUNCTION (<function ident>) FAILED WITH "<msg>" ERROR.

Explicación: Una función en línea de CICS identificada ha fallado con el código de retorno traducido a "msg".

Acción del sistema: el procesamiento continúa si la función no es crítica para la operación prevista. Se intentará la

recuperación del error. Si la falla es crítica, el procesamiento terminará con otros mensajes.

Respuesta del usuario: mensaje informativo. Supervise el registro CICS y SYSLOG en busca de mensajes posteriores

que afecten a la continuidad del proceso.

177

Messages and Codes

FSIVSHAR-654 JOB HISTORY RECORDING TO CONTROL FILE "<file>" FOR JOB <jobname>, JOBNUM J<jobnum>, FAILED.

Explicación: Ha fallado un intento de escribir el historial de trabajos en el archivo de control para el nombre y número

de trabajo dado.




FSIVSHAR-655 GDS SEND TO TRANSACTION PARTNER FAILED, RETURN CODES GIVEN WERE: '<nnnnn>'.

Explicación: La solicitud de envío de LU62 de CICS a la aplicación por lotes falló con los códigos de retorno "nnnn".

Acción del sistema: el programa continúa. Si durante la inicialización de CMS, se intentará cambiar a los servicios de

CMS. De lo contrario, la transacción esperará una recepción de la aplicación por lotes.

Respuesta del usuario: solo mensaje informativo. Esto puede ser una advertencia de condiciones anormales del

sistema que causarán una falla posterior y la terminación de la conexión.

FSIVSHAR-661 APPC FREE SESSION FAILED WITH RC='<nnnnn>'.

Explicación: La conexión en línea de CICS recibió un código de retorno anómalo de una solicitud LU62 para liberar la

sesión APPC.

Acción del sistema: el procesamiento termina con una terminación anormal para forzar la caída de la aplicación por

lotes.

Respuesta del usuario: determine a partir de mensajes relacionados por qué falló la solicitud de terminación de

sesión. Corrija el problema y reinicie la aplicación.

FSIVSHAR-662 INITIAL CAPTURE OF INITIATING PARTNER INFO FAILED RETURN CODE WAS: '<nnnnn>'.

Explicación: La conexión en línea de CICS recibió un código de retorno anómalo de una solicitud de información del

sistema CICS en la sesión LU62.

Acción del sistema: el procesamiento terminó en ausencia de la información requerida.

Respuesta del usuario: Determine a partir de mensajes relacionados por qué falló la solicitud de información del

sistema CICS. Corrija el problema y reinicie la aplicación.

FSIVSHAR-666 ERROR OCCURRED DURING STORAGE MANAGEMENT, RETURN CODE WAS <nnnn>.

Explicación: La conexión en línea de CICS recibió un código de retorno anómalo de una solicitud de almacenamiento

de CICS.

Acción del sistema: el procesamiento finaliza con señales suficientes para finalizar la aplicación por lotes.

Respuesta del usuario: Determine a partir de mensajes relacionados por qué falló la solicitud de almacenamiento

CICS. Corrija el problema y reinicie la aplicación.

FSIVSHAR-667 ROLLEDBACK CONDITION TRIPPED ON CURRENT SYNCPOINT. PROCESSING TERMINATED.

Explicación: La conexión en línea de CICS recibió un código de retorno anómalo de una solicitud de punto de

sincronización que indicaba que existía una condición de retrotracción.

Acción del sistema: el procesamiento termina con una terminación anómala 0C1.

Respuesta del usuario: determine a partir de mensajes relacionados qué otras condiciones pueden haber causado el

error. Corrija el problema y reinicie la aplicación.

178

Messages and Codes

FSIVSHAR-671 FILE ACCESS FOR DDNAME '<ddname>' FCTENTRY '<fctname>', RETURNED ERROR CONDITION '<nnnn>'.

Explicación: Un módulo de I/O en línea encontró una condición de error no recuperable de CICS. La condición de error

normalmente coincidirá con uno de los nombres de condición de identificador de CICS. El archivo para el que se

estaba realizando la I/O se identifica mediante el nombre de entrada DDNAME y CICS FCT del lote.


Respuesta del usuario: busque la condición de error en la Referencia del programador de CICS y actúe en

consecuencia. Consulte con el programador del sistema CICS para conocer los errores relacionados con el sistema (por

ejemplo, errores ISC, errores SYSID, etc.).

FSIVSHAR-672 KEY CHANGED ON DUPKEY REPOSITION REQUEST DD=<ddname> FCT=<fctname>.

Explicación: El módulo de I/I de KSDS en línea estaba procesando secuencialmente claves duplicadas en un índice

alternativo. El TP del lote solicitó reposicionamiento entre las claves duplicadas pero la clave de referencia fue

cambiada de la solicitud anterior. El archivo para el que se estaba realizando la I/O se identifica mediante el nombre

de entrada DDNAME y CICS FCT del lote.





FSIVSHAR-673 (<function ident>) FAILED ON CONN(<connection>), SESS (<session id>) WITH A "<msg>" ERROR.

Explicación: Una función de comunicaciones CICS, tal como se identificó, falló en la conexión y sesión identificadas. Si

se trata de ALLOCATE, SESS estará en blanco porque aún no se han establecido sesiones.

Acción del sistema: el procesamiento continúa. Se darán devoluciones de error a las funciones solicitantes que

signifiquen falta de capacidad de comunicación.


que afecten a la continuidad del proceso. Si se trata de un ALLOCATE que falla con un "SYSIDERR", la causa más

probable está en la región remota. La conexión de la región remota está o ha estado fuera de servicio. La conexión de

regiones remotas debe reinstalarse para volver a ponerla en servicio y restablecer su identidad VTAM.

FSIVSHAR-674 CONNECTION PROTOCOL DEFINED AS LU61 BUT ACCESS METHOD NOT IRC, VTAM OR XM.

Explicación: Una función de comunicaciones de CICS ha detectado un método de acceso no válido para un protocolo

de conexión determinado.





FSIVSHAR-675 CONNECTION (<id>) IS NOT IN SERVICE, NO SESSIONS CAN BE ALLOCATED.

Explicación: Ha fallado un intento de establecer una sesión en la conexión dada porque la conexión está fuera de

servicio.



Respuesta del usuario: mensaje informativo. Determine por qué la conexión está fuera de servicio, corrija la situación

y vuelva a ejecutar el trabajo.

179

Messages and Codes

FSIVSHAR-676 (<function ident>) FAILED ON CONN (<connection>), SESS (<session id>) WITH A "<msg>" ERROR.

Explicación: Una función de comunicaciones CICS, tal como se identificó, falló en la conexión y sesión identificadas. Si

se trata de ALLOCATE, SESS estará en blanco porque aún no se han establecido sesiones.




que afecten a la continuidad del proceso. Si se trata de un ALLOCATE que falla con un "SYSIDERR", la causa más

probable está en la región remota. La conexión de la región remota debe reinstalarse para volver a ponerla en servicio

y restablecer su identidad VTAM.

FSIVSHAR-693 VTAM-LU62 ERROR FOUND (CONV RESOURCE FAILED)

Explicación: VSHARE emitió un comando CICS GDS RECEIVE, ISSUE ERROR o ISSUE ABEND, pero CICS detectó un error

en el flujo de datos o la sesión recibidos. VSHARE informa del error que devolvió CICS.

Acción del sistema: el trabajo por lotes ABANDA.

Respuesta del usuario: como parte de la determinación del problema subyacente, busque el valor del código de

retorno (CDBERRCD) en el bloque IBM DFHCDBLK.

180

Messages and Codes

Mensajes de media sesión

FSIVSHAR-701 ILLEGAL RECORD TYPE WAS PASSED TO HS.

Explicación: El administrador de media sesión recibió un tipo de registro incorrecto.

Acción del sistema: el administrador de media sesión regresa al programa de llamada pasando un código de retorno

incorrecto.

Respuesta del usuario: posible daño del almacenamiento por parte del programa de aplicación. Verifique posibles

problemas con la aplicación. Si el problema persiste, comuníquese con su grupo de soporte técnico.

FSIVSHAR-702 ADDRESS IN RCB DOES NOT POINT TO A HS TO RM RECORD.

Explicación: Half Session Manager no encontró la dirección de un registro HS a RM en el RCB.

Acción del sistema: Half Session Manager vuelve al programa de llamada con un código de retorno incorrecto.


problemas con la aplicación. Si los problemas persisten, comuníquese con su grupo de soporte técnico.

FSIVSHAR-703 A RM TO HS RECORD WAS RECEIVED BUT THIS TYPE IS NOT SUPPORTED.

Explicación: Half Session Manager recibió un registro de Resource Manager, pero actualmente no es compatible con

Batch Logical Unit.


Respuesta del usuario: póngase en contacto con su grupo de soporte técnico.

FSIVSHAR-704 ILLEGAL RECORD CODE WAS PASSED TO HS.

Explicación: Half Session Manager recibió un registro con un código principal erróneo.



problemas con la aplicación. Si este problema persiste, comuníquese con su grupo de soporte técnico.

FSIVSHAR-705 ILLEGAL RECORD CODE WAS PASSED TO HS.

Explicación: Al intentar procesar un registro de Presentation Services, se encontró un código menor erróneo en el

registro.

Acción del sistema: Half Session Manager devuelve un código de retorno incorrecto a Presentation Services.


problemas con la aplicación. Si el problema persiste, comuníquese con su grupo de soporte técnico.

FSIVSHAR-706 STRAY SIGNAL RECEIVED. IGNORED.

Explicación: Half Session Manager recibió una señal parásita de la otra unidad lógica.

Acción del sistema: Half Session Manager regresa con un código de retorno incorrecto.

Respuesta del usuario: vuelva a intentar la operación. Si el mensaje persiste, comuníquese con su grupo de soporte

técnico.

FSIVSHAR-707 THE LENGTH OF THE LARGEST BUFFER IS ERRONEOUS. IT IS EQUAL TO ZERO.

Explicación: Half Session Manager encontró que la longitud del búfer más grande era cero.



181

Messages and Codes

FSIVSHAR-708 THE LENGTH OF THE LARGEST BUFFER IS ERRONEOUS. IT IS A NEGATIVE.

Explicación: Half Session Manager encontró que la longitud del búfer más grande era un número negativo.



FSIVSHAR-709 BAD SEND DATA RECORD TYPE WAS PASSED TO HALF SESSION.

Explicación: Half Session Manager estaba procesando un registro de envío de datos y encontró que el tipo era

desconocido.



problemas de aplicación. Si el mensaje persiste, comuníquese con su grupo de soporte técnico.

FSIVSHAR-710 CALL FSM_CHAIN_RCV_FMP19 CAUSED A STATE CHECK ERROR.

Explicación: Half Session Manager estaba intentando cambiar el estado de la máquina de estado finita de recepción y

recibió un error de estado.

Acción del sistema: el administrador de media sesión regresa con un código de retorno incorrecto.


FSIVSHAR-711 THE FSM #8 IS BAD. TRIED A VALID CHANGE, BUT RECEIVED ERROR.

Explicación: El administrador de media sesión estaba intentando cambiar el estado de la máquina de estado finito de

recepción en cadena y recibió una verificación de estado.



FSIVSHAR-712 TRIED TO CHANGE FSM #9 WITH BC BUT RECEIVED PROTOCOL ERROR.

Explicación: Half Session Manager estaba intentando cambiar el estado de la máquina de estado finito de envío en

cadena y recibió una verificación de estado.



FSIVSHAR-713 TRIED TO CHANGE FSM #9 WITH EC BUT RECEIVED PROTOCOL ERROR.

Explicación: Half Session Manager estaba intentando cambiar el estado de la máquina de estado finito de envío en

cadena con una entrada de cadena final y recibió una verificación de estado.



FSIVSHAR-714 TRIED TO CHANGE FSM #8 WITH A RESPONSE BUT RECEIVED FSM ERROR.

Explicación: Half Session Manager estaba intentando cambiar el estado de la máquina de estado finito de recepción

de cambios con una entrada de respuesta y recibió un código de retorno incorrecto.



182

Messages and Codes

FSIVSHAR-716 SEND FAILED. RC=XX FDBK2=XX IN SENSE=XXYYYY OUT SENSE=XXYYYY.

Explicación: Al emitir un envío VTAM, se recibió una mala respuesta de VTAM. El código de retorno, el código de

retroalimentación y los datos de detección se muestran en el mensaje.


Respuesta del usuario: determine el motivo del envío incorrecto buscando los códigos de retorno en el capítulo

Mensajes y códigos de VTAM. Si no comprende el problema, comuníquese con su grupo de soporte técnico.

FSIVSHAR-717 ERROR WITH ACB DURING A VTAM RECEIVE. ACB MAY NOT BE OPENED.

Explicación: Después de que se emitió una recepción VTAM, el error indicaba un problema con VTAM ACB.



FSIVSHAR-718 NON-ZERO SENSE CODE WAS RECEIVED. SENSE = XXXXXXXX.

Explicación: Después de la recepción, Half Session Manager notó un código de mal sentido recibido de la otra unidad

lógica o Half Session Manager encontró información errónea y emitió el código de mal sentido.



FSIVSHAR-719 RECEIVE FAILED RC=XX FDBK2=XX IN SENSE=XXYYYY OUT SENSE=XXYYYY.

Explicación: Half Session Manager recibió un error de VTAM después de emitir una recepción.

Acción del sistema: Half Session Manager regresa con un código de retorno incorrecto y devuelve la información de

detección.

Respuesta del usuario: determine el significado del mensaje consultando el capítulo Mensajes y códigos de VTAM. Si

encuentra problemas al cifrar el mensaje, comuníquese con su grupo de soporte técnico. Las ocurrencias más

comunes de este mensaje y sus causas son las siguientes:

RECEIVE FAILED RC=04 FDBK2=04 IN SENSE=460000

1) La transacción en segundo plano de VSHARE, TCCB, tiene definida la seguridad. Consulte la sección

“Definiciones de PCT” en la página 102 para obtener una explicación sobre esta transacción y seguridad.

2) La transacción en segundo plano de VSHARE, TCCB, está deshabilitada.

3) La transacción en segundo plano de VSHARE, TCCB, no está definida.

4) El programa VSHARE CSIVSC00 no está definido.

5) El programa VSHARE CSIVSC00 está desactivado. 6) La biblioteca de carga VSHARE CICS no está definida

en el RPL.

FSIVSHAR-720 STRAY RESPONSE WAS RECEIVED. IGNORED.

Explicación: La media sesión recibió una respuesta errónea de la otra unidad lógica.

Acción del sistema: Se ignoró el desvío y se emite otra recepción.


183

Messages and Codes

FSIVSHAR-721 RESPONSE PROTOCOL ERROR DETECTED. SESSION FREED.

Explicación: Half Session Manager estaba intentando actualizar la máquina finita y recibió un error de protocolo.


Respuesta del usuario: llame a su grupo de soporte técnico.

FSIVSHAR-722 FUNCTION MANAGEMENT HEADER #X WAS SENT TO THE LU. NOT SUPPORTED.

Explicación: Half Session recibió una cabecera de gestión de funciones de CICS que no es compatible con Batch LU.


Respuesta del usuario: esto no debería ocurrir. Contacte con su grupo de soporte técnico.

FSIVSHAR-723 TRIED TO DETERMINE TYPE OF RECORD RECEIVED BUT COULD NOT. FATAL.

Explicación: Half Session Manager recibió un registro de CICS que no pudo identificar.

Acción del sistema: Half Session Manager devuelve un código de retorno incorrecto.

Respuesta del usuario: esto no debería ocurrir. Contacte con su grupo de soporte técnico.

FSIVSHAR-724 STATE ERROR WHILE CHANGING FSM_CHAIN_RCV WITH BEGIN_CHAIN.

Explicación: Half Session Manager estaba intentando cambiar la cadena de recepción Finite State Machine con una

entrada Begin Chain y recibió un error de estado.



FSIVSHAR-725 STATE ERROR WHILE CHANGING FSM_CHAIN_RCV WITH END_CHAIN.

Explicación: Half Session Manager recibió un error de estado al intentar cambiar la máquina de estado finito de la

cadena de recepción con una entrada de End Chain.



184

Messages and Codes

Mensajes del administrador de recursos

FSIVSHAR-800 ILLEGAL RECORD TYPE WAS PASSED TO RM.

Explicación: Resource Manager recibió un tipo de registro no identificable.

Acción del sistema: Resource Manager regresa con un código de retorno incorrecto.

Respuesta del usuario: posible corrupción de almacenamiento. Verifique la aplicación por un posible error. Si el

problema persiste, llame al soporte técnico.

FSIVSHAR-801 ILLEGAL RECORD CODE WAS PASSED TO RM.

Explicación: mientras interrogaba un registro pasado, el administrador de recursos no pudo identificar el código de

registro.


Respuesta del usuario: posible corrupción de almacenamiento. Si el problema persiste, llame al soporte técnico.

FSIVSHAR-802 HS_IDS DO NOT MATCH. SCB = XXXXXXXX RM RECORD=XXXXXXXX.

Explicación: Resource Manager recibió una solicitud de Half Session Manager, pero se desconoce el ID del bloque de

control de sesión.


Respuesta del usuario: posible corrupción de almacenamiento. Si el problema persiste y no se han producido daños

en el almacenamiento, llame al soporte técnico.

FSIVSHAR-803 ILLEGAL RECORD CODE WAS PASSED TO RM.

Explicación: Resource Manager recibió un tipo de registro desconocido de Presentation Services.

Acción del sistema: Resource Manager devuelve un código de retorno incorrecto a Presentation Manager.



FSIVSHAR-804 DEALLOCATE FAILURE. BAD RCBID PASSED.

Explicación: Mientras procesaba una solicitud para desasignar una sesión, el administrador de recursos recibió una

identificación para un bloque de control de recursos desconocido.




FSIVSHAR-805 RCB IS ALREADY ALLOCATED.

Explicación: Mientras procesaba una solicitud de asignación, el administrador de recursos notó que el control de

recursos ya estaba en uso.

Acción del sistema: el administrador de recursos regresa con un código de retorno incorrecto.

Respuesta del usuario: esto no debería ocurrir. Póngase en contacto con el soporte técnico.

FSIVSHAR-806 SYNC LEVEL PASSED IN ALLOCATE RCB IS NOT SUPPORTED.

Explicación: Resource Manager recibió una solicitud para asignar una sesión con un nivel de sincronización no

admitido. La LU de Batch no admite ningún procesamiento de punto de sincronización.



185

Messages and Codes

FSIVSHAR-807 RCB_STATUS STATE ERROR WHILE CHANGING THE STATE WITH INPUT ALLOCATE_RCB.

Explicación: Al intentar cambiar el estado de la máquina de estados finitos # 4 con ALLOCATE_RCB como entrada, el

administrador de recursos recibió un error de estado.

Acción del sistema: el administrador de recursos deja de procesar la asignación y devuelve un código de retorno

incorrecto.


FSIVSHAR-808 SCB_STATUS STATE ERROR WHILE CHANGING THE STATE WITH INPUT GET_SESSION.

Explicación: Al intentar cambiar el estado de la máquina de estado finito n. ° 6 con GET_SESSION, el administrador de

recursos recibió un error de estado.

Acción del sistema: el administrador de recursos deja de procesar la asignación y devuelve un código de retorno

incorrecto.


FSIVSHAR-809 DEACTIVATE SESSION ID PASSED IS NOT THE SAME AS THE ID IN THE SCB.

Explicación: Al intentar desactivar una sesión para Presentation Service Manager, Resource Manager notó que la ID de

sesión transmitida no coincidía con la ID en el bloque de control de sesión.

Acción del sistema: el administrador de recursos detiene el proceso de desactivación y regresa con un código de

retorno incorrecto.

Respuesta del usuario: posible corrupción de almacenamiento. Si este problema persiste y no se produjo un daño en

el almacenamiento, comuníquese con el soporte técnico.

FSIVSHAR-810 ERROR WITH RECORD PASSED FROM LNS. EXPECTED 1,2 BUT RECEIVED X, X.

Explicación: Después de recibir el control del LU Network Service Manager, el Resource Manager recibió un tipo de

registro indicado por X, X; pero esperaba un tipo récord de 1,2.

Acción del sistema: Resource Manager deja de procesar la solicitud y regresa con un código de retorno incorrecto.


FSIVSHAR-811 SESSION ID PASSED FROM LNS DURING DEACTIVATION DOES NOT EQUAL SCB ID.

Explicación: Mientras procesaba una solicitud de desactivación del administrador de servicios de red de LU, el

administrador de recursos notó que no se conocía el ID del bloque de control de sesión pasado.


retorno incorrecto.


FSIVSHAR-812 RCB_IDS DO NOT MATCH IN RCB AND SCB. RCB=XXXXXXXX SCB=XXXXXXXX.

Explicación: mientras se procesaba una solicitud de desactivación, hubo una discrepancia entre el ID del bloque de

control de recursos ubicado en el RCB y el SCB.


retorno incorrecto.


186

Messages and Codes

FSIVSHAR-813 TRYING TO DEACTIVATE A SESSION THAT IS NOT IN_USE.

Explicación: Mientras procesaba una solicitud de desactivación, Resource Manager no pudo encontrar la sesión en la

tabla.



187

Messages and Codes

Mensajes de servicios de red LU 6.2

FSIVSHAR-900 UNKNOWN MAJOR RECORD TYPE WAS PASSED.

Explicación: LU Network Manager recibió un tipo de registro desconocido.

Acción del sistema: LU Network Manager regresa con un código de retorno incorrecto.

Respuesta del usuario: posible corrupción de almacenamiento por parte de la aplicación. Busque un posible error de

aplicación. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-902 UNKNOWN MINOR RECORD TYPE WAS PASSED.

Explicación: LU Network Manager recibió un registro con un código menor desconocido.


Respuesta del usuario: posible corrupción de almacenamiento por parte de la aplicación. Busque un posible error de

aplicación. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-903 THE DEACTIVATE CORRELATOR PASSED DOES NOT EQUAL VALUE IN LULUCB.

Explicación: LU Network Manager recibió una identificación de una sesión a desactivar que no es igual al valor

conocido por el Manager.



FSIVSHAR-904 CAN NOT DEACTIVATE BECAUSE FSM_STATUS DOES NOT INDICATE RIGHT STATE.

Explicación: LU Network Manager recibió una solicitud de desactivación, pero el estado de la sesión no era correcto.


Respuesta del usuario: póngase en contacto con el soporte técnico.

FSIVSHAR-905 MODE NAME PASSED IS UNKNOWN. PASSED NAME=XXXXXXXX, MODE=XXXXXXXX.

Explicación: Durante la activación de la sesión, LU Network Manager recibió un nombre de modalidad desconocido

para el definido en la LU de lote.


Respuesta del usuario: asegúrese de que el nombre del modo contenido en el archivo de control sea idéntico al de la

tabla de entrada del modo. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-906 PARTNER LU NAME PASSED IS UNKNOWN. PASSED=XXXXXXXX, LU NAME=XXXXXXXX.

Explicación: Durante la activación de una sesión, LU Network Manager recibió un nombre de una región CICS no

conocida por la LU de Batch.


Respuesta del usuario: asegúrese de que el APPLID de la región CICS esté ubicado correctamente en el archivo de

control. Si el problema persiste, comuníquese con el soporte técnico.

FSIVSHAR-907 THE VTAM ACB IS ALREADY OPEN.

Explicación: Al intentar abrir VTAM ACB, LU Network Manager encontró que ACB ya estaba abierto.



188

Messages and Codes

FSIVSHAR-908 ERROR CREATING THE VTAM EXIT LIST. ERROR = XXXX.

Explicación: Al intentar crear la lista de salida de VTAM, LU Network Manager recibió un código de error. XXXX es el

código de retorno de la macro GENCB.


Respuesta del usuario: posible problema de tamaño de la región. Aumente el tamaño de la región y vuelva a intentar

la operación. Si el problema persiste, comuníquese con el soporte técnico de CSI.

FSIVSHAR-909 ERROR CREATING THE VTAM ACB. ERROR = XXXX.

Explicación: Al intentar crear el VTAM ACB, LU Network Manager recibió un código de error. XXXX es el código de

retorno de la macro GENCB.



la operación. Si el problema persiste, llame al soporte técnico.

FSIVSHAR-910 ERROR CREATING THE VTAM NIB. ERROR = XXXX.

Explicación: Al intentar crear el VTAM NIB, LU Network Manager recibió un código de error. XXXX es el código de





FSIVSHAR-911 ERROR CREATING THE VTAM RPL. ERROR = XXXX.

Explicación: Al intentar crear el VTAM RPL, LU Network Manager recibió un código de error. XXXX es el código de





FSIVSHAR-912 THE OPENING OF THE VTAM ACB FAILED. REASON = XXYY.

Explicación: Al abrir ACB, LU Network Manager recibió el código de razón XXYY.


Respuesta del usuario: busque el código de motivo en la Guía del programador de VTAM y determine el motivo. Si el

problema persiste, llame al soporte técnico.

FSIVSHAR-913 VTAM FAILURE. RC=XX FDBK2=XX IN SENSE=XXXXYYYY OUT SENSE=XXXXYYYY.

Explicación: Al intentar conectarse a la región CICS, LU Network Manager recibió un código de retorno incorrecto. El

código de retorno, el código de retroalimentación y la información del código de detección se muestran en el

mensaje.


Respuesta del usuario: busque los códigos que se muestran en el capítulo Mensajes y códigos de VTAM y determine la

causa del error. Si el problema persiste, llame al soporte técnico.

Los casos más comunes de este mensaje y sus causas son los siguientes:

RC = 10 FDBK2 = 01 IN SENSE = 08570003

1) El CICS APPLID está inactivo.

2) El CICS ACB está cerrado en CICS.

3) La región CICS está inactiva.

189

Messages and Codes

RC=10 FDBK2=01 IN SENSE=087D000

1) El CICS APPLID no está definido para VTAM.

2) El CICS APPLID definido para un trabajo en la pantalla de mantenimiento es incorrecto.

RC=10 FDBK2=01 IN SENSE=08063426

1) La tabla de modalidad que contiene la entrada de modalidad no está disponible para CICS y el lote APPLID.

2) La entrada de modo definida para la sesión no es la misma que el nombre de modo definido para la región CICS en

el archivo de control VSHARE.

3) La seguridad externa ACF2 está activada para las sesiones y conexiones.

4) Los APPLID por lotes no tienen definiciones de conexión y sesión relacionadas en CICS.

5) Las conexiones en CICS se definieron como paralelas. Deben ser sesiones únicas.


1) Se definió que el lote APPLID no tiene la autoridad para adquirir una sesión. Especifique ACQ en la definición.

2) Los APPLID de lote no están definidos en RACF. Los APPLID por lotes deben definirse como usuarios.


1) ISC no se ha instalado en la región CICS.


1) La definición de la región CICS en la pantalla de mantenimiento del sistema VSHARE se definió con ACBNAME de la

definición CICS APPLID, no con la etiqueta NAME. Consulte la figura que explica la interrelación entre todas las

definiciones.

FSIVSHAR-914 THE CICS REGION XXXXXXXX WAS NOT AVAILABLE DURING ACTIVATION.

Explicación: Mientras realizaba la conexión a la región CICS denominada XXXXXXXX, LU Network Manager recibió un

código de detección que indica que la región no estaba disponible.


Respuesta del usuario: asegúrese de que la región CICS esté disponible y de que CICS ACB esté abierto.

FSIVSHAR-915 THE APPLID XXXXXXXX IS ALREADY IN USE.

Explicación: Al intentar abrir el APPLID por lotes, LU Network Manager recibió un mensaje de error que indica que

APPLID ya está siendo utilizado por otro programa.

Acción del sistema: LU Network Manager devuelve un código de retorno incorrecto y detiene el proceso de

activación.

Respuesta del usuario: Otro programa por lotes está utilizando APPLID. VSHARE permite múltiples definiciones

APPLID. Consulte el capítulo Instalación para obtener más detalles.

190

Messages and Codes

FSIVSHAR-916 THE APPLID XXXXXXXX IS NOT DEFINED TO VTAM. CHECK THE DEFINITION.

Explicación: El LU Network Manager recibió un APPLID para abrir que no está definido para VTAM.

Acción del sistema: LU Network Manager devuelve un código de retorno incorrecto y detiene el proceso de

activación.

Respuesta del usuario: consulte la sección “Definiciones de entorno” en la página 106 para obtener detalles sobre la

definición de APPLIDS.

FSIVSHAR-917 VTAM FAILURE. RC=XX FDBK2=XX IN SENSE=XXXXYYYY OUT SENSE=XXXXYYYY.

Explicación: al enviar un BIS a la región CICS, LU Network Manager recibió un código de retorno incorrecto de VTAM.

La información del error se encuentra en el mensaje.


Respuesta del usuario: busque el mensaje en el capítulo Mensajes y códigos de VTAM y determine la causa del

problema. Si el problema continúa, comuníquese con el soporte técnico.

FSIVSHAR-918 THE CICS REGION DID NOT SEND A BIS.

Explicación: Mientras esperaba que se enviara un BIS desde la región CICS durante la desactivación de la sesión, LU

Network Manager recibió otro comando.



FSIVSHAR-919 TPEND EXIT TAKEN, VTAM HALT MAY HAVE BEEN ISSUED.

Explicación: Se ingresó el enrutamiento de salida de VTAM mediante un error.

Acción del sistema: consulte otros mensajes.


FSIVSHAR-920 NSEXIT ROUTINE WAS ENTERED.

Explicación: LU Network Service Manager recibió una solicitud de servicios de red VTAM. Esto generalmente se

ingresa durante el proceso de limpieza después de la terminación de una sesión.

Acción del sistema: la información de detección se actualiza y los indicadores se establecen para informar al

administrador de media sesión que la sesión ha finalizado.

Respuesta del usuario: este mensaje debe acompañar a otros mensajes. Determine la causa de la interrupción de la

sesión mediante otros mensajes de red o mensajes escritos en el registro del sistema CICS.

FSIVSHAR-921 LOSTERM EXIT WAS EXECUTED WITH A REASONCODE = XX.

Explicación: Se ingresó la salida LOSTERM. Esto ocurre cuando la sesión se ha perdido por diversos motivos. El código

de motivo se muestra en el mensaje.

Acción del sistema: la información de detección se actualiza y los indicadores se establecen para informar al

administrador de media sesión que la sesión ha finalizado.

Respuesta del usuario: determine el motivo de la sesión perdida buscando el código de motivo en la Guía del

programador de VTAM. Otros mensajes que pueden ayudar se encontrarán en el registro del sistema o en el registro

del sistema CICS. Si el problema continúa, comuníquese con el soporte técnico.

FSIVSHAR-922 TPEND EXIT TAKEN.

Explicación: La salida de TPEND se activó como resultado de que un operador emitiera un comando VTAM HALT o

VARY NET, INACT.

Acción del sistema: la sesión finaliza de forma anormal y el sistema finaliza anormalmente con un usuario 900.

Respuesta del usuario: vuelva a ejecutar la operación y determine por qué el operador finalizó la sesión.

191

Messages and Codes

FSIVSHAR-9998 WARNING - PRODUCT AUTHORIZATION EXPIRES IN 30 DAYS OR LESS

Este mensaje se muestra si la copia de VSHARE que está utilizando está a punto de caducar. Póngase en

contacto con su representante de ventas de CSI International para obtener una nueva clave de producto.

FSIVSHAR-9999 PRODUCT AUTHORIZATION HAS EXPIRED

VSHARE está protegido con una clave de producto. Este mensaje se muestra si esa clave de producto ha

caducado. Póngase en contacto con su representante de ventas de CSI International para obtener una

nueva clave de producto.

192

Messages and Codes

Batch Abend Codes

U1000

Explicación: Este código de finalización anormal se emite cada vez que VSHARE detecta un error en el

módulo TCCBT001.

Acción del sistema: el trabajo finaliza con un código U1000.

Respuesta del usuario: compruebe el mensaje que acompaña al final anormal del U1000 y realice la

acción sugerida para el error en cuestión.

U2000

Explicación: Este código de finalización anormal se emite cada vez que se detecta un error después de la

activación de la sesión.

Acción del sistema: el trabajo finaliza con un código de U2000.



U3000

Explicación: Este código de finalización anormal se produce durante las llamadas de interfaz de punto de

sincronización / reversión o durante el procesamiento de CMS.

Acción del sistema: el trabajo finaliza anormalmente con un código de U3000.



U0999

Explicación: Este código de finalización anormal se emite durante el proceso de recuperación del diario.

Acción del sistema: el trabajo finaliza anormalmente con un código de U0999.

Respuesta del usuario: compruebe el mensaje que acompaña a la terminación anómala U0999 y realice la


193

Messages and Codes

Codigos CICS Abend

TC01

Explicación: La transacción de TCC por lotes encontró un error después de que se emitió una recepción.

Acción del sistema: Tarea de fin anormal con fin anormal TC01.

Respuesta del usuario: consulte el registro por lotes de VSHARE o el registro de CICS para determinar por qué falló la

recepción de VTAM o CMS. Módulo: CSIVSCOn

TC02

Explicación: La transacción de TCC por lotes encontró un error después de que se emitió un envío.


Respuesta del usuario: consulte el registro por lotes de VSHARE o el registro de CICS para determinar por qué falló el

envío de VTAM o CMS. Módulo: CSIVSCOn

TC03

Explicación: La transacción en línea de VSHARE recibió un comando de “señal”. Esto no es parte del protocolo TCC.


Respuesta del usuario: este es un error interno que no debería haber ocurrido. Póngase en contacto con el soporte

técnico de CSI. Módulo: CSIVSCOn

TC04

Explicación: La transacción de TCC en línea recibió dos recepciones consecutivas. Esto no es parte del protocolo de

comunicaciones TCC.


Respuesta del usuario: este es un error interno que no debería haber ocurrido. Póngase en contacto con el soporte


TC05

Explicación: La transacción en línea de TCC recibió una solicitud gratuita antes de que el trabajo por lotes enviara una

sesión de finalización.


Respuesta del usuario: consulte el registro por lotes para determinar si el trabajo por lotes finalizó. Si el problema

persiste, comuníquese con el soporte técnico de CSI. Módulo: CSIVSCOn

TC06

Explicación: Durante el procesamiento de CMS, la transacción de TCC en línea recibe un error durante una recepción.



recepción de CMS. Si el problema no se puede aislar, comuníquese con el soporte técnico. Módulo: CSIVSCOn

194

Messages and Codes

TC07

Explicación: La transacción en línea de TCC recibió una solicitud para utilizar LU 6.2 cuando la sesión de LU 6.2 ya

estaba liberada.


Respuesta del usuario: consulte el registro por lotes de VSHARE o el registro de CICS para determinar si la interfaz

CMS se activó correctamente. Si el problema no se puede aislar, comuníquese con el soporte técnico. Módulo:

CSIVSCOn

TC08

Explicación: Durante el procesamiento de CMS, las áreas de control de TCC se corrompieron.


Respuesta del usuario: Probablemente se ha producido una infracción de almacenamiento en la región CICS.

Determine la causa de la infracción. Si no se produjo una violación de almacenamiento, comuníquese con el soporte


TC09

Explicación: La transacción de TCC en línea encontró un error después de un resumen de CMS.



reanudación de VTAM o CMS. Módulo: CSIVSCOn

TC0A

Explicación: Después de capturar un AICA en la transacción en línea de TCC, la interfaz de CMS determinó que el

trabajo por lotes ya no se estaba ejecutando.

Acción del sistema: Tarea de fin anormal con fin anormal TC0A.

Respuesta del usuario: determine la causa de la finalización del trabajo por lotes. Se produjo una posible terminación

anormal del usuario. Si los mensajes indican que VSHARE tiene problemas, comuníquese con el soporte técnico de CSI.

Módulo: CSIVSCOn

TC10

Explicación: El administrador de la tabla TCC en línea encontró un error durante la validación abierta. Se encontró un

DSIDERR al abrir el conjunto de datos. Se debe haber detectado almacenamiento.


Respuesta del usuario: busque posibles infracciones de almacenamiento en CICS. Si no encuentra nada, comuníquese

con el soporte técnico. Módulo: CSIVSCOn

TC61

Explicación: mientras intentaba encontrar un conjunto de datos definido de forma remota, se emitió una solicitud

antes de que la transacción en línea de TCC enviara algo.


Respuesta del usuario: la transacción en línea de TCC finalizó o hubo un error en el enlace de ISC o MRO utilizado para

el acceso remoto a archivos. Consulte el registro de CICS para determinar qué ocurrió y reaccione según esos

mensajes de error. Módulo: CSIVSCOn

195

Messages and Codes

TC62

Explicación: El localizador de archivos remoto de TCC recibió dos recibos consecutivos de la transacción en

línea de TCC. Esto no forma parte del protocolo de comunicaciones.


Respuesta del usuario: error interno; comuníquese con el soporte técnico de CSI. Módulo: CSIVSCOn

196

vshare for z/os - csi international, inc

Documents