Propiedades del método

Use la página Propiedades del método para establecer las propiedades de matriz, COBOL, diseño, definición de host y conjunto de registros en el método .

Propiedades de un array

Usa esto	Para hacer esto
Dimensiones de matriz	Seleccione las dimensiones de matriz para el valor devuelto. El valor predeterminado es (none).
Es matriz	Seleccione si el valor devuelto es una matriz. Los valores posibles son: - True - False (valor predeterminado)
Se produce en función de	Seleccione esta opción para indicar que un elemento de datos numérico anterior a la tabla (conjunto de registros o matriz en Automation) indica el número real de filas o elementos que se envían o reciben. Equivalente a tablas de longitud variable en COBOL. Use la lista desplegable para seleccionar el elemento de datos numérico que especifica este valor. Para CICS Link, el conjunto de registros o la matriz y el especificador de longitud asociado deben estar dentro y fuera. Los datos del búfer que siguen a una tabla de longitud variable siguen inmediatamente el último elemento de datos de la tabla, independientemente del tamaño máximo especificado para la tabla. Las matrices con varias dimensiones solo se pueden usar para el bucle más externo (COBOL) o la dimensión situada más a la derecha (Microsoft® Visual C++ ® o Visual Basic). El valor predeterminado es (none).

Propiedades de COBOL

Usa esto	Para hacer esto
Tipo de datos de host	Seleccione el tipo de datos de host.
control de errores	Seleccione el control de errores de valor devuelto. Los valores posibles son: - Truncar. Seleccione esta opción para configurar TI para truncar el valor cuando se produzca un error. (valor predeterminado) - Redondeo. Seleccione esta opción para configurar TI de modo que redondee el valor cuando se produzca un error. - Error. Seleccione esta opción para configurar TI para que devuelva un error cuando se produzca un error.
Relleno	Escriba el relleno de valor devuelto. El valor predeterminado es 0.
Desde el host	Escriba el número de bytes de FILLER que sigue a este elemento de datos en los búferes que se reciben del servidor. FILLER genera un espacio no traducido en el búfer. FILLER no está visible en el área de automatización. El valor predeterminado es 0.
Para hospedar	Escriba el número de bytes de FILLER que sigue a este elemento de datos en los búferes que se envían al servidor. FILLER provoca una brecha no traducida en el búfer. FILLER no está visible en la sección de Automatización. El valor predeterminado es 0.
Escala	Escriba la escala del valor de retorno.
Atributo de Firma	Seleccione el atributo de signo del valor devuelto. Los valores posibles son: - Final. Para el tipo de datos DISPLAY con signo, indica que el signo es posterior (valor predeterminado). Esta opción indica al entorno en tiempo de ejecución de TI cómo se da formato a un tipo de datos DISPLAY firmado y afecta cómo se convierten los datos del host hacia y desde el tipo de datos Automation. - Separado final. Para el tipo de datos DISPLAY firmado, indica que el signo es independiente. Esta opción indica al entorno de ejecución en tiempo real de TI cómo se formatea un tipo de dato DISPLAY con signo y afecta a cómo se convierten los datos del host al tipo de dato Automation y viceversa. - Líder. En el caso del tipo de datos DISPLAY firmado, indica que el signo está a la vanguardia. Esta opción indica al entorno de ejecución en tiempo real de TI cómo se formatea un tipo de dato DISPLAY con signo y afecta a cómo se convierten los datos del host al tipo de dato Automation y viceversa. - Separado inicial. Para el tipo de datos DISPLAY firmado, indica que el signo es independiente.
Tamaño	Escriba el tamaño del valor devuelto.
SOSI	Seleccione esta opción para especificar si se espera que un conjunto de caracteres de doble byte comience con un carácter de salida de desplazamiento (SO) y termine con un carácter de entrada de desplazamiento (SI). Los valores posibles son: - True. Los caracteres SO y SI se quitan de los datos cuando se reciben de la aplicación host y los caracteres SO y SI se agregan a los datos cuando se envían a la aplicación host. En la longitud del PIC G, no es necesario incluir los dos bytes para los caracteres SO y SI porque el entorno de ejecución en tiempo real de TI los gestiona. - False (valor predeterminado)
Delimitación de cadenas	Seleccione la cadena de delimitación del valor de retorno. Los valores posibles son: - Relleno con espacios. Indica al entorno en tiempo de ejecución de TI que la representación del sistema central de la cadena se delimita rellenando la definición de cadena con caracteres de espacio. Por ejemplo, si la definición de COBOL del sistema central es PIC X(10), pero solo tres caracteres están en la cadena, el sistema central espera siete espacios finales. Por lo tanto, al seleccionar esta opción, se indica al entorno de ejecución de TI que modifique las cadenas que se envían al ordenador central, cambiando el carácter de terminación NULL de la cadena por el número adecuado de espacios finales antes de enviarlas al ordenador central. Por ejemplo, si la cadena se define en el sistema central como PIC X(10), TI enviará una cadena de ABC seguida de siete espacios finales. Al seleccionar esta opción también se indica al entorno en tiempo de ejecución de TI que se convierta la cadena de salida que se devuelve del sistema central al servidor de automatización de TI convirtiendo los espacios finales de la cadena en un único carácter de terminación NULL. Para obtener más información, consulte Relleno de cadenas de caracteres del sistema central con espacios. (valor predeterminado) - Terminado en nulo. Indica al entorno de ejecución de TI que la representación de la cadena en el mainframe está delimitada por un carácter nulo (EBCDIC 0x00). Al seleccionar esta opción, se indica al entorno en tiempo de ejecución de TI que agregue un único carácter NULL al final de una cadena si hay espacio para el byte antes de enviar una cadena al sistema central y le indica al entorno en tiempo de ejecución de TI que se detenga en el primer carácter NULL encontrado al recibir una cadena del sistema central. Por lo tanto, al seleccionar esta opción, se le indica a TI que conserve los espacios finales en las cadenas de salida procedentes del sistema central, ya que TI no convertirá los espacios finales en un único terminador NULL. Para obtener más información, consulte Relleno de cadenas de caracteres del sistema central con espacios.

