User manual

Computer Gateway User Manual 4-113 5/96
4.10.3
A temporary file with a unique name is created to receive the data on the requested volume.
After the transmission is complete, the temporary file is Safe Renamed to the requested
LCN pathname.
If the contents of an existing file are over written or data are appended to the file, the
resulting file attributes of the file are those specified in the message block of the request.
4.10.3.1 Write LCN File Request
Header information: Word 1—Transaction Code = 62
Word 2—Number of Words = 40 + data size
Word 5—CG Identifier = 2
Message format: Words 1..8—Reserved for future use
Word 9—Command type = 2
Word 10—File handling code
1 = Replace existing file
2 = Return error if file exists
3 = Append to or amend existing file
4 = Replace existing full file if exists
5 = Write full file if file does not exist
Option 4 and 5 work like 1 and 2 except the
CG/PLNM expects the subsequent file transfer
requests to write the rest of the file. If the first request
opens the file with no errors, the CG will respond to
the subsequent write request immediately, buffering
the file in memory until the last write request is sent.
The last request will reflect the status of writing the file
to disk.
Word 11—Reserved for response data
Word 12—Reserved for response data
Words 13..26—LCN pathname for the file (ASCII characters)
(PN:nn>vdir>filename.xx or NET>vdir>filename.xx)
Word 27—File Block Size* if linked file
(0 = default of 8 )
Word 28—Record size* if linked file
(0 = variable size)
Word 29—Number of records in this transmission
Word 30—Requested starting record
(0 = append/amend)
Word 31—Requested ending record
(not applicable if word 30 = 0)
Word 32—Number of blocks in file*
(applies to contiguous files only)
Word 33—Transmission counter
(initial = 0, subsequent = previous response value)
Word 34—Last data block flag (0 = not last)
Word 35—File type (0 = contiguous, 1 = linked)
Word 36—User supplied time-out in seconds.
The valid values are 1 to 1800.
A value outside this range sets a default of 60.
Word 37—Number of blocks used*
Word 38—File configuration*