A fix is available
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:
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
SC34262500 |
Fix information
Fixed component name
VSE/POWER
Fixed component ID
5686CF903
Applicable component levels
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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG32M","label":"APARs - VSE\/ESA environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"52C","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
11 December 2020