Extract Spool Files to Datasets using SDSF - Generalized
This utility, written in REXX, is intended to be invoked as a batch job step within individual 7AC1 jobs to extract SYSOUT files from the JES Spool into z/OS datasets (similar to the SDSF XDC line command).
The command is generalized so the user has flexibility in numerous places with the singluar exception that the generated dataset name must not exceed the z/OS limit of 44 characters.
Find in the code the string *custom* and do change the variable for
either SDSF or EJES.
%sdsfxdd JOBname(jobname(jobid)) +
STEPname(stepname) +
PROCstep(procstep) +
DDname(ddname) +
HLQ(high-level-qualifier) +
QUALifier(qualifier) +
SUFfix(suffix) +
LISt(list) +
OWNer(owner) +
SYStem(sys) +
DATE(date)
Note: Abbreviations are in CAPs.
| Keyword | Explanation |
|---|---|
| JOB | Specify the JOB name to be processed. jobname(jobid) for a specific job or jobname for all jobs with the same jobname or jobname* for all jobs starting with jobname |
| STEP | Specify the Stepname to be processed stepname or * for all steps Note that PROC Step names are not considered at this time |
| PROC | Specify the PROCstep name to be processed procstep-name or * for all |
| DD | Specify the DDname to be processed ddname or * for all ddnames masking is not supported at this time |
| OWNER | Specify the owning userid or default to ALL users |
| DATE | if non-blank then use JOBID or default to job creation date and time |
| HLQ | Specify the 1st level qualifier for the generated dataset names the default will be the users USERID or PREFIX |
| QUAL | Specify the 2nd level qualifier for the generated dataset names the 1st qualifier will be the users USERID or PREFIX |
| SUF | Specify the optional dataset suffix for the generated datasets The default is no suffix or you can specify SUF(NONE) The suffix is limited to 7 characters |
| LIST | Defines what the code does when it completes YES if under ISPF to display a dataset list (ISPF 3.4) of the datasets NO (default) to just exit |
| SYS | Specify if the System generated files (JESMSGLG, JESYSMSG, and JESJCL) are to be included YES or NO |
- The generated dataset name must never exceed the z/OS limit of 44 characters. This may require having a small QUAL and no SUF.
- The generated dataset name will have a format of: hlq.qual.Dyyddd.Thhdd.stepname.ddname.suffix
- If all jobs or all steps are processed there is a potential of duplicate stepname and ddname combinations. When this happens the dataset name will be suffixed with a .A up to .B. This suffix will increment withn the duplicate stepname and ddname.
- If the job is active and the spool dataset is NOT blocked then messages at the top of the data will provide the user with that information so they know that it is possible that some spool data may not have been written to the spool and may still be in the spool buffer.
This is a work in progress and comes with no warranty or guarantee of any kind. Use it at your own risk.
The MIT License (MIT) Copyright © 2021-2024
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the Software), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.