Vai al contenuto

Oggetti dell'API Macro

È possibile creare macro utilizzando l'API Macro. Per impostazione predefinita sono disponibili quattro oggetti principali da utilizzare nelle macro:

  • Session - Il punto di entrata principale per accedere all'host. L'oggetto Session viene utilizzato per eseguire la connessione, la disconnessione e per fornire accesso all'oggetto PresentationSpace.

  • PresentationSpace - Rappresenta lo schermo e fornisce molte capacità comuni, ad esempio il recupero e l'impostazione della posizione del cursore, l'invio di dati all'host e la lettura dello schermo. Viene ottenuto chiamando session.getPresentationSpace().

  • Wait - Fornisce un modo semplice per attendere che si verifichino i vari stati dell'host prima di continuare a inviare altri dati o a leggere dallo schermo. Ad esempio, è possibile attendere che il cursore si trovi in una determinata posizione, che il testo sia presente in una certa posizione sullo schermo o attendere semplicemente che trascorra un periodo di tempo fissato. Tutte le funzioni "wait" richiedono la parola chiave yield, spiegata più avanti.

  • User Interface - Disponibile automaticamente nella macro come variabile "ui". Fornisce capacità di interfaccia utente di base. È possibile utilizzare questo oggetto per mostrare i dati all'utente o richiedergli informazioni. Tutte le chiamate alla funzione "UI" richiedono la parola chiave yield.

Tutti gli oggetti disponibili

Vedere l'elenco degli oggetti disponibili nel riquadro di navigazione a destra, "In questa pagina" (potrebbe essere necessario espandere il browser).


Attributo

Utilizzare l'oggetto Attribute, insieme ad AttributeSet, per decodificare le informazioni di formattazione presenti nella cella dati.

Attributo Indica...
PROTECTED una cella dati protetta
MODIFIED una cella dati modificata
NUMERIC_ONLY l'inizio di una cella dati esclusivamente numerica
ALPHA_NUMERIC una cella dati alfanumerica
HIGH_INTENSITY se la cella dati contiene testo ad alta intensità
HIDDEN se la cella dati contiene testo nascosto
PEN_DETECTABLE se la cella dati è rilevabile dalla penna ottica
ALPHA_ONLY una cella dati esclusivamente alfabetica
NUMERIC_SHIFT l'inizio di un campo di spostamento numerico
NUMERIC_SPECIAL che la cella dati contrassegna l'inizio di un campo numerico speciale
KATAKANA_SHIFT una sezione di testo Katakana
MAGNETIC_STRIPE che la cella dati contrassegna l'inizio di un campo banda magnetica
SIGNED_NUMERIC_ONLY che la cella dati è un campo numerico con segno
TRANSMIT_ONLY che la cella dati è un campo di sola trasmissione
FIELD_END_MARKER che la cella dati contrassegna la fine di un campo modificato
FIELD_START_MARKER che la cella dati contrassegna l'inizio di un campo modificato
SPECIAL_EMPHASIS_PROTECTED un campo protetto con enfasi speciale
TAB_STOP che la cella dati contiene un arresto di tabulazione
REVERSE che la cella dati viene visualizzata in modalità video inverso
BLINKING che la cella dati contiene testo intermittente
RIGHT_JUSTIFIED che la cella dati contrassegna l'inizio di un campo con giustificazione a destra
LEFT_JUSTIFIED che la cella dati contrassegna l'inizio di un campo con giustificazione a sinistra
LOW_INTENSITY che la cella dati contiene testo a bassa intensità
UNDERLINE che la cella dati contiene testo sottolineato
DOUBLE_BYTE che la cella dati contiene testo a doppio byte
COLUMN_SEPARATOR che la cella dati contiene un separatore di colonna
BOLD che la cella dati contiene testo in grassetto
DOUBLE_WIDTH che la cella dati contrassegna un campo a doppia larghezza
DOUBLE_HEIGHT_TOP una cella dati a doppia altezza superiore
DOUBLE_HEIGHT_BOTTOM una cella dati a doppia altezza inferiore
CONTROL_PAGE_DATA che la cella dati contiene dati pagina di controllo
RIGHT_COLUMN_SEPARATOR che la cella dati contiene un separatore di colonna a destra
LEFT_COLUMN_SEPARATOR che la cella dati contiene un separatore di colonna a sinistra
UPPERSCORE che la cella dati contiene un sopralineato
STRIKE_THROUGH che la cella dati contiene testo barrato

AttributeSet

L'oggetto AttributeSet consente all'utente di decodificare gli attributi presenti nella cella dati. L'oggetto AttributeSet restituisce i valori definiti nell'oggetto Attribute e, se utilizzati insieme, è possibile ottenere informazioni sulla formattazione dalla cella dati.

