Saltar a contenido

Objetos de Macro API

Puede crear macros utilizando la Macro API. De forma predeterminada para el uso en macros, se dispone de cuatro objetos primarios:

  • Session: el punto de entrada principal para acceder al host. El objeto Session se utiliza para conectar, desconectar y proveer acceso al objeto PresentationSpace.

  • PresentationSpace: representa la pantalla y proporciona muchas funciones comunes, como obtener y ajustar la ubicación del cursor, enviar datos al host y leer de la pantalla. Se obtiene llamando session.getPresentationSpace().

  • Wait: facilita una forma sencilla de esperar a que se produzcan varios estados del host antes de seguir enviando más datos o leer de la pantalla. Por ejemplo, puede esperar a que el cursor esté situado en una posición determinada, a que haya texto presente en una posición de la pantalla o simplemente esperar una cantidad de tiempo fija. Todas las llamadas de la función ‘Wait' requieren la palabra clave yield, que se explica más adelante.

  • Interfaz de usuario:: disponible automáticamente en la macro como la variable "ui". Provee capacidades básicas de interfaz de usuario. Puede utilizar este objeto para mostrar datos al usuario o para indicarlos a modo de información. Todas las llamadas de la función "UI" requieren la palabra clave "yield".

Todos los objetos disponibles

Consulte la lista de objetos disponibles en el panel de navegación derecho, "En esta página". (Es posible que deba expandir el navegador).


Attribute

Utilice el objeto Attribute, junto con el objeto AttributeSet, para descifrar la información de formato presente en la celda de datos.

Attribute Indica...
PROTECTED Una celda de datos protegida.
MODIFIED Una celda de datos modificada.
NUMERIC_ONLY El inicio de una celda de datos solo de caracteres numéricos.
ALPHA_NUMERIC Una celda de datos alfanuméricos.
HIGH_INTENSITY Si la celda de datos contiene texto de alta intensidad.
HIDDEN Si la celda de datos contiene texto oculto.
PEN_DETECTABLE Si la celda de datos es detectable por lápiz.
ALPHA_ONLY Una celda solo de datos alfabéticos.
NUMERIC_SHIFT El inicio de un campo numérico mayúscula.
NUMERIC_SPECIAL Que la celda de datos marca el inicio de un campo numérico especial.
KATAKANA_SHIFT Una sección de texto Katakana.
MAGNETIC_STRIPE Que la celda de datos marca el inicio de un campo de banda magnética.
SIGNED_NUMERIC_ONLY Que la celda de datos es un campo numérico firmado.
TRANSMIT_ONLY Que la celda de datos es un campo solo de transmisión.
FIELD_END_MARKER Que la celda de datos marca el final de un campo modificado.
FIELD_START_MARKER Que la celda de datos marca el inicio de un campo modificado.
SPECIAL_EMPHASIS_PROTECTED Un campo protegido de énfasis especial.
TAB_STOP Que la celda de datos contiene una posición de tabulación.
REVERSE Que la celda de datos se visualiza en modo de vídeo inverso.
BLINKING Que la celda de datos contiene texto intermitente.
RIGHT_JUSTIFIED Que la celda de datos marca el inicio de un campo justificado a la derecha.
LEFT_JUSTIFIED Que la celda de datos marca el inicio de un campo justificado a la izquierda.
LOW_INTENSITY Que la celda de datos contiene texto de baja intensidad.
UNDERLINE Que la celda de datos contiene texto subrayado.
DOUBLE_BYTE Que la celda de datos contiene texto de doble byte.
COLUMN_SEPARATOR Que la celda de datos contiene un separador de columnas.
BOLD Que la celda de datos contiene texto en negrita.
DOUBLE_WIDTH Que la celda de datos marca un campo de anchura doble.
DOUBLE_HEIGHT_TOP Una celda de datos superior de altura doble.
DOUBLE_HEIGHT_BOTTOM Una celda de datos inferior de altura doble.
CONTROL_PAGE_DATA Que la celda de datos contiene datos de página de control.
RIGHT_COLUMN_SEPARATOR Que la celda de datos contiene un separador de columnas derecho.
LEFT_COLUMN_SEPARATOR Que la celda de datos contiene un separador de columnas izquierdo.
UPPERSCORE Que la celda de datos contiene sobrerrayado.
STRIKE_THROUGH Que la celda de datos contiene texto tachado.

AttributeSet

El objeto AttributeSet permite al usuario descifrar los atributos presentes en la celda de datos. El objeto AttributeSet devuelve valores definidos en el objeto Attribute y cuando se utilizan juntos se puede obtener información de formato de la celda de datos.

