z/OS JES2 Commands
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


$D MASDEF - Display the multi-access spool environment

z/OS JES2 Commands
SA32-0990-00

Function

To display multi-access spool definition and tuning parameters.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-$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:
  1. 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.
  2. 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.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014