Metodo Descrizione
contains(attribute) Determina se il set contiene l'Attribute specificato.
Parametri
{Number} attributo da controllare
Restituisce
{Boolean} True se l'attributo è presente nel set
isEmpty() Determina se il set di attributi è vuoto.
Restituisce
{Boolean}True se il set è vuoto.
size() Indica il numero di attributi in un set.
Restituisce
{Number} Il numero di attributi.
toArray() Converte il set di attributi interno in una matrice.
Restituisce
{Number[]}Matrice dei valori degli attributi nel set.
toString() Converte il set di attributi interno in una stringa.
Restituisce
{String} Nomi delimitati da spazi degli attributi nel set.
forEach(callback, thisArg) Funzione per reiterare ogni elemento nel set di attributi.
Parametri
{forEachCallback} Richiamata per eseguire l'operazione specifica. Chiamato con il nome di ogni attributo nel set.
{Object} thisArg puntatore facoltativo a un oggetto di contesto.
forEachCallback(string, object) Una funzione di richiamata fornita dall'utente in cui fornire il comportamento, da usare come parametro di richiamata per forEach.
Parametri
{String} Nome stringa dell'attributo nel set di attributi.
{Object} thisArg puntatore facoltativo a un oggetto di contesto.

AutoSignOn

Metodo Descrizione
getPassTicket() Ottiene un pass ticket da utilizzare per accedere a un'applicazione mainframe. È possibile richiedere più pass ticket utilizzando ID di applicazioni diversi.
Parametri
{String} L'ID applicazione indica all'host a quale applicazione è destinato l'accesso
Restituisce
{Promise} completata con la chiave pass ticket o rifiutata se l'operazione non riesce. Il pass ticket ottenuto da DCAS funziona solo per la sessione host corrente ed è valido per dieci minuti.
sendUserName() Applica il nome utente contenuto nel pass ticket al campo nella posizione del cursore corrente sullo schermo host corrente. Il nome utente deve essere inviato prima della password. Se viene inviata prima la password, il pass ticket verrà invalidato e sarà necessario ottenerne un altro.
Parametri
{String} passTicketKey ottenuto da getPassTicket
Restituisce
{Promise} completata se il nome utente viene inviato correttamente. Rifiutata se l'operazione non riesce.
sendPassword() Applica la password contenuta nel pass ticket al campo nella posizione del cursore corrente sullo schermo host corrente. Il nome utente deve essere inviato prima della password. Se viene inviata prima la password, il pass ticket verrà invalidato e sarà necessario ottenerne un altro.
Parametri
{String} passTicketKey ottenuto da getPassTicket
Restituisce
{Promise} completata se la password viene inviata correttamente. Rifiutata se l'operazione non riesce.

Colore

Costanti di colore da usare per i colori di primo piano e sfondo dell'oggetto DataCell.

Colore Descrizione Valore numerico
BLANK_UNSPECIFIED Nessun colore specificato 0
BLUE Blu 1
GREEN Verde 2
CYAN Ciano 3
RED Rosso 4
MAGENTA Magenta 5
YELLOW Giallo 6
WHITE_NORMAL_INTENSITY Bianco con intensità normale 7
GRAY Grigio 8
LIGHT_BLUE Blu chiaro 9
LIGHT_GREEN Verde chiaro 10
LIGHT_CYAN Ciano chiaro 11
LIGHT_RED Rosso chiaro 12
LIGHT_MAGENTA Magenta chiaro 13
BLACK Nero 14
WHITE_HIGH_INTENSITY Bianco con intensità alta 15
BROWN Marrone 16
PINK Rosa 17
TURQUOISE Turchese 18

ControlKey

L'oggetto ControlKey definisce le costanti per inviare i tasti di controllo del cursore e i comandi dell'host utilizzando il metodo sendKeys. Sono disponibili costanti per i tipi di host seguenti:


IBM 3270

Parola chiave Descrizione
ALTVIEW Alterna visualizzazione
ATTN Attenzione
BACKSPACE Backspace
BACKTAB Tab indietro
CLEAR Cancella o cancella display
CURSOR_SELECT Selezione cursore
DELETE_CHAR Elimina, elimina carattere
DELETE_WORD Elimina parola
DEST_BACK Backspace distruttivo
DEV_CANCEL Annulla dispositivo
DOWN Cursore giù
DSPSOSI Visualizza SO/SI
DUP Duplica campo
END_FILE Fine del campo
ENTER Invio
ERASE_EOF Cancella fino a fine del campo
ERASE_FIELD Cancella campo
ERASE_INPUT Cancella input
FIELD_MARK Field Mark
HOME Cursore in posizione Home
IDENT Identità
INSERT Inserisci
LEFT_ARROW Cursore a sinistra
LEFT2 Due posizioni verso sinistra
NEW_LINE Nuova riga
PA1 - PA3 PA1 - PA3
PF1 - PF24 PF1 - PF24
PAGE_DOWN Pagina giù
PAGE_UP Pagina su
RESET Ripristina, ripristina terminale
RIGHT2 Due posizioni verso destra
RIGHT_ARROW Cursore a destra, destra
SYSTEM_REQUEST Richiesta di sistema
TAB Tasto tabulazione
UP Cursore su

IBM 5250