Método Descripción
contains(attribute) Determina si el conjunto contiene el atributo especificado.
Parámetros
{Number} Atributo que se comprobará.
Devuelve
{Boolean} "True" (verdadero) si el atributo se encuentra en el conjunto.
isEmpty() Determina si el conjunto de atributos está vacío.
Devuelve
{Boolean} "True" si el conjunto está vacío.
size() Indica el número de atributos en un conjunto.
Devuelve
{Number} El número de atributos.
toArray() Convierte el conjunto de atributos interno en una matriz.
Devuelve
{Number[]} Matriz de valores de atributos en el conjunto.
toString() Convierte el conjunto de atributos interno en una cadena.
Devuelve
{String} Nombres de atributos con espacio delimitado en el conjunto.
forEach(callback, thisArg) Función para iterar sobre cada elemento en el conjunto de atributos.
Parámetros
{forEachCallback} Devolución de llamada para realizar la operación específica. Se llama con el nombre de cada atributo en el conjunto.
{Object} thisArg Puntero opcional a un objeto de contexto.
forEachCallback(string, object) Un usuario ha provisto la función callback donde usted provee el comportamiento de ser utilizado como el parámetro callback para forEach.
Parámetros
{String} Nombre de cadena de un atributo en el conjunto de atributos.
{Object} thisArg Puntero opcional a un objeto de contexto.

AutoSignOn

Método Descripción
getPassTicket() Obtiene un ticket de paso que se utiliza para iniciar sesión en una aplicación de mainframe. Se pueden solicitar múltiples tickets de paso utilizando distintos IDs de aplicación.
Parámetros
{String} El ID de aplicación indica al host la aplicación para la que es la entrada.
Devuelve
{Promise} Se cumple con la clave de ticket de paso o se rechaza si la operación falla. El ticket de paso obtenido del DCAS funciona sólo con la sesión de host actual y es válido durante diez minutos.
sendUserName() Aplica el nombre de usuario incluido en el ticket de paso al campo en la posición actual del cursor en la pantalla de host actual. El nombre de usuario se debe enviar antes que la contraseña. Si se envía la contraseña primero, el ticket de paso quedará invalidado y usted tendrá que obtener otro.
Parámetros
{String} passTicketKey obtenida del getPassTicket.
Devuelve
{Promise} Se cumple si se envía correctamente el nombre de usuario. Rechazado si la operación falla.
sendPassword() Aplica la contraseña incluida en el ticket de paso al campo en la posición actual del cursor en la pantalla de host actual. El nombre de usuario se debe enviar antes que la contraseña. Si se envía la contraseña primero, el ticket de paso quedará invalidado y usted tendrá que obtener otro.
Parámetros
{String} passTicketKey obtenida de getPassTicket.
Devuelve
{Promise} Se cumple si se envía correctamente la contraseña. Rechazado si la operación falla.

Color

Constantes de color a utilizar para los colores de primer plano y de fondo del objeto DataCell.

Color Descripción Valor Numérico
BLANK_UNSPECIFIED Ningún color especificado 0
BLUE Azul 1
GREEN Verde 2
CYAN Cian 3
RED Rojo 4
MAGENTA Magenta 5
YELLOW Amarillo 6
WHITE_NORMAL_INTENSITY Blanco de intensidad normal 7
GRAY Gris 8
LIGHT_BLUE Azul claro 9
LIGHT_GREEN Verde claro 10
LIGHT_CYAN Cian claro 11
LIGHT_RED Rojo claro 12
LIGHT_MAGENTA Magenta claro 13
BLACK Negro 14
WHITE_HIGH_INTENSITY Blanco de alta intensidad 15
BROWN Marrón 16
PINK Rosa 17
TURQUOISE Turquesa 18

ControlKey

El objeto ControlKey define constantes para enviar teclas de control de cursor y comandos de host utilizando el método sendKeys. Las constantes están disponibles para estos tipos de host:


IBM 3270

Palabra clave Descripción
ALTVIEW Alternar vista
ATTN Atención
BACKSPACE Retroceso
BACKTAB TabAtrás
CLEAR Borrar o Borrar pantalla
CURSOR_SELECT Selección de cursor
DELETE_CHAR Eliminar o Eliminar carácter
DELETE_WORD Borrar palabra
DEST_BACK Borrar al utilizar Retroceso
DEV_CANCEL Cancelar dispositivo
DOWN Cursor abajo
DSPSOSI Mostrar SO/SI
DUP Campo duplicado
END_FILE Final de campo
INTRO Intro
ERASE_EOF Eliminar final de campo
ERASE_FIELD Eliminar campo
ERASE_INPUT Eliminar entrada
FIELD_MARK Marca de campo
HOME Inicio de cursor
IDENT Ident
INSERT Insertar
LEFT_ARROW Cursor izquierda
LEFT2 Dos posiciones a la izquierda
NEW_LINE Nueva línea
PA1 - PA3 PA1 - PA3
PF1 - PF24 PF1 - PF24
PAGE_DOWN Avance página
PAGE_UP Retroceso página
RESET Reset, reset terminal
RIGHT2 2 posiciones a la derecha
RIGHT_ARROW Cursor derecha, derecha
SYSTEM_REQUEST Solicitud de sistema
TAB Tecla tabulación
UP Cursor arriba

IBM 5250

