APPEND
Possibilita que o programa abra os arquivos de dados nos diretórios especificados como se os arquivos estivessem no diretório atual.
Os diretórios especificados são chamados de diretórios anexados porque, durante a abertura dos arquivos de dados, eles podem ser encontrados como se estivessem anexados ao diretório atual.
Sintaxe :
APPEND [[unidade:]caminho[;...]] [/X[:ON|:OFF]][/PATH:ON|/PATH:OFF]
[/E]
Para exibir a lista de diretórios anexados, utilize a sintaxe relacionada a seguir:
APPEND
Para cancelar a lista existente de diretórios anexados, utilize a sintaxe relacionada a seguir:
APPEND ;
Parâmetros :
[unidade:]caminho
Especifica a unidade (se for diferente da unidade atual) e o diretório que você deseja anexar ao diretório atual. Pode-se definir múltiplas especificações de [unidade:]caminho, separando-a com ponto-e-vírgulas.
;
Quando utilizado isoladamente (APPEND ;), cancela a lista existente de diretórios anexados.
Opções :
/X[:ON|:OFF]
Especifica se o MS-DOS dever pesquisar (/X:ON) ou não pesquisar (/X:OFF) os diretórios anexados quando da execução dos programas. Pode-se abreviar /X:ON para /X. Se você quiser especificar X:ON, especifique-o na primeira vez que utilizar APPEND depois de iniciar o sistema. Depois disso, pode-se alternar entre X:ON e X:OFF. O valor
padrão é /X:OFF.
/PATH:ON|/PATH:OFF
Especifica se um programa deve pesquisar os diretórios anexados para encontrar um arquivo de dados quando um caminho já foi incluído com o nome do arquivo pelo qual o programa está procurando. A definição padrão é /PATH:ON.
/E
Atribui a lista de diretórios anexados a uma variável de ambiente nomeada APPEND. Esta opção pode ser utilizada somente na primeira vez que APPEND for utilizado depois de se iniciar o sistema. Se você utilizar /E, poderá utilizar o comando SET para exibir a lista de diretórios anexados. Para obter informações sobre as variáveis de ambiente, consulte o comando <SET>.
Atenção :
Não utilize Append com o programa Microsoft Windows ou Config do Windows.
Comando Relacionado :
Para definir um caminho de pesquisa para os arquivos executáveis, consulte o comando <PATH>.
Observações :
Executando APPEND com o Microsoft Windows
Não utilize Append com o programa Microsoft Windows ou o programa Config do Windows.
Executando APPEND várias vezes
Você pode utilizar APPEND tantas vezes quantas desejar depois de iniciar o sistema. Deve-se, entretanto, observar o seguinte:
* A opção /E é válida somente na primeira vez que você utilizar APPEND depois de iniciar o sistema.
* Na segunda vez e nas vezes subseqüentes em que APPEND for executado, deve-se omitir a extensão .EXE do nome-de-arquivo. Se você tentar executar APPEND digitando APPEND.EXE, ele não será carregado mais de uma vez.
Armazenando a lista de diretórios anexados no ambiente
Você pode utilizar a opção /E com APPEND para atribuir a lista de diretórios anexados a uma variável de ambiente nomeada APPEND. Para tanto, primeiro utilize o comando APPEND somente com a opção /E. Em seguida, utilize APPEND novamente, agora incluindo os diretórios que você deseja anexar. Não é possível especificar /E e [unidade:]caminho na mesma linha de comando.
Especificando múltiplos diretórios anexados
Para anexar mais de um diretório, separe as especificações múltiplas com ponto e vírgulas. Se você utilizar o comando APPEND novamente com os parâmetros [unidade:]caminho, o diretório ou diretórios especificados substituirão quaisquer diretórios especificados em um comando APPEND anterior.
Diretórios anexados e o comando DIR
Se você especificar o comando DIR, a lista resultante não incluirá os nomes de arquivo dos diretórios anexados.
Conflitos de nomes de arquivo
Se um arquivo de um diretório anexado possuir o mesmo nome que um arquivo do diretório atual, os programas abrirão o arquivo no diretório atual.
Utilizando APPEND com programas que criam novos arquivos
Quando um programa abrir um arquivo em um diretório anexado, o arquivo poderá ser encontrado como se estivesse no diretório atual. Se o programa então salvar o arquivo criando um novo arquivo com o mesmo nome, o novo arquivo ser criado no diretório atual (não no diretório anexado). APPEND é utilizado apropriadamente para os arquivos de dados que não devem ser modificados ou que devem ser modificados sem a criação de novas cópias dos arquivos. Os programas de banco de dados freqüentemente modificam os arquivos de dados sem criar novas cópias. Os editores de texto e os processadores de textos, entretanto, normalmente salvam os arquivos de dados modificados criando novas cópias. Para evitar confusão, não utilize APPEND com estes programas.
Usando a opção /X:ON e o comando path
Quando /X:ON for especificado, pode-se executar um programa localizado em um diretório anexado digitando-se o nome do programa no aviso do comando. Normalmente, utiliza-se o comando PATH para especificar diretórios que contenham programas. Observe que entretanto, quando o seu programa estiver em um diretório anexado, não será necessário utilizar o comando PATH para especificar o diretório. O MS-DOS encontra um programa em um diretório anexado seguindo a ordem normal em que o MS-DOS procura por um programa, isto é, primeiro no diretório atual, a seguir nos diretórios anexados e então no caminho de pesquisa.
Funções do MS-DOS que sempre utilizam diretórios anexados
Mesmo quando a opção /X:ON não for especificada, os diretórios anexados são utilizados quando os programas chamam as seguintes funções de interrupção 21h do MS-DOS:
* Abrir Arquivo (0Fh)
* Abrir Gerenciador de Arquivo (3Dh)
* Obter Tamanho de Arquivo (23h)
Quando a opção /X:ON for especificada, os diretórios anexados serão utilizados quando os programas chamarem quaisquer funções de interrupção 21h relacionadas na lista anterior ou quaisquer funções de interrupção 21h da seguinte lista:
* Encontrar Primeira Entrada (11h)
* Encontrar Primeiro Programa (4Eh)
* Executar Programa (EXEC) (4Bh)
Usando APPEND com unidades de rede
Você pode utilizar o comando APPEND para anexar diretórios que estão localizados nas unidades da rede.
Exemplos :
Para permitir que os programas abram arquivos de dados em um diretório nomeado CARTAS no disco da unidade B e em um diretório nomeado RELATS no disco da unidade A como se os arquivos estivessem no diretório atual, digite o seguinte comando:
append b:\cartas;a:\relats
Para anexar os mesmos diretórios e manter uma cópia da lista de diretórios anexados no ambiente do MS-DOS, digite os seguintes comandos:
append /e
append b:\cartas;a:\relats
Certifique-se de que estes comandos APPEND sejam os primeiros a serem utilizados depois que o sistema for iniciado.