Global Configuration

EXTSEC = {YES|NO}

where:

YES
Specifies the use of an external security system for validating access to MSO and to MVS data sets and resources. User Exit MSIDVER can effectively bypass External Security Verification. Each user receives a separate security profile. The MSO library FOCLIB.LOAD must be APF-authorized.

NO
Bypasses User Exit MSIDVER.

All users inherit the security profile of the MSO region itself. See MSO Security for further information. This command is mandatory in the configuration file; it does not default.

APF authorization is required.

Default: None.

EXTSEC must be specified.

SMFNUM = smfnumber

where:

smfnumber
Is a site-selected number for a user SMF record, from 128 to 255.

When SMFNUM=0 is specified, it has the effect of turning on internal usage accounting without writing SMF records; this would be used to enable utilization statistics to be displayed in the MSO Console and from the MVS console. The MSO Resource Manager also requires this specification. See MSO Usage Accounting for more information.

MSO must be APF-authorized if SMFNUM is specified. We recommend specifying SMFNUM=0 if you don't want to write SMF records, due to the other MSO features which require it.

APF authorization is required.

Default: 0, when running with APF authorization; otherwise disabled.

UNIQUE = {logid|secid}

where:

logid
Is a login ID.

secid
Is a security ID.

If this entry is omitted, MSO will allow any number of users to log on with the same LOGID or SECID.

APF authorization is not required.

Default: None

STORAGEBELOW = n

where:

n
Is the amount of virtual storage in kilobytes that must be available in the MVS below-the-line private area before a new user is allowed to log on. If omitted, the default is 200 (that is, 200K). This value may be specified as described in The Service Block, in which case it overrides the globally specified value. If the number you specify is beyond your maximum memory you will be unable to start your service.

APF authorization is not required.

Default: 200

STORAGEABOVE = n

where:

n
Is the amount of virtual storage in kilobytes that must be available in the MVS above-the-line private area before a new user is allowed to log on. If omitted, the default is 4096 (that is, 4M). This value may be specified as described in The Service Block, in which case it overrides the globally specified value.

APF authorization is not required.

Default: 4096

MAXSERVERS = n

where:

n
Is the maximum number of servers and FOCUS users that can be present on MSO at a time. MAXSERVERS may be specified to allow for adding additional FOCUS tasks, and should be set to the total number of subtasks that will be active in the address space.

APF authorization is not required.

Default: None

IDLELIM = nnnnnnn

where:

nnnnnnn
Is the number of seconds of idle time that are allowed before the MSO address space is shut down. All FOCUS users and all server tasks must be idle in order for this to take place.

IDLELIM may also be specified in the service block in which case it applies to a logged-on user, rather than the entire MSO address space. The maximum value that may be specified is 9999999.

APF authorization is not required.

Default: None

RACSP = nnn

where:

nnn
Allows you to select the MVS storage subpool used when SAF creates its security control blocks. In some circumstances, CA-ACF2 sites will experience better results by using subpool 255.

APF authorization is required.

Default: 230

FASTLOAD = load module

where:

load module
Names a reentrant or non-reentrant load module to be preloaded by the FastLoad Facility. This module must have an RMODE of ANY; FastLoad may not be used for modules that have RMODE 24. If the module specified is reentrant, then no copy is made, but the initial copy is kept in storage for all MSO users. Using FastLoad on a reentrant module causes the module to be loaded at MSO initialization time rather than at the time the module is first referenced by an MSO user; this has the effect of reducing storage fragmentation by preventing the use count from ever going back down to zero.

The FastLoad Facility should not be used on modules smaller than 200K or modules installed in the XLPA. See MSO Technical Description for a discussion of FastLoad Facility processing.

Use a separate record for each module to be preloaded.

APF authorization is required.

Default: None

APFAUTH = {EXTERNAL|INTERNAL}

where:

EXTERNAL
Allows you to allocate non-APF-authorized libraries (other than STEPLIB) to the MSO address space, or to individual MSO users, even when MSO itself is APF-authorized.

INTERNAL
Activates Internal APF Authorization. This feature is described in MSO Technical Description.

APF authorization is required.

Default: EXTERNAL

SZERO = {YES|NO}

where:

YES
Causes subpool 0 to be shared across tasks. It is required when VSAM files are allocated in the MSO JCL.

NO
Is used when VSAM files are not accessed, or when they are allocated to individual users with the DYNAM command.

APF authorization is not required.

Default: NO

MRM = {ON|OFF}

where:

ON
Turns the MSO Resource Manager on.

OFF
Turns the MSO Resource manager off.

MRM should normally be allowed to default; it will be activated whenever MSO is running with APF authorization and the SMFNUM has been specified or allowed to default. You should only deactivate MRM if a problem is suspected with the resource manager.

APF authorization is required.

Default: ON, if running with APF authorization and SMFNUM has been specified or allowed to default to 0.

FASTPDS = {ON|OFF}

where:

ON
Activates FASTPDS, causing MSO to read all partitioned data sets in the server's startup JCL and copy their directory information into memory. These tables of members are used for all future references to those libraries. The I/O to find the members is only done once, at initialization, and this results in faster access to data in the globally allocated libraries. When activated, these global files become read-only, and may not be updated by MSO users.

OFF
Deactivates FASTPDS.

APF authorization is not required.

Default: OFF.

MRM_PERCENT = nn

where:

nn
Is the threshold percentage of CPU that will cause a user to be reduced in priority by MRM. This number can range from 1 to 99.

APF authorization is required.

Default: 50

MRM_INTERVAL = nnnn

where:

nnnn
Is the second interval in which MRM will monitor all users to prevent any users from exceeding the MRM_PERCENT value. This number can range from 1 to 1440.

APF authorization is required.

Default: 10

SOS_PERCENT = nn

where:

nn
Is an integer representing a percentage between 0 and 99 percent.

Short on Storage specifies the percentage of storage utilization, which when exceeded, will cause a warning message to be issued via non-scrollable messages to WTO and MSOPRINT. The message destination can be altered with the Enhanced Message Routing Facility. If storage utilization falls below this value, a message is issued stating that the storage constraint has been relieved and the WTO message is deleted (unless suppressed by the Enhanced Message Routing Facility). The SOS_PERCENT check, if active, is made at every MRM_INTERVAL interval (MSO Resource Manager Interval).

Specifying 0 disables the SOS monitoring facility. SOS monitoring may be enabled or disabled dynamically by setting SOS_PERCENT to a non-0 or 0 value, respectively.

APF authorization is required.

Default: 0


Information Builders