CICSPlex SM valores de los argumentos
Debe especificar los valores de los argumentos entre paréntesis que siguen a las opciones en un comando de la API CICSPlex® SM. En COBOL, C/C++, PL/I o Assembler, puede sustituir los valores de los argumentos de la API CICSPlex SM por diferentes tipos de datos.
CICSPlex SM valores de los argumentos
- valor-datos
- Un argumento de envío que se utiliza para pasar datos de su programa a CICSPlex SM.Los datos que se pasan pueden ser datos binarios de palabra completa, datos de caracteres de longitud fija o variable, o no especificados. Si no se especifica el tipo de datos, CICSPlex SM asume una estructura de datos compuesta formada por múltiples campos de distintos tipos de datos. El argumento puede adoptar una de estas formas:
- Nombre de variable
- Término autodefinido
- Expresión
- referencia de datos
- Un argumento de recepción (o envío y recepción) que se utiliza principalmente para pasar datos de CICSPlex SM a su programa.
El tipo de datos puede ser cualquiera de los tipos permitidos para los argumentos valor de datos. Sin embargo, el argumento debe ser una variable con nombre.
En algunos casos, puede utilizar un argumento data-ref para proporcionar datos de entrada a CICSPlex SM antes de que CICSPlex SM le devuelva su salida; por ejemplo, puede especificar un argumento data-ref en la opción COUNT del comando FETCH.
- área de datos
- Argumento de envío o recepción que se utiliza para identificar un búfer que contiene datos. Un argumento data-area puede considerarse un argumento data-ref con un tipo de datos no especificado. Un argumento área de datos no puede definirse mediante un término o expresión autodefinidos; debe ser una variable con nombre.
- ptr-ref
- Un argumento receptor que se utiliza para pasar valores de puntero de CICSPlex SM a su programa.
Un argumento ptr-ref es una forma especial de data-ref argumento. Los datos que se pasan son un puntero de dirección, en lugar de datos binarios o de caracteres.
- cpsm-token
- Un argumento de envío o recepción que se utiliza para pasar tokens de identificación que son generados por CICSPlex SM. Un argumento cpsm-token puede considerarse un argumento data-ref con un tipo de datos no especificado.
Los tokens son creados por CICSPlex SM para identificar hilos de procesamiento de la API, conjuntos de resultados, filtros y notificaciones.
Debido a que los valores de token son creados por CICSPlex SM, su programa debe recibir un token en una variable antes de que pueda especificar ese token en comandos posteriores. Un token no puede definirse mediante un término o expresión autodefinidos; debe ser una variable con nombre.
COBOL valores de los argumentos
En COBOL, puede sustituir los valores de los argumentos de la API CICSPlex SM por diferentes tipos de datos. El tipo de datos que puede utilizar depende del tipo de valor del argumento.
- valor-datos
- Puede sustituirse por cualquier nombre de dato de COBOL del tipo de dato correcto para el argumento, o por una constante que pueda convertirse al tipo correcto para el argumento. La tabla siguiente indica cómo definir el tipo de datos correcto:
Tipo de datos COBOL definición Media palabra binaria PIC S9(4) USO BINARIO Fullword binario PIC S9(8) USO BINARIO Doble palabra binaria PIC S9(18 ) COMP POINTER USO ES PUNTERO Cadena de caracteres PIC X(n) donde n es el número de bytes Cadena de caracteres UTF-8 PIC X(n) donde n es el número de bytes Decimal empaquetado PIC S9(n) COMP-3 donde n es el número de dígitos decimales data-value incluye data-ref como subconjunto.
- referencia de datos
- Puede sustituirse por cualquier nombre de dato de COBOL del tipo de dato correcto para el argumento. La tabla siguiente indica cómo definir el tipo de datos correcto:
Tipo de datos COBOL definición Media palabra binaria PIC S9(4) USO BINARIO Fullword binario PIC S9(8) USO BINARIO Doble palabra binaria PIC S9(18 ) COMP POINTER USO ES PUNTERO Cadena de caracteres PIC X(n) donde n es el número de bytes Cadena de caracteres UTF-8 PIC X(n) donde n es el número de bytes Decimal empaquetado PIC S9(n) COMP-3 donde n es el número de dígitos decimales Cuando el tipo de datos no está especificado, data-ref puede referirse a un elemento elemental o de grupo.
- área de datos
- Puede sustituirse por cualquier nombre de datos COBOL con un tipo de datos binario de media palabra (PIC S9(4 ) COMP), binario de palabra completa (PIC S9(8 ) COMP), o cadena de caracteres (PIC X (n )).
- ptr-ref
- Puede sustituirse por una variable puntero o un registro especial ADDRESS.
- cpsm-token
- Puede sustituirse por cualquier nombre de dato de COBOL con un tipo de dato binario de palabra completa (PIC S9(8 ) COMP).
Valores de los argumentos en C/C
En C/C++, puede sustituir los valores de los argumentos de la API CICSPlex SM por diferentes tipos de datos. Puede utilizar cualquier referencia de datos del tipo de datos correcto para un valor de datos, referencia de datos, o área de datos, siempre que la referencia sea a un almacenamiento contiguo.
- valor-datos
- Puede sustituirse por cualquier expresión C que pueda convertirse al tipo de datos correcto para el argumento. La tabla siguiente indica cómo definir el tipo de datos correcto:
Tipo de datos Definición C Media palabra binaria int corto Fullword binario int largo Doble palabra binaria entero largo largo Matriz de caracteres char[n] donde n es el número de bytes del campo (el campo debe rellenarse con espacios en blanco) Cadena de caracteres UTF-8 char[n] donde n es el número de bytes del campo (el campo se rellena con espacios en blanco ASCII) data-value incluye data-ref como subconjunto.
- referencia de datos
- Puede sustituirse por cualquier referencia de datos C que tenga el tipo de datos correcto para el argumento. La tabla siguiente indica cómo definir el tipo de datos correcto:
Tipo de datos Definición C Media palabra binaria int corto Fullword binario int largo Doble palabra binaria entero largo largo Matriz de caracteres char[n] donde n es el número de bytes del campo (el campo debe rellenarse con espacios en blanco) Cadena de caracteres UTF-8 char[n] donde n es el número de bytes del campo (el campo se rellena con espacios en blanco ASCII) Si el tipo de datos no se especifica, data-ref puede referirse a un tipo de datos escalar, matriz o estructura. La referencia debe ser a un almacenamiento contiguo.
- área de datos
- Puede sustituirse por cualquier variable con nombre cuyo tipo de datos sea binario de media palabra (int corto), binario de palabra completa (int largo) o matriz de caracteres (char[n]).
- ptr-ref
- Puede sustituirse por cualquier referencia de tipo puntero C.
- cpsm-token
- Puede sustituirse por cualquier variable con un tipo de datos binario de palabra completa (long int).
PL/I valores de los argumentos
En PL/I, puede sustituir los valores de los argumentos de la API CICSPlex SM por cualquier referencia de datos de PL/I del tipo de datos correcto, siempre que la referencia sea al almacenamiento conectado.
- valor-datos
- Puede sustituirse por cualquier expresión de PL/I que pueda convertirse al tipo de datos correcto para el argumento. La tabla siguiente indica cómo definir el tipo de datos correcto:data-value incluye data-ref como subconjunto.
Tipo de datos PL/I definición Media palabra binaria BIN FIJO(15) Fullword binario BIN FIJO(31) Doble palabra binaria BIN FIJO(63) POINTER POINTER Cadena de caracteres CHAR(n) donde n es el número de bytes Cadena de caracteres UTF-8 CHAR(n) donde n es el número de bytes Decimal empaquetado (n dígitos decimales) DEC (n,0) FIJO - referencia de datos
- Puede sustituirse por cualquier referencia de datos de PL/I que tenga el tipo de datos correcto para el argumento. La tabla siguiente indica cómo definir el tipo de datos correcto:
Tipo de datos PL/I definición Media palabra binaria BIN FIJO(15) Fullword binario BIN FIJO(31) Doble palabra binaria BIN FIJO(63) POINTER POINTER Cadena de caracteres CHAR(n) donde n es el número de bytes Cadena de caracteres UTF-8 CHAR(n) donde n es el número de bytes Decimal empaquetado (n dígitos decimales) DEC (n,0) FIJO Si el tipo de datos no se especifica, data-ref puede referirse a un elemento, matriz o estructura; por ejemplo, FROM(P->STRUCTURE) LENGTH(LNG). La referencia debe ser al almacenamiento conectado.
El área de datos también debe tener el atributo de alineación PL/I correcto: ALINEADO para elementos binarios, y DESALINEADO para cadenas.
Si utiliza una cadena de datos variable sin una longitud explícita, los datos pasados comienzan con campos de longitud de dos bytes, y su longitud es la longitud máxima declarada para la cadena. Si especifica explícitamente una longitud en el comando, los datos pasados tienen esta longitud; es decir, los campos de longitud de dos bytes seguidos de datos hasta la longitud especificada.
- área de datos
- Puede sustituirse por cualquier variable con nombre cuyo tipo de datos sea binario de media palabra (FIXED BIN(15)), binario de palabra completa (FIXED BIN(31)) o cadena de caracteres (CHAR(n)).
- ptr-ref
- Puede sustituirse por cualquier referencia PL/I de tipo POINTER ALINEADO.
- cpsm-token
- Puede sustituirse por cualquier variable con un tipo de datos binario de palabra completa (FIXED BIN(31)).
Valores de argumento de lenguaje ensamblador
En general, un argumento puede ser la dirección de los datos o los propios datos (en términos de lenguaje ensamblador, una expresión reubicable o una expresión absoluta).
Una expresión reubicable no debe contener corchetes no emparejados (fuera de las comillas) ni comillas no emparejadas (aparte de las referencias a atributos de longitud). Si se cumple esta regla, se puede utilizar cualquier expresión, incluidas constantes literales, como =AL2(100), formas como 20(0,R11) y formas que utilicen las facilidades de sustitución de macros.
Una expresión absoluta debe ser un único término que sea una referencia de atributo de longitud o una constante autodefinida.
Hay que tener cuidado con los símbolos igualados, que sólo deben utilizarse cuando se refieren a registros (referencias a punteros). Si se utiliza un símbolo igualado para una longitud, por ejemplo, se trata como la dirección de la longitud y se produce un error imprevisible.
- valor-datos
- Puede sustituirse por una expresión reubicable que sea una referencia en lenguaje ensamblador a datos del tipo correcto para el argumento, o por una constante del tipo correcto para el argumento.
- referencia de datos
- Puede sustituirse por una expresión reubicable que sea una referencia en lenguaje ensamblador a datos del tipo correcto para el argumento.
- área de datos
- Puede sustituirse por una expresión reubicable que sea una referencia en lenguaje ensamblador a datos con un tipo de media palabra (DS H), palabra completa (DS F) o cadena de caracteres (CLn).
- ptr-ref
- Puede sustituirse por cualquier expresión absoluta que sea una referencia en lenguaje ensamblador a un registro.
- cpsm-token
- Puede sustituirse por una expresión reubicable que sea una referencia en lenguaje ensamblador a datos con un tipo de palabra completa (DS F).