Parola chiave Descrizione
ALTVIEW Alterna visualizzazione
ATTN Attenzione
AU1 - AU16 AU1 - AU16
BACKSPACE Backspace
BACKTAB Tab indietro
BEGIN_FIELD Inizio campo
CLEAR Cancella o cancella display
DELETE_CHAR Elimina, elimina carattere
DEST_BACK Backspace distruttivo
DOWN Cursore giù
DSPSOSI Visualizza SO/SI
DUP Duplica campo
END_FILE Fine del campo
ENTER Invio
ERASE_EOF Cancella fino a fine del campo
ERASE_FIELD Cancella campo
ERASE_INPUT Cancella input
FIELD_EXT Uscita campo
FIELD_MINUS Campo meno
FIELD_PLUS Campo più
FIELD_MARK Field Mark
HELP Richiesta guida
HEXMODE Modalità esadecimale
HOME Cursore in posizione Home
INSERT Inserisci
LEFT_ARROW Cursore a sinistra
NEW_LINE Nuova riga
PA1 - PA3 PA1 - PA3
PF1 - PF24 PF1 - PF24
PAGE_DOWN Pagina giù
PAGE_UP Pagina su
[stampare] Stampa
RESET Ripristina, ripristina terminale
RIGHT_ARROW Cursore a destra, destra
SYSTEM_REQUEST Richiesta di sistema
TAB Tasto tabulazione
UP Cursore su

VT

Parola chiave Descrizione
BACKSPACE Backspace
BREAK Interruzione
CLEAR Cancella o cancella display
CURSOR_SELECT Selezione cursore
DELETE_CHAR Elimina, elimina carattere
DOWN Cursore giù
EK_FIND Modifica ricerca tastierino
EK_INSERT Modifica inserimento tastierino
EK_NEXT Modifica tastierino successivo
EK_PREV Modifica tastierino precedente
EK_REMOVE Modifica rimozione tastierino
EK_SELECT Modifica selezione tastierino
END_FILE Fine del campo
ENTER Invio
F1 - F24 F1 - F24
HOLD In attesa
HOME Home
INSERT Ins
KEYPAD_COMMA Virgola tastierino
KEYPAD_DOT Decimale tastierino
KEYPAD_ENTER Invio tastierino
KEYPAD_MINUS Meno tastierino
KEYPAD0 - KEYPAD9 0 tastierino - 9 tastierino
LEFT_ARROW Cursore a sinistra
PF1 - PF20 PF1 - PF20
PAGE_DOWN Pagina giù
PAGE_UP Pagina su
RESET Ripristina, ripristina terminale
RETURN Invio, ritorno a capo
RIGHT_ARROW Cursore a destra, destra
TAB Tasto tabulazione
UDK16 - UDK20 Tasto 6 definito dall'utente - Tasto 20 definito dall'utente
UP Cursore su

UTS

Parola chiave Descrizione
BACKSPACE Backspace
BACKTAB Tab indietro
CHAR_ERASE Cancella il carattere nella posizione del cursore e sposta il cursore in avanti.
CLEAR_DISPLAY Cancella il display
CLEAR_EOD Cancella fino a fine display
CLEAR_EOF Cancella fino a fine campo
CLEAR_EOL Cancella fino a fine riga
CLEAR_FCC Cancella il carattere di controllo del campo
CLEAR_HOME Cancella il contenuto del display e porta il cursore in posizione Home
CONTROL_PAGE Attiva/Disattiva la pagina di controllo
DELETE_LINE Elimina la riga che contiene il cursore e sposta di una riga in alto le righe rimanenti
DELIN_LINE Elimina il carattere nella posizione del cursore e sposta a sinistra i caratteri rimanenti sulla riga.
DELIN_PAGE Elimina il carattere nella posizione del cursore e sposta a sinistra i caratteri rimanenti sulla pagina.
DOWN Sposta il cursore in basso di una riga. A capo in fondo.
DUP_LINE Crea una copia della riga corrente e sovrascrive la riga successiva con il duplicato.
END_FIELD Sposta il cursore alla fine del campo corrente.
END_PAGE Sposta il cursore alla fine della pagina corrente.
EURO Inserisce il carattere Euro
F1 - F22 Tasti funzione F1-F22
HOME Sposta il cursore all'inizio della pagina corrente (riga 1, colonna 1)
INSERT Attiva/Disattiva la modalità inserimento/sovrascrittura.
INSERT_IN_LINE Inserisce uno spazio alla posizione del cursore e sposta a destra i caratteri rimanenti sulla riga. Il carattere nella colonna all'estrema destra della riga viene rimosso.
INSERT_IN_PAGE Inserisce uno spazio alla posizione del cursore e sposta a destra i caratteri rimanenti sulla pagina. Il carattere nella colonna all'estrema destra di ogni riga viene rimosso.
INSERT_LINE Inerisce una nuova riga nella riga del cursore e sposta in basso le righe rimanenti. L'ultima riga nella pagina viene rimossa.
LEFT_ARROW Sposta il cursore di una posizione a sinistra e sposta a capo se necessario.
LOCATE_FCC Trova il carattere di controllo del campo successivo sullo schermo.
MSG_WAIT Recupera i messaggi in coda al terminale.
RETURN A capo
RIGHT_ARROW Sposta il cursore di una posizione a destra e sposta a capo se necessario.
SOE Inserisce il carattere di inizio immissione
START_OF_FIELD Sposta il cursore all'inizio del campo.
START_OF_LINE Sposta il cursore alla colonna 1 della riga corrente.
TAB Sposta il cursore alla posizione di tabulazione successiva sullo schermo.
TOGGLE_COL_SEP Attiva/Disattiva l'attributo del separatore di colonna.
TOGGLE_STRIKE_THRU Attiva/Disattiva l'attributo di testo barrato sulla cella dati corrente.
TOGGLE_UNDERLINE Attiva/Disattiva l'attributo di testo sottolineato sulla cella dati corrente.
TRANSMIT Trasmette i dati dei campi cambiati all'host.
UNLOCK Invia il tasto UNLOCK all'host.
UP Sposta il cursore in alto di una riga, a capo se necessario.

