IBM Support

PI14361: ALLOW DFHSTUP TO READ FROM STANDARD LABELED TAPES

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You are using DFHSTUP to process a tape file. However you
    cannot get DFHDFOU to create an unlabeled tape. This causes
    problems for you because DFHSTUP can only process unlabeled
    tapes.
    
    Additional Symptom(s) Search Keyword(s): DFHDFOU DFHSTUP VTAPE
    label labeled unlabelled KIXREVRER
    MSGDFHEV9920 MSGDFHEV9920S DFHEV9920 DFHEV9920S EV9920S EV9920
    9920S 9920
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHSTUP cannot read from standard       *
    *                      labeled tapes.                          *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    The DFHSTUP DEVICE=TAPE parameter provides the ability to read
    from an unlabeled tape. However, the sample JCL on page 105
    of the CICS TS for VSE/ESA Operations and Utilities Guide shows
    a TLBL for a labeled tape, but that is not correct. The ASSGN
    for SYS020 is correct, and is the only JCL statement that is
    needed to define an unlabeled tape.
    
    If DFHSTUP is executed with DEVICE=TAPE and SYS020 is assigned
    to a tape drive with a labeled tape, it will attempt to read
    the VOL1 label as a data record in the SORT E15 exit. The exit
    will terminate with an error and DFHSTUP will issue ABENDs.
    
    0S28I ABEND ISSUED. USER ABEND CODE=001, REASON CODE=000000CA
    and
    0S28I ABEND ISSUED. USER ABEND CODE=001, REASON CODE=000000D5
    
    DEVICE=TAPE will cause DFHSTUP to use a DTFMT that is defined
    with FILABL=NO on DEVADDR=SYS020.
    
    Additional keywords: MSG0S28I ABEND001 ABENDU001 ABENDU0001
    

Problem conclusion

  • DFHSTUP has been changed to allow the parameter DEVICE=SLTAPE.
    
    When this is used, DFHSTUP uses a DTFMT with FLABL=STD and
    DEVADDR=SYS020, and this allows a standard labeled tape to be
    used as input.
    
    The manual CICS TS for VSE/ESA Operations Guide and Utilities
    Guide SC33-1654-09 has been changed as follows.
    
    Page 105
    
    if on standard labeled tape use
    
    // TLBL DFHSTAT, ....
    // ASSGN SYS020,cuu
    
    if on unlabeled tape use
    
    // ASSGN SYS020,cuu
    
    Page 107
    
    DEVICE= DISK|TAPE|SLTAPE}
            ----
    
    Code this parameter to specify disk or tape input.
    
     DISK    Input will be from a data set on disk. This is the
             default.
    
     TAPE    Input will be from a data set on an unlabeled tape.
    
     SLTAPE  Input will be from a data set on a standard labeled
             tape.
    
    The manual CICS TS for VSE/ESA CICS Supplementary Data Areas
    LY33-6087-04 has been changed as follows.
    
    Page 200
    
    (399) CHARACTER    1  OTHER_SWITCHES
          1... ....        UPPERCASE_REQ        Translate flag
          .1.. ....        TAPE_DEVICE          Tape input reqd
          ..1. ....        SLTAPE_DEVICE        Labeled tape
          ...1 1111        *
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PI14361

  • Reported component name

    CICSTS FOR VSE

  • Reported component ID

    564805400

  • Reported release

    B0P

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-03-24

  • Closed date

    2014-06-18

  • Last modified date

    2014-07-03

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

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

    UI19013

Modules/Macros

  • DFHSTRD  DFHSTUP1
    

Publications Referenced
SC33165409LY33608704   

Fix information

  • Fixed component name

    CICSTS FOR VSE

  • Fixed component ID

    564805400

Applicable component levels

  • RB0P PSY UI19013

       UP14/07/03 I 1000

Fix is available

  • Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.

[{"Business Unit":{"code":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.1.1","Edition":""}]

Document Information

Modified date:
03 July 2014