SET CHANNEL

El comando SET CHANNEL abre un puerto serial o un documento. Sólo puede abrir un puerto serial o un documento al tiempo con este comando. Para cerrar un puerto serial abierto, pase SET CHANNEL (11).

Nota histórica: este comando fue originalmente el primer comando 4D utilizado para trabajar con puertos seriales y documentos en discos. Desde entonces, se han añadido nuevos comandos. Hoy en día, se trabaja generalmente con documentos en disco utilizando los comandos Open document, Create document y Append document. Con estos comandos, puede leer y escribir caracteres en los documentos utilizando SEND PACKET o RECEIVE PACKET (estos comandos trabajan también con SET CHANNEL). Sin embargo, si quiere utilizar los comandos SEND VARIABLE, RECEIVE VARIABLE, SEND RECORD y RECEIVE RECORD, debe utilizar SET CHANNEL para acceder a los documentos en el disco.

La descripción de SET CHANNEL está compuesta de dos secciones:

• Trabajar con los puertos seriales
• Trabajar con documentos

La primera forma del comando SET CHANNEL abre un puerto serial, define el protocolo de comunicación así como otra información del puerto. Los datos pueden ser enviados por los comandos SEND PACKET, SEND RECORD o SEND VARIABLE, y recibidos con RECEIVE BUFFER, RECEIVE PACKET, RECEIVE RECORD o RECEIVE VARIABLE.

• El primer parámetro, puerto, selecciona el puerto y el protocolo. Puede direccionar hasta 99 puertos seriales (uno a la vez). La siguiente tabla lista los valores para puerto:

Importante: el valor que pasa en puerto se refiere a un puerto serial COM existente reconocido por el sistema operativo. Por ejemplo, para que pueda utilizar los valores 101, 103 y 125, los puertos seriales COM1, COM3 y COM25 deben haber sido configurados correctamente.

En una configuración estándar, Mac OS y Windows reconocen dos puertos seriales: en Mac OS, el puerto modem y el puerto impresora; en Windows, los puertos COM1 y COM2. Sin embargo, se pueden añadir puertos seriales adicionales por medio de tableros de extensión. Inicialmente, 4D sólo direccionaba dos puertos seriales estándar y más adelante se implementó el soporte de puertos adicionales. Por razones de compatibilidad, se conservan ambos sistemas de direccionamiento.
- Si quiere direccionar un puerto serial estándar (impresora/COM2 o modem/COM1), puede pasar en el parámetro puerto uno de los siguientes valores 0, 1, 20, 21, 30 y 31 (que corresponde al método de direccionamiento antiguo), o un valor mayor a 100 (por favor vea la siguiente explicación).
- Si quiere direccionar puertos seriales adicionales, debe pasar el valor N+100 (donde N es el valor del puerto a direccionar). También puede considerar añadir 100 o 200 al valor menciondo anteriormente (N+100), si quiere seleccionar respectivamente un protocolo de software o de hardware.

Si quiere utilizar el puerto impresora/COM2 sin protocolo, puede utilizar una de las siguientes sintaxis:

o

Si quiere utilizar el puerto modem/COM1 con el protocolo XON/XOFF, puede utilizar una de las siguientes sintaxis:

o

Si quiere utilizar el puerto COM 25 con el protocolo RTS/CTS, debe utilizar las siguientes sintaxis:

Truco: los diferentes valores numéricos a acumular y pasar en puerto y param (a excepción de los valores de COM1...COM99) están disponibles como constantes predefinidas en el tema Comunicaciones del explorador en el entorno Diseño. Para los valores COM1...COM99, utilice los valores numéricos literales.

La segunda forma del comando SET CHANNEL le permite crear, abrir, y cerrar un documento. A diferencia de los comandos del tema Documentos del sistema, SET CHANNEL sólo puede abrir un documento a la vez. El documento puede leerse o escribirse. Consulte la sección para mayor información al respecto.

El parámetro operacion especifica la operación a realizar en el documento especificado por documento. La siguientes tabla lista los valores de operacion y el resultado obtenido, en función del valor de documento. La primera columna lista los valores posibles de operacion. La segunda columna lista los valores posibles de documento. La tercera columna lista la operación resultante.

Por ejemplo, para visualizar una caja de diálogo de abrir un archivo, puede utilizar la siguiente línea:

Todas las operaciones en esta tabla modifican la variable sistema Document si es necesario. Igualmente la variable sistema OK toma el valor 1 si la operación fue exitosa. De lo contrario, la variable sistema OK toma el valor 0.

Ver los ejemplos de los comandos RECEIVE BUFFER, SET TIMEOUT y RECEIVE RECORD.