Palabra clave Descripción
ALTVIEW Alternar vista
ATTN Atención
AU1 - AU16 AU1 - AU16
BACKSPACE Retroceso
BACKTAB TabAtrás
BEGIN_FIELD Principio de campo
CLEAR Borrar o Borrar pantalla
DELETE_CHAR Eliminar o Eliminar carácter
DEST_BACK Borrar al utilizar Retroceso
DOWN Cursor abajo
DSPSOSI Mostrar SO/SI
DUP Campo duplicado
END_FILE Final de campo
INTRO Intro
ERASE_EOF Eliminar final de campo
ERASE_FIELD Eliminar campo
ERASE_INPUT Eliminar entrada
FIELD_EXT Salir del campo
FIELD_MINUS Campo resta
FIELD_PLUS Campo suma
FIELD_MARK Marca de campo
HELP Solicitud de ayuda
HEXMODE Modo Hex
HOME Inicio de cursor
INSERT Insertar
LEFT_ARROW Cursor izquierda
NEW_LINE Nueva línea
PA1 - PA3 PA1 - PA3
PF1 - PF24 PF1 - PF24
PAGE_DOWN Avance página
PAGE_UP Retroceso página
[imprimir] Imprimir
RESET Reset, reset terminal
RIGHT_ARROW Cursor derecha, derecha
SYSTEM_REQUEST Solicitud de sistema
TAB Tecla tabulación
UP Cursor arriba

VT

Palabra clave Descripción
BACKSPACE Retroceso
BREAK Interrumpir
CLEAR Borrar o Borrar pantalla
CURSOR_SELECT Selección de cursor
DELETE_CHAR Eliminar o Eliminar carácter
DOWN Cursor abajo
EK_FIND Editar buscar de teclado numérico
EK_INSERT Editar insertar de teclado numérico
EK_NEXT Editar siguiente de teclado numérico
EK_PREV Editar anterior de teclado numérico
EK_REMOVE Editar quitar de teclado numérico
EK_SELECT Editar seleccionar de teclado numérico
END_FILE Final de campo
INTRO Intro
F1 - F24 F1 - F24
HOLD Retención
HOME Inicio
INSERT Insertar
KEYPAD_COMMA Teclado numérico Coma
KEYPAD_DOT Teclado numérico decimal
KEYPAD_ENTER Teclado numérico Intro
KEYPAD_MINUS Teclado numérico -
KEYPAD0 - KEYPAD9 Teclado numérico 0 - Teclado numérico 9
LEFT_ARROW Cursor izquierda
PF1 - PF20 PF1 - PF20
PAGE_DOWN Avance página
PAGE_UP Retroceso página
RESET Reset, reset terminal
RETURN Retorno, retorno de carro
RIGHT_ARROW Cursor derecha, derecha
TAB Tecla tabulación
UDK16 - UDK20 Tecla definida por el usuario 6 - Tecla definida por el usuario 20
UP Cursor arriba

UTS

Palabra clave Descripción
BACKSPACE Retroceso
BACKTAB TabAtrás
CHAR_ERASE Borra el carácter en la posición del cursor y avanza el cursor.
CLEAR_DISPLAY Borrar pantalla
CLEAR_EOD Eliminar hasta final de pantalla
CLEAR_EOF Eliminar hasta final de campo
CLEAR_EOL Eliminar hasta final de línea
CLEAR_FCC Borrar carácter de control de campo
CLEAR_HOME Borrar pantalla y mover el cursor a la posición inicial
CONTROL_PAGE Alternar la página de control
DELETE_LINE Elimina la línea en la que se encuentra el cursor y sube las líneas restantes una fila arriba
DELIN_LINE Borra el carácter que se encuentra debajo del cursor y mueve los caracteres restantes una línea hacia la izquierda.
DELIN_PAGE Borra el carácter que se encuentra debajo del cursor y mueve los caracteres restantes una página hacia la izquierda.
DOWN Mueve el cursor una línea hacia abajo. Se ajusta en la parte inferior.
DUP_LINE Crea una copia de la línea actual y sobrescribe la línea siguiente con la duplicada.
END_FIELD Mueve el cursor al final del campo actual.
END_PAGE Mueve el cursor al final de la página actual.
EURO Inserta el carácter del Euro
F1 - F22 Teclas de función F1-F22
HOME Mueve el cursor al principio de la página actual (fila 1, col 1)
INSERT Alterna el modo insertar/sobrescribir.
INSERT_IN_LINE Inserta un espacio en la posición del cursor y mueve los caracteres restantes de la línea a la derecha. El carácter en la columna más a la derecha de la línea se descarta.
INSERT_IN_PAGE Inserta un espacio en la posición del cursor y mueve los caracteres restantes de la página a la derecha. El carácter en la columna más a la derecha de cada línea se descarta.
INSERT_LINE Inserta una nueva línea en la flecha del cursor y mueve las líneas restantes hacia abajo. La última fila de la página se descarta.
LEFT_ARROW Mueve el cursor una posición hacia la izquierda ajustándolo de ser necesario.
LOCATE_FCC Encuentra el carácter de control de campo siguiente en la pantalla.
MSG_WAIT Recupera la cola de mensajes al terminal.
RETURN Retorno de carro
RIGHT_ARROW Mueve el cursor una posición hacia la derecha ajustándolo de ser necesario.
SOE Inserta el carácter de Inicio de Entrada
START_OF_FIELD Mueve el cursor al principio del campo.
START_OF_LINE Mueve el cursor a la columna 1 de la línea actual.
TAB Mueve el cursor a la posición de tabulación siguiente de la pantalla.
TOGGLE_COL_SEP Alterna el atributo de separador de columna.
TOGGLE_STRIKE_THRU Alterna el atributo de tachado en la celda de datos actual.
TOGGLE_UNDERLINE Alterna el atributo de subrayado en la celda de datos actual.
TRANSMIT Transmite datos de campo modificados al host.
UNLOCK Envía la tecla UNLOCK al host.
UP Mueve el cursor una fila hacia arriba, ajustándolo si es necesario.

