Using the SU Profile

You can set several parameters for the FOCUS Database Server in the Simultaneous Usage Profile (SU Profile). These parameters can also be used to control a local HLI program.

The profile is named PROFILE HLI, with LRECL 80 and RECFM F. It should reside on a minidisk that the sink machine accesses.

You can include the following commands in the sink machine profile:

SET BINS = nn
SET XFOCUSBINS = nn
SET CACHE = nn
SET PATHCHECK = {ON|OFF}
SET SUWEDGE = {n|ddname} [, {n|ddname} ...]
SET COMMIT = {ON|OFF}

where:

SET BINS
SET XFOCUSBINS

Controls the number of I/O buffers for the server. A maximum of 1023 bins (which are shared by all users) is allowed. Set BINS or XFOCUSBINS to the maximum for optimal performance. If BINS and XFOCUSBINS are not set in the profile, the server uses the default value, 64.

Note that source users can use the SET BINS or SET XFOCUSBINS command for their own processing. If the command is included in the SU profile, it affects only Simultaneous Usage processing.

SET CACHE

Cache memory buffers FOCUS database pages between disk and BINS and reduces I/O to disk. Issuing the SET CACHE command in the profile keeps the entire database in memory and, therefore, improves performance. The default is no cache memory. See the Developing Applications Manual and your FOCUS Installation Guide for more information on using cache memory with FOCUS Files.

Note, as with the SET BINS command, source users can use the SET CACHE command for their own processing. If the SET CACHE command is included in the sink machine profile, it only affects Simultaneous Usage processing.

SET PATHCHECK

Enables you to control whether the server determines the value of FOCURRENT by checking an updated segment and its parent segments in the path (SET PATHCHECK = ON, the default), or by checking only the updated segment (SET PATHCHECK = OFF). The SET PATHCHECK command can be used only when COMMIT=ON for the server. SET PATHCHECK and the FOCURRENT field are discussed in SU and the FOCUS Language.

SET SUWEDGE

Keeps Master Files in memory on a sink machine even though no users are accessing the files. This enhances performance by eliminating repeated parsing of Master files on FOCUS Database Servers that have a large number of users running multiple applications using different files on the server.

You can specify that a number of files be wedged open, that specific named files be wedged open, or a combination of both. The maximum number of files that will be wedged open is 128, regardless of how many you specify. For complete information, see Improving Performance.

SET COMMIT

Specifies whether the sink machine accepts source users whose MODIFY or Maintain procedures include the COMMIT and ROLLBACK subcommands. For more information, see SU and the FOCUS Language.

The commands read from the profile and any errors are written to ddname HLIERROR. If HLIERROR is not allocated, the commands and errors will be written to HLIPRINT. If neither HLIERROR or HLIPRINT is allocated, errors are written to the terminal.

The following error message applies specifically to the SU profile: