SET CHANNEL

O comando SET CHANNEL abre uma porta serial ou um documento. Você pode abrir apenas uma porta serial ou um documento de uma vez com este comando. Para fechar uma porta serial aberta, passe SET CHANNEL (11).

Nota histórica: Este comando era originalmente o primeiro comando 4D utilizado para trabalhar com portas seriais e documentos em disquetes. Desde aquela época, novos comandos foram adicionados. Hoje, você normalmente irá trabalhar com documentos no disco usando os comandos Open document, Create document e Append document. Com esses comandos, você pode ler e escrever caracteres para e de documentos usando SEND PACKET ou RECEIVE PACKET (estes comandos funcionam com SET CHANNEL, também). No entanto, se você quiser usar os comandos SEND VARIABLE, RECEIVE VARIABLE, SEND RECORD e RECEIVE RECORD, você deve usar SET CHANNEL para acessar o documento no disco.

A descrição de SET CHANNEL é composta de duas seções:

• Trabalhando com portas seriais
• Trabalhando com documentos

A primeira forma do comando SET CHANNEL abre uma porta serial, atribui o protocolo de criação e informação de outra porta. Os dados podem ser enviados com SEND PACKET, SEND RECORD ou SEND VARIABLE e recebido com RECEIVE BUFFER, RECEIVE PACKET, RECEIVE RECORD ou RECEIVE VARIABLE.

• O primeiro parâmetro, porta, seleciona a porta e o protocolo. Você pode dirigir até 99 portas seriais (uma de cada vez):

Importante: O valor que você passa na porta deve se referir a uma porta serial COM já existente e reconhecida pelo sistema operacional. Por exemplo, a fim de ser capaz de usar os valores de 101, 103 e 125, as portas seriais COM1, COM3 e COM25 deve ter sido configuradas corretamente.

Uma configuração padrão do Mac OS e Windows suportam duas portas seriais: no Mac OS, a porta do modem e a porta de impressora, no Windows, as portas COM1 e COM2. No entanto, portas seriais adicionais podem ser adicionados através da utilização de placas de extensão. Originalmente, 4D só asignava duas portas seriais padrão e foi só depois que o apoio de portas adicionais foi implementado. Por razões de compatibilidade, os dois sistemas de endereçamento foram mantidos.
- Se você quiser um endereço de porta serial padrão (printer/COM2 ou modem/COM1), você pode passar no parâmetro porta os seguintes valores 0, 1, 20, 21, 30 e 31 (que correspondem a velho método de endereçamento), ou um valor maior que 100 (leia a explicação a seguir).
- Se você quer abordar portas seriais adicionais, você precisará passar o valor de N+100 (onde N é o valor da porta com o endereço). Você também pode considerar a adição de 100 ou 200 ao valor acima mencionado (N+100), se você quer selecionar, respectivamente, um software ou um protocolo de hardware.

Se você quiser usar a porta printer/COM2 sem protocolo, você pode usar uma das seguintes sintaxes:

ou

Se você quiser usar a porta modem/COM1 com o protocolo XON / XOFF, você pode usar uma das seguintes sintaxes:

ou

Se você quiser usar a porta COM 25 com o protocolo RTS / CTS, você precisa usar a seguinte sintaxe:

Truque: Os diferentes valores numéricos para serem acumulados e passados na porta e configuraçao (mas não incluindo os valores para COM1 ... COM99) estão disponíveis como constantes predefinidas no tema das Comunicações dentro do ambiente de desenho. Para COM1 ...COM99 , usar literais numéricos.

A segunda forma do comando SET CHANNEL permite criar, abrir e fechar um documento. Ao contrário dos comandos de documentos do sistema, ele pode abrir apenas um documento de cada vez. O documento pode ser lido ou escrito. Consulte a seção  Documentos de Sistema para maiores informações a respeito.

O parâmetro de operaçao especifica a operação a ser realizada sobre o documento especificado por documento. A tabela a seguir lista os valores de funcionamento e à operaçao resultante, com valores diferentes para o documento. A primeira coluna apresenta os valores permitidos para a operaçao. A segunda coluna relaciona os valores permitidos para o documento. A terceira coluna lista o resultado da operação.

Por exemplo, para exibir uma caixa de diálogo Abrir arquivo para abrir um arquivo de texto, você usaria a seguinte linha:

Todas as operações nesta tabela atribui a variável de sistema de documentos, se necessário. Eles também definem a variável de sistema OK para 1 se a operação foi bem sucedida. Caso contrário, a variável de sistema OK é definido como 0.

Veja os exemplos para os comandos RECEIVE BUFFER, SET TIMEOUT e RECEIVE RECORD.