GPR_$SET_BITMAP                   GPR Calls                    GPR_$SET_BITMAP


NAME
     gpr_$set_bitmap - establishes a bitmap as the current bitmap.

FORMAT
     gpr_$set_bitmap (bitmap_desc, status)

DESCRIPTION
     This routine establishes a bitmap as the current bitmap for subsequent
     operations.

   Input Parameters
     bitmap_desc
          A unique bitmap descriptor, in gpr_$bitmap_desc_t format.  This is a
          4-byte integer.

   Output Parameters
     status
          Completion status, in status_$t format.

SEE ALSO
     gpr_$inq_bitmap.

NOTES
     The program can obtain the bitmap descriptor by using gpr_$inq_bitmap.

     After a bitmap is established using gpr_$set_bitmap or gpr_$init,  it  is
     called the "current bitmap."