Propiedades de método

Utilice la página Propiedades del método para establecer las propiedades array, COBOL, design, host definition y recordset en el método .

Propiedades de matriz

Use	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: - Verdad - False (valor predeterminado)
Se produce en función de	Seleccione esta opción para indicar que un elemento de datos numérico que precede 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 las 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 al ú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

Use	Para hacer esto
Tipo de datos de host	Seleccione el tipo de datos de host.
Tratamiento de errores	Seleccione el control de errores de valor devuelto. Los valores posibles son: - Truncar. Seleccione esta opción para establecer TI para truncar el valor cuando se produce un error. (predeterminado). - Redondeo. Seleccione esta opción para establecer TI para redondear el valor cuando se produce un error. - Error. Seleccione esta opción para establecer TI para devolver un error cuando se produce un error.
Filler	Escriba el relleno de valores devueltos. El valor predeterminado es 0.
Desde 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 un espacio sin traducir en el búfer. FILLER no está visible en el lado 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 búferes que se envían al servidor. FILLER provoca un espacio sin traducir en el búfer. FILLER no está visible en el lado de automatización. El valor predeterminado es 0.
Escala	Escriba la escala de valores devueltos.
Atributo sign	Seleccione el atributo de signo de valor devuelto. Los valores posibles son: - Final. Para el tipo de datos DISPLAY firmado, indica que el signo es final (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 a cómo se convierten los datos del host a y desde el tipo de datos de Automation. - Separado final. Para el tipo de datos DISPLAY firmado, indica que el signo es independiente. 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 a cómo se convierten los datos del host a y desde el tipo de datos de Automation. - Líder. En el caso del tipo de datos DISPLAY firmado, indica que el signo está delante. 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 a cómo se convierten los datos del host a y desde el tipo de datos de Automation. - 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 los datos del juego de caracteres de doble byte comiencen con un desplazamiento (SO) y terminen con un carácter de desplazamiento (SI). Los valores posibles son: - True. Los caracteres SO e SI se quitan de los datos cuando se reciben de la aplicación host, y los caracteres SO e SI se agregan a los datos cuando se envían a la aplicación host. En la longitud de PIC G, no es necesario incluir los dos bytes para los caracteres SO e SI porque el entorno en tiempo de ejecución de TI los aplica. - False (valor predeterminado)
Delimitación de cadenas	Seleccione el delimitador de cadena de valor devuelto. Los valores posibles son: - Espacio acolchado. Indica al entorno en tiempo de ejecución de TI que la representación del sistema central de la cadena está delimitada 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 en tiempo de ejecución de TI que se conviertan las cadenas que se envían al sistema central para cambiar el carácter de terminación NULL de la cadena al número adecuado de espacios finales antes de enviarlos al sistema 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 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. (predeterminado). - Terminada en NULL. Indica al entorno en tiempo de ejecución de TI que la representación del sistema central de la cadena 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 indica al entorno en tiempo de ejecución de TI que se detenga en el primer carácter NULO detectado 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

Use	Para hacer esto
Permitir 32 000 bits entrantes y salientes	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: - Verdad - 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 el 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 ser un máximo de 250 caracteres Unicode.
Id. de 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 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 Una excepción no controlada del tipo "System.MissingMemberException" se produjo 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 de contexto de inclusión se incluye como un 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 del 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. Use 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 de 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: - (none). De forma predeterminada, no se envían datos especiales a la aplicación host ni se reciben desde ella. 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 diferenciar los datos de 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, consulte descripción de "Metadatos opcionales".
Nombre	Escriba el nombre del método. El nombre puede ser 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 devuelto de posición después	Escriba el valor devuelto del método automation que sigue al elemento de datos seleccionado cuando se recibe del host. Esta opción no afecta al lado de Automation. Use esta opción cuando el elemento de datos que desee especificar como valor devuelto de Automation no es el primer campo de elemento de datos de la declaración de datos que describe los datos recibidos del host.
Relleno preliminar	Vea el número de bytes de FILLER recibidos o enviados al host.
Desde host	Escriba el número de bytes de FILLER que sigue a este elemento de datos en los búferes recibidos del servidor. FILLER provoca un hueco sin traducir en el búfer. FILLER no está visible en el lado 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 un hueco sin traducir en el búfer. FILLER no está visible en el lado de automatización.
Tipo de valor devuelto	Seleccione el tipo de valor devuelto. Los valores posibles son: - Vacío - Booleana - Byte - Fecha - Moneda - Decimal - Entero - Largo - Doble - Soltero - Cadena - Tipo definido por el usuario - Recordset - (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 usa para definir una tabla de datos o un conjunto de registros como enlazados o como incluir todas las filas tal como se define como Número máximo establecido en el parámetro .
Desde host	- Verdad - False (valor predeterminado)
Para hospedar	- Verdad - False (valor predeterminado)

Propiedades de definición de host

Use	Para hacer esto
Nombre del vínculo al programa	Escriba el nombre del vínculo al programa (CICS LINK/DPL).
Id. de transacción reflejada	Escriba el TRANID reflejado 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 deben usarse. Los caracteres % y & pueden causar problemas con Resource Access Control Facility (RACF) si la seguridad de las transacciones está activa.
Nombre de TP	Escriba un nombre de 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 del 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 host (IMS o CICS) o el nombre del programa de vínculo a (CICS LINK/DPL).

Propiedades de conjunto de registros

Use	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: - Verdad - False (valor predeterminado) Esta propiedad es de solo lectura y siempre se establecerá en False a menos que se haya establecido en True en el momento en que se creó la biblioteca de tipos con la primera versión del Integrador de transacciones COM.
Repetición máxima	Número máximo de repeticiones 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 las tablas de longitud variable en COBOL. Indica que un elemento de datos numérico que precede 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 al último elemento de datos de la tabla, independientemente del tamaño máximo especificado para la tabla. En el caso de las 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).
Ilimitada	Indica que el conjunto de registros no está enlazado. Indica que se puede enviar o recibir cualquier número de filas del host. Esta opción se seleccionaría 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, esto significa que el número de elementos de la matriz varía. Cuando el último elemento de datos es un conjunto de registros, esto significa que el número de filas del conjunto de registros varía. (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 puede hacer que el componente funcione incorrectamente.

Consulte también

Personalización de TRM y ELM con COMTIContext
Nodo de nombre del método (.NET)
Propiedades (proyecto de TI)