WRITE-UNIX-FILE

File 215
Statement PROCESS
Task This view makes it possible to write data to files in the z/OS UNIX file system.

Fields

Dictionary Field Name F/L Mu DE Remarks
NODE N5.0   D D Node ID (DBID).
ERROR-CODE N3.0      
ERROR-TEXT A58      
NODE-NAME A16   D  
SYSTEM-MESSAGE-CODE A10      
FUNCTION A8   D Function to be performed. Can be left unspecified. See below for possible values.
PATH A128   D Fully qualified path name of file to be written.
RECORD A253   D Contents of record.
IDENTIFIER A8   D Required for multiple parallel WRITE-UNIX-FILE calls.
RECORD-LENGTH N3.0   D Length of record to be written.

Relevant Error Codes

Code Text
530 Access denied by Security Facility.
553 I-O error in directory.
568 File or directory not found.
899 I/O ERROR DURING WRITE

Field Descriptions

Field Name Type/Length
NODE (N5.0)

D Node ID (DBID).

Field Name Type/Length
ERROR-CODE (N3.0)

Message code.

Field Name Type/Length
ERROR-TEXT (A58)

Text describing error.

Field Name Type/Length
NODE-NAME (A16)

Name of Node.

Field Name Type/Length
SYSTEM-MESSAGE-CODE (A10)
Field Name Type/Length
FUNCTION (A8)

Function to be performed. If not left unspecified the following functions are available:

Option Explanation
CLOSE  Closes all records that have been written.
Field Name Type/Length
PATH (A128)

Fully qualified path name of file to be written.

Field Name Type/Length
RECORD (A253)

Contents of record.

Field Name Type/Length
IDENTIFIER (A8)

Required if multiple WRITE-FILE calls are executing in parallel. All requests for the same file must have the same identifier.

Field Name Type/Length
RECORD-LENGTH (N3.0)

Length of record to be written. Default is 132.