DataCell

El objeto DataCell ofrece información sobre una posición particular en una pantalla del terminal.

Método Descripción
getPosition() Devuelve la posición de esta celda de datos en la pantalla.
Devuelve
{Position} La posición de la celda de datos en la pantalla.
getChar() Obtiene el carácter asociado a la celda.
Devuelve
{String} El carácter asociado a la celda.
getAttributes() Devuelve el conjunto de atributos especificado para esta instancia de celda de datos. Consulte AttributeSet.
Devuelve
{AttributeSet} El conjunto de atributos de esta instancia de celda de datos.
getForegroundColor() Devuelve el color de primer plano, como está definido en el objeto Color, para esta celda de datos.
Devuelve
{Number} Color en primer plano de esta celda de datos. El color se define en el objeto Color.
getBackgroundColor() Devuelve el color de fondo, como está definido en el objeto Color, para esta celda de datos.
Devuelve
{Number} Color de fondo de esta celda de datos. El color se define en el objeto Color.
toString Convierte la celda de datos interna en una cadena.
Devuelve
{String} La representación en forma de cadena de una celda de datos.
isFieldDelimiter() Comprueba si esta celda representa un delimitador de campo.
Devuelve
{Boolean} "True" (verdadero) si esta celda es un delimitador de campo; de lo contrario, "False" (falso).

Dimensión

Representa el tamaño de la pantalla o de la región de la pantalla.

Método Descripción
Dimension(rows,cols) Crea una nueva instancia Dimension.
Parámetros
{Number} filas Dimensión de las filas de la pantalla.
{Number} columnas Dimensión de las columnas de la pantalla.

Field

Utilice el objeto Field con FieldList para obtener la información presente en un campo de la pantalla.

Método Descripción
getAttributes() Devuelve el conjunto de atributos especificado para esta instancia de campo. Consulte AttributeSet.
Devuelve
{AttributeSet} El conjunto de atributos de este campo.
getForegroundColor() Devuelve el color en primer plano para el campo.
Devuelve
{Number} Color en primer plano de este campo. Estos valores se definen en el objeto Color.
getBackgroundColor() Devuelve el color de fondo para el campo.
Devuelve
{Number} Color de fondo de este campo. Estos valores se definen en el objeto Color.
getStart() Devuelve la posición inicial del campo. La posición inicial es la posición del primer carácter del campo. Algunos tipos de host utilizan una posición de carácter para guardar los atributos de nivel de campo. En este caso, la posición del atributo no está considerada la posición inicial.
Devuelve
{Position} Posición inicial del campo.
Genera
{RangeError} Para campos de longitud cero.
getEnd() Devuelve la posición final del campo. La posición final es la posición en el espacio de representación que contiene el último carácter del campo.
Devuelve
{Position} Posición final del campo.
Genera
{RangeError} Para campos de longitud cero.
getLength() Devuelve la longitud del campo. Para los tipos de host que utilizan una posición de carácter para guardar los atributos de campo, la longitud del campo no incluye la posición del atributo de campo.
Devuelve
{Number} Longitud del campo.
getDataCells() Obtiene las celdas de datos que comprende este campo. Consulte DataCell.
Devuelve
{DataCell[]} Las celdas de datos que comprenden este campo.
getText() Obtiene el texto del campo.
Devuelve
{String} Campo de texto.
setText() Establece el texto del campo. Para algunos tipos de host, como los VT, el texto se transmite al host de inmediato, pero en otros tipos de host el texto no se transmite al host hasta que se invoca una tecla de ayuda. Si el texto es más corto que el campo, el texto se coloca en el campo del host y el resto del campo se borra. Si el texto es más largo que el campo del host, se coloca tanto texto como quepa en el campo.
Parámetro
{String} Texto que se colocará en el campo.
Genera
{Error} Si el campo está protegido.
clearField() Borra el campo actual de forma específica de la emulación.
Genera
{Error} Si el campo está protegido o no se admite el borrado.
getPresentationSpace() Obtiene el objeto PresentationSpace que ha creado este campo.
Devuelve
{PresentationSpace} Elemento principal de esta instancia de campo.
toString() Crea una descripción sencilla del campo.
Devuelve
{String} Una interpretación del campo legible por el usuario.

FieldList

Utilice el objeto FieldList junto con el objeto Field para obtener información de la lista de campos.

