$D MASDEF - Display the multi-access spool environment
Function
To display multi-access spool definition and tuning parameters.
Syntax
Parameters
- AUTOEMEM
- Displays
the status of this JES2 MAS member's AUTOEMEM function. They can
be:
- ON
- This MAS member's jobs can be restarted.
- OFF
- This MAS member's jobs cannot be reset automatically.
- STARTING
- This MAS member's jobs are in the process of turning on AUTOEMEM.
- STOPPING
- This MAS member's jobs are in the process of turning off AUTOEMEM.
- CKPTLOCK
- Displays whether message $HASP479
is issued during a cold or warm start of JES2. The value that is displayed is one of the following:
- INFORM
- JES2 does not issue message $HASP479 during a cold or warm start of JES2 if:
- The checkpoint lock cannot be obtained, and
- The member ID of the member holding the lock is the same as the one being started.
- ACTION
- JES2 issues message $HASP479 in all cases.
- COLDTIME
- Displays
the time of the cold start (yyyy.ddd,hh:mm:ss).
Scope: MAS-wide.
- COLDVRSN
- Displays
the version of JES2 that was cold started.
Scope: MAS-wide.
- CYCLEMGT
- Specifies how access of individual members to the checkpoint data is controlled. The value that
is displayed is one of the following:
- MANUAL
- JES2 uses HOLD and DORMANCY parameters provided on MASDEF initialization statement or $TMASDEF command.
- AUTO
- JES2 will automatically manages HOLD and DORMANCY on all active member based on the current workload in MAS.
Scope: MAS-wide.
- DORMANCY
- Displays
the minimum and maximum time, in hundredths of seconds, that a member
of the multi-access spool (MAS) must wait before it attempts to regain
control of the checkpoint data set.
Scope: Single member.
- 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).
- ESUBSYS
- Displays the name of the emergency subsystem of this member.
Scope: Single member.
- HOLD
- Displays
the minimum length of time, in hundredths of seconds, that a member
of a multi-access spool configuration must maintain control of the
checkpoint data set.
Scope: Single member.
- LOCKOUT
- Displays
the time interval, in hundredths of seconds, 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.
Scope: Single member.
- OWNMEMB|OWNSID
- Displays the member name of this member.
Scope: Single member.
- QUESHELD
- This
information is displayed if this JES2 member has control of, and is
actively updating, the checkpoint data set.
Scope: Single member.
- QREBUILD
- Displays
the count of times that the job queue has been rebuilt since the last
all-member warm start or cold start.
Scope: MAS-wide.
- RESTART
- Displays
whether (Yes) or not (No) a JES2 MAS member can make the jobs on a
failed member eligible for restart. Note:
- If the job is registered with the automatic restart manager, the automatic restart manager restarts jobs regardless of the settings of the AUTOEMEM= and RESTART= parameters.
- If a JES2 member has been identified as the target of an automatic reconfiguration facility takeover, specify RESTART=NO. For more information, see z/OS MVS Setting Up a Sysplex.
Scope: Single member.
- RSVHELD
- This
information is displayed if this JES2 member has control of, but is
not actively updating, the checkpoint data set.
Scope: Single member.
- SHARED
- Displays
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).
Scope: Single member.
- SYNCTOL
- Displays
the time interval, in seconds, that must expire before a JES2 member
in a multi-access spool configuration is assumed to be inoperative.
Scope: Single member.
- WARMTIME
- Displays
the time of the last all-member warm start (yyyy.ddd,hh:mm:ss).
Scope: MAS-wide.
- XCFGRPNM
- Displays
the multi-access spool configuration's XCF groupname. The default
is the local node name. The node name is defined on the NAME= parameter
of the local NODE(nnnn) initialization statement.
Scope: MAS-wide.
Authority Required
This command requires display authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.
This command requires read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide.
Scope
The scope of this command varies by parameter. See the description of each parameter for its scope.
Some parameters on this command display information about the entire MAS, while other parameters display information about this member only.
You might want to use the parameters for this command to get information about all members of 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.
Example
1 $d masdef
$HASP843 MASDEF OWNMEMB=N1M1,AUTOEMEM=OFF,CKPTLOCK=ACTION,
$HASP843 COLDTIME=(2017.136,13:12:49),COLDVRSN=z/OS 2.3,
$HASP843 ENFSCOPE=SYSPLEX,DORMANCY=(25,500),HOLD=25,
$HASP843 LOCKOUT=1000,RESTART=NO,SHARED=NOCHECK,
$HASP843 SYNCTOL=120,XCFGRPNM=POK,QREBUILD=0,
$HASP843 CYCLEMGT=MANUAL,ESUBSYS=HASP
JES2 displays information about the MAS environment.