DataCell

L'oggetto DataCell fornisce informazioni su una posizione particolare su uno schermo di terminale.

Metodo Descrizione
getPosition() Restituisce la posizione di questa cella dati sullo schermo.
Restituisce
{Position} La posizione della cella dati sullo schermo
getChar() Ottiene il carattere associato alla cella.
Restituisce
{String}Il carattere associato alla cella.
getAttributes() Restituisce il set di attributi specificato per questa istanza della cella dati. Vedere AttributeSet.
Restituisce
{AttributeSet} Il set di attributi specificato per questa istanza della cella dati.
getForegroundColor() Restituisce il colore del primo piano, come definito nell'oggetto Color, per questa cella dati.
Restituisce
{Number} Colore in primo piano per questa cella dati. Il colore è definito nell'oggetto Color.
getBackgroundColor() Restituisce il colore dello sfondo, come definito nell'oggetto Color, per questa cella dati.
Restituisce
{Number} Colore di sfondo per questa cella dati. Il colore è definito nell'oggetto Color.
toString Converte la cella dati interna in una stringa.
Restituisce
{String}La rappresentazione in formato stringa di una cella dati.
isFieldDelimiter() Verifica se questa cella rappresenta un delimitatore di campo.
Restituisce
{Boolean} True se la cella è un delimitatore di campo, altrimenti false.

Dimension

Rappresenta le dimensioni dello schermo o l'area dello schermo.

Metodo Descrizione
Dimension(rows,cols) Crea una nuova istanza Dimension.
Parametri
{Number} rows dimensione delle righe sullo schermo
{Number} cols dimensione delle colonne sullo schermo

Field

Utilizzare l'oggetto Field, insieme a FieldList, per ottenere le informazioni presenti in un campo sullo schermo.

Metodo Descrizione
getAttributes() Restituisce il set di attributi specificato per questa istanza del campo. Vedere AttributeSet.
Restituisce
{AttributeSet} Il set di attributi per questo campo.
getForegroundColor() Restituisce il colore in primo piano del campo.
Restituisce
{Number} Colore in primo piano per questo campo. Questi valori sono definiti nell'oggetto Color.
getBackgroundColor() Restituisce il colore dello sfondo del campo.
Restituisce
{Number} Colore di sfondo per questo campo. Questi valori sono definiti nell'oggetto Color.
getStart() Restituisce la posizione iniziale del campo. La posizione iniziale è la posizione del primo carattere del campo. Alcuni tipi di host utilizzano una posizione del carattere per memorizzare attributi a livello di campo. In questo caso la posizione dell'attributo non è considerata la posizione iniziale.
Restituisce
{Position} Posizione iniziale del campo.
Genera
{RangeError} Per campi con lunghezza pari a zero.
getEnd() Restituisce la posizione finale del campo. La posizione finale è la posizione nello spazio di presentazione che contiene l'ultimo carattere del campo.
Restituisce
{Position} Posizione finale del campo.
Genera
{RangeError} Per campi con lunghezza pari a zero.
getLength() Restituisce la lunghezza del campo. Per i tipi di host che utilizzano una posizione del carattere per memorizzare gli attributi del campo, la lunghezza del campo non include la posizione dell'attributo del campo
Restituisce
{Number} Lunghezza del campo.
getDataCells() Ottiene le celle dati che compongono questo campo. Vedere DataCell.
Restituisce
{DataCell[]} Le celle dati che compongono questo campo.
getText() Ottiene il testo dal campo.
Restituisce
{String} Il testo del campo.
setText() Imposta il testo del campo. Per alcuni tipi di host, ad esempio VT, il testo viene trasmesso immediatamente all'host, ma in altri tipi di host il testo non viene trasmesso all'host fino a quando viene richiamato il tasto AID. Se il testo è più breve del campo, viene inserito nel campo dell'host e il resto del campo viene cancellato. Se il testo è più lungo del campo dell'host, verrà inserito nel campo tutto il testo che può essere contenuto.
Parametro
{String} Testo da impostare nel campo.
Genera
{Error} Se il campo è protetto.
clearField() Cancella il campo corrente in modo specifico all'emulazione.
Genera
{Error} Se il campo è protetto o se la cancellazione non è supportata.
getPresentationSpace() Ottiene l'oggetto PresentationSpace che ha creato questo campo.
Restituisce
{PresentationSpace} Elemento superiore di questa istanza del campo.
toString() Crea una una descrizione del campo.
Restituisce
{String} Una conversione del campo leggibile dall'utente.

FieldList

Utilizzare l'oggetto FieldList, insieme all'oggetto Field, per ottenere informazioni sull'elenco dei campi.

