$ACTIVATE

Function

To activate a particular level of JES2 checkpoint function. Once all MAS members have been migrated to JES2 z/OS V1R11, this command can be used to activate new JES2 functions for V1R11. If problems occur, $ACTIVATE,LEVEL=Z2 might be used to go back to a previous level of JES2 checkpoint processing.

Syntax


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

Parameters

LEVEL=

Specifies the checkpoint level to activate to.

z2

Activates the compatibility mode of JES2 processing. This allows pre-z/OS V1R11 JES2 members to coexist within a MAS that contains z/OS V1R11 JES2 members.

z11

Activates the full-function level of z/OS V1R11 JES2 processing. 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 and/or transaction job id.
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

This command requires system 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 control security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991 .

Processing Considerations

The $ACTIVATE,LEVEL=Z2 command should only be used if a z11 problem absolutely requires activation back to z2 checkpoint level.
The $ACTIVATE,LEVEL=Z11 command expands the JES2 checkpoint to support functions that are enabled with z11 checkpoint level. JES2 will reject the $ACTIVATE command if certain conditions are not met. There might be multiple reasons why z11 activation is not permitted. The command $DACTIVATE will provide an exhaustive list of reasons blocking checkpoint activation to z11 level. For all the reasons that block z11 activation, see $D ACTIVATE - Display current JES2 checkpoint level and MAS readiness for checkpoint activation to z11 level.
Extreme BERT shortage is the only reason $ACTIVATE,LEVEL=Z2 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

The $HASP895 message displays the current level or mode of the checkpoint.

The $HASP003 message indicates a reason why new functions cannot be activated.

The $HASP296 message displays the amount of space that must be added to the JES2 checkpoint in order to process the command.

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=Z2

     $HASP895  z2 CHECKPOINT MODE IS NOW ACTIVE
     $HASP895  $ACTIVATE, LEVEL=Z2
  $HASP895  JES2 CHECKPOINT MODE IS CURRENTLY Z2
  $HASP895  CURRENT CHECKPOINT SIZE IS 148 4K RECORDS.
  $HASP895  CURRENT NUMBER OF BERTS IS 500.
  $HASP895  PERCENT BERTS UTILIZED IS 27 PERCENT.

Illustrates a successful request for z2 activation. JES2 activates back to z2 checkpoint level. Activating to z2 level allows down-level MAS members (before JES2 z/OS V1R11) to join the MAS. Activating to z2 is only recommended when problems at z11 level prevent normal JES2 functioning.

Note: The increased limits for JQEs, JOEs and BERTs stays at z11 level.

 3   $ACTIVATE, LEVEL=Z11

     $HASP003  RC=(123),ACT
  $HASP003  RC=(123),ACTIVATE - BOTH z2 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 Z2
  $HASP895  CURRENT CHECKPOINT SIZE IS 148 4K RECORDS.
  $HASP895  CURRENT NUMBER OF BERTS IS 500.
  $HASP895  PERCENT BERTS UTILIZED IS 27 PERCENT.

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

 4   $ACTIVATE, LEVEL=Z11

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

JES2 attempts z11 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 z2.