The Simultaneous Usage Profile (SU Profile) enables users to set parameters for use with SU. This profile is member HLIPROF in a PDS allocated to ddname FOCEXEC in the FOCUS Database Server startup JCL. The DCB attributes are the same as those for any FOCEXEC PDS.

You can include the following commands in the FOCUS Database Server profile:

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

where:

SET BINS

SET XFOCUSBINS

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/XFOCUSBINS are not set in the profile, the FOCUS Database Server calculates how many to allocate based on available storage.

Note that source users can issue the SET BINS and SET XFOCUSBINS commands for their own processing. Including these commands in the FOCUS Database Server profile affects only simultaneous usage processing.

SET CACHE

Cache memory buffers FOCUS or XFOCUS database pages between disk and BINS, reducing disk I/O. Issuing SET CACHE in the profile keeps the entire database in memory, improving performance. The default is no cache memory. See your FOCUS documentation for using cache memory with FOCUS files.

Note that 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 FOCUS Database Server profile, it only affects simultaneous usage processing.

SET SUSI

The FOCUS Database Server has the ability to check authorizations through an external security package on z/OS. This facility is activated through the SET SUSI=ON command in the profile.

The default value is OFF. The FOCUS SU Security interface is discussed in Protecting FOCUS Databases: the FOCUS/SU Security Interface (SUSI).

SET SUTABSIZ

Enables you to control the number of entries in the user table SU uses to track active users known to the external security system. This value can range from 2 to 256. The default value is 32.

SET COMMIT

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

SET PATHCHECK

Enables you to control whether the FOCUS Database Server determines the value of FOCURRENT by checking an updated segment and its parent segments in the path (SET PATHCHECK = ON, default), or by checking only the updated segment (SET PATHCHECK = OFF).

SET SUWEDGE

Keeps Master Files in memory on FOCUS Database Server 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.

Commands read from the profile and any errors are written to ddname HLIERROR. If HLIERROR is not allocated, the commands and errors are written to HLIPRINT.

The following error message applies specifically to the SU profile:

(F0C725) THE HLI PROFILE CONTAINS AN ERROR

Only certain SET commands may be issued in the HLI profile. Either a non-SET line was found, or an invalid SET command was issued. Check the member HLIPROF of the FOCEXEC dataset on MVS. The erroneous line was ignored.