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

sfns_rv_cfs (routine)

Calculate cash flows for a multi-stepped coupon sinking fund security with sinks at other than par

Introduced in release: 1.3
Component: US Bonds
Purpose: Calculates cash flows with corresponding dates for a security with multiple stepped coupons and a sinking fund where sinks can occur at other than par. 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.

Notes: This routine is currently the most comprehensive for generating cash flows from sinking fund schedules for a stepped coupon bond.

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: 01/20/1997© 2001 TIPS, Inc.Doc Version: 5.0