Interface Data Set Specifications Chart
The chart below provides specifications for CSENet 2000 interface data sets with the following guidelines:
- The Retrieve/Overwrite/Append column refers to whether the data in the data set is downloaded by the OCSE server from the state system or whether it is uploaded by CSENet to the state.
- The File Transfer Protocol (FTP) command to append data to a data set is append. The FTP command to overwrite a data set with new data is put. If a state's version of FTP does not allow the append command or the state does not want data appended to its interface data sets, the put command is used for all interface uploads.
- Minimum and maximum record lengths are provided in bytes. In systems where the interface connects to a UNIX server, the record lengths will be one byte longer to include a carriage return at the end of each record.
If fixed-block format is chosen for a data set, the logical record length (LRECL) defined when the data set parameters are established specifies the length of all records to be written to the data set. However, if variable-block format is chosen for a data set, its LRECL specifies the maximum length of any record written to the data set. If a record destined for a data set is longer than the LRECL, the record is either written as multiple records or truncated, depending on the FTP parameters defined on the State's interface server. The LRECL defined for each interface data set must be set to the correct length to avoid record-length errors.
| Interface Data Set |
Retrieve/Overwrite/Append |
Minimum Record Length |
Maximum Record Length |
Data in the Data Set |
| Outgoing Transactions |
Retrieve, then Empty |
127 |
8481 |
Transactions to other states (or test transactions to send to the OCSE server). |
| Incoming Transactions |
Append |
127 |
8475 |
Transactions from other states (or test transactions from the OCSE server). |
| Invalid Transactions |
Append |
145 |
145 |
Error messages for transactions from your state in which the OCSE server found errors. |
| Validation Reports |
Append |
0 |
80 |
Validation Reports provide information about transactions from your state checked for errors by the OCSE server. |
| IRG Master File |
Overwrite |
247 |
247 |
A file of all existing IRG records. |
| IRG Update Files |
Append |
247 |
247 |
A file of new or modified IRG records. |
| Interface Reports |
Append |
0 |
80 |
Interface Reports provide summary information about interface file transfers. |
| Interface Logs |
Append |
0 |
120 |
Interface Logs contain detailed output from interface file transfers (useful for debugging). |