Function

To display the JES2 spooling environment characteristics.

Parameters

BUFSIZE

Displays the size (1944-3992 in bytes) of each JES2 buffer.

Scope: MAS-Wide.

CYL_MANAGED

Displays whether MAS members allow a SPOOL volume on cylinder-managed storage or not.

FAIL

JES2 data sets cannot be allocated in EAV cylinder-managed space.

ALLOWED

Both JES2 spool and checkpoint data sets can be allocated in EAV cylinder managed space.

Scope: MAS-Wide.

DSNAME

Displays the 1-44 character data set name for the JES2 spool data set. This data set is normally named SYS1.HASPACE, but its name can be changed. The $D SPOOL DSNAME value must match either the $D SPOOLDEF DSNAME or the $D SPOOLDEF DSNMASK value.

Scope: MAS-Wide.

DSNMASK

Displays the 1-44 characters data set mask name, including generic characters. If the DSNAME parameter is specified with the $S SPOOL command, the DSNAME value must match either the $D SPOOLDEF DSNAME value or the $D SPOOLDEF DSNMASK value. If the $D SPOOLDEF DSNMASK value is null, the DSNAME value must match the $D SPOOL DSNAME value.

Scope: MAS-Wide.

FENCE

Displays how track groups for jobs will be assigned across spool volumes.

ACTIVE=YES|NO

Determines whether (YES) or not (NO) any fencing is active at the time.

VOLUMES=nnn

Is the number of volumes a job will be fenced to.

Scope: MAS-Wide.

GCRATE

Specifies the rate for a JES2 spool garbage collection cycle. During a cycle, JES2 examines the signature records for every allocated track group on non-inactive spool volumes. JES2 recovers track groups for jobs no longer in the system and writes a symptom record.

You can only set this parameter using a $T command.

Note: Using GCRATE=FAST will not ease most SPOOL-full situations when the SPOOL space is legitimately owned by existing jobs.

NORMAL

Specifies that JES2 is pacing the examination of track group so that JES2 completes a spool garbage collection cycle in about seven days

FAST

Specifies that JES2 is performing an accelerated garbage collection cycle. JES2 is not performing pacing and is not waiting between track groups examination. JES2 resumes NORMAL pace processing after it completes this FAST cycle.

Scope: MAS-Wide.

LASTSVAL

Displays the time (GMT time) of the last spool validation (yyyy/ddd,hh:mm:ss). This time stamp represents the last time the system was either cold started or spool=validate was issued on a warm start.

This is used for diagnosis purposes, and the time stamp will be generated in one of three ways:

• Cold start
• Warm start with spool=validate
• JES2 initiated spool=validate when there is a detected error. The source of this error will be reported by message $HASP492

Scope: MAS-Wide.

LARGEDS

Displays whether large SPOOL data sets (greater than 65,535 tracks) can be started or not. Also indicates whether the new format SPOOL record addresses (MTTRs) are in use or not.

FAIL

Any attempt to start a SPOOL data set with more than 65,535 tracks fails.

ALLOWED

SPOOL data sets with up to the current size limit (1,048,575 tracks) can be started. New format SPOOL addresses are used when starting a new volume that contains SPOOL data sets that are greater than 65,535 tracks.

ALWAYS

SPOOL data sets with up to the current size limit (1,048,575 tracks) can be started. The new format SPOOL addresses are used when starting any volume (regardless of data set size).

Scope: MAS-Wide.

SPOOLNUM

The SPOOLNUM parameter displays the maximum number (1-253, rounded up to a multiple of 32 to 253) of spool volumes defined to a JES2 MAS configuration.

Scope: MAS-Wide.

TGSIZE

Displays the number (1-255) of JES2 buffers in a track group. JES2 uses this parameter to determine the size of a track group on a new spool volume being added to the complex.

Scope: Single Member.

TGSPACE=[ACTIVE|DEFINED|FREE|MAX|PERCENT| WARN]

The TGSPACE parameter displays the number of track groups on spool volumes. Information displayed for the type of spool volume follows:

• ACTIVE - the total number of track groups on all available spool volumes.
• DEFINED - the total number of track groups on all defined spool volumes.
• FREE - the total number of track groups on all available spool volumes that are currently unallocated.
• MAX - the maximum number of track groups that can be used in the complex.
• PERCENT - The current percentage of the total amount of spool space that is in use.
• WARN - the percentage of used track groups at which the operator will be alerted through message $HASP050 JES2 RESOURCE SHORTAGE.

Scope: MAS-Wide.

TRKCELL

The TRKCELL parameter displays the size of a track cell in terms of spool buffers (1-120); that is, TRKCELL displays the number of direct-access spool records to be logically ordered on a spool track and the number of records to be despooled (read from the spool) in one operation during print processing.

Scope: MAS-Wide.

VOLUME

The VOLUME parameter displays the 4- to 5-character prefix assigned to JES2 spool volumes. The prefix can contain 1-5 generic characters.

Scope: MAS-wide.

Authority Required

This command requires display authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Scope

The scope of this command varies by parameter.

Some parameters on this command will display information about the entire MAS, while other parameters will display information about this member only.

You might want to use the parameters for this command to get information about all members of the MAS. If so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP844 message displays the current values of all the parameters on the SPOOLDEF initialization statement.

The LASTSVAL parameter displays the time of the last spool validation (yyyy/ddd,hh:mm:ss). This parameter cannot be specified by command because it is display-only.

JES2 displays all current spooling environment characteristics.