Using the SU Profile
The Simultaneous Usage Profile (SU Profile) enables users to set parameters for use SU.
This profile is member HLIPROF in a PDS allocated to ddname FOCEXEC in the FOCUS
Database Server startup JCL. The DCBs 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} [, {n|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, 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 Using the FOCUS/SU Security Interface (SUSI).
- SET SUTABSIZE
- 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 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.
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 file PROFILE HLI on CMS or member HLIPROF of the
FOCEXEC dataset on MVS. The erroneous line was ignored.