Metodo Descrizione
getPresentationSpace() Ottiene l'oggetto PresentationSpace che ha creato questo campo.
Restituisce
{PresentationSpace} Elemento superiore di questa istanza del campo.
findField(position, text, direction) Restituisce il campo che contiene il testo specificato. La ricerca inizia nella posizione specificata e continua in avanti o indietro. Se una stringa comprende più campi, viene restituito il campo che contiene la posizione iniziale. Nella ricerca in avanti, la ricerca non andrà a capo all'inizio dello schermo. Nella ricerca all'indietro, la ricerca non andrà a capo alla fine dello schermo.
Parametri
{Position} Posizione dalla quale iniziare la ricerca. Vedere l'oggetto Position.
{String} Il testo da cercare (facoltativo). Se non fornito, restituisce il successivo campo a destra della posizione specificata o sotto di essa.
{Number} direzione della ricerca (facoltativo). Utilizzare PresentationSpace. Costanti SearchDirection per questo parametro. Ad esempio, PresentationSpace.SearchDirection.FORWARD o PresentationSpace.SearchDirection.BACKWARD. Se questo parametro non viene fornito, la ricerca è in avanti.
Restituisce
{Field} contenente la stringa o null se non viene trovato un campo che soddisfa i criteri specificati.
Genera
{RangeError} Se la posizione è al di fuori dell'intervallo.
get(index) Ottiene il campo all'indice specificato.
Parametri
{Number} Indice nell'elenco dei campi.
Restituisce
{Field} situato all'indice specificato.
Genera
{RangeError} Se l'indice è al di fuori dell'intervallo.
isEmpty() Determina se l'elenco dei campi è vuoto.
Restituisce
{Boolean} True se l'elenco è vuoto.
size() Indica il numero di campi nell'elenco.
Restituisce
{Number} Il numero di campi.
toString() Crea una una descrizione dell'elenco dei campi.
Restituisce
{String} Una conversione dell'elenco di campi leggibile dall'utente.

FileTransfer

Utilizzare l'oggetto FileTransfer per elencare e trasferire i file fra il sistema host e il client.

L'API di trasferimento dei file di Host Access for the Cloud astrae le convenzioni del percorso del file utilizzate dalle diverse implementazioni di file host. Seguire i formati dei percorsi URL o del file system Linux durante la formattazione dei percorsi di file utilizzati dall'API. Ad esempio, /root/directory/file.

È importante attenersi alle regole specifiche dei sistemi host, ad esempio i caratteri consentiti o la lunghezza dei nomi.

Nota

I browser impongono limitazioni di sicurezza considerevoli sulla possibilità di interazione di Javascript con i file system dei client.

Metodo Descrizione
getHostFileListing(remotePath)() Richiede un elenco di file host. Se viene omesso RemotePath, viene visualizzato un elenco di file per la directory di lavoro remota corrente.
Parametri
{String} (facoltativo) Se è specificato, si otterrà un elenco di file per il percorso remoto specificato. Se non è specificato, si otterrà un elenco di file per la directory di lavoro remota corrente.
Restituisce
{Promise} Si risolve in una matrice di oggetti HostFile contenuti in remoteName. Rifiutato se non è possibile leggere il percorso remoto.
sendFile(localFile, remoteName) Invia il file specificato all'host.
Parametri
{File} Oggetto file Javascript che punta al file locale da inviare.
{String} (facoltativo) Nome file remoto completo, come consentito dal sistema remoto (Unix, Windows, MVS, VAX).
Restituisce
{Promise} completato con un oggetto HostFile che rappresenta il file inviato correttamente. Rifiutato se si è verificato un errore nell'invio del file.
getDownloadURL(remoteName) Costruisce un collegamento per scaricare un file dal sistema host.
Parametri
{String} Nome file remoto completo, come consentito dal sistema remoto (Unix, Windows, MVS, VAX).
Restituisce
{URL} che può essere utilizzato per recuperare il file dal server di sessione di Host Access for the Cloud.
setTransferOptions(options) Imposta le opzioni di trasferimento per la sessione FileTransfer corrente. Le opzioni di trasferimento vengono applicate a tutti i trasferimenti futuri fino a quando la sessione viene chiusa o sostituita da un'altra chiamata a setTransferOptions.
Parametri
{JSON} vedere FileTransferOptions per i nomi e i valori consentiti.
Restituisce
{Promise} completata quando la chiamata viene completata. Rifiutato se si è verificato un errore nell'impostazione delle opzioni.
cancel() Annulla il trasferimento del file in corso.
Parametri
{String} Nome file remoto completo, come consentito dal sistema remoto (Unix, Windows, MVS, VAX).
Restituisce
{Promise} completata quando la chiamata viene completata. Rifiutata se si è verificato un errore nell'annullamento del trasferimento.

FileTransferFactory

Per tutte le macro è disponibile un oggetto fileTransferFactory. Se per la sessione sono configurati dei trasferimenti di file, è possibile usarlo per ottenere un riferimento all'oggetto FileTransfer.

Metodo Descrizione
getIND$File() Restituisce un oggetto FileTransfer per l'interazione con il tipo Ind$File configurato per la sessione.
Restituisce
{FileTransfer}
Genera
{Error} Se la sessione non è stata configurata per consentire i trasferimenti IND$File.

FileTransferOptions

Specifiche dell'oggetto opzioni di trasferimento file. Esempio:
`fileTransfer.setTransferOptions({ transferMethod : 'ascii' });```

Metodo Descrizione
transferMethod {String}Valori consentiti:
  • "ascii"
  • "binary"

HostFile

Un oggetto HostFile rappresenta un file nel file system host.

