This is what I was able to find:
$V{PAGE_COUNT}
- The number of records that display on the page.
$V{PAGE_NUMBER}
- The page number. When evaluated at 'now', you get the current page.
- When evaluated at 'report', you get the last page, or total.
I could not find a way (iReport does not support) to evaluate a parameter at 'report' time, so I was not able to get the total number of pages to display. I ended up moving this feature out of my SubReport and into the main report.