afsDTC:  Interface to the Depository Trust Company's Institutional Delivery System (ID)

afsDTC generates a file that contains a line item for each qualifying completed/approved ticket detail that has not been sent to the DTC yet.  This file will be created in the directory specified by the OUTPUT_DIR parameter in the [DTC] section of the afstrade.ini file.

The format of the DTC  file is described in the DTC's Institutional Delivery System (ID) Trade Input Function User's Guide.  Note: The header for this file is the required jobstream for input to the DTC, referred to by the DTC as ICM JCL.

After the DTC file has been generated, the user will be prompted to transmit the file, or the file will be FTP'd to the DTC.  If prompted to transmit, the user should transmit the DTC file to the DTC.  The file can be transmitted via RJE.  

While the data transmitted for each trade is the same, regardless of the transmission type (RJE or FTP), the file name and the header and trailer of each type of file is different (so you could not generate an RJE file and then send it manually via FTP).  In addition, the RJE file maximum record size is 80 while the FTP maximum record size is 807.

The user will be asked if the transmission of the file to the DTC was successful.  If the file was submitted successfully to the DTC then the user should answer "Yes"; otherwise the user should answer "No".

  • If "Yes", the tickets that were included in the DTC file will be marked as sent in the afstrade database so that they won't be included the next time afsDTC is run.  The DTC file will be copied to the archive directory specified by the ARCHIVE_DIR parameter in the [DTC] section of the afstrade.ini file.  If an RJE file the file in the archive directory will be renamed as follows:  
    • dtc-<yyyymmdd>-<file sequence #>-id    (ex. dtc-20040121-2-id)
  •  If "No", the tickets that were used to generate the file won't be marked so that they will be included the next time afsDTC is run.

If the directories to which the generated DTC files will be saved do not exist, afsDTC will create them automatically based on the values of the OUTPUT_DIR and ARCHIVE_DIR parameters in the [DTC] section of the afstrade.ini file.

Each time afsDTC is run, a log file will be created in the directory specified by the LogFileDirectory parameter in the [AFSTrade] section of the afstrade.ini file.

Note:  afsDTC.exe is a separate application and does not run from afstrade.exe.  Therefore, the user who will be running the afsDTC application will need access to it, including access for file creation in the OUTPUT_DIR and ARCHIVE_DIR directories.

A [DTC] section is needed in the afstrade.ini file in order to run the afsDTC application.  Set the appropriate values for your system.

[afsDTC]
; OUTPUT_DIR is the directory in which DTC file is placed. 
; This file is REPLACED every time afsDTC is run.
OUTPUT_DIR=c:\TEMP
; ARCHIVE_DIR is the directory in which an archive of each
; DTC file is placed when the program has successfully
; completed.
ARCHIVE_DIR=c:\TEMP
; INPUT_DIR is the directory in which DTC result file is  
; placed.  This file is REPLACED every time afsDTC is run.
INPUT_DIR=c:\TEMP
; FILE_TYPE is the Production/Test indicator: T=test,
; P=production
FILE_TYPE=T
; USER_NUMBER is the user number or signon
USER_NUMBER=1234
; REMOTE_NUMBER is the Remote number from the SIGNON card
; (from the first transmission)
REMOTE_NUMBER=123
; Transmission Format: FTP, RJE
; default is RJE
TRANSMISSION_FORMAT=FTP
; RACF is the sign-on string provided by DTC. This is a
; required value.
RACF=06963-201
FTPHostName=<server name>
FTPUserID=<user id>
FTPPassword=<password>
; FTPMode can be one of ASCII, IMAGE or BYTE
; FTPMode=ASCII
; PAUSE_SECONDS indicates the number of seconds to wait after the
; DTC file is uploaded, before the remote file from DTC is downloaded.
; Default is 5 seconds.
; PAUSE_SECONDS=5

Last Updated October 19, 2004.