OA05813: NAME/TOKEN PAIR CREATE SERVICE IEANTCR PERSISTENCE OPTIONS IEANT_CHECKPOINTOK AND IEANT_NOCHECKPOINT NOT DOCUMENTED

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as documentation error.

Error description

  • Changes were made to Name/Token Pair support at R703 to allow
    Checkpoint/Restart for owners of Task Level Name/token Pairs.
    New Persistence options IEANT_NOCHECKPOINT and
    IEANT_CHECKPOINTOK were added.  IEANT_CHECKPOINTOK indicates to
    Checkpoint/Restart that the Name/Token Pair will be valid
    after the restart (see DFSMSdfp Checkpoint/Restart SC26-7401).
    zOS Assembler Services Reference and Guide were not updated
    with the new options.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users of IEANTCR and Checkpoint/Restart at   *
    *                 HBB7703 and above.                           *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    Changes were made to Name/Token Pair support at R703 to allow
    Checkpoint/Restart for owners of Task Level Name/token Pairs.
    New Persistence options IEANT_NOCHECKPOINT and
    IEANT_CHECKPOINTOK were added.  IEANT_CHECKPOINTOK indicates to
    Checkpoint/Restart that the Name/Token Pair will be valid
    after the restart (see DFSMSdfp Checkpoint/Restart SC26-7401).
    zOS Assembler Services Reference and Guide were not updated
    with the new options.
    

Problem conclusion

  • These updates apply to HBB7703 and above:
    
    SA22-7607-04 MVS Assm Services Reference IAR-XCT
    
    11.1.2 Programming Requirements
    
    Add to '* Name/Token Persistence Constants'
    
    | IEANT_NOCHECKPOINT     EQU     0
    | IEANT_CHECKPOINTOK     EQU     2
    
    11.1.8 Parameters
    
    ,persist_option
    |  Specifies a fullword that contains an integer indicating if
    |  Checkpoint/Restart can be issued if the program has this
    |  task-level name/token pair.
    |
    | - 0 - checkpoint is not permitted
    | - 2 - checkpoint is permitted
    |
    | Note: Only task-level name/token pairs can permit checkpoint.
    | You must specify 0 for all other levels.
    
    11.1.10 Return and Reason Codes
    
    Hexadecimal Return Code 24
    
      Action:
    | - For task-level name/token pairs, you must specify zero or
    |   two for the persist_option.
    | - For home or primary address space level name/token pairs,
    |   you must specify zero for the persist_option.
    
    
    SA22-7610-04 MVS Auth Assm Services Reference ENF-IXG
    
    32.1.2 Programming Requirements
    
    Add to '* Name/Token Persistence Constants'
    
    
    | IEANT_NOCHECKPOINT     EQU     0
    | IEANT_CHECKPOINTOK     EQU     2
    
    32.1.8 Parameters
    
    ,persist_option
       Specifies a fullword that contains an integer indicating if a
       system-level name/token pair should persist after the
       creating address space's job step task terminates
    |  or if Checkpoint/Restart can be issued if the program has
    |  this task-level name/token pair. If a program has
    |  non-task-level name/token pairs or has task-level name/token
    |  pairs that did not specify IEANT_CHECKPOINTOK, the program
    |  cannot take a checkpoint.
    |
      - 0 - system level pair will not persist
    |       and checkpoint is not permitted
      - 1 - system-level pair will persist
    | - 2 - checkpoint is permitted
    |
    
      Note: Only system-level name/token pairs can persist after the
      creating task terminates.
    | Only task-level name/token pairs can permit checkpoint.
      You must specify 0 for all other levels.
    
     32.1.10 Return and Reason Codes
    
    Hexadecimal Return Code 24
    
      Action:
    | - For system-level name/token pairs, you must specify
    |   zero or one for the persist_option.
    | - For task-level name/token pairs, you must specify zero or
    |   two for the persist_option.
    | - For home or primary address space level name/token pairs,
    |   you must specify zero for the persist_option.
    
    
    SA22-7605-04  z/OS MVS Assembler Services Guide
    
    18.4 Using Checkpoint/Restart with Name/Token Pairs
    
    Change the first bullet to:
    
    | Task-level name/token pairs not created with a persist_option
    | value of 2 are owned by the task issuing the CHKPT macro.
    

Temporary fix

Comments

APAR Information

  • APAR number

    OA05813

  • Reported component name

    5752 SUPVR CONT

  • Reported component ID

    5752SC1C5

  • Reported release

    707

  • Status

    CLOSED DOC

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2003-12-03

  • Closed date

    2004-02-19

  • Last modified date

    2004-04-20

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Publications Referenced
SA22760704 SA22761004 SA22760504    

Fix information

Applicable component levels



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

z/OS family

Software version:

707

Operating system(s):

MVS, z/OS

Reference #:

OA05813

Modified date:

2004-04-20

Translate my page

Machine Translation

Content navigation