HP 3000 Manuals

NSCONTROL SERVER [ NS3000/iX Operations & Maintenance Reference Manual ] MPE/iX 5.0 Documentation


NS3000/iX Operations & Maintenance Reference Manual

NSCONTROL SERVER 

Alters the characteristics of the Network Services server processes.

Syntax 

                       {servername}
     NSCONTROL SERVER= {ALL       }[,minservers][,maxservers]

Parameters 

SERVER                Dynamically alters the minimum or maximum number of
                      servers.

serverName            Specifies the type of server for which you want to
                      alter the available number of server processes.
                      The servers that control the network services are:

                      DSSERVER              The specified options apply
                                            to the server that controls
                                            RFA, RDBA, PTOP, and RPM.
                                            Default minserver, maxserver
                                            values are 0, 300
                                            respectively.

                      LOOPBACK              The specified options apply
                                            to the server used by the
                                            LOOPBACK services.  Default
                                            minserver, maxserver values
                                            are 0, 300 respectively.

                      NFT                   The specified options apply
                                            to the server that controls
                                            NFT. Default minserver,
                                            maxserver values are 0, 300
                                            respectively.

                      NSSTATUS              The specified options apply
                                            to the server that controls
                                            NSSTAT (and NSTATL) services.
                                            Default minserver, maxserver
                                            values are 0, 300
                                            respectively.

                      VTSERVER              The specified options apply
                                            to the server that controls
                                            VT and REVERSE VT. Default
                                            minserver, maxserver values
                                            are 0, 300 respectively.

ALL                   If you specify ALL in place of a servername, the
                      specified options apply to all servers (NFT,
                      DSSERVER, LOOPBACK, NSSTATUS, VTSERVER).

                      Default:  ALL

                      There may be additional servers to control if other
                      network products, such as Personal Productivity
                      Center, are installed.  Refer to that network
                      product's documentation to obtain the appropriate
                      server names.

minservers            The minimum number of servers which will be in
                      existence at all times.  This includes active and
                      reserved servers.  These servers are created
                      immediately on the initiation of Network Services
                      and are then kept in reserve until a service
                      request is received.  Once the service request is
                      completed, the server is returned to reserve
                      status.  If necessary, additional servers are
                      created immediately to fit the new minimum
                      specified.  Valid range:  0....1250; however, see
                      note below.

                      Default:  0

maxservers            The maximum number of servers.  If necessary,
                      reserved servers will be terminated to fit the new
                      maximum.  However, a server that is in use will not
                      be terminated until it is returned to the reserved
                      server pool.

                      Limits in the number of allowed processes and
                      internal data structures can prevent you from
                      reaching the maximum number of servers.  Valid
                      range:  0....32767; however, see note below.

                      Default:  Varies by server


NOTE The total number of all active servers may not exceed 1250. The sum of all minservers must always be 1250 or less. You may specify a number greater than 1250 as one or more maxservers values, but there will never be more than a total of 1250 servers of all kinds at any one time.
Discussion The number of server processes is controlled with the SERVER function. The maximum number of servers limits how many processes of each server type can be in existence at any time. If the servers are at the maximum limit and a new service request (such as a DSCOPY or REMOTE HELLO) is received, the request will be rejected. By setting a maximum limit, you can control the amount of process resources available for NS3000/iX. Because the creation and initialization of a server takes time, using reserved servers decreases the set up time for a service request. A reserved server is created ahead of time and is held in reserve until a service request is received. The minimum number of servers controls the number of reserved processes for each type of server. The number set for the minimum does not limit the number of concurrent users of the Network Services. If there are more concurrent users than the minimum number of servers specified, new users can use the Network Services, but there is a delay while the additional servers are created. There is no simple formula for determining how many precreated servers to specify. Since each precreated server consumes one set of process resources, including process related system table entries and virtual memory for stack space, the number chosen must be a tradeoff between using system resources and allowing fast service response. The node manager needs to estimate, on the average, the number of concurrent users of each type of server. This number is used for the minimum number of servers of each type. Since the DSSERVER process is used by several services, and some of these services are active for a long time, it makes sense to allocate a larger number of DSSERVER servers than NFT, VTSERVER, LOOPBACK or NSSTATUS servers. An alternative to allocating a greater number of DSSERVER servers is to allocate the program files NFT.NET.SYS, VTSERVER.NET.SYS, DSSERVER.NET.SYS, LOOPBACK.NET.SYS, and NSSTATUS.NET.SYS. This alternative is most advantageous for DSSERVER, where the allocation of the program file is a significant portion of the set up time. The NFT server must read keywords and messages from the NFTCAT2 catalog as well as allocate the program file when the server is created, so the performance gain is not as great as for DSSERVER. Creating reserved servers or using the allocation alternative means that the program file is in use, just as when a program is run. Since the program file is in use, it cannot be purged, replaced, or backed up. Before any software installation, when the program files are replaced or backed up, check that the program files are not allocated and that there are no reserved servers. Example The command below sets the minimum number of DSSERVER processes to five and the maximum to 10. Five reserved DSSERVER processes are created immediately and are available for future service requests. The minimum number of servers, which includes both reserved and active servers, is restricted to five. When an active server is returned to the reserved pool, if there are already five reserved servers, the extra server is terminated. The maximum limit means that if there are 10 DSSERVER processes active, any new service requests will be rejected. :NSCONTROL SERVER=DSSERVER,5,10 Example If you execute the command below, there will be 10 server processes created for NFT, 10 for VTSERVER, 10 for DSSERVER, 10 for LOOPBACK, and 10 for NSSTATUS. Later, when users issue service requests (such as DSCOPY and REMOTE HELLO), they do not have to wait for the servers to be created. The maximum number of servers is unchanged. :NSCONTROL SERVER=ALL,10 Example In the example below, the node manager has chosen to allocate the program file used for the DSSERVER servers and to establish two reserved servers for NFT. To limit the system resources available, the maximum number of servers is set to 10 for both server types. In this way, performance is improved with a minimum amount of system resources used. Notice that the SERVER function can be repeated; multiple instances of NSCONTROL functions are allowed on the same command line. :ALLOCATE DSSERVER.NET.SYS :NSCONTROL SERVER=NFT,2,10;SERVER=DSSERVER,,10 :NSCONTROL STATUS=SERVERS SERVER MIN MAX DEBUG PIN JOBNUM STATUS SERVICES LOOPBACK 0 300 OFF NFT 2 10 OFF 247 RESERVED 187 RESERVED DSSERVER 0 10 OFF NSSTATUS 0 300 OFF VTSERVER 0 300 OFF


MPE/iX 5.0 Documentation