$ACTIVATE - Activate a particular level of JES2 function

Function

Start of change Displays the current checkpoint level and whether the checkpoint data set is large enough to perform an activation. When all MAS members are migrated to JES2 z/OS V2R2, and any needed exit changes are made, this command is used to enable the z22 functions for V2R2. If problems occur, $ACTIVATE,LEVEL=Z11 might be used to go back to a previous level of JES2 checkpoint processing where these functions are no longer active. End of change

Syntax


>>-$ACTIVATE--,--LEVEL--=--+-z11-+-----------------------------><
                           '-z22-'

Parameters

LEVEL=

Specifies the checkpoint level to activate to.

z22

Activates verification that the checkpoint data set is large enough to hold the expanded checkpoint data areas and fails the command if not. This level activates the following new functions:

The limits for JQEs, JOEs, and BERTs are increased to JQEs=1,000,000, JOEs=2,500,000, and BERTs=2,500,000.
Increased SPOOL space cache.
Improvements to handle greater numbers of executing jobs.

z11

Activates fallback to z11 mode. JES2 ensures that the JQEs, JOEs, and BERTs above the area supported by previous releases are not in use and fails the command if so. This level upgrades JES2 checkpoint and enables the following functions:

SAPI (SSI 79) and Extended Status (SSI 80) can support selection by transaction job name or transaction job ID, or both.
Extended Status (SSI 80) can return transaction information (job name, job ID and owner) within the terse SYSOUT section.
JOE data area extensions supported by BERTs. Initial JOE data area extension includes transaction job name and transaction job ID.
JOE extension called JOX is fixed. JOX only exists in artificial JOE returned by the new $DOGJOE service.
The size of the JQX is increased by 32 bytes.
The limits for JQEs, JOEs, and BERTs are increased to JQEs=400,000, JOEs=1,000,000, and BERTs=1,000,000.

Authority Required

Start of change This command requires RACF command authentication. End of change

Processing Considerations

The $ACTIVATE,LEVEL=Z22 command expands the JES2 checkpoint to support functions that are enabled with Z22 checkpoint level. JES2 rejects the $ACTIVATE command if certain conditions are not met. There might be multiple reasons why Z22 activation is not permitted. The command $DACTIVATE provides an exhaustive list of reasons blocking checkpoint activation to Z22 level. For all the reasons that block Z22 activation, see $D ACTIVATE - Display current JES2 checkpoint level and MAS readiness for checkpoint activation to Z22 level.
Extreme BERT shortage is the only reason $ACTIVATE,LEVEL=Z22 would be disallowed. For more information on extreme BERT shortage, see $HASP051 message.

Scope

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

Messages

Start of change The $HASP895 message is issued in response to this command. End of change

Examples

 1   $ACTIVATE, LEVEL=Z11

     $HASP895  z11 CHECKPOINT MODE IS NOW ACTIVE
     $HASP895  $ACTIVATE, LEVEL=Z11
  $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 27 PERCENT.

Illustrates a successful request for z11 activation. JES2 activates the z11 functions documented above.

 2   $ACTIVATE, LEVEL=Z22

     $HASP895  JES2 CHECKPOINT LEVEL IS NOW Z/OS 2.2.

Illustrates a successful request for z22 activation. JES2 activates to a z22 checkpoint level. Activating to z22 level allows MAS members to join the MAS.

Note: The increased limits for JQEs, JOEs, and BERTs stays at Start of change

z22

level.

 3   $ACTIVATE, LEVEL=Z11

     $HASP003  RC=(123),ACT
  $HASP003  RC=(123),ACTIVATE - BOTH z22 AND z11 CHECKPOINT
  $HASP003  ACTIVATION ARE DISALLOWED DUE TO EXTREME
  $HASP003  BERT SHORTAGE. JES2 IS IN A NON-STABLE
  $HASP003  STATE. RESTART JES2 AS SOON AS MORE BERTS
  $HASP003  HAVE BEEN MADE AVAILABLE.
     $HASP895  $ACTIVATE,LEVEL=Z11
  $HASP895  JES2 CHECKPOINT MODE IS CURRENTLY Z22
  $HASP895  CURRENT CHECKPOINT SIZE IS 148 4K RECORDS.
  $HASP895  CURRENT NUMBER OF BERTS IS 500.
  $HASP895  PERCENT BERTS UTILIZED IS 27 PERCENT.

Start of change JES2 attempts z11 activation but fails because an extreme BERT shortage has previously been encountered. Extreme BERT shortage blocks both z11 and z22 activations. The $HASP895 message indicates that the checkpoint level remains at z22. Run $D ACTIVATE command for a complete list of situations that might prevent z11 activation. End of change

 4   $ACTIVATE, LEVEL=z22

     $HASP296 MEMBER N1M1 -- CKPT1 SYS1.JESCKPT1 ON SPOOL1 - SPACE
     INSUFFICIENT -- 16 TRACKS NEEDED
     $HASP003 RC=(116),ACT
  $HASP003 RC=(116),ACTIVATE  - z22 CHECKPOINT ACTIVATION CANNOT
  $HASP003 BE PERFORMED. CHECKPOINT DATA SETS ARE
  $HASP003  TOO SMALL.  ISSUE COMMAND $D ACTIVATE FOR
  $HASP003  MORE INFORMATION.
     $HASP895 $ACTIVATE ,LEVEL=z22
  $HASP895  JES2 CHECKPOINT MODE IS CURRENTLY z11
  $HASP895  CURRENT CHECKPOINT SIZE IS 170 4K RECORDS.
  $HASP895  CURRENT NUMBER OF BERTS IS 1900.
  $HASP895  PERCENT BERTS UTILIZED IS 6 PERCENT.

JES2 attempts Start of change z22 End of change activation but fails because the size of the current CKPT1 data set is too small by 16 tracks. The $HASP895 message indicates that the checkpoint level remains at z11.