User manual

Computer Gateway User Manual 4-109 5/96
4.10.1
4.10.1.3 Status Codes Returned by File Transactions
The message block of each File Transfer response contains two words of status data.
• Word 11 of the message block contains the code specifying the overall return status
(0 = normal). See heading 4.10.17.1 for details.
• Word 12 of the message block contains a substatus code that is significant only when
word one contains the value 1 (see heading 4.10.17.2) or the value 14 (see heading
4.10.17.3). Exception: A normal response to a Data Out request (Command Code =
14) uses the substatus code value to identify the Data Out on/off status.
4.10.1.4 HM Node Addressing Forms
The pathname used to address a History Module file can specifiy either NET or the physical
node (PN:nn) of the History Module. The physical node number must be used when the
HM is running the HMI personality. The maximum pathname length is 28 characters.
Examples of the two addressing forms are:
NET>vdir>file_id.extension
PN:nn>vdir>file_id.extension
where
nn = the HM physical node number
vdir = volume or directory identifier
file_id.extension = the file name and suffix
Note that the "PN:nn" form of addressing is required when the History Module's
initialization (HMI) personality is loaded.
Some file operations can be performed on remote LCN networks. A remote network
address uses a 3-character prefix to the pathname that identifies the remote network. (e.g.,
n1\PN:43>vdir>filename.yy) Remote network addressing is limited to use with the
following file transfer commands only:
• Read LCN NET File
• Write LCN NET File
• Retrieve Single File Attributes
• List Catalog Into a File
• Copy File
• Delete Files
• Data Out Request
• Retrieve File Names and Extensions
NOTE
In the descriptions of the various request/response pairs that follow, an asterisk (*) indicates
that data in the field is a file attribute.