Metodo Descrizione
getName() Ottiene il nome del file.
Restituisce
{String} il nome del file.
getParent() Ottiene il padre di questo file host..
Restituisce
{String} l'elemento superiore di questo file host. Il risultato dipende dal tipo di host. Ad esempio in TST si tratta del nome del catalogo nel quale risiede il file.
getSize() Le dimensioni in byte del file.
Restituisce
{Number} le dimensioni del file in byte.
getType() Il tipo di file rappresentato.
Restituisce

HostFileType

L'oggetto HostFileType definisce le costanti per determinare il tipo di oggetto HostFile.

Valore Descrizione
FILE Rappresenta un file nel sistema host.
DIR Rappresenta una directory nel sistema host.
UNKNOWN Rappresenta un file host di origini sconosciute.

OIA

Interfaccia Operator Information Area (OIA). L'oggetto OIA restituisce i valori definiti nell'oggetto OIAStatus.

Metodo Descrizione
getStatus () Restituisce il set di flag di stato attivi. Vedere StatusSet.
Restituisce
{StatusSet} Contenente le informazioni sullo stato.
getCommErrorCode() Restituisce il codice di errore di comunicazione corrente.
Restituisce
{Number} il codice di errore di comunicazione corrente. Se non ne esiste uno, verrà restituito 0.
getProgErrorCode() Restituisce il codice di errore del programma corrente..
Restituisce
{Number} il codice di errore del programma corrente. Se non ne esiste uno, verrà restituito 0.

OIAStatus

OIAStatus Descrizione
CONTROLLER_READY Controller pronto
A_ONLINE Online con una connessione non SNA
MY_JOB Connesso a un'applicazione host
OP_SYS Connesso a un SSCP (SNA)
UNOWNED Non connesso
TIME Tastiera disattivata
SYS_LOCK Blocco sistema dopo tasto AID
COMM_CHECK Controllo comunicazione
PROG_CHECK Controllo programma
ELSEWHERE Sequenza di tasti non valida nella posizione del cursore.
FN_MINUS Funzione non disponibile
WHAT_KEY Sequenza di tasti non valida
MORE_THAN Troppi caratteri immessi nel campo
SYM_MINUS Immesso simbolo non disponibile
INPUT_ERROR Errore di input dell'operatore (solo 5250)
DO_NOT_ENTER Non immettere
INSERT Cursore in modalità inserimento
GR_CURSOR Cursore in modalità grafica
COMM_ERR_REM Promemoria errore di comunicazione
MSG_WAITING Indicatore di messaggio in attesa
ENCRYPT La sessione è crittografata
NUM_FIELD Carattere non valido in campo esclusivamente numerico

Position

Metodo Descrizione
Position(row,col) Crea una nuova istanza Position.
Parametri
{Number} row coordinata della riga sullo schermo
{Number} col coordinata della colonna sullo schermo

PresentationSpace

Utilizzare l'oggetto PresentationSpace per interagire con lo schermo del terminale. Le interazioni disponibili includono l'impostazione e l'ottenimento della posizione del cursore, l'invio di chiavi e la lettura del testo.

Metodo Descrizione
getCursorPosition() Restituisce un'istanza di Position che rappresenta la posizione corrente del cursore. In una sessione non connessa la posizione del cursore è 0,0.
Restituisce
{Position} posizione corrente del cursore
setCursorPosition(position) Sposta il cursore dell'host alla posizione specificata nella riga e nella colonna. Per alcuni host, ad esempio VT, l'host potrebbe limitare gli spostamenti del cursore.
Parametri
{Position} Position nuova posizione del cursore.
Restituisce
Nessun valore
Genera
{RangeError} Se la posizione non è valida sullo schermo corrente.
isCursorVisible() Verifica che il cursore sia attualmente visibile nello spazio di presentazione. Se la sessione non è connessa il cursore è considerato non visibile.
Restituisce
{Boolean} True se il cursore è visibile. False se il cursore non è visibile.
sendKeys(keys) Trasmette una stringa di testo o ControlKey all'host nella posizione corrente del cursore nello spazio di presentazione. Se il cursore non è nella posizione desiderata, utilizzare prima la funzione setCursorPosition.
La stringa di testo può contenere qualsiasi numero di caratteri e oggetti ControlKey.
Ad esempio: "myname" + ControlKey.TAB + "mypass" + ControlKey.ENTER trasmetterà un ID utente, il tasto Tab per passare al campo successivo, una password, quindi il tasto Invio.
Se è necessario trasmettere una parentesi quadra, raddoppiare le parentesi ([[ o ]]).
Parametri
{String} testo dei tasti e/o tasti di controllo da trasmettere
getText(start,length) Restituisce una stringa che rappresenta un'area lineare dello spazio di presentazione. Se vengono rilevati limiti di riga, non vengono inseriti caratteri di nuova riga.
Parametri
{Position} posizione iniziale dalla quale recuperare il testo
{Number}lunghezza del numero massimo di caratteri da restituire. Se il parametro della lunghezza causa il superamento dell'ultima posizione dello spazio di presentazione, verranno restituiti solo i caratteri fino all'ultima posizione.
Restituisce
{String) che rappresenta un'area lineare dello spazio di presentazione che potrebbe essere vuoto se la sessione non è connessa.
Genera
{RangeError} Se la posizione o la lunghezza non sono valide sullo schermo corrente.
getSize() Ottiene le dimensioni dello schermo come un oggetto Dimension.
Restituisce
{Dimension} Contenente il numero di righe e colonne. Le dimensioni dello schermo sono [row:0, col:0] se la sessione non è connessa.
getDataCells(start, length) Restituisce istanze di DataCell in cui il primo membro sarà la posizione specificata dal parametro start. Il numero massimo di istanze di DataCell nell'elenco è specificato dal parametro length.
Parametri
{Position} posizione iniziale sullo schermo dell'host in cui recuperare le istanze di DataCell. Vedere Position.
{Number} lunghezza del numero massimo di istanze di DataCell da recuperare. Se non è specificato, restituisce DataCell dalla posizione iniziale fino alla fine dello schermo.
Restituisce
{DataCell[]} Istanze che possono essere vuote se la sessione non è connessa. Se la posizione non è specificata, restituisce tutti i DataCell. Se la lunghezza non è specificata, restituisce i DataCell dalla posizione iniziale alla fine dello schermo.
Genera
{RangeError}se l'inizio o la lunghezza sono al di fuori dell'intervallo.
getFields() Restituisce un elenco di campi nello spazio di presentazione. Se il tipo di host non supporta i campi o lo schermo corrente non è formattato, il valore restituito sarà sempre un elenco vuoto. Vedere FieldList.
Restituisce
{FieldList} di campi definiti dall'host nello spazio di presentazione.

