Pular para conteúdo

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

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.

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.

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.