SETVER
Exibe a tabela de versões. Informa um número de versão (anterior á 6.0) a programas ou controladores de dispositivo que foram criados para versões anteriores do MS-DOS.
Este comando também pode ser usado para exibir e modificar a tabela de versão, que lista nomes de programas e o número da versão do MS-DOS com a qual foram projetados para trabalhar. Se o programa utilizado não estiver atualizado para o MS-DOS, você poderá incluir seu nome na tabela de versão usando o comando SETVER.
Sintaxe :
SETVER [unidade:caminho][nome-de-arquivo n.nn]
SETVER [unidade:caminho][nome-de-arquivo [/DELETE [/QUIET]]
Para exibir a tabela de versão atual, use a seguinte sintaxe:
SETVER [unidade:caminho]
O MS-DOS exibe duas colunas: a primeira (esquerda) lista os nomes dos arquivos de programa; a segunda (direita), a versão correspondente do MS-DOS com a qual cada arquivo foi projetado para ser executado.
Parâmetros :
[unidade:caminho]
Especifica a localização do arquivo SETVER.EXE.
nome-de-arquivo
Especifica o nome do arquivo de programa (geralmente arquivo .EXE ou .COM) que você deseja incluir na tabela de versão. Não são permitidos caracteres curinga (* ou ?).
n.nn
Especifica a versão do MS-DOS (ex: 3.3 ou 4.01) que o MS-DOS 6 informa ao arquivo de programa especificado.
Opções :
/DELETE
Exclui a entrada da tabela de versão para o arquivo de programa especificado. Esta opção pode ser abreviada como /D.
/QUIET
Oculta a mensagem tipicamente exibida durante a exclusão de uma entrada da tabela de versão.
Comando Relacionado :
Para obter informações sobre como carregar a tabela de versão no MS-DOS, consulte o comando <SETVER.EXE>.
Observações :
Confirmação de SETVER
Se forem executadas alterações na tabela de versão e não forem encontrados erros, o MS-DOS exibe a seguinte mensagem:
Tabela de versão atualizada com sucesso.
A mudança de versão terá efeito da próxima vez que o sistema for reinicializado.
Carregando a tabela de versão na memória :
Antes de usar o comando SETVER, a tabela de versão deve ser carregada na memória com um comando <DEVICE> no arquivo CONFIG.SYS. Como padrão, o programa de Instalação do MS-DOS modifica o arquivo CONFIG.SYS para garantir que a tabela de versão seja carregada na memória todas as vezes que o sistema for iniciado.
Definindo o número da versão de um interpretador de comandos
É possível usar o SETVER para definir o número da versão de um interpretador de comandos; porém, se for definido o número de versão do interpretados de comandos do MS-DOS 6.22 (COMMAND.COM), isso poder impossibilitar a inicialização do sistema.
Usando a tabela de versão :
Muitos programas criados para serem executados com uma versao anterior do MS-DOS rodarão corretamente com o MS-DOS 6.22. Em alguns casos, porém, algum programa poderá não funcionar corretamente, a menos que seu nome seja incluído na tabela de versão. A tabela informa ao programa que ele está sendo executado com a versão do MS-DOS para a qual foi projetado, mesmo que esteja sendo executado com o MS-DOS 6.22. Interpretando o MS-DOS 6.22 como uma versão mais antiga, o programa provavelmente funcionará perfeitamente; entretanto, o uso de SETVER não resolverá o problema se o programa não for compatível com o MS-DOS 6.
Reinicializando depois de atualizar a tabela de versão :
Quando você atualiza a tabela de versão incluindo ou excluindo entradas, é necessário reinicializar o sistema para que as alterações tenham efeito.
Atualizando entradas existentes :
Se for especificado um nome-de-arquivo já incluído na tabela de versão, a nova entrada substituirá a antiga.
Códigos de saída do SETVER
A lista abaixo apresenta os códigos de saída acompanhados uma breve descrição de seu significado:
0
O SETVER completou a tarefa com sucesso.
1
O usuário especificou uma opção de comando inválida.
2
O usuário especificou um nome-de-arquivo inválido.
3
Memória insuficiente no sistema para executar o comando.
4
O usuário especificou formato inválido de número de versão.
5
O SETVER não encontrou a entrada especificada na tabela de versão.
6
O SETVER não encontrou o arquivo SETVER.EXE.
7
O usuário especificou unidade inválida.
8
O usuário especificou excesso de parâmetros na linha de comando.
9
O SETVER detectou insuficiência de parâmetros na linha de comando.
10
O SETVER detectou erro durante a leitura do arquivo SETVER.EXE.
11
O arquivo SETVER.EXE está com defeito.
12
O arquivo SETVER.EXE especificado não suporta tabela de versão.
13
Espaço insuficiente na tabela de versão para nova entrada.
14
O SETVER detectou erro durante a gravação do arquivo SETVER.EXE.
O parâmetro ERRORLEVEL pode ser usado na linha de comando IF de um programa de lote para processar códigos de saída devolvidos pelo SETVER. Para obter um exemplo de programa de lote que processa códigos de saída, consulte o comando <IF> ou o comando <CHOICE>.
Exemplos :
Suponhamos que exista um arquivo de programa denominado MEUPROG.EXE criado para rodar sob a versão 3.30 do MS-DOS. Para executar MEUPROG.EXE, é necessário primeiro usar o comando SETVER para criar uma entrada na tabela de versão que fará com que MEUPROG.EXE interprete o MS-DOS 6.22 como versão 3.30:
setver meuprog.exe 3.30
Para excluir a entrada MEUPROG.EXE da tabela de versão (sem afetar o arquivo MEUPROG.EXE), digite o seguinte comando:
setver meuprog.exe /delete
Para listar o conteúdo da tabela de versão da unidade C, digite o seguinte comando:
setver c:
