{
{       This subcommand defines an RHFAM server application and the server'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_SERVER, DEFRS(
{     server, s : NAME 1..7 = $REQUIRED
{     rhfam_initiated, ri : BOOLEAN = TRUE
{     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
{     server_job, sj : FILE = $OPTIONAL
{     server_job_maximum_connections, sjmc : INTEGER 1..255 = 255
{     accept_connection, ac : BOOLEAN = TRUE
{     rhfam_validates_connection_lid, rvcl : BOOLEAN = TRUE
{     status)
{
{ server: This parameter specifies the name of the server application.
{   Client applications must specify this name on connect requests.
{
{ rhfam_initiated: A value of TRUE indicates that RHFAM is to initiate an
{   instance of the server when necessary to service a connection request
{   from a client. A value of FALSE indicates that instances of the server
{   will be initiated by a process independent of RHFAM. The default value
{   is TRUE.
{
{ maximum_connections: This parameter specifies the the maximum number of
{   concurrent connections that can be established for all instances of
{   a server 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.
{
{ server_job: This parameter specifies the file that contains the job stream
{   that RHFAM is to submit for execution, to process requests for this
{   server. This parameter must be specified if the rhfam_initiated parameter
{   is TRUE, but is ignored if rhfam_initiated is FALSE.
{
{ server_job_maximum_connections: This parameter specifies the number of
{   concurrent connections supported by a specific instance of the server
{   application. This parameter is ignored if the rhfam_initiated parameter
{   is FALSE. The default value is 255.
{
{ accept_connection: This parameter specifies whether RHFAM should accept
{   connection requests on behalf of the specified server before assigning
{   the connection to the server application job. If TRUE, RHFAM accepts
{   incoming connect requests for this server (up to the connection limit).
{   and queues the accepted requests for the server to retrieve. If FALSE,
{   RHFAM queues all incoming connect requests for this server (up to the
{   connection limit). The server must then retrieve AND accept the
{   connections. The default value is TRUE.
{
{ rhfam_validates_connection_lid: This parameter specifies whether or not
{   the destination LID in a connection request must match a local host LID.
{   If TRUE, RHFAM checks the destination LID before starting the server.
{   If FALSE, RHFAM does not check the destination LID.  The default is TRUE.
{
{ status: This parameter returns the results of this request. A normal status
{   means that the requested server was defined.
{
