{
{   This request will perform the file setup (volume assignment,
{ fmd creation, fat creation) necessary for file space to be allocated to a
{ file.  The actual allocation of the file space will be done in monitor mode.
{ The file descriptor for the file must have been created prior to issuing this
{ request.
{
{       DMP$ALLOCATE_FILE_SPACE_R1 (SYSTEM_FILE_ID, BYTE_ADDRESS,
{         NUMBER_BYTES_TO_ALLOCATE, CHAPTER_NUMBER, STATUS)
{
{ SYSTEM_FILE_ID: (input) This parameter specifies the system file
{       identification of the file.
{
{ BYTE_ADDRESS: (input) This parameter specifies the file address at which
{       allocation is to start.
{
{ NUMBER_BYTES_TO_ALLOCATE: (input) This parameter specifies the amount of file
{       space to allocate.
{
{ CHAPTER_NUMBER: (input) This parameter specifies the chapter in which to
{       allocate space.
{
{ STATUS: (output) This parameter returns the request status.
{
