IBM Support

DY47564: PDELETE LST,CRDAYS>10 MAY DELETE OUTPUT CREATED RECENTLY

A fix is available

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • Creation date and time for jobs and outputs names the begin of
    creation. For long running jobs, e.g. VTAM, CICS, TCPIP, the
    spooled output is collected over several days. When the output
    is completed, it's creation date is the start of the job.
    This means that newly created output is noted as many days old
    and thereby deleted by automatic processes using PDELETE with
    CRDAYS or CRAGE.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All the users which need to use ENDDAYS      *
    *                 and ENDAGE operands for the VSE/POWER        *
    *                 command level manipulations with the         *
    *                 queue entries.                               *
    ****************************************************************
    * PROBLEM DESCRIPTION: For the long running jobs the           *
    *                      VSE/POWER commands which are using the  *
    *                      creation date/time only can lead the    *
    *                      incorrect spooling entries deletion or  *
    *                      selection.                              *
    ****************************************************************
    * RECOMMENDATION: Applying of this update does not modify      *
    *                 earlier spooled entries. So they will not    *
    *                 contain "end of spooling" date and time      *
    *                 information. To make them possible to be     *
    *                 processed with ENDDAYS or ENDAGE operands    *
    *                 they can be POFFLOADed to the tape and       *
    *                 LOADed/SELECTed back without NOJNO option.   *
    *                 However in this case queue entries will      *
    *                 have the LOADing/SELECTing date and time     *
    *                 stamp for the end of spooling.               *
    ****************************************************************
    VSE/POWER spooling queue entries had in the queue records the
    date and time of their creation only. This restricted the
    manipulations with the queue entries and lead errors for the
    long running jobs when the deletion or some kind of selection
    had been performed.
    

