Comandos do X3270
Entrada e Controle
Abort - Aborta scripts e macros pendentes
Abort - Aborta scripts e macros pendentes
Descrição: Aborta scripts e macros pendentes.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.abort()
Observações: Útil para interromper operações em execução.
Attn - Atenção
Attn - Atenção
Descrição: Envia a sequência ATTN do 3270, equivalente ao comando TELNET IP. Usado para interromper certas operações no mainframe.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.attn()
Observações: Interrompe processos ou comandos no host.
Backspace - Voltar cursor uma posição
Backspace - Voltar cursor uma posição
Descrição: Move o cursor uma posição para a esquerda (sem apagar o caractere).
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.backspace()
Observações: Cursor apenas se move, não apaga.
Backtab - Voltar para campo anterior
Backtab - Voltar para campo anterior
Descrição: Move o cursor para o campo anterior no formulário.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.backtab()
Observações: Útil para navegação em formulários.
Bell - Toca sino
Bell - Toca sino
Descrição: Toca o sino do terminal para alertar o usuário.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.bell()
Observações: Pode ser ignorado se terminal não suportar.
CircumNot - Envia ~ ou ¬
CircumNot - Envia ~ ou ¬
Descrição: Envia o caractere ~ em modo NVT (terminal padrão) ou ¬ em modo 3270.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.circumnot()
Observações: Usado em ambientes específicos de terminal.
Clear - Limpa tela
Clear - Limpa tela
Descrição: Envia o comando CLEAR para limpar a tela no terminal 3270.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.clear()
Observações: Reseta a tela para estado inicial.
Close - Fecha conexão
Close - Fecha conexão
Descrição: Alias para disconnect, fecha a conexão com o host.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.close()
Observações: Encerramento limpo da sessão.
Closescript - Encerra script em execução
Closescript - Encerra script em execução
Descrição: Encerra o script em execução no terminal.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.closescript()
Observações: Útil para abortar scripts longos ou travados.
Compose - Interpreta próximas teclas
Compose - Interpreta próximas teclas
Descrição: Interpreta as próximas duas teclas conforme o mapa de composição.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.compose()
Observações: Usado para entrada de caracteres especiais.
Connect - Conecta ao host
Connect - Conecta ao host
Descrição: Estabelece conexão com o host mainframe.
Exemplo:
emulator = X3270()
from x3270 import x3270
emulator = x3270(visible=True)
emulator.connect(host='mainframe.example.com')
Observações: Essencial para iniciar sessões.
CursorSelect - Seleciona local do cursor (light pen)
CursorSelect - Seleciona local do cursor (light pen)
Descrição: Emula o clique com a caneta luminosa no local atual do cursor.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.cursorselect()
Observações: Pouco usado atualmente.
Delete - Apaga caractere na posição do cursor
Delete - Apaga caractere na posição do cursor
Descrição: Apaga o caractere na posição atual do cursor.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.delete()
Observações: Útil para edição de campos.
DeleteField - Apaga conteúdo do campo atual
DeleteField - Apaga conteúdo do campo atual
Descrição: Apaga todo o conteúdo do campo em que o cursor está.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.deletefield()
Observações: Limpa campo para nova entrada.
DeleteWord - Apaga palavra anterior ao cursor
DeleteWord - Apaga palavra anterior ao cursor
Descrição: Apaga a palavra antes da posição atual do cursor.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.deleteword()
Observações: Atalho útil para edição rápida.
Disconnect - Fecha conexão com host
Disconnect - Fecha conexão com host
Descrição: Fecha a conexão ativa com o host mainframe.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.disconnect()
Observações: Fecha sessão atual.
Erase - Backspace destrutivo
Erase - Backspace destrutivo
Descrição: Apaga o caractere anterior ao cursor (backspace destrutivo).
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.erase()
Observações: Apaga caractere e move cursor.
EraseEOF - Apaga até o fim do campo
EraseEOF - Apaga até o fim do campo
Descrição: Apaga do cursor até o final do campo.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.eraseeof()
Observações: Apaga grandes blocos de texto.
EraseInput - Apaga todos campos de entrada
EraseInput - Apaga todos campos de entrada
Descrição: Apaga todos os campos de entrada da tela.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.eraseinput()
Observações: Útil para limpar formulários inteiros.
Execute - Executa comando no shell
Execute - Executa comando no shell
Descrição: Executa um comando no shell do sistema.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.execute('dir')
Observações: Apenas para comandos do sistema local.
Enter - Envia comando ENTER
Enter - Envia comando ENTER
Descrição: Envia o comando ENTER para o terminal 3270.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.enter()
Observações: Confirma formulário ou comando.
Escape - Abre prompt c3270
Escape - Abre prompt c3270
Descrição: Abre prompt c3270 para comandos manuais.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.escape()
Observações: Útil para diagnóstico.
FieldEnd - Move cursor ao fim do campo
FieldEnd - Move cursor ao fim do campo
Descrição: Move o cursor para o final do campo atual.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.fieldend()
Observações: Facilita edição rápida.
FieldMark - Envia tecla FIELD MARK
FieldMark - Envia tecla FIELD MARK
Descrição: Envia a tecla FIELD MARK (marca visual usada em terminais 3270).
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.fieldmark()
Observações: Usado para delimitar campos.
Flip - Inverte tela (espelho)
Flip - Inverte tela (espelho)
Descrição: Inverte a tela da direita para a esquerda.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.flip()
Observações: Usado para teste de exibição.
Help - Exibe ajuda
Help - Exibe ajuda
Descrição: Exibe ajuda para um tópico.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.help('enter')
Observações: Ajuda interativa.
HexString - Envia dados hexadecimais
HexString - Envia dados hexadecimais
Descrição: Envia sequência de dados codificados em hexadecimal diretamente para o campo.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.hexstring('7F8A9B')
Observações: Útil para comandos avançados.
Home - Move cursor para início
Home - Move cursor para início
Descrição: Move o cursor para o primeiro campo da tela.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.home()
Observações: Rápido retorno ao início.
Ignore - Não faz nada
Ignore - Não faz nada
Descrição: Não faz nada. Pode ser usado para desabilitar uma tecla.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.ignore()
Observações: Útil para scripts condicionalmente desabilitarem ações.
Insert - Ativa modo inserção
Insert - Ativa modo inserção
Descrição: Ativa o modo de inserção do terminal 3270.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.insert()
Observações: Modo inserção insere caracteres ao invés de sobrescrever.
Interrupt - Envia comando TELNET IAC IP
Interrupt - Envia comando TELNET IAC IP
Descrição: Envia o comando TELNET IAC IP para interrupção (modo NVT).
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.interrupt()
Observações: Para interrupções rápidas no host.
Key - Envia caractere específico
Key - Envia caractere específico
Descrição: Envia um caractere específico, por nome ou valor hexadecimal.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.key('0x41')
Observações: Útil para envio direto de caracteres.
KeyboardDisable - Modifica bloqueio automático
KeyboardDisable - Modifica bloqueio automático
Descrição: Modifica o bloqueio automático do teclado.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.keyboarddisable(True)
Observações: Controle avançado do teclado.
Keymap - Ativa keymap temporário
Keymap - Ativa keymap temporário
Descrição: Ativa um keymap temporário para mapeamento de teclas.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.keymap('custommap')
Observações: Útil para teclas customizadas.
Keypad - Mostra teclado 3270
Keypad - Mostra teclado 3270
Descrição: Mostra o teclado virtual 3270 na tela (somente funciona para Windows).
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.keypad()
Observações: Facilita interação via mouse.
Left - Move cursor 1 coluna à esquerda
Left - Move cursor 1 coluna à esquerda
Descrição: Move o cursor uma coluna para a esquerda.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.left()
Observações: Navegação simples.
Left2 - Move cursor 2 colunas à esquerda
Left2 - Move cursor 2 colunas à esquerda
Descrição: Move o cursor duas colunas para a esquerda.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.left2()
Observações: Navegação rápida.
Macro - Executa macro definido
Macro - Executa macro definido
Descrição: Executa um macro previamente definido.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.macro('login_sequence')
Observações: Automatiza sequências de comandos.
Menu - Exibe menu de comandos
Menu - Exibe menu de comandos
Descrição: Exibe o menu de comandos do terminal (somente funciona para Windows).
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.menu()
Observações: Navegação via menu.
Movecursor - Move cursor linha e coluna (origem 0)
Movecursor - Move cursor linha e coluna (origem 0)
Descrição: Move o cursor para linha e coluna específicas (origem 0).
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.movecursor(5, 10)
Observações: Útil para posicionamento preciso.
Movecursor1 - Move cursor linha e coluna (origem 1)
Movecursor1 - Move cursor linha e coluna (origem 1)
Descrição: Move o cursor para linha e coluna específicas (origem 1).
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.movecursor1(1, 1)
Observações: Base 1, diferente do padrão Python.
Movecursoroffset - Move cursor por offset
Movecursoroffset - Move cursor por offset
Descrição: Move o cursor para uma posição de offset na memória da tela.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.movecursoroffset(100)
Observações: Uso avançado para controle interno.
Newline - Move cursor para próxima linha
Newline - Move cursor para próxima linha
Descrição: Move o cursor para o primeiro campo da próxima linha.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.newline()
Observações: Facilita inserção em múltiplas linhas.
Nextword - Move cursor para próxima palavra
Nextword - Move cursor para próxima palavra
Descrição: Move o cursor para a próxima palavra.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.nextword()
Observações: Navegação rápida.
Previousword - Move cursor para palavra anterior
Previousword - Move cursor para palavra anterior
Descrição: Move o cursor para a palavra anterior.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.previousword()
Observações: Navegação rápida.
Pause - Espera 350ms
Pause - Espera 350ms
Descrição: Aguarda por 350 milissegundos.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.pause()
Observações: Usado para esperar respostas lentas do host.
Prompt - Abre prompt externo
Prompt - Abre prompt externo
Descrição: Abre prompt externo com nome da aplicação.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.prompt('diagnostic')
Observações: Diagnóstico avançado.
Quit - Sai do terminal
Quit - Sai do terminal
Descrição: Sai do terminal 3270.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.quit()
Observações: Finaliza a sessão.
Set - Altera ou exibe configurações
Set - Altera ou exibe configurações
Descrição: Altera ou exibe configurações do terminal.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.set()
Observações: Configurações avançadas.
- acceptHostname:
- aidWait: true
- altCursor: false
- alwaysInsert: false
- bindLimit: true
- blankFill: true
- clientCert:
- codePage: bracket
- crosshair: false
- cursorBlink: false
- ftBufferSize: 16384
- httpd:
- insertMode: false
- lineMode: true
- lineWrap: false
- loginMacro:
- marginedPaste: false
- model: 3279-4-E
- monoCase: false
- noTelnetInputMode: line
- nopSeconds: 0
- oerrLock: true
- overlayPaste: true
- oversize:
- preferIpv4: false
- preferIpv6: false
- printer.codepage:
- printer.name:
- printer.options:
- printerLu:
- proxy:
- reconnect: false
- retry: false
- reverseInputMode: false
- rightToLeftMode: false
- saveLines: 4096
- screenTrace: false
- scriptPort:
- selectUrl: true
- showTiming: false
- startTls: true
- termName:
- trace: false
- typeahead: true
- underscore: true
- unlockDelay: false
- unlockDelayMs: 350
- verifyHostCert: true
- visibleControl: false
Show - Exibe status e configurações
Show - Exibe status e configurações
Descrição: Exibe status e configurações do terminal.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.show()
Observações: Útil para diagnóstico.
String - Envia texto
String - Envia texto
Descrição: Envia uma string diretamente para o campo atual.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.string('Olá mundo')
Observações: Entrada direta de texto.
Temporarycomposemap - Define mapa de composição temporário
Temporarycomposemap - Define mapa de composição temporário
Descrição: Define um mapa temporário de composição para teclas.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.temporarycomposemap('custommap')
Observações: Mapeamento temporário para caracteres.
Temporarykeymap - Alias para Keymap
Temporarykeymap - Alias para Keymap
Descrição: Alias para ativar keymap temporário.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.temporarykeymap('custommap')
Observações: Uso temporário de keymaps.
Toggle - Alterna configuração
Toggle - Alterna configuração
Descrição: Alterna uma configuração específica para ligado/desligado.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.toggle('insert_mode', 'off')
Observações: Ativa ou desativa opções.
Toggleinsert - Ativa/desativa modo inserção
Toggleinsert - Ativa/desativa modo inserção
Descrição: Alterna o modo inserção ligado/desligado.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.toggleinsert()
Observações: Ativa modo inserção alternado.
Togglereverse - Ativa/desativa modo reverso
Togglereverse - Ativa/desativa modo reverso
Descrição: Alterna o modo reverso de entrada.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.togglereverse()
Observações: Alterna modo reverso.
Transfer - Transferência de arquivos IND$FILE
Transfer - Transferência de arquivos IND$FILE
Descrição: Transferência de arquivos via IND$FILE entre host e cliente.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.transfer('receive file.txt')
Observações: Requer configuração no host.
Up - Move cursor para cima
Up - Move cursor para cima
Descrição: Move o cursor para a linha acima.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.up()
Observações: Navegação vertical.
Wait - Aguarda eventos do host
Wait - Aguarda eventos do host
Descrição: Aguarda por eventos do host, com parâmetros flexíveis.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
# Espera até a sessão estar em modo 3270
emulator.wait('3270mode')
# Espera até um campo de entrada estar disponível
emulator.wait('inputfield')
# Espera até mudar para modo NVT (TELNET puro)
emulator.wait('nvtmode')
# Espera até não haver mais dados pendentes de saída
emulator.wait('output')
# Espera até o teclado desbloquear
emulator.wait('unlock')
# Espera por 3 segundos
emulator.wait(3, 'seconds')
# Aguarda até ser desconectado
emulator.wait('disconnect')
# Aguarda o cursor estar na linha 5, coluna 10
emulator.wait('cursorat', row=5, col=10)
# Aguarda a string "READY" aparecer na linha 1, coluna 1
emulator.wait('stringat', row=1, col=1, string='READY')
# Aguarda até existir um campo de entrada na linha 6, coluna 20
emulator.wait('inputfieldat', row=6, col=20)
Observações: Pode aguardar eventos ou tempo.
| Parâmetro | Descrição |
|---|---|
inputfield |
Aguarda até um campo de entrada estar disponível. |
nvtmode |
Aguarda até entrar em modo NVT (modo TELNET puro). |
3270mode |
Aguarda até entrar em modo 3270 (sessão estabelecida). |
output |
Aguarda até não haver mais dados pendentes de saída. |
seconds |
Aguarda um número de segundos. |
disconnect |
Aguarda até a sessão ser desconectada. |
unlock |
Aguarda o teclado ficar desbloqueado. |
cursorat |
Aguarda o cursor estar em uma posição específica. |
stringat |
Aguarda uma string aparecer em uma posição específica. |
inputfieldat |
Aguarda um campo de entrada em uma posição específica. |
Navegação com o Cursor
Down - Move cursor para baixo
Down - Move cursor para baixo
Descrição: Move o cursor para a linha de baixo.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.down()
Observações: Navegação vertical simples.
Left - Move cursor para esquerda
Left - Move cursor para esquerda
Descrição: Move o cursor uma coluna para a esquerda.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.left()
Observações: Navegação horizontal.
Left2 - Move cursor 2 colunas para esquerda
Left2 - Move cursor 2 colunas para esquerda
Descrição: Move o cursor duas colunas para a esquerda.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.left2()
Observações: Movimento mais rápido para a esquerda.
Right - Move cursor para direita
Right - Move cursor para direita
Descrição: Move o cursor uma coluna para a direita.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.right()
Observações: Navegação horizontal.
Right2 - Move cursor 2 colunas para direita
Right2 - Move cursor 2 colunas para direita
Descrição: Move o cursor duas colunas para a direita.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.right2()
Observações: Movimento mais rápido para a direita.
Up - Move cursor para cima
Up - Move cursor para cima
Descrição: Move o cursor para a linha de cima.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.up()
Observações: Navegação vertical simples.
Tab - Move cursor para próximo campo
Tab - Move cursor para próximo campo
Descrição: Move o cursor para o próximo campo de entrada.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.tab()
Observações: Navegação entre campos.
Newline - Move cursor para próximo campo da linha seguinte
Newline - Move cursor para próximo campo da linha seguinte
Descrição: Move o cursor para o primeiro campo da próxima linha.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.newline()
Observações: Navegação vertical e horizontal combinada.
Nextword - Move cursor para próxima palavra
Nextword - Move cursor para próxima palavra
Descrição: Move o cursor para a próxima palavra.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.nextword()
Observações: Navegação rápida em texto.
Previousword - Move cursor para palavra anterior
Previousword - Move cursor para palavra anterior
Descrição: Move o cursor para a palavra anterior.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.previousword()
Observações: Navegação rápida em texto.
Comandos Específicos de Mainframe
PA - Atenção de Programa
PA - Atenção de Programa
Descrição: Envia a tecla de atenção de programa PA1, PA2, etc.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.PA(2) # envia PA2
Observações: Usado por aplicações específicas mainframe.
PF - Função Programada
PF - Função Programada
Descrição: Envia tecla de função PF1 a PF24, equivalente às teclas F1-F24.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.pf(12) # envia PF12
Observações: Comandos padrão em terminais 3270.
Printer - Impressora 3287 iniciar/parar
Printer - Impressora 3287 iniciar/parar
Descrição: Inicia ou para uma sessão de impressão associada a uma LU (Logical Unit).
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.printer(stop=True)
Observações: Requer configuração de LU no host.
SysReq - Requisição de sistema
SysReq - Requisição de sistema
Descrição: Envia a tecla System Request (SysReq), usada para alternar sessões LU ou invocar menus no host.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.sysreq()
Observações: Comando especial mainframe.
Utilitários
Paste - Colar
Paste - Colar
Descrição: Cola o conteúdo do clipboard no terminal.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.paste()
Observações: Requer permissão de acesso ao clipboard.
Redraw - Redesenhar
Redraw - Redesenhar
Descrição: Atualiza (força a reexibição) da tela do terminal.
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.redraw()
Observações: Útil quando a tela está corrompida.
Reset - Resetar teclado travado
Reset - Resetar teclado travado
Descrição: Libera o teclado se estiver travado (como na mensagem "X SYSTEM").
Exemplo:
from x3270 import x3270
emulator = x3270(visible=True)
# Conecta ao host mainframe na porta 992 (TLS)
emulator.connect_host('myhost.example.com', '992')
emulator.reset()
Observações: Resolve travamentos temporários.
Tipos de campos MAINFRAME
| SF | Hex equivalente | Significado |
|---|---|---|
| SF(c0=e8) | 1D E8 |
Campo protegido, editável, MDT ativo |
| SF(c0=e0) | 1D E0 |
Campo protegido, MDT desativado |
| SF(c0=f0) | 1D F0 |
Campo editável, MDT ativo |
| SF(c0=40) | 1D 40 |
Intensificado (brilhante) |
| SF(c0=80) | 1D 80 |
Campo protegido (não editável) |
| SF(c0=20) | 1D 20 |
Sublinhado |
| SF(c0=10) | 1D 10 |
MDT ativo (Modified Data Tag) |
| SF(c0=08) | 1D 08 |
Campo gráfico |
Obs.: Algumas telas são construidas enviando comandos que não são capturados utilizando o readbuffer do x3270, logo elas são reproduzidas com diferenças.