Personalización con programas sustituibles por el usuario

Un programa sustituible por el usuario es un programa proporcionado por CICS®que siempre se invoca en un punto determinado del proceso de CICS , como si formara parte del código CICS . Puede modificar el programa suministrado incluyendo su propia lógica, o reemplazarlo con una versión escrita por usted mismo.

Al crear sus propias versiones de programas sustituibles por el usuario, debe seguir esta guía:
  • Puede programar programas sustituibles por el usuario en cualquiera de los lenguajes compatibles con CICS (es decir, en lenguaje ensamblador, COBOL, PL/I o C). Se proporciona una versión en lenguaje ensamblador de la mayoría de los programas, en formato fuente, en la biblioteca CICSTS56. CICS.SDFHSAMP. COBOL, PL/I, o versiones C para algunos programas. La descripción de cada programa lista los programas de ejemplo, libros de copia y macros suministrados en cada caso.
  • Puede interrumpir una terminación anómala en un programa sustituible por el usuario haciendo que el programa emita un mandato EXEC CICS HANDLE ABEND . Sin embargo, si no se emite ningún HANDLE ABEND , CICS no termina de forma anómala la tarea, sino que devuelve el control al módulo CICS que ha llamado al programa. La acción realizada por el módulo CICS depende del programa sustituible por el usuario en cuestión.
  • Tras la devolución de cualquier programa sustituible por el usuario, CICS siempre debe recibir el control en modalidad de conversión de espacio primario, con el contenido original de todos los registros de acceso restaurados y con todos los registros de finalidad general restaurados (excepto los que proporcionan códigos de retorno o información de enlace).

    Para obtener información sobre los modos de traducción, consulte z/Architecture Principios de funcionamiento.

  • En z/OS®, no instale SVC o rutinas de PC que devuelvan el control a su interlocutor en cualquier modalidad autorizada: es decir, en estado de supervisor, clave PSW del sistema o APF autorizado. Hacerlo es contrario a z/OS Declaración de integridad. Si invoca estos servicios desde CICS, puede comprometer la integridad del sistema y el servicio de IBM® no resolverá los problemas resultantes.
  • Los programas sustituibles por el usuario, y cualquier programa invocado por programas sustituibles por el usuario, pueden ser RMODE ANY pero debe ser AMODE 31.
  • Debe asegurarse de que los programas sustituibles por el usuario estén definidos como locales. Los programas sustituibles por el usuario no se pueden ejecutar en una región remota. Esta regla se aplica a todos los programas sustituibles por el usuario, incluidos el programa de control de instalación automática y el programa de direccionamiento dinámico.
  • Los programas sustituibles por el usuario sólo producen volcados del sistema cuando se produce una comprobación de programa; no producen volcados de transacción.
  • Puede utilizar CICS Execution Diagnostic Facility (EDF) para probar programas sustituibles por el usuario. Sin embargo, EDF no funciona si la transacción inicial es una transacción proporcionada por CICS.