Propiedades de diseño

Usa esto	Para hacer esto
Permitir 32K entrada/salida	Seleccione esta opción si desea que TI trate la entrada DFHCOMMAREA independientemente de la salida DFHCOMMAREA. TI normalmente combina la entrada DFHCOMMAREA y el área DFHCOMMAREA de salida. Las áreas combinadas no pueden superar los 32 KB de datos. Cuando se selecciona esta opción, TI trata la entrada DFHCOMMAREA independientemente de la salida DFHCOMMAREA. Cada área de entrada y salida usa hasta 32 KB de datos. Cambiar esta opción afecta al método seleccionado actualmente. Los valores posibles son: - True - False (valor predeterminado) Nota: Puede usar esta propiedad como accesorio para "Usar modelo de programación de vínculos" en el modelo de programación CICS de procesamiento iniciado por Windows (WIP) y en cualquier modelo de programación de procesamiento iniciado por host (HIP). Nota: Esta propiedad solo está disponible si la propiedad Is Link está establecida en True.
Descripción	Escriba una descripción del método . La descripción puede tener un máximo de 250 caracteres Unicode.
Identificador del Contexto de Ayuda	Escriba el identificador de contexto de ayuda asociado a este método. El identificador se usa para conectarse a la Ayuda de este método y se devuelve cuando se produce una excepción durante la invocación de este método. El valor predeterminado es 0.
Incluir parámetro de contexto	Seleccione si el método de objeto de cliente incluye automáticamente el contexto. Los valores posibles son: - True. Visual Basic .NET incluye automáticamente el contexto como un parámetro adicional en el argumento . Si no incluye el parámetro COMTIContext en la llamada al método junto con los demás parámetros, Visual Basic .NET devuelve el mensaje de error Excepción no controlada del tipo "System.MissingMemberException" en microsoft.visualbasic.dll e informa de que no se puede llamar al método con el número de parámetros que ha escrito. Si recibe este mensaje, compruebe que el parámetro Include Context está incluido como parámetro dentro de la lista de parámetros del método . - False. Visual Basic .NET no incluye automáticamente el contexto como parámetro adicional en el argumento . Si establece esta propiedad en False e incluye el parámetro COMTIContext en la llamada al método junto con los demás parámetros, Visual Basic .NET devuelve el mensaje de error Una excepción no controlada del tipo "System.MissingMemberException" se produjo en microsoft.visualbasic.dll y le informa de que no se puede llamar al método con el número de parámetros que ha escrito. Si recibe este mensaje, quite el parámetro COMTIContext de la lista de parámetros de método. El valor predeterminado es True.
Valor inicial del búfer	Escriba el valor inicial del búfer. El valor predeterminado es null.
Is Link	Seleccione si el método de objeto host usa el modelo de programación Link. Los valores posibles para el procesamiento iniciado por Windows (WIP) son: - True. Utilice el modelo de vínculo. El modelo de programación de vínculos solo se puede usar con protocolos de vínculo CICS. - False. No use el modelo de vínculo. El valor predeterminado es False. Los valores posibles para el procesamiento iniciado por el host (HIP) son: - Sí. Use el modelo de vínculo. El modelo de programación de vínculos se puede usar con todos los protocolos. - No. No use el modelo de vínculo. - Vínculo mediante 32K In/Out. Use el modelo de vínculo y establezca las propiedades From Host y To Host. El valor predeterminado es No.
Metadatos	Seleccione cómo se controlan los metadatos. Los valores posibles son: - (ninguno). De forma predeterminada, no se envía ni recibe ningún dato especial a la aplicación host. Seleccione este botón de opción si solo desea enviar y recibir los datos del método . - Incluir información del método. Nombre de este método que se va a enviar al host junto con los datos de parámetros. El nombre del método se envía como los primeros 32 bytes en el búfer. Esta opción es útil si varias llamadas de método van a la misma transacción y desea distinguir los datos entre las diferentes llamadas. - Incluya toda la información. Todos los metadatos disponibles para enviarse y recibirse con los datos del método. Para obtener más información sobre el formato de los metadatos, vea description for "Optional Metadata" (Metadatos opcionales).
Nombre	Escriba el nombre del método. El nombre puede tener un máximo de 250 caracteres Unicode. El nombre debe ser diferente de cualquier otro nombre de método en el mismo proyecto. El valor predeterminado es NULL.
Valor de retorno de posición después	Escriba el valor devuelto del método Automation que corresponde al elemento de datos seleccionado cuando se recibe del host. Esta opción no afecta al lado de automación. Utilice esta opción cuando el elemento de datos que desea especificar como valor devuelto de la Automatización no sea el primer campo de elemento de datos en la declaración de datos que describe los datos recibidos del anfitrión.
Relleno preliminar	Vea el número de bytes de FILLER recibidos o enviados al host.
Desde el host	Escriba el número de bytes de FILLER que sigue a este elemento de datos en los búferes que se reciben del servidor. FILLER provoca una brecha no traducida en el búfer. FILLER no está visible en la sección de Automatización.
Para hospedar	Escriba el número de bytes de FILLER que sigue a este elemento de datos en los búferes que se envían al servidor. FILLER provoca una brecha no traducida en el búfer. FILLER no está visible en la sección de Automatización.
Tipo de retorno	Seleccione el tipo de valor devuelto. Los valores posibles son: - Vacío - Boolean - Byte - Fecha - Moneda - Decimal - Entero - Long - Double - Soltero - Cuerda - Tipo definido por el usuario - Conjunto de registros - (none) ( valor predeterminado)
Campo final de tamaño variable	- Seleccione esta opción cuando el último elemento de datos sea una cadena para indicar que el tamaño de la cadena varía. Esta opción también se utiliza para definir si una tabla de datos o un conjunto de registros está limitado o incluye todas las filas según lo definido en la Ocurrencia máxima establecida en el parámetro.
Desde el host	- True - False (valor predeterminado)
Para hospedar	- True - False (valor predeterminado)

