Formato del comando EXEC CICS y consideraciones de programación

EXEC CICS Los comandos se utilizan en aplicaciones escritas en Assembler, C, COBOL o PL/I. El formato general de un comando EXEC CICS es EXECUTE CICS (o EXEC CICS) seguido del nombre del comando requerido, y posiblemente de una o más opciones.

Para ver los comandos equivalentes en aplicaciones Java, consulte JCICS API mapping to EXEC CICS API.

EXEC CICS formato de los mandatos

El formato del mandato es el siguiente:
EXEC CICS command option(arg)....
donde:
  • comando describe la operación requerida (por ejemplo, LEER).
  • opción describe cualquiera de las muchas facilidades opcionales disponibles con cada función. Algunas opciones van seguidas de un argumento entre paréntesis. Puede escribir opciones (incluidas las que requieren argumentos) en cualquier orden.
  • arg (abreviatura de argumento) es un valor como data-value o name. Un valor-dato puede ser una constante; esto significa que un argumento que envía datos a CICS® es generalmente un valor-dato. Un argumento que recibe datos de CICS debe ser un área de datos.

    Algunos argumentos descritos como área de datos pueden tanto enviar como recibir datos. En estos casos, debe asegurarse de que el área de datos no está en almacenamiento protegido.

Ejemplo de un comando EXEC CICS
EXEC CICS READ
          FILE('FILEA')
          INTO(FILEA)
          RIDFLD(KEYNUM)
          UPDATE
Debe añadir el delimitador de fin de comando apropiado al final de cada comando EXEC CICS, dependiendo del lenguaje de programación.
Tabla| 1. Delimitador de fin de orden por idioma
Idioma Delimitador de fin de orden
C/C++ Punto y coma (;)
COBOL Declaración END-EXEC
PL/I Punto y coma (;)
Restricción: En el lenguaje C, se puede utilizar un carácter nulo como marcador de fin de cadena, pero CICS no lo reconoce; por lo tanto, nunca debe tener una coma o un punto seguido de un espacio (X'40') en medio de una línea de codificación.

Comentarios del código de usuario

Si desea añadir comentarios contra comandos EXEC CICS, puede hacerlo, sólo en Assembler, utilizando un punto o una coma como delimitador después del último argumento.

Ejemplo
EXEC CICS ADDRESS EIB(MYUEIB),        @F1A

Si se utiliza un punto o una coma con un comando EXEC CICS, la línea siguiente debe comenzar entre la columna 2 y la columna 16, con el carácter de continuación en la columna 72. La línea siguiente no puede empezar después de la columna 17. Si no se añade ninguna coma o punto, la línea siguiente debe empezar en o después de la columna 2 y terminar por la columna 71, con el carácter de continuación en la columna 72.

Opciones comunes para todos los comandos EXEC CICS

NOHANDLE, RESP, y RESP2 son opciones comunes que se pueden añadir a todos los comandos EXEC CICS para procesar condiciones de error.

Puede utilizar la opción RESP con cualquier comando para comprobar si se ha planteado una condición durante su ejecución. Con algunos comandos, cuando una condición puede plantearse por más de un motivo, si ya ha especificado RESP, puede utilizar la opción RESP2 para determinar exactamente por qué se ha producido una condición. El uso de RESP implica NOHANDLE. Para obtener más información sobre los valores de RESP, consulte Campos del bloque de interfaz EXEC.

Puede utilizar la opción NOHANDLE con cualquier comando para especificar que no desea que se realice ninguna acción para cualquier condición o identificador de atención (AID) resultante de la ejecución de ese comando. Utilizar el lenguaje C o C++ implica NOHANDLE en todos los comandos.

Para saber cómo puede manejar condiciones de excepción utilizando la opción NOHANDLE o RESP en los comandos EXEC CICS, consulte Manejo de condiciones de excepción mediante código en línea.

SIN MANGO
No tomar ninguna acción para cualquier condición o AID resultante de la ejecución de un comando. Esta opción desactiva el CICS manejo de excepciones por defecto en una llamada de comando EXEC CICS específica.
Ejemplo
El siguiente ejemplo muestra un comando EXEC CICS que utiliza la opción NOHANDLE. El comando devuelve la dirección del CWA en R3, si tiene éxito.
EXEC CICS ADDRESS CWA(R3) NOHANDLE
PRAE (xxx )
Esta opción también desactiva el CICS manejo de excepciones por defecto del mismo modo que la opción NOHANDLE, pero actualiza un área de datos binarios de palabra completa definida por el usuario (xxx). A la vuelta del comando, contiene un valor que corresponde a la condición que podría plantearse, o a una vuelta normal, es decir, xxx=DFHRESP(NORMAL). Puede comprobar este valor mediante DFHRESP. Para obtener más información, consulte Manejo de condiciones de excepción mediante código en línea.

Debido a que el uso de RESP implica NOHANDLE, tenga cuidado cuando utilice RESP con el comando RECEIVE. NOHANDLE anula tanto el comando HANDLE AID como el comando HANDLE CONDITION, con el resultado de que se ignoran las respuestas de las teclas PF.

RESP2(aaaa)
yyy es un área de datos binarios de palabra completa definida por el usuario. A la vuelta del comando, contiene un valor que califica aún más la respuesta a ciertos comandos. A diferencia de los valores RESP, los valores RESP2 no tienen nombres simbólicos asociados y no existe una función incorporada en el traductor que se corresponda con DFHRESP, por lo que debe comprobar el propio valor binario de palabra completa.
Ejemplo
El siguiente ejemplo muestra una llamada a EXEC CICS en COBOL que utiliza las opciones RESP y RESP2 opciones.
EXEC CICS WRITEQ TS FROM(abc)
                    QUEUE(qname)
                    NOSUSPEND
                    RESP(xxx)
                    RESP2(yyy)
                    END-EXEC.

Las opciones NOHANDLE, RESP, y RESP2 no se incluyen explícitamente en los diagramas de sintaxis de los comandos individuales ni en las descripciones de las opciones.

EXEC CICS restricciones de comando

Algunas restricciones generales se aplican a todos los comandos EXEC CICS que acceden a datos de usuario.

  • El programa debe estar en modalidad de direccionamiento primario al invocar cualquier servicio CICS . El espacio de direcciones primario debe ser el espacio de direcciones inicial. Todos los parámetros pasados a CICS deben residir en el espacio de direcciones primario.
  • Si el programa utiliza registros de acceso, CICS sólo conserva los registros de acceso 2 a 13, porque el código CICS puede utilizar los registros de acceso 0, 1, 14 y 15 para las llamadas de macro z/OS® .

EXEC CICS notación de sintaxis de comandos

En la documentación de CICS, los comandos EXEC CICS se presentan de forma estándar. Interpreta la sintaxis siguiendo las flechas de izquierda a derecha. Para obtener una explicación de la convención de sintaxis utilizada en la documentación, consulte Convenciones y terminología utilizadas en la documentación de CICS.

No se incluye el EXEC CICS que siempre precede a la palabra clave de cada comando, ni ningún delimitador de fin de comando.