Método Descripción
getPresentationSpace() Obtiene el objeto PresentationSpace que ha creado este campo.
Devuelve
{PresentationSpace} Elemento principal de esta instancia de campo.
findField(position, text, direction) Devuelve el campo que contiene el texto especificado. La búsqueda empieza desde la posición especificada y se realiza hacia delante o hacia detrás. Si la cadena contiene múltiples campos, se devuelve el campo que contiene la posición inicial. Cuando se busca hacia delante, la búsqueda no se ajusta a la parte superior de la pantalla. Cuando se busca hacia atrás, la búsqueda no se ajusta a la parte inferior de la pantalla.
Parámetros
{Position} Posición desde la que se debe iniciar la búsqueda. Consulte el objeto Position.
{String} El texto a buscar (opcional). Si no se indica, devuelve el campo siguiente a la derecha o debajo de la posición especificada.
{Number} Dirección de la búsqueda (opcional). Utilice PresentationSpace. Constantes SearchDirection para estos parámetros. Por ejemplo, PresentationSpace.SearchDirection.FORWARD o PresentationSpace.SearchDirection.BACKWARD. Si no se indica, se busca hacia delante.
Devuelve
{Field} Contiene la cadena o cero si no se encuentra un campo que cumpla los criterios especificados.
Genera
{RangeError} Si la posición está fuera del rango.
get(index) Obtiene el campo en el índice dado.
Parámetros
{Number} Índice en la lista de campos.
Devuelve
{Field} Ubicado en el índice especificado.
Genera
{RangeError} Si el índice está fuera del rango.
isEmpty() Determina si la lista de campos está vacía.
Devuelve
{Boolean} "True" (verdadero) si la lista está vacía.
size() Indica el número de campos en la lista.
Devuelve
{Number} El número de campos.
toString() Crea una descripción sencilla la lista de campos.
Devuelve
{String} Una interpretación de la lista de campos legible por el usuario.

FileTransfer

Utilice el objeto FileTransfer para listar y transferir archivos entre el sistema del host y el cliente.

La API de transferencia de archivos de Host Access for the Cloud abstrae las convenciones de ruta de archivos utilizadas por diferentes implementaciones de archivos del host. Siga los formatos de ruta de sistema de archivos URL o Linux a la hora de formatear las rutas de archivo utilizadas por la API. Por ejemplo, /root/directory/file.

Es importante observar todas las reglas específicas de los sistemas de host, como los caracteres permitidos o las longitudes de los nombres.

nota

Los navegadores imponen importantes restricciones de seguridad sobre la capacidad de Javascript para interactuar con los sistemas de archivos de los clientes.

Método Descripción
getHostFileListing(remotePath)() Solicitar un listado de archivos de host. Si se omite RemotePath, se muestra un listado de archivos para el directorio de trabajo remoto actual.
Parámetros
{String} (opcional) Si se especifica, se obtiene un listado de archivos para la ruta remota especificada. Si no se especifica, se obtiene un listado de archivos para el directorio de trabajo remoto actual.
Devuelve
{Promise} Se resuelve en una matriz de objetos HostFile incluidos en remoteName. Se rechaza si la ruta remota no se puede leer.
sendFile(localFile, remoteName) Envía el archivo especificado al host.
Parámetros
{File} Objeto de archivo de Javascript que señala al archivo local que se va a enviar.
{String} (opcional) Nombre completo de archivo remoto tal y como lo permite el sistema remoto (Unix, Windows, MVS o VAX).
Devuelve
{Promise} Se cumple con un objeto HostFile que indica que el archivo se ha enviado correctamente. Se rechaza si se ha producido un error al enviar el archivo.
getDownloadURL(remoteName) Construye un vínculo para descargar un archivo desde un sistema de host.
Parámetros
{String} Nombre completo de archivo remoto, tal y como lo permite el sistema remoto (Unix, Windows, MVS o VAX).
Devuelve
{URL} URL que se puede utilizar para recuperar el archivo desde el servidor de sesión de Host Access for the Cloud.
setTransferOptions(options) Establece las opciones de transferencia para la sesión FileTransfer actual. Las opciones de transferencia se aplican a todas las transferencias futuras cuando o bien se cierra la sesión, o bien ésta se sobrescribe con otra llamada a setTransferOptions.
Parámetros
{JSON} Consulte FileTransferOptions para conocer los nombres y valores permitidos.
Devuelve
{Promise} Se cumple cuando finaliza la llamada. Se rechaza si se ha producido un error al configurar las opciones.
cancelar() Cancela la transferencia actual en curso.
Parámetros
{String} Nombre completo de archivo remoto, tal y como lo permite el sistema remoto (Unix, Windows, MVS o VAX).
Devuelve
{Promise} Se cumple cuando finaliza la llamada. Se rechaza si se ha producido un error al cancelar la transferencia.

FileTransferFactory

Un objeto fileTransferFactory está disponible para todas las macros. Si se han configurado transferencias de archivos para la sesión, puede utilizarlas para obtener una referencia a un objeto FileTransfer.

Método Descripción
getIND$File() Devuelve un objeto FileTransfer para interactuar con el tipo Ind$File configurado para la sesión.
Devuelve
{FileTransfer}
Genera
{Error} Si la sesión no se ha configurado para permitir transferencias IND$File.

FileTransferOptions

Especificación del objeto de opción de transferencia de archivos. Ejemplo:
`fileTransfer.setTransferOptions({ transferMethod : 'ascii' });```

Método Descripción
transferMethod {String}Valores permitidos:
  • ‘ascii’
  • ‘binario’

HostFile

Un objeto HostFile representa un archivo en el sistema de archivos del host.