Propiedades de definición de host

Usa esto	Para hacer esto
Nombre del vínculo al programa	Escriba el nombre del vínculo al programa (CICS LINK/DPL).
Identificador de transacción reflejada	Escriba el TRANID reflejado al que usa este método, si desea invalidar el TRANID reflejado para el entorno remoto (RE) al que está asociado este componente. Dejar este cuadro en blanco hace que se use el TRANID reflejado en la descripción del entorno remoto. El TRANID puede tener hasta cuatro caracteres de longitud. Los caracteres aceptables son A-Z a-z 0-9 $ @ # . / _ % & ? ! : | = , ; <>. Los nombres de transacción que comienzan por C están reservados para CICS y no se deben usar. Los caracteres % y & pueden causar problemas con Resource Access Control Facility (RACF) si está activa la seguridad de las transacciones.
Nombre de TP	Escriba un nombre del programa de transacciones de origen (TP) cuando el programa de aplicación CICS tenga acceso a una base de datos DB2. Se hace referencia al nombre de TP en una entrada de tabla de control de recursos (RCT) de CICS, que asocia transacciones CICS con planes DB2. Especifica el nombre del programa de transacciones del host (IMS o CICS) o el nombre del programa para vincular (CICS LINK/DPL).

Propiedades del conjunto de registros