Session

L'oggetto Session è il punto di ingresso principale per l'interazione con l'host. Contiene funzioni per la connessione, la disconnessione e l'ottenimento dell'oggetto PresentationSpace.

Metodo Descrizione
connect() Connette all'host configurato. Se necessario, utilizzare wait.forConnect() per bloccare l'esecuzione della macro fino a quando non viene eseguita la connessione alla sessione.
Restituisce
Nessun valore
disconnect() Disconnette dall'host configurato. Se necessario, utilizzare wait.forDisconnect() per bloccare l'esecuzione della macro fino a quando la sessione è connessa.
Restituisce
Nessun valore
isConnected() Determina se la connessione all'host è stata stabilita.
Restituisce
{Boolean} true se la connessione all'host è stata stabilita; in caso contrario, false.
getPresentationSpace() Fornisce accesso all'istanza di PresentationSpace per questa sessione.
Restituisce
{PresentationSpace} istanza associata a questa sessione.
getDeviceName() Restituisce il nome del dispositivo per una sessione connessa oppure una stringa vuota se la sessione viene disconnessa o non dispone del nome del dispositivo.
Restituisce
{String} Il nome del dispositivo connesso.
getType() Restituisce il tipo di sessione host. Vedere SessionType.
Restituisce
{String} Il tipo di sessione host.
setDeviceName() Fornisce un modo per modificare il nome del dispositivo in un'istanza della sessione.
Parametri
{String} name Nome del dispositivo da utilizzare nella connessione a un host.
Genera
{Error}Se viene effettuato un tentativo di impostare il nome del dispositivo mentre la sessione è connessa.
getOIA() Fornisce accesso all'istanza di OIA per questa sessione.
Restituisce
{OIA} Associata alla sessione

SessionType

Costanti utilizzate per identificare il tipo di host con il quale viene stabilita la connessione. Vedere l'oggetto Session.

Tipo host Descrizione
IBM_3270 Indica una sessione di terminale IBM 3270
IBM_5250 Indica una sessione di terminale IBM 5250
VT Indica una sessione VT

StatusSet

È possibile utilizzare l'oggetto StatusSet per codificare lo stato di OIA. L'oggetto StatusSet restituisce i valori definiti nell'oggetto OIAStatus e, quando utilizzati insieme, è possibile ottenere informazioni sullo stato da OIA.

Metodo Descrizione
contains(statusFlag) Determina se il set contiene il flag di stato specificato dalle costanti OIAStatus.
Parametri
{Number} statusFlag di stato da controllare
Restituisce
{Boolean}True se il flag di stato è presente nel set.
isEmpty() Determina se il set di stati è vuoto.
Restituisce
{Boolean}True se il set è vuoto.
size() Indica il numero di flag di stato nel set.
Restituisce
{Number} Il numero di stati.
toArray() Converte il set di stati interno in una matrice.
Restituisce
{Object []} Matrice di flag di stato nel set.
toString() Converte il set di stati interno in una stringa.
Restituisce
{String} Nomi delimitati da spazi dei flag di stato nel set.
forEach(callback, thisArg) Funzione per reiterare ogni elemento nel set di stati.
Parametri
{forEachCallback} Richiamata per eseguire l'operazione specifica. Chiamato con il nome di ogni stato nel set.
forEachCallback(string, thisArg) Una funzione di richiamata fornita dall'utente in cui specificare il comportamento, da usare come parametro di richiamata per forEach.
Parametri
{String} String Il nome dello stato nel set di stati.
{Object} thisArg Puntatore facoltativo a un oggetto di contesto.

Interfaccia utente

L'oggetto User Interface fornisce le funzioni per l'interazione con l'utente, la richiesta di informazioni e la visualizzazione di informazioni di base. L'oggetto UI è reso disponibile automaticamente nella macro come variabile "ui".

Nota

Importante: tutte le funzioni dell'interfaccia utente devono essere precedute dalla parola chiave "yield". Questo consente alla macro di bloccare l'esecuzione fino a quando sono soddisfatte le condizioni della funzione UI.
[parameter] denota un parametro facoltativo.

