AIX | HP-UX | Linux | OS/2 | OS/390 | OS/400 | PTX | SUN | Win NT |
X | X | X | X | X | X | X | X | X |
Finalidad
Suprime un archivo completo.
Formato
@DTWF_REMOVE(nombarchivo, reintento)
@DTWF_REMOVE(nombarchivo)
Parámetros
Tabla 189. Parámetros de DTWF_REMOVE
Tipo de datos | Parámetro | Uso | Descripción |
---|---|---|---|
serie | nombarchivo | INOUT | El nombre del archivo que ha de suprimirse. Cuando la llamada se complete satisfactoriamente, este parámetro devolverá el nombre de archivo completamente calificado. |
entero | reintento | IN | El número de veces que ha de efectuarse un reintento en el caso de que el archivo no pueda suprimirse inmediatamente. El valor por omisión es no efectuar ningún reintento. |
Códigos de retorno
Tabla 190. Códigos de retorno de DTWF_REMOVE
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. |
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. |
Ejemplos
Ejemplo 1:
%DEFINE myFile = "c:/private/myfile" @DTWF_REMOVE(myFile)
Ejemplo 2:
%DEFINE { myFile = "c:/private/myfile" myWait = "2000" %} @DTWF_REMOVE(myFile, myWait)