Método Descripción
getName() Obtiene el nombre de archivo.
Devuelve
{String} El nombre de archivo.
getParent() Obtiene el creador de este archivo del host.
Devuelve
{String} El elemento principal de este archivo del host. Esto significa cosas diferentes en tipos de host diferentes. Por ejemplo, en TSO éste es el nombre del catálogo en el que reside el archivo.
getSize() El tamaño en bytes del archivo.
Devuelve
{Number} El tamaño del archivo en bytes.
getType() El tipo de archivo representado.
Devuelve

HostFileType

El objeto HostFileType define constantes para determinar el tipo de un objeto HostFile.

Valor Descripción
FILE Representa un archivo en el sistema de host.
DIR Representa un directorio en el sistema de host.
DESCONOCIDO Representa un archivo del host de origen desconocido.

OIA

Interfaz Operator Information Area (OIA). El objeto OIA devuelve valores que se han definido en el objeto OIAStatus.

Método Descripción
getStatus () Devuelve el conjunto de indicadores de estado habilitado. Consulte StatusSet.
Devuelve
{StatusSet} Contiene la información de estado.
getCommErrorCode() Devuelve el código de error de comunicación actual.
Devuelve
{Number} El código de error de comunicación actual. Si no existe, será 0.
getProgErrorCode() Devuelve el código de error del programa actual..
Devuelve
{Number} El código de error de programa actual. Si no existe, será 0.

OIAStatus

OIAStatus Descripción
CONTROLLER_READY Controlador listo
A_ONLINE Online con una conexión no-SNA
MY_JOB Conectada a una aplicación de host
OP_SYS Conectada a SSCP (SNA)
UNOWNED No conectada
TIME Teclado inhibido
SYS_LOCK Bloqueo del sistema tras tecla AID
COMM_CHECK Prueba de comunicación
PROG_CHECK Prueba de programa
ELSEWHERE Pulsación de tecla no válido en la posición del cursor
FN_MINUS Función no disponible
WHAT_KEY Pulsación de tecla no válido
MORE_THAN Demasiados caracteres ingresados en el campo
SYM_MINUS Símbolo introducido no disponible
INPUT_ERROR Error de entrada de operador (5250 sólo)
DO_NOT_ENTER No introducir
INSERT Cursor en modo insertar
GR_CURSOR Cursor en modo gráfico
COMM_ERR_REM Recordatorio de error de comunicación
MSG_WAITING Indicador de mensaje en espera
ENCRYPT La sesión está cifrada
NUM_FIELD Carácter no válido en campo sólo numérico

Posición

Método Descripción
Position(row,col) Crea una nueva instancia Position.
Parámetros
{Number} Coordenada de fila de la pantalla de filas.
{Number} Coordenada de columna de la pantalla de columnas.

PresentationSpace

Utilice el objeto PresentationSpace para interactuar con la pantalla del terminal. Entre las interacciones disponibles están ajustar y obtener la posición del cursor y la lectura de texto.

Método Descripción
getCursorPosition() Devuelve una instancia de Position que representa la posición actual del cursor. Una sesión no conectada tiene una posición de cursor de 0,0.
Devuelve
{Position} Ubicación actual del cursor.
setCursorPosition(position) Mueve el cursor del host a la posición de fila y columna especificado. En algunos hosts, como los VT, el host puede restringir los movimientos del cursor.
Parámetros
{Position} Position Nueva posición del cursor.
Devuelve
None
Genera
{RangeError} Si la posición no es válida en la pantalla actual.
isCursorVisible() Comprueba que el cursor está actualmente visible en el espacio de presentación. El cursor se considera no visible si la sesión no está conectada.
Devuelve
{Boolean} "True" (verdadero) si el cursor está visible. False si el cursor no está visible.
sendKeys(keys) Transmite una cadena de texto o ControlKey al host en la posición actual del cursor en el espacio de presentación. Si el cursor no se encuentra en la posición deseada, utilice primero la función setCursorPosition.
La cadena de texto puede contener cualquier número de caracteres y objetos ControlKey.
Por ejemplo: "myname" + ControlKey.TAB + "mypass" + ControlKey.ENTER transmitirá un ID de usuario, tabulará al campo siguiente, transmitirá una contraseña y, a continuación, transmitirá la tecla Intro.
Si necesita transmitir un corchete, duplique los corchetes ([[ o ]]).
Parámetros
{String} Texto de teclas o teclas de control que se transmitirán.
getText(start,length) Devuelve una cadena que representa un área lineal del espacio de presentación. Cuando se encuentran los límites de la fila, no se insertan caracteres de nueva línea.
Parámetros
{Position} Posición inicial desde la que se debe recuperar el texto.
{Number} Longitud del número máximo de caracteres que se devolverán. Si el parámetro de longitud provoca que se supere la última posición del espacio de presentación, solo se devuelven los caracteres hasta la última posición.
Devuelve
{String) Representa un área lineal del espacio de presentación que puede estar vacía si la sesión no está conectada.
Genera
{RangeError} Si la posición o la longitud no son válidas en la pantalla actual.
getSize() Obtiene las dimensiones de la pantalla como objeto Dimension.
Devuelve
{Dimension} Contiene el número de filas y columnas. El tamaño de la pantalla es [row:0, col:0] si la sesión no está conectada.
getDataCells(start, length) Devuelve instancias de DataCell en las que el primer miembro será para la posición especificada por el parámetro de inicio. El número máximo de instancias DataCell en la lista viene especificado por el parámetro de longitud.
Parámetros
{Position} Inicio de la primera posición en la pantalla del host en la que se recuperan instancias de DataCell. Consulte Position.
{Number} Longitud del número máximo de instancias de DataCell que se van a recuperar. Si no se especifica, devuelve DataCells de la posición inicial a la posición final de la pantalla.
Devuelve
{DataCell[]} Instancias que pueden estar vacías si no se ha conectado la sesión. Si la posición no está especificada, devuelve todas las DataCells. Si la longitud no se especifica, devuelve DataCells de la posición inicial a la posición final de la pantalla.
Genera
{RangeError} Si el inicio o la longitud están fuera del rango.
getFields() Devuelve una lista de los campos en el espacio de presentación. Si el tipo de host no soporta campos o si la pantalla actual no está formateada el valor de retorno será siempre una lista vacía. Consulte FieldList.
Devuelve
{FieldList} Para los campos definidos del host en el espacio de presentación.