Metodo Descrizione
prompt(message,[defaultAnswer], [mask]) Richiede all'utente di inserire informazioni nell'interfaccia utente.
Parametri
{String} titolo del messaggio da visualizzare all'utente. Impostazione di default: stringa vuota.
{String} defaultRisposta da utilizzare se l'utente non inserisce l'informazione richiesta. Impostazione di default: stringa vuota
{Boolean} la maschera indica se nascondere il prompt (come con la password)
Restituisce
{Promise} Completata quando l'utente chiude la finestra di dialogo. Restituisce l'input dell'utente quando sceglie "OK", null quando sceglie "Annulla".
message([message]) Visualizza un messaggio nell'interfaccia utente.
Parametri
{String} messaggio da visualizzare all'utente. Impostazione di default: stringa vuota.
Restituisce
{Promise} Completata quando l'utente chiude la finestra del messaggio.

Wait

Utilizzare l'oggetto Wait per attendere un particolare stato di una sessione o di uno schermo. Ad esempio, è possibile attendere che il cursore si trovi in una determinata posizione o che in una certa posizione sia presente il testo sia presente un testo prima di continuare l'esecuzione della macro.

Le funzioni Wait sono spesso utilizzare insieme alle funzioni asincrone quali connect() e sendKeys().

Nota

Tutte le funzioni accettano i timeout come parametro facoltativo e hanno un valore di timeout di default di 10 secondi (10000 ms).
Importante: tutte le funzioni Wait devono essere precedute dalla parola chiave "yield". Questo consente alla macro di bloccare l'esecuzione fino a quando sono soddisfatte le condizioni della funzione Wait.
[parameter] denota un parametro facoltativo.

Metodo Descrizione
setDefaultTimeout(timeout) Imposta il valore di timeout di default per tutte le funzioni.
Parametri
{Number} timeout di default da utilizzare per tutte le funzioni Wait in millisecondi.
Restituisce
{None}
Genera
{RangeError} Se il timeout specificato è minore di zero.
forConnect([timeout]) Attende il completamento di una richiesta di connessione.
Parametri
{Number} in millisecondi.
Restituisce
{Promise} Completata se la sessione è già connessa o quando si verifica la connessione. Rifiutata in caso di timeout.
forDisconnect([timeout]) Attende il completamento di una richiesta di disconnessione.
Parametri
{Number} timeout in millisecondi.
Restituisce
{Promise} Completata se la sessione è già disconnessa o quando si verifica la disconnessione. Rifiutata in caso di timeout.
forFixedTime([timeout]) Attende incondizionatamente per il tempo stabilito. Il tempo è stabilito in millisecondi (ms).
Parametri
{Number} timeout in millisecondi.
Restituisce
{Promise} Completata quando il tempo scade.
forScreenChange([timeout]) Attende la modifica della schermata host. Questa funzione restituisce il risultato quando viene rilevato un aggiornamento di schermata. Non fornisce alcuna garanzia in merito al numero di aggiornamenti successivi che possono essere ricevuti prima che la schermata venga completata. Si consiglia di prolungare l'attesa finché il contenuto della schermata soddisfi determinati criteri di interruzione noti.)
Parametri
{Number} timeout in millisecondi.
Restituisce
{Promise} Risolto se lo schermo cambia. Rifiutata in caso di timeout.
forCursor(position, [timeout]) Attende che il cursore arrivi alla posizione specificata.
Parametri
{Position} La posizione che specifica la riga e la colonna
Restituisce
{Promise} Completata se il cursore è già posizionato o quando ha raggiunto la posizione. Rifiutata in caso di timeout.
forText(text, position, [timeout]) Attende che il testo si trovi in una posizione specifica sullo schermo
Parametri
{String} testo previsto
{Position} posizione che specifica la riga e la colonna
{Number} timeout in millisecondi
Restituisce
{Promise} Completata se il testo è già nella posizione specificata o quando ha raggiunto la posizione. Rifiutata in caso di timeout.
Genera
{RangeError} se la posizione non è valida.
forHostPrompt(text, column,[timeout]) Attende un prompt dei comandi posizionato in una colonna specifica sullo schermo.
Parametri
{String} prompt di testo previsto
{Number} colonna in cui è previsto il cursore
{Number} timeout in millisecondi.
Restituisce
{Promise} Completata se le condizioni sono già soddisfatte o quando vengono soddisfatte. Rifiutata in caso di timeout.
Genera
{RangeError} se la colonna è al di fuori dell'intervallo.
forHostSettle([settleTime],[timeout]) NOTA: wait.forHostSettle deve essere utilizzato solo se altre funzioni di attesa più mirate risultano insufficienti.
Controlla i dati dello schermo in entrata e risolve settleTime ms dopo l'ultimo aggiornamento e lo sblocco della tastiera. Questa funzione è utile quando i dati arrivano in più pacchetti e si desidera essere certi che sia stato ricevuto l'intero schermo prima di procedere.
Parametri
{Number} tempo di attesa dopo l'ultimo aggiornamento per essere certi che non vengano ricevuti altri dati in modo imprevisto. Il default è 200 millisecondi.
{Number} timeout in millisecondi.
Restituisce
{Promise}Completata quando il tempo di risoluzione è scaduto dopo la ricezione dell'ultimo aggiornamento dello schermo e lo sblocco della tastiera.