Function

To specify multi-access spool definition and tuning parameters.

Parameters

AUTOEMEM|AUTOSYS={OFF|ON}

Specifies whether (ON) or not (OFF) this JES2 MAS member wants to have its work restarted if this member fails. If a MAS member has specified AUTOEMEM=ON and the MVS™ system where the member resides fails, its jobs will be warm–started if another active member in the same SYSPLEX has specified RESTART=YES on its MASDEF statement.

If you specify AUTOEMEM=ON but no other MAS member has RESTART=YES specified, the work active on this member will not be automatically restarted.

Note: The automatic restart management can restart jobs (if the job is registered with the automatic restart management) regardless of whether AUTOEMEM is ON or OFF.

DORMANCY=(mmmm,nnnn)

mmmm

The minimum time, in hundredths of seconds (0-3000), a member of a multi-access spool configuration must wait before it attempts to regain control of the checkpoint data set. This specification prevents any one member from monopolizing the checkpoint data set.

nnnn

The maximum time, in hundredths of seconds (100-6000), that a member can wait before it attempts to gain control of the checkpoint data set.

Attention:

1. If the value specified for nnnn is too small, excessive system time may be spent in unnecessary attempts to reacquire the checkpoint data set.
2. If the value specified for nnnn is too large, the start of certain functions and the responses to certain display commands may be delayed.

HOLD=nnnnnnnn

The minimum length of time, in hundredths of seconds (0-99999999), that a member of a multi-access spool configuration must maintain control of the checkpoint data set.

Note: Setting this parameter to a high value tends to limit access of other members of the configuration to the checkpoint data set.

LOCKOUT=nnnnn

The time interval, in hundredths of seconds (500-15000) from the first denied request for the checkpoint data set by a member of a multi-access spool configuration to the time that the configuration assumes the member controlling the checkpoint data set is inoperative. When this time interval has elapsed, JES2 issues the $HASP263 WAITING FOR ACCESS TO JES2 CHECKPOINT VOLUME message indicating a lockout situation, and then resets the time interval to the LOCKOUT value.

RESTART={No|Yes}

Specifies whether (YES) or not (NO) a JES2 MAS member can make the jobs associated with a JES2 MAS member that resided on a failed MVS member eligible for restart.

Note:

1. If you specify RESTART=YES, this member will restart any work associated with a member that specified AUTOEMEM=ON when the MVS that the member is running on failed.
2. If a JES2 member has been identified as the target of an Automatic Reconfiguration Facility takeover, specify RESTART=NO. For more information about the Processor Resource/Systems Manager™ (PR/SM™) environment to which this applies, see PR/SM Planning Guide.

SHARED={CHECK|NOCHECK}

Specifies whether the direct access volumes being used in the configuration for spool and checkpoint devices are to be marked as shared (CHECK) or non-shared (NOCHECK).

In a single-member environment, you must specify NOCHECK.

In a multi-access spool configuration, you must specify CHECK. The following are exceptions to this rule:

• In a test situation when isolated spool volumes are being used, you can specify NOCHECK.
• If the shared pack is damaged, the installation can use a non-shared pack to bring up one JES2 system.

SYNCTOL=nnn

The time interval, in seconds (0-300), that must expire before a JES2 member in a multi-access spool configuration is assumed to be inoperative.

Authority Required

This command requires system authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS system command group is assigned. The $T NODE(nnnn) command sets the command authority for a node.

This command requires control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Scope

Single member. This command will be in effect for this member only.

Depending on your installation's setup, however, you might want this command to be applied to all members of the MAS (to ensure a consistent environment across the MAS). If so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP843 message displays the current values of all the parameters.

JES2 specifies that this member of a sysplex no longer can have its jobs restarted through the automatic resetting of the software checkpoint data set. To see ,AUTOEMEM=OFF on a display console, you must enter the $D MASDEF command after entering the $T MASDEF command.