{
{       The purpose of this routine is to define an RHFAM client application.
{ The RHFAM client and server 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_CLIENT (CLIENT, MAXIMUM_CONNECTIONS, CAPABILITY, RING,
{   SYSTEM_PRIVILEGE, STATUS)
{
{ CLIENT: (input) This parameter specifies the name of the client that is
{   to be defined.
{
{ MAXIMUM_CONNECTIONS: (input) This parameter specifies the maximum number
{   of concurrent connections allowed for all instances of a client
{   application.
{
{ CAPABILITY: (input) This parameter may specify a user capability that
{   is required to call RHFAM program interfaces which perform client
{   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 client 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 client
{   application functions is limited to callers with system privilege.
{
{ SYSTEM_WIDE_CONNECTION_MGMT: (input) This parameter is a boolean value
{   which, if TRUE, specifies that the maximum number of connects, as
{   specified by the parameter MAXIMUM_CONNECTIONS, will be managed across
{   the whole system for this client.If FALSE, the connections will be
{   managed on a job basis.  This means that, if TRUE, the maximum number
{   of connects per job will not be limited by the number reserved at
{   APPLICATION_SIGN_ON time but is limited by the maximum number of
{   connects allowed for this type of client.
{
{ STATUS: (output) This status returns the result of the request. A status
{   of normal indicates that the specified client has been defined.
{
{     CONDITIONS: rfe$duplicate_appl_definition
{                 rfe$client_defined_as_server
{
{     IDENTIFIER: 'RF'
{
