Go To Documentation Main IndexMain Index
Go To TIPS, Inc.TIPS Home
sf_cfs

sf_cfs (routine)

Calculate cash flows for a sinking fund security

Introduced in release: 1.0
Component: Generic
Purpose: Calculates cash flows with corresponding dates for a security with a sinking fund. The cash flows include all payments to the security holder. In this case they include redemptions of securities (according to the sinking fund schedule), interest, and repayment of principal at maturity.

Special Considerations: The cash flows generated by this routine, unlike the other _cfs routines in the Library, cannot be scaled via the thous_securities variable, since they are based on the actual amounts passed in the outstanding_amt, sink_amt, sinkgrp_amts, overfund_amt, voluntary_amt and voluntarygrp_amts fields.

Alternatives: If some or all sink dates are off cycle from the coupon payment dates, or the security has an odd last coupon period use sf_cfs_ocs. If the bonds are sunk at other than par use sf_rv_cfs.

Notes: This routine only works with security_type 1, or 3 through 8. It does not work with any foreign security types.

Results: All results are accurate to as many places as supported by a double precision value. The array cfs contains the cash flows and the arrays cf_months, cf_days, cf_years contain the corresponding dates.

Error Conditions: Returned values should be ignored for a non-zero status. See Errors.

Last Mod Date: 12/28/1995© 2001 TIPS, Inc.Doc Version: 5.0