Usa esto	Para hacer esto
Incluir tamaño real	El programa host no incluirá ni esperará ninguna información que indique el número real de filas (conjuntos de registros) o elementos (matrices) que se envían o reciben. Los valores posibles son: - True - False (valor predeterminado) Esta propiedad es de solo lectura y siempre se establecerá en False a menos que se establezca en True en el momento en que se creó la biblioteca de tipos con la primera versión del Integrador de transacciones COM.
Número máximo de repeticiones	Ocurrencia máxima de fila. Indica el número máximo de filas que se van a enviar o recibir del host. Equivalente a la palabra clave OCCURS n TIMES en un elemento de grupo COBOL. El valor predeterminado es 1.
Se produce en función de	Equivalente a tablas de longitud variable en COBOL. Indica que un elemento de datos numérico anterior a la tabla (conjunto de registros o matriz en Automation) indica el número real de filas o elementos que se envían o reciben. Use la lista desplegable para seleccionar qué elemento de datos numérico especifica este valor. Para CICS Link, el conjunto de registros o la matriz y el especificador de longitud asociado deben estar dentro y fuera. Los datos del búfer que siguen a una tabla de longitud variable siguen inmediatamente el último elemento de datos de la tabla, independientemente del tamaño máximo especificado para la tabla. Para matrices con varias dimensiones, solo se puede usar para el bucle más externo (COBOL) o la dimensión situada más a la derecha (Visual C++ o Visual Basic). El conjunto de registros de valor devuelto se produce en función de . El valor predeterminado es (none).
Sin límites	Indica que el conjunto de registros no está enlazado. Indica que se puede enviar o recibir cualquier número de filas desde el host. Seleccionaría esta opción cuando las filas que se envían o reciben proceden de una base de datos y no se conoce el número máximo de filas. Los valores posibles son: - True. Cuando el último elemento de datos es una cadena, esto significa que el tamaño de la cadena varía. - False. Cuando el último elemento de datos es una matriz, significa que el número de elementos de la matriz varía. Cuando el último elemento de datos es un conjunto de registros, significa que el número de filas del conjunto de registros varía. (valor predeterminado)

Precaución

Las propiedades de un componente no están diseñadas para establecerse ni cambiarse mediante programación. Establecer o cambiar las propiedades mediante programación podría hacer que el componente funcione incorrectamente.

Véase también

TRMs personalizados y ELMs con COMTIContext
Nodo de nombre de método (.NET)
Propiedades (proyecto de TI)