$D ACTIVATE - Display current JES2 checkpoint level and MAS readiness for checkpoint activation to Z22 level

Function

To display the current JES2 checkpoint level that is set by the $ACTIVATE command. If the current level is Z11, this command also displays an indication whether checkpoint activation to Z22 succeeds.

Syntax

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

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:

Current checkpoint mode (z11 or z22).
Current checkpoint configuration (z11 or z22):
- Number of BERTs in the checkpoint along with current utilization.
- Current checkpoint size in 4K pages.
¹Future checkpoint configuration after activation to z22 mode through the $ACTIVATE,LEVEL=Z22 command:
- Projected checkpoint size in 4K pages.
¹Indication of whether $ACTIVATE,LEVEL=Z22 succeeds along with all issues that prevent checkpoint activation to z22 level. The issues which might prevent z22 activation are as follows:
- CYL_MANAGED SUPPORT MUST BE ACTIVATED.
- ALL MAS MEMBERS ARE NOT AT THE REQUIRED PRODUCT/SERVICE LEVEL TO SUPPORT ACTIVATION. MAS MEMBERS MUST BE AT z/OS RELEASE 2.2.
- CKPT1 IS TOO SMALL BY XXXX 4K RECORDS.
- CKPT2 IS TOO SMALL BY XXXX 4K RECORDS.
Indications of problems that prevent any $ACTIVATE from being done currently:
- RC=(94),JOB/OUTPUT QUEUE ERROR DETECTED RC=XX. z22 ACTIVATION IS NOT ALLOWED. SEE DESCRIPTION OF HASP003 REASON CODE 94 FOR MORE INFORMATION.
- AN EXTREME BERT SHORTAGE PREVENTS z22 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 about extreme BERT shortage.
  JES2 displays the current checkpoint level and information that shows that the $ACTIVATE,LEVEL=Z22 command would fail because an extreme BERT shortage was previously encountered. The extreme BERT shortage prevents $ACTIVATE,LEVEL=Z22 and $ACTIVATE,LEVEL=Z11.
- CKPT1 IS NOT ACCESSIBLE.
- CKPT2 IS NOT ACCESSIBLE.
Notes:
- ¹This section only appears when the current checkpoint is z11.

Examples

 1   $D ACTIVATE

$HASP895  $DACTIVATE
$HASP895  JES2 CHECKPOINT MODE IS CURRENTLY Z22
$HASP895  THE CURRENT CHECKPOINT:
$HASP895  -- CONTAINS 500 BERTS AND BERT UTILIZATION IS 37
$HASP895     PERCENT. 
$HASP895  -- CONTAINS 244 4K RECORDS.

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

 2   $D ACTIVATE

$HASP895  $DACTIVATE
$HASP895  JES2 CHECKPOINT MODE IS CURRENTLY Z11
$HASP895  THE CURRENT CHECKPOINT:
$HASP895  -- CONTAINS 500 BERTS AND BERT UTILIZATION IS 37
$HASP895     PERCENT.
$HASP895  -- CONTAINS 173 4K RECORDS.
$HASP895 z22 CHECKPOINT MODE ACTIVATION WILL:                
$HASP895  -- EXPAND CHECKPOINT SIZE TO 243 4K RECORDS.       
$HASP895 z22 ACTIVATION WILL FAIL IF ISSUED FROM THIS 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 fails from this member.

 3   $D ACTIVATE

$HASP895 $DACTIVATE
$HASP895 JES2 CHECKPOINT MODE IS CURRENTLY Z11
$HASP895 THE CURRENT CHECKPOINT:
$HASP895 -- CONTAINS 500 BERTS AND BERT UTILIZATION IS 98
$HASP895 PERCENT.
$HASP895 -- CONTAINS 143 4K RECORDS.
$HASP895 z22 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 z22 ACTIVATION WILL FAIL IF ISSUED FROM THIS MEMBER.
$HASP895 THE FOLLOWING ISSUES PREVENT ACTIVATION:
$HASP895 -- AN EXTREME BERT SHORTAGE PREVENTS z22
$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 that shows that the $ACTIVATE,LEVEL=Z22 command would fail because an extreme BERT shortage was previously encountered. See the description of message $HASP051 for more information about extreme BERT shortage.

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

 4   $D ACTIVATE

$HASP895 $DACTIVATE
$HASP895  JES2 CHECKPOINT MODE IS CURRENTLY Z11
$HASP895  THE CURRENT CHECKPOINT:
$HASP895  -- CONTAINS 500 BERTS AND BERT UTILIZATION IS 26
$HASP895     PERCENT.
$HASP895  -- CONTAINS 143 4K RECORDS.
$HASP895  z22 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  z22 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 that shows that the $ACTIVATE,LEVEL=Z22 command would fail because CKPT1 and CKPT2 sizes are too small.

 5   $D ACTIVATE

$HASP895 $DACTIVATE
$HASP895  JES2 CHECKPOINT MODE IS CURRENTLY Z11
$HASP895  THE CURRENT CHECKPOINT:
$HASP895  -- CONTAINS 500 BERTS AND BERT UTILIZATION IS 26
$HASP895     PERCENT.
$HASP895  -- CONTAINS 157 4K RECORDS.
$HASP895  z22 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  z22 ACTIVATION WILL FAIL IF ISSUED FROM THIS MEMBER.
$HASP895     THE FOLLOWING ISSUES PREVENT ACTIVATION:
$HASP895  -- NOT ENOUGH FREE BERTS FOR z22 ACTIVATION.
$HASP895     A MINIMUM OF 1637 ADDITIONAL BERTS ARE REQUIRED
$HASP895     TO AVOID A CRITICAL BERT SHORTAGE.
$HASP895  -- CYL_MANAGED SUPPORT MUST BE ACTIVATED.

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