Detalhes

Publicado: 09 de novembro de 2025

Para quem usa Debian (como você) ou Ubuntu, rodar o TK5 no Linux costuma ser até mais estável do que no Windows.
Vamos usar o pacote do site: https://www.prince-webdesign.nl/tk5

A diferença aqui é que no Linux a gente costuma baixar o pacote, extrair para uma pasta no home e rodar o Hercules direto pelo terminal.

⚙️ Pré-requisitos

• Debian 11/12 ou Ubuntu 22+
• Usuário com sudo
• 5 a 10 GB livres
• Terminal 3270 instalado (x3270, c3270 ou até o pw3270 do Linux)

🟩 Passo a passo

1. Instalar dependências básicas

sudo apt update
sudo apt install wget unzip x3270 -y

Se o pacote exigir Hercules compilado, dá pra instalar o Hercules do repositório também:

sudo apt install hercules

Mas como o TK5 costuma vir com binário/exec pronto, muitas vezes nem precisa.

2. Baixar o TK5

cd ~/Downloads
wget https://www.prince-webdesign.nl/tk5/tk5.zip

Se o nome do arquivo for diferente no site (ex.: tk5-xx.zip), é só ajustar o nome no wget.

3. Extrair o pacote

unzip tk5.zip -d ~/hercules-tk5

Agora você terá:

~/hercules-tk5/
 ├── hercules
 ├── conf/
 ├── dasd/
 ├── jcl/
 └── ...

4. Rodar o Hercules

Entre na pasta e rode:

cd ~/hercules-tk5
./hercules -f conf/tk5.cnf

Como no Windows: se o arquivo de configuração tiver outro nome, ajuste:

./hercules -f tk5.cnf

O console deve mostrar o IPL do MVS.

5. Conectar no MVS via 3270

Abra outro terminal e rode:

x3270 127.0.0.1:3270

Ou, se você estiver usando pw3270 no Linux:

pw3270 127.0.0.1:3270

Login (padrão dos pacotes TK5):

User: HERC01
Password: CUL8TR

6. Script de inicialização (Linux)

Pra não ter que ficar rodando tudo na mão, crie um script:

nano ~/start_tk5.sh

Cole:

#!/bin/bash
cd ~/hercules-tk5
gnome-terminal -- ./hercules -f conf/tk5.cnf &
sleep 5
x3270 127.0.0.1:3270 &

Salvar e sair. Depois:

chmod +x ~/start_tk5.sh
./start_tk5.sh

Se estiver em Debian sem gnome-terminal, pode trocar por xfce4-terminal ou até rodar no mesmo terminal.

💡 Dicas importantes (Linux)

• Permissão: se o binário vier sem permissão:

chmod +x hercules

• Porta ocupada: se a 3270 estiver sendo usada, altere no conf/tk5.cnf a porta ou derrube o serviço que estiver usando.
• Fechamento correto:
  • No 3270: logoff
  • No console Hercules: quit

🏁 Conclusão

Com esse setup, você consegue:

• TK5 rodando no Debian
• Conexão PW3270 / x3270
• Execução de JCL
• Criação de dataset
• E até simular integração com o VS Code rodando COBOL na máquina e JCL no TK5.

Base 100% no link novo: https://www.prince-webdesign.nl/tk5