$D ACTIVATE

Function

To display the current JES2 checkpoint level that is set by the $ACTIVATE command. If the current level is z2, this command also displays an indication whether checkpoint activation to z11 will succeed.

Syntax


>>-$D--ACTIVATE------------------------------------------------><

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

MAS-wide. The command is in effect across the entire MAS.

Messages

The $HASP895 message displays the current checkpoint level or mode. The $HASP895 message might display up to four levels of information in the following order:

Current checkpoint mode (z2 or z11).
Current checkpoint configuration (z2 or z11):
- Number of BERTs in the checkpoint along with current utilization.
- Current checkpoint size in 4K pages.
Future checkpoint configuration after activation to z11 mode through the $ACTIVATE,LEVEL=Z11 command:
- Number of BERTs along with projected utilization.
- Projected checkpoint size in 4K pages.
Note: This section only appears when the current checkpoint is z2.
Indication of whether $ACTIVATE,LEVEL=Z11 will succeed along with all issues that prevent checkpoint activation to z11 level. The issues which might prevent z11 activation are as follows:
- LARGEDS SUPPORT MUST BE ACTIVATED.
- RC=(94),JOB/OUTPUT QUEUE ERROR DETECTED RC=XX. z11 ACTIVATION IS NOT ALLOWED. SEE DESCRIPTION OF HASP003 REASON CODE 94 FOR MORE INFORMATION.
- ALL MAS MEMBERS ARE NOT AT THE REQUIRED PRODUCT/SERVICE LEVEL TO SUPPORT ACTIVATION. MAS MEMBERS MUST BE AT z/OS RELEASE 11.
- AN EXTREME BERT SHORTAGE PREVENTS z11 CHECKPOINT ACTIVATION. JES2 IS IN A NON-STABLE STATE. RESTART JES2 AS SOON AS MORE BERTS HAVE BEEN MADE AVAILABLE.
  Note: See description of message $HASP051 for more information on extreme BERT shortage.
  JES2 displays the current checkpoint level and information which shows that the $ACTIVATE,LEVEL=Z11 command would fail because an extreme BERT shortage has been previously encountered. The extreme BERT shortage prevents $ACTIVATE,LEVEL=Z11 and $ACTIVATE,LEVEL=Z2.
- NOT ENOUGH FREE BERTS FOR z11 ACTIVATION. A MINIMUM OF XXXX ADDITIONAL BERTS ARE REQUIRED TO AVOID A CRITICAL BERT SHORTAGE.
  Note: See description of message $HASP052 for more information.
- CKPT1 IS NOT ACCESSIBLE.
- CKPT2 IS NOT ACCESSIBLE.
- CKPT1 IS TOO SMALL BY XXXX 4K RECORDS.
- CKPT2 IS TOO SMALL BY XXXX 4K RECORDS.
Note: This section only appears when the current checkpoint is z2.

Examples

 1   $D ACTIVATE

$HASP895 $DACTIVATE
  $HASP895  JES2 CHECKPOINT MODE IS CURRENTLY Z11
  $HASP895  CURRENT CHECKPOINT SIZE IS 155 4K RECORDS.
  $HASP895  CURRENT NUMBER OF BERTS IS 500.
  $HASP895  PERCENT BERTS UTILIZED IS 26 PERCENT.

 1   $D ACTIVATE

$HASP895  $DACTIVATE
$HASP895  JES2 CHECKPOINT MODE IS CURRENTLY Z11
$HASP895  THE CURRENT CHECKPOINT:
$HASP895  -- CONTAINS 650 BERTS AND BERT UTILIZATION IS 20
$HASP895     PERCENT. 
$HASP895  -- CONTAINS 158 4K RECORDS.

JES2 displays the current checkpoint level and information when the checkpoint is already at z11 activation level.

 2   $D ACTIVATE

$HASP895 $DACTIVATE
  $HASP895  JES2 CHECKPOINT MODE IS CURRENTLY Z2
  $HASP895  THE CURRENT CHECKPOINT:
  $HASP895  -- CONTAINS 500 BERTS AND BERT UTILIZATION IS 26
  $HASP895     PERCENT.
  $HASP895  -- CONTAINS 148 4K RECORDS.
  $HASP895  z11 CHECKPOINT MODE ACTIVATION WILL:
  $HASP895  -- EXPAND CHECKPOINT SIZE TO 155 4K RECORDS.
  $HASP895  -- REQUIRE 20 ADDITIONAL BERTS AND UTILIZATION
  $HASP895     WOULD REACH 26 PERCENT.
  $HASP895  z11 ACTIVATION WILL SUCCEED IF ISSUED FROM THIS MEMBER.

JES2 displays the current checkpoint level and information which shows that the $ACTIVATE,LEVEL=Z11 command should succeed if issued at this point of time.

 2   $D ACTIVATE

