AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | PTX | SUN | Win NT |
X | X | X | X | X | X | X | X | X |
Finalidad
Abre un archivo de texto.
Formato
@DTWF_OPEN(nombarchivo, modalidad, reintento, crearOpciones)
@DTWF_OPEN(nombarchivo, modalidad, reintento)
@DTWF_OPEN(nombarchivo, modalidad)
Parámetros
Tabla 183. Parámetros de DTWF_OPEN
Tipo de datos | Parámetro | Uso | Descripción |
---|---|---|---|
serie | nombarchivo | INOUT | El nombre del archivo que ha de abrirse. Cuando la llamada se complete satisfactoriamente, este parámetro devolverá el nombre de archivo completamente calificado. |
serie | modalidad | IN | El tipo de acceso solicitado:
|
entero | reintento | IN | El número de veces que ha de efectuarse un reintento en el caso de que el archivo no pueda abrirse inmediatamente. El valor por omisión es no efectuar ningún reintento. |
serie | crearOpciones | IN | Opciones a utilizar al crear un archivo. Si un archivo existe, las opciones especificadas no se utilizan. Todas las plataformas, a excepción de OS/400, ignoran las opciones. Actualmente, se admite la opción siguiente: CCSID=nnn, que especifica el ID del juego de caracteres codificado (CCSID) que se debe utilizar al crear un archivo nuevo. Nnn debe ser un CCSID válido del 1 al 65534. |
Códigos de retorno
Tabla 184. Códigos de retorno de DTWF_OPEN
Código de retorno | Explicación |
---|---|
-1001 | El servidor no ha podido procesar una petición de Net.Data para asignar memoria. |
1001 | Un parámetro de entrada contenía un valor NULL. |
1002 | Un parámetro de entrada contenía un valor de serie que consistía en el carácter de terminación nulo. |
1003 | Se ha transmitido un número incorrecto de parámetros en una llamada de función. |
1005 | Se ha transmitido un parámetro en una llamada de función que debería haber sido una variable de serie, pero era de un tipo de variable diferente. |
1006 | Se ha transmitido una serie literal en una llamada de función para un parámetro que debería haber sido un parámetro de salida. |
1007 | Un parámetro contiene un valor que no es válido. |
2000 | Una función incorporada de la interfaz de archivo plano no ha podido encontrar el archivo especificado. |
2001 | Una función incorporada de la interfaz de archivo plano no ha podido abrir el archivo especificado porque lo estaba utilizando éste u otro proceso y no se podía compartir en la modalidad especificada. |
2006 | Una función incorporada de la interfaz de archivo plano no ha podido acceder al archivo especificado porque lo estaba utilizando éste u otro proceso y no se podía compartir en la modalidad especificada. |
Notas de utilización
Ejemplos
Ejemplo:
%DEFINE { myFile = "c:/private/myfile" myMode = "r+" %} @DTWF_OPEN(myFile, myMode, "1000")