El programa de asignación dinámica: palabras clave y valores

Los valores se clasifican del siguiente modo:

Valor de palabra clave
Para algunas palabras clave deben especificarse valores. Por ejemplo, la palabra clave STATUS puede tener un valor SHR, NEW, MOD u OLD (que puede abreviarse).
Cadena de letras clave
El valor puede ser una cadena de letras en cualquier orden. El programa no comprueba que la combinación de letras proporcionada tenga sentido. Por ejemplo, para la palabra clave RECFM, el valor puede ser una cadena de letras de A, B, D, F, G, M, R, S, T, U y V.
Valores devueltos
El operador del terminal no debe proporcionar ningún valor, ya que esta palabra clave solicita un valor que debe ser devuelto por las funciones de recuperación de información DYNALLOC. La descripción adicional se refiere al tipo de valor que se devolverá. Suele estar en la forma en que lo introduciría el operador, aunque en unos pocos casos el valor es como una cadena hexadecimal.
No permitido
Algunas palabras clave no requieren un valor, y no debe proporcionarlo.
Necesario
Se debe proporcionar un valor si la palabra clave codificada está designada como que requiere un valor.
Opcional
La especificación de un valor es opcional para algunas palabras clave.
Único
Para algunas palabras clave sólo puede indicarse un valor.
Múltiple
Para algunas palabras clave, se permite más de un valor. (En algunos casos, DYNALLOC requiere más de un valor, aunque el programa de ejemplo de asignación dinámica no lo impone)
Cadena de caracteres
Se permite cualquier carácter en este tipo de valor, aunque en la mayoría de los casos habrá reglas adicionales a seguir, por ejemplo, para la palabra clave DSNAME.
Cadena numérica
Sólo se permiten caracteres numéricos para este tipo de valor, por ejemplo, para la palabra clave EXPDT.
Longitudes máximas y mínimas
Para los valores numéricos y de caracteres, el programa comprueba la longitud máxima y mínima del valor. Para una cadena de longitud fija, estos valores son los mismos. El valor se sigue pasando a DYNALLOC tal y como se especificó.
Convertible a binario de n bytes
Se requiere un valor numérico, de una magnitud que pueda representarse en binario en el número de bytes especificado. Los valores que superan el número de bytes especificado se truncan al máximo posible para el ancho.

El programa de ejemplo de asignación dinámica no admite números negativos. No comprueba las palabras clave del operando; los errores de este tipo normalmente hacen que DYNALLOC devuelva códigos de error de la forma 03xx.

Reglas de abreviatura de las palabras clave

Las palabras clave pueden abreviarse. Una palabra del comando coincide con una palabra clave si se cumple alguna de las siguientes condiciones:
  • La ortografía es la misma.
  • La primera letra es la misma, y el resto de letras de la palabra aparecen en el mismo orden que en la palabra clave.

Si se produce una ambigüedad, el programa la diagnostica y enumera las posibles palabras clave.

Consideraciones sobre la programación del sistema

La ortografía de las palabras clave se define en la tabla del programa, DFH99T, que se edita en enlace con el programa. En la medida de lo posible, son las mismas que las correspondientes palabras clave de control de trabajo o TSO. Los comentarios en el código fuente de DFH99T explican cómo el programador del sistema puede:
  • Cambiar la ortografía de las palabras clave
  • Definir una ortografía alternativa para las palabras clave
  • Dividir las funciones de un verbo en subconjuntos
  • Añadir nuevos verbos con función de subconjunto
  • Añada nuevos operandos a medida que estén disponibles en el SVC.

Donde vea nn, la nn indica la versión de CICS® y library es el nombre de la biblioteca. Por ejemplo, CICSTS63. CICS.SDFHLOAD.

Miembro DFH99BLD en CICSTSnn.CICS..SDFHINST es el flujo de trabajo utilizado para construir el programa. Si se ha modificado parte del programa, vuelva a montar esa parte y edite de nuevo el programa.

Las macros IEFZB4D0 (estructura de lista de parámetros DYNALLOC) e IEFZB4D2 (equiparación de claves simbólicas), proporcionadas por z/OS®, se utilizan en el programa de asignación dinámica y su tabla de palabras clave. El significado de cada palabra clave de la tabla se define en términos de un nombre simbólico, definido por una de las macros IEFZB4D0 o IEFZB4D2. Las definiciones de las palabras clave de los comandos que figuran en ese manual deben considerarse preferibles a las de cualquier otra fuente. Para obtener una lista de palabras clave de comandos y sus valores simbólicos, para utilizarla como referencia cruzada con el manual de z/OS, ensamble DFH99T con la opción SYSPARM(LIST), e imprima el código objeto resultante. Si se modifica la tabla, repita el montaje para obtener una nueva lista.