JES2 job processing
CONTENTS:
2. View and save JES2 job data on a MVS file
2.1. sj (Source Job)
2.2. s (Start view listing)
2.3. xdc (save to MVS file)
2.4. ? (Questing output view)
3.1. What is filling JES2 spool ?
3.2. JES2 commands offen used
3.3. How to purge jobs data?
3.4. Job output class and disposition
4. BACKUP/OFFLOAD of JES2 – Q to tape
4.1. Displays parameters of transmitter to tape ($DOFF1.ST)
4.2. Set parameters changes of transmitter to tape ($TOFF1.ST)
4.3. Displays parameters of the day ($DOFFLOAD1)
4.4. Set parameters changes of the day ($TOFFLOAD1)
4.5. Start offload transmit to tape ($SOFFLOAD1,TYPE=TRANSMIT)
4.6. Stop offload transmit to tape ($POFFLOAD1)
5. RESTORE/RELOAD from JES-Q TAPE
5.1. Displays parameters of receive – $DOFF1.SR
5.2. Set parameters changes of receive from tape ($TOFF1.SR)
5.3. Displays parameters of the day for restore ($DOFFLOAD1)
5.4. Set parameters changes of the day for restore ($TOFFLOAD1)
5.5. Start offload receive from tape ($SOFFLOAD1,TYPE=RECEIVE)
5.6. Stop offload receive from tape ($POFFLOAD1)
5.7. Temporary stop of offload ($ZOFFLOAD1)
1. JES2 job information
JES2 Spool data set consists of SYSOUT + JCL source + SYSIN data + JCL contol blocks. JES2 analyze and groups job outputs for output class,route code,priority, Etc.
If we are referring to the JES2 output of a single job — this is SPOOL data, not a data set that can be accessed in any normal way. There is no data set name assigned to a spool file.
When JES2 is started during IPL it uses members SYS1.PARMLIB(JES2CMDS)
and SYS1.PARMLIB(JES2PARM) defining some important spool parameters:
JOBCLASS(A-Z) AUTH=ALL, /* All commands accepted */
LOG=YES, /* Print JES2 JOB LOG */
OUTDISP=(HOLD,HOLD), /* Disposition of System Output */
/* normal termination and abnormal */
OUTPUT=YES, /* Produce Output for Job */
SPOOLDEF
BUFSIZE=3856, /* MAXIMUM BUFFER SIZE &BUFSIZE */
DSNAME=SYS1.HASPACE,
FENCE=NO, /* Don’t Force to Min.Vol. &FENCE */
SPOOLNUM=32, /* Max. Num. Spool Vols */
TGBPERVL=5, /* Track Groups per volume in BLOB */
TGSIZE=33, /* 30 BUFFERS/TRACK GROUP &TGSIZE */
TGSPACE=(MAX=195456, /* Fits TGMs into 4K Page &NUMTG=(, */
WARN=80), /* &NUMTG=(,% */
TRKCELL=5, /* 5 Buffers/Track-cell &TCELSIZ */
VOLUME=BC2SP /* SPOOL VOLUME SERIAL &SPOOL */
JOBCLASS(STC) TIME=(1440,00), /* STC defaults */
LOG=YES, /* Print JES2 JOB LOG LOG */
OUTPUT=YES, /* Produce Output for Job OUTPUT */
OUTDISP=(HOLD,HOLD),
JOBCLASS(TSU) TIME=(0120,00), /* TSU defaults */
OUTDISP=(PURGE,HOLD),
LOG=YES, /* Print JES2 JOB LOG LOG */
OUTPUT=YES, /* Produce Output for Job OUTPUT */
OFFLOAD1 DSN=BACKUP.JES.OFFLOAD1.DMMDDYYS, /* DSN */
VALIDATE=YES, /* UNIT TAPE, DVICE TYPE 3590 */
UNIT=(VTS1,1) /* UNIT TAPE, DVICE TYPE 3590 */
/* No. of Devices (units) UNITCT */
/* */
OFFLOAD2 DSN=BACKUP.JES.OFFTEMP2.DMMDDYYS, /* DSN */
UNIT=(3590,1) /* UNIT TAPE, DVICE TYPE 3590 */
/* No. of Devices (units) UNITCT */
JES2 spool data are including:
- SYSIN and SYSOUT data sets
- JESNEWS
- Trace data sets
- SYSLOG
- Spool offload data
During job execution, JES2 creates data sets for a job’s input (SYSIN) and output (SYSOUT).
These data sets might exist after the job completes execution.
In a job we get output data sets with the following DDNAME: JESMSGLG, JESJCL, JESYSMSG, SYSPRINT, SYSOUT, CEEDUMP etc.
What is the max size of that SYSOUT?
The maximum size of a job in the spool is equal to the unused available space defined to the JES2 spool dataset. The only standard datasets (always present for JOB/STC/TSU ) are JESMSGLG, JESJCL, JESYSMSG and all the other names are optional, user defined. The maximum size/number_of_records for a spooled dataset ( print/punch ) is determined by the spool capacity and the rules imposed by JES2 customization.
Example of JES2 data for CICS application system when in z/os TSO/ISPF– sd.st – you entered the follwing – ? BC2AC10A:
DDNAME StepName ProcStep DSID Owner C Dest Rec-Cnt
JESMSGLG JES2 2 BC2AC10A X 2,003
JESJCL JES2 3 BC2AC10A X 138
JESYSMSG JES2 4 BC2AC10A X 2,464
DFHCXRF BC2AC10A 101 BC2AC10A X 0
MSGUSR BC2AC10A 103 BC2AC10A X 28,891
PLIMSG BC2AC10A 104 BC2AC10A X 0
COUT BC2AC10A 105 BC2AC10A X 0
CEEMSG BC2AC10A 106 BC2AC10A X 0
CEEOUT BC2AC10A 107 BC2AC10A X 0
PRINTER BC2AC10A 114 BC2AC10A X 0
CAFF BC2AC10A 115 BC2AC10A X 0
CRPO BC2AC10A 116 BC2AC10A X 0
JESMSGLG – This JES2 output data set is saved in SYSLOG:
The JESMSGLG output data set (which is part of JOB data in JES2) resides on SYSLOG for each job in the system and contains system messages related to the job starting and ending.
JESYSMSG – JES2 system messages output data set is also saved in SYSLOG. It contains all system communications /information messages related to the job.
All other JES2 data (including JESMSGLG and JESYSMSG) are saved in JES2 spool and can be offloaded on save tape for later reload when needed.
2. View and save JES2 job data on a MVS file
TSO/ISPF – sd.st (Status of jobs) operations:
2.1. sj (Source Job) RESDBCK0 JOB04443 BCA1MGP
Display and edit Job source data before JES2 processing (to submit the same or edited last executed job with: sd.st – Command ===> sub)
//RESDBCK0 JOB (9999),
//,
// REGION=0K,TIME=1440,
// MSGCLASS=X,MSGLEVEL=(1,1)
//* *************************************************
//* *************************************************
//JOBLIB DD DSN=KCI00.LIB.PROD.LOAD,DISP=SHR
// DD DSN=CEE.SCEERUN,DISP=SHR
//*
//CSDEFINE EXEC PGM=IDCAMS
//SYSOUT DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
//SYSIN DD *
PARM MARGINS(1 80)
/*
//DFDSS EXEC PGM=ADRDSSU,REGION=0M,TIME=1440 PARM=’TYPRUN=NORUN’
//SYSPRINT DD SYSOUT=*
//TAPE DD DSN=KCI01.DMNSNTAP.SOVBDB.G0959V00,DISP=(NEW,CATLG),
// VOL=SER=CB0930,UNIT=(300,,DEFER),
// DCB=(KCI01.DMNSNTAP.MODEL.DCB,
// RECFM=U,LRECL=0,BLKSIZE=32760,
// DSORG=PS),LABEL=(1,SL)
//SYSIN DD *
RESTORE –
DS(INC( –
KCI01.DMNSNDSK.BAKMSTR –
KCI01.DMNSNDSK.CSKCONF –
KCI01.DMNSNDSK.DAKMSTR –
KCI01.DMNSNDSK.DAKTRAN –
KCI01.DMNSNDSK.DAKTR01 –
KCI01.DMNSNDSK.DAKTR02 –
KCI01.DMNSNDSK.DAKTR03 –
KCI01.DMNSNDSK.DAKTR04 –
KCI01.DMNSNDSK.DAKTR05 –
KCI01.DMNSNDSK.DAKTR06 –
KCI01.DMNSNDSK.DAKTR07 –
)) –
INDDNAME(TAPE) –
RENAMEU(KCI01.DMNSNDSK.*,KCI08.D0407.*) –
SPHERE
2.2. s (Start view listing) RESDBCK0 JOB04443 BCA1MGP
View all JOB processed data / JESMSGLG, JESJCL , JESYSMSG, SYSPRINT etc./
2.3. xdc (save to MVS file) RESDBCK0 JOB04443 BCA1MGP
Create ‘BCA1MGP.JCL.RESDBCK0’ file that contains all JOB processed data / JESMSGLG, JESJCL , JESYSMSG, SYSPRINT/ as if ‘s RESDBCK0’ is entered) – to view in p.3.4 and send to PC with MF-PC file transfer:
Data set name ===> ‘BCA1MGP.JCL.RESDBCK0’ – Define DSN where the job data are printed
Member to use ===>
Disposition ===> NEW (OLD, NEW, SHR, MOD)
If the data set is to be created with more/less space or special parameters, specify the following:
Management class ===> (Blank for default management class)
Storage class ===> (Blank for default storage class)
Volume serial ===> (Blank for authorized default volume) *
Device type ===> (Generic unit or device address) *
Data class ===> (Blank for default data class)
Space units ===> CYLS (BLKS, TRKS, CYLS, BY, KB, or MB)
Primary quantity ===> 20 (In above units)
Secondary quantity ===> 20 (In above units)
Directory blocks ===> (Zero for sequential data set)
Record format ===> VBA
Record length ===> 240
Volume serial will be used to locate existing data sets if specified.
2.4. ? (Questing output view) RESDBCK0 JOB04443 BCA1MGP
Vew detail JOB steps processed data:
JESMSGLG JES2 2 BCA1MGP X LOCAL 26
JESJCL JES2 3 BCA1MGP X LOCAL 22
JESYSMSG JES2 4 BCA1MGP X LOCAL 142
SYSPRINT CSDEFINE 104 BCA1MGP X LOCAL 6
SYSPRINT DFDSS 106 BCA1MGP X LOCAL 142
- s JESYSMSG JES2 – view a single detail JOB step processed data
- s JESJCL JES2 – view source data of the job
- xdc JESJCL JES2 – create new BCA1MGP.JCL.RESDBCK0.JESJCL file for job step JESJCL JES2 (job source language) – view in p.3.4
- xdc JESYSMSG JES2 – create new BCA1MGP.JCL.RESDBCK0.JESYSMSG file for job step JESYSMSG JES2 – view in p.3.4
3. Useful JES2 commands
3.1. What is filling JES2 spool ?
- $djq,spl=(%>5) Display all jobs which occupy more than 5% of the spool
- $djq,a>5,q=ppu Display all jobs on the print/punch queue more than 5 days old
- $djq,q=ppu,type=tsu Display all TSUs on the print/punch queue
- $djq’jobname‘,spl Display spool percent occupied by the named job
- $djq,q=ppu,userid Display userid associated with jobs on print/punch queue
- $da,x Displays all jobs, including TSU and STC
- /$DJQ,SPL=%>1 – Display spool jobs with the maximum spool lines occupied:
$HASP890 JOB(STG33101) 275
$HASP890 JOB(STG33101) STATUS=(AWAITING HARDCOPY),CLASS=R,
$HASP890 PRIORITY=1,SYSAFF=(ANY),HOLD=(NONE),
$HASP890 SPOOL=(VOLUMES=(BC2SP1,2,3,4),TGS=1992,
$HASP890 PERCENT=2.9968)
- /$DSPL – Display percent spool used by spool volumes
$HASP893 VOLUME(BC2SP1) STATUS=ACTIVE,PERCENT=43
$HASP893 VOLUME(BC2SP2) STATUS=ACTIVE,PERCENT=42
$HASP893 VOLUME(BC2SP3) 598
$HASP893 VOLUME(BC2SP3) STATUS=DRAINING,AWAITING(JOBS),
$HASP893 PERCENT=1
$HASP893 VOLUME(BC2SP4) 599
$HASP893 VOLUME(BC2SP4) STATUS=DRAINING,AWAITING(JOBS),
$HASP893 PERCENT=1
$HASP646 42.8313 PERCENT SPOOL UTILIZATION
3.2. JES2 commands offen used
/$DA,X – Displays all jobs executing
$HASP890 JOB(SYSLOG) 669
$HASP890 JOB(SYSLOG) STATUS=(EXECUTING/BC2A),CLASS=STC,
$HASP890 PRIORITY=15,SYSAFF=(BC2A),HOLD=(NONE)
$HASP890 JOB(RACF) 670
$HASP890 JOB(RACF) STATUS=(EXECUTING/BC2A),CLASS=STC,
$HASP890 PRIORITY=15,SYSAFF=(BC2A),HOLD=(NONE)
$HASP890 JOB(NET) 671
$HASP890 JOB(NET) STATUS=(EXECUTING/BC2A),CLASS=STC,
$HASP890 PRIORITY=15,SYSAFF=(BC2A),HOLD=(NONE)
$HASP890 JOB(BPXAS) 672
$HASP890 JOB(BPXAS) STATUS=(EXECUTING/BC2A),CLASS=STC,
$HASP890 PRIORITY=15,SYSAFF=(BC2A),HOLD=(NONE)
$HASP890 JOB(RMF) 673
$HASP890 JOB(RMF) STATUS=(EXECUTING/BC2A),CLASS=STC,
$HASP890 PRIORITY=15,SYSAFF=(BC2A),HOLD=(NONE)
/$DQ – Displays spool utilization of JES-Q
$HASP643 3024 PPU LOCAL ANY
$HASP646 26.8482 PERCENT SPOOL UTILIZATION
/$D SPOOL – displays spool volumes
$HASP893 VOLUME(BC2SP1) STATUS=ACTIVE,PERCENT=27
$HASP893 VOLUME(BC2SP2) STATUS=ACTIVE,PERCENT=26
$HASP893 VOLUME(BC2SP3) 735
$HASP893 VOLUME(BC2SP3) STATUS=DRAINING,AWAITING(JOBS),
$HASP893 PERCENT=1
$HASP893 VOLUME(BC2SP4) 736
$HASP893 VOLUME(BC2SP4) STATUS=DRAINING,AWAITING(JOBS),
$HASP893 PERCENT=1
$HASP646 26.8572 PERCENT SPOOL UTILIZATION
/$DSPL,ALL – displays full spool volumes information
$HASP893 VOLUME(BC2SP1) 745
$HASP893 VOLUME(BC2SP1) STATUS=ACTIVE,SYSAFF=(ANY),TGNUM=16555,
$HASP893 TGINUSE=4498,TRKPERTGB=3,PERCENT=27
$HASP893 VOLUME(BC2SP2) 746
$HASP893 VOLUME(BC2SP2) STATUS=ACTIVE,SYSAFF=(ANY),TGNUM=16680,
$HASP893 TGINUSE=4429,TRKPERTGB=3,PERCENT=26
$HASP893 VOLUME(BC2SP3) 747
$HASP893 VOLUME(BC2SP3) STATUS=DRAINING,AWAITING(JOBS),
$HASP893 SYSAFF=(ANY),TGNUM=16680,TGINUSE=14,
$HASP893 TRKPERTGB=3,PERCENT=1
$HASP893 VOLUME(BC2SP4) 748
$HASP893 VOLUME(BC2SP4) STATUS=DRAINING,AWAITING(JOBS),
$HASP893 SYSAFF=(ANY),TGNUM=16555,TGINUSE=17,
$HASP893 TRKPERTGB=3,PERCENT=1
$HASP646 26.8602 PERCENT SPOOL UTILIZATION
/$DU,ALL – displays all JES2 Controled devices
$HASP881 LOGON1 APPLID=BC2AJES,STATUS=DRAINED
$HASP880 LINE1 UNIT=SNA,STATUS=ACTIVE,DISCON=NO
$HASP880 LINE2 UNIT=SNA,STATUS=ACTIVE,DISCON=NO
$HASP880 LINE3 UNIT=SNA,STATUS=ACTIVE,DISCON=NO
$HASP880 LINE4 UNIT=SNA,STATUS=ACTIVE,DISCON=NO
$HASP880 LINE5 UNIT=SNA,STATUS=ACTIVE,DISCON=NO
$HASP882 OFFLOAD1 757
$HASP882 OFFLOAD1 DSN=BACKUP.JES.OFFLOAD1.DMMDDYYS,
$HASP882 STATUS=DRAINED,ARCHIVE=ONE
$HASP882 OFFLOAD2 758
$HASP882 OFFLOAD2 DSN=BACKUP.JES.OFFTEMP2.DMMDDYYS,
$HASP882 STATUS=DRAINED,ARCHIVE=ONE
$HASP603 PRT1 UNIT=,STATUS=DRAINED
$HASP603 PRT2 UNIT=,STATUS=DRAINED
$HASP603 PRT3 UNIT=,STATUS=DRAINED
$HASP603 PRT4 UNIT=,STATUS=DRAINED
$HASP603 PRT5 UNIT=,STATUS=DRAINED
$HASP603 PRT6 UNIT=,STATUS=DRAINED
$HASP603 PRT7 UNIT=,STATUS=DRAINED
$HASP603 PRT8 UNIT=,STATUS=DRAINED
$HASP603 PRT9 UNIT=,STATUS=DRAINED
$HASP603 PRT10 UNIT=,STATUS=DRAINED
$HASP603 PRT11 UNIT=,STATUS=DRAINED
$HASP603 PRT12 UNIT=,STATUS=DRAINED
$HASP603 PRT13 UNIT=,STATUS=DRAINED
$HASP603 PRT14 UNIT=,STATUS=DRAINED
$HASP603 PRT15 UNIT=,STATUS=DRAINED
$HASP603 PRT16 UNIT=,STATUS=DRAINED
$HASP603 PRT17 UNIT=,STATUS=DRAINED
$HASP603 PRT18 UNIT=,STATUS=DRAINED
$HASP603 PRT19 UNIT=,STATUS=DRAINED
$HASP603 PRT20 UNIT=,STATUS=DRAINED
$HASP603 PRT21 UNIT=,STATUS=DRAINED
$HASP603 PRT22 UNIT=,STATUS=DRAINED
$HASP603 PRT23 UNIT=,STATUS=DRAINED
$HASP603 PRT24 UNIT=,STATUS=DRAINED
$HASP603 PRT25 UNIT=,STATUS=DRAINED
$HASP603 PRT26 UNIT=,STATUS=DRAINED
$HASP603 PRT27 UNIT=,STATUS=DRAINED
$HASP603 PRT28 UNIT=,STATUS=DRAINED
$HASP603 PRT29 UNIT=,STATUS=DRAINED
$HASP603 PRT30 UNIT=,STATUS=DRAINED
$HASP603 PRT31 UNIT=,STATUS=DRAINED
$HASP603 PRT32 UNIT=,STATUS=DRAINED
$HASP603 PRT33 UNIT=,STATUS=DRAINED
$HASP603 PRT34 UNIT=,STATUS=DRAINED
$HASP603 PRT35 UNIT=,STATUS=DRAINED
$HASP603 PRT36 UNIT=,STATUS=DRAINED
$HASP603 PRT37 UNIT=,STATUS=DRAINED
$HASP603 PRT38 UNIT=,STATUS=DRAINED
$HASP603 PRT39 UNIT=,STATUS=DRAINED
$HASP603 PRT40 UNIT=,STATUS=DRAINED
$HASP603 PRT41 UNIT=,STATUS=DRAINED
$HASP603 PRT42 UNIT=,STATUS=DRAINED
$HASP603 PRT43 UNIT=,STATUS=DRAINED
$HASP603 PRT44 UNIT=,STATUS=DRAINED
$HASP603 PRT45 UNIT=,STATUS=DRAINED
$HASP603 PRT46 UNIT=,STATUS=DRAINED
$HASP603 PRT47 UNIT=,STATUS=DRAINED
$HASP603 PRT48 UNIT=,STATUS=DRAINED
$HASP603 PRT49 UNIT=,STATUS=DRAINED
$HASP603 PRT50 UNIT=,STATUS=DRAINED
$HASP603 PRT51 UNIT=,STATUS=DRAINED
$HASP603 PRT52 UNIT=,STATUS=DRAINED
$HASP603 PRT53 UNIT=,STATUS=DRAINED
$HASP603 PRT54 UNIT=,STATUS=DRAINED
$HASP603 PRT55 UNIT=,STATUS=DRAINED
$HASP603 PRT56 UNIT=,STATUS=DRAINED
$HASP603 PRT57 UNIT=,STATUS=DRAINED
$HASP603 PRT58 UNIT=,STATUS=DRAINED
$HASP603 PRT59 UNIT=,STATUS=DRAINED
$HASP603 PRT60 UNIT=,STATUS=DRAINED
$HASP603 PRT61 UNIT=,STATUS=DRAINED
$HASP603 PRT62 UNIT=,STATUS=DRAINED
$HASP603 PRT63 UNIT=,STATUS=DRAINED
$HASP603 PRT64 UNIT=,STATUS=DRAINED
$HASP603 PRT65 UNIT=,STATUS=DRAINED
$HASP603 PRT66 UNIT=,STATUS=DRAINED
$HASP603 PRT67 UNIT=,STATUS=DRAINED
$HASP603 PRT68 UNIT=,STATUS=DRAINED
$HASP603 PRT69 UNIT=,STATUS=DRAINED
$HASP603 PRT70 UNIT=,STATUS=DRAINED
$HASP603 PRT71 UNIT=,STATUS=DRAINED
$HASP603 PRT72 UNIT=,STATUS=DRAINED
$HASP603 PRT73 UNIT=,STATUS=DRAINED
$HASP603 PRT74 UNIT=,STATUS=DRAINED
$HASP603 PRT75 UNIT=,STATUS=DRAINED
$HASP603 PRT76 UNIT=,STATUS=DRAINED
$HASP603 PRT77 UNIT=,STATUS=DRAINED
3.3. How to purge jobs data?
- $pjq,a>5,q=ppu Purges all jobs on the print/punch queue more than 5 days old
- $pjq,q=ppu,type=tsu Purge all TSUs on the print/punch queue
- $pjnnnnn Purge JOB number nnnnn
- $psnnnnn Purge STC number nnnnn
- $ptnnnnn Purge TSU number nnnnn
- TSO/ISPF – sd.st – //P …..// – purge more job outputs:
//p CKPRAC01 JOB07755
CKPRAC01 JOB07757
CKPRAC01 JOB07758
CKPRIBAN JOB07759
// CKPRAC01 JOB07760
p CKPRAC01 JOB07758 – purge only this job entry
- $pos’syslog’,a>5 Delete SYSLOG output groups more than 5 days old
3.4. Job output class and disposition
– Job output class (A-Z) are:
According JES2 standards Output class Structure is defined in SYS1.PARMLIB(JES2PARM) for all Job output classes as parameter OUTCLASS :
OUTCLASS(A) BLNKTRNC=YES, /* Outclass A */
OUTDISP=(WRITE,WRITE), /* OUT disp PRINT */
OUTCLASS(F) BLNKTRNC=YES, /* Outclass F */
OUTDISP=(KEEP,KEEP), /* OUT disp PRINT */
OUTCLASS(X) BLNKTRNC=YES, /* Outclass X */
OUTDISP=(HOLD,HOLD), /* OUT disp PRINT */
OUTPUT=PRINT, /* Print Class PRINT */
TRKCELL=YES /* Track-Cell this Class NOTRKCEL */
/* */
– JES2 Output dispositions (OUTDISP )are:
HOLD – Hold the output. JES2 does not process the output until you either
change the disposition to WRITE or KEEP, or release the output.
When the output is released, the disposition changes to WRITE.
KEEP – Process the output and then keep a copy of it on spool. After
processing, the disposition of this output becomes LEAVE.
LEAVE JES2 – does not process the output until you change the disposition
to WRITE or KEEP, or release the output. When the output is
released, the disposition changes to KEEP.
PURGE – Purge the output immediately.
WRITE – Process the output then purge it.
– JES2 command ($D OUTCLASS(n) to view OUTDISP for a given OUTCLASS:
/$D OUTCLASS(X):
$HASP842 OUTCLASS(X) 367
$HASP842 OUTCLASS(X) OUTPUT=PRINT,BLNKTRNC=YES,
$HASP842 OUTDISP=(HOLD,HOLD),TRKCELL=YES
AS READY FOR COMMANDS.
– Output class in SDSF (TSO/SDSF – PRIMARY OPTION MENU):
sd.o(SYSOUT queue status) menu:
OUTPUT ALL CLASSES ALL FORMS LINES 49,048 LINE 1-14 (168)
JOBNAME JobID Owner Prty C Forms Dest Tot-Rec
JHISGL JOB08324 BCO1VGP 144 B STD LOCAL 308
JHISGL6 JOB08336 BCO1VGP 144 B STD LOCAL 280
All these outputs are in waiting status to be processed according their Class (A/write/, B/write/, F/keep/, O/keep/, R/write/), Forms (std, stk) and Outdisp (leave, hold, write) as result of job JCL statements definitions: //CKPRAC01 JOB (9999), MSGCLASS=X; //SYSOUT DD SYSOUT=*; //SYSPRINT DD SYSOUT=*; //SYSUDUMP DD SYSOUT=*.
sd.st (Status of jobs) menu for job CKPRAC01 JOB07773:
NP JOBNAME JobID Owner Prty Queue C Pos
? CKPRAC01 JOB07773 BCO1DSL 1 PRINT R 3411
Next after ‘?’ entered:
NP DDNAME StepName ProcStep DSID Owner C Dest Forms Rec-Cnt
JESMSGLG JES2 2 BCO1DSL X LOCAL STD 21
s JESJCL JES2 3 BCO1DSL X LOCAL STD 57
JESYSMSG JES2 4 BCO1DSL X LOCAL STD 37
PRINT0 DAU9000 105 BCO1DSL P LOCAL STK1 591
After ‘s’ entered you can view job JCL:
s JESJCL JES2 3 BCO1DSL X LOCAL:
//CKPRAC01 JOB (9999),
// ,
// REGION=0M,
// MSGCLASS=X,MSGLEVEL=(1,1)
The CKPRAC01 JOB statement defines MSGCLASS=X and the following statements assign SYSOUT (system output data set) to an job output class as follows:
//SYSOUT DD SYSOUT=* (default as in job statement MSGCLASS=X)
//SYSPRINT DD SYSOUT=*
//SYSUDUMP DD SYSOUT=*
After – ? CKPRAC01 JOB07773 – output data sets JESMSGLG/JESJCL/JESYSMSG will have class= X (with disp=hold and form=std), but output data set PRINT0 will have class= P(with disp=leave and form=stk1 as defined in PGM= DAU9000). Because of their disp=hold and disp=leave these output data sets will not go to sd.o but will stay in sd.st.
To see the length of each data set in records and in bytes after – ? CKPRAC01 JOB07773 – press PF11:
DDNAME Rec-Cnt Page-Cnt Byte-Cnt
JESMSGLG 21 1,443
sd. so (Spool offload ) menu – defined default parameters:
OFFLOAD1 DRAINED
OFF1.JT STARTABLE
OFF1.ST STARTABLE
OFF1.JR STARTABLE
OFF1.SR STARTABLE
OFFLOAD2 DRAINED
OFF2.JT STARTABLE
OFF2.ST STARTABLE
OFF2.JR STARTABLE
OFF2.SR STARTABLE
4. BACKUP/OFFLOAD of JES2 – Q to tape
4.1. Displays parameters of transmitter to tape ($DOFF1.ST)
(WS parameters for backup of the reports in JES2 are displayed)
TSO/ISPF –from sd.log – /$DOFF1.ST <ENTER> – after IPL:
/$DOFF1.ST:
OFF1.ST STATUS=STARTABLE,CREATOR=,DISP=DELETE,
OUTDISP=(WRITE,KEEP),HOLD=,JOBNAME=,NOTIFY=NO,
RANGE=(J1,999999),ROUTECDE=(),START=YES,
VOLUME=(,,,),WS=(Q,OUTD/),BURST=,FCB=,FLASH=,
FORMS=(,,,,,,,),LIMIT=(0,*),PLIM=(0,*),
PRMODE=(),QUEUE=,UCS=,WRITER=
4.2. Set parameters changes of transmitter to tape ($TOFF1.ST)
$TOFF1.ST,WS=(Q,OUTD,JOB/) – how to change WS?
(to exclude a parameter “-“ is put before the parameter) – example:
/$TOFF1.ST,WS=(-Q,-OUTD,JOB/) – result WS=(JOB/).
for each parameter in WS criteria has to be set – examples:
JOBNAME=*, JOBNAME=STG* – jobs with such prefixes to be offloaded
OUTDISP=(HOLD,KEEP,LEAVE,WRITE) – up to 4 maximum.
Queue=(A-Z;0-9) – up to 15 maximum.
DISP=DELETE – after the tape backup delete the report from JES2
DISP=KEEP – the reports remain /stay/. JES2 – examples:
/$TOFF1.ST,JOBNAME=* – ( * – for all jobs).
$TOFF1.ST,OUTDISP=(KEEP,WRITE)
/$TOFF1.ST,DISP=KEEP – the reports remain /stay/ in sd.o queue.
After changes:
OFF1.ST STATUS=STARTABLE,CREATOR=,DISP=KEEP,
OUTDISP=(WRITE,KEEP),HOLD=,JOBNAME=*,
NOTIFY=NO,RANGE=(J1,999999),ROUTECDE=(),
START=YES,VOLUME=(,,,),WS=(JOB/),BURST=,FCB=,
FLASH=,FORMS=(,,,,,,,),LIMIT=(0,*),PLIM=(0,*),
PRMODE=(),QUEUE=,UCS=,WRITER=
4.3. Displays parameters of the day ($DOFFLOAD1)
From sd.log – enter
/$DOFFLOAD1:
OFFLOAD1 DSN=BACKUP.JES.OFFLOAD1.DMMDDYYS,
STATUS=DRAINED,ARCHIVE=ONE,LABEL=SL,
PROTECT=NO,RETPD=30,TRACE=NO,UNIT=(VTS1,1),
VALIDATE=YES,VOLS=255
4.4. Set parameters changes of the day ($TOFFLOAD1)
From sd.log – enter:
/$TOFFLOAD1,DSN=BACKUP.JES.OFFLOAD1.DmmddyyS
mm – month
dd – day
yy – year
S – number of this offload 1/first/, 2/second/ etc.
/ – If command line is not enough – enter on System Command Extension:
Examples:
/$TOFFLOAD1,BACKUP.JES.OFFLOAD1.D0127091 – first tape for the day: 27.01.2009
/$TOFFLOAD1,UNIT=(3590,1) <ENTER> – changing MAGSTAR VTS virtual tape to physical non-VSAM tape – DEVICETYPES(CART35) for MAGSTAR or DEVICETYPES(3590-1) for device tape address=300.
Before transmitting to tape – define CB1018 as BACKUP.JES.OFFLOAD1.D0127091 in TSO catalog with DEFNVSAM_JOB_tape :
//IMPCON1 EXEC PGM=IDCAMS,REGION=512K
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
DEFINE NONVSAM –
(NAME(BACKUP.JES.OFFLOAD1.D0127091) –
DEVICETYPES(3590-1) – or DEVICETYPES(CART35) for MAGSTAR
VOLUMES(CB1018)) –
CAT(CATALOG.MVSICF1.VTSOC01)
/*
After changes:
/$DOFFLOAD1:
OFFLOAD1 DSN=BACKUP.JES.OFFLOAD1.D0127091,
STATUS=DRAINED,ARCHIVE=ONE,LABEL=SL,
PROTECT=NO,RETPD=30,TRACE=NO,UNIT=(3590,1),
VALIDATE=YES,VOLS=255
4.5. Start offload transmit to tape ($SOFFLOAD1,TYPE=TRANSMIT)
/$SOFFLOAD1,TYPE=TRANSMIT <ENTER>
Starts the backup on the JES Tape
When on the console appears the message
“ $HASP534 OFF1.ST INACTIVE”
the transfer is completed.
4.6. Stop offload transmit to tape ($POFFLOAD1)
Stop the offload:
/$POFFLOAD1
$HASP000 OK
$HASP097 OFF1.JT IS DRAINED
$HASP097 OFF1.ST IS DRAINED
IEF196I IEC205I SYS00006,JES2,JES2,FILESEQ=0001, COMPLETE VOLUME LIST,
IEF196I VOLS=CB1018,TOTALBLOCKS=313869
IEC205I SYS00006,JES2,JES2,FILESEQ=0001, COMPLETE VOLUME LIST, 958
VOLS=CB1018,TOTALBLOCKS=313869
IEF234E K 0280,CB1018,PVT,JES2,JES2 – RACK=CB1018
IEF196I IEF287I BACKUP.JES.OFFLOAD1.D012709S NOT
IEF196I RECTLGD 2
IEF196I IEF287I VOL SER NOS= CB1018.
$HASP097 OFFLOAD1 IS DRAINED
$ZOFFLOAD1 <ENTER> – Temporary stops the offload fore some parameters changes.
5. RESTORE/RELOAD from JES-Q TAPE
5.1. Displays parameters of receive – $DOFF1.SR
From sd.log =>/$DOFF1.SR
OFF1.SR STATUS=STARTABLE,OUTDISP=(WRITE,HOLD,KEEP,
LEAVE),CREATOR=,HOLD=,JOBNAME=,MOD=(BURST=,
OUTDISP=,FCB=,FLASH=,FORMS=,HOLD=,PRMODE=,
QUEUE=,ROUTECDE=,UCS=,WRITER=),NOTIFY=NO,
RANGE=(J1,2147483647),ROUTECDE=(),START=YES,
WS=(Q,OUTD/),BURST=,FCB=,FLASH=,FORMS=(,,,,,,,
),PRMODE=(),QUEUE=,UCS=,WRITER=
5.2. Set parameters changes of receive from tape ($TOFF1.SR)
From sd.log – enter:
/$TOFF1.SR,JOBNAME=STG* <ENTER> – restore all jobs with prefix STG*
/$TOFF1.SR,JOBNAME=BKPSLIBS – restore only one job
Possible change of another parameter – OUTDISP or QUEUE
in WS=(JOB/) or WS=(OUTD/)
$TOFF1.SR,WS=(JOB/)
/$TOFF1.SR,WS=(-Q,-OUTD,JOB/)
After changes:
From sd.log =>/$DOFF1.SR:
OFF1.SR STATUS=STARTABLE,OUTDISP=(WRITE,HOLD,KEEP,
LEAVE),CREATOR=,HOLD=,JOBNAME=BKPSLIBS,
MOD=(BURST=,OUTDISP=,FCB=,FLASH=,FORMS=,HOLD=,
PRMODE=,QUEUE=,ROUTECDE=,UCS=,WRITER=),
NOTIFY=NO,RANGE=(J1,2147483647),ROUTECDE=(),
START=YES,WS=(JOB/),BURST=,FCB=,FLASH=,
FORMS=(,,,,,,,),PRMODE=(),QUEUE=,UCS=,WRITER=
/$TOFF1.SR,MOD=(Q=C) – All restores are with class “C”
5.3. Displays parameters of the day for restore ($DOFFLOAD1)
From sd.log – enter /$DOFFLOAD1:
OFFLOAD1 DSN=BACKUP.JES.OFFLOAD1.DMMDDYYS,
STATUS=DRAINED,ARCHIVE=ONE,LABEL=SL,
PROTECT=NO,RETPD=30,TRACE=NO,UNIT=(VTS1,1),
VALIDATE=YES,VOLS=255
5.4. Set parameters changes of the day for restore ($TOFFLOAD1)
From sd.log – enter:
/$TOFFLOAD1,UNIT=(3590,1) – if not done
/$TOFFLOAD1,BACKUP.JES.OFFLOAD1.D0127091 – from the day 27.01.2009
(must be tape cataloged)
After changes:
OFFLOAD1 DSN=BACKUP.JES.OFFLOAD1.D0127091,
STATUS=DRAINED,ARCHIVE=ONE,LABEL=SL,
PROTECT=NO,RETPD=30,TRACE=NO,UNIT=(3590,1),
VALIDATE=YES,VOLS=255
5.5. Start offload receive from tape ($SOFFLOAD1,TYPE=RECEIVE)
/$SOFFLOAD1,TYPE,=RECEIVE <ENTER>
Start restore of the member
5.6. Stop offload receive from tape ($POFFLOAD1)
Stop the offload if not needed more:
/$POFFLOAD1
$HASP000 OK
$HASP000 OK
$HASP097 OFF1.JR IS DRAINED
$HASP543 BC2AC51A — OFF1.SR DELETED
$HASP097 OFF1.SR IS DRAINED
$HASP250 BC2AC51A PURGED — (JOB KEY WAS C3A9CE5A)
IEF234E K 0281,CB1018,PVT,JES2,JES2 – RACK=CB1018
IEF196I IEF287I BACKUP.JES.OFFLOAD1.D012709S
IEF196I RECTLGD 2
IEF196I IEF287I VOL SER NOS= CB1018.
$HASP097 OFFLOAD1 IS DRAINED
5.7. Temporary stop of offload ($ZOFFLOAD1) – to hold until some changes are made
/$TOFF1.SR,MOD=(Q=C) – all restored jobs to be in class=“C“.
RESTORE JES-Q TAPE on another NODE (for instance from BC2A to BC1B):
/$TOFF1.SR,R=(BC2AJES.*)
/$TOFF1.SR,MOD=(R=BC1BJES.*)
Incoming search terms:
- jes commands mainframe
- jes2 spool commands
- jes2
- jes2 offload
- $dspl percent
- jes2 spool offload
- how to purge a job in mainframe
- mainframe tips for the day
- jes2 job log
- jesmsglg jesjcl jesysmsg
Comments
No comments yet, be the first to add one!