{
{       The purpose of this routine is to define an RHFAM server application.
{ The RHFAM server and client tables are searched to verify that the specified
{ application name is unique.
{        This routine must be called within the system job or the caller
{ must have NETWORK_APPLICATION_MGMT capability.
{
{ RFP$DEFINE_RHFAM_SERVER (SERVER, RHFAM_INITIATED, MAXIMUM_CONNECTIONS,
{   CAPABILITY, RING, SYSTEM_PRIVILEGE, SERVER_JOB, SERVER_JOB_MAX_CONNECTIONS,
{   ACCEPT_CONNECTION, RHFAM_VALIDATES_CONNECTION_LID, STATUS)
{
{ SERVER: (input) This parameter specifies the name of the server that is
{   to be defined.
{
{ RHFAM_INITIATED: (input) This parameter is a boolean value which, if TRUE,
{   specifies that RHFAM is to initiate an instance of the server application
{   when necessary to process a client's connection request. If FALSE, the
{   server application is initiated via an independent process.
{
{ MAXIMUM_CONNECTIONS: (input) This parameter specifies the maximum number
{   of concurrent connections allowed for all instances of a server
{   application.
{
{ CAPABILITY: (input) This parameter may specify a user capability that
{   is required to call RHFAM program interfaces which perform server
{   application functions. An empty name specifies that no user capability
{   is required to call these interfaces.
{
{ RING: (input) This parameter specifies the highest ring from which RHFAM
{   program interfaces which perform server application functions may be
{   called.
{
{ SYSTEM_PRIVILEGE: (input) This parameter is a boolean value which, if TRUE,
{   specifies that access to RHFAM program interfaces which perform server
{   application functions is limited to callers with system privilege.
{
{ SERVER_JOB: (input) This parameter specifies a file containing a sequence
{   of SCL commands that execute an instance of an RHFAM-initiated server
{   application. This file is saved in the $SYSTEM.RHFAM.SERVER catalog.
{   This parameter is valid only if RHFAM_INITIATED is TRUE.
{
{ SERVER_JOB_MAX_CONNECTIONS: (input) This parameter specifies the maximum
{   number of connections that an RHFAM-initiated server job can support.
{   This parameter may be specified only if RHFAM_INITIATED is TRUE.
{
{ ACCEPT_CONNECTION: (input) This parameter is a boolean value which, if
{   TRUE, specifies that RHFAM is to accept connections on behalf of a
{   server application.
{
{ RHFAM_VALIDATES_CONNECTION_LID: (input) This parameter is a boolean value
{   which specifies that RHFAM ensures that the destination LID in the
{   connection request matches a local host LID.
{
{ STATUS: (output) This status returns the result of the request. A status
{   of normal indicates that the specified server has been defined.
{
{     CONDITIONS: rfe$duplicate_appl_definition
{                 rfe$server_defined_as_client
{
{     IDENTIFIER: 'RF'
{
