🗂️ IEHLIST

📌 Explicação

O IEHLIST é um utilitário que lista o conteúdo de volumes e bibliotecas particionadas (PDS). Ele mostra:

• Nome dos datasets de um volume (VOL=SER)

• Membros de um PDS

• Informações de controle (data de criação, organização, tamanho, etc.)

Não copia, não altera, só lista — mas isso já ajuda muito na manutenção e diagnóstico.

🧰 Usos mais comuns

• Ver o conteúdo de um volume físico (DISK/FITA)

• Listar os membros de uma biblioteca PDS

• Auditar datasets (nome, tamanho, tipo, data)

• Identificar problemas de catalogação ou acesso

🧾 Sintaxe básica

//LISTAR  JOB (1234),'COBOL DICAS',
//            CLASS=A,MSGCLASS=X
//*
//STEP01 EXEC PGM=IEHLIST
//SYSPRINT DD SYSOUT=*
//DD1      DD VOL=SER=WORK01,UNIT=SYSDA,DISP=OLD
//SYSIN    DD *
  LISTVTOC FORMAT,VOL=SER=WORK01
/*

📂 Descrição dos DDs

• SYSPRINT → onde será impresso o resultado (saída do relatório)

• DD1 → usado para acessar o volume com o VOL=SER=

• SYSIN → comandos de controle do IEHLIST

💻 Exemplo prático: listar conteúdo de um volume

//LISTAR EXEC PGM=IEHLIST
//SYSPRINT DD SYSOUT=*
//DD1      DD VOL=SER=WORK01,UNIT=SYSDA,DISP=OLD
//SYSIN    DD *
  LISTVTOC FORMAT,VOL=SER=WORK01
/*

Esse exemplo vai listar todos os datasets do volume WORK01, mostrando nome, tamanho, tipo, data de criação etc.

💻 Exemplo prático: listar membros de um PDS

//LISTPDS EXEC PGM=IEHLIST
//SYSPRINT DD SYSOUT=*
//PDS      DD DSN=CDICAS.FONTE.COBOL,DISP=SHR
//SYSIN    DD *
  LISTDS NAME=CDICAS.FONTE.COBOL,MEMBERS
/*

Esse aqui mostra todos os membros dentro da biblioteca CDICAS.FONTE.COBOL.

⚙️ Regras

• LISTVTOC exige VOL=SER= com DISP=OLD

• LISTDS exige o nome do dataset e o parâmetro MEMBERS se for PDS

• O DD com VOL=SER ou DSN= deve estar corretamente acessível

💡 Dicas

• Use IEHLIST pra descobrir em que volume um dataset não catalogado está.

• Excelente ferramenta pra auditoria e suporte, sem risco de alteração de dados.

• Em ambientes com múltiplos volumes físicos, o LISTVTOC é essencial pra controle.

✅ Conclusão

IEHLIST é o detetive do JCL. Ele não move, não cria, não deleta — só investiga. E faz isso muito bem. Se você quer entender o que tem num volume ou dentro de uma biblioteca PDS, esse é o utilitário certo. Ideal pra quem trabalha com manutenção e diagnóstico.