$T MASDEF - Control the multi-access spool environment
Function
To specify multi-access spool definition and tuning parameters.
Syntax
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. - CYCLEMGT=MANUAL|AUTO
- Specifies how access of individual members to the checkpoint data is controlled.
- 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:- If the value specified for nnnn is too small, excessive system time may be spent in unnecessary attempts to reacquire the checkpoint data set.
- If the value specified for nnnn is too large, the start of certain functions and the responses to certain display commands may be delayed.
- ENFSCOPE=JESPLEX/SYSPLEX
- Displays whether ENF signals 58, 70, and 78 are broadcast to all systems in the SYSPLEX (ENFSCOPE=SYSPLEX) or only to all systems in the JESPLEX (ENFSCOPE=JESPLEX). JESPLEX means systems in the multi-access spool (MAS).
- 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:
- 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.
- 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.
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 for more information on using the ROUTE *ALL command.
Messages
The $HASP843 message displays the current values of all the parameters.
Examples
1 $T MASDEF,HOLD=1000,LOCKOUT=5000
$HASP843 MASDEF OWNMEMB=IBM1,AUTOEMEM=OFF,CKPTLOCK=ACTION,
$HASP843 COLDTIME=(1993.295,13:52:35),COLDVRSN=SP 5.1.0,
$HASP843 DORMANCY=(100,500),HOLD=1000,LOCKOUT=5000,
$HASP843 RESTART=NO,SHARED=NOCHECK,SYNCTOL=120,
$HASP843 XCFGRPNM=POK
2 $T MASDEF,RESTART=YES,AUTOEMEM=ON
$HASP843 MASDEF OWNMEMB=IBM1,AUTOEMEM=STARTING,CKPTLOCK=ACTION,
$HASP843 COLDTIME=(1993.295,13:52:35),COLDVRSN=SP 5.1.0,
$HASP843 DORMANCY=(100,500),HOLD=1000,LOCKOUT=5000,
$HASP843 RESTART=YES,SHARED=NOCHECK,SYNCTOL=120,
$HASP843 XCFGRPNM=POK
3 $T MASDEF,AUTOEMEM=OFF
$HASP843 MASDEF OWNMEMB=IBM1,AUTOEMEM=STOPPING,CKPTLOCK=ACTION,
$HASP843 COLDTIME=(1993.295,13:52:35),COLDVRSN=SP 5.1.0,
$HASP843 DORMANCY=(100,500),HOLD=1000,LOCKOUT=5000,
$HASP843 RESTART=YES,SHARED=NOCHECK,SYNCTOL=120,
$HASP843 XCFGRPNM=POK
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.