Sesión

El objeto Session es el punto de entrada principal para acceder al host. Contiene las funciones para conectar, desconectar y obtener el objeto PresentationSpace.

Método Descripción
connect() Conecta con el host configurado. Si es necesario, utilice wait.forConnect() para bloquear la ejecución de la macro hasta que la sesión esté conectada.
Devuelve
None.
disconnect() Se desconecta del host configurado. Si es necesario, utilice wait.forDisconnect() para bloquear la ejecución de la macro hasta que la sesión esté conectada.
Devuelve
None.
isConnected() Determina si la conexión con el host está establecida o no.
Devuelve
{Boolean} "True" (verdadero) si se ha establecido la conexión con el host; de lo contrario, "False" (falso).
getPresentationSpace() Proporciona acceso a la instancia de PresentationSpace para esta sesión.
Devuelve
{PresentationSpace} Instancia asociada a esta sesión.
getDeviceName() Devuelve el nombre del dispositivo para una sesión conectada o una cadena vacía si la sesión está desconectada o no tiene un nombre de dispositivo.
Devuelve
{String} El nombre del dispositivo conectado.
getType() Devuelve el tipo de sesión de host. Véase SessionType.
Devuelve
{String} El tipo de sesión del host.
setDeviceName() Aporta un medio para modificar el nombre de dispositivo en una instancia de sesión.
Parámetros
{String} name Nombre del dispositivo que se utilizará al conectarse a un host.
Genera
{Error} Si se intenta configurar el nombre de dispositivo mientras la sesión está conectada.
getOIA() Proporciona acceso a la instancia de OIA para esta sesión.
Devuelve
{OIA} OIA asociada a este sesión.

SessionType

Constantes utilizadas para identificar el tipo de host al que se está realizando la conexión. Consulte el objeto Session.

Tipos de host disponibles:

  • IBM_3270
  • IBM_5250
  • VT
  • ALC
  • UTS
  • T27

StatusSet

Puede utilizar el objeto StatusSet para descifrar el estado de OIA. El objeto StatusSet devuelve valores definidos en el objeto OIAStatus y, cuando se utilizan juntos, se puede obtener información de estado del OIA.

Método Descripción
contains(statusFlag) Determina si el conjunto contiene el indicador de estado especificado de constantes de OIAStatus.
Parámetros
{Number} Estado de statusFlag que se comprobará.
Devuelve
{Boolean}"True" (verdadero) si el indicador de estado está presente en el conjunto.
isEmpty() Determina si el conjunto de estados está vacío.
Devuelve
{Boolean} "True" (verdadero) si el conjunto está vacío.
size() Indica el número de indicadores de estado en el conjunto.
Devuelve
{Number} El número de estados.
toArray() Convierte el conjunto de estados interno en una matriz.
Devuelve
{Object []} Matriz de indicadores de estado del conjunto.
toString() Convierte el conjunto de estados interno en una cadena.
Devuelve
{String} Nombres delimitados por espacios de indicadores de estado en el conjunto.
forEach(callback, thisArg) Función para iterar sobre cada elemento en el conjunto de estados.
Parámetros
{forEachCallback} Devolución de llamada para realizar la operación específica. Se llama con el nombre de cada estado en el conjunto.
forEachCallback(string, thisArg) Una función de devolución de llamada suministrada por el usuario en la que se proporciona el comportamiento que se utilizará como parámetro de devolución de llamada a forEach.
Parámetros
{String} String El nombre de un estado en el conjunto de estado.
{Object} thisArg Puntero opcional a un objeto de contexto.

Interfaz de usuario

El objeto de interfaz de usuario provee funciones para interactuar con el usuario, para preguntar por información básica y visualizarla. El objeto UI está disponible automáticamente en su macro como la variable “ui”.

nota

Importante: Todas las funciones de la interfaz de usuario requieren la palabra clave "yield" delante de ellas. Esto permite bloquear la ejecución de la macro hasta que se cumplan las condiciones para la función UI.
[parameter] denota un parámetro opcional.

