{
{       This subcommand defines an RHFAM client application and the client's
{ attributes.
{
{       The caller must have NETWORK_APPLICATION_MANAGEMENT capability specified
{ in the validation file, or be the system job in order to use this command.
{
{
{ DEFINE_RHFAM_CLIENT, DEFRC(
{     client, c : NAME 1..7 = $REQUIRED
{     maximum_connections, mc : INTEGER 1..255 = 255
{     user_capability, uc : NAME OR KEY none = none
{     ring, r : INTEGER 1..15 = 13
{     system_privilege, sp : BOOLEAN = FALSE
{     system_wide_connection_mgmt, swcm : BOOLEAN = FALSE
{     status)
{
{ client: This parameter specifies the name of the client application.
{
{ maximum_connections: This parameter specifies the maximum number of
{   concurrent connections that can be established for all instances of
{   a client application. The default value is 255.
{
{ user_capability: This parameter specifies the name of the capability required
{   to be in the caller's validation file entry in order to call the affected
{   RHFAM program interfaces. The keyword NONE indicates that no capability
{   is to be validated.
{
{ ring: This parameter specifies the maximum ring number from which the
{   affected RHFAM program interfaces may be called. The default value for
{   this attribute is 13.
{
{ system_privilege: A value of TRUE indicates the affected RHFAM program
{   interfaces may be called only from code with system privilege. A value
{   of FALSE indicates requests may be made from any system or user code.
{   The default value is FALSE.
{
{ 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.  The default value is FALSE.
{
{ status: This parameter returns the results of this request. A normal status
{   means that the requested server was defined.
{