Problem conclusion

  • To make the operations with the spooling entries more accurate
    a new "end of spooling" time stamp is added to the queue entry
    when VSE/POWER adds the spooling entry to the appropriate queue.
    The time stamp contains date and time of the spooling
    completion.
    Two new operands are presented by this APAR: ENDDAYS and ENDAGE.
    These operands are working with new "end of spooling" time stamp
    and can be used in the following VSE/POWER commands:
    PALTER, PDISPLAY, PDELETE, PHOLD, PRELEASE and with restriction
    in POFFLOAD. PCOPY, segmentation and duplication processes also
    support the new "end of spooling" time stamp.
    ENDDAYS has similar rules of specification like CRDAYS.
    ENDAGE has similar rules of specification like CRAGE.
    CRDAYS, CRAGE, CRDATE, ENDDAYS and ENDAGE are mutually
    exclusive and can not be used together in the same command.
    If specified these operands together then the 1R52I message is
    issued and the command's execution is terminated. For example:
         POFFLOAD BACKUP,LST,481,CRDAYS<2,ENDDAYS>=0
         AR 0015 1C39I COMMAND PASSED TO VSE/POWER
         F1 0001 1R52I  POFFLOAD OPERANDS CRDATE, CRDAYS, CRAGE,
                 ENDDAYS AND ENDAGE MUTUALLY EXCLUSIVE
    POFFLOAD BACKUP/PICKUP can recognize ENDDAYS specification.
    POFFLOAD SELECT works with both ENDDAYS and ENDAGE operands.
    PDISPLAY command output shows the "end of spooling" time stamp
    when FULL=YES is specified and the queue entries selected for
    the displaying have this time stamp set. "End of spooling" date
    is shown as "DE=...". "End of spooling" time is shown as
    "TE=...". For example:
    D LST,ALL,ENDDAYS=1,FULL=YES
    AR 0015 1C39I COMMAND PASSED TO VSE/POWER
    F1 0001 1R46I    LIST QUEUE   P D C S  PAGES  CC FORM BU
    F1 0001 1R46I  $OFJ0650 00650 9 H A        1   1
    F1 0001        D=05/29/2014 DBGP=000001 L=0000000030
    F1 0001        QNUM=00050 T=12:33:40
    F1 0001        DE=05/29/2014 TE=12:33:40
    F1 0001        FCB=' '
    F1 0001 1R46I  PAUSEF4  00645 3 H A        4   1  +TO=(SYSA)
    F1 0001                                              FROM=(SYSA)
    F1 0001        D=05/29/2014 DBGP=000001 L=0000000011
    F1 0001        QNUM=00070 T=12:31:34
    F1 0001        MDUCT=001 TKN=00000020 DE=05/29/2014 TE=12:32:06
    The modified macros: IPW$DCP, IPW$GMM, IPW$DQC, IPW$DQR, IPW$DTC
    The modified modules: IPW$$CM, IPW$$CO, IPW$$CY, IPW$$LO,
    IPW$$LR, IPW$$MM, IPW$$OF, IPW$$PS, IPW$$PS1, IPW$$QM, IPW$$RY,
    IPW$$TR, IPW$$XWE.
    The documentation changes:
    Changes are made for "VSE/POWER Admin. & Oper.", chapter 3
    Subdivision "Life Cycle of Spool Output":
    1) Insert the phrase "The moment of output end is recorded by
    the queue entry's end date (DE=) and time (TE=)." after the
    phrase "The moment of creation is recorded by the queue entry's
    creation date (D=) and time (T=)."
    2) modify Figure 23 'Time Axis of Spool Life Cycle' with it's
    description as the following:
    Any PISPLAY request shows queue entries at the actual time,
    let us call "now" time. The total life cycle of entries between
    the creation moment, end of spooling moment, "now" and their
    deletion moment can be presented on a time axis:
    
    ------x--------x---------x---------x------> time
      creation    end       now     deletion
    
    Subdivision "Time-Based Handling of Spool Entries":
    1) modify Figure 24 "Time Based Spool Handling" and its
    description as the following:
    Many possibilities are available for time-based handling of
    spool entries. Selection criteria based on the fixed creation
    date, the end of spooling date, the variable age since creation
    or end can be chosen with all logical comparison operators
    (equal, less than, greater than, not equal, greater than or
    equal, less than or equal).The console displays can be stored
    based on the creation date.
             |<----------- CRDAYS= ----------------->|
    ---------x--------------x------------------------x
        creation           end                      now
        CRDATE=
        D=
    
    
                            |<----- ENDDAYS= ------->|
    ---------x--------------x------------------------x
        creation           end                      now
                           DE=
    
    Subdivision "Based on Age" modify as the following:
    "Another function allows to select queue entries without
    knowledge of the calendar creation or end of spooling date
    instead of their age in days. With this function the operator
    may forget about the calendar and the system date's format
    (mm/dd/yyyy or dd/mm/yyyy), and select entries simple by their
    age, which means the number of days that have elapsed since
    their creation or end. For that purpose the search operands
    CRDAYS=|>|<... or ENDDAYS=|>|<... may be used in the display,
    queue manipulation and POFFLOAD BACKUP|PICKUP|SAVE|SELECT
    commands, for example:
         PDISPLAY LST,HUS*,CRDAYS>30
         PDISPLAY PUN,HUS*,ENDDAYS<4
    displays all list queue entries named HUS..., that have been
    created more than 30 days ago in the first example and that
    have been ended less than 4 days ago in the second example.
    
    Add the following piece of scheme
                                     (ref)
    |------,ENDDAYS-comp_op-nnn---------------------|
    |                                (ref)          |
    |------,ENDAGE-comp_op-age----------------------|
    to the schemes of PALTER (ref=2), PDELETE (ref=2), PDISPLAY
    Format 1 (ref=3), PDISPLAY Format 2 (ref=1), PHOLD (ref=2),
    POFFLOAD SELECT (ref=2), PRELEASE (ref=3).
    
    Add the following piece of scheme
    --------------------------------------------------
        |                         (4)  |
         --ENDDAYS---- = ---- nnn -----
                   |-- > --|
                   |-- < --|
                   |- ^= --|
                   |- >= --|
                    - <= --
    to the POFFLOAD Format 1 and Format 2 schemes after the CRDAYS
    scheme. Modify Note 4 for both cases in the next way:
    "4 CRDAYS or ENDDAYS operands can be specified for BACKUP and
    PICKUP functions only. CRDAYS or ENDDAYS specification for SAVE
    function will be rejected with the 1R52I message."
    
    Add ENDDAYS and ENDAGE description to PALTER, PDELETE, PDISPLAY,
    PHOLD and PRELEASE describing paragraphs as the following:
    
    "ENDAGE=|>|<|^=|>=|<=age
    In this string:
    ENDAGE
      indicates that only those queue entries are to be addressed,
      whose age in hours and minutes (current date and time minus
      end of sppoling date and time) is:
           Equal to                  (=) ^
           Greater than              (>)
           Less than                 (<) +> the specified value
           Not equal to             (^=)    in hours and minutes
           Greater than or equal to (>=)
           Less than or equal to    (<=) -
    age
      the value of the age must have one of the following formats:
         hhmm
           specifies the age in hours and minutes. The value for
           hours hh can be a number between 0 and 99 (a leading
           zero can be omitted). The value for minutes mm can be
           a number between 00 and 59. If a number of minutes is
           less than 10, it is to be specified with a leading zero.
         hmm
           is equivalent to 0hmm (number of hours is less than 10).
         hh
           is equivalent to hh00 (number of minutes is equal to
           zero).
         h
           is equivalent to 0h00 (number of hours is less than 10,
           number of minutes is equal to zero).
    
    ENDDAYS=|>|<|?=|>=|<=nnn
    In this string:
    ENDDAYS
       indicates that the requested change is to be done for those
       queue entries whose age in days beginning with the end of
       spooling date (current date minus end of spooling date) is:
           Equal to                  (=) ^
           Greater than              (>)
           Less than                 (<) +> the specified value
           Not equal to              (^=)   in days
           Greater than or equal to  (>=)
           Less than or equal to     (<=)-
    nnn
       the age in days against which the queue entries' end of
       spooling dates are to be compared. The value may be a number
       between 0 and 999, with or without leading zeros. The value
       "0" means entries ended today."
    

Temporary fix

Comments

APAR Information

  • APAR number

    DY47564

  • Reported component name

    VSE/POWER

  • Reported component ID

    5686CF903

  • Reported release

    52C

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2014-08-15

  • Closed date

    2014-11-07

  • Last modified date

    2014-11-18

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

    DY47520

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

    UD54076 UD54077

Modules/Macros

  • IPW$$CM  IPW$$CO  IPW$$CY  IPW$$LO  IPW$$LR  IPW$$MM  IPW$$OF
    IPW$$PS  IPW$$PS1 IPW$$QM  IPW$$RY  IPW$$TR  IPW$$XWE IPW$DCP
    IPW$DQC  IPW$DQR  IPW$DTC  IPW$GMM
    

Publications Referenced
SC34262500        

Fix information

  • Fixed component name

    VSE/POWER

  • Fixed component ID

    5686CF903

Applicable component levels

  • R52C PSN UD54076

       UP14/11/18 I 1000

  • R52G PSN UD54077

       UP14/11/18 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.



Document information

More support for: z/VSE family

Software version: 52C

Operating system(s): VSE/ESA

Reference #: DY47564

Modified date: 18 November 2014