ADD OR REMOVE JES2 SPOOL VOLUMES
CONTENTS
1. Display status of available JES2 spool volumes
2. Verify TGSPACE groups of JES2 spool for enough
3. Verify System definitions established at IPL time
4. Initialize spare volume to be added as spool volume BC2SP3
5. Define spool space on volume BC2SP3 and JES2 start command
6. Stop or remove spool volumes if they are not necessary
In the present article a procedure for display, add and remove JES2 spool volumes is described. Displaying spool information allow to monitor JES2 spooling and determine the action to take to control the spool environment. The current status of spool volumes and JES2 spool definitions are displayed online using JES2 commands in TSO/ISPF environment. The same JES2 spool definitions and parameters are fixed in the system member SYS1.PARMLIB(JES2PARM) used during IPL of the z/OS system to create and establish the JES2 spool. A spare disk volume is used and initialized with prefix assigned to JES2’s spool volumes and additional spool space is allocated on it. A start spool operator command is issued to become the added disk volume Active in the JES2 spool. With the Halt and drain spool commands the operator may stop usage of any spool volume (put to inactive status) or to remove if 0% used.
1. Display status of available JES2 spool volumes
From TSO/ISPF – sd.log – the current status of all available JES2 spool volumes is displayed with the command /$dspl as follows:
$HASP893 VOLUME(BC2SP1) STATUS=ACTIVE,PERCENT=63
$HASP893 VOLUME(BC2SP2) STATUS=ACTIVE,PERCENT=63
$HASP893 VOLUME(BC2SP3) 253
$HASP893 VOLUME(BC2SP3) STATUS=DRAINING,AWAITING(JOBS),
$HASP893 PERCENT=1
$HASP893 VOLUME(BC2SP4) 254
$HASP893 VOLUME(BC2SP4) STATUS=INACTIVE,PERCENT=0
$HASP646 63.4752 PERCENT SPOOL UTILIZATION
The JES2 spool volumes status may be: active, starting, draining, drained, halting, inactive or removed (absent):
Active – the volume is available to be used for JES2 spool data.
Starting – when a start command is issued for a given spool volume (that was in inactive status or a new volume is to be added) to mini-format and dynamic allocate it.
Draining – when a drain command is issued and the spool data on the volume are not transferred yet on the other active spool volumes.
Drained – the drain command is completed and the volume is removed from the spool and go to inactive status.
Halting – when a halt command is issued and the volume is going to inactive status.
Inactive – after drain or halt command issued.
Removed – if absent from the online display using the command /$dspl.
63, 63.4752 PERCENT SPOOL UTILIZATION – % of spool utilization for each volume or for the whole spool.
2. Verify TGSPACE groups of JES2 spool for enough
From TSO/ISPF – sd.log – the current status of JES2 spool definitions is displayed with the online command /$DSPOOLDEF to verify for enough TGSPACE groups:
$HASP844 SPOOLDEF 260
$HASP844 SPOOLDEF BUFSIZE=3856,DSNAME=SYS1.HASPACE,
$HASP844 FENCE=(ACTIVE=NO,VOLUMES=1),GCRATE=NORMAL,
$HASP844 LASTSVAL=(2007.208,17:16:47),RELADDR=NEVER,
$HASP844 SPOOLNUM=32,TGSIZE=33,TGSPACE=(MAX=195456,
$HASP844 DEFINED=66470,ACTIVE=33235,PERCENT=63.4812,
$HASP844 FREE=12137,WARN=80),TRKCELL=5,VOLUME=BC2SP
Or
$HASP844 DEFINED=66470,ACTIVE=33235,PERCENT=14.7916,
$HASP844 FREE=28319,WARN=80),TRKCELL=5,VOLUME=BC2SP
Or
$HASP844 DEFINED=66470,ACTIVE=66470,PERCENT=7.7794,
$HASP844 FREE=61299,WARN=80),TRKCELL=5,VOLUME=BC2SP
BUFSIZE= 3856 – Specifies the size (1944-3992) in bytes, of each JES2 buffer
SPOOLNUM= 32
Specifies the maximum number of spool volumes which can be defined at any one time. Spool volumes are defined by either use of the VOLUME= parameter on this initialization statement during a JES2 cold start, or they can be defined by using the $S SPL (start spool) operator command. This parameter can be increased with a $T SPOOLDEF command after an $ACTIVATE command has been issued.
TGSIZE=33 – the number (1-255) of JES2 buffers to be contained in a track group.
TGSPACE=( MAX=195456 – specifies the maximum number (1-9935680) of track groups required before the next cold start. This value should include the track groups for all concurrently mounted spool volumes and for all planned spool additions when determining each spool volume’s requirement. Specify TGSPACE=(MAX=) as a multiple of 16288.
the number of track groups per volume –
DEVICE |
BUFSIZE |
CYL/VOL |
TRKS/GRP* |
TRACK |
3390-2 | 3992 | 2226 | 3 | 11130 |
(/$tspooldef,tgspace=(max=nnnnnn) if necessary to modify)
WARN= 80 – specifies the percentage (0-100) of use of track groups at which the operator will be alerted through message $HASP050 JES2 RESOURCE SHORTAGE
TRKCELL=5 – Specifies the size (1-120) of a track cell in terms of spool buffers – the number of records on a track of a spool volume
VOLUME=BC2SP – Specifies the 4- to 5-character prefix assigned to JES2’s spool volumes
3. Verify System definitions established at IPL time
SYS1.PARMLIB(JES2PARM) – spool definitions + paramaters
Checkpoint Volume Space Definitions
CKPTDEF CKPT1=(DSNAME=SYS1.HASPCKPT,
/* NAME FOR CKPT &DSNPRFX
VOLSER=BC1S31, /* SYS1.HASPCKPT
INUSE=YES), /*
CKPT2=(DSNAME=SYS1.HASPCKP2,
/* NAME FOR CKPT &DSNPRFX
VOLSER=BC1S32, /* SYS1.HASPCKP2
INUSE=YES), /*
Spool Volume Space Definitions
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=BC1S3 /* SPOOL VOLUME SERIAL &SPOOL
The following job JES2ALCM allocate SYS1.HASPACE AND CHKPT DATA SETS on volumes BC1S31 and BC1S32 when the system is created for JES2 needs:
//JES2ALCM JOB (9999,IPO,10,10),
// ‘OPER’,
// ,
// MSGCLASS=X,
// MSGLEVEL=(1,1),
// NOTIFY=,
// TIME=1440,
// USER=
//*
//* ALLOCATE SYS1.HASPACE AND CHKPT DATA SETS
//ALLOCATE EXEC PGM=IEFBR14
//CKPT1A DD DISP=(,KEEP),UNIT=(3390),
// VOL=SER=BC1S31,SPACE=(CYL,(25),,CONTIG),
// DSN=SYS1.HASPCKPT
//CKPT2A DD DISP=(,KEEP),UNIT=(3390),
// VOL=SER=BC1S32,SPACE=(CYL,(25),,CONTIG),
// DSN=SYS1.HASPCKP2
//SPACE1A DD DISP=(,KEEP),UNIT=(3390),
// VOL=SER=BC1S31,SPACE=(CYL,(3311),,CONTIG),
// DSN=SYS1.HASPACE
//SPACE2A DD DISP=(,KEEP),UNIT=(3390),
// VOL=SER=BC1S32,SPACE=(CYL,(3311),,CONTIG),
// DSN=SYS1.HASPACE
//* ALLOCATE ADDITIONAL SYS1.HASPACE
//ALLOCATE EXEC PGM=IEFBR14
//SPACE1A DD DISP=(,KEEP),UNIT=(3390),
//JES2ALCM JOB (9999),
// ,
// REGION=0M,
// MSGCLASS=X,MSGLEVEL=(1,1)
//*
//* ALLOCATE ADDITIONAL SYS1.HASPACE
//ALLOCATE EXEC PGM=IEFBR14
//SPACE1A DD DISP=(,KEEP),UNIT=(3390),
// VOL=SER=BC2SP3,SPACE=(CYL,(3311),,CONTIG),
// DSN=SYS1.HASPACE
/*
4. Initialize spare volume to be added as spool volumes BC2SP3
First go to TSO/ISPF – p.6 – 2 – 2 – 3 – to find a spare volume (0582) , vary it offline (/v 0582,offline) and start job DSFINIT3 (if volume is 3GB) or DSFINIT9 (if volume is 9GB):
//DSFINIT3 JOB ‘SYSTEMS’,CLASS=B,MSGCLASS=X,MSGLEVEL=(1,1)
//DSF1 EXEC PGM=ICKDSF,REGION=1024K
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
INIT UNIT(0582) VOLID(BC2SP3) PRG –
DEVTYPE(3390) VTOC(0,1,195) INDEX(014,0,45) NOVERIFY
//DSFINIT9 JOB ‘SYSTEMS’,CLASS=B,MSGCLASS=X,MSGLEVEL=(1,1)
//DSF1 EXEC PGM=ICKDSF,REGION=1024K
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
INIT UNIT(1900) VOLID(SP1900) PRG –
DEVTYPE(3390) VTOC(0,1,674) INDEX(45,0,150) NOVERIFY
Vary online the volume initialized as BC2SP3 (/v 0582, online ).
5. Define spool space on volume BC2SP3 and JES2 start command
– additional space definition
To define /format additional SYS1.HASPACE on the initialized volume BC2SP3 the following job JES2ALCM is used:
//JES2ALCM JOB (9999),
// ,
// REGION=0M,
// MSGCLASS=X,MSGLEVEL=(1,1)
//*
//* ALLOCATE ADDITIONAL SYS1.HASPACE
//ALLOCATE EXEC PGM=IEFBR14
//SPACE1A DD DISP=(,KEEP),UNIT=(3390),
// VOL=SER=BC2SP3,SPACE=(CYL,(3311),,CONTIG),
// DSN=SYS1.HASPACE
/*
– activate spool volume BC2SP3
From TSO/ISPF – sd.log – /$S SPL(BC2SP3) – (start spool) operator command is issued to ACTIVATE THE NEW ADDED SPOOL VOLUME BC2SP3:
$HASP893 VOLUME(BC2SP3) STATUS=INACTIVE,COMMAND=(START)
$HASP646 15.0130 PERCENT SPOOL UTILIZATION
IEF196I IEF237I 0582 ALLOCATED TO $BC2SP3
$HASP850 16555 TRACK GROUPS ON BC2SP4
$HASP850 16555 TRACK GROUPS ON BC2SP1
$HASP850 16680 TRACK GROUPS ON BC2SP2
$HASP850 16555 TRACK GROUPS ON BC2SP3
$HASP851 129096 TOTAL TRACK GROUPS MAY BE ADDED
$HASP630 VOLUME BC2SP3 ACTIVE 0 PERCENT UTILIZATION
/$dspl – display available spool volumes with the added ACTIVE volume BC2SP3
$HASP893 VOLUME(BC2SP4) STATUS=ACTIVE,PERCENT=14
$HASP893 VOLUME(BC2SP1) STATUS=ACTIVE,PERCENT=15
$HASP893 VOLUME(BC2SP2) STATUS=ACTIVE,PERCENT=14
$HASP893 VOLUME(BC2SP3) STATUS=ACTIVE,PERCENT=0
$HASP646 11.2668 PERCENT SPOOL UTILIZATION
6. Stop or remove spool volumes if they are not necessary
From TSO/ISPF – sd.log – /$z spl,(BC2SP3) – (halt spool) operator command is issed to stop usage of volume BC2SP3 (put to inactive status):
$HASP893 VOLUME(BC2SP3) 460
$HASP893 VOLUME(BC2SP3) STATUS=ACTIVE,AWAITING(BC2A),
$HASP893 COMMAND=(HALT)
$HASP646 11.2668 PERCENT SPOOL UTILIZATION
IEF196I IEF285I SYS1.HASPACE
IEF196I IEF285I VOL SER NOS= BC2SP3.
$HASP630 VOLUME BC2SP3 INACTIVE 0 PERCENT UTILIZATION
/$dspl – display available spool volumes with BC2SP3 INACTIVE
$HASP893 VOLUME(BC2SP4) STATUS=ACTIVE,PERCENT=14
$HASP893 VOLUME(BC2SP1) STATUS=ACTIVE,PERCENT=15
$HASP893 VOLUME(BC2SP2) STATUS=ACTIVE,PERCENT=14
$HASP893 VOLUME(BC2SP3) STATUS=INACTIVE,PERCENT=0
$HASP646 15.0130 PERCENT SPOOL UTILIZATION – increased from 11.2668 to 15.0130 PERCENT SPOOL UTILIZATION after stopping volume BC2SP3.
From TSO/ISPF – sd.log – /$p spl(BC2SP3) – (drain spool) operator command is issued to remove ACTIVE BC2SP3 from spool (going via draining, drained, inactive and removed if 0% used):
$HASP893 VOLUME(BC2SP3) 400
$HASP893 VOLUME(BC2SP3) STATUS=ACTIVE,AWAITING(BC2A),
$HASP893 COMMAND=(DRAIN)
$HASP646 11.2668 PERCENT SPOOL UTILIZATION
IEF196I IEF285I SYS1.HASPACE
IEF196I IEF285I VOL SER NOS= BC2SP3.
$HASP806 VOLUME BC2SP3 DRAINED
$HASP850 16555 TRACK GROUPS ON BC2SP4
$HASP850 16555 TRACK GROUPS ON BC2SP1
$HASP850 16680 TRACK GROUPS ON BC2SP2
$HASP851 145656 TOTAL TRACK GROUPS MAY BE ADDED
/$dspl – display available spool volumes with BC2SP3 removed
$HASP893 VOLUME(BC2SP4) STATUS=ACTIVE,PERCENT=14
$HASP893 VOLUME(BC2SP1) STATUS=ACTIVE,PERCENT=15
$HASP893 VOLUME(BC2SP2) STATUS=ACTIVE,PERCENT=14
$HASP646 15.0130 PERCENT SPOOL UTILIZATION – increased from 11.2668 to 15.0130 PERCENT SPOOL UTILIZATION after volume BC2SP3 is removed.
Incoming search terms:
- yhs-fullyhosted_003
Comments
No comments yet, be the first to add one!