The Service Block

The service block replaces the MAXFOC and NUMFOC specifications, and defines the characteristics of the subtasks that MSO is to run. Multiple service blocks may be specified. The parameters in the service block are positional, and only apply to the service block in which they are placed. All service blocks must be placed after all other entries in the configuration file.

The service specified in the first service block will become the default service for VTAM users and will be shown on the VTAM logon screen (see Figure 4). If multiple service blocks are specified, you should ensure the desired default service is specified first. The maximum number of service blocks that may be specified is 20.

Note: CICS- and TSO-connected users may only access SERVICE=FOCUS. Only VTAM-connected users have access to other services. APF authorization is not required in the service block.

SERVICE = name

where:

name

Specifies FOCUS as the service name. The service named in the first service block in the configuration file will be the default service on the VTAM logon screen.

Default: None

PROGRAM = name

where:

name

Specifies FOCUS as the program name.

NUMBER_READY = nnn

where:

nnn

Is the number of initial FOCUS copies loaded into the MSO address space. These FOCUS copies are the non-sharable part of FOCUS. All MSO users share one copy of the sharable part of FOCUS. When installing MSO, it is convenient to make NUMBER_READY = 1, because the higher this number is, the longer it takes MSO to initialize. NUMBER_READY can later be increased to a larger number. This value is equivalent to the old NUMFOC parameter.

Default: 1

MAXIMUM = nnn

where:

nnn

Is the maximum number of users allowed to log onto MSO. This value is equivalent to the old MAXFOC parameter.

Default: 1

TIMEOUT = nnn

where:

nnn

Specifies a maximum time, in seconds, a FOCUS task may be in a terminal wait. If the limit is exceeded, the task is ended and its resources are freed.

Note: If a user is waiting for FOCUS to reply, the TIMEOUT clock is not running.

Thus, to cause a user to timeout after 20 minutes, one would code

TIMEOUT = 1200

The maximum value that may be specified is 9999999. The default is to disable the timeout facility.

Default: None

IDLELIM = nnn

where:

nnn

Specifies a maximum time, in seconds that a user's task may be in a wait. This includes waiting on all external events, not just terminal wait (in contrast to TIMEOUT above). If the limit is exceeded, the task is ended and its resources are freed. This is distinct from the global IDLELIM setting (see Global Configuration), which applies to the entire MSO region. Whichever IDLELIM is smaller will apply to users of this service. The maximum value that may be specified is 9999999.

Default: None

PRTYGROUP = n

where:

n

Specifies the default MRM priority for all users of this service, from 1 to 15.

Default: 7

STORAGEBELOW = n

where:

n

Specifies STORAGEBELOW for this service only, overriding the default or globally-specified value. See Global Configuration for a description of the global STORAGEBELOW parameter.

Default: Use the global STORAGEBELOW value.

STORAGEABOVE = n

where:

n

Specifies STORAGEABOVE for this service only, overriding the default or globally-specified value. See Global Configuration for a description of the global STORAGEABOVE parameter.

Default: Use the global STORAGEABOVE value.

LOGON_TIMEOUT = nnn

where:

nnn

Is a positive number between 30 and 100000, representing the number of seconds the MSO VTAM Logon screen is displayed before being canceled.

It allows you to set a maximum number of seconds that the MSO Logon screen is displayed. When that period expires the connection is broken and the user is returned to the VTAM Logon screen. This frees up the VTAM session.