$HASP895  $DACTIVATE
$HASP895  JES2 CHECKPOINT MODE IS CURRENTLY Z2
$HASP895  THE CURRENT CHECKPOINT:
$HASP895  -- CONTAINS 650 BERTS AND BERT UTILIZATION IS 20
$HASP895     PERCENT.
$HASP895  -- CONTAINS 158 4K RECORDS.
$HASP895  $ACTIVATE TO z2 MODE WILL FAIL IF ISSUED FROM THIS 
$HASP895  MEMBER. 
$HASP895  THE FOLLOWING ISSUES PREVENT ACTIVATION:
$HASP895  -- A SPOOL IS USING NON-DEFAULT DATA SET NAME.

JES2 displays the current checkpoint level and information explaining why the command will fail from this member.

 3   $D ACTIVATE

$HASP895 $DACTIVATE
$HASP895  JES2 CHECKPOINT MODE IS CURRENTLY Z2
$HASP895  THE CURRENT CHECKPOINT:
$HASP895  -- CONTAINS 500 BERTS AND BERT UTILIZATION IS 98
$HASP895     PERCENT.
$HASP895  -- CONTAINS 143 4K RECORDS.
$HASP895  z11 CHECKPOINT MODE ACTIVATION WILL:
$HASP895  -- EXPAND CHECKPOINT SIZE TO 155 4K RECORDS.
$HASP895  -- REQUIRE 300 ADDITIONAL BERTS AND UTILIZATION
$HASP895     WOULD REACH 158 PERCENT.
$HASP895  z11 ACTIVATION WILL FAIL IF ISSUED FROM THIS MEMBER.
$HASP895  THE FOLLOWING ISSUES PREVENT ACTIVATION:
$HASP895  -- AN EXTREME BERT SHORTAGE PREVENTS z11
$HASP895     CHECKPOINT ACTIVATION. JES2 IS IN A
$HASP895     NON-STABLE STATE. RESTART JES2 AS SOON AS
$HASP895     MORE BERTS HAVE BEEN MADE AVAILABLE.

JES2 displays the current checkpoint level and information which shows that the $ACTIVATE,LEVEL=Z11 command would fail because an extreme BERT shortage has previously been encountered. See the description of message $HASP051 for more information on extreme BERT shortage.

Note: The extreme BERT shortage prevents $ACTIVATE,LEVEL=Z11 and $ACTI VATE,LEVEL=Z2.

 4   $D ACTIVATE

$HASP895 $DACTIVATE
$HASP895  JES2 CHECKPOINT MODE IS CURRENTLY Z2
$HASP895  THE CURRENT CHECKPOINT:
$HASP895  -- CONTAINS 500 BERTS AND BERT UTILIZATION IS 26
$HASP895     PERCENT.
$HASP895  -- CONTAINS 143 4K RECORDS.
$HASP895  z11 CHECKPOINT MODE ACTIVATION WILL:
$HASP895  -- EXPAND CHECKPOINT SIZE TO 398 4K RECORDS.
$HASP895  -- REQUIRE 200 ADDITIONAL BERTS AND UTILIZATION
$HASP895     WOULD REACH 66 PERCENT.
$HASP895  z11 ACTIVATION WILL FAIL IF ISSUED FROM THIS MEMBER. 
$HASP895     THE FOLLOWING ISSUES PREVENT ACTIVATION
$HASP895  -- CKPT1 IS TOO SMALL BY 255 4K RECORDS
$HASP895  -- CKPT2 IS TOO SMALL BY 255 4K RECORDS.

JES2 displays the current checkpoint level and information which shows that the $ACTIVATE,LEVEL=Z11 command would fail because CKPT1 and CKPT2 sizes are too small.

 5   $D ACTIVATE

$HASP895 $DACTIVATE
$HASP895  JES2 CHECKPOINT MODE IS CURRENTLY Z2
$HASP895  THE CURRENT CHECKPOINT:
$HASP895  -- CONTAINS 500 BERTS AND BERT UTILIZATION IS 26
$HASP895     PERCENT.
$HASP895  -- CONTAINS 157 4K RECORDS.
$HASP895  z11 CHECKPOINT MODE ACTIVATION WILL:
$HASP895  -- EXPAND CHECKPOINT SIZE TO 181 4K RECORDS.
$HASP895  -- REQUIRE 1637 ADDITIONAL BERTS AND UTILIZATION
$HASP895     WOULD REACH 426 PERCENT.
$HASP895  z11 ACTIVATION WILL FAIL IF ISSUED FROM THIS MEMBER.
$HASP895     THE FOLLOWING ISSUES PREVENT ACTIVATION:
$HASP895  -- NOT ENOUGH FREE BERTS FOR z11 ACTIVATION.
$HASP895     A MINIMUM OF 1637 ADDITIONAL BERTS ARE REQUIRED
$HASP895     TO AVOID A CRITICAL BERT SHORTAGE.
$HASP895  -- LARGEDS SUPPORT MUST BE ACTIVATED.

JES2 displays the current checkpoint level and information which shows that the $ACTIVATE,LEVEL=Z11 command would fail because critical BERT shortage and LARGEDS support must be activated.