{
{    The purpose of this request is to return a list of mainframes which are
{ acting as partners to the host mainframe and the state of each.
{
{       DFP$GET_MAINFRAME_LIST (PARTNERS_ARE_SERVERS, PARTNER_MAINFRAMES,
{             PARTNER_COUNT)
{
{ PARTNERS_ARE_SERVERS: (input)  This parameter specifies whether the partner
{       mainframes of interest are servers (value specified as TRUE) or clients
{       (value specified as FALSE).
{
{ PARTNER_MAINFRAMES: (output)  This parameter specifies an array of mainframe
{       entries to be be set by this request.  If the dimension of this array
{       is smaller than the number of partner mainframes, the array will be set
{       to its maximum dimension.  The value of the partner_count parameter
{       returned will always be the total number of partner mainframes which
{       satisfy the partners_are_servers criterion.
{
{ PARTNER_COUNT: (output)  This parameter specifies the number of mainframes
{       found which satisfy the partners_are_servers parameter.  This value
{       could be greater than the dimension of the partner_mainframes parameter
{       array.
