Function
To display multi-access spool
definition and tuning parameters.
Syntax
>>-$D--MASDEF--+-----------------+--+-------------+------------->
'-,----AUTOEMEM---' '-,--CKPTLOCK-'
>--+-------------+--+-------------+--+-------------+------------>
'-,--COLDTIME-' '-,--COLDVRSN-' '-,--DORMANCY-'
>--+---------+--+------------+--+----------------+-------------->
'-,--HOLD-' '-,--LOCKOUT-' '-,--+-OWNMEMB-+-'
'-OWNSID--'
>--+-------------+--+-------------+--+------------+------------->
'-,--QREBUILD-' '-,--QUESHELD-' '-,--RESTART-'
>--+------------+--+-----------+--+------------+---------------->
'-,--RSVHELD-' '-,--SHARED-' '-,--SYNCTOL-'
>--+-------------+--+-------------+----------------------------><
'-,--WARMTIME-' '-,--XCFGRPNM-'
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 AUTOEMEM
on.
- STOPPING
- This MAS member's jobs are in the process of turning AUTOEMEM
off.
- CKPTLOCK
- Displays
whether message $HASP479 is issued during a cold or warm start of
JES2. The value displayed will be one of the following:
- INFORM
- JES2 will 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.
Instead, JES2 issues message $HASP457 to indicate that the member
has bypassed confirmation of the lock release.
- 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.
- DORMANCY
- Displays
the minimum and maximum time, in hundredths of seconds, that a member
of the MAS must wait before it attempts to regain control of the checkpoint
data set.
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.
- 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.
- QUESHELD
- This
information is displayed if this JES2 member has control of, and is
actively updating, the checkpoint data set.
Scope: Single
member.
- 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, SA23-1399.
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, SA32-0991.
Scope
The scope of this command
varies by parameter. See the description of each parameter for its
scope.
Some parameters on this command will display information
about the entire MAS, while other parameters will 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, SA38-0666 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=IBM1,AUTOEMEM=OFF,CKPTLOCK=ACTION,
$HASP843 COLDTIME=(1994.192,12:37:29),COLDVRSN=SP 5.2.0,
$HASP843 DORMANCY=(100,500),HOLD=30,LOCKOUT=1000,
$HASP843 RESTART=NO,SHARED=NOCHECK,SYNCTOL=120,
$HASP843 XCFGRPNM=POK,QREBUILD=0
JES2 displays information about the MAS environment.