Método Descripción
prompt(message,[defaultAnswer], [mask]) Se pregunta al usuario por información en la interfaz de usuario.
Parámetros
{String} Título del mensaje que se mostrará al usuario. Por defecto: cadena vacía.
{String} Respuesta por defecto que se utilizará si el usuario la deja en blanco. Valor por defecto: cadena en blanco
{Boolean} La máscara indica si se debe ocultar la solicitud (como con una contraseña).
Devuelve
{Promise} Se cumple si el usuario cierra la ventana del diálogo. Devuelve la entrada del usuario con “OK” o cero con “Cancel”.
message([message]) Muestra un mensaje en la interfaz de usuario.
Parámetros
{String} Mensaje que se mostrará al usuario. Por defecto: cadena vacía.
Devuelve
{Promise} Se cumple cuando el usuario cierra la ventana del mensaje.

Wait

Utilice el objeto wait para esperar una sesión particular o un estado de pantalla. Por ejemplo, puede esperar hasta que el cursor se encuentre en una posición particular o hasta que haya texto presente en una posición determinada antes de continuar con la ejecución de la macro.

Las funciones de espera se utilizan frecuentemente en combinación con funciones asíncronas como connect() y sendKeys().

nota

Todas las funciones tienen tiempo límite como parámetro opcional y tienen un valor de tiempo límite por defecto de 10 segundos (10 000 ms).
Importante: Todas las funciones de espera requieren la clave ‘yield’ enfrente de ellas. Esto permite bloquear la ejecución de la macro hasta que se cumplan las condiciones para la función de espera.
[parameter] denota un parámetro opcional.

Método Descripción
setDefaultTimeout(timeout) Establece el valor de tiempo límite por defecto para todas las funciones.
Parámetros
{Number} Tiempo límite por defecto que se utilizará para todas las funciones de espera en milisegundos.
Devuelve
{None}
Genera
{RangeError} Si el tiempo límite especificado es inferior a cero.
forConnect([timeout]) Espera una solicitud de conexión para completar.
Parámetros
{Number} Tiempo en milisegundos.
Devuelve
{Promise} Se cumple si la sesión ya está conectada o cuando se realiza la conexión. Rechazada si expira el tiempo de espera.
forDisconnect([timeout]) Espera una solicitud de desconexión para completar.
Parámetros
{Number} Tiempo límite en milisegundos.
Devuelve
{Promise} Se cumple si la sesión ya está desconectada o cuando al fin se desconecta. Rechazada si expira el tiempo de espera.
forFixedTime([timeout]) Espera de forma incondicional un tiempo fijo. Tiempo en milisegundos (ms).
Parámetros
{Number} Tiempo límite en milisegundos.
Devuelve
{Promise} Se cumple una vez transcurrido el tiempo.
forScreenChange([timeout]) Espera a que cambie la pantalla de host. Esta función se devuelve cuando se detecta una actualización de pantalla. No ofrece garantías sobre el número de actualizaciones posteriores que pueden recibirse antes de que se complete la pantalla. Es aconsejable esperar repetidamente hasta que el contenido de la pantalla coincida con algunos criterios de detención conocidos.)
Parámetros
{Number} Tiempo límite en milisegundos.
Devuelve
{Promise} Se resuelve si la pantalla cambia. Rechazada si expira el tiempo de espera.
forCursor(position, [timeout]) Espera a que el cursor llegue a la posición especificada.
Parámetros
{Position} La posición que especifica la fila y la columna.
Devuelve
{Promise} Se cumple si el cursor ya se ha ubicado o si se ubica finalmente. Rechazada si expira el tiempo de espera.
forText(text, position, [timeout]) Espera a que el texto se encuentre en una posición específica de la pantalla.
Parámetros
{String} El texto previsto.
{Position} La posición que especifica la fila y la columna.
{Number} Tiempo límite en milisegundos.
Devuelve
{Promise} Se cumple si el texto ya se encuentra en la posición especificada o en cualquier otra ubicación. Rechazada si expira el tiempo de espera.
Genera
{RangeError} Si la posición no es válida.
forHostPrompt(text, column,[timeout]) Espera a que un símbolo de sistema esté colocado en una columna específica de la pantalla.
Parámetros
{String} Solicitud de texto prevista.
{Number} Columna en la que se espera que se encuentre el cursor.
{Number} Tiempo límite en milisegundos.
Devuelve
{Promise} Se cumple si ya se dan las condiciones o cuando al fin se dan. Rechazada si expira el tiempo de espera.
Genera
{RangeError} Si la columna está fuera del rango.
forHostSettle([settleTime],[timeout]) NOTA: wait.forHostSettle solo debe utilizarse cuando otras funciones de espera adicionales específicas son insuficientes.
Supervisa los datos entrantes de la pantalla; resuelve settleTime ms tras la última actualización y cuando el teclado está desbloqueado. Esta función es útil cuando los datos llegan en varios paquetes y desea asegurarse de que se ha recibido toda la pantalla antes de continuar.
Parámetros
{Number} Tiempo que se esperará después de la última actualización para asegurarse de que no se reciban datos de forma inesperada. El valor por defecto es 200 milisegundos.
{Number} tiempo de espera en milisegundos.
Devuelve
{Promise} Se cumple cuando ha transcurrido el tiempo de establecimiento tras la recepción de la última actualización de la pantalla y el teclado está desbloqueado.