Professional Documents
Culture Documents
Jes 2 Messages - Zos
Jes 2 Messages - Zos
JES2 Messages
SA22-7537-06
z/OS
JES2 Messages
SA22-7537-06
Note
Before using this information and the product it supports, be sure to read the general information under “Notices” on page
333.
Summary of changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Chapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
System log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Hard-copy log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
JES2 message format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Messages preceded by a job identifier . . . . . . . . . . . . . . . . . . . . . . . . . 2
Multiple-line JES2 messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
A Method for Finding Changes to MVS and TSO/E Message Texts . . . . . . . . . . . . . . 4
JES2 message documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Chapter 5. One-hundreds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Chapter 6. Two-hundreds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
Programming Interface Information . . . . . . . . . . . . . . . . . . . . . . . . . 334
Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
You can use LookAt from these locations to find IBM message explanations for z/OS® elements and
features, z/VM®, VSE/ESA™, and Clusters for AIX® and Linux™:
v The Internet. You can access IBM message explanations directly from the LookAt Web site at
www.ibm.com/servers/eserver/zseries/zos/bkserv/lookat/.
v Your z/OS TSO/E host system. You can install code on your z/OS or z/OS.e systems to access IBM
message explanations using LookAt from a TSO/E command line (for example: TSO/E prompt, ISPF, or
z/OS UNIX® System Services).
v Your Microsoft® Windows® workstation. You can install LookAt directly from the z/OS Collection
(SK3T-4269) or the z/OS and Software Products DVD Collection (SK3T-4271) and use it from the
resulting Windows graphical user interface (GUI). The command prompt (also known as the DOS >
command line) version can still be used from the directory in which you install the Windows version of
LookAt.
v Your wireless handheld device. You can use the LookAt Mobile Edition from www.ibm.com/servers/
eserver/zseries/zos/bkserv/lookat/lookatm.html with a handheld device that has wireless access and an
Internet browser (for example: Internet Explorer for Pocket PCs, Blazer or Eudora for Palm OS, or
Opera for Linux handheld devices).
You can obtain code to install LookAt on your host system or Microsoft Windows workstation from:
v A CD-ROM in the z/OS Collection (SK3T-4269).
v The z/OS and Software Products DVD Collection (SK3T-4271).
For additional information about checks and about IBM Health Checker for z/OS, see IBM Health Checker
for z/OS: User’s Guide. Starting with z/OS V1R4, z/OS users can obtain the IBM Health Checker for z/OS
from the z/OS Downloads page at http://www.ibm.com/servers/eserver/zseries/zos/downloads/.
SDSF also provides functions to simplify the management of checks. See z/OS SDSF Operation and
Customization for additional information.
Note: Most user messages are explained in other message books, such as z/OS TSO/E
Messages.
Application Programmer Response
Instructions for an application programmer.
Only provided for messages that could appear in SYSOUT produced by a job, for example
SPZAP.
System Programmer Response
Instructions for the system programmer.
Only provided for messages that require additional action beyond the operator response, user
response, or application programmer response.
Most licensed documents were declassified in OS/390 V2R4 and are now included on the z/OS Online
Library Collection, SK2T-6700. The remaining licensed documents appear in unencrypted BookManager
softcopy and PDF form on the z/OS Licensed Product Library, LK2T-2499.
Additional information
Additional information about z/OS elements can be found in the following documents.
However, some messages cannot be translated because of their very nature. Messages such as
$HASP000 OK, and messages that consist wholly or mostly of substituted variables, such as $HASP088,
cannot be translated.
The document contains information previously presented in z/OS JES2 Messages, SA22-7537-05, which
supports z/OS Version 1 Release 7.
New information
v $HASP608
v $HASP715
v $HASP889
v $HASP9171
v $HASP9172
Changed information
v $HASP003
v $HASP443
v $HASP607
This document contains terminology, maintenance, and editorial changes. Technical changes or additions
to the text and illustrations are indicated by a vertical line to the left of the change.
You may notice changes in the style and structure of some content in this document - for example,
headings that use uppercase for the first letter of initial words only, and procedures that have a different
look and format. The changes are ongoing improvements to the consistency and retrievability of
information in our documents.
Summary of changes
for SA22-7537-05
z/OS Version 1 Release 7
The document contains information previously presented in z/OS JES2 Messages, SA22-7537-04, which
supports z/OS Version 1 Release 5.
New information
v $HASP060
v $HASP107
v $HASP108
v $HASP109
v $HASP110
v $HASP111
v $HASP112
v $HASP113
v $HASP114
v $HASP115
v $HASP116
v $HASP139
Changed information
v $HASP003
v $HASP077
v $HASP088
v $HASP095
Deleted information
v $HASP127
v $HASP117
v $HASP304
v $HASP349
v $HASP354
v $HASP399
v $HASP476
v $HASP480
v $HASP9139
This document contains terminology, maintenance, and editorial changes. Technical changes or additions
to the text and illustrations are indicated by a vertical line to the left of the change.
Summary of changes
for SA22-7537-04
z/OS Version 1 Release 5
The document contains information previously presented in z/OS JES2 Messages, SA22-7537-03, which
supports z/OS Version 1 Release 4.
New information
v $HASP892 — QUEUE_ERROR(n) with reason codes added
v $HASP9107 {No} JES2 ERROR COUNTS SINCE
v $HASP9133 JES2 ERROR HISTORY
v $HASP9163 FAST SPOOL GARBAGE COLLECTION (SPOOLDEF GCRATE=FAST)
Changed information
v $HASP003 — new reason code (100) added
v $HASP110
v $HASP500
v $HASP603
v $HASP607
v $HASP703
v $HASP714
v $HASP844
v $HASP890
This document contains terminology, maintenance, and editorial changes. Technical changes or additions
to the text and illustrations are indicated by a vertical line to the left of the change.
Summary of changes
for SA22-7537-03
z/OS Version 1 Release 4
The document contains information previously presented in z/OS JES2 Messages, SA22-7537-02, which
supports z/OS Version 1 Release 3.
Summary of changes xv
v $HASP9209
v $HASP9210
v $HASP9211
v $HASP9301
v $HASP9302
Changed information
v $HASP003
v $HASP095
v $HASP119
v $HASP263
v $HASP264
v $HASP276
v $HASP277
v $HASP375
v $HASP435
v $HASP449
v $HASP467
v $HASP474
v $HASP603
v $HASP708
v $HASP709
v $HASP712
v $HASP875
This document contains terminology, maintenance, and editorial changes. Technical changes or additions
to the text and illustrations are indicated by a vertical line to the left of the change.
System log
The system log (SYSLOG) is a SYSOUT data set provided by JES2. SYSOUT data sets are output spool
data sets on direct access storage devices (DASD). Your installation should print the SYSLOG periodically.
The SYSLOG consists of:
v All messages from WTL macros
v All messages entered by operator LOG commands
v Typically the hard-copy log
v Any messages routed to the SYSLOG from any system component or program.
Hard-copy log
The hard-copy log is a record of all system message traffic and written to SYSLOG.
{* }
[hh.mm.ss] [sysname] {jobid} {@ } {Nn Mm} $HASPnnnn text
{b[+]}
hh.mm.ss
The time stamp shows the time the message was issued in hours, minutes, and seconds. This display
is optional and appears before the message identifier ($HASPnnn) if your installation has entered the
CONTROL (K S,MFORM=(T)) command to include the time stamp in the console message format.
sysname
The system name. This display is optional and appears before the message identifier ($HASPnnn) if
your installation has entered the CONTROL (K S,MFORM=(S)) command to include the system name
in the console message format.
jobid
JES2 job identifier. This display is optional, and it appears before a subset of message identifiers
($HASPnnn) if your installation has entered the CONTROL (K S,MFORM=(J)) command to include the
job identifier in the console message format. See Table 1 on page 2 for a list of the subset of
messages preceded by a job identifier.
If JES2 is responding to a request for information about a range of devices that requires multiple lines, a
multiple-line message will be issued for each device. For example, $D NODE(1-3) causes JES2 to display
three multiple-line messages: one each for node 1, 2, and 3.
If a message that JES2 issues as a multiple-line message does not contain enough information to span
more than one line, JES2 issues that message in single-line format. This occurs when:
v JES2 uses the message to display information for various devices that do not contain enough
information to create more than a single line of message data.
v JES2 responds to a command that limits the information for a device to a single line. For example, by
entering the $D NODE(POK),STATUS command, the following single-line message is issued:
When automating messages, it is recommended that your automation program determine how many lines
are contained in the message. If there is more than one line, your automation program should process the
first line as the control line of a multiple-line message. Table 2 lists the message identifiers for the
messages that JES2 issues as multiple-line messages.
Chapter 1. Introduction 3
A Method for Finding Changes to MVS and TSO/E Message Texts
Automation routines are sensitive to changes to message text between releases. You can find changes to
message texts in the following ways:
v The Summary of Changes of the related messages book can be helpful when you go from one release
to the next.
v Data set SYS1.MSGENU contains data that can help you identify changes to message texts more
accurately. This method allows you to find message text changes between your current release and
whatever release you choose to migrate to. This method is described below.
Also, this method works better if the “old” copy of SYS1.SHASMENU has the same level of service as the
system from which you are migrating.
You can compare the new data set with the data set on the system from which you are migrating.
Depending on how you do the comparison, you can get output like the following.
For new messages, the output might show an I (for Insert) on the left:
I - IEA403I VALUE OF RMAX HAS BEEN CHANGED TO 99
For messages whose text has changed, the output might show both an I and a D, indicating that a record
in the message file has been replaced:
I - IEE162I 46 &NNN. ROLL &A. MESSAGES (DEL=R OR RD)
D - IEE162I 46 &NNN. ROLL &A. MESSAGES (DEL=R, RD)
This means that, in message IEE162I, (DEL=R, RD) was replaced by (DEL=R OR RD).
Using this information, you can decide if your automation routines need to be changed.
Some messages have alternative fields; that is, under certain circumstances one field will appear, and
under other circumstances another field will appear. One of the alternative fields appear when the
message appears on your console. In this document, alternative fields are shown stacked one above the
other, enclosed in braces:
$HASPnnn message text {first alternative }
{second alternative}
Chapter 1. Introduction 5
6 z/OS V1R8.0 JES2 Messages
Chapter 2. Routing codes
Routing codes send system messages to the consoles where they are to be displayed. More than one
routing code can be assigned to a message to send it to more than one console. For more information on
message routing, see the following documents:
v z/OS MVS Programming: Authorized Assembler Services Guide
v z/OS MVS Programming: Authorized Assembler Services Reference SET-WTO
v z/OS MVS Installation Exits
v z/OS MVS Initialization and Tuning Reference
Specification
The routing codes are specified in the ROUTCDE parameter of the WTO or WTOR macro. If you specify a
message which contains no routing codes, MVS may provide one or more default routing codes, based
upon the presence or lack of other queuing specifications.
If you specify a message containing descriptor codes but no routing codes and no target console, MVS will
not assign any routing codes but will attempt to queue the message to the console with master authority.
If you specify a message containing no routing codes, no descriptor codes, and no target console, MVS
will assign a default set of routing codes. This set of default routing codes is specified at MVS initialization
on the DEFAULT statement in your CONSOLxx parmlib member. If a set of default routing codes was not
provided on the DEFAULT statement, MVS will assign routing codes 1 through 6.
Specification
Descriptor codes are specified in the DESC parameter of the WTO or WTOR macro. The following
restrictions apply when specifying descriptor codes:
v Descriptor codes 1 through 6, 11, and 12 are mutually exclusive. Assign only one of these codes to a
message. If you assign two mutually exclusive codes to one message, the system uses the most
important code and ignores the other.
v Descriptor codes 7 through 10 and 13 can be assigned in combination with any of the mutually
exclusive codes.
v Descriptor code 9 or 10 can be used only with descriptor code 8.
Under certain conditions, the system uses a descriptor code other than that specified in the macro as
follows:
v The system assigns descriptor code 6 if the macro specifies a ROUTCDE parameter, but no DESC
parameter.
v The system assigns descriptor code 7 if all of the following are true:
1. A problem program issued the macro.
2. The macro omits both DESC and ROUTCDE parameters, or specifies descriptor codes 1 or 2.
3. The message is not a multiple-line WTO message.
v The system assigns no descriptor code if all of the following are true:
1. An authorized program issued the macro.
2. The macro omits both DESC and ROUTCDE parameters.
3. The message is not a multiple-line WTO message.
The system deletes messages issued by any program when that program issues the DOM macro.
The operator can manually remove all messages from a display console screen or can set the console to
roll messages off the screen.
Message color
On operator consoles with color, the descriptor code determines the color of the message. The use of
color is explained in z/OS MVS System Commands. Also see the descriptions of the CONSOLxx and
MPFLSTxx parmlib members in z/OS MVS Initialization and Tuning Reference.
Note: When an authorized program issues a message with descriptor code 2, a DOM
macro must be issued to delete the message after the requested action is
performed.
3 Eventual Action Required
The message indicates that the operator must perform an action eventually. The task does
not wait for the operator to complete the action.
If the task can determine when the operator has performed the action, the task should
issue a DOM macro to delete the message when the action is complete.
4 System Status
The message indicates the status of a system task or of a hardware unit.
5 Immediate Command Response
The message is issued as an immediate response to a system command. The response
does not depend on another system action or task.
6 Job Status
The message indicates the status of a job or job step.
7 Task-Related
The message is issued by an application or system program. Messages with this
descriptor code are deleted when the job step that issued them ends.
The value specified for the keyword is in an node (NnnnnRnnnn), a special local (Unnnn),
incorrect character set. or a local (LOCAL) destination.
07 INVALID JOB TYPE This message will be issued during
initialization:
The job type specified for the keyword is
incorrect. For offload SYSOUT v if the symbolic node name has not yet been
receivers/transmitters and print/punch devices, defined to JES2 (either the NODE statement
the valid job types are J, S, and T. For offload defining the symbolic node name is missing
job receivers/transmitters, the only valid job from the initialization stream or JES has not
type is J. yet processed the NODE statement in the
initialization stream).
08 VALUE IS OUTSIDE NUMERICAL RANGE,
v if JES2 detected a DESTID(xxxxxxxx)
RANGE IS (xxxx—yyyy)
subscript value that matched a NODE
The value specified for the keyword is not NAME= specification within the initialization
within the specified range. data set. (JES2 does not allow you to
specify functionally redundant DESTID
09 DATA IS TOO SHORT statements in the initialization data set.)
The number of characters entered is
insufficient for the value of the specified The problem is either that the sequence of the
keyword. node definition in the initialization stream is not
correct or the initialization stream defines a
10 DATA IS TOO LONG duplicate node. Correct the initialization stream.
Too many characters were entered for the
value of the specified keyword. If you ignore this error message when a
DESTID subscript value matches a NODE
11 TOO MANY {REMOTE | NETWORK NAME specification and proceed with
RECEIVER | NETWORK XMITTER} DEVICES initialization, JES2 will initialize, but is unable to
HAVE BEEN DEFINED communicate with the duplicated node as
The specified device exceeds the maximum specified by trace-of-keywords. This means
number allowed. that anything you direct to the duplicated node,
such as output or commands, might arrive at
12 MISSING REQUIRED OPERAND xxxxxxxx an unexpected destination.
The variable field xxxxxxxx is optional. When 18 INVALID ROUTE CODE
present, it indicates the required operand that
is missing for the specified keyword. In general the valid route codes for a device
are to a node (Nnnnn), a remote workstation
13 VALUE CAN NOT BE DISPLAYED – TOO (Rnnnn or R*), a remote workstation on a
LARGE different node (NnnnnRnnnn or NnnnnR*), a
A request to display a specified keyword value special local (Unnnn) or a local (LOCAL). See
cannot be granted because the area used for the description of the specific device in z/OS
display processing is too small. An error has JES2 Initialization and Tuning Reference for a
occurred in $SCAN processing. Determine if list of the valid route codes.
it’s either an installation exit or an IBM $SCAN 19 INVALID ACCOUNT INFORMATION
error. If it is an internal JES2 error, contact the
IBM support center. The specified low range of the account
information is greater than the specified high
14 TOO MANY keyword type WERE PROVIDED range of the account information.
The specified keyword is ignored because too 21 INVALID REMOTE DEVICE NAME
many have been provided for this keyword
type. You have exceeded the maximum The specified remote device has not been
number of specified items that have been defined to JES2 with an RMTnnnn initialization
defined for your system. If this is a subscript statement because it was issued locally, and
value, you have exceeded the valid number of JES2 could not determine the remote device
subscripts on the command. name. For example, if not issued from a
remote, issue the fully qualified command $D
17 INVALID DESTINATION R(nnnn).PU(m).
The value specified for the destination must be 22 VALUE CAN NOT BE DISPLAYED – NOT
for a node (Nnnnn), a remote workstation YET SPECIFIED
(Rnnnn), a remote work station on another
A request was made to display a keyword that zero. It is possible that an attempt to display
has not been specified. fields in a control block was made before the
set request to build the control block. Contact
23 INVALID COMMENT FOUND
the IBM support center.
An incorrect comment was found. Either it does
31 MODULE COULD NOT BE LOADED
not have the proper delimiters (/* comment */)
or its location is not legal. See z/OS JES2 The specified module cannot be loaded. See
Initialization and Tuning Reference or z/OS message $HASP875, RC=02 for more
JES2 Commands for valid syntax. information.
24 REQUEST DENIED – INSUFFICIENT 32 MODULE IS INVALID, RMODE MUST BE 24
STORAGE
The module is in RMODE 31; JES2 expects it
The request is denied because there is to be in RMODE 24. See message $HASP875,
insufficient storage to satisfy it. Increase the RC=06 for more information.
JES2 region size or increase the private
33 MODULE NAME DOES NOT MATCH ITS MIT,
storage area above 16 megabytes in virtual
EXPECTED-mit_exp ACTUAL-mit_act
storage.
The module name does not match the label
25 NO SELECTABLE DEVICE(S) FOUND
specified on the $MODULE macro. See
A request to set, display, or act upon (for message $HASP875, RC=07 for more
example, $P) a device or range of devices information. z/OS JES2 Macros provides a
cannot be satisfied. Either JES2 could not find description of the $MODULE macro.
a device or the device it found was not in the
34 MODULE VERSION IS INVALID,
range, didn’t match the filter, or is in a state
EXPECTED-ver_exp ACTUAL-ver_act
that could not be operated on.
The module version in the module’s module
26 REQUEST DENIED – INTERNAL ERROR
information table (MIT) does not match that in
WITHIN $SCAN
$HCT. See message $HASP875, RC=08 for
An abend occurred within JES2 $SCAN more information.
processing, causing the request to end. See
35 MODULE ASSEMBLED WITH INVALID
previous $HASP088 or $HASP095 message.
MACRO LIBRARIES, EXPECTED-lib_exp
An attempt has been made to return the
ACTUAL-lib_act
storage obtained for the processing of the
request and JES2 has recovered from the The module was assembled with a different set
error. of macro libraries than the rest of the modules
in JES2. See message $HASP875, RC=09 for
27 REQUEST DENIED – INTERNAL ERROR
more information.
WITHIN $SCAN
36 MODULE IS NOT IN COMMON STORAGE
Insufficient information passed to the JES2
$SCAN routine has caused the request to end The module is not in common storage. See
abnormally. This error could also be due to a message $HASP875, RC=10 for more
$SCANTAB macro coding error. Determine if information.
it’s either an installation exit or an IBM
$SCANTAB error. If an internal JES2 error, 37 INSUFFICIENT STORAGE FOR LOAD
contact the IBM support center. $SCAN MODULE TABLE ENTRY
requires: The amount of storage needed to allocate the
v A valid call (see the macro $SCAN) load module table entry for the module was
v Specification of a display output area with a unavailable. See message $HASP875, RC=01
valid length for more information.
The module information table (MIT) for this The installation-defined WARNING operand on
module is incorrect. See message $HASP875, the $SCANTAB macro matched the value
RC=11 for more information. specified on the $SCAN WARNMSK operand.
39 INCOMPATIBLE OPERAND SETTINGS – 47 MODULE IS NOT REENTRANT
xxxxxxxx xxxxxxxx
Because the module is not reentrant, JES2
The values specified for the displayed could not load the module into CSA. See
operands are not compatible. See z/OS JES2 message $HASP875, RC=03 for more
Initialization and Tuning Reference or z/OS information.
JES2 Commands for incompatibilities.
48 NEW CSA/LPA LOADMODS INVALID ON
40 MULTI-LINE OUTPUT FROM MESSAGE HOT START
BUILDING ($BLDMSG) INVALID FOR WTOR
Because the common storage module was not
A request to create a message using loaded during a prior initialization of JES2,
$BLDMSG TYPE=WTOR has resulted in an JES2 denies its load on a hot start. See
attempt to send more than one line of output to message $HASP875, RC=04 for more
MCS. Because MCS does not accept multi-line information.
WTORs, the request is rejected. However, the
49 INSUFFICIENT STORAGE TO LOAD
first line of the multi-line WTOR is written to the
MODULE
console and all other lines are suppressed.
Shorten the message by modifying the The amount of storage needed to load the
$SCANTAB entries that define that message. module could not be allocated. See message
See the description of the $SCANTAB macro in $HASP875, RC=05 for more information.
z/OS JES2 Macros for information on how to
modify these entries. Determine if it’s either an 51 MODULE NOT FOUND – MODULE CANNOT
installation exit or an IBM $SCANTAB error. If BE VERIFIED
an installation exit, notify the system The $MODCHK macro made no verification
programmer. If an internal JES2 error, contact checks on the module because the address
the IBM support center. operand was not coded on the $MODCHK
41 SPIN NOT VALID IF TRACE LOG NOT macro and the entry point was not found in the
ACTIVE load module table ($LMT). See message
$HASP875, RC=12 for more information.
A request was made to spin the trace log data
set when trace logging was not active. 52 NO SELECTABLE ENTRIES FOUND
MATCHING SPECIFICATION
43 MAXIMUM TRACE STORAGE EXCEEDED
(NUMBER OF TABLES TIMES PAGES PER Either a keyword request was made to $SCAN
TABLE) but no entries matched the input, or JES2
determined that a requested operation is not
The total amount of storage requested for trace required or cannot be fulfilled. This error
tables (number of tables times pages per table) typically occurs when a numeric or symbolic
exceeds the maximum of 10 megabytes. subscript is used and no entries matching the
subscript are currently defined. For example,
44 IGNORED, IT IS AN OBSOLETE
this message is issued if a display request for
PARAMETER
NODE(POK*) was made and no control blocks
The specified keyword has been eliminated that define nodes contained POK as the first
from JES2. See z/OS JES2 Commands or three characters in the name.
z/OS JES2 Initialization and Tuning Reference
Either JES2 could not find a device or the
to find the replacement for this keyword.
device it found was not in the range, didn’t
45 IGNORED, VALUES ON HOT START ARE match the filter, or is in a state that could not
RESTORED TO PRIOR VALUES be operated on.
A request was made to alter a field that is 54 INVALID NODE NAME SPECIFIED
maintained in CSA. The request is ignored and
A character name representing a node is
the field is restored on hot start to the CSA
expected, but the name is not valid. If this
version.
message appears for a NODE(nnnn)
46 IGNORED, AS SPECIFIED BY LOCAL statement, then the following applies.
INSTALLATION $SCAN TABLES v The node name can only be an explicit
destination value (that is, a numerical value)
if both of the following are true:
– The value is not the same as another ACTFLAG, ACTSET, and ACTDISP operands
node number. on the $SCANTAB macro for the keyword, that
– The value is not the same as the DEST= the object is inactive.
value on the DESTID statement unless 60 MODULE USER VERSION IS INVALID,
the DEST= value is also the number of EXPECTED-uver_exp ACTUAL-uver_act
this node (Nnnnn).
The module version in the module’s module
If you ignore this error message and proceed information table (MIT) does not match that in
with initialization, JES2 will initialize but is $HCT. See message $HASP875, RC=15 for
unable to communicate with the duplicated more information.
node as specified by trace-of-keywords. 61 MODULE IBM USER VERSION IS INVALID
55 REQUEST INVALID DUE TO ACTIVE The module version in the module’s module
STATUS information table (MIT) contains an unexpected
The request to change or display value. See message $HASP875, RC=16 for
characteristics is not permitted at this time more information.
because JES2 determined using the 62 CONSOLE LOCATION INVALID OR
ACTFLAG, ACTSET, and ACTDISP operands UNAVAILABLE
on the $SCANTAB macro for the keyword, that
the object is active. The console identified on a $T or $ADD
REDIRECT command is either unavailable or
56 EXISTING ENTRIES FOUND MATCHING the identification is incorrect.
SPECIFICATION
63 NOT VALID FOR PATH MANAGER DEFINED
The request to create a new control block (for CONNECTIONS
example, $ADD) is ignored because a
matching control block already exists. A $T CONNECT or $DEL CONNECT
command was entered for a connection that is
57 DISPLAY TERMINATED DUE TO EXCESSIVE not defined as a static connection. Either a
OUTPUT (AS DEFINED BY CONDEF CONNECT initialization statement does not
DISPMAX) exist for the specified connection or a
The number of lines of output that $SCAN was $ADD CONNECT command was not entered
to display exceeded the maximum number for the specified connection. Enter a $ADD
permitted, as defined by the DISPMAX= CONNECT command to override the non-static
parameter on the CONDEF initialization connection with a static one before reentering
statement. $SCAN processing truncates the the original command.
display to the allowed limit. 64 REJECTED – NETWORK PATH MANAGER
If you want $SCAN to display the entire NOT AVAILABLE
number of output lines, increase the A command was entered that requires the path
DISPMAX= value and then reissue the request. manager services after JES2 suspended
network path manager functions. See message
Note: If the request was to change parameter $HASP502.
values, followed by display, the changes
were made successfully even though 65 UNSUPPORTED LOCAL DEVICE TYPE
the display was truncated. The device specified by the UNIT keyword
58 SELECTION OF GENERIC/MULTIPLE exists but JES2 does not support this as a
ENTRIES FOR ALTERATION IS INVALID local device. Use the MVS D U command to
display which devices are defined.
The keyword cannot be altered on a request
that specified a generic or generic range 66 UNIT SPECIFIED DOES NOT EXIST
subscript (for example DESTID(JES*) The device specified by the UNIT keyword
DEST=N3). This restriction is defined by the does not exist. Use the MVS D U command to
GENSET operand on the $SCANTAB macro display which units are defined.
for the keyword.
67 FSS SPECIFIED IS NOT DEFINED
59 REQUEST INVALID DUE TO INACTIVE
STATUS The FSS named in the FSS keyword of a
$ADD PRT(n) command does not exist. Use
The request to change or display the $D FSS command to display which FSSes
characteristics is not permitted at this time are defined.
because JES2 determined using the
68 VALUE MAY NOT BE SPECIFIED AT THIS A command ($ADD RMT, $T RMT, or $P RMT)
TIME was issued from either another RJE
workstation or from an JES2 NJE system that
JES2 either processed an initialization
does not have proper authorization to issue the
statement or a $T command, but could not set
command. The command fails.
an attribute specified for a device.
trace—of—keywords in the message text 73 ALL MEMBERS ARE NOT AT THE
indicates the attribute that could not be set. It REQUIRED PRODUCT/SERVICE LEVEL
may be possible to set the attribute later, but if
All active JES2 MAS members are not at the
you continue to receive this reason code with
correct service/product level to support the
the same keyword you will not be able to set
command. Active implies defined members that
the attribute. For example, if you attempt to
are not drained and not initializing.
assign a compaction table with the COMPACT
keyword on a device that does not support v If you applied a new product level:
compaction (CMPCT=NO), you will always See z/OS Migration for your new product
receive this reason code. level to determine actions that are required
for the command to function.
69 CANNOT USE STRUCTURE strname WHILE
RUNNING IN MODE=DUAL v If you applied a new service level:
See the documentation supplied with the
The current checkpoint mode is DUAL, but an
maintenance you just applied to determine
attempt was made to assign a NEWCKPTn to
actions that are required for the command to
a coupling facility structure by coding the
function.
STRNAME= keyword. Because the use of a
coupling facility structure is only supported The command fails, notify the system
while running in DUPLEX mode, the request is programmer.
denied. Issue the $T
CKPTDEF,MODE=DUPLEX command to 74 CURRENT CHECKPOINT DATA SETS ARE
change the checkpoint mode to DUAL and TOO SMALL
then retry the command assigning CKPTDEF A command was issued which required an
to a coupling facility. increase in the amount of space needed for the
70 ELEMENT VALUE MUST EXCEED checkpoint data set(s). The current checkpoint
PREVIOUS ELEMENT VALUE [BY AT LEAST is too small. Either there are not enough tracks
yyyyy ] in the data set or the size of an individual track
is too small. This message is accompanied by
A parameter range was specified which either $HASP295 (TRACK SIZE
requires the second range element to be INSUFFICIENT) or $HASP296 (dsname
greater than the first range element by at least SPACE INSUFFICIENT). If the $HASP296
1. The bracketed portion of the message message was issued, then issue a $D
appears only if the values must be different by CKPTSPACE command to determine the
more than 1. current set utilization. Then use the
reconfiguration dialog to increase the size of
71 LINE/SHARABLE SPECIFICATIONS ARE
and begin using the larger data set. If the
NOT VALID
$HASP295 message was issued, then either
A LINE= value on either the $T RMT(nnnn) use the reconfiguration dialog to move the data
command or the $ADD RMT(nnnn) command set to a volume that has a larger track size or
is not: decrease a CKPT size related parameter. See
v Defined on a LINE(nnnn) initialization the $HASP295 message for more information.
statement. In either case, the command fails.
v Available for RJE (remote job entry) 75 MEMBER mmmm NOT ALLOCATED TO
because it is dedicated to NJE (network job BOTH CKPT DATA SETS (MODE=DUPLEX,
entry) use. DUPLEX=OFF)
v Accessible because it is dedicated to A $T command was issued which requires
another remote that has specified adjusting the size of the checkpoint, and the
SHARABLE=NO on the RMT(nnnn) current member is not allocated to both
definition. checkpoint data sets. The command fails
v Accessible because it is being used by because of lack of checkpoint data set access.
another remote as a nondedicated line.
mmmm is the member that currently has
72 CANNOT BE {MODIFIED | TERMINATED} BY DUPLEX=OFF set.
ANOTHER RJE WORKSTATION
Note: There may be more than one member 85 JOB CANNOT BE CANCELLED; SPECIFY
that has DUPLEX=OFF. This is just the ’PROTECTED’
first member that was detected.
The operator entered one of the following
76 FILTER KEYWORD NOT ALLOWED AFTER against a protected job:
SET KEYWORD v A $C command with the PURGE or ALL
Before you specify any related set keyword(s), parameters
you must first specify the filter keyword(s). v A $O CANCEL command
Example: Non-valid: $t jobq,class=a,/class=b v A $P command
Valid: $t jobq,/class=a,class=b
77 AT LEAST ONE FILTER MUST BE JES2 purges any output for the specified job(s)
SPECIFIED that is not protected. If the output for the
specified job(s) is protected, JES2 ignores the
The command requires at least one filter. command and continues processing. Specify
Example: Non-valid: $pojq Valid: the PROTECTED parameter on the command
$pojq,jm=alice* if you must cancel the job or output.
78 MULTIPLE JOBS FOUND 86 SPOOL VOLUME CANNOT BE STARTED –
There is more than one job by the name NO TRACK GROUPS AVAILABLE. CHECK
specified in the system. Specify the job by MAX TGSPACE ON SPOOLDEF.
number (jobid) if you want to affect all jobs with There are no more track groups available to
a name. Specify the name within parenthesis start the spool volume. Increase TGSPACE to
rather than quotes. specify the number of track groups required.
79 INCORRECT RETURN CODE FROM 87 JQ - ROUTECDE - INCORRECT
PRESCAN OR POSTSCAN ROUTINE COMBINATION OF FILTERS SPECIFIED.
Pre–scan or post–scan routine returned a MUST SPECIFY BOTH ’>’ AND ’<’ FILTERS,
return code other than those allowed. OR NEITHER.
Determine if it’s either an installation exit or an An attempt was made to filter on ROUTECDE=
IBM $SCANTAB error. If an internal JES2 error, or DEST= using a > or < filter, but either:
contact the IBM support center.
v A > filter was specified without a < filter, or a
80 MISSING PRESCAN OR POSTSCAN < filter was specified without a > filter.
ROUTINE
The route code comparisons therefore result in
A pre–scan or post–scan routine specified on an open-ended range, which is not allowed. To
SCANTAB or an exit routine could not be avoid this message, an additional route code
found. Determine if it’s either an installation exit filter must be provided on the command.
or an IBM $SCANTAB error. If an internal JES2
88 INCORRECT RANGE OF ROUTE CODES
error, contact the IBM support center.
SPECIFIED
81 SOURCE OF COMMAND HAS IMPROPER
The command entered attempted to filter on a
AUTHORITY
range of route codes using > and < filters, but
The issuer of the command requires a higher the resulting range was inconsistent because:
level of authority. Example: Command required v The high and low bounds of the range
system authority and console specified from specified different node names, and the
has job authority. nodal route codes were not both specified
82 INVALID FILTER KEYWORD as ’node.*’, or
v The low bound of the range specified a
The keyword entered is not a valid filter.
special local route code (Unnnn or
83 INVALID DELIMITER equivalent) and the high bound of the range
did not, or
A filter was entered with an invalid delimiter.
For example, > (greater than) or < (less than) v The low bound of the range specified a
were entered when only <> (not equal to) or = userid route code, and the high bound
(equal to) are valid delimiters. See z/OS JES2 specified a remote route code (Rnnnn or
Commands . equivalent).
Job is busy on a device and cannot be The operator has attempted to cancel a job
modified at this time. which is not cancelable. The most common
reasons are the job is marked non-cancelable
by MVS or you tried to cancel an executing The operator issued a command against a job
STC (you must use the MVS CANCEL that has completed execution. The command
command to cancel a started task in contained an operand only valid for jobs that
execution). The message is issued and no have not yet executed.
MVS CANCEL is issued for that job.
100 REJECTED - AT LEAST ONE DATA SET IS
90 NOT DEFINED TO WLM REQUIRED IN PROCLIB(xxxxxxxx)
CONCATENATION
The operator has attempted to modify the
default SCHENV for a jobclass or has The operator issued a $T command to delete a
attempted to modify the SCHENV for a job and data set from the PROCLIB concatenation.
the SCHENV name is not defined to WLM. However, this was the only data set within the
PROCLIB(xxxxxxxx) concatenation, where
91 nnnnnn FAILURE
xxxxxxxx is the PROCLIB name for which the
The MVS service listed was called and message is issued. Because JES2 requires
returned an error. Details of the error are in there be at least one data set in the
previous messages. concatenation it does not delete the data set
and rejects the command.
92 NOT VALID FOR DEMAND SELECT JOBS
101 SUBSYSTEM INTERFACE NOT DORMANT,
The command was issued against a started COLD START NOT ALLOWED
task or time sharing user which is not allowed.
A start parameter of COLD or FORMAT was
93 NOT EXECUTING specified, but there is an active subsystem
Command could not complete because job is interface (SSI).
not actively executing. 102 CONFLICTING FILTERS SPECIFIED
94 JOB/OUTPUT QUEUE ERROR DETECTED, Mutually exclusive filters were specified.
RC=rc
103 INTERNAL ERROR – R11 = HCT NOT
rc identified the type of queue error detected. ALLOWED IN NON–JES2 ADDRESS SPACE
Reason codes from X'01' X'7F' are errors
encountered in the job queue. Reason codes A $SCANTAB specified a prescan, postscan, or
X'80' to X'FF' are errors encountered in the cleanup routine that requires the HCT (JES2 or
output queue. SUBTASK) environment, but the invoking table
was requested outside the JES2 address
95 INSUFFICIENT BERTS space.
Operator command failed because of a BERT 104 SOCKET MUST SPECIFY LOCAL NODE
shortage.
A NETSRV points to a SOCKET whose
96 NOT SPINNABLE NODE= value does not specify the local node.
$T J/S/T,SPIN valid only if JESLOG=SPIN or 105 DEVICE TYPE UNSUPPORTED BY
JESLOG=(SPIN,xxxx) ASSOCIATED REMOTE
97 LOGICAL PARMLIB {MEMBER NOT FOUND The remote device points to a line that is not of
| ALLOCATION FAILED} the correct type (for example, a SNA remote
An error was returned from the MVS points to a TCP/IP line) .
IEFPRMLB service while trying to access the | 106 CANNOT SET DYNAMIC IF NOT ACTIVE ON
default PARMLIB concatenation. | ALL MEMBERS
98 PROCESSING INCLUDE keyword error | The QAFF for the service class is not set to
An error was encountered processing the | ’ANY’.
keyword in the message. | 107 SERVICE CLASS NOT DEFINED OR WLM
In the message text keyword error is one of the | ERROR
following: | The service class name given in a $S/$P/$T
v MEMBER - NO BASE DATA SET | SRVCLASS(serviceclass) is not defined
v MEMBER - BASE DATA SET IS NOT PDS System action: The system does the following:
v DSN - MEMBER NOT SPECIFIED FOR v If JES2 encounters an incorrect initialization
PDS statement, JES2 ignores all parameters on that
99 REJECTED - JOB IS POST EXECUTION statement. If the initialization statement is defining a
device, JES2 will create that device using all device
default settings.
Descriptor Code: 2,7 Note 27 rc The return code from the CPF assembler
macro.
Note: If ERROR BUILDING MESSAGE HASPnnn is rsnc The reason code from the CPF assembler
displayed, this message ($HASP003) also has macro.
the routing and descriptor codes of message
$HASPnnn. System action: JES2 initialization processing ends.
Operator response: Notify the system programmer.
$HASP004 System programmer response: Do the following:
Explanation: 1. Look up the return code and reason code in z/OS
COMMAND PREFIX INVALID: text RC= rsnc MVS Programming: Authorized Assembler Services
Reference ALE-DYN under the CPF macro.
The command prefix specified by the CONCHAR 2. Correct the problem.
parameter of the CONDEF statement either at 3. Restart JES2.
initialization or through a $T command is not valid.
In the message text: Detecting Module: HASPSERV
rsnc The reason code. Routing Code: 2,10
text The explanatory text accompanying the reason Descriptor Code: 4
code.
rsnc text $HASP007
01 PREFIX ALREADY DEFINED Explanation:
APAR OW28617 WAS NOT ACTIVATED
The prefix specified already exists in the
sysplex, if the scope is SYSPLEX, or on this DUE TO CHECKPOINT DATA SET CONSTRAINTS
system, if the scope is SYSTEM.
02 PREFIX IS A SUBSET OF ANOTHER An attempt was made to increase the size of the
checkpoint data set to include the JQX CTENT header.
System action: If JES2 detects the error during
This attempt failed because there was not enough
initialization, JES2 issues message $HASP428 and then
space in the checkpoint data set to increase the size.
ends. If JES2 detects the error while processing a $T
command, the command fails and JES2 continues to System action: JES2 initialization continues.
System action: Processing continues. If the utilization rsncd The reason code from the ISGENQ service.
percentage decreases, JES2 deletes this message from rname The rname (minor name) of the resource that
the console 32 seconds after it is issued. If the is the target of ENQ. The major name is
utilization percentage still exceeds the threshold value, SYSZJES2.
JES2 reissues this message with the new utilization
percentage displayed. This process continues until the System action: The ENQ being requested is not
resource shortage is relieved (either by less use of the obtained and error processing begins. If the resource
resource or by an increase in the threshold). If JES2 represents the JES2 checkpoint data set, a
ends before the shortage is relieved, the message is reconfiguration dialog will appear.
deleted. Operator response: Respond as directed by
For the resources that are monitored on a MAS-wide subsequent messages to recover the resource that is
basis (JNUM, JQEs, JOEs and TGs), the message can the target of the ENQ.
be displayed to the console by any member. The System programmer response: See the explanation
operator will not see redundant messages issued to the of the return and reason codes for the ISGENQ macro
console by every member if the MVS MSCOPE=(*ALL) to determine the appropriate action.
command was specified, but messages from all
members are written to hardcopy. If MSCOPE=(*ALL) Detecting Module: HASPCKPT, HASPCKDS,
was not specified in the MVS CONSOLxx PARMLIB HASPIRDA
member, the operator might miss seeing this message. Routing Code: 2,4,10
For CMDS, the CMDNUM value on CONDEF can be Descriptor Code: 4
changed through the $TCONDEF command.
Operator response: Notify the system programmer. If $HASP064
resource-type is either JQEs (job queue elements) or
JOEs (job output elements), any operator in the MAS Explanation:
can relieve the shortage by doing one or more of the I/O ERROR ON device AT unit
following:
v Entering the $OQ command to release held output.
EXCP CC=cc1 IOS CC=cc2 CSW STATUS=stat 4B An error occurred during tape
CSW COUNT=count IOB SENSE=sens sens
repositioning that was requested by
the tape ERP.
DEVICE SENSE=ssssssss ssssssss ssssssss ssssssss
4C Invalid exposure number.
ssssssss ssssssss ssssssss ssssssss
4D CC=3. GDP or NIP in control, or with
SEEK ADDRESS =bbcchhr, MTTR=mmttttrr IOSGDPLP set, in logical paths
available (UCBLPM).
CURRENT CCW(S) address1 =opwwwwww,wwwwwwww
4E GDP — reserved device or in
NO CURRENT CCW
address2 =opwwwwww,wwwwwwww conjunction with IOSRELSE, device
cannot be released.
An input/output error has occurred on the indicated
4F Error recovery routines were entered
JES2 device.
following a direct access error but are
In the message text:
unable to read the home address or
device The VOLSER associated with the device. record 0.
unit Specifies a 4–digit hexadecimal device 51 Simulated error status. The
number. appendages and, if allowed to
execute, the ERP have determined
cc1 EXCP compatibility completion code associated that this is a permanent error. The I/O
with the error. request is terminated with the
cc2 IOS completion code from the IOBE control permanent error. The code indicates
block (if available). that the device is in a permanent error
state, boxed, or not connected. The
41 Permanent I/O error. code can indicate also that a missing
42 Extent error (DASD only). Either interrupt was detected and that the I/O
IOBSEEK lies outside the extents operation was terminated as a result
described by the DEB or the channel of recovery operations by the missing
program attempted execution outside interrupt handler.
the current extent. 52 The I/O request was found pending in
43 Duplexed I/O request was not started the sub–channel by IOS, and the
because of the UCB level or a not driver requested that the IOSB not be
ready device. requeued.
44 An error occurred after the previous 53 IOS canceled the I/O request because
I/O request to the device was posted of an I/O timeout condition.
complete. The appendages and (if 54 The I/O request could not be started.
allowed to execute) the ERP have The current address space did not
determined that is is a permanent match IOSASID and a captured UCB
error. The I/O request is terminated address was used in IOSUCB.
with the permanent error. The CSW
contents and sense data in the IOB 6D CC=3 on all paths with IOSCC3WE bit
do not apply to the attempted set. Return request to requester.
operation. They apply to the previous 71 For fetch driver — hardware corrected
operation attempted for any data set data check.
on the device. You can reissue the
EXCP macro instruction to restart the 74 Simulated error status. This code is
channel program. set as a result of attempting to start
an I/O operation to a device that is in
45 A program check or machine check a permanent error state, boxed, or is
occurred in IOS while processing the not connected. This code is also set if
I/O request. a missing interrupt was detected and
48 The channel program was purged. the I/O operation was terminated as a
result of recovery operation by the
49 Store or modify sub–channel request missing interrupt handler. The system
has been canceled. has set this code temporarily in
4A I/O prevention — either the I/O IOBECBCC and IEDB to invoke the
request has not been started or the ERP, if allowed to execute, and the
I/O request has been terminated. appendages to determine if the error
is permanent or correctable. If the
count CSW residual count — the number of bytes not MESSAGE, AUTO-REPLY IN sec SECONDS
transferred in the last CCW.
sens The first two sense bytes when a unit check JES2 has issued a WTOR for the $HASPxxx message
occurs. Occasionally, the system is unable to and is waiting for a reply. After 5 minutes, JES2 issues
obtain any sense bytes because of unit checks this message to inform the operator that no reply has
when sense commands are issued. In this been given. This message is repeated every 30
case, the system simulates sense bytes by seconds with an updated sec value. If the WTOR has
sense to X’10FE’.information. not been replied to when sec reaches 0, JES2 will take
a default action based on the WTOR that is pending.
ssssssss
In the message text:
Complete device specific sense information
(set after a unit check). See the appropriate $HASPxxx
device document for an explanation of the The message id associated with the WTOR
sense information. JES2 is waiting for.
bbcchhr sec The number of seconds remaining before JES2
Device address of the record being processed takes a default action.
(bb=Bin identifier, cc=Cylinder identifier,
System action: JES2 repeats this message every 30
hh=Head identifier, r=record).
seconds until the time in message goes to 0 or the
WTOR is replied to. If the times runs out before a reply
is received, then a default action will be taken and the Operator response: Contact the systems
WTOR will be deleted. The default action is described in programmer.
the system action of the WTOR.
System programmer response: Determine the
Operator response: Reply to the WTOR listed in the impact of the lost function to the installation. If the
message. See the WTOR explanation for details on how function is critical to normal operation, a
to reply. $PJES2,ABEND is required to end JES2 ($PJES2 won’t
work), then restart JES2. If not, JES2 will continue
System programmer response: None.
running without the listed function until the next restart
Detecting Module: HASPTERM of JES2.
Routing Code: 1,2,10 Detecting Module: HASPTERM
Descriptor Code: 2,7 Routing Code: 1,2,10
Descriptor Code: 7,11
$HASP068
Explanation: $HASP069
PARTIAL RECOVERY SUCCESSFUL – xxxxxxxx Explanation:
PCE ENDED JES2 CONTINUES WITHOUT desc JES2 SYSTEM DUMP SUPPRESSED BY
nnnn of mmmm yyyyyyyy PCES REMAIN
ON desc DUMP ANALYSIS ELIMINATION SLIP
number of JES2 catastrophic errors within the interval of System action: JES2 reissues message $HASP070.
hhhh hours. The default values for nn and hhhh are 2
Operator response: Enter a valid reply to message
and 24, respectively).
$HASP070.
The JES2 processor that was running has a recovery
routine for this error, but because the error rate has Detecting Module: HASPTERM
exceeded the value specified at initialization, JES2 does
not automatically run the processor recovery routine. Routing Code: 1,2,10
Instead, JES2 issues this message to require the Descriptor Code: 4
operator to choose the action JES2 should take.
System action: JES2 waits for the operator to reply. If $HASP072
the operator replies RECOVER, JES2 issues an
indicative dump (message $HASP088) to the hardcopy Explanation:
log and then attempts recovery. If the operator replies RECOVERY IN PROGRESS
SNAP, JES2 issues message $HASP088 at the
console, and then issues message $HASP070 again. If An error has occurred in a JES2 processor (for
the operator replies TERMINATE, JES2 stops example, in the JES2 command processor). The
processing and a system dump is written. If no processor recovery routine has received control and is
response is made after 10 minutes, then JES2 will take attempting to recover from the error and to avoid ending
the default action of RECOVER. $HASP065 is issued JES2.
every 30 seconds to tell the operator that an automatic
System action: While the JES2 processor recovery
response will occur for the WTOR.
routine is running, JES2 runs in a quiesced state. JES2
Operator response: Enter the appropriate reply: processors that are not essential to the recovery
attempt (those processors controlling readers and
RECOVER
printers, for example) do no processing.
to allow the JES2 processor recovery routine to
run and to allow the automatic system dump Operator response: None.
RECOVER,NODUMP Detecting Module: HASPTERM
to allow the JES2 processor recovery routine to
Routing Code: 1,2,10
run and to prevent the system dump
Descriptor Code: 7,11
TERMINATE
to stop JES2 and to allow the automatic
system dump $HASP073
TERMINATE,NODUMP Explanation:
to stop JES2 and prevent the system dump RECOVERY SUCCESSFUL –
SNAP to receive message $HASP088 at the console
NORMAL PROCESSING RESUMES
followed by a repeat of message $HASP070.
To prevent a system dump, reply NODUMP to
the second $HASP070 message. A JES2 processor recovery routine successfully
recovered from a JES2 error.
SNAP,NODUMP
to receive message $HASP088 at the console System action: JES2 processing continues.
followed by a repeat of message $HASP070. Operator response: Check the $HASP messages to
To prevent a system dump, reply NODUMP to see if the processor recovery routine caused any units
the second $HASP070 message. (Replying of work to be canceled or suspended. Take corrective
NODUMP on the SNAP option is meaningless action, if necessary.
and equivalent to replying SNAP.)
Detecting Module: HASPTERM
Detecting Module: HASPTERM
Routing Code: 1,2,10
Routing Code: 1,2,10
Descriptor Code: 4
Descriptor Code: 4
$HASP074
$HASP071
Explanation:
Explanation: RECOVERY UNSUCCESSFUL
INVALID REPLY TO $HASP070
An error occurred in a JES2 processor (for example, in
The operator entered an incorrect reply to message the command processor). The processor recovery
$HASP070.
routine received control but was unable to recover from Descriptor Code: 4
the error.
System action: JES2 issues message $HASP098 to $HASP077
request ending options.
Explanation:
Operator response: Reply to message $HASP098.
JOB jobname
Detecting Module: HASPTERM
SUBTASK FAILED-ACCESS REQUEST DENIED DURING
Routing Code: 1,2,10
Descriptor Code: 4 NJE SESSKEY EXTRACT
JES2 function
$HASP075 USER function
REQUEST NUMBER nnn
Explanation:
Alternate nnnnnnnn A failure occurred in the JES2 general purpose subtask
during access verification performed for a command,
CELL POOL CREATED. VIRTUAL STORAGE LOSS. remote signon, or the specified job. The access request
was denied for installation-specified function nnn or
JES2 detected an error in cell pool nnnnnnnn. JES2 during authorization checking for one of the following
has successfully rebuilt the cell pool, but was unable to functions:
free the storage associated with the damaged cell pool. v $DESTCHK authorization call
In the message text:
v Audit for job in error
nnnnnnnn v Command authorization
The number of the damaged cell pool.
v Data set delete
System action: Processing continues. v DCT SECLABEL extract
Operator response: Contact the system programmer. v Device authorization
System programmer response: When possible, v Environment extract
schedule a JES2 restart to reclaim the lost storage. v JESNEWS update processing
Detecting Module: HASCPOOL v JESNEWS token build
v Job XMIT/OFFLOAD
Routing Code: 1,2,10
v NEWS SYSOUT data set create
Descriptor Code: 4
v NJE SYSOUT data set authorization
v Notify user token extract
$HASP076
v Printer data set select
Explanation: v PSO data set open
NO ALTERNATE type
v PSO data set select
CELL POOL CREATED FOR DAMAGED CELL POOL. v RJE SIGNON/LOGON
v OUTPUT descriptor modify
LOSS OF VIRTUAL STORAGE.
v Reverify token extract
JES2 detected an error in a cell pool, but was unable to v SECLABEL affinity extract
rebuild the damaged cell pool. All storage associated v Security environment initialization
with the cell pool is lost.
v Security environment create
In the message text:
v Security environment delete
type The type of cell pool affected.
v SJF services token extract
System action: Processing continues v SPOOL browse data set open
Operator response: Contact the system programmer. v Subtask ACEE create
System programmer response: Examine the original v SYSIN data set create
cell pool to find out why it cannot be rebuilt. When the v SYSIN data set open
problem is resolved, issue a warm start. v SYSOUT application programming interface (API)
Detecting Module: HASCPOOL v SYSOUT data set create
Routing Code: 1,2,10 v SYSOUT data set open
Note: A jobid may appear before $HASP077 if your Detecting Module: HASPRAS
installation includes the jobid in the console Routing Code: 1,2,10
message format and if this message is issued on
behalf of a job (not a command or remote Descriptor Code: 4
signon).
System action: JES2 sets a return code indicating $HASP079
that an access request was denied. If the authorization Explanation:
check was for user or job verification, JES2 flushes the xxxxxxxx SUBTASK REINSTATED
job. Processing for all other cases, and for user
functions, depends upon the requester.
Recovery processing is complete for the indicated
JES2 also issues the $HASP078 message, which subtask. The subtask identifier xxxxxxxx displayed in
identifies the subtask that ABENDed. the text is the same name as the subscript of the
RECVOPTS initialization statement.
Operator response: Notify the system programmer of
In the message text:
this message.
xxxxxxxx
System programmer response: Determine why the
The reinstated subtask.
failure occurred by examining the abend and reason
codes issued with the corresponding $HASP078 System action: Normal processing continues.
message.
Operator response: None.
Detecting Module: HASPNUC
Detecting Module: HASPRAS
Routing Code: 2,9,10
Routing Code: 1,2,10
Descriptor Code: 3,6
Descriptor Code: 4
$HASP078
$HASP080
Explanation:
Explanation:
xxxxxxxx SUBTASK FAILED – ABEND
JES2 SYSTEM DUMP REQUESTED
cde RC= rsnc
FROM mod (adr) + X’oooooo’
addr The address of the module Operator response: Notify the system programmer.
X’oooooo’ System programmer response: Determine the
The offset into the module reason(s) why the SDUMP failed using the IEA
messages issued and correct the problem.
Messages issued before the $HASP080 message
Detecting Module: HASPRAS
define the reason for the dump request.
Routing Code: 1,2,10
System action: JES2 requests a dump of the
appropriate storage areas, address spaces, and Descriptor Code: 4
diagnostic information.
Operator response: Notify the system programmer, $HASP082
and note the descriptions of messages issued before
Explanation:
message $HASP080.
INSTALLATION EXIT 26 ABEND cde
Save the hard-copy log. For systems with remote
consoles, save the remote console sheet. AT mod (adr) + X’oooooo’
System programmer response: Print the dump taken
(or use IPCS to view the dump), and note the Installation exit 26 abended. The message text includes
descriptions of the messages issued before $HASP080. diagnostic information:
If you used SMP/E to make all changes to the system, cde The abend completion code for the failing exit
run the LIST CDS and LIST PTFBY functions of SMP/E routine.
to obtain a list of the current maintenance from the mod The failing module name.
SMP/E control data set (CDS).
adr The module address.
If you changed the system without using SMP/E, run the
LISTIDR function of AMBLIST to obtain a list of all X’oooooo’
members with a PTF or local fix and save the output. The offset from the module address to the
Run the LISTIDR against the following data sets: failing instruction.
v SYS1.SVCLIB System action: The ESTAE issuing this message
v The library that contains the program that issued the requests an SDUMP. Control is returned to the JES2
message. main task where normal JES2 end processing
continues.
v SYS1.LPALIB.
Operator response: Notify the system programmer.
Run EREP to format the LOGREC data set and save
System programmer response: Print and analyze the
the resulting output.
SDUMP. See other messages and the system
Detecting Module: HASPRAS completion code described in z/OS MVS System Codes.
Routing Code: 1,2,10 Detecting Module: HASPTERM
Descriptor Code: 4 Routing Code: 1,2,10
Descriptor Code: 11
$HASP081
Explanation: $HASP083
JES2 SYSTEM DUMP UNSUCCESSFUL
Explanation:
R13 NOT A VALID PCE ADDRESS
The SDUMP requested by JES2 after issuing message
$HASP080 has failed. A probable cause is that the
The operator responded SNAP in reply to message
dump data set is full.
$HASP070 or $HASP098, requesting an indicative
dump. JES2, during indicative dump processing, found
Note: This message is also issued if the dump has
that register 13 contains zeros or an incorrect processor
been suppressed by either dump analysis
control element ($PCE) address.
elimination (DAE) or a SLIP command.
System action: Indicative dump processing continues,
System action: The JES2 module that requested the
but PCE information is not displayed in message
SDUMP did not specify operator intervention if an error
“$HASP088 PCE = pceid (adr)”. When indicative dump
occurred while issuing the SDUMP. Therefore, the
processing completes, message $HASP098 is issued.
module regains control. JES2 processing continues, and
the dump request is canceled. Operator response: None.
Detecting Module: HASPTERM messages $HASP264 and $HASP479 and correct the
problem.
Routing Code: 1,2,10
Detecting Module: HASPTERM
Descriptor Code: 4
Routing Code: 1,2,10
$HASP084 Descriptor Code: 1
Explanation:
INVALID SAVE AREA CHAIN $HASP087
Explanation:
The operator responded SNAP in reply to message JES2 FAILED
$HASP070 or $HASP098, requesting an indicative
dump. JES2, during indicative dump processing, found DURING TERMINATION PROCESSING,
that the chain of processor control element ($PCE) save
areas in fields PSVNEXT and PSVPREV is in error. ABEND CODE cde
System action: Indicative dump processing continues,
but message “$HASP088 – CALLED BY mod2” is not HASPTERM abended while JES2 was stopping.
included in the output. When the indicative dump In the message text:
completes, message $HASP098 is issued.
cde The system or installation completion code.
Operator response: None.
System action: An SDUMP is requested by the
Detecting Module: HASPTERM ESTAE issuing this message. JES2 stops processing.
Routing Code: 1,2,10 Operator response: Notify the system programmer.
Descriptor Code: 4 System programmer response: See other error
messages and the description of the completion code.
Print and analyze the SDUMP. For descriptions of the
$HASP085
system completion codes, see z/OS MVS System
Explanation: Codes.
JES2 TERMINATION COMPLETE
Detecting Module: HASPTERM
JES2 has ended because the operator entered the $P Routing Code: 1,2,10
JES2 command or the operator replied EXIT or PURGE Descriptor Code: 4
to message $HASP098. If PURGE was entered, JES2
attempts to end any attached tasks.
$HASP088
System action: JES2 ends.
Explanation:
Operator response: None.
Only 32 bit registers are being used
Detecting Module: HASPTERM ------- JES2 [SUBTASK ] ABEND ANALYSIS --------
FMID = xxxxxxx LOAD MODULE = lmodname
Routing Code: 1,2,10 SUBSYS = ssss vvvvvvvv uuuuuuuu
DATE = yyyy.ddd TIME = hh.mm.ss
Descriptor Code: 4 [DESC = text]
MODULE MODULE OFFSET SERVICE ROUTINE EXIT
NAME BASE + OF CALL LEVEL CALLED ##
----------------------------------------------------------
$HASP086 modname strtadr + offset ptfnum rtn-or-abend exit
[GENERAL PURPOSE SUBTASK CALLER]
Explanation: [callname1 strtadr + offset ptfnum rtnname]
WARNING – FAILING INSTR WAS instr
PSW = psw ILC = n IC = mm
| BEA = Modname Address + offset
JES2 CHECKPOINT LOCK NOT RELEASED TEA = tea_addr
SID = asid (HOME) asid (PRIM) asid (SCND)
{PCE = pceid (adr) [jobid] [jobname]|
JES2 has abnormally ended without releasing the DTE = tasktype (adr)}
DASD resident checkpoint data set lock. R0 = r0 r1 r2 r3
R4 = r4 r5 r6 r7
System action: When any other system in the R8 = r8 r9 r10 r11
multi-access spool configuration cannot obtain the R12 = r12 r13 r14 r15
-----------------------------------------------------------
checkpoint data set lock, it issues message $HASP264
or $HASP479. The full 64 bit registers are being used
------- JES2 [SUBTASK ] ABEND ANALYSIS --------
Operator response: See the descriptions of FMID = xxxxxxx LOAD MODULE = lmodname
SUBSYS = ssss vvvvvvvv uuuuuuuu
In the message text: instr The actual failing instruction. It is not given if
the home ASID is not the same as the primary
xxxxxxx ASID.
SMP Function Modification ID for the current
JES2 product. psw PSW at the time of the error.
Descriptor Code: 4
$HASP092
Explanation:
$HASP094
API ERROR ON LOGONxxx
Explanation:
ACB, rrrr, SSCP, ssss I/O ERROR ON SPOOL, MTTR= nnnnnnnn
The interface between the SSCP and JES2 has failed. An incorrect extent was supplied when requesting I/O
In the message text: from a spool device. Either the “m” from the MTTR was
greater than X'FD', or the spool volume designated by
xxx The identifier of the device for which the logon
the “m” value was not available for use.
was attempted.
rrrr The SSCP service that was requested. Note: Several versions of this message follow. Use the
form that corresponds to the $HASP094
ssss The first two characters of ssss indicate the
message on your console.
return code in register 15 after the ACB
request; the last two characters indicate the
setting of the ACBERFLG field. In the message text:
A6 READ (IOBCCW4) for diagnostic purposes using the LOG=Y option on the
$T LINE(nnnn) command.
A8 SYN (IOBCCW5)
In the message text:
A8 WRITE RESP (IOBCCW7)
lna The line number.
AA SYN (IOBCCW2)
dev Specifies a 4-digit hexadecimal device number.
AA WRITE RESP (IOBCCW3)
rr The count received.
v CTCA sequences (x=C or x=9):
ee The count expected.
x2 SENSE (IOBCCW1)
System action: Any job being read in is deleted and
x4 READ (IOBCCW4) must be resubmitted.
x7 CONTROL (IOBCCW3) Operator response: This represents a very serious
x8 WRITE (IOBCCW2) error. Control records may have been lost, which could
cause partial loss of terminal function. The line should
xA WRITE ENQ (IOBCCW2) be drained ($P) and restarted ($S) as soon as practical.
ee Expected response, if xy contains B4 or 94. Detecting Module: HASPRAS
See the sens field for a description of the
possible values. Routing Code: 8,10
dev ,02,0C00,003D, 94 **
$HASP094
A5
A6 Explanation:
B4 I/O ERROR ON LINElna dev
01 02 **
I/O ERROR ON LINElna 94 B4
dev ,02,0C00,0070, A5 61
A6 An incorrect ending character was received from a
multileaving terminal. This message can also occur as
an informational message when a JES2 trace is
JES2 has received an incorrect acknowledgment from a requested for diagnostic purposes using the LOG=Y
2770, 2780, or 3780 terminal. This may indicate that an option on the $T LINE(nnnn) command.
output device (printer or punch) at the remote terminal In the message text:
has become “not ready”. It may also indicate that an
output block has been lost. This message can occur as lna The line number.
an informational message when a JES2 trace is
dev Specifies a 4-digit hexadecimal device number.
requested for diagnostic purposes using the LOG=Y
option on the $T LINE(nnnn) command. ii The end character received.
In the message text:
System action: Normal error recovery procedures are
lna The line number. invoked.
dev Specifies a 4-digit hexadecimal device number. Operator response: None.
System action: The last block is retransmitted. Detecting Module: HASPRAS
Operator response: The remote terminal operator Routing Code: 8,10
should check (to any extent possible) for missing or
Descriptor Code: 4
duplicate output and should request a backspace or
restart if the output looks questionable.
Detecting Module: HASPRAS
Routing Code: 8,10
Descriptor Code: 4
$HASP094 $HASP094
Explanation: Explanation:
I/O ERROR ON LINElna dev I/O ERROR ON LINElna
The card reader on a 2770, 2780, or 3780 has become A unit check on the communications adapter has been
not ready. This may be caused by a card feed error or detected by JES2. For more detailed information
by the failure of the remote operator to activate the concerning the exact nature of the error, consult 2701
end-of-file switch or button. This message can also Data Adapter Unit Component Description or 2703
occur as an informational message when a JES2 trace Transmission Control Component Description.
is requested for diagnostic purposes using the LOG=Y In the message text:
option on the $T LINE(nnnn) command.
lna Line number.
In the message text:
dev Specifies a 4-digit hexadecimal device number.
lna The line number.
cde Code.
dev Specifies a 4-digit hexadecimal device number.
sens Sense information.
System action: The system waits for the reader to be
made ready and transmission to continue. ii Additional sense information.
Operator response: The remote terminal operator System action: Processing continues.
should correct the problem and ready the card reader
(ensuring that the end-of-file switch or button is Operator response: None.
activated). Detecting Module: HASPRAS
Detecting Module: HASPRAS Routing Code: 8,10
Routing Code: 8,10 Descriptor Code: 4
Descriptor Code: 4
$HASP094
$HASP094 Explanation:
Explanation: I/O ERROR ON LINElna
I/O ERROR ON LINElna
dev ,02,FF00, rr **, 94 ee, 4200
dev ,02,0D00,0037, 94 ** B4
B4
C4 A block sequence error has been detected by a
A6 multileaving terminal, indicating that one or more
transmission blocks have been lost. This message can
JES2 has received an unexpected end-of-transmission also occur as an informational message when a JES2
(EOT). This message can also occur as an trace is requested for diagnostic purposes using the
informational message when a JES2 trace is requested LOG=Y option on the $T LINE(nnnn) command.
for diagnostic purposes using the LOG=Y option on the In the message text:
$T LINE(nnnn) command. lna The line number.
In the message text:
dev Specifies a 4-digit hexadecimal device number.
lna The line number.
rr The count that was received at the remote
dev Specifies a 4-digit hexadecimal device number. terminal.
System action: Normal error recovery procedures are ee The count that was expected.
invoked.
System action: Output on the remote’s printers and
Operator response: None. punches is stopped; jobs on readers are deleted.
Detecting Module: HASPRAS Operator response: This represents a very serious
Routing Code: 8,10 error. Control records may have been lost, which could
cause partial loss of terminal function. The line should
Descriptor Code: 4 be drained ($P) and restarted ($S) as soon as practical.
Detecting Module: HASPRAS
Routing Code: 8,10 condition that caused the codes, the message may
be repeated for subsequent autologon attempts.
Descriptor Code: 4
3. This message can occasionally occur if a remote
SNA device cannot respond quickly enough after a
$HASP094 BIND during remote sign on processing. System
Explanation: sense data in RPLFDBK2 indicates that an incorrect
I/O ERROR ON LINElna FM header is sent. The remote session is logged off
shortly thereafter. Increase the WAITIME parameter
on the SNA RMT statement to allow the remote
dev,cde,sens,ii **,****
adequate time for setup and give the remote time to
be the first speaker for the SNA session.
An unusual channel end condition on the
communications adapter has been detected by JES2.
In the message text:
This message can also occur as an informational
message about LINE(nnnn) or LOGON(n), when a JES2 devname
trace is requested for diagnostic purposes using the The device or line on which the error occurred.
LOG=Y option on the $T LINE(nnnn) or $T LOGON(n)
SNA The type of device.
command. For more detailed information concerning the
exact nature of the error, consult the appropriate xx The VTAM request type (RPLREQ), as follows:
hardware component description documents.
In the message text: X'15' SETLOGON
member you are attempting to start. This $D06 The event control block (ECB) that ends the
discrepancy can cause various errors to occur, subtask was not posted before a $DTEDYND
including the display of this message. macro was issued to detach the subtask. All
subtasks must return to MVS before
Examples of conditions that can cause these $DTEDYND issues the MVS DETACH macro
errors to occur: for that subtask.
1. You have a $ACTIVATed (Release 4 or $D07 The DTE table for the specified subtask
higher) JES2 member already running in identifier requested information from the user
the MAS, and you attempt add a control table (UCT), however no UCT address
pre-Release 4 member. was found in the HCT pointer field $UCT.
2. You have attempted to change a cold start
$D08 The $DTEDYN ATTACH service has found an
initialization parameter during a warm start
entry point address to be zero.
(for example, JOBNUM= on the JOBDEF
initialization statement). See the JES2 $D09 The $DTEDYN ATTACH service has found a
Initialization and Tuning Reference for a HEAD=field address that is not valid.
description of initialization parameters that
$D10 The $DTEDYN service cannot find a required
require a cold start.
name/token pair.
System Programmer Response: Correct the $D11 The $DTEDYN DETACH service has found a
initialization parameters so that they are HEAD=field address that is not valid.
compatible with the with the cold start
$D12 The $DTEDYN DETACH service cannot find a
initialization parameters currently in effect.
required name/token pair.
See the JES2 Migration Notebook applicable $DB1 INCORRECT TYPE PASSED TO $DILBERT
for the highest JES2 release running in the
Call to $DILBERT services was made which
MAS for more details on checkpoint
passed an invalid TYPE=parameter.
compatibility.
$DB2 INCORRECT TYPE PASSED TO $DILBERT
$CF1 JES2 ERROR DURING COUPLING FACILITY
ACCESS The processing routine specified on the
$DILBERT Macro returned a return code that is
During normal checkpoint processing, JES2
not supported. The reason code associated
encountered an unexpected return code from
with $DB2 is the bad return code.
an IXLLIST request.
$DB3 $DILBERT INLINE PARMLIST MISMATCH
$CF2 An I/O error occurred on a checkpoint data set
that resides on a coupling facility structure and The in–line parameter list passed to the
’TERM’ was specified in a checkpoint $DILBERT service is incompatible with the
reconfiguration. routine. The most likely cause is a failure to
reassemble a module containing a $DILBERT
$D01 The $GETABLE service routine was unable to
macro call.
locate the DTE table for the subtask identifier
specified in the $DTEDYN ATTACH macro call. $DD1 The $GETABLE service routine was unable to
locate a DCT table related to the DCT name
$D02 The DTE table for the specified subtask
specified in the $DCTDYN macro call.
identifier requests information from the user
control table (UCT), however no UCT address $DD2 Indicates that a WSTAB address was found on
was found in the HCT pointer field $UCT. a $DCTTAB that was not eligible for job or
SYSOUT selection.
$D03 RC=(MVS IDENTIFY return code). The MVS
IDENTIFY for the subtask requested on this $DD3 A required name/token pair could not be
$DTEDYN ATTACH macro failed. located by the $DCTDYN service.
$D04 The $GETABLE service routine was unable to $DD4 $DCTDYN was unable to build device name.
locate the DTE table for the subtask identifier
specified in the $DTEDYN DETACH macro $DJ1 EXIT CODE RETURNING NON-EXIT MODE
call. JQA
$D05 The DTE passed by the caller of $DTEDYN The $DOGJQE service has been called by a
DETACH failed validity checking. Either the JES2 exit to perform a $DOGJQE
EBCDIC eye catcher was not ‘DTE’ or the ACTION=RETURN. The JQA being returned
subtask name in the DTE did not match the was obtained by IBM code, not by exit code.
name in the DTE table. $DJ2 EXIT CODE DID NOT RETURN EXIT MODE
JQA
The $DOGJQE service has been called by a $F01 Free Cell services error.
JES2 exit to perform a $DOGJQE
$F02 Get Cell extension error.
ACTION=RETURN. The JQA being returned
was obtained by exit code and not $F03 Quick Cell initialization error.
subsequently freed before returning to JES2.
$F04 FSS request error on GETDS.
$DP1 $XECB is not valid or is being $WAITed on by
two PCEs. $F05 FSS request error on RELDS.
$DP2 Data was on a linkage stack when a $WAIT $F08 A functional subsystem interface (FSI) POST
macro was issued. request failed.
$DP3 $WAIT WAS ISSUED FROM INITIALIZATION $F09 No FSS was found for a printer defined as
PCE being in FSS mode. Either a $S command was
issued for the printer or the error occurred
A $WAIT has been issued during JES2 during initialization processing.
initialization, before the initialization of the
JES2 PCE dispatcher. $G01 JES2 issued the GETMAIN macro instruction
for storage for a TGB (track group buffer), but
$DP4 $WAIT WAS ISSUED FROM JES2 SUBTASK the required storage is not available in subpool
0.
A $WAIT has been issued from a JES2
subtask. $GF1 ATTEMPT TO FREE SUBPOOL 0
$DP5 The JES2 dispatcher has found a PCE An attempt was made to $FREMAIN subpool
eyecatcher that is not valid. 0. This is not allowed in the JES2 main task.
This is probably an incorrect call to the
$E01 The total number of channel end indications
$FREMAIN service.
from IOS has exceeded the total number of
input/output operations initiated by JES2. For $GF2 UNEXPECTED LENGTH OF 0
example, the total number of outstanding
input/output operations became negative. A $FREMAIN request was issued with a length
value passed as zero. If allowed to continue,
$EP1 The routine specified on a $PCTAB resolved to this would result in a subpool FREEMAIN. If a
an address of zero. subpool FREEMAIN is required, then do not
code LV= on the $FREMAIN call. Otherwise,
$EP2 The routine specified on a $PCTAB for a
correct the length specification for the
common PC cannot be found in the common
$FREMAIN call.
storage.
$GS1 A subtask work queue error was detected.
$EN1 JES2 or an installation exit routine either called
a JES2 service routine or used a macro that $GT1 $GETABLE - INVALID TABLE ENTRY
called a service routine that issued the $EN1
error code. This error code indicates that the The $GETABLE service has located a table
service does not support running under the pair in which the JES2 table pointer points to a
processor type (PCEID) of the caller. USER table, or the USER table pointer points
to a HASP table, or a dynamic table pointer
$ER1 A JES2 processor is attempting to cancel or does not point to a dynamic table. The
replace its current JES2 recovery environment, probable cause is either a mismatch of levels
but there is no recovery environment of the $MCT macro, or a failure to use the
associated with the current save area level. $PAIR macro to define a table pair.
That is, the processor has not established a
recovery environment since it obtained control, $GW1 Either a JES2 processor requested a work
and therefore cannot cancel one. area larger than the maximum size allowed, or
a processor’s total work area requests are
$ER2 JES2 detected a non-valid track address in larger than the total allowed.
module HASPRAS during an I/O operation.
$GW2 One of the following occurred:
$ER5 When a JES2 processor recovery routine
returned control, critical register contents or RC=04 A JES2 processor has attempted to
control block contents (or both) had been return a work area with an incorrect
destroyed. pool identifier.
$ER9 There is a logic error in the JES2 processing RC=08 A JES2 processor has attempted to
associated with (but not included in) a JES2 return a larger work area than it
processor recovery routine. acquired.
$F00 Get Cell services error. RC=12 A JES2 processor has attempted to
return a work area which has already The ENF 40 signal was not issued during JES2
been marked as free. initialization. Recover from this abend and
allow JES2 to complete initialization.
RC=16 $RETWORK has discovered that the
cell control prefix for the cell being Operator Action: Hot start JES2 if OMVS is
returned has been overlaid. needed.
$GW3 A JES2 processor used part of a work area $IP1 Input services incurred a GETMAIN failure.
that it did not own. (For $DEBUG=YES only.)
$IP2 JES2 detected an error in the parameter list
$GW4 A $GETWORK request was issued passed to the Security Authorization Facility to
unconditionally (without ERRET= on the validate the job.
macro), and the GETMAIN, required to satisfy
$IP3 JES2 read a job card from an input device.
the request, failed.
JES2 passed control to installation exit 2. After
$I04 The $GETABLE service routine was unable to exit 2 returned, JES2 detected that the card
locate a DCT table related to the DCT type was changed. JES2 scanned the card and
specified in the INITRTE subroutine in could not recognize it as a job card. Exit 2 has
HASPIRMA. probably overlaid the card.
$I05 An internal logic error has occurred in one of $IR1 JES2 detected an error in the internal reader
the HASPIRDA routines. The reason code protected buffer. The pointer to the current job
indicates the routine and type of error. within the buffer does not point to a valid
location. JES2 deletes the current job on the
RC=04 The main routine, IRDA, received a
internal reader.
return code from KTRK1IO indicating
IRDA passed bad parameters to $IR2 JES2 detected a serialization error for an
KTRK1IO. This occurred while internal reader. JES2 deletes the current job on
attempting to lock the checkpoint data the internal reader.
set.
$IV8 QUEUE VERIFY ERROR FOLLOWING
RC=08 The main routine, IRDA, received a $IVATE
return code from KTRK1IO indicating
Reverification of job queue after $ACTIVATE
IRDA passed incorrect parameters to
failed.
KTRK1IO. This occurred while
attempting to read the master record $IV82 JQT KIT NOT FOUND FOLLOWING $IVATE
from the checkpoint data set.
$ACTIVATE LEVEL=R4 processing failed to
RC=12 The main routine, IRDA, received a find the JQT CTENT.
return code from TRK1IO indicating
IRDA passed incorrect parameters to $J05 JES2 detected an error with either the chaining
KTRK1IO. This occurred while or the type of JQE or JOE by one of the job
attempting to read the entire first track output service routines:
from the checkpoint data set. RC=04 The work JOE does not point to a
RC=16 The main routine, IRDA, received a characteristics JOE.
return code from TRK1IO indicating RC=08 JES2 cannot find the work JOE that
IRDA passed incorrect parameters to was requested to be removed from a
KTRK1IO. This occurred while characteristics JOE chain
attempting to write the lock at the end (JOECHNXT).
of IRDA processing.
RC=12 Either the subject JQE has no work
RC=20 IRDA processing had a failure in JOEs or JES2 cannot find the work
PARM=UNACTIVATE processing. JOE requested to be removed from a
Unexpected return code from JQE.
CKPTVSIZ.
RC=16 The use count of the characteristics
RC=24 IRDA processing cannot find the local JOE is zero, but it still points to a
KITs for either the NITC or RECY work JOE.
CTENTs.
RC=20 The work JOE points to an alleged
$I06 ENF TYPE 40 SIGNAL ERROR characteristics JOE that is not a
REASON=(return code from the ENFREQ characteristics JOE.
macro)
RC=24 The JQE pointed to by the JOE is a
free JQE.
$J06 $#POST was entered when not under control $K01 Alteration of checkpoint record contents when
of $QSUSE macro. not under control of $QSUSE macro. (For
DEBUG=YES only.)
$J07 The $#ADD routine detected that a $JOE that
was to be added to a $JOT had an erroneous $K02 The coupling facility lock was stolen
SYSOUT class. Valid SYSOUT classes are unexpectedly by another member of the MAS.
(A-Z, 0-9).
$K03 One of the following is true:
$J08 JES2 detected an error in the output queues 1. Two members are using the same member
and the detecting routine was not able to name.
correct the error.
2. There is a time stamp synchronization
RC=04 The verification/correction routine(s) problem in a multi-access spool
detected an error. JES2 issues the configuration. This is typically caused by an
$HASP498 message, which asks the incorrect operator reply to message
operator if the JOT queues should be $HASP420 or some other operator error.
totally rebuilt.
This error ($K03) requires that you re-IPL the
RC=08 The rebuild routine detected an error.
system.
JES2 issues the $HASP499 message,
indicating both the correction and $K04 An attempt was made to recover from a
rebuild routines have failed. permanent I/O error on a checkpoint data set.
Although the recovery was successful, an error
$J09 JOE ON INCORRECT QUEUE
occurred on the “companion” checkpoint data
A JOE does not have the correct JOETYPE. set during a checkpoint reconfiguration.
Possible causes are: (CKPT2 is the companion for CKPT1 and vice
v Something other than a work JOE is passed versa.) In an attempt to recover from the I/O
to one of the job output service routines. error on the companion data set, JES2 initiated
a subsequent checkpoint reconfiguration, and
v A free JOE queue points to a JOE that isn’t
the operator replied TERM to $HASP272.
marked ‘free’.
$K05 A checkpoint record has been changed, but not
RC=0 A work JOE is expected and the JOE
flagged for checkpoint. (For DEBUG=YES
is not a work JOE
only.)
RC=4 JES2 just removed a JOE that is not a
$K06 The operator issued the $T
free JOE from the free JOE chain.
CKPTDEF,RECONFIG=Yes command (the
$J10 INCORRECT JOE ADDRESS blank between $T and CKPTDEF is optional)
to enter a checkpoint reconfiguration dialog
The JOE address passed to one of the job with JES2. This dialog is not possible because
output service routines was not a valid JOE there are no checkpoint data sets presently in
address. use.
RC=04 The JOE address is not within the $K08 An abend has occurred during a checkpoint
valid range of JOE addresses. reconfiguration. This error requires that you
RC=08 The JOE address is not on a control re-IPL the system.
block boundary. $K10 A permanent read error has occurred on a
$J11 ATTEMPT TO BUSY A JOE DURING WARM checkpoint data set. The reason code (RC=)
START indicates the reason for the error.
During warm-start processing, JES2 attempted RC=04 An I/O error occurred while attempting
to set on the busy system indicator for a JOE. to acquire a RESERVE (using the
Changing the system busy indicator for a JOE MVS RESERVE macro) for the
cannot occur during a warm-start because it checkpoint data set.
would conflict with the recovery processing of RC=08 The check value in the HASP
busy JOEs. communications table (HCT) does not
$J12 QUEUES NOT OWNED ENTERING $#JWEL agree with the check value in the
CHECK record.
The caller of $#JWEL failed to ensure the
checkpoint queues were owned, that is, it failed RC=12 An I/O error occurred while reading
to do a $QSUSE) prior invoking the $#JWEL the 4K pages of the checkpoint data
macro. set.
RC=16 An I/O error occurred while reading RC=12 The routine KTRK1IO, called from
the first track of the checkpoint data KREAD1, detected that I/O was
set. already active for a checkpoint data
set before attempting a lock read
RC=20 An I/O error occurred while attempting
operation.
to acquire the checkpoint lock.
$K23 JES2 detected that either one or both of the
$K13 The checkpoint lock, which has been read,
active checkpoint data sets being used by this
contains erroneous information.
member of the multi-access spool (MAS)
$K15 An attempt to format the checkpoint data set configuration was forwarded (possibly because
was unsuccessful. If this error occurs after of error recovery on another member).
initialization, you must re-IPL the system. Because this member detected the forwarded
data set(s) during normal processing, it could
$K17 A checkpoint read channel program was not perform the necessary recovery action.
interrupted. Retries were also interrupted. When you restart JES2, initialization
$K18 A checkpoint write channel program was processing will detect a change in the
interrupted. checkpoint data set configuration.
This I/O error occurred on the only checkpoint $K24 Internal error: JES2 has detected that the
data set allocated by this member. There will checkpoint data set configuration has been
be a backup copy of the checkpoint data set altered by another member of the multi-access
only if one of the following is true: spool (MAS) configuration (possibly because of
error recovery action on another member).
v The JES2 configuration is running in
Because this member detected the change
DUPLEX mode and another member has
during normal processing, it could not perform
specified DUPLEX=ON. The DUPLEX data
the necessary recovery action. When you
set can then be used as the backup copy.
restart JES2, initialization processing will detect
v Before ABENDing, this member created an a change in the checkpoint data set
emergency backup copy of the checkpoint in configuration.
the data set named
SYS1.EMERGNCY.HASPCKPT. $K25 FCT REQUESTED ABEND BIT SET
$K19 The same error occurred as indicated by $K18 Internal error: JES common coupling services
except that both CKPTn data sets were installation exits IXZXIT01 or IXZXIT02 set the
allocated to this member during the error. bit to request an abend during JESXCF
inter-member communications. This bit is
Although the CKPTn data set without the error available for testing and diagnostic purposes.
may contain a valid copy of the checkpoint, it is
recommended that you restart JES2 with the $K26 INCOMPATIBLE LEVELS OF CODE
SYS1.EMERGNCY.HASPCKPT data set, DETECTED
providing that it was previously specified (in Internal error: a JES2 checkpoint
response to a $HASP279 message). reconfiguration was attempted between JES2
$K20 JES2 detected an incorrect change log members at incompatible service levels for the
address list entry while updating the checkpoint $CKX data area. Return codes are:
records from the change log. RC= Meaning
$K21 JES2 detected an incorrect change log 1 Receiver’s $CKX data area version is
address list entry while building the change log. too far down level to be compatible
$K22 An internal logic error has occurred in one of with the sender’s $CKX data area
the checkpoint related routines. The reason version
code indicates the routine and type of error. 2 Receiver’s $CKX data area version is
RC=04 The routine CKPTALOC was unable too far up level to be compatible with
to locate the UCB for a checkpoint the sender’s $CKX data area version
data set even though an OBTAIN
indicates the volume is mounted. System Programmer’s Response: Ensure
Because a recovery routine exists for that every MAS member has a compatible
this error, recovery will be attempted. $CKX data area service level.
RC=08 The routine KTRK1IO detected that $K27 CKPT RECONFIGURATION ALREADY
an incorrect parameter list was STARTED
passed to it when called from
Internal error: a checkpoint reconfiguration is
KREAD1.
already started on another MAS member and
has progressed too far for this member to corresponding call made to the driving
participate. A reason code is set from the member was a checkpoint
second byte of field PCEID in the $PCE data reconfiguration synchronization call
area. (CKRRSYNC)
$K28 INTERNAL ERROR DETECTED BY A A storage overlay was detected in the
HASPCKRR $CKM data area
Internal error: either incorrect data was passed $K29 INTERNAL ERROR DETECTED BY
to the checkpoint reconfiguration routine or the HASPCKRR
inter-member communication routine was
Internal error: an error was detected by JES2
called out of sequence. Return codes are:
checkpoint reconfiguration routines that
RC= Meaning manage JESXCF communications. Likely,
JESXCF is the component in error. $K29 is
1 A $CKM data area was not passed to
issued for errors detected in data returned from
the inter-member communication
the JES common coupling services (JESXCF)
routine
as follows:
2 Sequence error: there was a second
$K29 reason codes (displayed in hexadecimal)
checkpoint reconfiguration start
have the following format:
inter-member communication call
(CKRRSTRT) without an intervening RC=ffssttxx
checkpoint reconfiguration end
(CKRRDONE) where:
xx the call code of the last call made to $K34 reason codes (displayed in hexadecimal)
JES XCF (IXZXIXcc) indicated by the have the following format:
xx value in the CKMILSTX byte of the RC=ffss01xx
$CKM data area as follows:
where:
00 no IXZXIXcc service was
called within the scope of the ff function footprint from the CKMIFUNC
currently executing JES2 byte of the $CKM data area
inter-member communication
ss status bits from the CKMIFLG2 byte of
routine.
the $CKM data area
01 IXZXIXAC – acknowledge
01 error type code from the CKMIXERT
message
byte of the $CKM data area (always
02 IXZXIXIF – obtain member 01 for $K34 errors.)
information
xx the call code of the last call made to
03 IXZXIXMB – build mailbox JES XCF (IXZXIXcc) indicated by the
xx value in the CKMILSTX byte of the
04 IXZXIXMC – clear mailbox
$CKM data area as follows:
05 IXZXIXMD – delete mailbox
01 IXZXIXAC – acknowledge
06 IXZXIXRM – receive message
message
02 IXZXIXIF – obtain member
07 IXZXIXSM – send message information
08 call to XCFUSTAT routine to 03 IXZXIXMB – build mailbox
update this member’s XCF
04 IXZXIXMC – clear mailbox
user state
05 IXZXIXMD – delete mailbox
$K31 INTERNAL ERROR DETECTED BY
HASPCKDS 06 IXZXIXRM – receive
message
Internal error: this non-driving member was
directed by the driving member to perform a 07 IXZXIXSM – send message
reconfiguration action that this member
considers unavailable.
$M03 An internal logic error has been detected by RC=08 Buffer queued by BSC processing.
the Remote Telecommunications Access RC=12 Buffer queued by SNA processing.
Method (RTAM) during processing for a
systems network architecture (SNA) or BSC $N11 Network Path Manager (NPM) encountered an
remote work station. error from an XCF service.
$M04 An SNA logical line has been erroneously $PD1 A call was made to $PCEDYN for a DCT
removed from the SNA line queue after having chain, and a DCT in that chain is incorrect (for
been reserved for an SNA example, its DCT table cannot be found, or it
application-to-application session. should not have a PCE related to it).
$M05 BUFSIZE TOO SMALL $PD2 A call was made to $PCEDYN, passing a PCE
or a DCT, and the corresponding PCE table
The size of the buffer associated with the entry or DCT table entry could not be found.
remote punch is too small to hold the buffer
being sent to the device. Increase the buffer $PD3 A call was made to $PCEDYN, passing a DCT,
size being used for this remote. and the DCT table entry corresponding to that
DCT does not have a matching PCE table
$M10 The network path manager has determined entry.
that the nodes attached table (NAT) is
incorrect. $PD4 A call was made to $PCEDYN and there was
an error in the connection between the PCE
$N01 JES2 detected an error while computing the full and a DCT (for example, the PCE and DCT
networking path. The reason code is the return are required to match one-to-one and do not).
code from the $SUBIT macro.
$PD5 A call was made to $PCEDYN to detach a
$N02 Either JES2 received an unexpected return PCE and (1) the PCE length is incorrect, or (2)
code processing a $NATGET or an error was the PCE indicates the processor has resources
found in the nodes attached table (NAT). The outstanding (for example, save areas, buffers,
reason code is the $NATGET return code. or job queue elements).
$N03 Either JES2 received an nonzero return code $PD6 A call was made to $PCEDYN that resulted in
references to PCE table entries (in the A print processor detected an active PQE on
installation PCE table) that indicated required the PQE free queue.
fields are in the UCT. The installation has not
$PP3 PQE IS IN ERROR
allocated a UCT.
A print processor detected an error with an
$PD7 A call was made to $PCEDYN to attach a PCE
active PQE. The problem is one of the
after initialization or to detach a PCE, and the
following:
corresponding PCE table entry indicates PCEs
of that type cannot be dynamically attached or v The data set PQE is not a valid PQED
detached. v The job start PQE is not a valid PQEJ
$PD8 The entry point address of a necessary module v The PQE is pointing to itself.
is set to zeros. This field is zero if the VCON $PP4 EXCP FOR IOB ALREADY IN PROGRESS
created by the MODULE= parameter on the
$PCETAB macro could not be resolved at link JES2 Print/Punch processing is about to initiate
edit time. I/O to a printer/punch and has unexpectedly
discovered that I/O is already in progress.
$PD9 The $PCEDYN service has not found a
required name/token pair. PS0 NO PCE FOR ACTIVE PSO
$PD10 The $PCEDYN service has found the address An active PSO was detected but a search of
of a required COUNT= parameter that is not PSO PCEs found none processing the PSO.
valid.
PS1 JQELOCK not held at TREGROUP
$PD11 The $PCEDYN service has found the address
TREGROUP service routine was called without
of a required CHAN= field that is not valid.
holding job lock.
$PD12 The required name/token pair that attached a
PS2 JQELOCK not held at PSOFRELK
PCE associated with the DCT has not been
found. PSOFRELK service routine was called without
holding the job lock.
$PG1 An address of zero was passed to the
$PGSERV service routine. $PT1 $PUTABLE INVALID TABLE ENTRY
$PJ2 The $PJES2,ABEND command was issued. The $PUTABLE service has located a table
pair which a dynamic table pointer does not
$PJF The $PJES2,ABEND,FORCE command was
point to a dynamic table. The probable cause
issued.
is either a mismatch of levels of the $MCT
$PP0 PQE COUNT IS GREATER THAN PQE LIMIT macro, or a failure to use the $PAIR macro to
define a table pair.
A print processor detected an incorrect PQE
count. $Q01 A JES2 processor requested a job queue
service routine function with incorrect
$PP1 PQE CHAINING ERROR arguments or failed to ensure that the job
A print processor detected an incorrectly queue checkpoint processor was not active for
chained PQE. The reason code describes how a $QMOD service function.
the PQE is incorrectly chained: $Q02 A JES2 processor requested a job queue
RC=04 The PQE address is the PQE header service but failed to find the queue for the type
address. specified in the job’s JQE. To ensure a clean
recovery, this error requires that you perform
RC=08 The PQE is on the free queue. an all-member warm start of JES2.
RC=12 The PQE forward pointer loops to the $Q03 REQUIRED $QSUSE CONTROL NOT
same PQE. OBTAINED
RC=16 The PQE backward pointer loops to A service was called that requires the caller to
the same PQE. own the checkpoint queues, but the caller does
RC=20 The PQE backward pointer is not own them. The caller must issue a
incorrect. $QSUSE macro to obtain ownership before
calling the service, or before attempting to
RC=24 The PQE forward pointer is incorrect. modify a checkpointed control block.
RC=28 The PQEJ forward pointer loops to the $Q04 JES2 has detected an incorrect checkpoint
same PQE for a job start PQE queue element address. The reason code
(PQEJ). indicates the exact error.
$PP2 PQE IS NOT ON THE FREE QUEUE
RC=04 The element address passed to the $Q14 JQE CHANGED WHILE JQA ACTIVE
$CKPT service routine is lower than
JES2 detected an update to a real JQE while
the valid range of addresses for the
an artificial JQE was locked using $DOGJQE.
element type.
Updates to JQE without $DOGJQE
RC=08 The element address passed to the serialization is not allowed.
$CKPT service routine is higher than
$Q15 JQE NOT ARTIFICIAL
the valid range of addresses for the
element type. A job was being added to a WLM service class
queue, however, a real JQE was passed to the
RC=12 The element address passed to the
queue service but an artificial JQE was
$CKPT service routine does not point
required.
to the start of the control block being
$CKPTed. $Q16 $DOGJQE FETCH,UPDATE AND QUEUES
NOT OWNED
$Q05 INCORRECT JOB QUEUE CHANGE
REQUEST The $DOGJQE service has been called to
support ACTION=(FETCH,UPDATE) or
A JES2 processor requested a job queue
ACTION=(FETCHNEXT,UPDATE), or
service with the $QMOD macro to change the
ACTION=REFRESH and the JES2 queues are
processing phase of a job when the change
not owned.
was not allowed.
$Q17 DJACCESS INCORRECT CALLING
$Q06 JQE ON INCORRECT QUEUE
SEQUENCE
The JQE obtained from the free queue had a
The $DOGJQE service has been called to
type indication other than free or while running
support ACTION=FETCHNEXT,
a JQE queue, a JQE with an incorrect queue
ACTION=REFRESH, ACTION=SETACCESS or
type was encountered. This is a JES2 internal
ACTION=MANAGEACCESS. The caller has
logic error.
failed to provide a valid JQA address.
$Q07 INCORRECT JQE ADDRESS
$Q18 INCORRECT ACTION AGAINST UNLOCKED
The JQE address passed to one of the job JQA
service routines was not a valid JQE or JQA
The $DOGJQE service has been called to
address.
perform an action other than FREE or
$Q08 ATTEMPT TO QUEUE JOB TO MANAGEACCESS,ACQUIRE for a JQA which
NON-EXISTENT QUEUE previously had been set in a lock freed state by
a MANAGEACCESS,RELEASE call.
A $QADD, $QMOD, or $QPUT service
requested a job queue type that is not valid. $Q19 $DOGJQE FETCHNEXT NOT VALID IF
STACK
$Q09 The caller of the $GETLOKW service did not
establish access to the checkpoint queues The $DOGJQE service has been called to
using the $QSUSE macro. perform a FETCHNEXT using a JQA as input
which has a stack of users.
$Q10 The $GETLOKW or $FRELOKW service was
called from an unexpected PCE. $Q20 $DOGJQE IMPROPER JQA EMPTY STATUS
$Q11 JQE/JIX MISMATCH The $DOGJQE service has been called to
support ACTION=FETCH and was given a JQA
A job has a job number that the JIX indicates is
which is empty.
either unassigned or assigned to another job.
$Q21 REQUIRED JQA ADDR NOT PASSED TO
$Q12 REQUEST TO MANIPULATE FREE JQE
$DOGJQE
The caller passed a ‘free’ JQE to a service
The $DOGJQE service has been called to
routine.
support an ACTION other than FETCH,
$Q13 ATTEMPT TO BUSY A JQE DURING WARM FETCHNEXT, REFRESH or QUERYLOCK and
START there was no other JQA provided.
During warm-start processing, JES2 attempted $Q22 $DOGJQE CALLER USED OLD MACRO
to set on the busy system indicator for a JQE. FORM
Changing the system busy indicator for a JQE
The $DOGJQE service has been called by a
cannot occur during a warm-start because it
routine which has not been reassembled using
would conflict with the recovery processing of
the latest version of the $DOGJQE macro.
busy JQEs.
$Q23 CAT AND JOB CLASS DIFFER ON $QBUSY $S03 JES2 detected an incorrect spin $IOT address
while processing the first-in first-out (FIFO) spin
The CAT that the $QBUSY service found (or
$IOT queue.
the CAT passed into the service) does not
match the execution class in the JQE. Either $SA1 The JOE or JQE currently found in the $SAPID
the wrong CAT was passed into the service or for this thread is not consistent with a previous
the current JQETYPE does not reflect the SAP1 request made by this thread.
same job class as the JQXJCLAS field.
$SG1 While processing a request to get an SMF
$Q24 ATTEMPT TO BUSY JOB THAT IS ALREADY buffer, the SMF free count was about to go
ACTIVE negative.
The $QBUSY service was called to busy a $SG2 While processing a request to get an SMF
JQE that was already marked as busy. buffer, $CPOOL services failed to return a cell.
If recovery is attempted from this error, SMF
$Q25 ATTEMPT TO SET DCTDEVID WITH NO DCT
processing will be turned off.
The $QBUSY service was called to busy a
$SM1 JES2 detected a non-valid track address in
JQE and set the active device identifier
module HASPSPOL during an I/O operation.
(JQEDEVID). However there is no DCT
associated with the current PCE. $SW1 JES2 detected an error while processing a
scheduler JCL facility request.
$Q26 INCORRECT OFFSET OR LENGTH FOR
$DOGJQE $TK1 An incorrect checkpoint token was passed to
the $CHECK service routine. Because a
$DOGJQE ACTION=CKPTFLD not valid
recovery routine exists for this error, recovery
parameters.
will be attempted.
$Q30 CHECKPOINT INFO FOR JIX CTENT
$TR1 The exclusive ENQ for the trace table, issued
OVERLAID
by the $TRACE log processor, failed. The
JES2 detected an overlay of the JIX CTENT. reason code is the return code from the ENQ
macro.
$QG1 EXIT 49 ISSUED $WAIT
$TR2 The trace log processor incurred a GETMAIN
Exit 49 rejected the JQE that was passed to it failure.
and also issued $WAIT. Exit 49 can only
$WAIT if it does not reject the JQE. $U01 An installation exit routine issued a return code
that is higher than the maximum return code
$QG2 $EXIT 14 DID NOT RETURN UPDATABLE value specified in the $MAXRC parameter of
JQA the $EXIT macro instruction.
Exit 14 gave a return code of 8 but failed to $U03 A GETMAIN for the UCB parameter list failed.
provide an update-mode JQA.
$V01 The executing job is using unavailable spool
$R01 JES2 detected that $SCQJQE does not space during a hot start of JES2.
contain a valid offset for shared communication
queue JQE. $WL1 UNABLE TO DETERMINE WLM SERVICE ID
While processing the policy activation, JES2
$RD1 NJE job header create table is full. received an unexpected return code from
$RD2 NJE job header or trailer corrupted. IWMPQRY. See message $HASP712 to
determine what return code was passed.
$REP The required recovery routine specified on a
$PCTAB cannot be found. $WL2 UNRECOVERABLE CLASSIFICATION
ERROR While classifying a job, JES2 received
$RT1 $RETABLE INVALID TABLE ENTRY an unexpected error return code from
The $RETABLE service has located a table IWMCLSFY. See messages $HASP712 to
pair in which a dynamic table pointer does not determine what return code was passed.
point to a dynamic table. The probable cause $WS1 The remote printer or punch device control
is either a mismatch of levels of the $MCT table (DCT) you want cannot be found. The
macro, or a failure to use the $PAIR macro to request is ended.
define a table pair.
$WS2 The work selection service routine (WSSERV)
$S01 A GETMAIN for a permanent JES2 save area did not receive the address of a required
pool has failed. control block from the calling routine.
$S02 The JES2 $RETSAVE service routine has RC=04 The JOE address was not found.
detected that the save area being returned is
not on the calling processor’s save area chain. RC=08 The JQE address was not found.
RC=12 The JCT address was not found. been abnormally ended. X'0Cx' is the system
completion code, where x = 1 through F. See
RC=16 The data set header address was not
the description of codes in z/OS MVS System
found.
Codes.
RC=20 The UCT address was not found.
System action: If a JES2 recovery routine exists for
RC=24 The DCT address was not found. this error, and the JES2 error rate has not reached or
exceeded the value specified in the RECVOPTS
$WS3 No work selection (WS) tables were defined for initialization statement, JES2 issues an indicative dump
a device. (message $HASP088) to the hard-copy log, and then
$WS4 There was no slash found in either the invokes the recovery routine.
installation work selection table or the HASP If a JES2 recovery routine exists for this error, and the
work selection table. A slash must be found in JES2 error rate has reached or exceeded the value
one of these tables for the selection criteria to specified in the RECVOPTS initialization statement,
be valid. JES2 issues message $HASP070 and waits for the
$X01 The spool offload channel-end routine (module operator to reply.
HASPSTAM) found that I/O operations were If there is no JES2 recovery routine for this error, JES2
not completing in order. issues an indicative dump (message $HASP088) and
$X02 The spool offload channel-end routine (module message $HASP098 to the master console.
HASPSTAM) found that the number of I/O Even if a recovery routine exists, the following
completions exceeded the number of I/O catastrophic errors cause JES2 to end: BR3, CF1, CF2,
operations issued. DP3, DP4, ER1, ER5, ER9, GS1, J09, J10, K04, K08,
$X03 GETMAIN failed to obtain the storage required K20, K21, K22, K23, K24, PJF, PJ2, Q02, Q06, Q07,
for job control blocks during conversion Q11, Q23, WS3, WS4, ZP1, and Z03
processing. The following catastrophic errors require that the system
$X04 UNRECOVERABLE CLASSIFICATION be re-IPLed: $K02, $K03, $K08, $K15 (when $K15
ERROR SJB NO LONGER QUEUED TO occurs after initialization) and $V01.
CHAINAn attempt has been made to dequeue Operator response: Notify the system programmer.
an SJB that has already been dequeued. Enter the appropriate response to message $HASP098.
$X05 The running processor incurred a GETMAIN System programmer response: Use the indicative
failure. dump and the SVC dump (if any) to diagnose the error.
$X06 Unable to obtain the SVJLOK resource. The If the displayed error code is $K04, $K10, $K15, $K17,
return code from ENQ is in register 2. $K18, or $K19, a possible reason for the error is that
$XC1 A JES2 XCF error has occurred. A previously the JES2 program (for example, HASJES20) does not
displayed message(s) ($HASP777 and have the non-swappable attribute in the program
$HASP779) provides the reason for the properties table. Examine the SCHEDxx PARMLIB
JESXCF error. member to determine whether the JES2 program has
the non-swappable attribute. See z/OS JES2
$XC2 A JES XCF service returned an unexpected Initialization and Tuning Reference for more information.
return code. The reason code associated with
this error code is the return code from the JES Detecting Module: HASPBSC, HASPIRMA,
XCF service. See z/OS MVS Programming: HASPCKDS, HASPCKRR, HASPJOS, HASPCKPT,
JES Common Coupling Services for an HASPNUC, HASPCNVT, HASPNPM, HASPCOMM,
explanation of the return code and the HASPRAS, HASPCON, HASPRDR, HASPDYN,
associated programmer action. HASPSERV, HASPEVTL, HASPSNA, HASPFSSM,
HASPSTAM, HASPIRA, HASPTERM, HASPIRDA,
$XF1 JES2 detected an error or unexpected return HASPTRAK
code from JESXCF.
Routing Code: 1,2,10
$ZP1 ZAP JOB QUEUE ERROR
Descriptor Code: 11
ZAPJOB processing has induced a job queue
error. JES2 terminates. When restarting JES2,
use the initialization form ZAPJOB to remove $HASP096
the offending job. Explanation:
$Z03 An unrecoverable subtask abend has occurred. DISASTROUS ERROR AT SYMBOL errorsyn
IN CSECT errormod
$HASP097
Explanation:
MTTR=mmttttrr,UNIT=unit,VOLSER=vvvvvv
devname IS DRAINED
One of the following occurred:
The operator issued the $P command for the indicated
v If an I/O error message accompanies this message, a
device, and the device has entered the DRAINED
critical I/O error has occurred on the SYS1.HASPACE
status. With OS/390 Release 4, some parameter
data set.
descriptions might truncated (for example, LNE),
v If no I/O error message accompanies this message, therefore, your automation processing might be
there is a logic error in JES2. Possible reasons for affected.
the logic error are: In the message text:
– JES2 tried to free a JCT (job control table) from
devname
the JCT queue and could not find the JCT on the
The name of the drained device.
queue, or JES2 detected an incorrect IOT (I/O
table) or incorrect JCT while reading the spool. System action: JES2 discontinues use of the device
– JES2 detected an incorrect remote message JQE until a $S device command is entered, specifying the
(RATRMJQE) for the signed-on remote. Either the device correctly. JES2 deallocates the device, permitting
JQE was not on the hardcopy queue it to be used by other tasks within the system.
($HARDCPY), or was not a started task (STC), or Operator response: Enter a $S device command
the remote name (RATNAME) and the JQE when JES2 is to continue using the device.
jobname (JQENAME) did not match.
Detecting Module: HASPNUC
The indicated symbol is used to generate the error Routing Code: 7,8
message and can be referenced in the assembler
cross-reference for the indicated CSECT. Descriptor Code: 4
Operator response: Notify the system programmer. System action: The system waits for the operator to
reply. If no response is made after 10 minutes, then
System programmer response: Recreate the failure JES2 will take the default action of END,DUMP.
while running $TRACE ID=3. Optionally, issue a SLIP $HASP065 is issued every 30 seconds to tell the
dump or code an SDUMP macro on entry to the operator that an automatic response will occur for the
$DISTERR routine in HASPNUC. WTOR.
Detecting Module: HASPRAS Operator response: Enter one of the following:
Routing Code: 10 END – JES2 attempts to stop any attached tasks,
informs tasks waiting on a JES2 function of the
Descriptor Code: 4
error, and then exits from the system. Upon
completion, the $HASP085 message is issued.
$HASP099
Explanation:
ALL AVAILABLE FUNCTIONS COMPLETE
Descriptor Code: 4
$HASP102
Explanation:
$HASP104
jobname HELD FOR THE
Explanation:
FOLLOWING VOLUME(S) – – jobname text
devname
The indicated job has been placed in HOLD status by
the JES2 input service because a /*SETUP control The input service processor has detected a
statement was encountered. The text of the control /*MESSAGE control statement in the input stream.
statement is displayed with accompanying $HASP103 In the message text:
messages.
In the message text: jobname
The name of the job.
jobname
The name of the held job. devname
The name of the device.
Note: A jobid may precede $HASP102. See “JES2 text The text of the /*MESSAGE control statement.
message format” on page 1.
System action: The system continues processing and Note: A jobid may precede $HASP104. See “JES2
holds the job on the execution queue. message format” on page 1.
Operator response: Ensure that the requested System action: Processing continues.
volumes are available to be mounted, and release the Operator response: Respond to the message
job. accordingly.
System programmer response: None. System programmer response: None.
Detecting Module: HASCSRIP Detecting Module: HASCSRIP
Routing Code: 1–6 Routing Code: 1–6
Descriptor Code: 4 Descriptor Code: 4
$HASP103 $HASP105
Explanation: Explanation:
jobname volser,...,volser jobname – – EXPECTED CONTINUATION
The indicated job has been placed in HOLD status by NOT RECEIVED
the JES2 input service pending availability of the
volumes indicated by volser,...,volser. In a line of a JCL statement, the system found either a
In the message text: non-blank character in column 72, or a comma at the
jobname end of the last operand, and expected a continuation on
The name of the held job. the next line. A continuation begins with //. Instead, the
next line began with /*.
volser ,..., volser In the message text:
The one to eight character volume identifier of
the volumes. jobname
The name of the job.
Note: A jobid may precede $HASP103. See “JES2 System action: Input servicing for jobname
message format” on page 1. terminates.
System action: The job is placed in JES2 HOLD Application Programmer Response: If the
status, and input processing continues. continuation line is missing, provide it.
Operator response: Ensure that the requested If the continuation line is present, but mistakenly begins
volumes are available to be mounted and release the with /*, correct it to begin with //.
job.
If no continuation was intended, correct the first line so
System programmer response: None. that column 72 is blank, and the last operand ends with
a blank.
Detecting Module: HASCSRIP
Routing Code: 1–6
Detecting Module: HASPRDR, HASCINJR, VALUE FOR xxxxxxxx KEYWORD NOT VALID
HASCNJJR The value for the keyword listed is syntactically not
valid (for example, unbalanced parentheses or
Routing Code: 7
apostrophes might exist).
Descriptor Code: 4
UNEXPECTED KEYWORD DETECTED – xxxxxxxx
An unknown keyword was encountered on the
$HASP106 statement.
Explanation: UNEXPECTED POSITIONAL OPERAND DETECTED
jobname DELETED BY JES2 OR CANCELLED A positional operand was encountered where one
was not expected. Typically this is caused by a
BY OPERATOR BEFORE EXECUTION missing ’=’ or improper apostrophes.
VALUE FOR POSITIONAL OPERAND NOT VALID
JES2 places this message in the job log: A syntactically invalid positional operand was
v If the jobname contained a JECL error detected.
v The operator canceled the job before the jobname
processed. | Note: A job identifier may precede $HASP107. See
| “JES2 message format” on page 1.
In the message text: System action: The message is written to the JCL
jobname data set and JES2 ends input service processing for the
The name that appears in the name field of the job. The job is queued for output processing.
JOB JCL statement. Operator response: None.
Note: A job identifier may precede $HASP106. See Application Programmer Response: See z/OS MVS
“JES2 message format” on page 1. JCL Reference for correct forms of the listed statement.
Correct the JCL error and rerun the job.
System action: Processing continues.
Detecting Module: HASCSRIP
Operator response: None.
Routing Code: 7
System programmer response: None.
Descriptor Code: 4
Detecting Module: HASPHOPE
Routing Code: – $HASP108
Descriptor Code: – Explanation:
jobname – – NON-VALID XMIT STMT - reason
$HASP107
A //XMIT card which was included in a JCL stream is in
Explanation: error. The reason in the message describes the error:
jobname – – NON-VALID statement In the message text:
jobname
STMT, reason
The name of the affected job.
While parsing JCL statements, JES2 detected an error reason is one of:
on the xxxxxxxx statement. The problem encountered is
identified by reason. DEST KEYWORD ERROR, RC=1
In the message text: The DEST= keyword specified null destination.
jobname NO OPERAND SUPPLED, RC=2
The name of the affected job. No operands were specified on the //XMIT
card. The DEST= keyword is required.
statement
The JCL statement affected. DEST= VALUE IN ERROR, RC=3
The DEST= keyword specified a destination
reason is one of the following: that was not valid.
Chapter 5. One-hundreds 61
$HASP109 • $HASP110
The JECL/JCL installation exit routine (Exit 4/54) has v Started jobs that use IEFJOBS support, where
notified the input service processor that it has detected only one JOB card is permitted in the started
an illegal control statement. The installation may use the member.
exit routine to replace the text of this message. If the problem is a started job, for example, and this
In the message text: message is preceded by $HASP100 ON
jobname STCINRDR, see z/OS MVS JCL Reference for
The name of the job. more information.
VALUE OF ACCOUNTING STRING IS TOO LONG
Note: A jobid may precede $HASP109. See “JES2 The accounting string positional operand is longer
message format” on page 1. than the maximum value allowed.
System action: JES2 ends input service processing VALUE OF PROGRAMMER NAME IS TOO LONG
for the job. The programmer name positional operand is longer
than the maximum value allowed.
Application Programmer Response: See z/OS MVS
JCL Reference for the correct format of the control VALUE OF keyword= EXCEEDS n CHARACTERS
statement in error. Correct the control statement and The value provided for the specified keyword
resubmit the job. exceeds the maximum value allowed.
Detecting Module: HASCSRIP VALUE OF keyword= HAS TOO MANY OPERANDS
The specified keyword is a list for which too many
Routing Code: 7
values have been specified.
Descriptor Code: 4
VALUE of keyword= PARAMETER IS GREATER
THAN nnn
The specified keyword has a value larger than the
maximum allowed for the keyword.
VALUE OF keyword= PARAMETER IS NOT NUMERIC Note: A jobid may precede $HASP111. See “JES2
The specified keyword is required to be numeric. message format” on page 1.
VALUE OF keyword= PARAMETER IS NOT VALID System action: The message is written to the JCL
The value provided for the specified keyword is not data set and JES2 ends input service processing for the
valid. job. The job is queued for output processing.
VALUE OF keyword= PARAMETER IS NULL Operator response: None
The specified keyword cannot be specified as null.
Application Programmer Response: See z/OS MVS
JCL Reference for correct forms of the /*ROUTE
Note: A jobid may precede $HASP110. See “JES2
statement. Correct the JCL error and rerun the job.
message format” on page 1.
Detecting Module: HASCINJR, HASCSRIP,
System action: The message is written to the JCL
HASPRDR
data set and JES2 ends input service processing for the
job. The job is queued for output processing. Routing Code: 7
Operator response: None Descriptor Code: 4
Application Programmer Response: See z/OS MVS
JCL Reference for information about coding JOB $HASP112
statements. Correct the JOB statement or remove the
Explanation:
additional job cards and resubmit the job. If you want to
allow the illegal JOB statement to be ignored, specify jobname – – INVALID /*JOBPARM CARD - reason
JCLERR=NO on the JOBDEF initialization statement.
While parsing JCL statements, JES2 detected an error
Detecting Module: HASCINJR, HASCSRIP, on the /*JOBPARM statement. The problem
HASPRDR encountered is identified by reason.
In the message text:
Routing Code: 7
jobname
Descriptor Code: 4
The name of the affected job.
Chapter 5. One-hundreds 63
$HASP113 • $HASP114
job. The job is queued for output processing. job. The job is queued for output processing.
Operator response: None Operator response: None
Application Programmer Response: See z/OS MVS Application Programmer Response: See z/OS MVS
JCL Reference for correct forms of the /*JOBPARM JCL Reference for correct forms of the /*OUTPUT
statement. Correct the control statement and rerun the control statement. Correct the control statement and
job. rerun the job.
Detecting Module: HASCSRIP Detecting Module: HASCSRIP
Routing Code: 7 Routing Code: 7
Descriptor Code: 4 Descriptor Code: 4
$HASP113 $HASP114
Explanation: Explanation:
jobname – – INVALID /*OUTPUT CARD - reason jobname – – INVALID /*XEQ CARD - reason
While parsing JCL statements, JES2 detected an error jobname – – INVALID /*ROUTE XEQ CARD - reason
on the /*OUTPUT statement. The problem encountered jobname – – INVALID EXECUTION NODE
is identified by reason.
In the message text: While parsing JCL statements, JES2 detected an error
on the /*XEQ or /*ROUTE XEQ statement. The problem
jobname
encountered is identified by reason.
The name of the affected job.
In the message text:
reason is one of the following: jobname
The name of the affected job.
INCORRECT CODE VALUE
The code value specified is not valid (too long or
reason is one of the following:
invalid characters).
EXECUTION NODE NOT VALID
INCORRECT CONTINUATION
The node specified on the XEQ statement is not a
An attempt to continue an OUTPUT statement was
valid NJE node, or a DESTID of a valid node.
made but no previous output statement exists for
the job. MISSING POSITIONAL OPERAND
The required node name operand was not specified
VALUE OF keyword= EXCEEDS nnnnnnnn
on the JCL statement.
The numeric value provided for the specified
keyword exceeds the maximum value allowed for
the keyword. Note: A jobid may precede $HASP114. See “JES2
message format” on page 1.
VALUE OF keyword= EXCEEDS n CHARACTERS
The character values provided for the specified System action: The message is written to the JCL
keyword is longer than the maximum allowed data set and JES2 ends input service processing for the
length. job. The job is queued for output processing.
System action: The message is written to the JCL The input service processor has detected an
data set and JES2 ends input service processing for the unrecognizable JES2 control statement.
job. The job is queued for output processing. In the message text:
Operator response: None jobname
Application Programmer Response: See z/OS MVS The name of the affected job.
JCL Reference for the correct format of the /*NETACCT
control statement. Correct the control statement and Note: A jobid may precede $HASP118. See “JES2
rerun the job. message format” on page 1.
Detecting Module: HASCSRIP System action: JES2 ends input service processing
for the job.
Routing Code: 7
Application Programmer Response: See z/OS MVS
Descriptor Code: 4 JCL Reference for the correct format of the control
statement in error. Correct the statement and resubmit
$HASP116 the job.
Chapter 5. One-hundreds 65
$HASP120
ILLEGAL EXECUTION NODE, RC=9 cmd The text of the entered command.
The input service processor detected an System action: The command is passed to the JES2
incorrect execution node for a JOB. command processor for the further action.
EXCESSIVE SYSIN STATEMENTS, RC=10 Operator response: None.
The job being processed by the input service
processor has more SYSIN data sets than can Detecting Module: HASPRDR, HASCINJR,
be represented within the total number of HASCNJJR
buffers available on this member.
Routing Code: 7,8
DEVICE CANCELLED OR STOPPED, RC=11
Descriptor Code: 4
The input service processor has detected that
it’s associated device has been canceled or
stopped. This may be the result of an operator
command or a request by the device to
terminate processing.
$HASP121 $HASP122
Explanation: Explanation:
jobname device name ERROR RECEIVING jobname ( jobid FROM nnnnnnnn )
Chapter 5. One-hundreds 67
$HASP124 • $HASP125
delete a job currently on the device, perform the In the message text:
appropriate action consistent with the reason for
devname
deletion. If skipping is caused by the deletion of a job
The device name.
because of an error encountered, inform the
programmer of the error. Otherwise, check the input jobid The job identifier of the flushed job.
stream to make sure that the cards are in correct order
and resubmit the corrected jobs after canceling any that jobname
were incorrectly entered. The name of the flushed job.
Application Programmer Response: Correct the JCL System action: Recovery processing continues.
in accordance with the accompanying error messages. Operator response: None.
Detecting Module: HASPRDR, HASCINJR, System programmer response: None.
HASCNJJR
Detecting Module: HASPRDR
Routing Code: 7
Routing Code: 7,10
Descriptor Code: 4
Descriptor Code: 4
$HASP126
$HASP129
Explanation:
OUTPUT= grpid,joeid1,joeid2 Explanation:
jobname EXCESS SYSIN DD STATEMENTS
OUTPUT DELETED
A user submitted a job stream to JES2 with such a
A $#ADD macro has found a bad class in the JOE. A large number of SYSIN //ddname DD * or DD DATA
disastrous error is issued previous to this message. JCL statements that they could not be represented
In the message text: within the total number of buffers allocated to JES2 by
the EXTBUF parameter on the BUFDEF initialization
grpid The group identifier name assigned by the user statement.
or JES2. In the message text:
joeid1 The number of job output elements in output jobname
group grpid. The name of the failed job.
joeid2 The number of job output elements in the
output group identified by grpid and joeid1. Note: A jobid may precede $HASP129. See “JES2
message format” on page 1.
System action: JES2 deletes the data set.
System action: JES2 ends input service processing
Operator response: Notify the system programmer. for the specified job.
System programmer response: Investigate Application Programmer Response: If the failing job
disastrous error. was submitted by a program that entered a loop, correct
Detecting Module: HASPMSG, HASPJOS the program. Otherwise, use the failing job’s output to
determine the largest number of SYSIN DD cards that
Routing Code: 2,10 can be included in one job stream on your system.
Correct the JCL and rerun the job.
Descriptor Code: 4
Detecting Module: HASCSRIP
$HASP128 Routing Code: 7
Explanation: Descriptor Code: 4
devname SIMULATING $C
$HASP130
jobid jobname FLUSHED Explanation:
SECOND OPERAND OF JESLOG HAS ssssssss
A program check occurred while a JES2 processor was
using device devname. JES2 is simulating a $C ERROR
command for the device to prevent JES2 from ending. If
the device was processing a job when the program The JOB statement has an error in the second operand
check occurred, JES2 flushes the job and identifies it in of the JESLOG= operand.
the message text. In the message text ssssssss=:
Chapter 5. One-hundreds 69
$HASP131 • $HASP133
SYNTAX
$HASP132
The operand is not of the form nnn, nnnK,
nnnM, hh:mm, h:mm +hh:mm, or +h:mm. If of Explanation:
the proper form, then the minute value may be DSNAME devname MUST CONTAIN ALL
greater than 59.
ALPHANUMERICS AND/OR CHARACTERS
SEMANTICS
The line count is less than 500, the time
@,#,$,-,X’C0’
interval is less than 10 minutes or the time of
day, hh, is greater than 23.
JES2 builds this message when an incorrect character
System action: The job fails JCL conversion. is found in the DSNAME value specified on a SYSIN or
Application Programmer Response: Fix the JCL SYSOUT DD statement.
specification. In the message text:
Chapter 5. One-hundreds 71
$HASP136 • $HASP138
devname
The name of the device on which the input was $HASP138
entering the system (xeqnode). Explanation:
xeqnode JESLOG SPIN
The name of the node at which this job was to REQUESTED BY OPERATOR
execute. HAS OCCURRED BECAUSE OF TIME INTERVAL OR TIME OF DAY
OF LINE COUNT
orgjobid
The JES2 JOBLOG (JESMSGLG) and systems
The job identifier or VM/RSCS spool file
messages (JESYSMSG) have been spun and made
identifier from which this job originated.
available for processing.
orgjname In the message text if:
The job name associated with this job identifier
JESLOG SPIN REQUESTED BY OPERATOR
that was found in the Network Job Header.
A result of a $TJnnn, SPIN $TSnnn,SPIN or
System action: The input service processor will flush $TTnnn,SPIN command.
the input stream.
JESLOG SPIN HAS OCCURRED BECAUSE OF TIME
Operator response: None. INTERVAL OR TIME OF DAY
A result of the time interval for JESLOG
Application Programmer Response: Check the input
(JESLOG=(SPIN,+hh:mm)) expiring or the time
stream to make sure that the cards are in the correct
of day (JESLOG=(SPIN,hh:mm)) occurring.
order and there is a valid JOB card before the /*XMIT
card. Correct the JCL accordingly and resubmit the job. JESLOG SPIN HAS OCCURRED BECAUSE OF LINE
This message can be cross referenced with orgjobid to COUNT
the $HASP135 message received by the operator at the A result of the line count criterion being
execution node. reached (JESLOG=(SPIN,nnn)).
Detecting Module: HASCSRIP System action: Job processing continues.
Routing Code: 7,8,10 System programmer response: None.
Descriptor Code: 4 Operator response: None.
Detecting Module: HASPCOMM, HASCDSOC
Routing Code: None. The message appears only in
SYSLOG, JESMSGLG and JESYSMSG.
The specified exit returned JCL to be processed by During termination, JES2 encountered a failure
input processing. However, the JCL that was returned attempting to delete an ENF listen exit.
had continuation or other errors that prevented input In the message text:
processing from correctly processing the job stream.
In the message text: nn Relative number of the ENFREQ
CODE=DELETE that failed.
jobname
The name of the affected job. xx The return code from the ENFREQ
CODE=DELETE macro.
nnn The exit, or exits, that returned the invalid JCL.
System action: JES2 continues termination
Note: A jobid may precede $HASP139. See “JES2 processing.
message format” on page 1. System programmer response: Contact the IBM
System action: The message is written to the JCL Support Center.
data set and JES2 ends input service processing for the Detecting Module: HASPTERM
job. The job is queued for output processing.
Routing Code: 1,2,10
Operator response: None
Descriptor Code: 4
System programmer response: Review the exit and
any JCL that is being modified or added by the exit.
Review documentation for the exits in z/OS JES2 $HASP150
Installation Exits for more information on how to code a Explanation:
user exit.
Detecting Module: HASCSRIP jobname
Chapter 5. One-hundreds 73
$HASP151 • $HASP153
See z/OS MVS Programming: Assembler Services System programmer response: None.
Reference ABE-HSP under the SETPRT macro Detecting Module: HASPPRPU, HASPFSSP
instruction for the explanation of the return code in the
SETPRT error message. Routing Code: 7,10
Descriptor Code: 4
Note: A jobid may precede $HASP151. See “JES2
message format” on page 1.
$HASP153
System action: JES2 stops processing the specified
job. Message $HASP190 is issued when this job Explanation:
requires that the setup for the device be altered. The prtname JAMMED,SYSOUT RESTART
SETPRT error message and message $HASP154 are
issued to the programmer. The printer identified in the message has lost some
data.
Operator response: Respond as indicated in the
In the message text:
SETPRT error message. If necessary, issue the $DU
command to display the current status of the printer and
prtname
$HASP156
The name of the printer.
Explanation:
System action: If the operator does not reposition the
jobname prtname JOB REQUEUED
printer, output processing resumes with the output last
fused by the printer. If the operator wishes to reposition
the printer, the operator must wait for JES2 to resume The operator entered a repositioning command for the
output processing. 3800 printer identified by prtname. At least some (and
possibly all) of the output for the specified job has
Operator response: If automatic recovery is crossed the 3800 transfer station. This job is requeued
acceptable, the operator need not respond. If automatic on the output queue.
recovery is not acceptable, the operator must wait for In the message text:
JES2 to complete its backspacing process. If the
operator does not wait, JES2 will not accept any jobname
operator commands. The operator may enter a $F The name of the job.
command or $B command to reposition the printer to prtname
the page you want. The operator may even choose to The name of the printer.
enter a $E command to restart the printer.
System programmer response: None. Note: A jobid may precede $HASP156. See “JES2
message format” on page 1.
Detecting Module: HASPPRPU
System action: The repositioning command is
Routing Code: 7 processed. The requeued job will be printed on any
Descriptor Code: 4 eligible device.
Operator response: None.
$HASP154 System programmer response: None.
Explanation: Detecting Module: HASPPRPU
SETPRT ERROR DEVICE= prtname
Routing Code: 7
JOB= jobname ID= jobid ROOM= rrr Descriptor Code: 4
Chapter 5. One-hundreds 75
$HASP158 • $HASP165
display the current status of the printer, and use the $T printer ($C, $E, or $I), the command processes
command to attempt to correct the error. If necessary, against the current job and the printer drains.
contact the system programmer.
08 Hold or cancel the job and restart the printer.
System programmer response: Respond as Notify the system programmer.
indicated by the return code in register 15, which
12 Notify the system programmer.
appears in this message. See the SETPRT macro
instruction in z/OS DFSMS Macro Instructions for Data System programmer response: If this message
Sets for the meanings of return codes 18 through 50. appears frequently, increase the CKPTPAGE parameter
in the printer initialization statement. If this message is
Detecting Module: HASPPRPU
associated with a particular job, increase the CKPTPGS
Routing Code: 7 parameter in the /*OUTPUT control statement or the
CKPTPAGE parameter on the JCL OUTPUT statement.
Descriptor Code: 2
Detecting Module: HASPPRPU
$HASP158 Routing Code: 7
Explanation: Descriptor Code: 2,4
jobname prtname PPQ SHORTAGE
$HASP160
– CODE = cde
Explanation:
JES2 detected a critical resource shortage during devname INACTIVE – CLASS =
processing for the 3800 printer.
In the message text: class
class...class
jobname
The name of the job.
The indicated device found no work in the queue(s)
prtname specified by class [class...class].
The name of the printer. In the message text:
cde A decimal code indicating the type of shortage. devname
The name of the device searching for work.
Possible values of cde are:
class[class...class]
cde Description The names of the queues.
04 The PPQ (pending page queue) of the 3800 System action: The specified device remains
printer has been exhausted. INACTIVE until work becomes available.
08 GETMAIN attempted to expand the PPQ of the Operator response: You can use the set ($T)
3800 printer and failed. command to:
12 An error has been detected in the PPQ of the v Alter the setup to match work in the listed classes.
3800 printer. v Alter the current class list.
System programmer response: None.
Note: A jobid may precede $HASP158. See “JES2
message format” on page 1. Detecting Module: HASPPRPU, HASPFSSP
cde Response
04 Entering a $S PRTnnnn command attempts to
expand the PPQ of the 3800 printer. If the
expansion is successful, normal processing
continues. If you enter a command to stop a
ENDED AT nodename cc= ddd Note: A jobid may precede $HASP165. See “JES2
xxx yyy
ENDED AT nodename – MAXCC maxcc
message format” on page 1.
JCL ERROR
CANCELLED System action: The job enters the output phase and
ABENDED Sxxx Unnnn processing continues. This message is displayed to an
SECURITY VIOLATION interactive user if the NOTIFY parameter is specified on
the JCL JOB statement, or the JECL /*NOTIFY
The variables in the message text and their meanings
statement is specified.
are:
Application Programmer Response: In the case of a
jobname
JCL ERROR message, check system output for the
The jobname. If apostrophes are imbedded in
actual error message. Correct the indicated error and
the jobname, they are replaced by quotation
resubmit the job. In the case of an ABENDED message,
marks.
check system output for the ABEND code. In the case
jobid The job identifier on the input node. of SECURITY VIOLATION, verify the user id, group id,
and password used, if any.
nnnnnnnn
The input node for this job. This is displayed Detecting Module: HASPHOPE
only if nodename is not the job’s input node.
Routing Code: 7
nodename
Descriptor Code: 4
The node where the job will run.
maxcc The maximum condition code encountered.
$HASP170
Sxxx Unnnn
Explanation:
System and User abend codes.
devname ABORTED
ENDED AT nodename MAXCC maxcc FWD-SPACED
The specified job has ended at nodename. DELETED
BACKSPACED
ENDED AT nodename – JCL ERROR
REPEATED
The specified job has ended at nodename. RESTARTED
Converter/interpreter or initiator phase of job INTERRUPTED
processing could not be completed because of
an error in the JCL.
Output processing on the indicated device has been
ENDED AT nodename – CANCELLED aborted, forward-spaced, deleted, backspaced,
The specified job was canceled by the operator repeated, restarted, or interrupted.
at nodename. In the message text:
ENDED AT nodename – ABENDED Sxxx Unnnn devname
The specified job has ended abnormally at The name of the device.
nodename.
System action: The system action depends on the
[xxx yyy] ENDED AT nodename – cc=dddd specified function:
JES2 stopped the specified job at nodename
by a condition test specified in the COND ABORTED
parameter of the job statement being satisfied An unrecoverable error has occurred on the
by the completion code dddd of the running 3800 printer. Output processing is stopped.
step xxx. If step xxx is a step of a cataloged Job(s) currently active on the device are
procedure, then yyy is the step that called step requeued from their last checkpoint and the
xxx. device drains.
Chapter 5. One-hundreds 77
$HASP175 • $HASP181
Routing Code: 7
an error while attempting to obtain buffers for the printer nnnn The number of defined buffers.
error log or MDR area.
Note: A jobid may precede $HASP183. See “JES2
System action: Output processing to the printer
message format” on page 1.
continues. However, there might be a loss of error log
data or inappropriate error recovery procedures on System action: The job is held.
some devices.
Operator response: Release the job when fewer
Operator response: Use the $P PRT(nnnn) command JES2 devices are active. If the job continues to receive
to stop the printer, then restart it with the $S PRT(nnnn) this message, or if the number of required buffers
command. If the problem persists, notify the system (mmmm) is greater than the number defined (nnnn),
programmer. notify the system programmer.
System programmer response: None. System programmer response: Increase the value of
the limit for the EXTBUF parameter on the BUFDEF
Detecting Module: HASPNUC
initialization statement, or use the PURGE option to
Routing Code: 2,7 cancel the specified job.
Descriptor Code: 4 Detecting Module: HASPHOPE, HASPCNVT
Routing Code: 1,2
$HASP182
Descriptor Code: 4
Explanation:
NO BUFFERS TO DETERMINE IF STD UCS/FCB
$HASP184
Chapter 5. One-hundreds 79
$HASP186
Note: A jobid may precede $HASP186. See “JES2 If devname specifies a punch device, the indicated job
message format” on page 1. requires that the setup of that punch device be altered
to forms = ffff. If devname specifies a printer device, the
System action: JES2 discontinues HARDCPY indicated job requires the setup be altered to forms =
processing on the device for the specified job output ffff, carriage control = cccc, and print train = tttt.
group element ($JOE), and continues to scan for the
next BEST JOE. JES2 will remember that the device Note: Another version of this message follows. Use the
cannot select the specified JOE and will skip that JOE form that corresponds to the $HASP190
for the specified device until the device is restarted, message on your console.
JES2 is restarted or the output group element is
modified through operator commands. In the message text:
If an access violation occurs, and you have DEBUG jobname
SECURITY=YES, JES2 issues this message, and The name of the job.
RACF issues message ICH408I and writes an SMF
TYPE80 (X'50') record which includes LOGSTR devname
information. The LOGSTR identifies the problem as The name of the print or punch device.
either:
fff The forms name.
v JES2 DEVICE WORK SELECTION SCREENING
cccc The carriage control name.
v EXTERNAL WRITER WORK SELECTION
SCREENING tttt The print train name.
v SAPI - DATA SET ACCESS
Note: A jobid may precede $HASP190. See “JES2
Operator response: Notify the system programmer. message format” on page 1.
System programmer response: Select one of the System action: Output processing is halted on the
following actions based on your environment set up: specified device until an appropriate operator response
v If security is intended to act as a work selection is received.
criterion and another device can select the output
Operator response: Verify that the requested setup
group element, no action is required.
has been completed and enter a start ($S) command for
v If the output group element was routed to the wrong the indicated device. If you want to override any or all of
device, modify the output to go to a device on which the setup specifications, do so with the set ($T)
it can be processed using operator commands. command followed by a start ($S) command. Current
activity may be suspended by the restart ($E), interrupt
Chapter 5. One-hundreds 81
$HASP190 • $HASP191
($I), and cancel ($C) commands. In this event, all System action: Output processing is halted on the
intervening set ($T) commands are ignored and the specified device until an appropriate operator response
device setup is the same as before the setup message. is received. For burst mode, if the burster is not
threaded, this message is repeated.
System programmer response: None.
Operator response: Verify that the requested setup
Detecting Module: HASPPRPU
has been completed and enter a start ($S) command for
Routing Code: 7 the indicated 3800 printer device. If you want to override
any or all of the setup specifications, do so with the set
Descriptor Code: 2,4 ($T) command followed by a start ($S) command.
Current activity may be suspended by the restart ($E),
$HASP190 interrupt ($I), and cancel ($C) commands. In this event,
all intervening set commands are ignored, and the
Explanation: device setup is that before the setup message.
jobname SETUP –
System programmer response: None.
prtname – F= ffff – O= name Detecting Module: HASPPRPU, HASPFSSP
– B= Y Routing Code: 7
N
Descriptor Code: 2
Note: JES2 only issues $HASP190 for: HALTED – DATA POSSIBLY LOST
1. channel-attached printers that are defined
with PRINTER(nnnnn) A channel or I/O error has occurred while printing a data
SETUP=HALT,WS=(...F/). set. Printing will not continue until the operator takes
2. non-channel-attached (PSF FSS-driven some action, although during error recovery, JES2 may
printers that are SNA or TCP/IP attached) cause the data set to be printed again.
printers that are defined with In the message text:
PRINTER(nnnnn) SETUP=HALT,WS=(...F/)
jobname
and with the PSF PRINTDEV statement that
The name of the halted job.
includes SETUP= in the PSF PROC. Be
aware that this SEPUP= setting is prtname
application-specific and you need to consult The name of the printer on which the job was
the appropriate user’s guide before setting processing.
this value. For example, see the PSF book
that documents the use of PRINTDEV Note: A jobid may precede $HASP191. See “JES2
SETUP=ALL | NONE | FORMS | BURST to message format” on page 1.
understand which settings will prompt the
$HASP190 message. System action: The printer prtname is halted until the
operator takes some action. The error may have caused
data to be duplicated or lost.
This allows JES2 to stop, issue this message, and wait
until the operator verifies printer changes. Operator response: Use the $S command to restart
the printer if automatic recovery is acceptable. If
In the message text: automatic recovery is not acceptable, use the $B
command to reposition the printer to the top of the page
jobname
in error, or to a page before the page that has the error.
The name of the job.
Then use the $S command to restart the printer. If you
prtname must be absolutely sure that the data set prints
The name of the printer. correctly, use the $E command to reposition the printer
to the beginning of the data set, and then use the $S
ffff The forms name. command to restart the printer.
name The name of the overlay. System programmer response: None.
Note: A jobid may precede $HASP190. See “JES2 Detecting Module: HASPPRPU
message format” on page 1. Routing Code: 7
SWBTUREQ RETRIEVE RC=nn,REASON=nnnn System action: JES2 puts the output in HOLD=SYS
JES2 was processing a scheduler JCL facility status. Recovery processing continues.
SWBTUREQ RETRIEVE request. This form of Operator response: Use the $L command to display
the text includes a return code (RC) and a the status of this job output element identified by
reason code. grpid.joeid1.joeid2. and correct the error. Use the $TO
SWBTUREQ SPLICE RC=nn,REASON=nnnn command to put the output in REL=SYS status, or
JES2 was processing a scheduler JCL facility cancel the job and have the user resubmit it.
SWBTUREQ SPLICE request. This form of the System programmer response: None.
text includes a return code (RC) and a reason
code. Detecting Module: HASPPRPU
Chapter 5. One-hundreds 83
message lists the termination options and precedes the
$HASP098 message.
Operator response: This is only an informational
message; reply to the $HASP098 message with one of
the responses above.
System programmer response: None.
Detecting Module: HASPTERM
Routing Code: 1,2,10
Descriptor Code: 2,7
Chapter 6. Two-hundreds 87
$HASP208 • $HASP210
System action: Automatic logon mode (A=Y) is reset For NOTIFY requests, in the message text:
to A=N.
tt The status byte.
Operator response: Re-initiate the automatic logon
rr The associated reason code if the status byte
(with the $S Rnnnn or $T Rnnnn, A=Y commands) after
is a procedure error (03).
the cause of the failure has been fixed.
ssssssss
Detecting Module: HASPSNA
The associated sense data if the status byte is
Routing Code: 8,10 a procedure error (03).
Descriptor Code: 4 System action: JES2 ends the affected sessions.
Message $HASP210 provides additional information.
$HASP208 Operator response: None.
Explanation: System programmer response: If the termination is
event SCHEDULED FOR luname RC= xx unexpected, examine any VTAM messages related to
the session that terminated.
NSEXIT SCHEDULED FOR luname CLEANUP, xx
Detecting Module: HASPSNA
NSEXIT SCHEDULED FOR luname NOTIFY, Routing Code: 8,10
xxx NOT FOUND System action: JES2 restarts the line (as if a $E
LNE(nnnn) command was entered) resulting in the end
of the SNA session by a close destination (CLSDST).
The specified compaction table was not defined during
JES2 initialization. System programmer response: Examine incoming
In the message text: data buffers on this line to determine if the session
partner is violating SNA protocols.
jobname
The name of the job. Detecting Module: HASPSNA
devname Routing Code: 8,10
The name of the device.
Descriptor Code: 4
xxx The number of the missing compaction table.
$HASP214
Note: A jobid may precede $HASP211. See “JES2
message format” on page 1. Explanation:
LINElna – SIGNON FAILED,
System action: The data is sent to the specified SNA
remote device in un-compacted form.
UNABLE TO INITIATE SAF REQUEST
Operator response: None.
Detecting Module: HASPSNA JES2 was unable to obtain sufficient storage for the
control blocks needed to initiate a security authorization
Routing Code: 7,8 facility (SAF) request to verify the signon of an RJE
terminal.
Descriptor Code: 4
In the message text:
lna The line number.
$HASP212
System action: JES2 stops the remote terminal
Explanation:
signon.
SNA CRITICAL ERROR ON zzzzzzzz
Operator response: Notify the operator of the system
On the identified session, an unrecoverable system trying to sign on that the attempt failed and to try to sign
network architecture (SNA) error occurred in an SNA on later. If the condition persists, notify the system
request parameter list (RPL)-based request or programmer.
response. System programmer response: Determine why there
In the message text: is insufficient storage in the JES2 address space and
zzzzzzzz correct the problem. Failed logon attempt will be
The name of the session. brought to the security administrator’s attention. Contact
the operator when the problem is corrected.
System action: JES2 ends the session. Messages
$HASP094 and $HASP210 provide further information. Detecting Module: HASPSNA, HASPBSC
Chapter 6. Two-hundreds 89
$HASP215 • $HASP219
System action: The RJE signon/logon continues Operator response: Reenter the command. If the
normally. condition persists, notify the system programmer at the
receiving node.
Operator response: The former password remains in
effect. System programmer response: Determine why there
is insufficient storage in the JES2 address space and
Detecting Module: HASPSNA, HASPBSC correct the problem. Notify the operator at the issuing
Routing Code: # node that the command can be reentered.
Routing Code: 1,2,10 applid The VTAM application identifier of the node.
Operator response: Contact the system programmer. System action: The BIND is rejected.
System programmer response: Ensure that the Operator response: Start a qualifying SNA line with
application definitions defined to JES2 on the the $S command and have the other node reenter the
APPL(avvvvvvv), LOGON(n), and N(nnnn) definitions $SN command or enter the $SN command locally to
are the same as those defined to VTAM and all other start networking with applid specified in the message
JES2 NJE nodes in the network. If they are not, correct text.
the definitions in error. Determine if the network
System programmer response: For RC=02, reason
connection is correct, and if not, stop and restart the
1, 2, or 3, this line cannot be used for SNA/NJE line
network connection.
dedication. Another line must be used. For RC=02,
Detecting Module: HASPSNA reason 4, turn off the password to this line or use
another line. For RC=02, reason 5, dedicate the line on
Routing Code: 1,2,8,10 the APPL definition instead of the NODE definition. For
Descriptor Code: 4 RC=03, ensure that the application names defined to
JES2 NJE with the APPL(avvvvvvv) or N(nnnn)
initialization parameters are the same as those defined
$HASP221 to VTAM and all other JES2 NJE nodes in the network.
Explanation: If not, correct the APPL(avvvvvvv) or N(nnnn) statement
in error and retry starting networking to the node.
Detecting Module: HASPSNA
Chapter 6. Two-hundreds 91
$HASP222 • $HASP225
Routing Code: 8,10 condition exists. If the network path manager is not
available, a restart of JES2 is required to start the
Descriptor Code: 4
connection.
System programmer response: For resource
$HASP222
shortages, you may need to increase the value for
Explanation: NJEDEF LINENUM= or TPDEF SNABUF=LIMIT=. For
XEQ DRAINING secure signon failures, contact the security administrator
to ensure that the correct SESSKEY was provided for
JES2 issues this message in response to a $P XEQ the NJE.node1.node2 profile in the APPCLU class, and
command. that the APPCLU class is active.
System action: JES2 selects no more jobs for Detecting Module: HASPSNA, HASPNPM
execution on this member. This message is Routing Code: 1,2,8,10
non-deletable.
Descriptor Code: 4
Operator response: To resume job selection by this
member, issue $S XEQ.
$HASP224
System programmer response: None
Explanation:
Detecting Module: HASPCOMM INVALID COMPACTION SCB
Routing Code: 8,10
RECEIVED FROM applid
Descriptor Code: 4
A compaction string control byte has been found in a
$HASP223 data record received on the identified NJE session. No
compaction table currently exists for this session.
Explanation: In the message text:
NJE UNABLE TO SIGN ON TO nodename,reason
applid The VTAM application identifier of the node.
The NJE signon to node nodename was unable to be System action: The line is restarted (as if a $E
processed. Valid reasons include: LINE(nnnn) command was entered) resulting in the SNA
LINE IS DRAINED application-to-application session being stopped by a
The line being used is drained and could not be CLSDST from the primary node.
started. System programmer response: Examine incoming
LINE IS BUSY data buffers on this line to determine if the session
The line being used is already in session. partner is violating JES2 NJE protocols.
session partner is not violating JES2 NJE protocols. IS ALREADY ON MEMBER memname
Detecting Module: HASPSNA
The operator has entered a $S command for the
Routing Code: 8,10 indicated line or a range of lines that included the
identified line. Because LINE=nnnn was specified on the
Descriptor Code: 4
RMT(nnnn) initialization statement, a $S LINE(nnnn)
command implies a start for RMT(nnnn). RMTnnnn is
$HASP226 already logged on to member memname in the
message.
Explanation:
In the message text:
INVALID STREAM ALLOCATION REQUEST
lna The number of the line.
RECEIVED FROM applid
nnnn The number of the remote workstation.
Chapter 6. Two-hundreds 93
$HASP230 • $HASP232
System action: JES2 returns the command to the Note: A coupling facility is always considered
issuer and processing continues. volatile unless you have taken measures to
protect against the loss of power to that
Operator response: Reissue the command with a
coupling facility. See ES/9000 and ES/3090
valid text length.
PR/SM Planning Guide for a description of
Detecting Module: HASPRTAM, HASPCON how to monitor the volatility of coupling
facilities.
Routing Code: –
OPERATOR REQUEST
Descriptor Code: – JES2 entered this reconfiguration following your
request to begin a checkpoint reconfiguration with a
$HASP233 $T CKPTDEF,RECONFIG=Yes command. (The
blank between $T and CKPTDEF is optional.)
Explanation:
REASON FOR JES2 CHECKPOINT System action: JES2 checkpoint reconfiguration
processing continues, and JES2 (re)issues message
RECONFIGURATION IS $HASP285 with either STARTED or
RE-SYNCHRONIZING.
CKPTn I/O ERROR(S) ON m MEMBER(S)
COUPLING FACILITY HAS BECOME VOLATILE $HASP233 is issued to a console by the driving
OPERATOR REQUEST member and also issued to HRDCPY by non-driving
members for diagnostic purposes.
This message indicates the reason JES2 is performing
Operator response: Monitor subsequent checkpoint
this checkpoint reconfiguration thereby determining the
reconfiguration messages and follow any further
available reconfiguration processing options. If members
instructions as appropriate. Follow-on checkpoint
simultaneously enter a reconfiguration for different
reconfiguration messages will inform you of ongoing
reasons, JES2 determines the reason displayed in this
status.
message using the following order of precedence:
1. I/O on CKPT1 System programmer response: None.
2. I/O on CKPT2
Detecting Module: HASPCKDS
3. Coupling facility becomes volatile
4. Operator request Routing Code: 1,2,10
CKPTn I/O ERROR(S) ON m MEMBERS Descriptor Code: 2,7
JES2 initiated a checkpoint reconfiguration because
of I/O error(s) on a coupling facility structure or data
set on m members. $HASP275 (issued by one or $HASP234
more members) accompanies this message and Explanation:
provides the specific member and reason code. MEMBER member-name
($HASP275 might be displayed on a different
console based on your installation’s MSCOPE UNABLE TO RECONFIGURE AS REQUESTED
specification on the CONSOLxx parmlib member.
See z/OS MVS Initialization and Tuning Guide for a BY THE DRIVING MEMBER
description of the MSCOPE parameter. See z/OS
JES2 Initialization and Tuning Guide for a complete
The driving member is able to perform a requested
explanation of checkpoint reconfiguration
reconfiguration action; however, member member-name
processing and examples of various checkpoint
(a non-driving member) is unable to perform the same
reconfiguration dialogs.
action. A specific reason for the non-driving member’s
In the message text: inability to perform the action appeared in a previous
message (such as $HASP295, $HASP296, $HASP297,
n Either 1 or 2 indicating CKPT1 or CKPT2, $HASP414, $HASP424, $HASP429, $HASP453,
respectively. $HASP536, $HASP542, and $HASP581). For example,
m The number of members encountering I/O the checkpoint may have been forwarded to a data set
errors on CKPTn when JES2 first on a volume that is not mounted on the system where
determined the reason for this checkpoint the non-driving member resides. In this case, you
reconfiguration. receive $HASP424 followed by $HASP234.
COUPLING FACILITY HAS BECOME VOLATILE System action: This message is issued by both the
The coupling facility on which a checkpoint resides non-driving member that encountered the error and the
became volatile and JES2 entered a checkpoint driving member.
reconfiguration as a result of processing based on v On the non-driving member, the message is written to
your CKPTDEF VOLATILE= specification. HRDCPY only.
Chapter 6. Two-hundreds 95
$HASP235 • $HASP237
This message informs the operator that n members are Descriptor Code: 4
unable to reconfigure. This message is preceded by n
$HASP234 messages. $HASP237
The optional text, OPERATOR ASSISTANCE
REQUESTED, is only displayed when there was no Explanation:
prior operator involvement in this checkpoint CKPTn strname
reconfiguration because CKPTDEF OPVERIFY=NO is NEWCKPTn
in effect.
In the message text:
IS ON A VOLATILE COUPLING FACILITY
n The number of members that encountered I/O
errors on CKPTn when the $HASP235
message was first issued for this checkpoint (1)
reconfiguration. VALID RESPONSES ARE:
System action: This message is followed by
$HASP271 or $HASP273 and the corresponding
Notes:
$HASP272 ENTER RESPONSE message. This
message is highlighted and not deleted until you reply 1 ‘CONT’ - PROCEED WITH ASSIGNMENT
to $HASP272. ‘CANCEL’- EXIT FROM RECONFIGURATION
‘TERM’ - TERMINATE MEMBERS WITH I/O
Operator response: Search each member’s SYSLOG
ERROR ON CKPTn
for the n $HASP234 messages. This search is
‘DELETE ’- DISCONTINUE USING CKPTn
unnecessary if you were aware of the previous error
CKPTDEF (NO OPERANDS) - DISPLAY
messages.
MODIFIABLE SPECIFICATIONS
System programmer response: Wait for follow-on
Chapter 6. Two-hundreds 97
$HASP238
CKPTDEF (NO OPERANDS) JES2 assumes you specified a checkpoint and attempts
If you reply with a CKPTDEF statement with no to process it. If the specification is null, JES issues the
operands, JES2 issues message $HASP829 $HASP282/$HASP272 message pair to request your
displaying the current settings of the CKPTDEF checkpoint specification. Otherwise, JES2 issues the
parameters that can be modified during a $HASP273/$HASP272 message pair to request
dialog. $HASP289 is highlighted and is deleted confirmation of the checkpoint you specified.
after you reply to the $HASP237/$HASP272
System programmer response: If you are not familiar
message pair that JES2 reissues.
with the reconfiguration dialog process, see z/OS JES2
Initialization and Tuning Guide for a detailed discussion.
Note: If, during a reconfiguration dialog, you
need to see the complete set of Detecting Module: HASPCKDS
CKPTDEF specifications, issue the
Routing Code: 1,2,10
$D CKPTDEF command. If you only
need to see specific parameter settings Descriptor Code: 2,7
(for example, CKPT1 and CKPT2),
issue the $D CKPTDEF,CKPT1,CKPT2
command. JES2 responds by issuing $HASP238
message $HASP829 showing only the Explanation:
CKPT1 and CKPT2 specifications. RMTxxxx ROUTECDE=yyyy – –
CKPTDEF (WITH OPERANDS)
If you want to change a checkpoint CONFLICTS WITH RMTyyyy ROUTECDE= zzzz
specification, reply with a CKPTDEF statement
with one or more of the operands listed below The JES2 initialization data set specified (using the
(for example, CKPTDEF CKPT1=...). JES2 ROUTECDE= parameter on RMT(nnnn) statement) that
scans the CKPTDEF statement and a remote is to be pooled to a remote that, in turn, is to
immediately resets the indicated parameters to be pooled to a second remote. JES2 does not allow
the values specified. Message $HASP829 is multiple levels of remote redirection. The initialization
issued displaying the current settings of the statement that should be corrected is either:
modifiable parameters on the CKPTDEF RMTxxxx ROUTECDE=yyyy
initialization statement. $HASP289 is -- or --
highlighted and is deleted after you reply to the RMTyyyy ROUTECDE=zzzz
next $HASP272 message that JES2 issues.
System action: JES2 issues $HASP441 to query the
The CKPTDEF operands that can be modified operator as to whether JES2 is allowed to continue
are: initialization with the incorrect RMT(nnnn) definition.
v CKPT1=
Operator response: Contact your system
programmer. Reply ‘N’ to the $HASP441 message if
{(DSName=dsname,VOLser=volser)
your remote pooling definitions are important to your
(STRNAME=strname)} –
system, otherwise reply ‘Y’.
if not currently in use
v CKPT2= System programmer response: Correct the remote
definitions in the JES2 initialization data set by either:
{(DSName=dsname,VOLser=volser) v Modifying the ROUTECDE= parameter on the
(STRNAME=strname)} – definition for RMTxxxx (for example, to
if not currently in use ROUTECDE=zzzz), or
v NEWCKPT1=
v Modifying the ROUTECDE= parameter on the
definition for RMTyyyy (for example, to
{(DSName=dsname,VOLser=volser) ROUTECDE=yyyy).
(STRNAME=strname)}
v NEWCKPT2=
Your requirements for which remotes are to be pooled
will determine which RMT(nnnn) statement(s) you need
{(DSName=dsname,VOLser=volser) to correct.
(STRNAME=strname)}
v DUPLEX={ON|OFF} Detecting Module: HASPIRRE
Routing Code: 1,2,10
For an explanation of each operand, see the
description of the CKPTDEF initialization Descriptor Code: 4
statement in z/OS JES2 Initialization and
Tuning Reference.
Chapter 6. Two-hundreds 99
$HASP243 • $HASP245
Operator response: If TIME LIMIT appears in the 1. For cause 1, correct the clock values on the system
message text, clear the hardware reserve on the in error with the older clock value. IPL to set the
checkpoint device by bringing down the system holding TOD clock and perform a single system warm start.
the lock. Clear 100 percent spool utilization by canceling 2. For cause 2, evaluate the $HASP094 explanation.
input jobs or jobs that could be easily rerun, or add Consider evaluating the disk surface for bad
spool volumes to the configuration. cylinders in the SYS1.HASPACE data set or
If MESSAGE LIMIT appears in the message text, consider possible spool contamination (logical error
determine which system in the MAS is sending the in processing on spool).
messages. Determine if that system is looping or if 3. For cause 3, see the $Q02 explanation under
there is an application that is sending many notifications $HASP095. To ensure a clean recovery from a
to the system that issued this message. $Q02 abend, perform an all-member warm start of
JES2.
If MEMBER IN CHECKPOINT DIALOG appears in the
message text, answer the console prompts for the Detecting Module: HASPRTAM
checkpoint reconfiguration dialog for that member.
Routing Code: 8,10
If ERROR ON SPOOL appears in the message text, the
Descriptor Code: 4
old messages are discarded and a new remote
message data set will be created that contains any new
messages. $HASP247
Detecting Module: HASPRTAM Explanation:
ERROR ON SPOOL AT nodename
Routing Code: 10
LINExx
Descriptor Code: 4 xx
– MESSAGE TRUNCATED
$HASP246
Explanation: If SPOOL occurs in the message text:
DISASTROUS ERROR WRITING An error occurred while spooling a multi-line write to
READING operator (WTO) message at the indicated node. This
message appears as the last line of the multi-line WTO
SPOOL MESSAGES at the node for which the message was destined.
REMOTE If LINExx occurs in the message text:
The value of the DELAY parameter on the NJEDEF
A disastrous error occurred while JES2 was reading or initialization statement was exceeded while receiving a
writing commands and messages to or from the spool multi-line WTO.
volumes or a remote console. The system has In the message text:
discarded commands and messages.
xx The receiving line.
Possible causes of this problem are any of the
following: nodename
v The time of day (TOD) clock setting for one of the The name of the node.
systems is out of synchronization relative to one or System action: Processing continues.
more of the other systems. The synchronization
tolerance is specified by the SYNCTOL parameter on Operator response: Inform the operator of the node
the MASDEF initialization statement. that sent the message about the truncated message.
v Physical I/O errors on the spool volumes may have Detecting Module: HASPRTAM
occurred if the system has issued message
$HASP094. See the explanation of that message. Routing Code: 8,10
v JES2 ended with a $Q02 abend and was then Descriptor Code: 4
restarted with a hot start.
System action: Processing continues. $HASP248
Operator response: Notify the system programmer. Explanation:
The system may issue message $HASP096 or MESSAGES DISCARDED –
$HASP094.
System programmer response: If JES2 has issued
an associated $HASP096 message or a $HASP094
message, see the explanation of that message for more
information. Do the following:
bbbb The bin identifier, or 0000. While processing a dynamic allocation error on member
member, JES2 issued a $GETWORK macro to obtain
cccc The cylinder identifier.
storage to contain formatted text for display by message
hhhh The head identifier. $HASP581. The $GETWORK failed because there is
insufficient storage in the JES2 address space.
Note: This message appears during JES2 initialization
System action: JES2 issues the $HASP581 message
if the number of tracks allocated to the spool
without the formatted text.
extent results in a partial track group. The partial
track group is removed. Operator response: Notify the system programmer.
System action: JES2 attempts recovery, and this System programmer response: Determine why there
message appears, when JES2 purges the job or data is insufficient storage in the JES2 address space and
set associated with the track group and at future JES2 correct the error.
warm starts.
Detecting Module: HASPNUC
Operator response: Notify the system programmer.
Routing Code: 1,2,10
System programmer response: If the recovery
Descriptor Code: 4
attempt was not successful, contact your hardware
support representative.
Detecting Module: HASPSPOL
Routing Code: 10
Descriptor Code: –
delayed member has been waiting for at least 15 noted here. Specific actions are also provided for each
seconds to: action-code and action-text.
v Detect an XCF user-state update by the causing General Approach for All Action Codes: Before JES2
member. (The user-state information is for the JES can continue with the checkpoint reconfiguration, you
XCF group name defined by the XCFGRPNM= must first resolve any outstanding sysplex partition
parameter on the MASDEF initialization statement.) problems.
v Receive a JES XCF application message from the
If the $HASP257 message(s) persists, you must issue
causing (driving) member
$PJES2,ABEND followed by $PJES2,ABEND,FORCE
v Receive a JES XCF acknowledgment message from to remove the problem member(s) from the MAS and
the causing (non-driving) member. wait for the reconfiguration to end before restarting the
failed members. To determine which member is actually
In the message text: causing the problem, consider:
delayed-member-name 1. If the driving member is waiting for one (or more)
The member waiting for an action to occur on non-driving members, and all the other non-driving
another member members are waiting on the driving member, then
the member(s) for which the driving member is
causing-member-name waiting is likely the cause of the delay.
The member that has not yet performed or
informed the delayed-member-name of 2. If the driving member has not issued $HASP257,
completion of an expected action. and all the other non-driving members issued
$HASP257 indicating a delay, then the member
causing the delay is likely the driving member.
Probable causes for the delay to perform the necessary
action by the causing-member-name are: If you can isolate the most likely member(s) causing the
1. More than 15 seconds might be required for JES2 to delay:
format a large checkpoint data set. 1. Terminate the member(s). (You cannot issue
2. The operator stopped the MVS system on which the $PJES2,ABEND,FORCE unless you have first
causing member resides. attempted to terminate the member with the
3. The causing member is in termination processing. $PJES2,ABEND command.)
4. The causing member is a candidate for partitioning
or is being partitioned out of the sysplex. 2. Try to not terminate the driving member unless
5. JES2 is in a loop or hung or some other necessary. It holds the latest (most current) copy of
non-productive state. the checkpoint data. However, terminate the driving
6. The waiting member has not yet received an member before terminating all non-driving members.
expected message or acknowledgment from the
causing member. JES2 might not have issued, or These recommendations require that you have an
JES XCF might not have delivered, an expected overall view of the status of the MAS. Obtain this overall
application or acknowledgment message. view from message $HASP255 which identifies the
7. The delayed member has not yet detected an driving member and the set of $HASP254 and
expected XCF user state update by the causing $HASP257 messages from all members. You can use a
member. single command to display the set of $HASP257
messages if the CONDEF CONCHAR= is defined as
For all causes above, the delay can be temporary and the same character on every JES2 member of the MAS.
reconfiguration processing continues if the respective For example, if CONCHAR=$ is specified on every
activity completes. If temporary, consider this an member, issue the MVS command
informational message for those conditions. D R,L,CN=(ALL),MSG=$HASP257.
For causes e, f, and g, one or more members may have The action-code and corresponding action-text are:
caused reconfiguration processing to not proceed. Code Text
These delays can be permanent.
1 causing-member-name TO INDICATE
System action: In general, the JES2 checkpoint RECONFIGURATION STARTING
reconfiguration is delayed until the expected XCF user
state update is detected or JES XCF application or Explanation: The causing member has not
acknowledgment message is received. If the delaying updated its XCF user-state information to
member eventually responds or fails, the $HASP257 indicate it has started checkpoint
message is deleted and processing continues. Specific reconfiguration processing.
system actions are provided for each action-code and System Action: If the cause is temporary,
action-text. processing continues when the reason for
Operator response: There are certain general actions delay is processed.
you might take for all action-codes and action-texts are
System programmer response: None. v The lock is in transition and is currently held by MVS.
If this state persists, there may be a XCF signalling
Detecting Module: HASCSIRQ problem or a system may have failed.
v The lock cannot be obtained because a system member memname has control of the software lock on
managed process is active for the structure. the checkpoint data set and has not relinquished that
control.
In the message text: In the message text:
volser The volume identifier. memname
The alphameric identifier of the failed member
member_name that is holding the software lock on the
The JES2 member that holds the checkpoint checkpoint data set. If the member undergoing
lock. initialization has failed before a member id is
SYSTEM assigned, memname is INITIALIZATION.
The MVS system temporarily holds the lock System action: JES2 cannot continue processing until
after it has been relinquished by the last JES2 it has exclusive control of the software lock on the
member to update the checkpoint. checkpoint data set. This message is repeated
System action: JES2 issues this message every time approximately every 30 seconds until memname
the warning interval specified on the LOCKOUT relinquishes control of the software lock on the
parameter expires until the read operation completes. checkpoint data set. If the failed member memname
participated in the automatic restart function (indicated
Operator response: Ensure that other systems in the by AUTOEMEM=ON on its MASDEF initialization
MAS configuration are operational. If the primary statement), and another active JES2 member in the
checkpoint is on DASD and the other system is down, it MAS performs restart functions for members on failed
is probably holding a RESERVE on the JES2 MVS systems (indicated by RESTART=YES on its
checkpoint data set. If the failed system cannot be MASDEF initialization statement), then the active JES2
restarted, the RESERVE must be cleared by pressing member will recover the software lock on the checkpoint
SYSTEM RESET on the failed system. After pressing data set.
SYSTEM RESET, message $HASP264 might be
issued. Use of the JES2 $E CKPTLOCK command will Operator response: Use the $D MASDEF command
not clear the reserve when this message is issued with to show all the parameters in the MAS and their current
a VOLSER. definitions.
v If memname has failed and the automatic restart
If the primary checkpoint data set resides on a coupling
function is not active (AUTOEMEM=OFF on its
facility structure, wait until the software lock is freed. If
MASDEF initialization statement), then enter a
the list member is not operational, then the JES2 $E
$E CKPTLOCK,HELDBY=memname command to
CKPTLOCK command can be used to steal the lock. If
remove control of the software lock on the checkpoint
LOCK HELD BY SYSTEM is displayed, there may be a
data set from memname.
problem with XCF signalling or a system has failed and
not been partitioned out of the SYSPLEX. Check for v If memname has failed with the automatic restart
outstanding WTORs that have additional information. If function active (AUTOEMEM=ON on its MASDEF
a SYSTEM MANAGED PROCESS ACTIVE indication initialization statement), and another active member
has not cleared, you should determine the state of the has an active automatic restart function, with that
active process and possibly cancel it using the SETXCF member performing restart functions for members on
command. a failed MVS system (indicated by RESTART=YES
on the MASDEF initialization statement display), then
Examine other members of the MAS for a $HASP9207 the member will recover the software lock on the
message. A member that has issued the $HASP9207 checkpoint data set.
message is the cause of this message. Perform
v If memname has failed and the automatic restart
diagnostics on the member issuing the $HASP9207
function is active (AUTOEMEM=ON on its MASDEF
message to resolve the problem.
initialization statement) on memname, and no other
Detecting Module: HASPCKDS member is active, enter a
$E CKPTLOCK,HELDBY=memname command to
Routing Code: 1,2,10
remove control of the software lock on the checkpoint
Descriptor Code: 4 data set from memname.
See the description of the $E CKPTLOCK,HELDBY=
$HASP264 command in z/OS JES2 Commands.
Explanation:
Examine other members of the MAS for a $HASP9207
WAITING FOR RELEASE OF JES2 CKPT LOCK BY memname message. A member that has issued the $HASP9207
message is the cause of this message. Perform
JES2 has successfully reserved the software lock on
diagnostics on the member issuing the $HASP9207
the checkpoint data set. However, it has determined (by
message to resolve the problem.
examining the checkpoint data set lock record) that
– CKPT DUMP IN PROGRESS System action: JES2 prompts the operator for an
alternative reconfiguration action.
JES2 has detected a major error during I/O processing Operator response: Either fix the allocation problem
to the checkpoint data set. JES2 issues a dump of the and then again request that CKPT1 be suspended, or
checkpoint information in virtual storage. select an alternative reconfiguration action.
In the message text:
Detecting Module: HASPCKDS
cde The error code.
Routing Code: 1,2,10
System action: JES2 processing stops.
Descriptor Code: 4
Operator response: Notify the system programmer.
System programmer response: Use the checkpoint $HASP271
dump and the explanation of the displayed error code
under $HASP095 to correct the problem. Explanation:
CHECKPOINT RECONFIGURATION OPTIONS
Detecting Module: HASPCKPT
Routing Code: 1,2,10 VALID RESPONSES ARE:
CKPTDEF (WITH OPERANDS) message. The text of the preceding message can be
If you want to change a checkpoint obtained from MVS by using the D R,L command or, if
specification, reply with a CKPTDEF statement the long form of the $HASP272 message is issued, the
with one or more of the operands listed below MVS D R,MSG=$HASPxxx command that is displayed
(for example, CKPTDEF CKPT1=...). JES2 in the message.
scans the CKPTDEF statement and IBM suggests:
immediately resets the indicated parameters to v If the D R,MSG=id response includes ″NOARMF″,
the values specified. Message $HASP829 is then turn on ARMF by issuing the following
issued displaying the current settings of the command: K M,ARMF=Y This allows the display of
modifiable parameters on the CKPTDEF future action messages. Also, you should update your
initialization statement. $HASP289 is CONSOLxx parmlib member to set on ARMF.
highlighted and is deleted after you reply to the
v Reply with ″CKPTDEF″. This if frequently a valid
next $HASP271/$HASP272 message pair that
option that doesn’t change anything. However, if it is
JES2 reissues.
not a valid reply, JES2 will issue an error message
The CKPTDEF operands that can be modified and then reissue the original message.
are:
System action: JES2 waits for the operator’s reply.
v CKPT1=
Operator response: The information needed to reply
{(DSName=dsname,VOLser=volser) to the HASP272 message is contained in the preceding
(STRNAME=strname)} – message. The text of the preceding message can be
if not currently in use obtained from MVS by using the D R,L command or, if
v CKPT2= the long form of the HASP272 message is issued, the
MVS D R,MSG=$HASPxxx command that is displayed
{(DSName=dsname,VOLser=volser) in the message.
(STRNAME=strname)} –
Detecting Module: HASPCKDS
if not currently in use
v NEWCKPT1= Routing Code: 1,2,10
Descriptor Code: 2,7
{(DSName=dsname,VOLser=volser)
(STRNAME=strname)}
v NEWCKPT2= $HASP273
Explanation:
{(DSName=dsname,VOLser=volser)
JES2 CKPTn DATA SET WILL BE ASSIGNED TO
(STRNAME=strname)}
v DUPLEX={ON|OFF}
dsname ON VOLUME volser
For an explanation of each operand, see the NEWCKPTn STRNAME strname
description of the CKPTDEF initialization
statement in z/OS JES2 Initialization and
Tuning Reference. (1)
System programmer response: If you are not familiar VALID RESPONSES ARE:
with the reconfiguration dialog process, see z/OS JES2
Initialization and Tuning Guide for a detailed discussion.
Notes:
Detecting Module: HASPCKDS
1 ‘CONT’ – PROCEED WITH ASSIGNMENT
Routing Code: 1,2,10 {‘CANCEL’ – EXIT FROM
RECONFIGURATION}
Descriptor Code: 2,7
{‘TERM’ – TERMINATE MEMBERS WITH I/O
ERROR ON CKPTn}
$HASP272 [‘DELETE’ – DISCONTINUE USING CKPTn]
CKPTDEF (NO OPERANDS) – DISPLAY
Explanation:
MODIFIABLE SPECIFICATIONS
ENTER RESPONSE (ISSUE D R, MSG=$HASPxxx FOR RELATED MSG) CKPTDEF (WITH OPERANDS) – ALTER
MODIFIABLE SPECIFICATIONS
JES2 issues this message when operator input is
needed to determine the correct action for JES2 to take
If NEWCKPTn is displayed, JES2 is about to replace
and the explanation cannot be placed in a WTOR. JES2
the data set name and volume serial or the coupling
issues a highlighted message (WTO) followed by the
facility structure name of the specified checkpoint data
$HASP272 WTOR. The information needed to reply to
set (CKPT1 or CKPT2) with the specifications assigned
the $HASP272 message is contained in the preceding
to NEWCKPTn. JES2 requests the operator to verify or appears as an option, JES2 is processing an
change the action to be taken. If the specifications are I/O error for the CKPTn as indicated by
not what you require, change them by replying to the message $HASP233.
$HASP272 message with the CKPTDEF (WITH
A reply of TERM causes all members
OPERANDS) option, or select a new action.
experiencing an I/O error on CKPTn to end
abnormally with a $Kxx error code. The reason
If NEWCKPTn is not displayed, the specified checkpoint
code on the $HASP275 message for each
data set (CKPT1 or CKPT2) is being placed into
member is the $HASP095 error code for each
service. JES2 is about to assign the checkpoint data set
member. Depending on the $Kxx reason code
to data set name dsname on volume volser or coupling
given in the $HASP275 message and the
facility structure name strname, based on an explicit
subsequent $HASP095 error code, the TERM
request (option 7 or 8) given to the
response may require an IPL or an all-member
$HASP271/$HASP272 message pair. JES2 requests
warm start. Although JES2 attempts to create
the operator to verify or change the action to be taken.
an emergency backup copy of this data set
If the specifications are not what you require, change
before ending (see message $HASP279), it
them by replying to the $HASP272 message with the
may not be successful.
CKPTDEF (WITH OPERANDS) option, or select a new
action. DELETE
JES2 reformats the other CKPTn data set (for
Not all of the options appear for a given instance of this example, CKPT2, if CKPT1 is displayed) and
message. then deallocates the CKPTn data set specified
in this message ($HASP273). JES2 continues
In the message text: processing with only one checkpoint data set in
use.
n The number of the checkpoint or new
checkpoint data set (either 1 or 2). Notes:
1. The DELETE option appears only if there is
dsname
an I/O error on this member and both
The name of the new checkpoint data set.
checkpoint data sets are in use
volser The volume identifier. (INUSE=YES). For example, if there is an
error on CKPT1 and CKPT2 is not active,
strname
there is no DELETE option because that
The name of the coupling facility structure.
would leave no active checkpoint data set.
System action: JES2 issues message $HASP272 and 2. If your JES2 configuration is running in
waits for an operator response. DUPLEX mode and any member has
Operator response: Determine the action you want specified DUPLEX=OFF, JES2 does not
taken and then reply to $HASP272 with one of the delete the CKPT1 data set unless it can
options described below. Not all of the options appear allocate the DUPLEX data set (CKPT2) on
for a given instance of this message. every member. If allocation is successful,
JES2 issues message $HASP280
Option Meaning indicating the CKPT2 data set is in use and
then suspends the use of CKPT1. If
CONT JES2 completes the checkpoint assignment.
allocation is not successful on this member,
CANCEL JES2 issues the $HASP278/$HASP272
JES2 ends from the reconfiguration and message pair. If allocation is not successful
continues processing. If you previously replied on a non-driving member(s), JES2 issues
CKPTDEF to change CKPTn or NEWCKPTn, message $HASP234 and $HASP235.
those changes are lost.
CKPTDEF
If you reply with a CKPTDEF statement with no
Note: CANCEL appears as an option only if
operands, JES2 issues message $HASP829
this reconfiguration is not for an I/O
displaying the current settings of the CKPTDEF
error.
parameters that can be modified during a
dialog. $HASP289 is highlighted and is deleted
Attention: If the TERM option appears and after you reply to the $HASP273/$HASP272
you inadvertently reply CANCEL, JES2 will message pair that JES2 reissues.
treat CANCEL as a synonym for TERM and
terminate members.
Note: If, during a reconfiguration dialog, you
TERM A reply of TERM is not recommended. If TERM need to see the complete set of
CKPTDEF specifications, issue the
$D CKPTDEF command. If you only
For an explanation of each operand, see the An I/O error has occurred on the specified checkpoint
description of the CKPTDEF initialization data set (CKPT1 or CKPT2).
statement in z/OS JES2 Initialization and In the message text:
Tuning Reference.
member-name
JES2 assumes you specified a checkpoint and attempts The name of the member experiencing the I/O
to process it. If the specification is null, JES issues the error.
$HASP282/$HASP272 message pair to request your n The number of the checkpoint data set. The
checkpoint specification. Otherwise, JES2 reissues the number is either 1 or 2.
$HASP273/$HASP272 message pair to request
confirmation of the checkpoint you specified. rsnc A code identifying the cause of the error. The
$HASP275 reason codes correspond to the
System programmer response: If you are not familiar $Knn error codes for $HASP095. See the
with the reconfiguration dialog process, see z/OS JES2 $HASP095 message for their descriptions.
Initialization and Tuning Guide for a detailed discussion.
System action: JES2 enters a checkpoint
Detecting Module: HASPCKDS reconfiguration, issuing message $HASP255.
Routing Code: 1,2,10 Operator response: Notify the system programmer.
xxx Either YES or NO, indicating whether the data $HASP536 is issued before entering dialog
set is currently in use. v STRUCTURE DOES NOT SUPPORT NAMED
REFERENCES
reason text is one of the following:
$HASP536 is issued before entering dialog
v BOTH CKPT1 AND CKPT2 ARE INUSE=NO
v STRUCTURE DOES NOT HAVE ENOUGH LIST
$HASP472 is issued before entering dialog HEADERS
v CONNECT FOR CKPTn FAILED RC=xxxxxxxx $HASP536 is issued before entering dialog
RSN=xxxxxxxx
v STRUCTURE DOES NOT HAVE ENOUGH LOCK
$HASP536 is issued before entering dialog ENTRIES
v OBTAIN FOR CKPTn FAILED RC=xxxxxxxx $HASP536 is issued before entering dialog
$HASP414 is issued before entering dialog v STRUCTURE NOT ALREADY USED
v VOLUME FOR CKPTn NOT MOUNTED $HASP536 is issued before entering dialog
$HASP424 is issued before entering dialog v STRUCTURE IS NOT LARGE ENOUGH
v ALLOCATE FOR CKPTn FAILED RC=xxxxxxxx $HASP536 is issued before entering dialog
S99ERROR=xxxx S99INFO=xxxx
System action: JES2 issues message $HASP272 and
$HASP581 is issued before entering dialog
waits for an operator response. If you reply ‘CKPT1’ or
v CKPTn FAILED ALLOCATION ‘CKPT2’ to $HASP272, JES2 reissues message
There is no related error message $HASP277 with the updated checkpoint specification.
v DATA SET FOR CKPTn HAS NO EXTENTS Operator response: Determine where the checkpoint
$HASP453 is issued before entering dialog data set was located when JES2 was last active. If the
v TRACK SIZE TOO SMALL FOR CKPTn DATA SET checkpoint specification displayed is not correct, reply
CKPT1 or CKPT2 to specify the correct data set names.
$HASP295 is issued before entering dialog When message $HASP277 displays the correct values,
v CKPTn DATA SET TOO SMALL reply ‘CONT’ to attempt to allocate the correct data
$HASP296 is issued before entering dialog sets.
v CKPTn VOLUME NOT SHARED If the values for CKPT1 and CKPT2 are the same as
$HASP449 is issued before entering dialog when JES2 was last active, and you do not want to
change those specifications, then resolve the problem
v OF ABEND PROCESSING CKPTn DATA SET
as described in the reason text and any preceding
$HASP095 is issued before entering dialog messages. When you resolve the problem, reply ‘CONT’
v OF I/O ERROR READING CKPTn to attempt to complete initialization processing.
$HASP290 or $HASP291 is issued before entering If the values listed are the ones JES2 was last using
dialog and the error listed cannot be resolved, bypass the
v OF I/O ERROR LOCKING CKPTn checkpoint information saved in the checkpoint data
$HASP290 is issued before entering dialog set(s) by replying ‘RECONFIG’ causing JES2 to issue
message $HASP283. Respond to $HASP283 to verify
v OF I/O ERROR RESERVING CKPTn
the checkpoint specifications you want JES2 to use.
$HASP291 is issued before entering dialog
A common cause for this message is that a checkpoint
v CKPTn FAILED VALIDATION PROCESSING
volume or structure is lost while JES2 is not active. In
$HASP434 is issued before entering dialog this case, you can change the specification for that data
v CKPTn STRUCTURE CONTAINS NO DATA set to INUSE=NO (either in the initialization data set or
$HASP555 is issued before entering dialog in response to this message). This message is issued
with VOLUME FOR CKPTn NOT MOUNTED. If the
v OPERATOR DID NOT ALLOW FORWARDING operator again sets the data set to INUSE=NO and
A reply of ‘N’ was given to $HASP457 before entering replies ‘CONT’, JES2 reissues this message. This
the dialog message will be continually re-issued because the
v OPERATOR REPLIED ‘N’ TO $HASP417 MESSAGE saved information says that the data set is INUSE=YES.
Without specifying ‘RECONFIG’ as a start option or in
$HASP416 and HASP417 are issued before entering
response to this message, JES2 will use the saved
dialog
information rather than what the operator specified. To
v STRUCTURE DOES NOT HAVE A DISP OF KEEP start JES2 in this situation, you must reply ‘RECONFIG’
$HASP536 is issued before entering dialog or restart JES2 by specifying
v STRUCTURE DATA SIZE IS INCORRECT S JES2,PARM=RECONFIG.
$HASP536 is issued before entering dialog This problem can also occur if you rename a JES2
v STRUCTURE IS NOT A LIST checkpoint data set, you change the VOLSER of the
volume containing the checkpoint, or you move the n The number of the checkpoint or new
checkpoint data set without using a JES2 checkpoint checkpoint data set. The number is either 1 or
reconfiguration to do so. Therefore, to avoid this 2.
problem, IBM suggests that you always use a JES2
dsname
checkpoint reconfiguration to move or alter the name of
The name of the checkpoint data set.
a checkpoint data set.
volser The volume identifier.
If you do not want to continue JES2 initialization, reply
‘TERM’. strname
The name of the coupling facility structure.
System programmer response: If you are not familiar
with the initialization dialog process, see z/OS JES2 System action: JES2 issues message $HASP272 and
Initialization and Tuning Reference for a detailed waits for an operator response.
discussion.
Operator response: Determine the action you want to
Detecting Module: HASPCKDS take and respond to message $HASP272 with one of
the options described below. Not all of the options
Routing Code: 1,2,10
appear for a given instance of this message.
Descriptor Code: 2,7
Option Meaning
CANCEL
$HASP278
JES2 ends the reconfiguration and continues
Explanation: processing. If you previously replied CKPTDEF
UNABLE TO LOCATE OR UNABLE TO USE CKPTn
to change CKPTn or NEWCKPTn, those
NEWCKPTn changes are lost.
dsname ON volser STRNAME strname
DOES NOT EXIST OR IS NOT USABLE - REFER TO PREVIOUS MESSAGE(S) Note: CANCEL appears as an option only if
VALID RESPONSES ARE: ‘CANCEL’ – EXIT FROM RECONFIGURATION this reconfiguration is not for an I/O
‘TERM’– TERMINATE MEMBERS WITH I/O ERROR ON CKPTn
‘CREATE’ – CREATE DATA SET error.
‘DELETE’ – DISCONTINUE USING CKPTn
Initialization and Tuning Reference for a detailed driving member. JES2 has determined that member
discussion. member-name now has the next most-current
in-storage copy of the checkpoint.
Detecting Module: HASPCKDS
System Action: This message is highlighted on the
Routing Code: 1,2,10
driving member and also issued to HRDCPY on
Descriptor Code: 2,7 non-driving members for diagnostic purposes.
Reconfiguration processing continues. Depending
$HASP285 on how far the reconfiguration progressed before
re-synchronization, JES2 might need to involve the
Explanation: operator to complete reconfiguration processing. If
JES2 CHECKPOINT RECONFIGURATION status the operator needs to be involved, JES2 issues the
$HASP271/$HASP272 or $HASP273/$HASP272
JES2 has entered a checkpoint reconfiguration with the message pair.
following status:
Operator response: Respond to subsequent
STARTED – JES2 INITIALIZATION checkpoint reconfiguration messages, as requested by
A JES2 checkpoint reconfiguration is started JES2. After the reconfiguration completes, JES2
because: the operator specified RECONFIG as a resumes normal processing.
JES2 start option, JES2 initialization cannot
determine which checkpoint data set or structure to System programmer response: None. If you are not
use, or JES2 requests confirmation of the familiar with the checkpoint reconfiguration process, see
checkpoint specifications. z/OS JES2 Initialization and Tuning Guide for a detailed
discussion before responding to checkpoint
System Action: This reconfiguration is limited to reconfiguration dialog messages.
this single JES2 MAS member; other members are
not involved. This message is followed by message Detecting Module: HASPCKDS
$HASP289. Routing Code: 1,2,10
STARTING Descriptor Code: 2,7
A JES2 checkpoint reconfiguration is starting. JES2
has not yet chosen the driving member.
$HASP287
System Action: This message is replaced by the
“STARTED – DRIVEN BY MEMBER” form of the Explanation:
message after checkpoint reconfiguration start-up ONLY ONE CHECKPOINT DATA SET
processing completes. If JES2 cancels the
reconfiguration, this message is followed by IS CURRENTLY IN USE
$HASP255.
DUPLEX CHECKPOINT WRITES
This message is highlighted on the member(s)
where the reconfiguration originated because of an WILL BE SUSPENDED
operator request. It is also issued to HRDCPY on
all other members for diagnostic purposes.
The DUPLEX=ON parameter was specified in one of
STARTED – DRIVEN BY MEMBER member-name the following cases:
A JES2 checkpoint reconfiguration has started and v On the CKPTDEF initialization statement
is being driven by member member-name because v On a $T CKPTDEF command
JES2 has determined that member has the v In response to a WTOR message during the
most-current in-storage copy of the checkpoint. reconfiguration dialog.
System Action: After reconfiguration start-up
Because only one checkpoint data set is in use, the
processing completes, JES2 replaces any previous
CKPTDEF,DUPLEX=ON request cannot be satisfied.
$HASP285 messages that indicated “STARTING”
with this form of the message. System action: JES2 suspends the duplexing function
on all members of the configuration and continues
This message is highlighted on the driving member
processing.
and also issued to HRDCPY on non-driving
members for diagnostic purposes. Operator response: Notify the system programmer.
JES2 continues reconfiguration processing. System programmer response: If you want, enter the
checkpoint reconfiguration dialog to start using the data
RE-SYNCHRONIZING – DRIVEN BY MEMBER
set that is not in use. JES2 automatically begins
member-name
duplexing.
A JES2 checkpoint reconfiguration is
re-synchronizing following the failure of the previous Detecting Module: HASPCKPT
Operator response: Notify the system programmer. System action: JES2 issues message $HASP272 and
waits for an operator response.
System programmer response: Message $HASP414
precedes this message. Examine the completion code Operator response: Determine the action you want
given in $HASP414 to determine why the allocation taken and reply to message $HASP272 with one of the
failed and correct the problem. JES2 automatically options described below.
begins duplexing. Option Meaning
Detecting Module: HASPCKPT CKPTDEF
If you reply with a CKPTDEF statement with no
Routing Code: 1,2,10 operands, JES2 issues message $HASP829
Descriptor Code: 4 displaying the current settings of the
parameters on the CKPTDEF initialization
statement. $HASP829 is highlighted and is
$HASP289 deleted after you reply to the
$HASP289/$HASP272 message pair that JES2
Explanation:
reissues.
CKPT1 AND/OR CKPT2
CKPTDEF (WITH OPERANDS)
If you want to respecify CKPTDEF specification
such as data set names and volume serials or
SPECIFICATIONS ARE REQUIRED.
the structure name of checkpoint data sets,
reply with a CKPTDEF statement with
appropriate parameters (for example,
REPLY TO HASP272
CKPTDEF
CKPT1=(DSN=dsname,VOL=volser),
CKPT2=...)
(MULTIPLE TIMES IF NECESSARY)
For a description of each operand, see the and respond to subsequent messages as directed.
description of the CKPTDEF initialization
System programmer response: Determine the
statement in z/OS JES2 Initialization and
severity and extent of the error (type of request that
Tuning Reference.
failed, data set record to which I/O was attempted) from
END When you satisfied with the checkpoint
the information provided. For a complete list of these
specifications, reply END. JES2 initialization
request failure return and reason codes, see z/OS MVS
continues using the new specifications.
Programming: Sysplex Services Reference. Determine
TERM JES2 initialization ends.
the appropriate recovery procedure and respond to
System programmer response: If you are not familiar subsequent messages to perform recovery.
with the reconfiguration dialog process, see z/OS JES2
Detecting Module: HASPCFDE, HASPCFFC,
Initialization and Tuning Guide for a detailed discussion.
HASPCFLE, HASPCFMT, HASPCFQL, HASPCFRD,
Detecting Module: HASPCKDS HASPCFRE, HASPCFRL, HASPCFRS, HASPCFR2,
HASPCFSI, HASPCFWP, HASPCFWR
Routing Code: 1,2,10
Routing Code: 1,2,10
Descriptor Code: 2,7
Descriptor Code: 4
$HASP290
$HASP291
Explanation:
MEMBER member_name Explanation:
MEMBER member-name – –
(1)
– – JES2 CKPT n IXLLIST request REQUEST FAILURE JES2 CKPTn DATA SET I/O ERROR
JES2 detects a failure attempting to access a A permanent I/O error (I/O completion code other than
checkpoint data set that resides on a coupling facility. X'7F') has been detected for a JES2 checkpoint data
Depending on the point in JES2 processing where the set I/O operation. Depending on the point in JES2
error occurred, data might have been read or written processing where the error occurred, data may have
and the error might or might not make the data set been read or written and the error may or may not be
inaccessible. catastrophic.
Complete device specific sense information READ ON STRUCTURE strname SYSTEM MANAGED PROCESS ACTIVE
WRITE
(set after a unit check). See the appropriate FORMAT
device document for an explanation of the IO
sense information. Indicates that the coupling facility has not responded to
opwwwwww,wwwwwwww JES2 after the indicated checkpoint operation was
Specifies the CCW that failed, where op may initiated. The value of MASDEF LOCKOUT is the
be one of the following: elapsed time that the coupling facility has not
03 (NO-OP) responded.
05 (WRITE DATA) This is a normal condition if you are dumping the
06 (READ DATA) coupling facility.
07 (SEEK) ‘IO’ indicates miscellaneous operations such as
08 (TIC) checkpoint lock and checkpoint query processing.
0E (READ KD) In the message text:
1D (WRITE CKD)
23 (SET SECTOR) member-name
29 (SRCH KEY EQ) The name of the JES2 member issuing the
31 (SRCH ID EQ) message.
op (UNKNOWN) strname
The name of the coupling facility structure.
System action: JES2 repeats this message (the time
interval is the current value of MASDEF LOCKOUT) reconfiguration messages with an appropriate option to
until JES2 receives a response from the coupling facility recover from the error.
indicating checkpoint processing progress or the
Attempt to determine the cause of the delay using other
operation completes.
related messages or symptoms.
Operator response: Attempt to determine the cause
System programmer response: None
of the delay using other related messages or symptoms.
If the message states that a structure rebuild is in Detecting Module: HASPCFFC
progress, this is a normal condition. However, if the
condition persists, it may be because of an XCF Routing Code: 1,2,10
signalling problem or a failed system. Check for any Descriptor Code: 4
outstanding WTORs. If the condition cannot be cleared,
then consider stopping the system managed process
(using the SETXCF command) if appropriate or initiating $HASP294
a checkpoint reconfiguration using the $T Explanation:
CKPTDEF,RECONFIG=YES command to assign a new WAITING FOR RESERVE (VOL volser).
JES2 checkpoint data set. If a reconfiguration is
requested, it may take the form of an I/O error because REPLY ‘CANCEL’ TO END WAIT
the current I/O must be purged and an I/O error
simulated.
This copy of JES2 is waiting for the RESERVE on
System programmer response: None volume volser to be accepted. If you want to discontinue
the wait, reply CANCEL.
Detecting Module: HASPCFFC
In the message text:
Routing Code: 1,2,10
volser The volume identifier.
Descriptor Code: 4
System action: The system waits for either a
response of CANCEL or for the RESERVE to be
$HASP293 successful.
Explanation: Operator response: Issue the D GRS command to
MEMBER member-name – – JES2 CHECKPOINT determine what resource is reserving the volume. If you
believe the RESERVE will never be successful, reply
READ ON STRUCTURE strname CANCEL. The reconfiguration starts again from the
WRITE beginning; at which time you can define an accessible
FORMAT volume.
IO
If you believe the RESERVE will be successful, wait.
PURGED DUE TO INACTIVE COUPLING FACILITY The message will be deleted when the RESERVE
completes.
Indicates that while checkpoint I/O is active on the
Detecting Module: HASPCKDS
coupling facility, JES2 detected a request for a
checkpoint reconfiguration, and the coupling facility has Routing Code: 1,2,10
not responded to JES2 within approximately one
minute. Descriptor Code: 2,7
‘IO’ indicates miscellaneous operations such as
checkpoint lock and checkpoint query processing. $HASP295
In the message text:
Explanation:
member-name MEMBER member-name – – CKPTn
The name of the JES2 member issuing the NEWCKPTn
message.
dsname ON volser
strname
– – TRACK SIZE INSUFFICIENT – – EXCEEDED BY m BYTES
The name of the coupling facility structure.
System action: The current I/O is purged, and JES2 JES2 has determined that the volume on which the
reenters the checkpoint reconfiguration. specified checkpoint data set resides has an insufficient
track size to contain the control information portion of
If the current checkpoint I/O has been initiated as the the JES2 checkpoint data set. In z2 mode, the control
result of a JES2 checkpoint reconfiguration, JES2 may information must fit on the first track.
issue message $HASP282 to indicate a null In the message text:
NEWCKPTn specification.
Operator response: Respond to the checkpoint
dsname ON volser
Operator response: Notify the system programmer.
System programmer response: Either increase the
– – SPACE INSUFFICIENT – – m TRACKS NEEDED
amount of private storage available to JES2 or change
the initialization parameters to reduce the amount of
An insufficient amount of space was allotted to the
storage needed.
Detecting Module: HASPCKDS v The verb is a valid JES2 verb but is not a valid verb
for this particular WTOR message.
Routing Code: 1,2,10
v The response did not begin with a verb and JES2 is
Descriptor Code: 4 reading the first part of the response as the
verb.verb.
$HASP298 System action: JES2 re-issues the original WTOR
Explanation: message and then waits for a reply.
INVALID RECORD ENCOUNTERED ON CKPTn Operator response: Read the descriptions of the valid
responses to this particular WTOR message and then
WRITTEN BY MEMBER memname give a new reply.
Detecting Module: HASPCKDS
While processing updates from the CKPTn data set’s
change log, JES2 has discovered an incorrect change Routing Code: 1,2,10
log record.
Descriptor Code: 2,7
In the message text:
n The number of the checkpoint data set. The
number is either 1 or 2.
memname
The member name of the member that wrote
the incorrect record.
System action: A $K20 abend message is issued and
JES2 stops processing.
Operator response: Notify the system programmer.
System programmer response: Use the indicative
dump and the SVC dump (if any) to diagnose the error.
If CKPT2 encountered an error, restart the failed
member specifying PARM=CKPT1. If CKPT1
encountered an error, specify PARM=CKPT2. If storage
overlay on member memname is suspected, re-IPL that
member. On the remaining members in the
configuration, enter the $T CKPTDEF,RECONFIG=Yes
command (the blank between the $T and CKPTDEF is
optional) to move CKPTn to a different volume using the
checkpoint reconfiguration dialog.
$HASP299
Explanation:
‘verb’ INVALID – PLEASE RESPECIFY
System action: Processing continues. During JCL conversion, the procedure library specified
Operator response: Determine the reason the job by ddname was found to have a logical record length
was placed in JES2 HOLD status and when other than 80, or a blocksize that is not an even multiple
appropriate, release the job for further processing. of 80.
In the message text:
Detecting Module: HASCJBST
ddname
Routing Code: 2 The name of a DD statement.
Descriptor Code: 6 System action: An attempt is made to process the
JCL without using a procedure library.
$HASP305 Operator response: It may be possible, by specifying
Explanation: SHR and not using JCL procedures, to correct the
jobname CONVERSION PROCESSOR problem with the specified procedure library without
stopping the system.
AWAITING STORAGE Detecting Module: HASPCNVS
Routing Code: 2
The conversion processor is unable to perform JCL
conversion because there is insufficient storage Descriptor Code: 4
Descriptor Code: 4
$HASP307
Explanation:
$HASP309
UNABLE TO OPEN ddname
Explanation:
During JCL conversion, the procedure library specified INIT init INACTIVE { ******** }
by ddname could not be opened. A DD card for the
specified procedure library may not exist in the c= classes
procedure used to start the subsystem.
In the message text: The specified JES2 logical initiator is idle because no
jobs of the classes indicated were available in the JES2
ddname
job queue.
The name of a DD statement.
In the message text:
System action: If the specified procedure library is
init The initiator number or name.
other than PROC00, then an attempt is made to use
PROC00. If PROC00 cannot be opened, an attempt is classes
made to process the JCL without using a procedure The job classes.
library.
System action: The execution processor activates the
Operator response: Notify the system programmer. logical initiator when an appropriate job becomes
available.
System programmer response: Determine if the
specified DD statement should exist in the JES2 Operator response: If the initiator is not to be used
cataloged procedure. If so, put it in the procedure. for an extended period of time, enter a $P init command
for that initiator. Otherwise, enter a $TI command to
Application Programmer Response: Check the value
alter the job classes the initiator is to process or allow
of the PROC= keyword on the /*JOBPARM JECL
the initiator to remain inactive as required.
statement to see if you specified a nonexistent
procedure library. If so, correct the specified value. Detecting Module: HASPXEQ
Otherwise, notify the system programmer.
Routing Code: 1,2
Detecting Module: HASPCNVS
Descriptor Code: 4
Routing Code: 2
Descriptor Code: 4 $HASP310
Explanation:
$HASP308 jobname TERMINATED AT END OF MEMORY
Explanation:
jobname ESTIMATED TIME EXCEEDED The specified job is ended as a result of the abnormal
end of the address space.
In the message text:
BY nnnnnnn MINUTES jobname
The name of the job.
The indicated job has exceeded its estimated elapsed
(wall clock) time in the JES2 execution phase by Note: A jobid may precede $HASP310. See “JES2
nnnnnnn minutes. In the message text: message format” on page 1.
jobname System action: Processing continues.
The name of the job.
Operator response: None.
nnnnnnn
The time in minutes. Detecting Module: HASPXEQ
Routing Code: 1,2
Note: A jobid may precede $HASP308. See “JES2
message format” on page 1. Descriptor Code: 4
The specified job has been re-queued for warm start Routing Code: 2,10
processing as a result of the abnormal end of the Descriptor Code: 4
address space in which it was running.
In the message text:
$HASP313
jobname
The name of the job. Explanation:
jobname JES2 IS UNABLE TO CREATE
Note: A jobid may precede $HASP311. See “JES2 DELETE
message format” on page 1.
THE SECURITY ENVIRONMENT
System action: Processing continues.
SECURITY PRODUCT RETURN CODE = rrrrrrrr
Operator response: None.
REASON CODE = ssssssss
Detecting Module: HASPXEQ
Routing Code: 1,2 The specified job is canceled because JES2:
Descriptor Code: 4 v could not create the security environment for the job
to be converted
v could not delete the environment following the job’s
$HASP312
conversion
Explanation: v is running in an environment where SECLABELs are
jobname JOB NOT CREATED. active, but the userID associated with the JES2
address space is not defined with a SECLABEL of
function NOT AVAILABLE DUE TO SECURITY FAILURE.
SYSMULTI. See z/OS JES2 Initialization and Tuning
The security product failed a request to create the Guide for further explanation of using SECLABELs to
security environment for function. provide system-level affinity.
In the message text: either or . The return and reason codes are the
jobname hexadecimal values returned by the security product,
The name of the job. (as opposed to the SAF return codes) for a RACROUTE
REQUEST=VERIFY. See the documentation for your
function security product for an explanation of those values.
The name of the failed function.
In the message text:
Some of the values for jobname, and the corresponding
values for function are: jobname
The name of the job.
jobname
function Note: A jobid may precede $HASP313. See “JES2
SYSLOG message format” on page 1.
System log System action: JES2 cancels the job.
$JESNEWS Operator response: Notify the system programmer.
JES news
System programmer response: See the
$TRCLOG accompanying messages (from RACF or another
JES2 trace security product), in addition to the return and reason
codes, to determine the cause of the error. If the job
If jobname is a value other than those listed, the originated from a member that had no security product
corresponding value of function is Application. installed, and the issuing member did have a security
System action: Processing continues. However, the product installed, then the error may be due to incorrect
function indicated is not available. data being passed on the JOB card. Otherwise, the
error may indicate a problem with the security
Operator response: Notify the system programmer. environment or the data passed to the security product.
Correct the problem and resubmit the job.
System programmer response: Look for prior error
messages from your security product to determine the Detecting Module: HASPCNVS
cause of the failure. Correct any security definitions or
profiles to allow JES2 to create the security Routing Code: 1,2,10
environment. Descriptor Code: 4
Routing Code: 1,2 JES2 issues this message in response to a $ADD, $D,
Descriptor Code: 4 $DEL, or $T command for the PROCLIB statement. It is
also issued in response to a PROCLIB initialization
statement. It displays the keywords defined on this
$HASP315 statement and their current values.
Explanation: In the message text:
INIT init HALTED { ******** } ddname
The PROCLIB concatenation.
c= classes
keyword
The name of the keyword.
The operator has entered a $ZI command and the
identified initiator has subsequently entered the value The value of the keyword.
HALTED condition.
In the message text: The description of the PROCLIB statement in z/OS
init The initiator number or name. JES2 Initialization and Tuning Reference explains the
parameters displayed in this message.
classes
The job classes. System action: Processing continues.
System action: The initiator job associated with the Operator response: None.
identified initiator remains in an indefinite wait state. System programmer response: None.
Operator response: Enter a $SI command to resume | Detecting Module: HASCSCAN
processing jobs with the initiator.
Routing Code: 1,2,10
Detecting Module: HASPXEQ
Descriptor Code: 4
Routing Code: 1,2
Descriptor Code: 4 $HASP321
Explanation:
$HASP316 jobname OUTGRP= grpid joeid1 joeid2
Explanation: PURGED – RECEIVER DOES NOT HAVE ACCESS TO DATA
jobname HAS REPLACED
DELETED A TSO RECEIVE command was issued for a data set
that the requester is not authorized to access.
text is:
JES2 detected an error while initializing work areas to
collect a job’s OUTPUT JCL keywords for output STORAGE IN EPVT IS NOT AVAILABLE
grouping. There is not enough storage in the extended
In the message text: private storage area for grouping to occur.
jobname
The name of the job.
| Note: A jobid may precede $HASP323. See “JES2
| message format” on page 1.
text is one of the following: System action: If the error occurs during reception of
SYSOUT, JES2 issues message $HASP543 and purges
STORAGE IN EPVT IS NOT AVAILABLE
the incoming job. If the error occurs when a job
There is not enough storage in the extended
requests an OPEN of a SYSOUT data set, the OPEN
private storage area for grouping to occur.
request fails. If the error occurs when JES2 opens a
STORAGE IN ECSA IS NOT AVAILABLE system data set, JES2 requeues the batch job for
There is not enough storage in the extended processing and ends the initiator. If the error occurs
common storage area (ECSA) for grouping to when a job unallocates a spin data set as a non-spin
occur. data set, JES2 leaves the data set as a spin data set.
Operator response: Obtain a dump of JES2 and
notify the system programmer.
System programmer response: Use the Routing Code: Message sent to hardcopy only.
environmental editing, recording, and printing program
Descriptor Code: 4
(EREP) to format SYS1.LOGREC and examine the
output for the symptom record associated with this error.
Report the return code (RC) and reason code (RSNC), $HASP347
if any, to the IBM Support Center.
Explanation:
Detecting Module: HASPSJFR jobname SYSOUT ALLOCATION FAILED
Routing Code: 2,10
JES2 cannot allocate a SYSOUT data set because an
Descriptor Code: 4 error occurred in an SJFREQ find or retrieve request or
because an error occurred in scanning output
$HASP329 references on a JCL DD statement.
In the message text:
Explanation:
jobname JOB VALIDATION FAILED jobname
The name of the job.
WITHOUT ACCOMPANYING MESSAGE
Note: A jobid may precede $HASP347. See “JES2
SECURITY PRODUCT RETURN CODE= rrrrrrrr message format” on page 1.
System action: If this was a static allocation, JES2
REASON CODE= ssssssss ends the job. For dynamic allocation, only the allocation
fails.
The security product failed the job without at least one
accompanying message. This message is issued to Operator response: Notify the system programmer.
hardcopy only and JES2 deletes the specified job. The Application Programmer Response: Check the job’s
return and reason codes are the hexadecimal values JCL for an incorrect output reference.
returned by the security product, (as opposed to the
SAF return codes) for either a RACROUTE Detecting Module: HASCDSAL
REQUEST=TOKENBLD or a RACROUTE Routing Code: 10
REQUEST=VERIFY. See the documentation for your
security product for an explanation of those values. Descriptor Code: 6
In the message text:
jobname $HASP350
The name of the job. Explanation:
jobname INIT STOPPED
Note: A jobid may precede $HASP329. See
“JES2 message format” on page 1.
JES2 has caused an initiator to stop. The initiator was
rrrrrrrr The security product return code. stopped because of an operator request, because
insufficient storage was available, or because the
ssssssss
initiator had been started to run an STC or TSU job and
The reason code.
that job had a JCL error.
System action: The job is routed to the print phase In the message text:
for appropriate action and then purged.
jobname
Operator response: Report this message to the The name of the job.
system programmer.
Note: A jobid may precede $HASP350. See “JES2
System programmer response: No accompanying
message format” on page 1.
messages (from RACF or another security product)
were returned to JES2. See the return and reason System action: The initiator should stop normally.
codes to determine the cause of the job validation
Operator response: None.
failure. If the job originated from a member that had no
security product installed, and the issuing member did Detecting Module: HASCJBST
have a security product installed, then the failure may
be due to incorrect data being passed on the JOB card. Routing Code: 2
Otherwise, the failure may indicate a problem with the Descriptor Code: 4
security environment or the data passed to the security
product. Correct the problem and resubmit the job.
Detecting Module: HASPSSRV
JES2 stopped segmentation for the SYSOUT defined by An OPEN macro failed for a subsystem data set
ddname. because JES2 could not determine the type of the data
In the message text: set from the data set name in the job file control block
(JFCB).
jobid The job identifier. In the message text:
jobname jobname
The name of the job. The name of the job.
ddname
The name of a DD statement. Note: A jobid may precede $HASP352. See “JES2
message format” on page 1.
text is one of the following: System action: Processing continues.
RC=1 UNABLE TO SERIALIZE Application Programmer Response: Resubmit the
JES2 could not obtain the job lock because the job ensuring that:
lock is already held. v MSGLEVEL=(1,1) is coded
RC=2 MULTIPLE OPEN ACBS v The failing step contains a SYSABEND DD
JES2 encountered a data set open count statement.
greater than 1.
RC=3 SEGMENT LIMIT REACHED Correct the incorrect data set type and resubmit job.
The SYSOUT being segmented has reached Detecting Module: HASCDSOC
the number of segments specified in the
SEGLIM= parameter of the OUTDEF Routing Code: 10
statement. Descriptor Code: 6
RC=4 CLOSE IN PROGRESS
The application issued a CLOSE macro. The $HASP353
last record of the data set required JES2 to
segment the data set. JES2 is unable to Explanation:
segment the data set during a CLOSE request. jobname CLOSE FAILED BECAUSE NOT
This situation occurs when the application uses
SYSIN,SYSOUT,PROCESS-SYSOUT,NOR SPOOL BROWSE
QSAM locate mode.
System action: JES2 discontinues segmentation for A CLOSE macro failed for a subsystem data set
the current output. because JES2 could not determine the data set’s type
from the data set name in the JFCB.
System programmer response:
In the message text:
RC=1 Dump JES2 and the job that received the error.
jobname
Determine why the lock was held and correct
The name of the job.
the problem. If unable to determine the cause,
contact the IBM Support Center.
Note: A jobid may precede $HASP353. See “JES2
RC=2 Dump the job. Determine if the job attempted message format” on page 1.
to open the same data set twice.
System action: Processing continues.
RC=3 Determine why the job is exceeding the
Application Programmer Response: Correct the
SEGLIM value and adjust SEGLIM if
incorrect data set type and resubmit the job.
necessary.
Detecting Module: HASCDSOC
RC=4 None. The message is for information only.
Routing Code: 10
System action: The system suspends JES2 rc The return code in decimal.
processors and users of JES2 services that require System action: JES2 suspends output segmentation.
direct access space, until an output function completes
and the associated direct access space becomes System programmer response: Ensure any
available, or another spool volume is added using the application that performs segmentation uses the data
$S SPOOL command. control block (DCB) interface and not the access
method control block (ACB) interface to the data sets.
Operator response: Take one or more of the following See MVS/DFP Macro Instructions for Data Sets for an
actions as appropriate: explanation of the SETPRT return code.
v Identify any jobs using excessive amounts of spool
Detecting Module: HASCHAM
space and take appropriate action. For example,
cancel an executing job if it continues to use SPOOL Routing Code: 10
at an unacceptable rate, or if it is being submitting to
an internal reader that’s in a loop. Descriptor Code: 6
v Purge old output and jobs.
v Offload old output and jobs using the SPOOL offload $HASP357
facility. Explanation:
v Add more SPOOL volumes. jobname STORAGE UNAVAILABLE FOR SDB
v If a very large job was recently deleted by a
$ZAPJOB command, rather then waiting for up to JES2 cannot allocate a subsystem data set, because
seven days for JES2 to recover its SPOOL space storage within the user’s address space is unavailable
using SPOOL garbage collection, consider using a for a subsystem data set block.
$TSPOOLDEF,GCRATE=FAST command to recover In the message text:
the SPOOL space quickly.
jobname
v If SPOOL utilization reached 100% in seconds as a The name of the job.
result of a programming error, first correct the cause
of the problem. Then rather then waiting for up to Note: A jobid may precede $HASP357. See “JES2
seven days for JES2 to recover its SPOOL space message format” on page 1.
using SPOOL garbage collection, consider using a
$TSPOOLDEF,GCRATE=FAST command to recover System action: The subsystem data set is not
the SPOOL space quickly. allocated.
Application Programmer Response: Reduce the
Note: Using $TSPOOLDEF,GCRATE=FAST will not be data set requirements of the job step.
useful for most SPOOL-full situations where the
SPOOL space is legitimately owned by existing Detecting Module: HASCSRDS
jobs. Routing Code: 10
Operator response: Add a spool volume (using the Detecting Module: HASCDSAL
$S SPL command) or make an already existing volume Routing Code: 2
active by issuing a $S SPL command.
Descriptor Code: 6
Detecting Module: HASPCKPT
Routing Code: 1,2 $HASP361
Descriptor Code: 4 Explanation:
jobname JOB NOT FOUND
$HASP359
JES2 was unable to find the specified started task
Explanation: (STC) or time sharing user (TSU) in its job queue that
jobname HCBGM – NO STORAGE AVAILABLE an initiator requested specifically by job identifier. The
job was created by a START or MOUNT command or
IN SP 230 by a TSO LOGON command.
In the message text:
While attempting to start processing a job, JES2 has
failed to obtain storage from the user address space to jobname
hold one of the job’s direct access resident control The name of the job.
blocks.
In the message text: Note: A jobid may precede $HASP361. See “JES2
message format” on page 1.
jobname
The name of the job. System action: The requesting initiator is stopped.
Operator response: Reenter the command that
Note: A jobid may precede $HASP359. See “JES2 created the job.
message format” on page 1.
Detecting Module: HASCJBST
System action: Processing continues.
Routing Code: 10
System programmer response: Provide more
common storage area. Descriptor Code: 6
$HASP373
$HASP375
Explanation:
Explanation:
jobname STARTED jobname ESTIMATED LINES EXCEEDED
CARDS
– INIT init – CLASS class – SYS sysname KBYTES
PAGES
jobname STARTED
$HASP397
Explanation:
jobname RE-ENQUEUED
System action: During a JES2 warm start, JES2 ends Descriptor Code: 4
after attempting to verify the remaining required
volumes. After a $S SPOOL command is entered, the $HASP403
command is rejected and the volume is not started.
Explanation:
System programmer response: Make sure that all
spooling volumes are correct. If not, mount the correct
ones. If correct, perform a cold start, thus destroying
JES2 warm start processing encountered a job that was Operator response: Resubmit the job.
stopping its processing during system shutdown. Detecting Module: HASPWARM
In the message text:
Routing Code: 1,2
jobname
The name of the job. Descriptor Code: 4
nnn The maximum number of direct access spool cross memory interface required to support functional
volumes that JES2 supports. subsystem fssname.
In the message text:
yyyyy The prefix of the spool volume as specified by
the VOLUME parameter of the SPOOLDEF fssname
initialization statement. The name of the functional subsystem.
System action: JES2 does not allocate the spool System action: The functional subsystem abends with
volume. The operator has the option to continue or stop an ABEND code of X'02C'. All devices are drained that
processing. are associated with the functional subsystem.
Operator response: If you request continuation, the Operator response: Save the hard-copy log. For
system comes up with only nnn spool volumes. If you system with remote consoles, save the remote console
request to end processing, JES2 ends. Notify the sheet. Notify the system programmer.
system programmer.
To restart the functional subsystem enter the $S
System programmer response: Increase the value of PRTnnnn command. If the functional subsystem devices
the SPOOLNUM parameter on the SPOOLDEF are also supported directly by JES2, they may be
initialization statement. restarted by entering the $T command with MODE=JES
and then starting the device with the $S command.
Detecting Module: HASPIRDA
System programmer response: The $F06 code
Routing Code: 1,2,10
indicates this error condition. See z/OS MVS System
Descriptor Code: 2,7 Codes for an explanation of the X'02C' abend.
Determine the cause of the ATSET system service
failure. ATSET was invoked with an authorization index
$HASP412 value in the $CCTAXV field of the $HCCT. For a
Explanation: description of ATSET, see z/OS MVS Programming:
JES2 CAN NOT RECONNECT TO FSS fssname, Assembler Services Reference ABE-HSP.
Save the dump produced. If you use SMP/E to make all
FSS ADDRESS SPACE HAS ENDED changes to the system, run the LIST CDS and LIST
PTFBY functions of SMP/E to obtain a list of the current
During a JES2 hot start, JES2 attempted to reestablish maintenance from the SMP/E control data set (CDS).
the cross memory interface required to support
functional subsystem (FSS) fssname, but JES2 detected If any changes are made without using SMP/E, run
that the FSS address space has ended. LISTIDR of AMBLIST to obtain a list of all members with
a PTF or local fix and save the output. Run LISTIDR
System action: JES2 drains all devices associated against the following:
with this FSS. v SYS1.LINKLIB.
Although JES2 determined that the FSS was active v SYS1.SVCLIB
during a hot start, JES2 was unable to schedule an v The library containing the program that issued the
SRB to reconnect to the cross-memory address space. message.
Either JES2 could not find a valid ASCB for the FSS or
the FSS address space was terminating. v SYS1.LPALIB
Operator response: Enter the $S PRTnnnn command Contact the IBM Support Center.
to restart the FSS. If JES2 also directly supports the
FSS devices, issue the $T command with MODE=JES Detecting Module: HASPWARM
and then issue the $S command to start the device. Routing Code: 1,2,10
Detecting Module: HASPWARM Descriptor Code: 4
Routing Code: 1,2,10
Descriptor Code: 7 $HASP414
Explanation:
$HASP413
MEMBER member-name ––
Explanation:
JES2 RECONNECT TO FSS fssname FAILED, OBTAIN FAILED FOR
CKPTn NEWCKPTn
FSS TERMINATED WITH ABEND 02C – $F06
hh:mm:ss
JES2 was unable to finish formatting the first extent of
The time of the last write to the checkpoint in
SYS1.HASPACE on the specified SPOOL volume
hour:minute:second format (for example,
because a hardware error occurred or because the
18:24:45)
SPOOL volume is not properly initialized.
System action: JES2 issues message $HASP417. In the message text:
Operator response: Respond to message volser The volume identifier.
$HASP417.
System action:
System programmer response: If the data set JES2 v For a cold start, processing continues without the
will use is incorrect, update the CKPTDEF initialization volume.
statement with the correct CKPTn values and then
v For a warm start, processing stops after attempting to
restart JES2.
verify the remaining spool volumes.
Detecting Module: HASPIRDA
v For a $S SPOOL command, the command is rejected In this case, the old XCF status information for the
and processing continues. member has been lost. Reply Y to the HASP420
message.
Operator response: If the error was caused by a
hardware malfunction, have it corrected. If not, the
Note: An incorrect reply of Y to message $HASP420
SPOOL volume may need to be re-initialized.
might cause JES2 to end abnormally (code
Re-initialize it using ICKDSF.
$K03) and possible damage to spool and
Detecting Module: HASPSPOL checkpoint, resulting in a cold start of JES2.
Routing Code: 1,2,10 Detecting Module: HASPIRDA
Descriptor Code: 4 Routing Code: 1,2,10
Descriptor Code: 2,7
$HASP419
Explanation: $HASP420
MEMBER memname1
Explanation:
REPLY ‘Y’ IF memname IS
HAS DETERMINED THAT THE FOLLOWING
ALL MEMBERS ARE
JES2 MEMBERS(S) ARE DORMANT:
DOWN (IPL REQUIRED), ‘N’ IF NOT
memname2
, memname3... JES2 has issued either message $HASP419 reporting
the member(s) considered dormant, or message
$HASP405 if it cannot determine if any other member in
JES2 initialization has determined through analysis of
the multi-access spool configuration is active. JES2
the checkpoint record that the specified member(s) of
requires confirmation of the status of each of the
the configuration is inactive. However, JES2 was not
displayed member(s).
able to confirm this because it could not find the listed
In the message text:
members in the XCF status information. The operator
must confirm the member is down by responding to the memname
following $HASP420 message. The member name.
In the message text:
System action: JES2 waits for the operator’s reply.
memname1
The member name of this member. Operator response:
v If memname is displayed:
memname2 [, memname3,] ...
The member names of the inactive members. This $HASP420 message is issued once for every
member displayed in message $HASP419 or until
System action: JES2 issues message $HASP420 you reply N. For each issuance, determine whether
once for every member documented or until the MVS is down on memname using the notes provided
operator responds N to the message. below. If memname is indeed inactive, reply Y to this
message. Otherwise reply N.
Operator response: Notify your system programmer
and respond to message $HASP420. If you reply Y to every issuance of this message
(indicating all members displayed in $HASP419 are
System programmer response: This message is inactive), JES2 will perform a cold start or a warm
issued when JES2 determines that a member has not start, depending on the initialization option you
accessed the checkpoint data set within the value previously specified. If you reply N to this message
specified for SYNCTOL on the MASDEF initialization for any member documented in $HASP419, JES2
statement and JES2 cannot obtain status information for initialization will terminate, regardless of the kind of
the member from XCF. This can occur because: start you previously specified.
v The member is (or was at one time) active on an v If ALL MEMBERS ARE is displayed:
MVS system that is not in the same SYSPLEX as the
The $HASP405 message precedes this message.
member that is initializing. In this case, XCF cannot
Determine whether MVS is down on all other
determine the current member status. If the member
members in the multi-access spool (MAS)
is still active on the other MVS system, reply N to the
configuration using the notes provided below. If all
$HASP420 message, otherwise reply Y.
other members are inactive, reply Y to this message.
v The member that is initializing is on an MVS system JES2 will perform a cold start or a warm start,
that has had its XCF coupling data sets reformatted. depending on the initialization option you previously
specified.
Operator response: If the wrong volume was System action: If this is an operator-requested spool
mounted, mount the correct volume and warm start format, JES2 formats all unformatted spool volumes
JES2. Otherwise, cold start JES2; any spool volumes during a cold start, all spool volumes during a format
that are not correctly formatted will automatically be start, and the indicated spool volume in response to a
reformatted during a JES2 cold start. If the message $S SPOOL,FORMAT command.
was issued in response to a start spool ($S SPOOL) If this is a JES2-initiated mini-format, JES2 only writes
command, make sure the correct spool volume is the signature records for a spool record. JES2 does not
mounted on all systems, and reenter the $S SPOOL change or overwrite any spool data.
command.
Operator response: None.
Detecting Module: HASPSPOL, HASPIRDA
Detecting Module: HASPSPOL
Routing Code: 1,2,10
Routing Code: 1,2,10
Descriptor Code: 4
Descriptor Code: 4
member-name Explanation:
The member experiencing the problem. SPECIFY OPTIONS – JES2
Member-name is only included when the volser
is for a checkpoint data set. jeslevel SSNAME= ssname
The operator attempted to start the JES2 subsystem System action: JES2 resets to default responses, and
when the subsystem interface (SSI) created by a waits for the operator to reply.
previous JES2 is still active. This could be caused by Operator response: Enter the required options. For
any of the following: further information, see z/OS JES2 Commands.
Detecting Module: HASPIRMA being initialized and the subsystem support module, (or
its related control blocks). This can happen when:
Routing Code: 1,2,10
v A JES2 subsystem (that is, a subsystem with the
Descriptor Code: 4 same name as the one now being started) had been
active since the last IPL and had abnormally ended.
$HASP428 The subsystem support module(s) (HASCxxxx)
specified during this initialization is not the same
Explanation: module used by the previously running JES2, or the
CORRECT THE ABOVE PROBLEMS related control blocks left by that JES2 are not
compatible with the JES2 now being initialized.
AND RESTART JES2 v The subsystem support module’s structure or content
indicates that it is not compatible with, or at a
This message follows one or more messages that different level than, the JES2 currently being
indicate why JES2 initialization could not complete initialized.
normally.
System action: JES2 ends. In the message text:
This message is issued for one of the following reasons: Detecting Module: HASPIRA, HASPIRDA,
HASPIRMA
v NOT LOADABLE – JES2 attempted to load module
HASPINIT and failed. Routing Code: 1,2,10
v INCORRECT – The module entry point could not be Descriptor Code: 4
found from the module information table assumed to
be at the beginning of the module.
$HASP433
System action: The $HASP428 message is issued
and then JES2 ends. Explanation:
INVALID SUBSYSTEM EXECUTION MODE
Operator response: Notify the system programmer.
System programmer response: Place a compatible An attempt was made to run JES2 as other than a
HASPINIT load module in the same data set that subsystem started task (for example, as a batch job).
contains the HASJES20 load module referenced by the
System action: JES2 ends.
JES2 catalog procedure that is being started.
Operator response: Notify the system programmer.
Detecting Module: HASPNUC
System programmer response: Determine who
Routing Code: 1,2,10
made the attempt and verify their right to use JES2.
Descriptor Code: 4
Detecting Module: HASPNUC
Routing Code: 1,2,10
$HASP432
Descriptor Code: 4
Explanation:
AVAILABLE STORAGE EXCEEDED
$HASP434
WHILE ALLOCATING id
Explanation:
INVALID CHECKPOINT RECORD ON CKPTn
During JES2 initialization, the amount of storage
required for JES2 processing exceeded the available DATA SET
private virtual storage in the JES2 address space.
In the message text, id can be one of the following
values: JES2 has detected an incorrect checkpoint record on
the specified checkpoint data set. The record is
BUFFERS incorrect because of one of the following reasons:
A GETMAIN to allocate JES2 buffers was v A permanent I/O error has occurred.
unsuccessful.
v A field named $HASPID did not contain “JES2”.
$HASP435 dsname
The name of the checkpoint data set.
Explanation:
DUPLICATE MEMBER NAME OR strname
The name of the coupling facility structure.
MORE THAN 32 MEMBER NAMES xxxxx The prefix of the spool volume as specified by
the VOLUME parameter of the SPOOLDEF
One of the following error conditions exists: initialization statement.
v On the MASDEF statement, OWNMEMB specifies a System action: JES2 issues message $HASP441.
member name that is different from any already
existing member names and there are already 32 Operator response: Respond to message
member names defined. In other words, there has $HASP441.
been an attempt to define a 33rd member name. Detecting Module: HASPIRDA
v The same member name has been specified for two
different members. Routing Code: 1,2,10
$HASP441 $HASP442
Explanation: Explanation:
REPLY‘Y’ TO CONTINUE INITIALIZATION INITIALIZATION STATEMENTS CONFLICTING
Routing Code: 1,2,10 routing code is incorrect for one of these reasons:
Descriptor Code: 4 v If the routing code is an explicit value, then that value
is greater than the maximum allowed.
v If the routing code is a symbolic value, then that
$HASP443
symbol is not defined on a DESTID or a Nnnnn
Explanation: initialization statement.
| vvvvvv NOT ALLOCATED reason
vvvvvv ENQ BYPASSED reason In the message text:
destid The routing code.
The specified spool volume has not been allocated. This
message may follow another JES2 message indicating System action: JES2 ends.
the problem. Operator response: Notify the system programmer.
In the message text, reason is one of the following:
| OBTAIN FAILURE, RC=01 System programmer response: Correct the error and
| I/O ERROR DURING FORMAT, RC=02 restart JES2.
| I/O ERROR DURING READ VALIDATION, RC=03 Detecting Module: HASPIRA
| DYNAMIC ALLOCATION FAILURE, RC=04
| INTERNAL ERROR, RC=05 Routing Code: 1,2,10
| UNABLE TO GET DEVICE INFORMATION, RC=06
| UNUSABLE EXTENT SIZE, RC=07 Descriptor Code: 4
| EXTENT ABOVE 64K TRACK LIMIT, RC=08
| DSNAME AND VOLUME ALREADY OWNED BY
| ANOTHER MAS, RC=09 $HASP445
| UNABLE TO CONSTRUCT ENQ MINOR NAME, RC=10 Explanation:
| UCBINFO - RC=retcd RSN=rsncd
UNACTIVATE REQUEST FAILED, reason
| UNABLE TO CONSTRUCT ENQ MINOR NAME, RC=11
| IOSCDR - RC=retcd RSN=rsncd
| UNABLE TO CONSTRUCT ENQ MINOR NAME, RC=12 The unactivate request failed.
| UNABLE TO FIND DEVICE IDENTIFICATION In the message text, reason is one of the following:
| UNABLE TO CONSTRUCT ENQ MINOR NAME, RC=13
| DIAGNOSE - RC=retcd MAS ALREADY IN RELEASE 4 MODE
| where retcd and rsncd are the return code and JES2 was warm started with PARM=UNACT
| reason code from the failing service specified and JES2 is already in release 4 mode.
| respectively. The effect is that the PARM=UNACT was ignored
because JES2 is already in release 4 mode.
System action:
v For a cold start, the volume is ignored and OTHER MEMBERS ACTIVE
processing continues. JES2 was warm started with PARM=UNACT
specified; however, there are other members of the
v For an all-member warm start, the operator is queried
MAS that are active. PARM=UNACT can only be
as to the action to be taken. (The $HASP853
used on an all member warm start or an all
message is issued.)
member hot start (a hot start where there are no
v For any other type of starts, initialization ends. active JES2 address spaces). The effect is that the
v If this message is issued in response to a start spool PARM=UNACT is ignored and JES2 starts in z/OS
command, the command is rejected, and JES2 1.2 mode.
processing continues.
MEMBER NOT ALLOCATED TO BOTH CHECKPOINT
Operator response: Mount the correct volume on the DATA SETS
required device. JES2 was warm started with PARM=UNACT
specified; however, this member is not allocated to
Detecting Module: HASPSPOL, HASPIRDA both checkpoint data sets (they have specified
Routing Code: 1,2,10 CKPT1 and CKPT2 as INUSE=YES, indicated
MODE=DUPLES and DUPLEX=OFF). You must be
Descriptor Code: 4 allocated to both checkpoint data sets to specify
PARM=UNACT. The effect is that the
$HASP444 PARM=UNACT is ignored and JES2 starts in z/OS
1.2 mode.
Explanation:
destid PRINT/PUNCH ROUTE CODE INVALID JOB NUMBERS ABOVE THAT SUPPORTED BY
REL4 ARE IN USE
Either JES2 was warm started with PARM=UNACT
The routing code that appears in the destid field of the
or a $ACTIVATE,LEVEL=R4 command was issued
message text was specified on the ROUTECDE
and job numbers above 65534 are in use. Since
parameter of a JES2 initialization statement, but the
INSTALLATION STRING LENGTH NOT VALID started with MASDEF SHARED=NOCHECK. By starting
The Exit 24 field X024SSIL (supplied length) was JES2 with the PARM=CONSOLE option, it is possible to
not valid. restart JES2 and update the MASDEF SHARED
parameter setting. However, you should not operate an
STORAGE NOT AVAILABLE FOR SYSTEM STRING
MAS until the definition of the device is corrected in the
JES2 could not obtain the necessary storage in the
MVS I/O configuration. Contact the programmer
extended common storage area for the system
responsible for defining devices to the system to correct
information string.
the device definition.
System action: JES2 initialization continues: the SSI
System programmer response: If you are not familiar
routine will operate without the string.
with the checkpoint dialog process, see z/OS JES2
Operator response: Notify the system programmer. Initialization and Tuning Guide for a detailed discussion.
System programmer response: If the reason text If you are running this JES2 member in a non-MAS
indicates that the installation string length is not valid, environment, specify MASDEF SHARED=NOCHECK.
examine Exit 24 to ensure that the string is built
Detecting Module: HASPSPOL, HASPCKDS
correctly and supply the correct length.
Routing Code: 1,2,10
Detecting Module: HASPIRA
Descriptor Code: 4
Routing Code: 1,2,10
Descriptor Code: 4
$HASP450
Explanation:
$HASP449
OPEN FAILED FOR JES2 PARAMETER LIBRARY DDNAME
Explanation: MEMBER
volser name
MEMBER member-name ––
JES2 issued an OPEN macro instruction for the
MUST BE MOUNTED ON SHAREABLE DEVICE parameter library data set and determined that the data
set was not opened.
The specified volume is on a device that is not defined name is the name of the DD statement or member
with ’share’ option in the I/O configuration for MVS. If name in PARMLIB that could not be opened.
JES2 is operating in a multi access SPOOL System action: Message $HASP441 follows,
configuration, the volumes used for the JES2 requesting operator action.
checkpoint and SPOOL must be on devices defined to
z/OS with the ’share’ option. JES2 will verify the Operator response: Check with the system
definition of the device if SHARED=CHECK was programmer as to whether you should allow initialization
specified on the MASDEF initialization statement. to continue. Respond to the $HASP441 message
In the message text: accordingly.
member-name System programmer response: Determine the cause
The name of the member experiencing the of the error and correct it.
problem. member-name is only displayed if this
Detecting Module: HASPIRPL
message is issued when JES2 is attempting to
allocate a checkpoint data set on volser. Routing Code: 1,2,10
volser The volume identifier. Descriptor Code: 4
System action: If this message is issued for a
checkpoint volume during JES2 initialization, JES2 $HASP451
initiates a checkpoint reconfiguration dialog. If JES2 is
Explanation:
already within a checkpoint reconfiguration, JES2
prompts the operator for alternative actions. ERROR ON JES2 PARAMETER LIBRARY
If the volume is a required spool volume, JES2 ends. JES2 encountered an error when reading the
Otherwise, processing continues. initialization parameter library.
Operator response: If you are attempting to warm System action: Message $HASP441 follows,
start JES2 when this message is received, it is possible requesting operator action.
that the I/O configuration for MVS has been updated
incorrectly. JES2 will not be able to start unless either Operator response: Ask the system programmer
the definition of the device in the I/O configuration is whether you should allow initialization to continue.
updated to indicate the device is shared or JES2 is Respond to the $HASP441 message accordingly.
System programmer response: Determine the cause n The number of the checkpoint or new
of the problem and correct the parameter errors. checkpoint data set. The number is either 1 or
2.
Detecting Module: HASPIRPL
dsname
Routing Code: 1,2,10
The name of the data set.
Descriptor Code: 2,7
volser The volume identifier of the volume containing
the data set.
$HASP452
System action:
Explanation: v If the data set is a checkpoint data set and JES2 is in
NODE NUMBER ON CONNECT STATEMENT EXCEEDS initialization, JES2 initiates a checkpoint
reconfiguration dialog. If JES2 is already within a
NODENUM VALUE ( nnn ) checkpoint reconfiguration, JES2 prompts the
operator for alternative actions.
JES2 final NJE initialization has determined that the
v If the $S SPOOL command was entered, the
node number specified on either the NODEA or NODEB
command is rejected and processing continues.
parameter on the CONNECT initialization statement is
greater than the maximum number of nodes specified v Otherwise processing continues without the volume.
on the NODENUM parameter on the NJEDEF System programmer response: Reallocate data set
initialization statement. dsname using a single extent.
In the message text:
Detecting Module: HASPSPOL, HASPCKDS
nnnn The maximum number of nodes.
Routing Code: 1,2,10
System action: The $HASP428 message is issued
and JES2 initialization ends. Descriptor Code: 4
Operator response: Notify the system programmer.
$HASP454
System programmer response: Either change the
value assigned to the NODEA or NODEB parameter on Explanation:
the CONNECT statement so that it is less than or equal SHOULD JES2 BYPASS THE MULTI-MEMBER
to the value assigned to NODENUM, or increase the
number specified on the NODENUM parameter on the INTEGRITY LOCK? (‘Y’ OR ‘N’)
NJEDEF initialization statement.
Detecting Module: HASPIRRE JES2 initialization has issued message $HASP479,
indicating this member cannot obtain the multi-member
Routing Code: 1,2,10 integrity lock on the checkpoint data set. JES2 has
obtained primary serialization on the checkpoint data set
Descriptor Code: 4
with a hardware reserve. JES2 prompts the operator to
reply if processing should continue without the lock.
$HASP453
System action: JES2 waits for the operator’s reply.
Explanation:
Operator response: This message prompts you to
take the lock from the holding member. Replying Y
MEMBER member-name – –
bypasses serialization. Note that replying Y
inappropriately could be harmful because the integrity of
checkpoint data might be compromised. If JES2
CKPTn
initialization should continue without the multi-member
NEWCKPTn
integrity lock on the checkpoint data set, reply Y to
direct JES2 to steal the lock. For example, you might
dsname ON volser HAS ZERO EXTENTS
reply Y in the following case:
v The JES2 member indicated in $HASP479 holds the
JES2 initialization has determined that the specified
lock but has abnormally ended, or a system failure
data set was allocated with zero extents.
has occurred while the operating system was
In the message text:
initializing a member in the configuration.
member-name
The name of the member experiencing the If you do not want to continue without the multi-member
problem. MEMBER member-name is only integrity lock on the checkpoint data set, reply N. For
included when the volser is for a checkpoint example, you might reply N is the following cases:
data set.
$HASP458 $HASP460
Explanation: Explanation:
FORWARDED CKPT n DATA SET IS UNABLE TO CONFIRM THAT
Routing Code: 2,10 xxx Either YES or NO, indicating whether the data
set is currently in use.
Descriptor Code: 4
System action: JES2 issues message $HASP417.
Operator response: Respond to message
$HASP417.
System programmer response: If the data set JES2
will use is incorrect, update the CKPTDEF initialization jobname WAS ON SYSOUT RECEIVER
statement with the correct CKPTn values and then
restart JES2. JES2 warm start found that the indicated job’s system
Detecting Module: HASPIRDA output was being received from another node when a
system failure occurred.
Routing Code: 1,2,10 In the message text:
Descriptor Code: 2,7 jobname
The name of the job.
$HASP461
Note: A jobid may precede $HASP463. See “JES2
Explanation: message format” on page 1.
jobname WAS ON JOB RECEIVER
System action: The job is queued for purge. Output
already received is discarded.
JES2 warm start found that the indicated job was being
received for processing when a system failure occurred. Operator response: None.
In the message text:
Detecting Module: HASPWARM
jobname
Routing Code: 1,2
The name of the job.
Descriptor Code: 4
Note: A jobid may precede $HASP461. See “JES2
message format” on page 1.
$HASP464
System action: The job is queued for purge.
Explanation:
Operator response: None. jobname WAS ON SYSOUT TRANSMITTER
Detecting Module: HASPWARM
JES2 warm start found that the indicated job’s system
Routing Code: 1,2 output was being transmitted to another node or being
offloaded when a system failure occurred.
Descriptor Code: 4
In the message text:
jobname
$HASP462
The name of the job.
Explanation:
jobname WAS ON JOB TRANSMITTER Note: A jobid may precede $HASP464. See “JES2
message format” on page 1.
JES2 warm start found that the indicated job was being System action: The job’s output is requeued for
transmitted to another node for processing or being transmission.
offloaded when a system failure occurred.
In the message text: Operator response: None.
jobname Detecting Module: HASPWARM
The name of the job.
Routing Code: 1,2
parameters, flags the errors, and issues a message v STATEMENT INSERTED BY INSTALLATION
requesting that JES2 be restarted. EXIT
Operator response: Notify the system programmer. v TERMINATION REQUESTED BY
Restart JES2 when the problem has been corrected. INSTALLATION EXIT
v STATEMENT INSERTED BY JES2 DEFAULT
System programmer response: Correct the line
subparameter of the RMT(nnnn) initialization statement v VERIFICATION ERROR
for this terminal. v UNABLE TO REP DATA
Detecting Module: HASPIRRE v DATA OR FORMAT ERROR
v COMMAND LENGTH ERROR
Routing Code: 1,2,10
v COMMENT ERROR
Descriptor Code: 4
This message is issued following the $HASP466
$HASP466 message when an error is encountered in a JES2
initialization statement. Because the initialization error
Explanation: forces JES2 initialization into console mode, this
initialization-parameter-statement-image message is followed by message $HASP469.
This message is issued for each initialization parameter The possible diagnostic messages are:
statement having an error when JES2 initialization is not
in console mode. All continuation cards pertaining to this END-OF-INPUT INDICATION
initialization parameter statement should be examined The parameter statement displayed in message
for errors because this message displays only the first $HASP466 was an end-of-input indication (/*
continuation card, not necessarily the continuation parameter). This is an informational message to
card(s) that have errors (bad parameters). indicate that parameter input processing stopped
This message is followed by the $HASP467 message, although an end-of-file had not been reached for
which forces JES2 initialization into console mode. The the PARMLIB parameter input data set.
$HASP467 message contains the diagnostic; the STATEMENT BYPASSED BY INSTALLATION EXIT
$HASP469 reply message gives the operator an The parameter statement displayed in message
opportunity to correct the initialization statement in error. $HASP466 was bypassed by an exit 19 routine.
If the initialization statement is not in error but the LOG This message is issued to the console only if the
control parameter is in effect, the message is sent to parameter input came from the console.
the system log.
In the message text: Note: This is a warning message, not an error
initialization-parameter-statement-image message.
The text of the initialization statement STATEMENT INSERTED BY JES2 DEFAULT
parameter. The parameter statement is inserted by default.
System action: Processing continues. STATEMENT INSERTED BY INSTALLATION EXIT
Operator response: See message $HASP469. The parameter statement displayed in message
$HASP466 was inserted by an exit 19 routine.
Detecting Module: HASPIRPL
Routing Code: 1,2,10 Note: This is an informational message, not an
error message.
Descriptor Code: 4
TERMINATION REQUESTED BY INSTALLATION
EXIT
$HASP467 An exit 19 routine requested a stop of JES2
Explanation: initialization when it was passed the associated
(1) parameter statement.
diagnostic VERIFICATION ERROR
A VERIFY statement was entered but the storage
being verified does not contain the data that was
Notes:
specified on the statement.
1 diagnostic is one of the following:
The verification error causes JES2 to ignore all
v END-OF-INPUT INDICATION subsequent REP statements until JES2 encounters
v STATEMENT BYPASSED BY INSTALLATION a NAME statement.
EXIT
UNABLE TO REP DATA commands result in the same messages and message
The JES2 REP facility was unable to replace the ids as those commands. Depending on what information
data at the specified storage location. The most you specified on the DISPLAY statement, the response
probable cause of this error is that the specified is one of the following:
storage is read-only. An example of read-only v The text of a message in the DISPLAY statement or
storage is storage in the pageable link pack area command.
(PLPA).
v All of the keywords defined on the specified
If a VER statement failed, JES2 ignores initialization statement or command and their current
subsequent REP statements until it encounters a values (if the statement name is specified without any
NAME statement. keywords).
DATA OR FORMAT ERROR v Certain keywords defined on the initialization
The format of the data specified on a JES2 VER or statement or command and their associated values (if
REP facility statement is incorrect. Some possible the statement name and those keywords are
errors are: specified on the DISPLAY statement or command).
v JES2 has not yet loaded the module specified on
In the message text:
a statement.
v The installation used incorrect delimiters to statement
separate fields on a statement. The initialization statement or command.
v The statement does not contain enough fields. value The value of that parameter.
v The module name exceeds eight characters. text Lists all of the keywords on the initialization
COMMAND LENGTH ERROR statement or command.
A command in the JES2 initialization deck exceeds
132 characters. Note: Placement of the DISPLAY initialization control
statement influences whether JES2 will display
COMMENT ERROR coded or default options. It is recommended that
A command in the JES2 initialization deck contains you place the DISPLAY statement following the
an invalid comment. initialization statement to be displayed.
See message $HASP003 for more information. System action: Processing continues.
CANCEL, OR END
$HASP468
Explanation: JES2 initialization is requesting the operator to enter
statement keyword=value,... either an initialization statement or a control statement.
text
System action: JES2 waits for the operator to reply.
This message contains the response to the DISPLAY Operator response: Reply with one of the following
initialization control statement when the following are responses:
true: v Initialization statement – This response allows you to
v The statement requested the display of a fixed text change an initialization statement. After you have
string or entered the initialization statement, and JES2 has
processed it, JES2 reissues this message. If you
v The statement requested a display for all or part of a
have no further statements to add, respond with END
JES2 initialization statement for which there are no
and JES2 processing resumes.
JES2 operator commands.
v Control statement – This response allows you to
Display requests for JES2 initialization statements that submit a control statement. After you have entered
share common definitions with JES2 $D and $T the control statement, and JES2 has processed it,
System action: JES2 processing continues. System action: JES2 issues message $HASP454.
Operator response: Verify the information is correct. If Operator response: Respond to message
it is not correct, notify the system programmer. $HASP454.
System programmer response: If the checkpoint System programmer response: Determine why the
data set specification is not correct, stop JES2 as soon checkpoint data set lock is not being released.
as possible. Determine the cause of the problem, Detecting Module: HASPIRDA
correct it, and restart JES2. When JES2 comes up,
check for possible spool damage. Routing Code: 1,2,10
A warm start was requested when both CKPT1 and System action: JES2 waits for the operator to reply. If
CKPT2 were in use. When JES2 began to read the data the system programmer directs you to respond ’Y’,
sets, it discovered that they were from separate cold JES2 rebuilds the job queue and forces the JES2 start
starts and it could not accurately determine which data option REQ which then prompts an additional response
set is more current. Because of this, JES2 will not allow to message $HASP400.
the system to come up. Operator response: Notify the system programmer.
Note: This situation can also happen if, while System programmer response: Unless you can
processing forwarded data sets, JES2 identify a procedural problem that caused a mismatch
encounters a data set with a different cold start between the checkpoint and the level of the system you
date. are initializing that you can identify and correct, a
response of Y is recommended to allow JES2 to rebuild
the queue. However, some jobs or output might be lost
In the message text:
and JES2 might change job priorities within the queue. Detecting Module: HASPJOS
During the current JES2 warm start, JES2 forces the
Routing Code: 1,2,10
REQ option, which will prompt additional operator action
(see message $HASP400). Descriptor Code: 4
Reply N, if you want JES2 to terminate to correct a
procedural problem. $HASP486
Detecting Module: HASPIRDA Explanation:
JES2 CKPT n DATA SET –
Routing Code: 1,2,10
Descriptor Code: 4 DAMAGED RECORD DETECTED
dsname ON volser
$HASP484
( strname )
Explanation:
OUTPUT QUEUES ERROR RC= rc – – JES2 initialization processing found that the previous
update made to the specified checkpoint data set
OUTPUT MAY BE LOST OR DUPLICATED (CKPT1 or CKPT2) did not complete successfully. The
checkpoint data set is assumed to be incorrect.
In the message text: In the message text:
rc rc identified the type of queue error detected. dsname
Reason codes X'80' to X'FF' are errors The data set name.
encountered in the output queue.
volser The volume serial number of the volume on
which the data set resides.
An error was found in the structure of the JES2 output
queues. strname
The name of the coupling facility structure.
System action: JES2 rebuilds the output queues to
correct the error; however, some output might be lost or n The number of the checkpoint data set (either
duplicated in the process. 1 or 2).
incorrect job queue data and issues the $HASP483 Operator response: None.
message, determine whether JES2 should rebuild the
Detecting Module: HASPIRDA
job queues and advise the operator of what reply to
give to message $HASP483. Routing Code: 1,2,10
Detecting Module: HASPIRDA Descriptor Code: 4
Routing Code: 1,2,10
$HASP489
Descriptor Code: 2,7
Explanation:
INITIALIZATION MAY NOT HAVE
$HASP487
Explanation: RELEASED CKPT DATA SET LOCK
CKPT n INVALID OPTION –
RECONFIG JES2 initialization processing has abnormally ended
without releasing the checkpoint data set lock on the
COLD START DENIED first track of the checkpoint data set.
WARM
System action: Other systems in the multi-access
spool configuration issue message $HASP264 when
While other systems were running in the multi-access
they detect the above condition. Other systems going
spool configuration, the CKPTn or RECONFIG
through initialization processing issue message
initialization option was specified either on a cold start
$HASP479 when they detect the above condition.
or on a warm start of a single system. These options
are not allowed when you are performing a single Operator response: See the descriptions of
system start and other systems are running. messages $HASP264 and $HASP479.
In the message text:
System programmer response: Determine why the
n The number of the checkpoint data set. The checkpoint data set lock was not released.
number is either 1 or 2.
Detecting Module: HASPIRA
System action: JES2 processing ends.
Routing Code: 1,2,10
Operator response: Either restart JES2 without the
CKPTn or RECONFIG initialization option or stop JES2 Descriptor Code: 4
on all other systems in the multi-access spool
configuration and perform an all-member warm start. $HASP490
Detecting Module: HASPIRDA Explanation:
Routing Code: 1,2,10 HOT START DENIED – RE-IPL REQUIRED
Note: This can also occur in a single-system Operator response: Re-IPL the system and perform a
configuration if the checkpoint data set lock was warm start of JES2.
not reset. Detecting Module: HASPIRA, HASPIRMA
System action: JES2 initialization processing cannot Routing Code: 1,2,10
continue until it has exclusive control of the checkpoint
data set lock. Initialization processing attempts to obtain Descriptor Code: 4
the checkpoint data set lock once each second for the
next 30 seconds. If JES2 cannot obtain the lock,
message $HASP479 is issued. If JES2 can obtain the
lock, initialization processing continues.
System action: JES2 initialization ends. SPOOL VALIDATION WAS DONE DUE TO
PRIOR INTERRUPTED VALIDATION
Operator response: Re-IPL the member and perform A previous all-member warm start was
a warm start for JES2. interrupted in the middle of validating
Detecting Module: HASPIRDA or rebuilding the track group map. The
validation must be completed before
Routing Code: 2,10 JES2 can initialize, even if
SPOOL=NOVALIDATE was specified.
Descriptor Code: 4
SPOOL VALIDATION WAS BYPASSED DUE
TO BERT SHORTAGE
$HASP492
The track group map could not be
Explanation: rebuilt because not all jobs could be
subsystem processed. The jobs that were not
processed required more BERTs than
ALL–MEMBER WARM START were available.
COLD START
System action: JES2 processing continues.
MEMBER memname WARM START
HOT START Operator response: None.
QUICK START
Detecting Module: HASPWARM
RESTART
Routing Code: 1,2,10
HAS COMPLETED
text Descriptor Code: 4
v For an all-member warm start, SPOOL=VALIDATE System action: JES2 processing ends.
was included on the start JES2 command and JES2
Operator response: Notify the system programmer.
validates the track group map.
System programmer response: Ensure that the
When initialization completes, JES2 deletes this buffer size does not exceed 4096 bytes.
message from the console.
Detecting Module: HASPIRMA
In the message text: Routing Code: 1,2,10
subsystem Descriptor Code: 4
The name of the address space as specified
on the MVS START command.
$HASP496
memname
Explanation:
The name of this member of the MAS
configuration as defined by OWNMEMB on the statement keyword=xxxxxxxx
$HASP494 xxxxxxxx
The value of the parameter specified on the
Explanation: initialization statement
HOT START DENIED – INVALID MEMBER ID
yyyyyyyy
The value of the parameter saved in the JES2
An attempt was made to perform a hot start on a
checkpoint.
member of a MAS configuration, but the OWNMEMB
parameter on the MASDEF initialization statement System action: If the message text states SAVED
specified a member name different from the name in VALUE OF Y WILL BE USED, then the probable cause
use when the member was last active. is an operator command that was issued to update the
parameter, but the initialization statement was not
System action: JES2 processing ends.
updated. JES2 initialization will continue normally (using
Operator response: Notify the system programmer. the saved value of the parameter).
System programmer response: Correct the member If the message text states CANNOT BE CHANGED
name specified on the OWNMEMB parameter on the FROM SAVED VALUE OF Y, then a conflict exists for a
MASDEF initialization statement and then have the statement that cannot be updated on this type of start.
operator restart JES2. This may indicate that an incorrect initialization deck
was used to start JES2. If the correct initialization deck
Detecting Module: HASPIRDA
was used, then an incorrect start was used to update
Routing Code: 1,2,10 the parameter. See z/OS JES2 Initialization and Tuning
Reference for the correct procedures to update the
Descriptor Code: 4 parameter. If any $HASP496 messages have this
format, then JES2 will issue the $HASP441 message to
$HASP495 determine if JES2 initialization should continue with the
saved value.
Explanation:
PP BUFFER SIZE EXCEEDS 4096 If the message text states CANNOT BE CHANGED
FROM SAVED VALUE OF Y AND MUST BE
CORRECTED TO START JES2, then a conflict exists
When used to calculate the size of the print/punch (PP)
for a statement that cannot be changed on this type of
buffer, the size of the job output element (JOE) caused
start. You must correct the initialization statement, or do
the PP buffer to exceed the maximum allowable (4096)
a cold start to change the parameter. This message will
bytes.
be followed by message $HASP428. System action: JES2 waits for the operator to reply.
Operator response: See message $HASP422. Operator response: Notify the system programmer of
the error and respond to this message.
System programmer response: See message
$HASP422. If JES2 should rebuild the output queues, reply Y to this
message. The FIFO queuing structure will be lost in the
Detecting Module: HASPWARM, HASPIRDA
rebuild process. Some output may also be lost.
Routing Code: 1,2,10
If JES2 should not rebuild the output queues, reply N to
Descriptor Code: 4 this message. JES2 issues the $HASP428 message
and then ends.
the JES2 subsystems at one or both ends of the the proper $S N command. (See z/OS JES2
connection have many modifications. Commands). If the problem continues, notify the system
programmer.
System action: JES2 rejects the signon and continues
processing. System programmer response: Examine incoming
data buffers on this line to determine if the session
Operator response: Notify the system programmer.
partner is violating SNA protocols.
System programmer response: Check user
Detecting Module: HASPNPM
modifications to ensure the maximum resistance values
are not exceeded. Routing Code: 1,2,8,10
Detecting Module: HASPNPM Descriptor Code: 4
Routing Code: 1,2,8,10 LINE NOT TRANSPARENT, RC=09
Descriptor Code: 4 Explanation: The line did not have the
text-transparency capability. LINE(nnnn) initialization
INVALID CONTROL SEQUENCE, RC=06
statements define capabilities for lines.
Explanation: The proper connection protocol was not
System action: JES2 rejects the signon and continues
followed.
processing.
System action: JES2 rejects the signon and continues
Operator response: Notify the system programmer.
processing.
System programmer response: Check line
Operator response: Notify the system programmer.
capabilities and, if they are incorrect, correct the
System programmer response: Check for consistent specifications on the LINE(nnnn) initialization
connection definitions. statement(s). Install text transparency or use alternate
lines for NJE communications.
Detecting Module: HASPNPM
Detecting Module: HASPNPM
Routing Code: 1,2,8,10
Routing Code: 1,2,8,10
Descriptor Code: 4
Descriptor Code: 4
CONNECTION INCLUDES LOCAL NODE AND
MEMBER, RC=07 NECESSARY STORAGE NOT AVAILABLE, RC=10
Explanation: JES2 received a connection record that Explanation: An insufficient amount of storage was
defines an already active connection for a member on available for the connection.
the local node.
System action: JES2 rejects the signon and continues
System action: JES2 rejects the connection record processing.
and continues processing.
Operator response: Notify the system programmer.
System programmer response: Examine trace
System programmer response: Determine why
identifier 24 to determine the source of the record and if
storage is not available. When storage is available,
the connection as defined at the source node needs to
notify the other system that it needs to reconnect.
be corrected.
Detecting Module: HASPNPM
Detecting Module: HASPNPM
Routing Code: 1,2,8,10
Routing Code: 1,2,8,10
Descriptor Code: 4
Descriptor Code: 4
CES EXCEEDS TOLERANCE, RC=11
INVALID NCC RECORD, RC=08
Explanation: A node attempted to sign on to a line
Explanation: The network connection control (NCC)
connected to this system but the value of their
record contained an incorrect length. The length field
connection event sequence (CES) is greater than the
contains either a zero value or a length value that
sum of the TOD clock plus the value of TIMETOL
extends the current record beyond the end of the data
specified on the NJEDEF initialization statement.
buffer. This message may indicate hardware I/O errors
or that an incorrect record was built by another node or System action: JES2 rejects the signon attempt.
MAS member.
Operator response: Either increase the value of the
System action: JES2 purges the data buffer and NJEDEF TIMETOL parameter or correct the time on
schedules the line for signoff. one of the two systems involved.
Operator response: Reestablish the connection with
Note: To correct the time, re-IPL the system. Do not System action: JES2 rejects the connection record.
use the MVS SET command to set the time.
System programmer response: Examine trace
System programmer response: None. identifier 21 to determine the identity of the node
attempting to signon and ensure the features requested
Detecting Module: HASPNPM
by that node are correct.
Routing Code: 1,2,8,10
Detecting Module: HASPNPM
Descriptor Code: 4
Routing Code: 1,2,8,10
INVALID MEMBER(S) – nodename (member#), RC=12
Descriptor Code: 4
Explanation: JES2 received a status record on line
nodename INCORRECT VALUE FOR PATHMGR,
lna for a connection between 2 nodes where either the
RC=15
primary or secondary member number is not valid.
Explanation: JES2 detected a node that either:
In the message text:
v Attempted to sign on as a JES2 node but was
nodename defined with PATHMGR=NO
The name of the node of the invalid member
v Attempted to sign on as a non-JES2 node but was
number.
defined with PATHMGR=YES.
member#
The member number specified in the record. Note: This error might occur if you are trying to connect
a JES2 node that contains a CONNECT
System action: JES2 rejects the record.
statement with a JES2 node that contains
Operator response: Notify the system programmer. PATHMGR=YES. In JES2 versions before 4.1.0,
specifying a CONNECT statement was
System programmer response: Examine trace equivalent to defining the node as
identifier 24 to identify the source of the record in error PATHMGR=NO. This would cause the node to
and isolate the member transmitting the erroneous sign on as a non-JES2 node.
records.
The member must equal 1 for JES2 nodes at JES2 In the message text:
Version 5 and OS/390.
nodename
Detecting Module: HASPNPM The name of the node that attempted to sign
on.
Routing Code: 1,2,8,10
System action: JES2 rejects the connection record.
Descriptor Code: 4
System programmer response: Do the following:
FUTURE CES BETWEEN nodea AND nodeb, RC=13
v If the definition of the node is incorrect:
Explanation: JES2 received a connection record with 1. Use the $T NODE(nnnn) command to correct the
a CES value that exceeds the value specified on the definition of the node so that the value of the
TIMETOL parameter of the NJEDEF initialization PATHMGR parameter agrees with the software in
statement. use on the node.
In the message text: 2. Update the NODE(nnnn) initialization statement
for the node with the correction.
nodea and nodeb
The nodes represented on the connection v If the definition of the node is correct:
record. 1. Use the Environmental Recording, Editing and
Printing Program (EREP) to format the logrec
System action: JES2 rejects the connection record.
data set.
System programmer response: Examine trace 2. Locate the symptom record for this time period
identifier 24, which contains the rejected record for the with the description NCC RECORD REJECTED.
nodes and members involved.
3. Contact the IBM Support Center for assistance.
Detecting Module: HASPNPM v Check the CONNECT statements on both nodes. If
Routing Code: 1,2,8,10 one of the nodes contains a CONNECT statement
and the other node has PATHMGR=YES, check the
Descriptor Code: 4 version of the nodes involved. See z/OS JES2
UNSUPPORTED SIGNON FEATURES, RC=14 Initialization and Tuning Reference for more
information about conditions when using the
Explanation: A node attempted to signon to this node, CONNECT statement.
requesting a feature not supported by line vvvvvvvv.
Detecting Module: HASPNPM
Explanation: JES2 received a status record on line Operator response: Verify that the time-of-day clock
lna for a connection between 2 nodes where the on each node is set correctly. Attempt to restart the NJE
primary node and member are the same as the session at some later time.
secondary node and member. System programmer response: This problem can be
In the message text: caused if a node was IPLed with a time-of-day clock
value that is less than that used when the system was
nodename brought down. If this is the case, NJE cannot be
The name of the node specified in the record. restarted until the time-of-day clock has reached the
CES last associated with the connection. Use the $D
member#
CONNECT command to display the CES associated
The member number specified in the record.
with a connection.
System action: JES2 rejects the record.
Detecting Module: HASPNPM
Operator response: Notify the system programmer.
Routing Code: 1,2,8,10
System programmer response: Examine trace
Descriptor Code: 4
identifier 24 to identify the source of the record in error
and isolate the member transmitting the erroneous DUPLICATE CES BETWEEN nodea(memba) and
records. nodeb(membb), RC=20
Detecting Module: HASPNPM Explanation: JES2 received a network connection
control (NCC) record on line lna. This record has the
Routing Code: 1,2,8,10
same connection event sequence (CES) value as the
Descriptor Code: 4 current known status of the connection, but a different
resistance value.
INCORRECT MULTI-TRUNK PROTOCOL, RC=18
In the message text:
Explanation: During NJE signon processing, JES2
determines that the two nodes do not agree that this is nodea and nodeb
the first line to connect the two nodes. Either the issuing The nodes represented in the connection
node has: record.
v multiple lines to the other node, but the network memba and membb
connection control (NCC) record indicates this is the The members represented in the connection
first line or record.
v no other line to the other node, but the NCC record
System action: JES2 rejects the record.
indicates that this is not the first line.
System programmer response: This message is
System action: JES2 signs off all lines on this
most likely indicative of a problem which occurred at You may be able to complete the signon by either:
node nodea or nodeb, rather than at this node, which is v Restarting any lines that are hung in signon and
just detecting the error. At nodea and nodeb, examine attempting to sign them on again, or
the trace id 21-24 to determine the origin of conflicting
v Restarting member member-name
NCC records. If possible, restart all connections
between nodea(memba) and nodeb(membb) to
establish a new CES for the connection. For additional information on dumping JES and JESXCF
address spaces and restarting the JESXCF address
Detecting Module: HASPNPM space, see z/OS MVS Programming: JES Common
Coupling Services.
Routing Code: 1,2,8,10
Detecting Module: HASPNPM
Descriptor Code: 4
Routing Code: 1,2,10
SECURE SIGNON FAILURE, RC=21
Descriptor Code: 2,7
Explanation: JES2 received a signon network
connection control record on line lna. The encrypted
string in the signon record does not match the expected $HASP502
value. This is either because the encryption key
specified on the other end of the connection does not Explanation:
match the encryption key on this end of the connection, NETWORK PATH MANAGER FUNCTIONS
or the other end of the connection is not using a secure
signon protocol. SUSPENDED
System action: JES2 rejects the signon record. A severe error occurred in the network path manager.
System programmer response: Verify that the JES2 attempted recovery of the path manager, but the
encryption key specified in the APPCLU profile for this attempt failed.
node and the adjacent node are correct. System action: JES2 suspends network job entry
(NJE) functions but continues with other processing. If
$HASP501 this JES2 member is part of a multi-access spool
(MAS), the members in the MAS will also consider this
Explanation: member down from an NJE standpoint until the failing
NJE SIGNONS DELAYED, RESPONSES NOT MAS is restarted.
RECEIVED FROM MEMBER member-name Operator response: Notify the system programmer.
System programmer response: Analyze the dumps
JES2 is unable to complete an NJE signon because JES2 wrote and locate the cause of the problem. See
information was requested from another member of the z/OS JES2 Diagnosis for assistance in analyzing the
MAS, and that member has not yet responded to the dumps. If the error is in JES2 code, contact the IBM
request. Support Center. When possible, restart JES2 to recover
In the message text: the lost networking functions.
member-name Detecting Module: HASPNPM
The name of the member that has not
responded Routing Code: 1,2,10
v ’RESTART’ — DISCONNECT AND RESTART The network path manager has failed. A recovery
LINE lna attempt, which included rebuilding the path manager
v ’DISC’ - DISCONNECT LINElna control blocks, received errors too serious to continue.
This message requests the operator to reinitialize all
v ’CONT’ - DO NOT DISCONNECT LINElna
network job entry (NJE) resources in an attempt to
restart networking functions.
A failure occurred while the path manager was
processing an NCC record received on LINElna from System action: JES2 issues message $HASP272
node nodename. prompting the operator or system programmer to enter
a valid response to $HASP503. If the operator or
In the message text: system programmer enters a response other than one
listed in the message text, JES2 issues message
lna The number of the line. $HASP299 until a correct response is entered.
nodename Operator response: Contact the system programmer.
The name of the node.
System programmer response: If the failures are
System action: JES2 issues message $HASP272 infrequent, disconnecting and restarting the nodes may
prompting the operator or system programmer enters a be adequate recovery. However, frequent failures
valid response to message $HASP503. If the operator require that you restart the nodes manually with
or system programmer enters a response other than additional debugging aids, for example, traces, in place.
one listed in the message text, JES2 issues message
$HASP299 until a correct response is entered. Detecting Module: HASPNPM
Routing Code: 1,2,10 System programmer response: Either restart the line
with a lower resistance or increase the value of
Descriptor Code: 4
NJEDEF RESTMAX=.
Detecting Module: HASPNPM
$HASP507
Routing Code: 1,2,10
Explanation:
COULD NOT CREATE DESTID Descriptor Code: 4
GREATER THAN RESTMAX (max) JES2 displays this message after initialization when the
RMTNUM= parameter on the TPDEF initialization
statement has been increased because the number for
JES2 has successfully signed on to another node but
a defined RJE workstation is greater than this
the resistance of the connection is greater than the
parameter value. In the message text:
current value of NJEDEF RESTMAX=.
In the message text: nnnn The highest number for an RJE workstation
defined on this member at initialization.
node Name of one of the nodes in the connection.
System action: Processing continues.
m Member number corresponding to node.
Operator response: None.
linenum
Line over which the signon occurred. Detecting Module: HASPIRPL
rest Resistance of connection. Routing Code: 1,2,10
max Current value of NJEDEF RESTMAX. Descriptor Code: 4
System action: Signon is allowed to complete. Data
can be received over the line but no data is sent.
Operator response: Contact the system programmer.
Notes:
$HASP512
1 text is one of the following:
Explanation:
REMOTE DESTINATION TABLE v ACCESSING GROUPING DATA
v FREEING GROUPING DATA
ERROR NAME= name v FREEING SWBTUREQ WORK AREA
v USING SWBTUREQ RETRIEVE SERVICE
An error was detected while building the remote
destination table named in the message text. The error v SJFREQ SERVICE SET ERROR CODE
occurred because either: v SWBTUREQ SERVICE SET ERROR CODE
v A NODE statement or a DESTID statement specified v USING SJFREQ KEYLIST SERVICE
a node number higher than the NODENUM specified v USING INSTALLATION EXIT 41
on the NJEDEF statement, or
v When defining the destination, an incorrect DEST= The SYSOUT receiver devname abnormally ended.
parameter was detected, or the symbolic DEST=
parameter was used as a DESTID subscript or node In the message text:
name in a subsequent initialization statement.
jobid The job identifier.
In the message text: jobname
The name of the job.
name The name of the remote destination table.
devname
System action: JES2 deletes the remote destination
The name of the failed device.
table (RDT) entry.
System action: If the error only affects the current job,
Operator response: Notify the system programmer.
JES2 purges that job and the SYSOUT receiver
System programmer response: Examine the continues to process other jobs. If the error affects all
initialization statements to determine which of the errors work for devname, JES2 issues message $HASP514
described above is causing the problem. Then do one and ends the SYSOUT receiver.
of the following:
Operator response: Dump JES2 and notify the
v Either change the node number on the NODE or system programmer of the error.
DESTID statement, OR increase the NODENUM
value on the NJEDEF initialization statement. System programmer response: Examine dump to
determine the cause of the error. If unable to find the
v Either change the destination of the NODE or
cause, contact the IBM Support Center.
DESTID statement OR change the sequence of
DESTID/NODE statements in the initialization stream. Detecting Module: HASPNSR
The DESTID statement that was flagged as an error
should appear AFTER the initialization statement that Routing Code: 10
creates the destination name (that is, the name must Descriptor Code: 4
be defined before it is used).
rejects the incoming job. The sending node places the nnnnn The number of JQEs requeued to either the
output into hold. free or rebuild queue.
Operator response: Notify the system programmer. text is one of the following:
System programmer response: The system ELEMENT(S) DISCARDED
programmer at the sending node should ensure that During an all-member warm start,
only one JDVT name is in use. damaged JQEs were moved to the
free queue.
Detecting Module: HASPNSR
ELEMENT(S) PENDING DISCARD
Routing Code: 8,10
During a JES2 warm start (quick, hot,
Descriptor Code: 4 single-member) damaged JQEs were
moved to the rebuild queue awaiting
discard. The rebuild queue temporarily
$HASP516 holds jobs (JQEs) that were actively
Explanation: being processed on either this MAS
ERROR OBTAINING JCL GROUPING KEYWORDS member or another. JES2 returns
these JQEs to the free queue at a
later time.
(1) System action: JES2 processing continues. Some
– text jobs and their output might have been lost in the
recovery process.
Notes: Operator response: None.
1 text is one of the following: System programmer response: None.
v STORAGE IN EPVT IS NOT AVAILABLE Detecting Module: HASPJOS
v STORAGE IN ECSA IS NOT AVAILABLE
Routing Code: 1,2,10
v UNDEFINED JCL DEFINITION NAME
v CALLER IS NOT INITIALIZATION PCE Descriptor Code: 4
jobname
$HASP523
The name that appears as the job name on the
Explanation: JOB JCL statement.
jobname – – devname DELETED
devname
The JES2 identifier for the device reading in
The indicated job, which was being transmitted by the the job.
job transmitter indicated by devname has been
canceled. programmer
In the message text: The information contained in the programmer
name field on the JOB JCL statement, if any.
jobname
The name of the job. userid The userid associated with the job as specified
by the USER parameter on the JOB JCL
devname statement or as propagated by the MVS
The name of the device. security authorization facility (SAF). If JES2
cannot identify the userid that originated this
Note: A jobid may precede $HASP523. See “JES2 job, this field will display *UNKNOWN.
message format” on page 1.
nodename
System action: JES2 queues the job for output. The name of the node from which this job
Operator response: None. originated. If JES2 cannot identify the node
from which this job originated, this field will
Detecting Module: HASPNJT display *UNKNOWN.
Routing Code: 1,2,7
Note: A job identifier may precede message
Descriptor Code: 4 $HASP525. See “JES2 message format” on
page 1.
$HASP524 System action: Unless rerouted, the job is forwarded
to its final destination when a path is available.
Explanation:
devname INACTIVE Operator response: None.
Detecting Module: HASPRDR
The job transmitter indicated by devname has
completed transmitting its current job and has found no Routing Code: 7
more jobs that it can transmit.
Descriptor Code: 4
In the message text:
devname
$HASP526
The name of the device.
Explanation:
System action: The job transmitter waits for a job to
jobname TRANSMITTED FOR EXECUTION AT nodename
be added to the transmission queue.
Operator response: None. The indicated job has been transmitted from its system
of origin to the indicated node for processing. This
Detecting Module: HASPNJT message appears on a TSO terminal, not on the
Routing Code: 1,2,7 operator’s console, and only appears if the indicated job
specified NOTIFY=userid on its job card. If apostrophes
Descriptor Code: 4 are imbedded in the job name, they are replaced by
quotation marks.
$HASP525 In the message text:
Explanation: jobname
jobname ON devname The name of the job.
programmer nodename
The name of the node.
FROM userid AT nodename
Note: A jobid may precede $HASP526. See “JES2
An intermediate node received a job statement on the message format” on page 1.
indicated device.
In the message text: System action: The job is purged from the originating
system and will not be accessible using TSO
STATUS/CANCEL/OUTPUT until its output (if any) is Note: A job identifier precedes this message. See
received. “JES2 message format” on page 1.
Operator response: None. System action: The system continues processing.
The system also issues message $HASP686.
Detecting Module: HASPNJT
Operator response: Do the following:
Routing Code: 8
1. Note the line number and job identifier displayed in
Descriptor Code: 4 this message.
2. Enter a $D J command to determine the destination
$HASP527 of the job or SYSOUT.
Explanation: jobname
LINElna INPUT HELD – – The name of the job
jobid The original jobid of the job
NJE HOP COUNT EXCEEDED
origin-node
The node at which the job was submitted
JES2 has held a job or SYSOUT entering this system
from the network. The hop count in the header of the adjacent-node
job or SYSOUT is greater than the maximum number of The ‘store-and-forward’ node sending the job to
hops specified in the MAXHOP parameter of the the detecting node. If THROUGH
NJEDEF initialization statement. This message could adjacent-node does not appear in the message
indicate a possible loop in the network. text, the job was received directly from the
In the message text: origin-node, that is, there is no
‘store-and-forward’ between the origin and
lna The line number.
detecting nodes.
Routing Code: 8,10 Note: An incorrect data block could result from the
interruption of a job before the last write to an
Descriptor Code: 4 obtained track could be completed. In this case,
the message does not indicate an error.
$HASP530
The first form of this message is displayed on the
Explanation: operator’s console. The second form of this message is
jobname ON devname transmitted as the last line of the data set for
programmer information.
nnnn RECORD In the message text:
S
jobname
The name of the job.
SYSOUT data sets for the indicated job are being
transmitted by the SYSOUT transmitter indicated by devname
devname. The name of the device.
In the message text:
nodename
jobname The name of the node.
The name of the job.
Note: A jobid may precede $HASP531. See “JES2
devname
message format” on page 1.
The name of the device.
System action: Further reading and transmission of
nnnn The number of records associated with this job.
the current data set is halted. The SYSOUT transmitter
continues processing with the next data set. set. The data set is marked non-selectable to avoid
immediate retransmission.
Operator response: Notify the system programmer.
Operator response: If JOB HELD appears in the
System programmer response: To determine if
message, determine whether the JOB was correctly
hardware I/O errors have occurred on the JES2 spool,
received before releasing it. If OUTGROUP
check the system log for message $HASP094 and any
NON-SELECTABLE appears in the message, the
other messages indicating spool hardware I/O errors.
non-selectable data set can be displayed using the $L
Also, check the system log during the job’s processing
command and the data set can be made selectable for
for an abend, which would result in an incomplete data
retransmission using the $T command.
block. Use this information to correct the problem.
Detecting Module: HASPNST Note: This message can also be issued when the
SYSOUT transmitter attempts to send an NJE
Routing Code: 8,10
job to a receiving node that does not have job
Descriptor Code: 4 authority on the sending node definition. Ensure
that the receiving node has your node correctly
defined and check your definitions for that node
$HASP532 by doing the following:
Explanation: 1. Enter a $D JOBQ ’jobname’ command for the
jobname – – devname RESTARTED job indicated in the $HASP522 message.
2. This will result in the $HASP890 message,
providing the target node id.
,JOB HELD
,OUTGROUP NON-SELECTABLE 3. Enter a $D NODE command for that id to
receive the $HASP826 message, which
displays the settings for that node.
One of the following occurred:
4. Enter the $T NODE command to define the
v The operator has entered a $E command directed to target node for job authority, if necessary.
the SYSOUT transmitter indicated by devname.
v The transmitter has received an error indication from Detecting Module: HASPNJT
RTAM. Routing Code: 8
v The sending node does not have the proper authority
Descriptor Code: 4
defined for the target node. (See the note under
Operator Response.)
$HASP533
In the message text:
Explanation:
jobname jobname – – devname DELETED
The name of the job.
devname The operator has entered a $C command directed to
The name of the device. the SYSOUT transmitter indicated by devname or has
canceled the job and specified the purge operand.
In the message text:
Note: A jobid may precede $HASP532. See “JES2
message format” on page 1. jobname
The name of the job.
System action: The SYSOUT transmitter stops
transmitting data sets for its current job and issues an devname
RTAM “close” to cause the SYSOUT receiver to delete The name of the device.
any output it has already received (that is, purge the
received job). The transmitter will place the JOEs it has Note: A jobid may precede $HASP533. See “JES2
acquired back in the network JOE queue for message format” on page 1.
transmission at a later time.
System action: The SYSOUT transmitter stops
If JOB HELD appears in the message, the transmitter transmitting data sets for its current job and issues an
received an error indication from RTAM when sending a RTAM “negative close” to cause the SYSOUT receiver
job header, job trailer, or an end-of-file. The job is held to delete any output it has already received (that is,
to avoid immediate retransmission in case the job was purge the received job). The transmitter will remove the
actually received correctly. job output elements (JOEs) it has acquired from the
If OUTGROUP NON-SELECTABLE appears in the network JOE queue. The data sets represented by the
message, the transmitter received an error indication JOEs will not be available for output. If, after removing
from RTAM when sending a data set header or a data the JOEs, there is no more work to be performed for the
job, the job will be queued for purging.
The SYSOUT transmitter indicated by devname has JES2 could not connect to the coupling facility structure
completed transmitting its current job and has found no for the specified checkpoint data set.
more work to send in the network job output element In the message text:
(JOE) queue.
In the message text: strname
The name of the coupling facility structure.
devname
The name of the device. CKPT1 JES2 was attempting to connect to the
coupling facility structure strname for CKPT1.
System action: JES2 processing continues.
CKPT2 JES2 was attempting to connect to the
Operator response: None. coupling facility structure strname for CKPTn.
Detecting Module: HASPNJT rc Hexadecimal return code from the connect
Routing Code: 8 service. See z/OS MVS Programming: Sysplex
Services Reference.
Descriptor Code: 4
rsn Hexadecimal reason code from the connect
service. See z/OS MVS Programming: Sysplex
$HASP535 Services Reference.
Explanation: errcode, text
CKPT MODE FORCED TO One (or more) of the additional decimal codes
and accompanying text messages provided by
DUPLEX DUE TO USE OF STRNAME strname JES2.
JES2 was requested to run in DUAL mode for The first four digits display the return codes for the
checkpoint data set operations. However, one or both of IXLCONN macro, while the next four digits display the
the active data sets resides in a coupling facility reason code field. The following list shows ERRCODE
structure (the STRNAME= subparameter was specified and text:
for both the CKPTn= parameter and the NEWCKPTn
parameter on the CKPTDEF initialization statement); 01, STRUCTURE DOES NOT HAVE A DISP OF KEEP
JES2 will not operate in DUAL mode if a coupling
facility structure is used for a checkpoint data set. In the Explanation: Specifies that this structure was not
message text: initially allocated by JES2.
Explanation: Specifies that this structure was not 09, ACTIVE CONNECTION ALREADY EXISTS
initially allocated by JES2.
Explanation: Specifies that a system with the same
System programmer response: Ensure that you name (MASDEF OWNMEMB=member) is already
have specified the correct value for STRNAME. If you connected to the structure.
have, delete the structure and let JES2 attempt to
System programmer response: Either change the
connect to it again. If this method does not succeed,
MASDEF OWNMEMB= name for this system or bring
specify a new value for STRNAME.
the other system down.
04, STRUCTURE DOES NOT SUPPORT NAMES
10, NO MORE CONNECTIONS AVAILABLE
REFERENCES
Explanation: No more connections are available to
Explanation: Specifies that this structure was not
the coupling facility.
initially allocated by JES2.
System programmer response: You can end the
System programmer response: Ensure that you
program of some address spaces connected to the
have specified the correct value for STRNAME. If you
structure, or change the value of STRNAME and let
have, delete the structure and let JES2 attempt to
JES2 attempt to connect to the structure again.
connect to it again. If this method does not succeed,
specify a new value for STRNAME. 11, STRUCTURE IS NOT IN ACTIVE POLICY
05, STRUCTURE DOES NOT HAVE ENOUGH LIST Explanation: The structure accessed for the
HEADERS checkpoint data set is defined in a coupling facility
resource management (CFRM) administrative policy that
Explanation: Specifies that this structure was not
is not currently active at your installation.
initially allocated by JES2.
System programmer response: For more information
System programmer response: Ensure that you
on administrative policies, see z/OS MVS Setting Up a
have specified the correct value for STRNAME. If you
Sysplex .
have, delete the structure and let JES2 attempt to
connect to it again. If this method does not succeed, 12, XES IS NOT AVAILABLE
specify a new value for STRNAME.
Explanation: The XES component is unavailable.
06, STRUCTURE DOES NOT HAVE ENOUGH LOCK
ENTRIES System programmer response:
v On a cold start or an all-member warm start:
Explanation: Specifies that this structure was not
initially allocated by JES2. – Change the coupling facility name.
– Use a DASD data set (DSNAME= VOL=) instead
System programmer response: Ensure that you of STRNAME=.
have specified the correct value for STRNAME. If you
have, delete the structure and let JES2 attempt to v On a hot start, or a single member warm start
connect to it again. If this method does not succeed, – Enter the reconfiguration dialog to change the
specify a new value for STRNAME. checkpoint data set specifications.
07, STRUCTURE NOT ALREADY USED
13, MASDEF OWNMEMB= VALUE NOT VALID FOR
Explanation: Specifies that JES2 does not see XES
checkpoint data set forwarded through the
Explanation: The connection name (CONNAME= )
reconfiguration dialog.
that JES2 passed to XES is not valid. JES2 creates the
System programmer response: Ensure that you connection name by concatenating the string ‘JES2_’
have specified the correct value for STRNAME. If you with the name of the local member as specified on
have, delete the structure and let JES2 attempt to either the OWNMEMB= parameter of the MASDEF
connect to it again. If this method does not succeed, initialization statement or the default name specified as
specify a new value for STRNAME. the SID specification in the MVS SMFPRMnn PARMLIB
member.
08, STRUCTURE IS NOT LARGE ENOUGH
System programmer response: Ensure that the
Explanation: Specifies that JES2 finds structure too value specified on the OWNMEMB= parameter is valid
small for use. and contains characters that are valid as a XES
System programmer response: See z/OS JES2 connection name. Correct the OWNMEMB= value if
Initialization and Tuning Guide to determine how large necessary and allow JES2 to attempt to reconnect the
the structure should be. Either delete the structure and member. For MASDEF OWNMEMB= naming
redefine it, or change the value for STRNAME and allow convention information, see MVS/ESA SP V5 JES2 Init
JES2 to attempt to connect to a structure of the proper and Tuning Reference and for the SMFPRMnn
size. PARMLIB member, see z/OS MVS Initialization and
Tuning Reference.
(1)
$HASP540
STRUCTURE strname
Explanation:
jobname ON devname
Notes:
FROM userid AT nodename 1
Note: A job identifier may precede message System programmer response: Specify a new, larger
$HASP540. See “JES2 message format” on coupling facility structure that has been defined in the
page 1. active CFRM administrative policy. To determine the
exact size required, calculate the total storage required
System action: Processing continues. to hold aaaaaa 4K elements on the coupling facility on
which the structure is to be placed and then add that
Operator response: None.
value to cccccc. If a large enough structure does not
Detecting Module: HASPNSR, HASCNJSR exist, move the checkpoint to DASD and restart JES2.
See z/OS MVS Setting Up a Sysplex for more
Routing Code: 8
information about CFRM policies.
Descriptor Code: 4
Detecting Module: HASPCKDS
Routing Code: 2,10
$HASP542
Descriptor Code: 4
Explanation:
MEMBER member_name – –
$HASP543
Explanation:
Examples of conditions that can cause these errors to asks to confirm the checkpoint data sets, JES2
occur: connects to, but does not use, that structure. If you
1. You have a $ACTIVATed (Release 4 or higher) JES2 attempt to use this structure in a subsequent warm
member already running in the MAS, and you start, this message results.
attempt add a pre-Release 4 member. System action: JES2 enters the checkpoint
2. You have attempted to change a cold start reconfiguration dialog.
initialization parameter during a warm start (for
Operator response: Notify the system programmer
example, JOBNUM= on the JOBDEF initialization
and respond to the checkpoint reconfiguration dialog
statement). See the JES2 Initialization and Tuning
messages. If you are unfamiliar with the dialog process,
Reference for a description of initialization
see z/OS JES2 Initialization and Tuning Guide for
parameters that require a cold start.
sample scenarios.
See the JES2 Migration Notebook applicable for the System programmer response: Determine why the
highest JES2 release running in the MAS for more checkpoint data set being used is empty. If possible,
details on checkpoint compatibility. specify a different checkpoint data set either in the
JES2 initialization data set or in console mode.
In the message text:
Detecting Module: HASPIRDA
rsnc The reason code associated with the cause of
Routing Code: 1,2,10
this occurrence.
Descriptor Code: 4
rsnc Explanation
01 Specifies that more checkpoint records exist on
$HASP561
the coupling facility than JES2 expected to
process. Explanation:
NJEDEF NODENUM= mmmmm,
02 Specifies that fewer checkpoint records exist
on the coupling facility than JES2 expected to
SAVED VALUE OF nnnnn WILL NOT BE USED
process.
System action: JES2 enters the checkpoint The JES2 initialization parameter NJEDEF
reconfiguration dialog. NODENUM=mmmmm was specified, and the number of
Operator response: Notify system programmer nodes was successfully increased from nnnnn to
mmmmm.
System programmer response: Correct the
initialization parameters so that they are compatible with System action: JES2 initialization continues.
the with the cold start initialization parameters currently Operator response: None
in effect.
System programmer response: None
Detecting Module: HASPCFLE
Detecting Module: HASPIRRE
Routing Code: 1,2,10
Routing Code: 1,2,10
Descriptor Code: 4
Descriptor Code: 4
$HASP555
$HASP562
Explanation:
NO CHECKPOINT RECORDS FOUND IN CKPTn Explanation:
UNABLE TO INCREASE NJEDEF NODENUM FROM mmmmm
DATA COUPLING FACILITY STRUCTURE IS EMPTY TO nnnnn
NO CHECKPOINT RECORDS FOUND IN CKPTn UNABLE TO EXPAND JES2 CHECKPOINT TO INCLUDE nnnnn
DATA NODES
SET COUPLING FACILITY STRUCTURE IS EMPTY JES2 was unable to create checkpointed structures
large enough to contain all defined NJE nodes. The
JES2 has detected an unusable checkpoint data set number of nodes might have been increased on the
that resides on a coupling facility structure while NJEDEF NODENUM= initialization statement, or the
attempting to warm start. If you cold started with a checkpointed structures previously created (for example,
checkpoint defined on a coupling facility structure, but because an earlier release of JES2 was used).
replied ’N’ in response to the $HASP441 message that System action: JES2 prompts the operator to verity
that initialization should continue without these Operator response: Contact system programmer
checkpointed structures.
System programmer response: Contact IBM service
Operator response: Verify that the correct initialization
Detecting Module: HASPIRRE
parameters are being used and reply to the $HASP441
message as appropriate. Routing Code: 1,2,10
System programmer response: Increase the size of Descriptor Code: 4
the checkpoint as indicated by the $HASP296 or
$HASP542 message.
$HASP565
Detecting Module: HASPIRDA
Explanation:
Routing Code: 1,2,10 LINE REQUEST FROM NETSRV nn FOR nodename
Descriptor Code: 4 REJECTED - <DEDICATED LINE LINE nnnn IS NOT AVAILABLE, RC=1>
the encryption key can not be used because the Detecting Module: HASPIRRE, HASPTCP
RACF APPCLU class is not active.
Routing Code: 1,2,10
System action: The request to initiate an NJE session
Descriptor Code: 4
is rejected.
Operator response: Start a qualifying TCP/IP line,
$HASP579
and have the other node reissue the request.
Explanation:
System programmer response: Ensure that the
GETMAIN FAILED DURING DYNAMIC
correct LINE, NODE, and SOCKET definitions are
included in the JES2 initialization parameters, or define
them dynamically through $ADD or $T operator ALLOCATION ERROR PROCESSING
commands.
Following an error in the allocation of the offload data
Detecting Module: HASPTCP set, the offload subtask failed to obtain storage in which
Routing Code: 1,2,10 to place the dynamic allocation error message text.
Descriptor Code: 4 System action: JES2 drains the offload device. Other
JES2 processing continues.
Operator response: Contact system programmer. System action: JES2 drains the offload device and
continues processing.
System programmer response: Verify that the
correct initialization SOCKET= values are specified on Operator response: Notify the system programmer.
the NETSRV initialization statement. System programmer response: See z/OS MVS
Programming: Authorized Assembler Services Guide for codes. Correct the problem using the diagnostic
an explanation of each code. Correct the problem using information obtained.
the diagnostic information obtained.
Detecting Module: HASPNUC
Detecting Module: HASPSTAM
Routing Code: 2,10
Routing Code: 2,10
Descriptor Code: 4
Descriptor Code: 4
$HASP582
$HASP581
Explanation:
Explanation: OFFLOAD n RECEIVERS DRAINED
MEMBER member-name – – DRAINING
A dynamic allocation request failed. In the message Either a $S command was entered for the indicated
text: offload device and no receivers/transmitters are able to
be started, or a $P command was entered for each
member-name
active receiver while the reload operation was in
The name of the JES2 member that
progress.
experienced the error
In the message text:
device The JES2 logical device that experienced the
n The number of the offload device.
error
System action: If this message is issued during a
rc The return code from dynamic allocation
reload (RECEIVE) operation, the offload device remains
(DYNALLOC) returned in R15
halted until you start at least one receiver. You must
eeee The DYNALLOC error code (in hexadecimal in then restart the offload device to restart the reload
the S99ERROR field of the DYNALLOC operation.
parameter list)
If this message is issued during an offload (TRANSMIT)
iiii The DYNALLOC error information code (in operation, the offload device remains active and will
hexadecimal in the S99INFO field of the begin transmitting when one of the offload transmitters
DYNALLOC parameter list) has been started.
formatted-text Operator response: Enter the $S command for a
An explanation from the TSO DAIRFAIL service receiver/transmitter. If the reload operation was in
of why the allocation failed. The corrective progress, enter the $S command for the offload device
actions provided in this formatted text are to restart the operation, or enter the $P command for
expressed in terms that might only be the offload device to stop the reload operation.
applicable in a TSO environment; be certain to
Detecting Module: HASPSTAM
use the corresponding MVS or JES2 action. If
this message is preceded by $HASP253 or if Routing Code: 1,2
an error occurred in the service that generates
Descriptor Code: –
the formatted text, this formatted-text is not
displayed.
$HASP587
System action: JES2 processing continues without
allocating the device. If a JES2 checkpoint Explanation:
reconfiguration is in progress, the operator is prompted I/O ERROR READING FROM n
for an alternative action.
Operator response: If a JES2 checkpoint
reconfiguration is in progress, specify another data set – MAXIMUM EXCEEDED
name or volume serial as appropriate.
An I/O error has occurred while reading from the offload
System programmer response: See z/OS MVS data set.
Programming: Authorized Assembler Services Guide for In the message text:
an explanation of the DYNALLOC error and information
n The number of the offload device. requested on the JECL statement and if the
installation specified NOTIFY=YES for the offload
System action: If a pre-processing job is being read,
job transmitter/receiver.
the job in error is purged. If the error occurs while
SYSOUT data sets are being read, any data already 2. The jobid referencing the current JES2 jobid on this
received will be kept. system may precede $HASP588. See “JES2
message format” on page 1.
If the maximum limit of 10 consecutive errors per reload
operation has been exceeded, JES2 automatically System action: Processing continues.
drains the offload device. If the maximum limit has not Operator response: None.
been exceeded, the reload process continues with the
next job. Detecting Module: HASPNJT, HASPRDR
OFFLOADED ON yyyy.ddd
LOADED AT nodename FROM yyyy.ddd DUMP
ON yyyy.ddd
FROM yyyy.ddd DUMP jobname [(jobid FROM nnnnnnnn)]
SYSOUT { OFFLOADED } { LOADED }
[AT nodename] { ON yyyy.ddd }
The indicated job has been written to or read from the {FROM yyyy.ddd}
spool offload data set.
The indicated job’s output has been written to or read
In the message text: from the spool offload data set.
was requested on the JECL statement and the Detecting Module: HASPNSR
installation specified NOTIFY=YES for the offload
Routing Code: 11
SYSOUT transmitter/receiver.
2. The jobid referencing the current JES2 jobid on this Descriptor Code: 6
system may precede $HASP589. See “JES2
message format” on page 1. $HASP593
System action: Processing continues. Explanation:
Operator response: None. OFFLOADn START REJECTED – DEVICE
FIRST RECORD –
$HASP591
Explanation: DRAINING OFFLOAD DEVICE
I/O ERROR READING FROM SKIPPING FOR JOB HEADER
OFFLOADn DATA SET – POSSIBLE DATA LOSS JES2 determined that the first record of the data set it is
attempting to reload is not LRECL=80. The probable
An I/O error has occurred while reading a SYSOUT cause for this failure is that the reload operation was
data set from the indicated offload data set. started with an incorrect tape. The message text is
In the message text: variable based on your OFFLOADn VALIDATE=
specification.
n The number of the offload device. In the message text:
n The number of the offload device.
Note: This message is appended to the SYSOUT data
set with the error. System action: Based on the variable message text,
JES2 responds as follows:
System action: Any SYSOUT data already received
will be kept. If this is the eleventh consecutive error to DRAINING OFFLOAD DEVICE
occur for this reload operation, JES2 automatically Your initialization data set contains or defaults to
drains the offload device. If less than 11 errors have OFFLOADn VALIDATE=YES, directing JES2 to
occurred, the reload process continues with the next drain the offload device.
job.
SKIPPING FOR NEXT JOB HEADER
User response: Check your SYSOUT data sets for a Your initialization data set contains or defaults to
possible loss of data. If necessary, resubmit the job. OFFLOADn VALIDATE=YES, indicating that JES2
will continue to read the offload data set and Descriptor Code: 4
continue to pass records to the offload receiver(s).
However, the receiver(s) discards records until it
encounters a job header; it then continues normal
job processing.
Operator response: Ensure that the tape that you
have loaded is the first tape of the data set you are
reloading. Reload the correct tape and restart the reload
operation.
Detecting Module: HASPSTAM
Routing Code: 2,10
Descriptor Code: 4
$HASP599
Explanation:
START OF INITnnnn FAILED,
This keyword can appear multiple times. The value This keyword only applies to remote printers and
of d starts at 1 and increases for each character set punches.
the printer is using. This keyword is blank for
COPYMARK={DATASET|JOB|CONSTANT|NONE}
impact printers.
Specifies when this printer is incrementing the copy
This keyword only applies for local printers. marks. This keyword is DATASET for impact
printers.
CKPTLINE
The maximum number of lines in a logical page. This keyword only applies for local printers.
JES2 uses this value together with the value of
CREATOR
CKPTPAGE to determine when to checkpoint the
Specifies the user identification that created the
output data sets.
output that this device is selecting. If this keyword
This keyword only applies for local and remote is not explicitly set, the value is blank.
printers and punches.
This keyword only applies for local and remote
CKPTMODE={PAGE|SEC} printers and punches.
This keyword specifies the method JES2 is using to
DEVFCB
checkpoint output on this printer. Valid values for
Specifies the 1- to 4-character name of the forms
this keyword are PAGE and SEC. This keyword is
control buffer (FCB) that this printer is using as a
PAGE for impact printers.
default. If this keyword is not explicitly set, the
This keyword only applies for local printers. value is blank.
CKPTPAGE This keyword only applies for local printers.
Specifies the number of pages after which JES2
EJECT={YES|NO}
will checkpoint the output data set.
Specifies whether JES2 sends a page eject to a
This keyword only applies for local and remote remote printer on the printer’s first use following the
printers and punches. start of an RJE session depending upon the
assumed position of the printer. JES2 assumes that
CKPTSEC
the remote printer is not positioned at the top of a
Specifies the number of seconds after which JES2
page on the first use after JES2 is started,
will checkpoint the output data set. The value of
restarted, or after a remote session fails and the
this keyword is zero for impact printers.
remote printer is not at the top of a page.
This keyword only applies for local printers.
This parameter should be NO if this is a remote
CLASS work station that writes SYSOUT to media other
Specifies the job class assigned to jobs that enter than paper and does not need a page eject in the
the system on this device which do not have the first line.
CLASS parameter on the JOB JCL statement.
This keyword only applies to remote printers.
This keyword only applies for local and remote ENDED JES2 encountered an abend in a situation
readers. where no active recovery ($ESTAE) existed. At the
time of the abend, the device PCE in control is not
CMPCT={YES|NO} considered a required PCE for continued JES2
Specifies whether a JES2 is capable of compacting operations. The device PCE is marked ENDED and
data sent to a remote system network architecture JES2 has permanently suspended the device PCE.
(SNA) device. This keyword is NO for remote To recover the device, restart JES2.
binary synchronous communication (BSC) devices.
DEVFLASH
This keyword only applies to remote printers and The 1- to 4-character name of the forms FLASH ID
punches. that JES2 is using for this printer.
COMPRESS={YES|NO} This keyword only applies for local printers.
Specifies whether JES2 is capable of compressing
data sent to a remote SNA device. This keyword is This keyword is blank for any of the following:
NO for remote BSC devices. v If the printer does not have a forms FLASH ID
This keyword only applies to remote printers and specified
punches. v If this printer is not capable of forms flashing
COMPACT v If this is an impact printer.
Specifies the number of the compaction table JES2 FCB
is using for this device. A value of 0 for this Specifies the 1- to 4-character forms control buffer
keyword means that there is no compaction (FCB) image or the carriage control tape name that
occurring on this device. is mounted on this printer.
STD indicates that the FCB image has been This keyword only applies to local and remote
marked “STANDARD” in SYS1.IMAGELIB. If the readers and lines.
FCB is the same as the DEVFCB setting, then
HONORTRC={YES|NO}
DEFAULT is displayed. DEFAULT and STD are
Specifies whether the TRC=YES|NO parameter
mutually exclusive; they appear as follows:
specified on the job’s OUTPUT JCL statement will
DEVFCB= Resulting be honored or not honored for a given JES—mode
specified? DEVFCB=C? C=STANDARD? FCB printer. HONORTRC= only applies to JES mode
---------- --------- ----------- ---------
printer.
no N/A no (none)
no N/A yes ,STD A JES—mode printer (other than 3800 printers)
yes no no (none) strips off (ignores) the table reference character if
yes no yes (none) HONORTRC=YES and TRC=YES is specified for
yes yes no ,DEFAULT
SYSOUT.
yes yes yes ,DEFAULT
JOBNAME
This keyword only applies for local and remote Specifies the jobname for jobs to be selected by
printers. this device.
FCBLOAD Notes:
Specifies that whether JES2 provides FCB support 1. If the jobname was coded after the slash in the
for this remote printer. work selection (WS=) list, the jobname
This keyword only applies to remote printers. displayed may vary depending on the output
group being processed.
FLASH
2. If no jobname was assigned, the JOBNAME=
The 1- to 4-character name of the forms FLASH ID
field displays the name of the job currently on
that JES2 is using for this printer. This keyword is
the device.
blank if the printer does not have a forms FLASH
ID specified or if this printer is not capable of forms
This keyword only applies for local and remote
flashing.
printers and punches.
This keyword is blank for impact printers.
LASTFORM
This keyword only applies for local printers. The FCB previously used to process output on this
printer.
FLUSH={YES|NO}
Specifies whether JES2 punches a blank card This keyword only applies to local printers.
following each data set or data set copy processed
LIMIT
by this device.
Specifies the lower and upper record limits for jobs
This keyword only applies to remote punches. that this device will process. A limit of (0,*) means
that this device selects all output.
FORMS
Specifies the 1- to 8-character forms identifiers that This keyword only applies for local and remote
are loaded on this device. There can be up to 8 printers and punches and SYSOUT transmitters.
forms identifiers loaded.
LRECL
This keyword only applies for local and remote Specifies the logical record length of the data
printers. transmitted to this remote SNA device.
FSAROLTR={YES|NO} This keyword is blank for BSC devices and only
Specifies whether the internal rolling trace for an applies to remote printers and punches.
FSS printer is active for this device.
MARK={YES|NO}
FSS Specifies whether this printer is marking the edge
The name of the FSS that controls this printer. of the separator page. The value of this keyword is
NO for impact printers.
This keyword only applies to local printers.
This keyword only applies to local printers.
HOLD={YES|NO}
Specifies whether jobs entering the system on this MODE={JES2|FSS}
device are to be held until the operator releases the Specifies that this printer is either JES2-managed
job for processing. (JES2) or functional subsystem-managed (FSS).
For lines, this keyword specifies whether JES2 is This keyword only applies to local printers.
holding a particular network transmitter or receiver.
MODIFY
The name of the character set that contains any
SEPDS UCSVERFY={YES|NO}
Specifies whether this device creates data set Specifies whether JES2 is to perform UCS
separator pages for data sets within the job output verification processing when a UCS image is
elements ($JOE) selected for processing by this loaded for a 4250 or 4248 printer.
device.
This keyword is NO for printers other than local
This keyword only applies to remote and local 4250 or 4248 printers.
printers and punches.
UNIT={dev|SNA}
SETUP={HALT|NOHALT} Specifies a 4-digit hexadecimal device number
Specifies whether JES2 halts this device and assigned to this device. For system network
issues message $HASP190 after a change of architecture (SNA) networking lines, the value of
device characteristics. UNIT is SNA.
This keyword only applies to remote and local VOLUME
printers and punches. Specifies 1- to 4-spool volumes from which this
device can select output. If this keyword is (,,,) the
SPACE device can select from all spool volumes.
Specifies the spacing between lines of output.
This keyword only applies to local and remote
This keyword only applies to local printers. printers and punches.
SUSPEND={YES|NO} WRITER
Specifies whether the device-interrupt feature is Specifies the writer name assigned to this device.
active.
This keyword only applies to local and remote
This keyword only applies to remote printers and printers and punches.
punches.
WS
SYSAFF Specifies the work selection characteristics for this
Specifies the system(s) in the multi-access spool device.
(MAS) configuration that jobs entering the system
on this device can run if SYSAFF is not specified Some of the devices that this keyword applies to
on the /*JOBPARM JES2 control statement. include local and remote printers and punches,
spool offload devices and the network SYSOUT
This keyword only applies to local and remote transmitters.
readers.
XEQDEST
TRACE={YES|NO} Specifies the node at which jobs entering the
Specifies whether tracing is active for this device. system on this device will run if a /*ROUTE or
/*XEQ JES2 control statement is not present in the
job stream.
This keyword only applies to local, and remote Operator response: Enter the corrected command.
readers. See z/OS JES2 Commands.
System action: The system continues processing. Detecting Module: HASPCOMM
Operator response: None. Routing Code: #
Detecting Module: HASPIRPL Descriptor Code: –
Routing Code: #
$HASP607
Descriptor Code: –
Explanation:
JES2 NOT DORMANT – MEMBER DRAINING,
$HASP604
Explanation: RC= rc text
ID xxxx T= hh.mm.ss
| The operator entered a $P JES2 command to withdraw
I= ssss L= console text | JES2 from the system, but not all of JES2’s functions
| have completed. JES2 deletes this message from the
The operator entered a $TA command and the response | console when either all JES2 activity has completed or
indicates the contents of the command element being | a $S command is entered to resume JES2 processing.
created, displayed, modified, or deleted. If the operator | See the $HASP608 message for a more detailed list of
is attempting to alter or create an automatic command | activity causing JES2 not to be withdrawn.
element and a diagnostic message precedes this In the message text:
message, the element will be deleted.
rc The return code.
The fields in the message text are:
text The explanatory text accompanying the return
xxxx The user-defined or system-defined automatic
code.
command identifier.
hh.mm.ss Possible values of rc and text are:
Time of the current day to enter the
rc text
command(s) indicated by text.
01 OUTSTANDING I/O
ssss Time interval between each command.
02 OUTSTANDING WTO ACTIVITY
console
The 2- to 8-character console name and | 03 ACTIVE PROCESSORS
optional console area specified in the
automatic command. This parameter only 04 OUTSTANDING HELD PROCESSORS
affects the response to the $TA command. To 05 INTERNAL READERS ARE ALLOCATED
redirect the response to the automatic
command, you must specify an L=console | 06 OUTSTANDING CROSS MEMBER
within the quotes of the command text. | REQUESTS
text The command(s) to enter at the time indicated. 07 OUTSTANDING SPIN ACTIVITY
| $HASP608 message. This applies to all return codes. | SAPI REQUESTS (SSI 79) nnn
| PSO REQUESTS (SSI 1) nnn
For return codes 1 through 7, stop all JES2 functions | END OF MEMORY REQUESTS(EOM) nnn
(that is, drain all devices, lines, initiators, and stop all | OUTSTANDING WTO ACTIVITY
jobs), then reenter the $P JES2 command. | OUTSTANDING SPIN ACTIVITY
| PROCESSOR(S) ENDED BY PRIOR RECOVERY
| For RC=03, issue the $DPCE,ACTIVE>0 command to
| determine what PCEs have active work.
| There are the following two alternate forms of the
| For RC=06, if necessary, enter a $P JES2,QUICK to | message other than the previous table of activity:
| have JES2 ignore these requests when withdrawing.
| 1. ALL AVAILABLE FUNCTIONS COMPLETE
For RC=08, the $P JES2,ABEND command is required | JES2 issues this form of the message as a
to end JES2. | response to a $DJES2 command when there is
| no activity to display.
For RC=09, you might be experiencing a temporary
state or it might indicate that an address space is still | 2. xPJES2 COMMAND ACCEPTED
actively making requests of JES2. If the condition does | JES2 issues this form of the message after you
not clear and is the only reason code listed, then this is | issue a $PJES2 command and the command
likely a system address space (request jobID). Issue a | is accepted. The x is the CONCHAR of the
$DA,STC command to display all remaining address | member that issued the $PJES2 command.
spaces. One of these is probably still actively requesting
JES2 services. | JES2 issues this message as a response to a $DJES2
| command or as a response when a $PJES2 command
| For RC=10, issue the $DA,X command to get a list of
| is rejected. The message will list the specific reasons
| active address spaces.
| why JES2 cannot be withdrawn.
Detecting Module: HASPCOMM
Routing Code: 1,2,10
| In the message text:
| pcename
Descriptor Code: 2,5,7
| Long descriptive name of PCE
| nnn Count of activity
| $HASP608
| asid Address space identifier
| Explanation:
| ACTIVE PROCESSORS (PCES) | jobname
| NAME COUNT JOBID | Name of the job
| -------------------------------- -------- --------
| pcename/devname nnn jobid | jobid Job identifier
| ACTIVE ADDRESS SPACES | devname
| ASID JOBNAME JOBID | Device name associated with PCE
| -------- -------- --------
| asid jobname jobid | status Device status
| ACTIVE NETWORKING DEVICES
| NAME STATUS | member name
| -------------------------------- -------- | The name of the member of the JES2 MAS
| devname status
| HELD PROCESSORS | System action: If received as a response to a
| NAME | $PJES2 command, JES2 is not withdrawn and no new
| -------------------------------- | functions will be started. However, jobs can continue to
| pcename/devname | be entered.
| ALLOCATED INTERNAL READERS
| ASID JOBNAME JOBID | If received as a response to a $DJES2 command,
| -------- -------- -------- | command processing is complete and normal
| asid jobname jobid | processing continues.
| OUTSTANDING CROSS MEMBER REQUESTS
| Operator response: If received as a response to a
| ASID JOBNAME JOBID COUNT
| -------- -------- -------- -------- | $PJES2 command, then evaluate the following JES2
| asid jobname jobid nnn | functions listed to determine if they can be stopped,
| OUTSTANDING BERT LOCK REQUESTS | then re-enter the $P JES2 command:
| JOBNAME JOBID LOCKED BY | v Active processors
| -------- -------- ----------
| jobname jobid member name | v Active address spaces
| INTERNAL ACTIVITY | v Active networking device
| TYPE COUNT | v Allocated internal readers
| ----------------------------- --------
| TOTAL PCE I/O nnn
Descriptor Code: –
$HASP614
Explanation:
$HASP617
OFFLOADn START REJECTED –
Explanation:
DATA SET IN USE (OFFLOADn ON memname NO JOBS RELEASED
The operator entered a $S command to start an offload The operator entered a $AA command telling the
device, but the corresponding offload data set is system to release all jobs held by the $HA command.
currently being used by an offload device on the system No jobs were found to be held by that command.
identified by memname.
In the message text: System action: Processing continues.
n The number of the offload device. Operator response: If jobs are known to be held, use
explicit release commands: $A‘jobname’, $AJ, $AS, or
memname $AT as appropriate to release the jobs.
The member name.
Detecting Module: HASPCOMM
System action: The command is rejected and
processing continues. Routing Code: #
Operator response: Ensure that the data sets to be Routing Code: 1,2,10
rerouted are not active and reenter the $R command. Descriptor Code: 4
Detecting Module: HASPCOMM
Routing Code: # $HASP619
System programmer response: Correct the unit – The unit is allocated only to JES2 functions.
address specification on the device’s initialization – The unit is not busy with a JES2 function.
statement.
– The FSS assigned to the device, if any, did not
Detecting Module: HASPCOMM, HASPSXDV issue any messages indicating the reason for the
start failure.
Routing Code: 1,2,10
v If no unit address was specified, it should be
Descriptor Code: 4 specified through a $T command. The device can be
started with a $S command.
$HASP627 System programmer response: Determine why the
Explanation: device is unavailable, then retry the allocation.
devname Detecting Module: HASPCOMM, HASPFSSP,
NOT STARTED – UNIT=dev IS HASPSXDV
NOT AVAILABLE Routing Code: 1,2,10
Descriptor Code: ,4
The operator entered a $S command for the device
indicated by devname. One of the following is true:
v The device was already allocated to a non-JES2 $HASP629
function. Explanation:
v The system programmer has assigned the device to jobid NOT FOUND
a physical unit but JES2 is using that physical unit for jobname
a different device function.
v The unit is offline and cannot be allocated. The operator entered a command to set a job’s priority
v The allocation subtask abended. or processing class, but JES2 could not find the job.
Either the JES2-assigned jobid or the jobname appears,
v The device is assigned to a functional subsystem
depending on how the operator identified the job on the
(MODE=FSS), and the FSS failed to start the device
command.
(possibly for one of the above reasons).
In the message text:
v No unit address was specified for this printer.
jobid The job identifier.
In the message text: jobname
devname The name of the job.
The name of the device.
Note: The jobid actually appears before the message
dev Specifies a 4-digit hexadecimal device number. identifier ($HASP629) if your installation has
System action: Processing continues with the device entered the K S,MFORM=(J) command to
remaining drained. include the jobid in the console message format.
Operator response: Determine the use of the unit System action: Processing continues.
assigned to the device. Operator response: Enter the correct job identification
v If the unit is offline, place it online and use the VARY for the required job.
command to make it available for allocation before
Detecting Module: HASPCOMM
reentering the $S command.
v If the unit is busy with a JES2 function, wait for it to Routing Code: #
complete, enter $P for the owning device, and Descriptor Code: –
reenter the $S command to activate the new function.
v If the unit is allocated to a non-JES2 function, wait
$HASP630
until it becomes available before reentering the $S
command. Explanation:
v If the device is in FSS mode and none of the reasons VOLUME volser ACTIVE
above appear to be the cause of the start failure, look STARTING
for messages from the FSS indicating possible HALTING
causes of the problem. DRAINING
v If the unit has one of the properties listed below, INACTIVE
notify the system programmer:
– The unit is online.
– The unit is not allocated.
jobname
$HASP643
The name of the job.
Explanation:
memname
nnnnnn PPU destid ANY
The member name.
Note: A jobid may precede $HASP635. See “JES2 The operator entered the $DQ command. There are
message format” on page 1. nnnnnn jobs waiting for print/punch processing with the
routing shown in the destid field. ANY indicates that the
System action: The message is not sent; processing jobs are eligible for processing on any system.
continues. In the message text:
Operator response: None. nnnnnn
The number of jobs awaiting processing.
Detecting Module: HASPCOMM
destid The destination of the output.
Routing Code: #
System action: Processing continues.
Descriptor Code: –
Operator response: None.
$HASP636 Detecting Module: HASPCOMM
Explanation: Routing Code: #
cmd
Descriptor Code: –
The message text repeats back to the operator, in an
out-of-line area on a console, the command the $HASP644
operator entered.
Explanation:
In the message text:
nnnnnn OUT sysid
cmd The text of the command entered by the IND
operator.
System action: Processing continues. The operator entered a $DQ command. There are
nnnnnn jobs waiting for output processing in system
Operator response: None. sysid. If IND appears, system sysid is in independent
mode.
Detecting Module: HASPCOMM
In the message text:
Routing Code: #
nnnnnn
Descriptor Code: – The number of jobs awaiting output processing.
sysid The system identifier.
$HASP642
System action: Processing continues.
Explanation:
Operator response: None.
nnnnnn HOLD sysid
IND Detecting Module: HASPCOMM
Routing Code: #
The operator entered a $DQ command. There are
nnnnnn jobs held in system sysid. (This includes both Descriptor Code: –
active and queued jobs.) If IND appears, system sysid
is in independent mode.
$HASP645
In the message text:
Explanation:
nnnnnn
nnnnnn XMT destid
The number of jobs being held.
sysid The system identifier. The operator entered a $DQ command. There are
System action: Processing continues. nnnnnn jobs waiting for transmission to the node
identified in the destid field for processing.
Operator response: None. In the message text:
Detecting Module: HASPCOMM nnnnnn
The number of jobs awaiting transmission.
Routing Code: #
destid The destination of the output.
Descriptor Code: –
Operator response: See z/OS JES2 Commands for PCE ( pcetype ) DESC= description
valid verbs, formats, and authority required and reenter
the required command correctly from an authorized COUNT= ( defined, allocated, ended ),
console. ACTIVE= active, TRACE= tr
Detecting Module: HASPCOMM
Routing Code: # Details display:
Descriptor Code: – PCE ( pcetype ) NAME= name,
iii Count of outstanding I/O for this PCE. System action: JES2 processing continues.
eee Number of the exit that is currently in control of System programmer response: Determine why there
this PCE. is insufficient storage in the JES2 address space and
correct the error.
If the operator specified one or more of these processor Detecting Module: HASPCOMM
types on the $DPCE command, this message appears
for each of the specified types. If the operator entered Routing Code: #
the $DPCE command without any processor names, Descriptor Code: –
this message appears for each processor type.
System action: Processing continues. $HASP657
Operator response: None. Explanation:
Detecting Module: HASPCOMM JES2 EVENT TRACE LOG IS INACTIVE – –
JES2 issues this message when the trace logger Operator response: Notify the system programmer
determines that an insufficient number of tables was that this condition has occurred. If tracing should be
active, you must first allocate trace tables using the $T
is an SNA line, the A=applid operand is required. JES2 could not find a started SNA line that was not
currently busy for another SNA node or remote.
Detecting Module: HASPCOMM
applid IS NOT A DEFINED APPL OR NODE, RC=06
Routing Code: #
The application name specified on the $SN
Descriptor Code: – command is neither a defined application (APPL)
nor the name of an existing node. The name is
incorrect, the application should be defined using
$HASP678 the $T APPL(applname) command, or a node
Explanation: should be renamed to that application name.
LINElna BUSY NODEnnnn IS THE LOCAL NODE, RC=07
The application name specified on the $SN
The operator has entered a $SN command for a line command either implied a local node or, if no such
that is currently involved in a JES2 NJE or RJE application exists, was the name of a local node.
connection. Networking cannot be initiated from the local node
In the message text: to itself.
lna The line number. ALREADY IN SESSION WITH applid, RC=08
The application name specified on the $SN
System action: Processing continues.
command either implied, or was the name of, a
Operator response: Wait for the line to complete its node already in session with the local node for
current JES2 function, enter a $P command to drain the networking.
line, enter a $S command to start the line, and then
MAXIMUM SESSIONS ALREADY ACTIVE, RC=09
reenter the $SN command.
Because the maximum number of SNA applications
Detecting Module: HASPCOMM are already active, no additional applications can be
started at this time. Use the SESSION parameter
Routing Code: #
on the TPDEF initialization statement to specify the
Descriptor Code: – maximum number of applications allowed.
NO STORAGE AVAILABLE FOR APPL, RC=10
$HASP679 An application (APPL) was to be dynamically
defined but no storage was available for the
Explanation: necessary control blocks.
$SN,A= applid REJECTED – reason
THE NODE FOR APPL applid IS INVALID, RC=11
The operator attempted to initiate an SNA An existing application (APPL) was found for the
application-to-application session using the $SN $SN command but it references an incorrect node
command. number.
In the message text: DEDICATED LINE LINEnnnn IS NOT AVAILABLE,
applid The VTAM application identifier. RC=12
The line specified on the $SN command or defined
in the NODE(nnnn) initialization statement is not
reason is one of the following:
usable. Possible reasons are:
JES2/VTAM INTERFACE INACTIVE, RC=01 1. Dedicated line number lna is also dedicated to
The JES2/VTAM interface has not been activated. an RJE device (RMT5,LINE=5).
The LOGON1 DCT has either not been defined or
2. Dedicated line number lna is in disconnect
not been started using the $S LOGON1 command.
process (draining).
LINElna IS NOT A SNA/VTAM LINE, RC=02 3. Dedicated line number lna has a ″password″
The line specified on the $SN command is a BSC set on it.
line, not an SNA line.
4. User has multiple SNA paths to NODE5 and
LINElna IS NOT ACTIVE, RC=03 has set the node for the dedicated line instead
The line specified on the $SN command has not of setting the associated APPL statement for a
been started. The line must be started before you dedicated line.
reissue the $SN command.
NETWORK PATH MANAGER IS NOT AVAILABLE,
LINElna IS BUSY, RC=04 RC=13
The line specified on the $SN command is already JES2 could not start the connection because the
busy for another SNA node or remote. network path manager PCE failed. JES2 also
issued message $HASP502 to indicate this
NO IDLE SNA LINE IS AVAILABLE, RC=05
condition.
No line was specified on the $SN command and
Explanation: {Unnnn}
{LOCAL}
nnnnnn JOBS ON REBUILD QUEUE,
{userid}
{nodename}
mmmmmm JOES ON REBUILD QUEUE
{nodename.Rnnnn}
{nodename.userid}
In response to a $D REBLD command, JES2 displays SECLABEL= [seclabel]
all the JOEs ($HASP890) and JQEs ($HASP686) on the TSOAVAIL= { YES}
rebuild queue. This message follows messages { NO}
$HASP890 and $HASP686 to provide the total of those UCS= {ucs}
JQEs and JOEs. {DEMAND-SETUP}
In the message text: USERID= userid
WRITER= [writer]
nnnnnn
RELEASED
The number of jobs on the rebuild queue.
CANCELLED
mmmmm NOTE RELEASED,
The number of JOEs on the rebuild queue. SPECIFY
’PROTECTED’
System action: Processing continues.
The operator entered a $T O, $O, $DO $TO, $CO or
Operator response: None $PO command for a job, a started task, or a Time
System programmer response: None Sharing Option/Extensions (TSO/E) logon. This
message displays the current output characteristics for
Detecting Module: HASPCOMM each job output element (JOE) specified on the
Routing Code: 1,2,10 command. Asterisks (****) appear in the variable field for
any characteristic that is not the same for all the data
Descriptor Code: 4 sets in this JOE.
LOCAL Any local device. System action: The job or command is ignored; JES2
userid a local userid. processing continues.
nodename The name of a node.
Operator response: None.
nodename.Rnnnn
nnnn is a remote number on Detecting Module: HASCSRIC
a node.
nodename.userid Routing Code: #
userid is a userid at a node. Descriptor Code: –
SECLABEL=[seclabel]
The security label of the data sets grouped in
the JOE. $HASP690
TSOAVAIL={YES|NO} Explanation:
Indicates if the output group is available for jobname COMMAND REJECTED –
processing by the TSO output command.
Only an output group that was held when it AUTHORIZATION FAILURE
was created, and has never been released, is
COMMAND REJECTED –
available for processing by the TSO/E output text
command. For example, the $HASP686
message will display TSOAVAIL=NO if an SOURCE OF COMMAND HAS IMPROPER AUTHORITY
output group is released by a $O command
and held again with a $TO NDISP=HOLD A command was entered by an operator or from a
command. console that lacks sufficient authority to issue the
UCS={ucs|DEMAND-SETUP} command. If JES2 is unable to obtain messages from
The universal character set for this output. the security product, the $HASP687 message is issued;
Demand-setup may appear in the keyword otherwise, text indicates that any messages issued by
field, indicating it is required. the security product follow the $HASP690 message.
USERID=userid If COMMAND REJECTED – SOURCE OF COMMAND
The user identifier of the submitter of the job. HAS IMPROPER AUTHORITY is displayed, this
WRITER=[writer] message will also be issued if the source where the
The external writer specified for this output. command originated does not have the proper authority
RELEASED to issue the command.
The indicated output group has been released. In the message text:
CANCELLED jobname
The indicated output group has been canceled. The name of the job.
NOT RELEASED, SPECIFY ’PROTECTED’
The operator entered one of the following Note: A jobid may precede $HASP690. See “JES2
against a protected job: message format” on page 1.
v A $CO command
v A $O CANCEL command System action: The command is ignored; JES2
v A $PO command processing continues.
System action: JES2 processing continues. Operator response: Notify the system programmer
that this authorization failure has occurred.
System programmer response: If HOLDRC=005,
take the actions indicated in the explanation of the System programmer response: Contact the security
$HASP528 message. administrator to determine whether the command should
be accepted. Update the appropriate profiles, if
Detecting Module: HASPCOMM necessary, and notify the operator that the command
Routing Code: # may be reentered.
$HASP691 $HASP693
Explanation: Explanation:
COMMAND TERMINATED – cmd Nn Mm $GR jobname JOB NOT FOUND
A program check occurred while JES2 was processing The operator at MAS member Mn, node Nn, entered the
the command identified in the message text. JES2 $GR command for the job named in the message text,
stopped processing that command, and the JES2 but JES2 could not find the job.
command processor recovery routine has received In the message text:
control.
n The number of the node or the MAS member.
In the message text:
jobname
cmd The text of the terminated command.
The name of the job.
System action: JES2 recovery processing continues.
Note: A node id Nn and member id Mm may precede
Operator response: Notify the system programmer.
$HASP693. See “JES2 message format” on
System programmer response: Follow your page 1.
installation’s procedures for identifying and correcting
System action: JES2 processing continues.
the problem.
Operator response: Check command authority for this
Detecting Module: HASPCOMM
node.
Routing Code: *,1,2,10
Detecting Module: HASPCOMM
Descriptor Code: 4
Routing Code: #
Descriptor Code: –
$HASP692
Explanation:
$HASP694
Nn Mm $GR jobname
Explanation:
INVALID ORIG NODE NAME – nodename Nn Mm $GR jobname
The operator at MAS member Mn, node Nn, entered the MULTIPLE JOBS FOUND
$GR command with the O=nodename operand. The
nodename specified is not defined in the node The operator at MAS member Mn, node Nn, entered the
information table of the node to which the command $GR command for the job named in the message text,
was sent. but JES2 found more than one job with that job name.
In the message text: In the message text:
n The number of the node or the MAS member. n The number of the node or of the MAS
member.
jobname
The name of the job. jobname
The name of the job.
nodename
The invalid node name.
Note: A node id Nn and member id Mm may precede
$HASP694. See “JES2 message format” on
Note: A node id Nn and member id Mm may precede
page 1.
$HASP692. See “JES2 message format” on
page 1. System action: JES2 does not process the command.
System action: JES2 does not process the command. Operator response: Reenter the command, specifying
the job type (J for a batch job, S for a started task, or T
Operator response: Reenter the command with a
for a TSO user) and the job number. The job number is
valid node name in the O= operand.
the number JES2 assigned the job at its originating
Detecting Module: HASPCOMM node. For example, you would enter J110 to specify
batch job 110.
Routing Code: #
Detecting Module: HASPCOMM
Descriptor Code: –
Routing Code: #
Descriptor Code: –
$HASP699
Explanation:
CONFLICTING OPERAND(S) DETECTED
devname
$HASP702
The name of the device.
Explanation:
fssname
FSS fssname NOT STOPPED
The name of the functional subsystem.
STOP DEVICE ORDER UNSUCCESSFUL STOP FSS ORDER UNSUCCESSFUL
The functional subsystem application could not FSA FAILED TO DISCONNECT
successfully process the order to stop the device.
STOP FSA ORDER UNSUCCESSFUL The functional subsystem could not be stopped, but all
The functional subsystem could not successfully functional subsystem applications (FSAs) associated
process the order to stop the functional subsystem with this functional subsystem have successfully
application. stopped.
In the message text:
FSA FAILED TO DISCONNECT
The functional subsystem application did not fssname
disconnect within a predetermined amount of time The name of the functional subsystem.
after a STOP FSA order was issued. STOP FSS ORDER UNSUCCESSFUL
System action: Normal operation continues. No work The functional subsystem could not successfully
is selected by the indicated device. The device is left in process the order to stop the functional subsystem.
the draining state. FSS FAILED TO DISCONNECT
Operator response: Notify the system programmer. The functional subsystem did not disconnect within
The $P command can be entered for the device again. a predetermined amount of time after a STOP FSS
If this message appears during $PJES2 processing, the order was issued.
system will not withdraw and a $PJES2,ABEND may be System action: JES2 does not withdraw from the
required to withdraw JES2 from the system. Use the system while functional subsystems remain active.
MVS CANCEL command to cancel the functional
subsystem address space with a dump. Operator response: Notify the system programmer. A
$PJES2,ABEND is required to withdraw JES2 from the
Save the hard-copy log. For systems with remote system. Use the MVS CANCEL command to cancel the
consoles, save the remote console sheet. functional subsystem address space with a dump.
System programmer response: If the system issues System programmer response: If this message is
message $HASP703 along with this message, use the accompanied by the $HASP703 message, use the
return code issued in message $HASP703 and the return code issued in $HASP703 and the appropriate
appropriate functional subsystem (FSS) documentation FSS documentation to analyze the error.
to analyze the error.
Detecting Module: HASPFSSP
If you use SMP/E to make all changes to the system,
use the LIST CDS and LIST PTFBY functions of SMP/E Routing Code: 1,2,10
to obtain a list of the current maintenance from the Descriptor Code: 4
SMP/E control data set (CDS).
If you make any changes to the system without using $HASP703
SMP/E, run the LISTIDR function of AMBLIST to obtain
a list of all members with a PTF or local fix and save Explanation:
the output. Run LISTIDR against the following: devname FSI ERROR – RT= rc –
v SYS1.LINKLIB.
MGCRE SERVICE FAILED
v SYS1.SVCLIB GETMAIN SERVICE FAILED
v The library containing the program that issued the ORDID= nnnn REQUEST FAILED
message. ORDID= nnnn BAD RESPONSE
v SYS1.LPALIB FSA (DEVICE) FSID TOO LARGE
$SUBIT SERVICE FAILED
Save all the associated output and contact the IBM
Support Center for assistance. JES2 (HASPFSSP) detected an incorrect or
unsuccessful return code from a system or functional
Detecting Module: HASPFSSP subsystem interface (FSI) service routine during FSI
Routing Code: 1,2,10 processing. The return code is displayed as the RT=
value. The text following the message indicates the
Descriptor Code: 4 service that was detected as failing. If the text indicates
an FSI order failure, ORDID= gives the ID of the order
that failed.
Possible values of nnn and text are: and, for systems with Multiple Console Support (MCS),
a copy of the hardcopy log.
nnn text
Detecting Module: HASPFSSP
001 FSI RELDS Unprintable - SWB error
Routing Code: 1,2,10
002 FSI RELDS Unprintable - FSA
Descriptor Code: 4
System action: Processing continues.
Operator response: Notify the system programmer.
$HASP706
After the problem that caused the data set to be
unprintable is fixed, make the data set selectable by Explanation:
entering the $TO command. devname – WAITING FOR RESPONSE
System programmer response:
FROM FSS= fssname FSS NOT STOPPED
HOLDRC= FSA NOT STOPPED
Meaning DEVICE NOT STOPPED
FSS NOT STARTED
001 Indicates that JES2 processing (in module
FSSM) in an FSS address space detected a
TIME= nnnn MINUTES
problem with SWB data. Check SYSLOG for
prior JES2 messages for additional information
concerning this error. JES is waiting for a response from the FSS to an
outstanding order. JES2 issues this message at five
002 Indicates that a functional subsystem minute intervals until a response is received from the
application (FSA) detected an error and issued FSS. TIME= is the number of minutes since the
a release data set (RELDS) order to JES2 to message was first issued, and will not be incremented
indicate that the FSA cannot print the data set. past TIME=995. When JES2 receives the proper
Check SYSLOG and any output that was response, FSS processing will resume.
produced by the FSA for messages concerning In the message text,
why the FSA issued the RELDS.
devname
The name of the device.
Based on prior SYSLOG or output messages, correct
the problem that caused the data set to be fssname
nonprocessable. The name of the functional subsystem.
Detecting Module: HASPFSSP nnn The time in minutes.
Routing Code: 7 System action: Normal operation continues. Nothing
is selected by the device until a response is received
Descriptor Code: 4
from the FSS.
Operator response: Notify the system programmer.
$HASP705
System programmer response:
Explanation:
device TERMINATING – FSS= fssname 1. Try to identify why the FSS is not responding. If it is
not obvious, obtain console dumps fro both the
– FSA INITIATED TERMINATION JES2 and FSS ASIDS (including private region and
CSA) to identify why the FSS is not responding.
The indicated device controlled by the functional 2. In the case of installation with PSF, issue the MVS
subsystem (fssname) has requested a stop. MODIFY command against the failing FSS(PSF)
In the message text: printer. The MODIFY command is described in PSF
documents. For example, MODIFY
device The name of the device. FSSNAME,FORCE,PRTNNNN.
fssname 3. If item 2 fails to relieve the problem, issue an MVS
The name of the functional subsystem. CANCEL command against the failing FSS ASID.
System action: Normal operation continues. No work 4. If item 3 fails, JES2 needs to be hot started. Use the
is selected by the indicated device. The device stops $PJES2,ABEND command only if all other attempts
and drains. to recover the device fail.
Operator response: Determine why the device was Detecting Module: HASPFSSP
stopped by examining the FSS-issued messages. Save Routing Code: 1,2,10
the dump, the console sheet, remote console sheet,
Descriptor Code: 4
MEMBER IS UP-LEVEL
The member is at a higher release than the
initializing member.
$HASP712 $HASP713
Explanation: Explanation:
ERROR DURING WORKLOAD MANAGER func INCLUDE DSNAME= dsname,
, RC= return code REASON= reason code JES2 issues this message in response to an INCLUDE
or a D INCLUDE initialization statement. It displays the
A WLM error has been detected. current data set JES2 is reading initialization statements
from.
Func Explanation
dsname
CONNECT The data set name and optional member name
Error connecting to WLM. JES2 terminates. from which JES2 is reading initialization
WLM Service: IWMCONN statements.
POLICY QUERY volser The volume serial number of the data set being
Error obtaining current WLM SERVICE read.
definition. unit The unit value for the data set (if specified on
WLM Service: IWMPQRY an INCLUDE initialization statement).
BATCH REGISTRATION and BATCH The description of the INCLUDE statement in z/OS
DEREGISTRATION JES2 Initialization and Tuning Reference explains the
Error during registering or deregistering the parameters displayed in this message.
batch class.
System action: Processing continues.
WLM Service: IWMBREG, IWMBDREG
Operator response: None.
CLASSIFICATION
An unrecoverable error was IWMCLSFY System programmer response: None.
detected while classifying a job. | Detecting Module: HASCSCAN
WLM Service: IWMCLSFY Routing Code: 1,2,10
DISCONNECT Descriptor Code: 4
Error disconnecting from IWMDISC WLM.
WLM Service: IWMDISC $HASP714
SRVCLASS= Explanation:
The WLM Service class that was being
JES2 TERMINATION PROCESSING AWAITING nnnnnnnn ADDRESS SPACES
processed for functions of BATCH
REGISTRATION and BATCH – DUMP INITIATED. ISSUE $PJES2,ABEND FOR IMMEDIATE JES2 SHUTDOWN
DEREGISTRATION.
JES2 is attempting to terminate in response to a
REASON= $PJES2 command. There are nnnnnnnn address
The reason code returned by the WLM request space(s) other than JES2 which are preventing JES2
RC= The return code from the WLM request. termination.
System action: System continues. If the func issuing System action: This message will continue to be
the message is CONNECT, JES2 ends. displayed until JES2 is able to shut down, or until JES2
detects that there is no progress being made in address
System programmer response: Contact the IBM space termination. In this case, a dump is taken of the
support center. address space(s) that are preventing JES2 termination.
Detecting Module: HASPIRPL, HASPCKPT, Note that if you receive the ″DUMP INITIATED″ form of
HASPTERM, HASPXEQ $HASP714 and a dump was not taken, this indicates
that JES2 termination is proceeding as intended.
Routing Code: 1,2,10
Operator response: Notify the system programmer.
Descriptor Code: 4
System programmer response: Save the dump
taken as indicated by the $HASP714 message and
contact the IBM support center. The $PJES2,ABEND
command may be issued to allow JES2 to terminate
after the dump has been taken. An error occurred within the FSMGETQC
routine in module HASPFSSM. A reason code
Detecting Module: HASPXEQ
is displayed and placed in register 15 indicating
Routing Code: 1,2,10 one of the following errors:
Descriptor Code: 2,7 rc Meaning
01 The number of cells to get (passed
| $HASP715 through $GETQC in R1) is less than
or equal to 0 or greater than
| Explanation: QCTLIMIT.
| ADDRESS SPACES AWAITING RETURN JOBID
| ASID JOBNAME 02 A SETLOCK RELEASE request failed.
| -------- -------- The return code from SETLOCK is in
| asid jobname bits 0-15 of the reason code.
03 The GETCELL service failed. The
| Note: JES2 displays up to 5 ASIDs and JOBNAMEs. return code from GETCELL is in bits
0-15 of the reason code.
| JES2 is attempting to terminate in response to a
| $PJES2 command. The listed address spaces are $F01 FREECEL SERVICES ERROR
| preventing JES2 termination because they have not An error occurred within the FSMFREQC
| performed a return jobid call. routine in module HASPFSSM. A reason code
| System action: The message will continue until JES2 is set indicating one of the following errors:
| detects that no more address space requires a return rc Meaning
| jobid call.
01 The number of cells to get (passed
| Operator response: Notify the system programmer. through $FREQC in R1) is less than
| System programmer response: Perform a return or equal to 0 or greater than
| jobid for the listed address spaces. QCTLIMIT.
A catastrophic error has occurred within the JES2 05 The BLDCPOOL service failed. The
functional subsystem interface (FSI) support routines return code from BLDCPOOL is in bits
(HASPFSSM) for which JES2 has issued a $ERROR 0-15 of the reason code.
macro. The message is issued from the HASPFSSM 06 The GETMAIN request for the
catastrophic error routine, FSMCATER, invoked through (additional) cell pool failed. The return
the $ERROR macro. code from GETMAIN is in bits 0-15 of
In the message text: the reason code.
cde The decimal code returned from the FSI. $F03 QUICKCELL INIT ERROR
rc The return code returned from the FSI. An error occurred within the FSMQCT routine
text The explanatory text accompanying the codes. in module HASPFSSM. A reason code is set
indicating the following error:
Register 15 contains the return code (rt) in the first four rc Meaning
digits, and the reason code (rc) in the last four digits:
01 A GETMAIN request failed (through
0008|0001
rt rc $GETMAIN). The return code from
GETMAIN is in bits 0-15 of the reason
code.
The following list shows cde, rc, and text:
$F05 SJF REQUEST ERROR ON RELDS
cde text
$F00 GETCELL SERVICES ERROR
An error occurred within the FSMQCT routine JES2 or FSS address space. Look for the reason code
in module HASPFSSM. A reason code is set and additional service routine return codes in register 15
indicating the following error: at the time of the abend. If the reason code indicates a
temporary out of storage condition, take action to
rc Meaning
alleviate the shortage and tell the operator to restart the
03 The SJF DELETE request failed. The device.
return code from the SJF request is in
bits 0-15 of the reason code. Note: Quickcell services return codes are documented
under the X’6FB’ ABEND code in z/OS MVS
04 The SJF TERMINATE request (in
System Codes.
subroutine FSMSJTER) failed. The
return code from the SJF request is in Detecting Module: HASPFSSM
bits 0-15 of the reason code.
Routing Code:1,2,10
$F06 GETBLK SERVICE ERROR
Descriptor Code:11
An error occurred within the FSMGTBLK
routine in module HASPFSSM. A reason code
$HASP751
is set indicating the following error:
Explanation:
rc Meaning
SJFxxxxxxxx
01 An RPL cell obtained from the free jobname
cell chain does not contain the correct
eye-catcher. SERVICE ERROR(RECOVERED),RC= rc
02 A GETR cell obtained from the free
cell chain does not contain the correct
SJFRC= sjfrc, KEY= keyword
eye-catcher.
$F07 RETBLK SERVICE ERROR The scheduler JCL facility (SJF) service xxxxxxxx
An error occurred within the FSMGTBLK encountered an error while processing the indicated job.
routine in module HASPFSSM. A reason code SJF sent error return code rc to the JES2 FSI support
is set indicating the following error: module and the module has recovered.
In the message text:
rc Meaning
jobname
01 An RPL cell passed by the caller does The name of the job.
not contain the correct eye-catcher.
xxxxxxxx
02 A GETR cell passed by the caller The name of the SJF service.
does not contain the correct
eye-catcher. rc The return code.
System action: An SDUMP is requested with the title If the error occurred in SJF UPDATE service, additional
set to the $HASP750 message text and an ABEND 02C information is displayed:
is issued. The functional subsystem (FSS) ESTAE
routine might attempt recovery or end the FSS address sjfrc The reason code returned by SJF.
space. If the FSS recovers, normal processing resumes keywd The name of the keyword found to be in error.
from the point of recovery. If the FSS ends, normal
JES2 processing continues but the device operated by Note: A jobid may precede $HASP751. See “JES2
the failed functional subsystem/functional subsystem message format” on page 1. The $HASP750
application (FSS/FSA) is drained. message explains the rc value.
Operator response: Notify the system programmer. System action: The indicated output group is returned
Wait for the FSA or FSS task to recover, or stop and for from the FSS to JES2. It is then requeued to the output
the JES2 device to drain. If the FSS is stopped, attempt queue and marked as unselectable (S=N). The
to restart the device that was being operated by the $HASP704 message is issued when the output group is
failed FSA/FSS through the $S command. If the device requeued.
is not restarted or fails again, and if the device can be
directly managed by JES2, then the device may be Operator response: Enter the $TO command to
switched to JES mode using the $T device, MODE=JES correct the output keyword in error and make the output
command, followed by the $S device commands. group reselectable (S=Y). Because the output group
may have originated on another node connected to
System programmer response: Analyze the JES2, you may have to contact the job originator to
message(s) issued and the dump requested from the correct the problem for subsequent jobs.
Notify the system programmer that this error has Routing Code: 1,2,10
occurred.
Descriptor Code: 4
Detecting Module: HASPFSSM
Routing Code: 10 $HASP777
Descriptor Code: 6 Explanation:
FAILURE DURING THE UPDATE OF USER
MEMBER= nodename $ memb MAS member memb attempted to update its XCF user
state field with the IXCSETUS macro. The attempt
GROUP= xcfgrpnum failed.
JES2 MAS member memb used the IXCJOIN macro to In the message text:
join the JES2 XCF group. The attempt failed. rc The hexadecimal return code from the
In the message text: IXCSETUS macro.
service rsnc The hexadecimal reason code from the
JESXCF/MVS service that failed. IXCSETUS macro.
rc The hexadecimal return code from the nodename$memb
IXCJOIN macro. The XCF member name, where:
rsnc The hexadecimal reason code from the nodename
IXCJOIN macro. The name of the JES2 node
nodename$memb containing memb.
The XCF member name, where: memb The identifier of the JES2 member
nodename attempting to update its user state
The name of the JES2 node field.
containing memb. xcfgrpnm
memb The identifier of the JES2 member The XCF group name.
attempting to join the XCF group.
The values for rc and rsnc are listed under the
xcfgrpnm IXCSETUS macro in z/OS MVS Programming:
The name of the XCF group this member was Authorized Assembler Services Reference EDT-IXG.
attempting to join, as specified on the
XCFGRPNM parameter of the MASDEF System action: JES2 issues $HASP095 message
initialization statement. with $XC1 code and then ends.
Operator response: Notify the system programmer.
The values for rc and rsnc are listed under the IXCJOIN
macro in z/OS MVS Programming: Authorized The XCF member nodename$memb may remain in the
Assembler Services Reference EDT-IXG. sysplex. To display the status of nodename$memb,
enter the D XCF,GROUP,xcfgrpnm,nodename$memb
System action: JES2 initialization ends. command where xcfgrpnm is the JES2 XCF group
Operator response: Notify the system programmer. name specified on the MASDEF initialization statement.
System programmer response: Search the problem System programmer response: Search the problem
reporting data bases for a fix to the problem. If none reporting data bases for a fix to the problem. If none
exists, contact the IBM support center with the return exists, contact the IBM support center with the return
and reason codes. and reason codes.
$HASP783
$HASP785
Explanation:
THE AUTOMATIC RESTART Explanation:
AGED XCF MEMBER DATA HAS BEEN DELETED
FOR JOBS ON A FAILED
MEMBER nodename $ memb GROUP xcfgrpnm
JES2 MEMBER HAS BEEN BYPASSED –
JES2 XCF group member nodename$memb has been
deleted from the group because it has become aged. A
MEMBER= memname
member ages when it either remains across sysplex
IPLs or is in the failed state for more than one day. A
In response to message IXC402D, the operator sysplex IPL duration is from the time the first system
indicated that the MVS system on which memname was IPLs into the sysplex until the last system becomes
active is down, when the member was, in fact, still inactive.
active. Therefore, although the AUTOEMEM option was In the message text:
enabled, restarting of jobs from memname requires
operator intervention. See z/OS MVS System nodename$memb
Messages, Vol 10 (IXC-IZP) for information about The identifier of the aged XCF member, where:
message IXC402D. nodename
In the message text: The name of the JES2 node
containing memb.
memb The identifier of the JES2 member. information on the XCFGRPNM parameter.
xcfgrpnm Detecting Module: HASPXCF
The XCF group name.
Routing Code: 1,2,10
System action: The XCF member data for
Descriptor Code: 4
nodename$memb is removed.
Operator response: None.
$HASP788
Detecting Module: HASPXCF
Explanation:
Routing Code: 1,2,10 FAILURE DURING THE XCF JOIN
Descriptor Code: 4
BECAUSE A MAXIMUM
JES2 XCF MEMBER IS ACTIVE – JES2 member memb attempted to join the JES2 XCF
group, but could not because the maximum number of
MEMBER= nodename $ memb groups is already defined to the sysplex. The
MAXGROUP attribute on the DEFINEDS statement (of
GROUP= xcfgrpnm the IXCL1DSU format utility) did not allow enough
groups while formatting the sysplex couple data set.
See z/OS MVS Setting Up a Sysplex for more
MAS member memb is attempting to join the JES2 XCF information.
group but cannot because a member with an identical In the message text:
name already belongs to the group. Each MAS should
have a unique XCF group name. However, if there is nodename$memb
more than one MAS with the same node name, sharing The XCF member name, where:
the same JES2 XCF group, and at least one member in
nodename
each shares the same name, this failure can occur.
The name of the JES2 node
In the message text:
containing memb.
nodename$memb
memb The identifier of the JES2 member
The XCF member name, where:
attempting to join the sysplex group.
nodename
xcfgrpnm
The name of the node containing
The XCF group name.
memb.
System action: JES2 initialization ends.
memb The identifier of the member
attempting to join the group. System programmer response: Format the sysplex
couple data set with a sufficient maximum number of
xcfgrpnm
groups to include the JES2 XCF group.
The XCF group name.
Detecting Module: HASPXCF
System action: JES2 initialization ends.
Routing Code: 1,2,10
Operator response: Decide which JES2 MAS
member should be joined to the XCF group and stop Descriptor Code: 4
the JES2 member that doesn’t belong in the JES2 XCF
group. In addition, notify the system programmer.
$HASP789
System programmer response: If more than one
Explanation:
MAS should happen to exist in a sysplex environment,
FAILURE DURING THE XCF JOIN
each MAS should define a unique XCF group for JES2
to join. This can be done by specifying a unique name
BECAUSE A MAXIMUM
in the XCFGRPNM parameter on the MASDEF
initialization statement for all MAS’s in the sysplex.
NUMBER OF XCF MEMBERS ARE ACTIVE –
See z/OS JES2 Initialization and Tuning Guide and
z/OS JES2 Initialization and Tuning Reference for
The JES2 trace log processor has been started as the LEAVE JES2 will not process the data set
result of the START=Y keyword on the TRACEDEF until you change the output disposition
command or initialization statement. The trace log to KEEP or WRITE.
processor automatically starts up after a JES2 restart if PURGE
trace data was being processed at the time of failure. JES2 will remove the output from the
This message is only issued when trace entries are system.
ready to be written to the trace log data set. If tracing is
inactive, the trace log writer will not start.
Note: Do not use this value when
In the message text:
tracing as JES2 purges the
jobname trace output immediately upon
The name of the job. creation.
Note: A jobid may precede $HASP800. See “JES2 Note: A jobid may precede $HASP801. See “JES2
message format” on page 1. message format” on page 1.
System action: The trace table entries being System action: The contents of the event trace log
produced by event trace are now being written to the have been written to a SYSOUT data set of the
trace log data set for later printing. SYSOUT class designated by c. The data set is (HELD)
if the SYSOUT class was defined as a held class during
Operator response: None. JES2 initialization. If this message is in response to a
Detecting Module: HASPEVTL $T TRACEDEF, LOG=(START=NO) command, the
system issues message $HASP802.
Routing Code: 1,2
Operator response: None.
Descriptor Code: 4
Detecting Module: HASPEVTL
The JES2 trace log data set was “spun-off” because the IS INACTIVE
operator entered a $T TRACEDEF,SPIN or a $T
TRACEDEF, LOG=(START=NO), or because the line The operator entered a $T TRACEDEF,
limit of the data set (set by the LOG=SIZE= parameter LOG=(START=NO) command and all trace table entries
on the TRACEDEF initialization statement) was (if any) were written to the trace log data set. JES2 has
reached. issued the $HASP801 message.
In the message text: In the message text:
jobname jobname
The name of the job The name of the job.
c The output class of the trace log
Note: A jobid may precede $HASP802. See “JES2
outdisp One of the following: message format” on page 1.
WRITE JES2 processes the output and then System action: The trace entries produced by an
removes the output from the system. event trace are no longer written to the trace log data
set. If an event trace is still in effect ($T
Operator response: You may remove the volume TERMINATE START PROCESSING
from the JES2 environment.
Detecting Module: HASPSPOL There is not enough space in the master TGM (track
group map) to map all of the track groups on the spool
Routing Code: 1,2
volume. Messages $HASP850 and $HASP854
Descriptor Code: 4 accompany this message showing how many of the
track groups on the volume volser are mapped in the
master TGM.
$HASP810
System action: Spool command processing waits for
Explanation: the operator to reply.
volser INVALID ON MEMBER memname
Operator response: Reply Y or N. If you reply Y,
– REASON CODE = rsnc JES2 starts the volume using only the number of track
groups indicated in the $HASP850 message. To fully
This message is issued at the member initiating the use the volume later, increase TGSPACE=(MAX=), then
start spool ($S SPOOL) command because the drain and restart the volume. If you reply N, JES2
indicated member cannot start the spool volume drains the volume.
identified by volser because of reason code rsnc. The Detecting Module: HASPSPOL
member that had the error received a full descriptive
message explaining the error. Routing Code: 1,2,10
In the message text: Descriptor Code: 4
volser The volume identifier.
memname $HASP812
The member name. Explanation:
rsnc The reason code issued in the message to the DESTDEF response ,...,
command originator indicating an error on
another member. JES2 issues this message in response to a DISPLAY
initialization control statement or a $D or $T command
Possible values of rsnc are: that specifies the DESTDEF initialization statement. It
displays the current value of the keywords required. The
rsnc Meaning description of the DESTDEF statement in z/OS JES2
4 Volume not mounted Initialization and Tuning Guide explains each of the
keywords.
8 Duplicate spool volumes
System action: Processing continues.
12 Allocation error
Operator response: None.
16 Formerly mounted spool volume not mounted
Application Programmer Response: None.
The reset of the checkpoint data set lock failed because The operator entered a command to display or change
the member specified on the a network connection.
’$E CKPTLOCK,HELDBY=’ command did not hold the In the message text:
lock, or the lock was not held by a member that failed nodename
during initialization. The name of a node.
System action: Processing continues. memb The number of a member.
Operator response: If the $HASP263 message nnnnnnnn
includes the message text ″LOCK HELD BY MEMBER The resistance of the connection.
member_name″ or the $HASP264 is still being issued,
verify that the member name specified on the yyyy/ddd
’$E CKPTLOCK,HELDBY=’ command matches the A Julian date.
member name specified in one of these two messages. hh:mm:ss
Application Programmer Response: None. Time in hours, minutes, and seconds.
Detecting Module: HASPCKPT TIME= displays the time JES2 received the connection
Routing Code: 1,2,10 record for a connection or the time the operator entered
a command which changed a static connection. CES=
Descriptor Code: 4 displays the connection event sequence (CES) for
non-static connections. STATUS=status displays the
$HASP815 current status of the connection as follows:
Explanation: ACTIVE
CONNECT NODEA nodename, The connection exists and the signon process
has completed.
MEMBERA= mema, NODEB= nodename, HELD The connection exists but the nodes are
currently in the process of signing on.
MEMBERB= memb,
REST= nnnnnnnn, INACTIVE
The connection exists but the nodes have not
signed on.
STATUS= ACTIVE ACTIVE(status)
INACTIVE A static connection exists and is treated as
HELD active for the purposes of path determination.
The actual connection is not active but has a
status of status (that is, one of the other status
STATE= INUSE types listed here).
PENDING
EXTRA STATE Displays additional information for an ACTIVE
MAXREST connection.
UNCONNECTED INUSE Connection is currently in use in some path to
a node.
STATIC= YES PENDING
NO An INUSE STATIC connection to an adjacent
node for which the corresponding line is not
currently signed on.
EXTRA Connection is currently not part of any path Routing Code: 1,2,10
and is not needed to reach any node.
Descriptor Code: 4
MAXREST
Connection is not in use because all paths that
$HASP818
can make use of it have reached their
resistance limit (as specified on NJEDEF Explanation:
RESTMAX). REDIRECT ( inputcon ) DA= outcon,
UNCONNECTED
Static connection between two nodes, neither DF= outcon, DI= outcon, DJ= outcon,
of which are reachable by any path.
DN= outcon, DQ= outcon, DU= outcon,
System action: Processing continues
DSPL outcon, LJ= outcon, DEF= outcon,
Operator response: None.
Detecting Module: HASPCOMM, HASPNPM DCONNECT= outcon, DNODE= outcon
Routing Code: #
JES2 issues this message in response to a $ADD, $T
Descriptor Code: – or $D REDIRECT command.
In the message text:
$HASP816 inputcon
The 2- to 8-character console name or the
Explanation:
console identifier specified in the command.
SUBNET (vvvvvvvv) node1,node1,...
outcon The 2- to 8-character console name or console
The system issues this message in response to an identifier and the optional display area JES2
operator-entered $D SUBNET command or a D directs the response for specific display
SUBNET JES2 read in the initialization deck. commands.
The nodes node1,node2,... are all defined with the
value vvvvvvvv for SUBNET= on the NODE(nnnn) For example, if the inputcon is POOL2 and DA=TAPE2,
statement. JES2 directs responses to $DA commands entered on
In the message text: POOL2 to TAPE2.
vvvvvvvv Operator response: None.
The name of the subnet.
| Detecting Module: HASCSCAN
node1 and node2
Routing Code: #
Names of nodes.
Descriptor Code: –
System action: Processing continues.
Operator response: None.
$HASP819
| Detecting Module: HASCSCAN, HASPCOMM
Explanation:
Routing Code: # statement keyword=value,...
statement keyword=value,...
Descriptor Code: – statement keyword=value,...
....
$HASP817
JES2 issues this message in response to a $D
Explanation:
command that specified the LOADMOD initialization
SUBTDEF GSUBNUM= value
statement. Depending on what information you specified
on the $D command, the response is one of the
This message is issued in response to a $D SUBTDEF following:
command and displays the value of the GSUBNUM
v All of the keywords defined on the specified
keyword.
initialization statement or command and their current
In the message text:
values (if the statement name is specified without any
value The value of the GSUBNUM keyword. keywords).
System action: Normal processing continues. v Certain keywords defined on the initialization
statement or command and their associated values (if
Operator response: None. the statement name and those keywords are
| Detecting Module: HASCSCAN specified on the DISPLAY statement or command).
LIMIT= llll, WARN= www, FREE= ffff description of the BUFDEF statement in z/OS JES2
Initialization and Tuning Reference explains each of the
This message is issued in response to a $D or $T keywords.
TPDEF command. The message displays the keywords In the message text:
defined on this statement and their current values. keyword
The AUTONUM display-only parameter shows the The name of the keyword.
number of remotes in autologon mode as specified by
RMT(nnnn) Autolog=Yes. value The value of the keyword.
BSCBUF= displays the maximum number (llll), the
lll A maximum number of keywords.
threshold percent for warning messages (www) and the
free buffers (ffff) below 16-megabytes in virtual storage. www A threshold percentage for warning messages.
SNABUF= displays the maximum number (llll), the
fff The number of free buffers.
threshold percent for warning messages (www) and the
free buffers (ffff) above 16-megabytes in virtual storage. System action: Processing continues.
SESSIONS= displays the maximum number (llll) of
VTAM sessions defined, the threshold percent for Operator response: None.
warning messages (www), and the number of free (ffff) | Detecting Module: HASCSCAN
and frozen (zzzz) VTAM sessions. (FREE= and
FROZEN= are display-only parameters.) Routing Code: 1,2,10
The description of the TPDEF statement in z/OS JES2 Descriptor Code: 4
Initialization and Tuning Reference explains each of the
keywords.
In the message text: $HASP841
keyword Explanation:
The name of the keyword. SMFDEF keyword=value,...,
in z/OS JES2 Initialization and Tuning Reference The number of free track groups on active spool
explains each of the keywords. volumes is also included in the message text with the
In the message text: TGSPACE=(FREE= keyword.
The description of the SPOOLDEF statement in z/OS
n The output class.
JES2 Initialization and Tuning Reference explains the
keyword SPOOLDEF keywords. Also see $D SPOOLDEF and $T
The name of the keyword. SPOOLDEF in z/OS JES2 Commands
GCRATE displays the current rate of garbage collection
value The value of the keyword. by spool space management as either NORMAL (an
System action: Processing continues. approximate 7–day cycle) or FAST (accelerated without
7–day pacing). If GCRATE=FAST is in effect, JES2 also
Operator response: None. displays the percentage of garbage collection completed
| Detecting Module: HASCSCAN as FAST,nn.nn% FINISHED.
Descriptor Code: 4
This message is issued in response to a $D or $T
ESTxxxx command. The message displays the
$HASP844 keywords defined on this statement and their current
values. The description of the ESTxxxx statement in
Explanation: z/OS JES2 Initialization and Tuning Reference explains
SPOOLDEF keyword=value,..., each of the keywords.
In the message text:
TGSPACE= ( FREE= nnnnn )
xxxx One of the following:
This message is issued in response to a $D or $T v BYTE
SPOOLDEF command. The message displays the v IME
keywords defined on this statement and their current
v LNCT
values.
The keyword LASTVAL has a time stamp that v PAGE
represents the last time the system was either cold v PUN
started, warm started using SPOOL=validate, or when
keyword
there is a detected error as a result of SPOOL=validate
The name of the keyword.
and the source of the error will be reported in message
$HASP492. value The value of the keyword.
bbb The maximum number of unused CKPT2 4K the volume without any warning messages. All
records. tracks allocated to these jobs will be lost until an
all-member warm start is performed if you have
System action: Processing continues.
specified SPOOL=VALIDATE as a start option or
System programmer response: None. within 7 days as provided by the JES2 spool
reclamation function, whichever occurs first.
| Detecting Module: HASCSCAN
System programmer response: To fully use the
volume later, reply N to $HASP811 or PURGE to
$HASP853 $HASP853. Increase the TGSPACE=(MAX=) value with
Explanation: a $T SPOOLDEF operator command. Restart the
REPLY GO, QUIT, OR PURGE specified volume, volser.
QUIT OR PURGE Detecting Module: HASPIRDA
This message is issued during a cold start when there Routing Code: 1,2,10
is not enough space in the TGM (track group map) to Descriptor Code: 4
map all of the track groups on the spool volume
identified by volser in messages $HASP850 and
$HASP854, which precede this message. $HASP850 $HASP854
indicates how many track groups for this volume are Explanation:
currently mapped in the track group map.
MAXIMUM NUMBER OF TRACK GROUPS EXCEEDED WHILE ALLOCATING VOLUME
This message is issued during an all-member warm
start to inform the operator that a spool volume was volser
mounted during earlier JES2 processing, but is not This message is issued during JES2 initialization or in
mounted and online now. response to a $S SPOOL command. There is not
System action: JES2 waits for the operator to reply. enough space in the master track group (TGM) map to
map all of the track groups on the spool volume
Operator response: Notify the system programmer identified by volser. Use TGSPACE=(MAX=) on the
and reply GO, QUIT, or PURGE depending on the SPOOLDEF statement to set or reset space available to
action you want taken. the TGM.
During a cold start: In the message text:
determine if JES2 initialization should continue and Contact the IBM Support Center for assistance.
attempt to issue a dump if the SJF service did not issue
Detecting Module: HASPIRMA
one. If JES2 initialization is continued with the error,
then JES2 bypasses all future use of SJF processing Routing Code: 1,2,10
and will not honor the JCL OUTPUT statement.
Descriptor Code: 2,7
Operator response: Notify the system programmer.
System programmer response: Correct the JDT $HASP857
library.
Explanation:
Detecting Module: HASPIRMA WARNING – EXITnnn
Routing Code: 1,2,10
NOT DEFINED WITHIN CURRENTLY
Descriptor Code: 2,7
LOADED JES2 MODULES
$HASP856
There is a JES2 initialization statement for EXIT(nnn),
Explanation: but that exit is not defined. That is, there is no module
JES2 FSS SERVICES PROHIBITED DUE TO loaded that issues the $EXIT macro instruction for exit
point nnn.
CROSS MEMORY AXxxx ERROR, RC= rc In the message text:
nnn The number of the exit.
JES2 failed to establish the cross memory authorization
index (AX) required for support of the functional System action: JES2 initialization continues.
subsystems.
Operator response: Notify the system programmer.
In the message text:
System programmer response: This is only an
xxx Either RES or SET.
informational message. Verify that the exit will be loaded
rc A return code. at a later time or that the exit is not required.
System action: Functional subsystem address spaces Detecting Module: HASPIRPL
will not be started by JES2.
Routing Code: 1,2,10
Operator response: Save the hard-copy log and
Descriptor Code: 4
notify the system programmer. For systems with remote
consoles, save the remote console sheet.
$HASP858
If the functional subsystem supported devices are also
supported in JES mode, you may enter the $T Explanation:
command to set the devices to MODE=JES. The EXIT ROUTINE nnn ( EXITnnn )
devices are then available for direct JES2 use.
NOT FOUND
System programmer response: Determine the
reason for the AXRES or AXSET error and correct it. If
you want, have the operator stop and restart JES2. For The exit routine name that appears in the message text
a description of the return code, see z/OS MVS was specified on the EXIT(nnn) initialization statement,
Programming: Assembler Services Reference but JES2 could not find that routine. Either there is no
ABE-HSP. LOAD initialization statement for the module containing
the routine, or there is no $ENTRY macro instruction
If you use SMP/E to make all changes to the system, defining the routine name as an entry point.
run LIST CDS and LIST PTFBY functions of SMP/E to In the message text:
obtain a list of the current maintenance from the SMP/E
control data set (CDS). name The name of the exit routine.
If you make any changes to the system without using nnn The number of the exit.
SMP/E, run the LISTIDR function of AMBLIST to obtain System action: JES2 issues messages $HASP859
a list of all members with a PTF or local fix and save and $HASP441, then waits for the operator to reply.
the output. Run LISTIDR against the following:
v SYS1.LINKLIB. Operator response: Notify the system programmer.
Reply Y or N to message $HASP441. If you reply Y,
v SYS1.SVCLIB JES2 ignores the missing exit routine and processes
v The library containing the program that issued the any other exit routines specified for EXITnnn. If you
message. reply N, JES2 issues message $HASP428 and ends.
v SYS1.LPALIB
v 24 – Post-initialization exit
$HASP863
Explanation: In the message text:
MORE THAN 10 SPOOL I/O ERRORS OCCURRED.
nn The number of the installation exit.
SHOULD JES2 CONTINUE THE WARM START? routine The name of the exit routine that requested
JES2 initialization to be terminated.
VALID RESPONSES ARE:
System action: Processing continues and initialization
’CONTINUE’ - CONTINUE THE WARM START ends.
’ABEND’ - TERMINATE JES2 WITH $V02 ABEND Operator response: Notify the system programmer.
System programmer response: Correct the problem
JES2 warm start processing has detected at least 10
that installation exit 0 found or change the initialization
errors accessing SPOOL. This message is followed by
deck to disable exit 19 or exit 24.
the $HASP272 WTOR. This can be caused by a
mismatch between the SPOOL and the checkpoint data Detecting Module: HASPIRA
sets or by starting with an old SPOOL or checkpoint
Routing Code: 1,2,10
data set. At this point, JES2 has not written any
significant data to the SPOOL or checkpoint data sets. Descriptor Code: 4
If you reply CONTINUE to $HASP272, JES2 will
initialize and write updated data to the current
checkpoint and SPOOL data sets. If you reply ABEND, $HASP865
JES2 terminates and can be restarted with the correct Explanation:
checkpoint and SPOOL data sets. CONFIRM MEMBER (nn)
System action: JES2 issues the $HASP272 WTOR to
query the operator for continuation options. NAME= memname1 IS TO BE
request what action should be taken. System action: JES2 processing continues. The
indicated offload job transmitter or offload job receiver is
Operator response: Notify the system programmer.
defined with a default affinity list.
System programmer response: When $HASP870 is
Operator response: When JES2 initialization is
issued, see the description of the responses under the
complete, use the $T OFFn.JT or the $TOFFn.JR
system action. Give the appropriate reply.
command to set the correct system affinity list.
Detecting Module: HASPIRDA
Detecting Module: HASPIRMA
Routing Code: 1,2,10
Routing Code: 1,2,10
Descriptor Code: 4
Descriptor Code: 4
$HASP866
$HASP869
Explanation:
Explanation:
devname IMPLICIT
.... - JOB NOT FOUND
FSS DEFINITION INVALID,
This message is issued in response to a ZAPJOB
NO FSS ASSIGNMENT MADE command when no jobs are found that match the input
parameters. This message is only issued during JES2
initialization processing.
The device initialization statement for devname
specified FSS=xxxx, indicating the device was System action: Processing continues.
supported by an FSS. An FSS(xxxx) initialization
Operator response: None.
statement was not provided for this FSS. Although JES2
attempted, after parameter processing, to process the | Detecting Module: HASCSCAN
implicitly defined FSS(xxxx), it encountered an error. A
GETMAIN for the FSS definition may have failed. Routing Code: 1,2,10
In the message text: Descriptor Code: 4
devname
The name of the device. $HASP870
System action: Processing continues. The FSS will Explanation:
not be defined and the device will not be supported by REPLY Y TO CONFIRM, N TO REFUSE
an FSS.
Operator response: Notify the system programmer. If OR T TO TERMINATE
the FSS should be created, use the $ADD FSS(xxxx)
command when the hot start completes. The device can JES2 detects that a change to a member name has
be moved to the FSS using the $T device,FSS=xxxx been requested. The message $HASP865 precedes this
command. message specifying the requested change.
System programmer response: Either correct the System action: A reply of Y causes the change
initialization statements or have the operator create the requested in message $HASP865 to occur. JES2
FSS. initialization will continue with the new member name
assigned to the configuration.
Detecting Module: HASPIRMA
A reply of N causes the requested change to be
Routing Code: 1,2,10 ignored. If this member did not make the request, JES2
Descriptor Code: 4 initialization will continue with the member name
unchanged from the previous start of JES2.
– INSUFFICIENT STORAGE
$HASP871
Explanation: There is not enough storage available for the dynamic
WARNING DTE service routine ($DTEDYNA) to complete attach
processing for subtask tttttttt.
– SYS1.IMAGELIB FAILED TO OPEN In the message text:
tttttttt The name of the subtask.
During JES2 initialization, an error was encountered
attempting to open the SYS1.IMAGELIB data set. System action: Control is returned to the JES2
processor that tried to attach the subtask. The type of
System action: Message $HASP872 follows, processing (recovery, end, or normal) depends on the
requesting operator action. individual JES2 processor.
Operator response: None. See message $HASP872. Operator response: Notify the system programmer.
System programmer response: Determine the cause System programmer response: Determine why there
of the error and take corrective action. is insufficient storage in the JES2 address space and
correct the error.
Note: Data management message IEC119I may have
been issued to aid in problem determination. Detecting Module: HASPDYN
Descriptor Code: 4
$HASP874
$HASP872 Explanation:
JES2 VERSION vvvvvvvv
Explanation:
REPLY‘Y’ TO CONTINUE INITIALIZATION, IS INCOMPATIBLE WITH MVS
module – reason, RC= rsnc increasing the common storage area (CSA) for the
system.
Either the $MODLOAD routine detected an error during MODULE COULD NOT BE LOADED, RC=02
the loading of the specified module or the $MODCHK
routine detected an error during verification. The Explanation: An attempt to load the module failed.
variable text and reason code indicate the exact reason The module is probably not in the correct library
for the error. These are explained under the (STEPLIB, LINKLIST, or LPA).
programmer response section.
System programmer response: Place the module in
In the message text:
the appropriate library from which JES2 can
module successfully load it.
The name of the module.
MODULE IS NOT REENTRANT, RC=03
reason Explains the reason for the error.
Explanation: Because the module is not reentrant, it
rsnc The reason code accompanying reason. could not be loaded into the common storage area
(CSA).
Note: This message is issued only if MESSAGE=YES System programmer response: Ensure that the code
is specified on the $MODLOAD or $MODCHK in the module is reentrant. Use the linkage editor to
macros. mark it reentrant for JES2 load processing.
System action: The system action depends on the NEW CSA/LPA LOADMODS INVALID ON HOT
module displayed and the specific circumstances: START, RC=04
v If the JES2 initialization module (HASPINIT) or one of
its subsystem support modules had an error, JES2 Explanation: On this JES2 hot start, an attempt was
initialization processing stops. made to either load a module into CSA or to load a
module that was in LPA. New common storage modules
v If an MVS module that JES2 may load (for example, cannot be loaded on a hot start because the existing
IEE7603D) had an error, JES2 asks the operator modules may be in use for common storage exits and
whether JES2 initialization should end. the exit routines cannot be changed.
v If the error occurred while processing a LOADMOD
initialization statement, $SCAN begins requesting System programmer response: If it is necessary to
input from the operator console instead of the normal load new common storage modules or replace existing
parmlib input. This allows the operator to correct the ones, perform a warm start of JES2.
error, if necessary. INSUFFICIENT STORAGE TO LOAD MODULE,
For this type of error, the message displayed is RC=05
actually $HASP003 with one of the variable texts
Explanation: A request was made to load a module
listed below.
into CSA, but no CSA storage was available.
v If the exit incurred an error ($MODLOAD or
$MODCHK was called from an installation exit), the System programmer response: Resolve the lack of
system action depends on the caller of the service. storage by either increasing the CSA for the system or
by freeing other CSA uses.
Operator response: Notify the system programmer.
MODULE IS INVALID, RMODE MUST BE 24, RC=06
System programmer response: The response
depends on the type of error that occurred. See the Explanation: The module being loaded is marked as
values of reason and rsnc and their explanations below: RMODE 31 and resides above 16 megabytes in virtual
storage. All JES2 code must be marked RMODE 24.
INSUFFICIENT STORAGE FOR LOAD MODULE
TABLE ENTRY, RC=01 System programmer response: Regenerate the
module with RMODE 24.
Explanation:
INSUFFICIENT STORAGE FOR LOAD MODULE NAME DOES NOT MATCH ITS
MIT,EXPECTED-mit_exp ACTUAL-mit_act, RC=07
MODULE TABLE ENTRY, RC=01 Explanation: During module verification, a
JES2-format module was checked to ensure its load
An attempt was made to allocate a load module table module name matched the name in the module
entry for the displayed load module, but no storage was information table (MIT). The check failed.
available. There is no logical limit on the number of
entries, except the amount of available storage. Note: No JES2 uses of $MODCHK specify that this
type of check should be done at this time; the
System programmer response: Resolve the lack of
programmer specified this verification.
storage. You may accomplish this by reducing the
number of LOADMOD initialization statements or by System programmer response: Rename the load
module to match the name in the MIT. $MODCHK because the address operand was not
coded on the $MODCHK macro and the entry point was
MODULE VERSION IS INVALID, EXPECTED-ver_exp
not found in the load module table ($LMT).
ACTUAL-ver_act, RC=08
Explanation: The version number in the module Note: This is probably because JES2 or an installation
information table (MIT) for this module does not match exit called $MODCHK before a successful
the version of the JES2 release that is running. $MODLOAD was performed.
System programmer response: Reassemble the System programmer response: Either code the
module at the same version level as the JES2 release ADDR= parameter for load modules when calling
currently running. $MODCHK or ensure the JES2 load module was loaded
successfully by $MODLOAD.
MODULE ASSEMBLED WITH INVALID MACRO
LIBRARIES, EXPECTED-lib_exp ACTUAL-lib_act, INVALID TIME FRAME TO LOAD TO CSA/LPA,
RC=09 RC=14
Explanation: The module was assembled with a set of Explanation: A $MODLOAD call was made for the
MVS macro libraries different from the set used to named module. It is not possible to load modules into
assemble the JES2 system that is running (for example common storage this early in JES2 initialization. This
MVS/ESA rather than z/OS). can occur if Exit 0 is found in LPA (not
STEPLIB/LINKLIST) or when installation of Exit 0 issues
System programmer response: Reassemble the
$MODLOAD TYPE=JES2 and the requested module is
module with the correct macro library level.
found in LPA.
MODULE IS NOT IN COMMON STORAGE, RC=10
System programmer response: If you must load
Explanation: The $MODCHK routine determined that installation modules into CSA early in initialization, either
this module is not in common storage. This error should use a LOADMOD initialization statement early in your
not occur with the modules that JES2 loads because it initialization stream, or call $MODLOAD in an early call
forces these modules into CSA if they are not in LPA. to exit 19 during parameter processing by $SCAN.
System programmer response: Either place the MODULE USER VERSION IS INVALID
module in LPA, or change your exit $MODLOAD calls to EXPECTED-uver_exp ACTUAL-uver_act, RC=15
request that the module be placed in CSA.
Explanation: The module user version character string
MODULE MIT IS INVALID, CANNOT LOCATE LMT, for this module in the module information table (as
RC=11 defined by &UVERS in $HASPGBL), does not match
the version of the JES2 release that is running.
MODULE MIT IS INVALID, MODULE TOO SMALL,
RC=11 System programmer response: Reassemble the
module at the same version level as the JES2 release
MODULE MIT IS INVALID, INCORRECT MITETBL currently running.
ADDRESS, RC=11
MODULE IBM USER VERSION IS INVALID, RC=16
MODULE MIT IS INVALID, INCORRECT
EYECATCHER, EXPECTED-mit ACTUAL-mit, RC=11 Explanation: The user version character string for this
module in the module information table (MIT) does not
Explanation: The module information table (MIT) for match the IBM-defined value.
the module is not valid for one or more of the following
reasons: System programmer response: Ensure that the
v The module is not long enough to contain a module object deck is at the correct maintenance level. If the
information table. object deck is at the correct maintenance level and the
error persists, contact your IBM support representative.
v The module does not begin with CL4‘MIT’.
v The MITETBL pointer to the MIT entry table, which is MODULE $ENTRY ADDRESS TABLE OFFSET(S)
generated at the end of the module, points to an NOT VALID, RC=17
address outside the range of the module. Explanation: An IBM module was loaded into
System programmer response: Reassemble the common storage during JES2 initialization saving the
module with the correct JES2 module structure, using a service routine’s entry point address information. At
$MODULE macro to start the module (and generate the least one entry point was defined (through the $ENTRY
MIT), and a $MODEND macro to end the module (and macro) to have its address placed at an invalid offset
generate the MITETBL). within the CADDR control block.
MODULE NOT FOUND – MODULE CANNOT BE System programmer response: Ensure that the
VERIFIED, RC=12 module being loaded to common storage matches the
version of JES2 code currently performing JES2
Explanation: No verification checks were done by initialization.
MODULE CONTAINS DUPLICATE ADDRESS TABLE To prevent a possible $K03 abend of the existing
$ENTRY, RC=18 member, message $HASP441 is issued asking if
initialization should continue.
Explanation: An IBM module was loaded into
In the message text:
common storage during JES2 initialization saving the
service routine’s entry point address information. At memname
least one entry point was defined (through the $ENTRY The member name.
macro) to have its address placed at an invalid offset
nn The number of the currently active member.
within the CADDR control block where another entry
point address has already been placed. System action: When the $HASP441 message is
issued, JES2 waits for a reply.
System programmer response: Ensure that the
module being loaded to common storage matches the Operator response: If you are initializing a JES2
version of JES2 code currently performing JES2 member with a name that is identical to the OWNMEMB
initialization. of a currently active member, respond N to the
$HASP441 message. Verify, using the $D
Detecting Module: HASPCSV, HASPIRSI
MEMBER,NAME command on an already active
Routing Code: 1,2,10 system, that there are no other members active by the
same name using this checkpoint. If you respond Y to
Descriptor Code: 4
$HASP441 and there’s another member active by that
name, that member will be abended.
$HASP876
If this member is being restarted, SYNCTOL has not
Explanation: expired and you should respond Y to the $HASP441
MEMBER memname IS ACTIVE, message. This will end the other JES2 member with the
same name.
DELETION IGNORED Detecting Module: HASPIRDA
CHANGE
Routing Code: 1,2,10
JES2 detects that a member name change has been Descriptor Code: 2,7
requested for member memname, which is currently
active. The $HASP865 message precedes this message
specifying the requested action. $HASP878
In the message text: Explanation:
memname devname ATTACH FAILED
The member name.
– INITIALIZATION ERROR
System action: JES2 issues the $HASP441 message,
asking whether to continue initialization and ignore the
JES2 has attempted to attach the subtask specified by
message, or stop.
dtename, but the subtask encountered an error during
Operator response: Notify the system programmer. its initialization. The error encountered depends upon
When the member name is correct, restart JES2. the individual subtask.
In the message text:
System programmer response: Respond to the
$HASP441 message. If you respond N, you should dtename
correct the initialization data set by assigning the correct The name of the failed subtask.
memname on the MEMBER initialization statement.
System action: JES2 detaches the specified subtask.
Detecting Module: HASPIRDA
Operator response: Notify the system programmer.
Routing Code: 1,2,10
System programmer response: Determine why the
Descriptor Code: 2,7 subtask failed to initialize and whether JES2 should
continue without the subtask.
$HASP877 Detecting Module: HASPDYN
Explanation: Routing Code: 2,10
OWNMEMB= memname SPECIFIED ON MASDEF
Descriptor Code: 4
IS ALREADY ACTIVE AS MEMBER(nn)
keyword=value,...
$HASP879
Explanation: JES2 issues this message in response to a:
RMT(nnn) DEVTYPE= unit, v $D or $T command that specified the LINE(nnnn)
initialization statement.
STATUS= status, keyword=value,...
v $DU command that either implicitly or explicitly
specified the LINE(nnnn) initialization statement.
JES2 issues this message in response to a:
v $S, $P, or $E command that specified LINE(nnnn)
v $D or $T command that specified the RMT(nnnn)
devices.
initialization statement.
v $DU or $T command that either implicitly or explicitly If this message is issued in response to a $DU, $S, $P,
specified the RMT(nnnn) initialization statement. or $E command, only UNIT= and STATUS= may be
v $S or $P command that specified SNA RMT(nnnn) displayed. Otherwise, the message displays all the
device(s). keywords on the LINE(nnnn) statement that are related
to this type of line (SNA or BSC, as defined by the
If this message is issued in response to a $DU, $S, or UNIT= parameter) and their current values. The
$P command, only DEVTYPE= and STATUS= may be description of the LINE(nnnn) statement in z/OS JES2
displayed. Otherwise, the message displays all the Initialization and Tuning Reference explains most of the
keywords on the RMT(nnnn) statement that are related keywords. Further information can be found under
to this type of remote (SNA or BSC, as defined by the $HASP603.
DEVTYPE= keyword) and their current values. The
descriptions of the BSC and SNA RMT(nnnn) In the message text:
statements in z/OS JES2 Initialization and Tuning
lna The line number.
Reference explain the keywords.
dev|SNA
In the message text: Specifies a 4-digit hexadecimal device number
for a binary synchronous communication (BSC)
nnnn The number of the remote.
line. For system network architecture (SNA)
unit The type of remote (either SNA or BSC). lines, UNIT=SNA.
status The status of the device. The values for status status The status of the device. The values for status
are listed below. are:
keyword v DRAINED/rname
The name of the keyword. v DRAINING/rname
value The value of the keyword. v INACTIVE/rname or nname
v ACTIVE/rname or nname
The STATUS= keyword displays the current status of v SIGNON/nname
the remote device. Possible values for status are: v SIGNON/AWAITING-MAS(member-name)
v INACTIVE nname
v ACTIVE/LINEnnnn v SIGNON/AWAITING-ncc or nname
v INACTIVE/LINEnnnn keyword
System action: Processing continues. The name of the keyword.
Operator response: None. value The value of the keyword. See z/OS JES2
Initialization and Tuning Reference for an
| Detecting Module: HASCSCAN explanation of most keywords.
Routing Code: #/1,2,10 This keyword might be DISCON={QUIESCE |
Descriptor Code: –,4 INTERRUPT | NO} which is a ‘display only’
keyword. DISCON= displays the disconnect
status for the line with possible values of:
$HASP880
Value Meaning
Explanation:
LINElna UNIT= dev NO The line is not in the process of
SNA disconnecting
,STATUS= status, QUIESCE
When the current work on the line
completes, the line will disconnect
INTERRUPT status The status of the device. The values for status
The line is interrupting the current are listed below.
transmission and when complete will
keyword
disconnect the line.
The name of the keyword.
The STATUS= keyword displays the current status of value The value of the keyword.
the device. The possible values for status are listed
below, where rname or nname is optionally displayed, The STATUS= keyword displays the current status of
indicating the remote name (RMTnnnn) or node name the LOGONn device. The possible values for status are:
for which the line is currently in use or permanently v DRAINED
assigned.
v DRAINING
In the STATUS= text: v INACTIVE
v ACTIVE
member-name
The name of the member of the local MAS, or System action: Processing continues.
list of member names, from which signon
responses are required before the signon can Operator response: None.
complete. | Detecting Module: HASCSCAN
ncc The NCC record type (J, K, or L) next Routing Code: #/1,2,10
expected from node nname to allow the signon
to continue. Descriptor Code: –,4
UNIT=ddd v STARTING
UNIT=/ddd v INACTIVE
UNIT=/dddd
v ACTIVE,(jobid jobname)
The STATUS= keyword displays the current status of System action: Processing continues.
the OFFLOADn device. The possible values for status
are: Operator response: None.
v DRAINED | Detecting Module: HASCSCAN
v DRAINING Routing Code: #/1,2,10
v STARTING
Descriptor Code: –,4
v INACTIVE
v ACTIVE
$HASP884
v HALTED
Explanation:
System action: Processing continues. OFFn.JT STATUS= status,
Operator response: None.
keyword=value,...
| Detecting Module: HASCSCAN
Routing Code: #/1,2,10 JES2 issues this message in response to a:
Descriptor Code: –,4 v $D or $T command that specified the OFFn.JT
initialization statement.
v $DU command that either implicitly or explicitly
$HASP883 specified the OFFn.JT initialization statement.
Explanation: If this message is issued in response to a $DU
OFFn.JR STATUS= status, command, it is possible that only STATUS= is displayed.
Otherwise, it displays all the keywords defined on the
keyword=value,... OFFn.JT statement and their current values. The
description of the OFFn.JT statement in z/OS JES2
JES2 issues this message in response to a: Initialization and Tuning Reference explains each of the
v $D or $T command that specified the OFFn.JR keywords.
initialization statement.
v $DU command that either implicitly or explicitly In the message text:
specified the OFFn.JR initialization statement. n The number of the offload device.
If this message is issued in response to a $DU status The status of the device. The values for status
command, it is possible that only STATUS= is displayed. are listed below.
Otherwise, it displays all the keywords defined on the keyword
OFFn.JR statement and their current values. The The name of the keyword.
description of the OFFn.JR statement in z/OS JES2
Initialization and Tuning Reference explains each of the value The value of the keyword.
keywords.
The STATUS= keyword displays the current status of
In the message text: the OFFn.JT device. The possible values for status are:
v DRAINED
n The number of the offload device.
v DRAINING,(jobid jobname)
status The status of the device. The values for status
v STARTABLE
are listed below.
v STARTING
keyword
v INACTIVE
The name of the keyword.
v ACTIVE,(jobid jobname)
value The value of the keyword.
System action: Processing continues.
The STATUS= keyword displays the current status of Operator response: None.
the OFFn.JR device. The possible values for status are:
| Detecting Module: HASCSCAN
v DRAINED
v DRAINING,(jobid jobname) Routing Code: #/1,2,10
v STARTABLE Descriptor Code: –,4
A route code in this display can have one of the The STATUS= keyword displays the current status of
following forms: the OFFn.ST device. The possible values for status are:
v LOCAL v DRAINED
v Rnnnn v DRAINING,(jobid jobname)
v Unnnn v STARTABLE
v userid v STARTING
v nodename v INACTIVE
v nodename.Rnnnn v ACTIVE,(jobid jobname)
v nodename.userid
v nodename.* A route code in this display can have one of the
following forms:
v *
v LOCAL
If the message shows * as the route code, this device is v Rnnnn
selecting all output regardless of the route code value. If v Unnnn
v userid
v nodename
| $HASP889
v nodename.Rnnnn
| Explanation:
v nodename.userid
| SRVCLASS (xxxxxxxx) keyword=value,...
v nodename.*
|
v * | JES2 issues this message in response to $ADD, $D,
| $S, $P, or $T SRVCLASS command. The keywords
If the message shows * as the route code, this device is | defined and their current values are displayed.
selecting all output regardless of the route code value. If
the message shows nodename.* as the route code, this | System action: Processing continues.
device is selecting output for the node, nodename | Operator response: None
regardless of the userid.
| System programmer response: None
System action: Processing continues.
| Detecting Module: HASCSCAN
Operator response: None.
| Routing Code: Routed as a command response
| Detecting Module: HASCSCAN
| Descriptor Code: 4
Routing Code: #/1,2,10
|
Descriptor Code: –,4
$HASP890
$HASP887
Explanation:
Explanation: JOB ( jobname ),
EXIT ROUTINE xxxxxxxx,
STATUS= ( status ), CLASS= class,
NOT LOCATED IN COMMON STORAGE
PRIORITY= priority, SYSAFF= sysaff,
The exit effector for the JES2 user environment
HOLD= hold, CMDAUTH= (auth1,auth2),
determined that the load module containing the named
exit routine xxxxxxxx was not found in common storage. USERID= userid,
Exit routines called from the JES2 USER, FSS, or
SUBTASK environment must be made accessible by SPOOL=(VOLUMES= name ), TGS= nnnn,
placing them into CSA or LPA.
PERCENT= (xxx.xx)d,
System action: Exit routine xxxxxxxx will not be called
and the job/task for which the exit routine was invoked ARM_ELEMENT= YES CARDS= FFF,
will be terminated with ABEND code 0F7, REASON NO
code x’98’.
REBUILD= YES SRVCLASS= srvclass,
Operator response: Notify the system programmer. NO
System programmer response: The STORAGE
SCHENV= schenv, SCHENV_AFF= (member),
keyword on the JES2 LOADMOD initialization statement
controls the required storage location of the load SECLABEL_AFF= (member),
module. Specify one of the following JES2 initialization
statements: CC= ( code ,ABEND=(Sxxx.Unnnn) )
v LOADMOD(lmodname) STORAGE=LPA /* lmodname CODE=code
resides in LPA */
DELAY= BUSY_ON_DEVICE
v LOADMOD(lmodname) STORAGE=CSA /* HOLD
lmodname to reside in CSA */ LIMIT
LOCKED
An IPL must also be performed in conjunction with the SCHENV
correct specification of the JES2 LOADMOD SECLABEL
initialization statement. SPOOLS_NOT_AVAILABLE
SYSAFF
Detecting Module: HASCSIRQ MEMBER_STATUS
QUEUE_ERROR
Routing Code: 1,2,10
Descriptor Code: 11 This message is issued in response to a $D $T, $A, $H,
$E, $P, $C, or $S command. The message displays the
current status of the indicated job. If the message is in
response to the LONG parameter, JES2 also displays v c – The processing class (A-Z, 0-9).
all the information following the HOLD= keyword in the v CONVERTING – MVS is converting the job’s
message. JCL.
In the message text:
v devname – The JES2 name of any input or
jobname output device performing a function for the
The job name appearing on the job statement job.
or in the start procedure operand. v EXECUTING – The job is running.
status The STATUS= keyword describes the current v IN OUTPUT – The job is in OUTPUT
state of the job. processing.
v AWAITING ARM RESTART – The job is v ON COMMAND – A command is currently
waiting to be restarted by the automatic modifying the JOEs for this job.
restart management. This message appears v ON JOEPURGE – A JOE for this job is
after the job ends and before the automatic currently being purged.
restart management sends a restart request
v ON PRSYSOUT – The external writer or an
to JES2. If the automatic restart
application using the external writer interface
management sends a request to JES2 to
(the process SYSOUT or PSO interface) is
restart the job, the job’s status changes to
processing output for the job.
AWAITING EXECUTION.
v ON RESTART – Job is currently being ARM
v AWAITING CNVT/WAIT=YES – Similar to
restarted.
AWAITING CONVERSION, except that this
job must run on a conversion processor that v ON ROUT – Job is put through the
can wait for an MVS resource. These jobs transmission or reception process to build
have attempted conversion once before but the job’s control blocks for transmission to
failed because an MVS resource was not the final destination.
available (such as a PROCLIB data set that v ON SAPI – Output for this job is being
needs to be recalled from HSM or a ENQ processed by an application using the SAPI
that is not available). interface. This interface is used by both IBM
v AWAITING CONVERSION – The job is and OEM products to access SYSOUT data
waiting for JCL conversion. sets on SPOOL. Applications using the SAPI
interface can act as printers, archiving
v AWAITING EXECUTION – The job is waiting
agents, or browsers of SYSOUT data sets.
to run.
v ON SPINNING – A JOE is being created for
v AWAITING HARDCOPY – The job is waiting
a sysout data set that was spun off.
to be printed or punched.
v ON TSOUTPUT – The TSO OUTPUT
v AWAITING OUTPUT – The job has finished
command or an application using the same
running and is awaiting output processing.
interface as the TSO output command (the
v AWAITING PURGE – The job is waiting to process sysout or PSO interface) is
be purged. processing output for this job.
v AWAITING SPIN – A job has completed v SPINNING – The job is busy in SPIN
execution and is waiting for all the SPIN processing.
data sets that were created to complete the
v *UNKNOWN* – The job has a job type is not
process of being spun. All SPIN data sets
valid.
must have output elements built before the
job can move to the next phase. v xnode – The node to which the job will be
sent for processing.
v AWAITING XMITTER – The job is on the
XMITTER queue, waiting to be sent to class The class (A-Z and 0-9) that is assigned to the
another node for processing. specified job.
v $ – The job is a started task. priority
v @ – The job is a time-sharing user. Priority (0-15) that is specified for the job.
v BERT LOCKED / member-name(/pcename) sysaff Indicates where a job is eligible to run in the
– This indicates that an update-mode copy shared JES2 configuration.
of the job has been obtained by member
“member-name”, under the specified hold The job is currently held or will be held at the
processor (“pcename”). When issued in end of the current phase.
response to a $C, $E, $H, or $P job 1. HOLD=(ALL) will appear after a $H A,ALL
command, the command has been accepted command is issued. To reactivate all jobs
but the processing of the command will be issue a $A A command
deferred until the lock becomes available.
2. HOLD=(JOB) will appear after a $H JES2 displays six asterisks (**.****) for
J’jobname’ is issued. To reactivate a PERCENT= when the number of track groups
particular job issue a $A J’jobname’ exceeds 8,355,585.
command.
ARM ELEMENT={YES|NO}
auth1[,auth2] Indicates whether (YES) or not (NO) the job
Displays the remote(s) or node(s) that can uses the automatic restart manager services.
enter commands that affect this job.
FFF Number of input cards in the job stream.
auth1 and auth2 are obtained from one of the
REBUILD={YES|NO}
following:
The job is on the rebuild queue. After the
v The default output route code associated current phase of processing, the job will be
with the input device on which the job removed from the system.
entered the system.
SRVCLASS=srvclass
v The remote or node specified on a /*ROUTE
The WLM service class associated with the
PRINT JES2 control statement which
job. If the service class is in the process of
becomes the default print routing for the job.
being reset by the $TJOBnn,SRVCLASS=
v The remote or node specified on a /*ROUTE command the service class may display as
PUNCH JES2 control statement which *RESUME.
becomes the default punch routing for the
job. SCHENV=schenv
The scheduling environment.
If JES2 determines that auth1 and auth2 SCHENV_AFF=(member)
specify the same remote, JES2 only displays The members in the JES2 configuration on
auth1. which the scheduling environment is available.
LOCAL CC=(COMPLETED,CODE=y)
Any local device. The job completion code.
state, and the JES2 member is not MODE=WLM, then this may be a
independent (IND=NO). temporary state while the jobs are
being re-queued.
SCHENV
The job’s scheduling environment is SPOOLS_NOT_AVAILABLE
not available on any member, or is At least one SPOOL volume that the
available only on systems where JES2 job is using is halting or has been
is inactive. Use the halted.
$DJ’jobname’,LONG command to find
Yes Display only jobs which are delayed
out what scheduling environment a job
for any of the above reasons.
requires. Then use the D
WLM,SCHENV=schenv-name No Display only jobs which are not
command to find out the current delayed for any of the above reasons.
status of the scheduling environment
on each system in the sysplex. System action: Processing Continues.
JOBNAME=name
$HASP892
The name of the job or transaction program
Explanation: currently running.
INIT ( name ) STATUS ( status ),
f The class of the active job or transaction
program.
CLASS= class_list,
taskid The identifier of the task that started the
INELIGIBLE_CLASS ( class,class ), initiator. The identifier has the form STCnnnn.
$HASP896
Explanation:
DAS VERIFICATION AND REBUILD HAS COMPLETED
Also note: JES2 messages in the range $HASP9500 through $HASP9999 are also available for
customer use only. See Chapter 15, “Nine-thousands,” on page 299 for information on messages in
that range.
$HASP5081
$HASP5068
Explanation:
Explanation:
NETSRV xxx SYSTEM DUMP UNSUCCESSFUL
NETSRV xxx yyyyyyyy SUBTASK <nnn>
– ABEND LIMIT EXCEEDED, nnn OF yyyyyyyy The SDUMP requested from a JES2 NETSRV address
space has failed. A probable cause is that the dump
SUBTASKS REMAIN data set is full.
A subtask in the NETSRV address space has exceeded System action: Processing continues.
program check. If the abend was a program error, you must examine the linkage stack entries to
check, this is the translation exception address determine which CSA routines were called.
associated with the program check. If none is
Detecting Module: HASCNJRC
available, this field will not be displayed.
Routing Code: 1, 2, 10
| Modname Address + offset
Breaking event address. If supported by the Descriptor Code: 4
hardware, this is the address of the last branch
instruction before a program check. This is
useful for diagnosing wild branch instructions. $HASP5091
rsnc The reason code associated with the cause of SECURITY CHECK FAILED, RC=12
this occurrence A security check failed.
System action: An SDUMP is requested and recovery System action: The transmit or receive stream is
is attempted. terminated.
System programmer response: Use the dump System programmer response: See other error
obtained to diagnose the error. messages and traces to determine the cause of the
failure.
Detecting Module: HASCNJRC
Detecting Module: HASCNJJT, HASCNJJR,
Routing Code: 1, 2, 10 HASCNJST, HASCNJSR
Descriptor Code: 4 Routing Code: 1, 2, 10
Descriptor Code: 4
$HASP5532
Explanation:
jobname devname SEVERE ERROR - reason
While the JES2 monitor was in the process of Operator response: None.
terminating, it found that commands were queued for System programmer response: None.
processing. JES2 does not process these commands
and returns $HASP9053 to the command issuer. Detecting Module: HASJMON
In the message text:
Routing Code: 2,10
command
Descriptor Code: 4
The first 10 characters of the command that is
being rejected.
$HASP9090
System action: Command is not processed.
Explanation:
Operator response: None.
xxxxxxxxxx
System programmer response: None.
COMMAND REJECTED - AUTHORIZATION FAILURE
Detecting Module: HASJCMDS
Routing Code:Routed as a command response A JES2 monitor command was entered by an operator
or from a console that lacks sufficient authority to issue
Descriptor Code: 5 the command. The security product might issue a
related message, such as ICH408I, which can be used
$HASP9084 to further identify the source of the problem.
In the message text:
Explanation:
xxxxxxxxxx
JES MONITOR ADDRESS SPACE STARTED FOR
The first 10 characters of the command that
was rejected.
jes2
System action: The command is rejected.
JES2 started the monitor either because JES2 is
Operator response: Monitor commands cannot be
initializing or the monitor was restarted after having
issued without proper authority from the security
been terminated by a $JSTOP command or an ABEND.
product.
In the message text:
System programmer response: Contact the security
jes2 The name of the JES2 subsystem being
administrator to determine whether the command should
monitored.
be accepted. Update the appropriate profiles, if
System action: Processing continues. necessary, and notify the operator that the command
might be reentered.
Operator response: None.
System programmer response: None. Note: the first qualifier for the entity name of JES2
monitor commands is not the same as the first
Detecting Module: HASJMON qualifier for JES2 commands. For the JES2
Routing Code: 2, 10 monitor, the entity names start with jes2MON
where jes2 is the name of the JES2 address
Descriptor Code: 4 space being monitored.
RECOVERING address
The subtask is in the process of Current address of the module in the monitor
recovering from an ABEND. address space.
System action: Continues normal processing. length Current length of the module.
In the message text: count In the current interval, the number of samples
of this type.
yyyy.ddd hh:mm:ss
Date and time the statistics were last reset. percent In the current interval, the percentage of
samples of this type.
name Name of the resource being monitored. For
more information on resource names see the Samples are divided into the following types:
$HASP050 message.
ACTIVE
limit The limit for the resource at the current time. JES2 main task was active.
System action: Processing continues and JES2 System action: Displays data for incidents being
immediately issues the $HASP9121, $HASP9122 tracked and continues with the command response.
($JDJES), and $HASP9150 messages. Operator response: If any incident tracking messages
Operator response: None. are displayed, consult the explanation for the message
for further information.
System programmer response: None.
System programmer response: None.
Detecting Module: HASJCMDS
Detecting Module: HASJCMDS
Routing Code: Routed as a command response
Routing Code: Routed as a command response
Descriptor Code: 5
Descriptor Code: 5
$HASP9121
$HASP9130
Explanation:
$HASP9121 NO OUTSTANDING ALERTS Explanation:
D HISTORY
$HASP9121 OUTSTANDING ALERTS
JES2 issues this message in response to a
$JDHISTORY monitor command. This is a header
JES2 issues this message in response to a $JDJES or
message that is followed by the $HASP9131 and
a $JDSTATUS monitor command. This message is the
$HASP9132 messages.
header for alert messages that follow. Alerts represent
conditions detected by the monitor that are not System action: Processing continues and JES2
immediately issues the $HASP9131 and $HASP9132 System programmer response: None.
messages.
Detecting Module: HASJCMDS
Operator response: None.
Routing Code: Routed as a command response
System programmer response: None.
Descriptor Code: 5
Detecting Module: HASJCMDS
Routing Code: Routed as a command response $HASP9132
Descriptor Code: 5 Explanation:
MAIN TASK SAMPLING PERCENT HISTORY
$HASP9131
DATE TIME COUNT ACTIVE IDLE WAIT L-LOCK N-DISP PAGING
Explanation: ----
yyyy.ddd
----
hh:mm:ss
----- ------ ---- ---- ------ ------ ------
count active idle wait llock ndisp paging
JES2 name USAGE HISTORY
JES2 issues this message in response to a
DATE TIME LIMIT USAGE LOW HIGH AVERAGE $JDHISTORY monitor command. This message
---- ---- ----- ----- --- ---- ------- displays the history of JES2 main task CPU samples
yyyy.ddd hh:mm:ss limit usage low high average
over time. When the counts are reset, the old values
are saved and displayed in this message. JES2 displays
JES2 issues this message in response to a up to 72 set of counts representing 72 hours of CPU
$JDHISTORY monitor command. This message statistics.
displays the history of resource usage over time. When
the resource statistics are reset, the old values are
In the message text:
saved and displayed in this message. Up to 72 samples
are displayed for each resource which represents 72 yyyy.ddd hh:mm:ss
hours of resource usage. The date and time when the interval started.
The most current interval is displayed first.
Note: Resources are sampled, thus it is possible that a
count The number of samples collected in the
brief spike in usage of a resource may be missed
interval.
by the sampling and the high reflected in this
message may not reflect the actual highest active Percent of samples when JES2 main task was
utilization. actively running.
idle Percent of samples when JES2 was waiting in
In the message text:
a normal z/OS wait.
name The name of the resource being monitored. For
wait Percent of samples when JES2 main task is in
more information on resource names see the
a z/OS wait other than the normal wait for
$HASP050 message.
work.
yyyy.ddd hh:mm:ss
llock Percent of samples when JES2 main task is
The date and time when the interval started.
waiting to obtain the local lock.
The most current interval is displayed first.
ndisp Percent of samples when JES2 main task TCB
limit The limit for the resource when the interval
has been marked non-dispatchable for other
ended. Because of changes by operator
than a z/OS wait.
commands, this may be different from the limit
at the time the sampling interval started. paging Percent of samples when JES2 main task is
waiting for paging activity.
usage Resource usage at the end of the interval.
System action: Processing continues normally.
low The lowest amount of the resource in use
during the interval. Operator response: None.
high The highest amount of the resource in use System programmer response: None.
during the interval.
Detecting Module: HASJCMDS
average
Routing Code: Routed as a command response
The average amount of the resource in use
during the interval. Descriptor Code: 5
System action: Processing continues and JES2
issues the $HASP9132 message.
Operator response: None.
Routing Code: Routed as a command response processing. Having determined there are no outstanding
requests (D R,JOB=JES2), look for ENQ problems (D
Descriptor Code: 5
GRS,ANALYZE) and WTO buffer shortages (IEA404A
message). If no problems are found, DUMP the JES2
$HASP9152 address space and determine why JES2 is not
responding. Contact IBM support as appropriate.
Explanation:
JES2 INITIALIZING Detecting Module: HASJCMDS
Routing Code: Routed as a command response
JES2 issues this notice message in response to a
$JDJES or a $JDSTATUS monitor command. This Descriptor Code: 5
message indicates that the JES2 address space is
initializing and is not yet available for processing. $HASP9154
System action: Display continues. Explanation:
Operator response: The JES2 address space is in its CKPT RECONFIGURATION IN PROGRESS
initialization process and might be waiting for a reply to
a WTOR or JES2 might have also issued a $HASP709 JES2 issues this notice message in response to a
message indicating an initialization delay. Issue a D $JDJES or a $JDSTATUS monitor command. This
R,JOB=JES2 command to display any outstanding message indicates that the JES2 is reconfiguring the
requests from JES2. See the description of any checkpoint data sets and is not available for processing.
messages displayed for additional information. If no
System action: Display continues.
requests are outstanding and the condition persists,
contact your system programmer. Operator response: The JES2 address space is in
the process of reconfiguring the checkpoint data sets
System programmer response: If this condition
and might be waiting for a reply to a WTOR (locally or
persists, JES2 is unable to complete initialization
on another member) or copying data to a new
processing. Having determined there are no outstanding
checkpoint data set. First determine if a WTOR is
requests (D R,JOB=JES2), look for ENQ problems (D
outstanding by issuing a D R,JOB=JES2,CN=(ALL)
GRS,ANALYZE). If no problems are found, DUMP the
command to display any outstanding requests from
JES2 address space and determine why JES2 is not
JES2. Because the reconfiguration can be driven by
responding. Contact IBM support as appropriate.
any member of the MAS, route this command to all
Detecting Module: HASJCMDS systems. See the description of any messages
displayed for additional information. If no requests are
Routing Code: Routed as a command response
outstanding it is possible that the checkpoint data is
Descriptor Code: 5 being copied to the new data set. Depending on load,
this can take a few minutes. However, if the condition
persists, contact your system programmer.
$HASP9153
System programmer response: If this condition
Explanation: persists, JES2 might be unable to complete a
JES2 TERMINATING reconfiguration request. Having determined there are no
outstanding request (D R,JOB=JES2), look for XCF or
JES2 issues this notice message in response to a JESXCF signalling problems. The reconfiguration dialog
$JDJES or a $JDSTATUS monitor command. This uses JESXCF and SCF to coordinate the
message indicates that the JES2 address space is reconfiguration process. If signalling is lost, that might
terminating and is not available for processing. explain the problem. Also determine if any JES2
system(s) are down but not partitioned out of the
System action: Display continues.
SYSPLEX. Because all members must respond to a
Operator response: The JES2 address space is in reconfiguration request, JES2 might be waiting for a
the process of terminating and might be waiting for a member that is no longer active. Check also for any
reply to a WTOR. Issue a D R,JOB=JES2 command to ENQ problems (D GRS,ANALYZE) that might be
display any outstanding requests from JES2. See the blocking the JES2 address space. If you find no
description of any messages displayed for additional problems, DUMP the JES2 address space and
information. If no requests are outstanding ensure a determine why JES2 is not responding. Contact IBM
WTO buffer shortage does not exist. Look for a support as appropriate.
IEA0404A message (D R,MSG=IEA404A). If no
Detecting Module: HASJCMDS
problems are found and the condition persists, contact
your system programmer. Routing Code: Routed as a command response
System programmer response: If this condition Descriptor Code: 5
persists, JES2 is unable to complete termination
multiple instances of the same job to be running on two selected, issue a $SXEQ command.
systems. JES2 also issues this message in response to
System programmer response: None.
a $PJES2,TERM command. This message is normally
preceded by a $HASP9151 JES2 ADDRESS SPACE Detecting Module: HASJCMDS
NOT ACTIVE message.
Routing Code: Routed as a command response
System action: Display continues.
Descriptor Code: 5
Operator response: To restart JES2, you must re-IPL
the system.
$HASP9160
System programmer response: To determine why a
re-IPL is required, examine SYSLOG looking for Explanation:
$HASP088 messages or $PJES2,TERM commands. AT LEAST ONE PCE HAS ENDED
Descriptor Code: 5
JES2 issues this notice message in response to a
$JDJES or a $JDSTATUS monitor command. This
$HASP9159 message indicates that at least one SPOOL volume is
not active. This can be the result of a command issued
Explanation: to purge or halt a volume or as the result of a volume
JES2 EXECUTION PROCESSING STOPPED ($PXEQ) being halted because of errors on the volume. The
result is that performance of active jobs might be
JES2 issues this notice message in response to a impacted because not all SPOOL volumes are available
$JDJES or a $JDSTATUS monitor command. This or job and SYSOUT cannot be selected for processing
message indicates that a $PXEQ command has been because the needed SPOOL volumes are not available.
issued and that a $HASP222 message is outstanding.
Until you issue a $SXEQ command, JES2 cannot start System action: Display continues.
any new batch jobs. Operator response: To determine what volumes are
System action: Display continues. not available, issue the $DSPOOL,STATUS<>ACTIVE
command. If the volume should be active, issue the
Operator response: To allow new batch jobs to be
$SSPOOL(volume) command to start the correct PCEs wait for SPOOL space but might cause delays
volume. elsewhere.
System programmer response: None. Another source of potential problems is the SPOOLDEF
FENCE= settings and the AFFINITY= setting on your
Detecting Module: HASJCMDS
SPOOL volumes. Use of these parameters can limit the
Routing Code: Routed as a command response SPOOL space available to a PCE. This is especially
true if FENCE=(ACTIVE=YES,VOLUMES=1) and you
Descriptor Code: 5 have a large number of SPOOL volumes (greater than
64). If this is the case, consider increasing the number
$HASP9162 of volumes within the “fence”.
NETWORK PATH MANAGER rejoin the MAS as this value defaults to the local node
name.
FUNCTIONS SUSPENDED
System action: Processing continues.
information (a dump of the JES2 address space) and normal operations. If the problem cannot be resolved,
restart this system. issue the $P SPOOL(volume), CANCEL command to
delete the volume and all jobs and SYSOUT that has
Detecting Module: HASJCMDS
space on the volume.
Routing Code: Routed as a command response
System programmer response: None.
Descriptor Code:5
Detecting Module: HASJCMDS
Routing Code: Routed as a command response
$HASP9169
Descriptor Code:5
Explanation:
MEMBER CANNOT GET CKPT LOCK (PROBABLY HELD BY ANOTHER MEMBER)
| $HASP9171
JES2 issues this notice message in response to a
$JDJES or a $JDSTATUS monitor command. The | Explanation:
message indicates that JES2 is not able to access the | LOCAL MEMBER IS IN INDEPENDENT MODE
JES2 checkpoint. This is normally caused by another |
member holding the checkpoint and not releasing it. | JES2 issues this notice message in response to a
| $JDJES or a $JDSTATUS monitor command. This
System action: Most JES2 activities, such as running | message indicates that the local JES2 member is
jobs and printing output, require access to the JES2 | running in independent mode. Jobs submitted by
checkpoint. If this condition persists, JES2 functions will | members in independent mode can only be processed
eventually stop. | on members that are in independent mode. Jobs
Operator response: Determine which JES2 member | submitted by members that are not in independent
is holding the checkpoint lock by looking for HASP9207 | mode cannot be processed on members in independent
message on other members of the MAS. (Issue a | mode.
ROUTE *ALL, $JDSTATUS if all members use $ as the | If a job is not converting, executing, or going through
JES2 command prefix.) If a member is holding the JES2 | output processing, it might be because the independent
checkpoint, perform problem determination on that | state of the job is not the same as the member you
member and restart JES2 if needed. | believe should process the job. Use the $D JOB
| command to view the system affinity of the job and the
System programmer response: If this condition | $D MEMBER command to view the independent mode
occurs too frequently, consider adjusting the MASDEF | of the member.
LOCKOUT parameter. The condition is detected when
the time specified on LOCKOUT has elapsed and the | System action: Display continues.
checkpoint lock has not been obtained. | Operator response: None
Detecting Module: HASJCMDS | System programmer response: None
Routing Code: Routed as a command response | Detecting Module: HASJCMDS
Descriptor Code:5 | Routing Code: Routed as a command response
| Descriptor Code:5
$HASP9170
Explanation: | $HASP9172
AT LEAST ONE SPOOL VOLUME HALTED DUE TO I/O ERRORS
| Explanation:
JES2 issues this notice message in response to a | AT LEAST ONE OTHER MEMBER IS IN INDEPENDENT MODE
$JDJES or a $JDSTATUS monitor command. The |
message indicates that at least one SPOOL volume has | JES2 issues this notice message in response to a
been placed in halting status (or has halted) because an | $JDJES or a $JDSTATUS monitor command. This
I/O error has occurred when JES2 attempts to access | message indicates that at least one other JES2 member
data on that volume. | is running in independent mode. Jobs submitted by
| members in independent mode can only be processed
System action: Display continues. | on members that are in independent mode. Jobs
Operator response: To determine which volumes are | submitted by members that are not in independent
in a halting or halted state, issue a $DSPOOL | mode cannot be processed on members in independent
command. Review syslog to determine why the volume | mode.
was halted (look for $HASP630 VOLUME volume | If a job is not converting, executing, or going through
HALTING messages), and correct the cause of the I/O | output processing, it might be because the independent
error. When the problem has been resolved, issue the | state of the job is not the same as the member you
$S SPOOL(volume) command to return the volume to | believe should process the job. Use the $D JOB
| command to view the system affinity of the job and the condition persists, notify the system programmer.
| $D MEMBER command to view the independent mode
System programmer response: Except for rare
| of the member.
situations, JES2’s main task should not encounter z/OS
| System action: Display continues. WAITs. z/OS WAITs in the main task can cause
deadlocks that might impact multiple members of a
| Operator response: None MAS. Determine where the main task is waiting and
| System programmer response: None why. If an exit was in control at the time of the wait,
then the exit may need to be rewritten to subtask the
| Detecting Module: HASJCMDS code that causes the WAIT. Even if the message does
| Routing Code: Routed as a command response not indicate an exit, the code might be getting control as
a result of installation customization, for example, an
| Descriptor Code:5 installation—written SCAN driver command. If the
source of the wait cannot be immediately determined,
$HASP9201 take a dump of the JES2 address space to help
determine where and why the wait has occurred. If you
Explanation: determined that the wait is a result of IBM—distributed
JES2 MAIN TASK WAIT DETECTED AT module+offset code, contact the IBM support center.
DURATION- hh:mm:ss.xx PCE- pcename EXIT- xit Detecting Module: HASJSPLR
JOB ID- jobid COMMAND- jes2_command Routing Code: 1,2,10,42 or as a command response
Descriptor Code: 2,7 or 5 when a command response
JES2 issue this alert message in response to a $JDJES
or a $JDSTATUS monitor command or as a highlighted
message. Based on context, this message can indicate $HASP9202
an alert or an incident JES2 is tracking. This message
indicates that the monitor has detected the main task is Explanation:
in an unexpected wait. POTENTIAL JES2 MAIN TASK LOOP DETECTED NEAR module+offset
In the message text: DURATION- hh:mm:ss.xx PCE- pcename EXIT- xit
System programmer response: Long PCE indicates that the main task has not entered its normal
dispatches can be an indication of a tuning problem, a MVS wait for the duration specified. This can be caused
complex process that takes a long time to complete or by a number of situations:
an error situation. If the JES2 main task is not getting v A multi-PCE loop in which one PCE completes
enough CPU resource, it could appear to the monitor as processing, posts a second PCE and waits. When
a loop. Use the D A,JES2 command or a performance the second PCE gets control, it does some work,
monitor to ensure that JES2 is indeed consuming CPU. posts the first PCE and waits. First PCE posts
When you have eliminated CPU performance problems, second, and so forth.
check if the PCE displayed is the command processor
v Recurring problems getting basic resources such as
and examine the command that was entered. Some
the local lock or storage. Often other items are
commands can take a long time to complete, such as a
tracked but other alerts are not issued because the
command to alter all 200,000 jobs or 500,000 JOEs in
resource problems only last a second at a time.
the system. If progress is being made (job number
Issuing a $JDJES command and looking at incidents
displayed is being updated) for a complex command,
being tracked can help you identify what is
then this might be normal processing.
happening.
First, deal with the current situations by either waiting v Normal processing in a very busy NJE/RJE
for the command to complete or ABEND JES2 and then environment. If this is impacting other functions, you
restarting it. When this situation has been addressed, might study your networking parameters to determine
consider entering multiple commands with job ranges, if tuning them could reduce JES2 overhead. For more
for example $PJQ(1–20000), $PJQ(20001–40000), and information on tuning JES2 networking see z/OS
so forth). As each command completes, JES2 can JES2 Initialization and Tuning Guide.
perform other processes preventing JES2 from being
able to process other requests. In the message text:
If the problem is not a complex command, determine if hh:mm:ss.xx
progress is being made by examining the job ID in the The length of time the main task has been
message. If no progress is being made, there might be running without entering its normal MVS wait.
a problem. First, issuing the z/OS MVS DUMP
command to capture a dump of the JES2 address pcename
space. Then issue a $PJES2,ABEND command The name of the PCE in control.
followed by a $PJES2,ABEND,FORCE command to
xit The exit number in control (or NONE).
terminate JES2. When JES2 terminates, you can then
restart it. Analyze the dump to determine what code is jobid The job ID or job index associated with current
running and the cause of the long dispatch. If the PCE (or NONE).
problem is in exit code, or exit–invoked code, correct
jes2_command
the exit logic. Some logic, for example, that performs
If the current PCE is the command processor,
adequately when there were only 20,000 jobs in the job
the current command is being processed. If the
queue might have problems with 200,000 jobs. If the
current PCE is not the command processor,
problem is caused by IBM–distributed code, contact the
this line is not displayed.
IBM support center.
Detecting Module: HASJSPLR Note: Because data used to build this message is
sampled without serialization, it is possible, in
Routing Code: 1,2,10,42 or as a command response
rare situation, for the PCE, exit, or job
Descriptor Code: 2,7 or 5 when a command response information to not correspond to the address
being displayed.
$HASP9204 System action: If condition persists, JES2 reissues
this message every 30 seconds with updated
Explanation:
information.
JES2 MAIN TASK BUSY
Operator response: Monitor alerts indicate potential
DURATION- hh:mm:ss.xx PCE- pcename reasons why JES2 is not functioning properly. If this
condition persists, notify the system programmer.
EXIT- xit JOB ID- jobid
System programmer response: Use the
$JDDETAILS command to examine the distribution of
COMMAND- jes2_command
samples in the JES2 sampling statistics. If most
samples are in the ACTIVE and IDLE categories, the
JES2 issue this alert message in response to a $JDJES problem is that JES2 is busy processing work or is
or a $JDSTATUS monitor command or as a highlighted unable to get CPU resources. If JES2’s main task is
message. Based on context, this message can indicate ready to run but cannot get the CPU, because of tuning
an alert or an incident JES2 is tracking. This message problems, the samples appear as ACTIVE. Determine if
hh:mm:ss.xx MEMBER CANNOT GET CKPT LOCK (PROBABLY HELD BY ANOTHER MEMBER)
The length of time the PCE has been waiting
for the BERT lock. JES2 issue this alert message in response to a $JDJES
module+offset or address
$HASP9210
Module and offset or address where the main
task was made non-dispatchable. Explanation:
JES MAIN TASK PAGING WAIT AT module+offset
hh:mm:ss.xx
The length of time the main task was DURATION- hh:mm:ss.xx PCE- pcename
non-dispatchable.
EXIT- xit JOB ID- jobid
pcename
The name of the PCE in control during the COMMAND- jes2_command
wait.
JES2 issues this alert message in response to a
xit The exit number in control during the wait (or
$JDJES or a $JDSTATUS monitor command or as a
NONE).
highlighted message. Based on context, this message
jobid The job id or job index associated with the can indicate an alert or an incident JES2 is tracking.
current PCE (or NONE). This message indicates JES2 has been trying to resolve
a page fault for the duration specified. There are many
jes2_command
reasons for this, not all are related to paging but rather
If the current PCE is the command processor,
to locking problems.
the current command is being processed. If the
In the message text:
current PCE is not the command processor,
this line is not displayed. module+offset or address
Module and offset or address where the paging
Note: Because data used to build this message is wait occurred.
sampled without serialization, it is possible, in
hh:mm:ss.xx
rare situations, for the PCE, exit, or job
The length of time the wait has lasted.
information to not correspond to the address
being displayed. pcename
The name of the PCE in control during the
System action: If the condition persists, JES2
wait.
reissues this message every 30 seconds with updated
information. xit The exit number in control during the wait (or
NONE).
Operator response: Monitor alerts indicate potential
reasons why JES2 is not functioning properly. If this jobid The job ID or job index associated with the
condition persists, notify your system programmer. current PCE (or NONE).
System programmer response: If there is a dump in jes2_command
progress, this is normal processing. If there is no dump If the current PCE is the command processor,
in progress, look for ENQs held by the JES2 address the current command is being processed. If the
space or general ENQ contention using the D GRS,C current PCE is not the command processor,
and D GRS,ANALYZE commands. Look for subtasks in this line is not displayed.
the JES2 address spaces that might be waiting for
ENQs. Attempt to obtain a dump of the JES2 and GRS Note: Because data used to build this message is
address spaces using the z/OS DUMP command. sampled without serialization, it is possible, in
Depending on the situation, a dump of JES2 might not rare situations, for the PCE, exit, or job
be possible and a stand–alone dump might be needed. information to not correspond to the address
Examine the main task TCB to determine why it is not being displayed.
dispatchable. Examine subtasks to determine if they are
the cause of the non-dispatchability. One cause of System action: If the condition persists, JES2
problems in this area has been subtasked exits that reissues this message every 30 seconds with updated
obtain a STEP-MUST-COMPLETE ENQ as a result of information.
requests to the security product to update security data. Operator response: Monitor alerts indicate potential
When the ENQ is issued. the main task stops which can reasons why JES2 is not functioning properly. If this
create, in some cases, a deadlock situation. If the condition persists, notify your system programmer.
problem persists and appears to be in IBM–distributed
JES2 code, contact the IBM support center. System programmer response: Ensure that there are
no problems with the paging data sets, real frames
Detecting Module: HASJSPLR shortages, or any of the storage management
Routing Code: 1,2,10,42 or as a command response components and their setting. Examine tuning
parameters related to these areas. If you cannot
Descriptor Code: 2,7 or 5 when a command response determine the cause, request dumps of the JES2 and
master address spaces, ASID 3 and
Explanation:
This is an alert message which is issued in response to
JES MAIN TASK NOT RUNNING
a $JDJES or a $JDSTATUS JES2 monitor command or
as a highlighted message. Based on context, this
DURATION- hh:mm:ss.xx
message may indicate an alert or an incident being
tracked. This message is issued when the JES2 main
JES2 issues this message in response to a $JDJES or task has not been dispatched by MVS for a long period
a $JDSTATUS monitor command or as a highlighted of time.
message. Based on context, this message can indicate With this message, all indicators show that JES2 should
an alert or an incident JES2 is tracking. This message be running but it has not used any CPU resource (in
is issued when the JES2 main task has been waiting at contrast to $HASP9211 where JES2 is waiting at its
its normal wait for the duration specified. There are normal MVS wait for work).
indicators that the main task does have work to do and In the message text:
should be running, but it is not.
In the message text: hh:mm:ss.xx
The length of time since the main task last
hh:mm:ss.xx received any CPU resource.
The length of time the main task has been
waiting at its normal z/OS wait. System action: If the condition persists, JES2
reissues this message every 30 seconds with updated
System action: If the condition persists, JES2 information.
reissues this message every 30 seconds with updated
information. Operator response: Monitor alerts indicate potential
reasons why JES2 is not functioning properly. If this
Operator response: Monitor alerts indicate potential condition persists, notify your system programmer.
reasons why JES2 is not functioning properly. If this
condition persists, notify your system programmer. System programmer response: Most likely the JES2
main task is not being dispatched by MVS is because
System programmer response: JES2’s main task there is higher priority work in the system that is using
might not be running because of improper tuning of all available CPU resources. Either the other work in the
MVS parameters or because of a problem in the JES2 system is consuming more CPU resources than it
address space. If the condition persists, investigate should (for example, the system is in a loop), or the
tuning and operational considerations first. For example, priority assigned to the JES2 address space is too low.
consider if online applications have been tuned to run Determine which processes are using all the available
before JES2 (not a recommended practice), or if the CPU resources and either stop that work or raise the
operator has issued a command that requires heavy priority of the JES2 address space. Note that restarting
use of system resources. JES2 does not solve the problem and might not be
If the condition persists after investigating a tuning or possible in this situation.
operational issue, obtain a dump of the JES2 address Detecting Module: HASJSPLR
space and determine why the JES2 main task is not
being dispatched. Common problems include the Routing Code: 1,2,10,42 or as a command response
following: Descriptor Code: 2,7 or 5 when a command response
v A service or an exit has reset the main task STIMER
so that the main task is not ″waking up.″
$HASP9213
v A POST SRB is unable to run because the local lock
is not available. Determine which function is holding Explanation:
the local lock and why. LONG JES2 COMMAND PROCESSING
If the problems appear to be in IBM-distributed code, JES2 MAIN TASK DURATION hh:mm:ss.xx PCE pcename EXIT xit
contact the IBM support center. Restarting JES2 might JOB ID jobid COMMAND jes2_command
correct the problem, however, if the condition is a result
MEMBER CANNOT GET CKPT LOCK (PROBABLY HELD BY ANOTHER MEMBER)
of tuning, attempting to restart JES2 can aggravate the
condition. This is an alert message that is issued in response to a
Contact the system programmer to determine if continued processing is acceptable at an installation level
and then diagnose the problem. The following table contains a list of PCEs, their names, whether they are
required, and a description of their function.
z/OS information
z/OS information is accessible using screen readers with the BookServer/Library Server versions of z/OS
books in the Internet library at:
www.ibm.com/servers/eserver/zseries/zos/bkserv/
IBM may have patents or pending patent applications covering subject matter described in this document.
The furnishing of this document does not give you any license to these patents. You can send license
inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
USA
For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property
Department in your country or send inquiries, in writing, to:
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
The following paragraph does not apply to the United Kingdom or any other country where such
provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION
PROVIDES THIS DOCUMENT “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR
IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT,
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer
of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically
made to the information herein; these changes will be incorporated in new editions of the document. IBM
may make improvements and/or changes in the product(s) and/or the program(s) described in this
document at any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in
any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of
the materials for this IBM product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it believes appropriate without
incurring any obligation to you.
Licensees of this program who want to have information about it for the purpose of enabling: (i) the
exchange of information between independently created programs and other programs (including this one)
and (ii) the mutual use of the information which has been exchanged, should contact:
IBM Corporation
Mail Station P300
2455 South Road
Poughkeepsie, NY 12601-5400
USA
The licensed program described in this information and all licensed material available for it are provided by
IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any
equivalent agreement between us.
This information contains examples of data and reports used in daily business operations. To illustrate
them as completely as possible, the examples include the names of individuals, companies, brands, and
products. All of these names are fictitious and any similarity to the names and addresses used by an
actual business enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrates programming
techniques on various operating platforms. You may copy, modify, and distribute these sample programs in
any form without payment to IBM, for the purposes of developing, using, marketing or distributing
application programs conforming to the application programming interface for the operating platform for
which the sample programs are written. These examples have not been thoroughly tested under all
conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these
programs. You may copy, modify, and distribute these sample programs in any form without payment to
IBM for the purposes of developing, using, marketing, or distributing application programs conforming to
IBM’s application programming interfaces.
If you are viewing this information softcopy, the photographs and color illustrations may not appear.
Trademarks
The following terms are trademarks of the International Business Machines Corporation in the United
States, other countries or both:
v AFP
v BookManager
v DB2
v DFSMS/MVS
v eNetwork
v ES/3090
v ES/9000
v IBM
v IBMLink
v MVS/DFP
v MVS/ESA
v OS/390
v PR/SM
v Print Services Facility
v RACF
v Resource Link
v SP
334 z/OS V1R8.0 JES2 Messages
v System/360
v VTAM
v z/OS
v z/OS.e
Linux is a trademark of Linus Torvalds in the United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the
United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Other company, product, or service names may be trademarks or service marks of others.
Notices 335
336 z/OS V1R8.0 JES2 Messages
Glossary
This glossary defines technical terms and allocate. To assign a resource for use in performing a
abbreviations used in JES2 documentation. If you specific task.
do not find the term you are looking for, refer to
APA. See all points addressability
the index of the appropriate JES2 manual or view
IBM Glossary of Computing Terms, available from: APAR. Authorized program analysis report
American National Standard Dictionary for artificial JQE. An artificial JQE consists of the base
Information Systems, ANSI X3.172-1990, copyright JQE, the JQX, and additional fields defined in the JQA.
1990 by the American National Standards Institute
(ANSI). Copies may be purchased from the automatic restart. A restart that takes place during
the current run, that is, without resubmitting the job. An
American National Standards Institute, 11 West
automatic restart can occur within a job step or at the
42nd Street, New York, New York 10036.
beginning of a job step. Contrast with deferred restart.
Definitions are identified by an asterisk (*) that See also checkpoint restart.
appears between the term and the beginning of
the definition; a single definition taken from ANSI automatic volume recognition (AVR). A feature that
is identified by an asterisk after the item number allows the operator to mount labeled volumes on
for that definition. available I/O devices before the volumes are needed by
a job step.
AFP. See Advanced Function Presentation batch processing. (1) *Pertaining to the technique of
executing a set of computer programs such that each is
all-member warm start. A JES2 member restart of the completed before the next program of the set is started.
first member in a multi-access spool (MAS) (2) *Pertaining to the sequential input of computer
configuration. Either the JES2 member previously ended programs or data. (3) *Loosely, the serial execution of
without error or there must be an IPL of the MVS computer programs. (4) Under TSO, the processing of
system. one job step in a region, so called because jobs are
submitted in a group or batch.
all points addressability. The ability to address,
reference, and position text, overlays, and images at baud. (1) A unit of signaling speed equal to the
any defined position or pel on the printable area of the number of discrete conditions or signal events per
paper. This capability depends on the ability of the second. For example, one baud equals one-half dot
hardware to address and to display each picture cycle per second in Morse code, one bit per second in a
element. train of binary signals, and one 3-bit value per second in
cataloged procedure. A set of job control statements checkpoint write. Any write to the checkpoint data
that has been placed in a library and that can be set. A general term for the primary, intermediate, and
retrieved by name. final writes that update any checkpoint data set.
CCW. Channel command word checkpoint/restart facility. (1) A facility for restarting
execution of a program at some point other than at the
central storage. (1) In z/OS or System/390 virtual beginning, after the program was terminated due to a
storage systems, the storage of a z/OS or System/390 program or system failure. A restart can begin at a
computing system from which the central processing checkpoint or from the beginning of a job step, and
unit can directly obtain instructions and data, and to uses checkpoint records to reinitialize the system. (2)
which it can directly return results. (Formerly referred to Under TCAM, a facility that records the status of the
as “real storage”.) (2) Synonymous with processor teleprocessing network at designated intervals or
storage. following certain events. Following system failure, the
system can be restarted and continue without loss of
centralized control. Control in which all the primary messages.
station functions of the data link are centralized in one
data station. Contrast with independent control. checkpointing. Preserving processing information
during a program’s operation that allows such
CES. Connection event sequence processing to be restarted and duplicated.
chain printer. An impact printer that has a revolving CKPT1. The checkpoint data set designed as the one
chain with links that carry the type slugs. on which the reserve is acquired. In a DUAL mode
configuration, CKPT1 is one of the alternately used
primary data sets from which JES2 reads and writes the
connection event sequence. A clock value that destination. A combination of a node name and one
indicates the time a connection took place or was of the following: a userid, a remote printer or punch, a
broken. This is copied to NCC records and used by the special local printer, or LOCAL (the default if only a
path manager to determine the “most current” record node name is specified).
when keeping track of NJE connections.
destination identifier (destid). The 8-character
console. Any device from which operators can enter subscript on the DESTID(jxxxxxxx) initialization
commands or receive messages. For JES2, the same statement or command that corresponds to a
device from which an operator also enters MVS base combination of a first-level destination and a
control program commands. second-level destination that determines where data
should be sent in a JES2 installation. A destid can be
control statements. Statements placed into an input either a symbolic destination or an explicit destination.
stream to identify special JES2 processing options for
jobs. destination node. Node to which data is sent.
CSA. Common service area device partitioning. A pool of devices (called a fence)
to be used exclusively by a set of jobs in a specific job
CSECT. Control section class allowing an installation to tailor its device usage to
its anticipated workload.
CTC. Channel-to-channel adapter
direct access storage device (DASD). A device in
D which the access time is effectively independent of the
location of the data.
DASD. Direct access storage device
DJC. Dependent job control.
data integrity point. The generic name given to the
DUAL mode. A checkpointing mode that provides the
point in the 3800 model 3 printing process at which the
alternate use of two primary checkpoint data sets
data is known to be secure. (Also called the stacker.)
Glossary 339
(CKPT1 and CKPT2). The data sets are referred to as
the to-be-read-from and to-be-written-to data sets.
F
dump. A report showing the contents of storage. facility. (1) A feature of an operating system, designed
Dumps are typically produced following program to service a particular purpose, for example, the
failures, for use as diagnostic aids. checkpoint/restart facility. (2) A measure of how easy it
is to use a data processing system. Together with
DUPLEX mode. A checkpointing mode that provides system performance, a major factor on which the total
the continuous use of only one checkpoint data set. A productivity of an installation depends. (3) Anything
second (backup) data set is defined, but it is written to used or available for use in furnishing communication
less frequently than the primary. service. Commonly, a general term for communications
paths.
dynamic allocation. Assignment of system resources
to a program at the time the program is executed rather FCB. Forms control buffer
than at the time it is loaded into central storage.
final write. A write of the same information as the
dynamic connection. A connection created via intermediate write done at the end of the checkpoint
sign-on or NCC record sent from another node cycle. See also intermediate write.
Synonymous with non-static connection.
first-level destination. The nodal portion of a
dynamic table. An installation-defined table that is destination (the node to which the data goes).
used to extend, modify, or delete the JES2 default
processing specifications. See also table pair. foreground. (1) in multiprogramming, the environment
in which high-priority programs are executed. (2) Under
TSO, the environment in which programs are swapped
E in and out of central storage to allow CPU time to be
shared among terminal users. All command processor
EBCDIC. Extended binary coded decimal interchange programs execute in the foreground. Contrast with
code background.
ECSA. Extended common service area foreground job. (1) A high-priority job, usually a
real-time job. (2) A teleprocessing or graphic display job
EM. End of media that has an indefinite running time during which
communication is established with one or more users at
end of block (EOB). A code that marks the end of a
local or remote terminals. (3) Under TSO, any job
block of data.
executing in a swapped region of central storage, such
end-of-file mark (EOF). A code that signals that the as a command processor or a terminal user’s program.
last record of a file has been read. Contrast with background job.
EOB. End of block format. All tracks on a SPOOL volume are written to
accommodate later SPOOL I/O. This includes initializing
EOF. End of file the signature records.
EPVT. Extended private storage area forms control buffer (FCB). A buffer that is used to
store vertical formatting information for printing; each
execution node. The JES2 network job entry node position corresponding to a line on the form.
upon which a job is to be executed.
forwarding. The dynamic replacement of the
exit points. The place in the code where a routine checkpoint data set specifications (data set name and
(exit) receives control from the system. volume) with new specifications.
full function mode. The state that permits a printer to host-id. The unique 10-digit CPU identification made
produce page-mode output. up of the 6-digit CPU serial number followed by a 4-digit
model number.
functional subsystem (FSS). An address space
uniquely identified as performing a specific function hot start. A JES2 member restart performed when a
related to the JES. For JES2, an example of an FSS is member ends abnormally and the MVS system is not
the Print Services Facility program that operates the re-IPLed.
3800 Model 3 and 3820 printers.
functional subsystem interface (FSI). The interface IBM-defined exit. The point in source code where IBM
through which JES2 or JES3 communicate with the has added an exit point where an installation routine
functional subsystem. can receive control from the operating system. Contrast
with installation-defined exit.
functional subsystem startup. That process part of
system initialization when the functional subsystem impact printer. *A printer in which printing results from
address space is created. mechanical impacts.
Glossary 341
initiator. That part of an operating system that reads JES2 reader. In MVS, the part of the job entry
and processes operation control language statements subsystem that controls the input stream and its
from the system input device. associated job control statements. Synonymous with
input stream control.
initiator/terminator. The job scheduler function that
selects jobs and job steps to be executed, allocates JES2 table. A JES2-defined table that is used to
input/output devices for them, places them under task specify the default characteristics of many of its
control, and at completion of the job, supplies control initialization parameters, commands, and other
information for writing job output on a system output externals. See also table pair.
unit.
JES2 writer. In MVS, the part of the job entry
input service processing. In JES2, the process of subsystem that controls the output of specified data
performing the following for each job: reading the input sets. Synonymous with output stream control.
data, building the system input data set, and building
control table entries. JES3. Job entry subsystem 3. An MVS subsystem that
receives jobs into the system, converts them to internal
input stream control. Synonymous with JES2 reader. format, selects them for execution, processes their
output, and purges them from the system. In an
installation-defined exit. The point in source code installation with multiple processors (a JES3 complex),
where an installation adds an exit point where an one processor’s JES3 subsystem exercises centralized
installation routine can receive control from the control over the other processors and distributes jobs to
operating system. Contrast with IBM-defined exit. them through use of a common job queue.
interface. Hardware, software, or both, that links JIX. Job queue index
systems, programs, or devices.
JMR. Job management record
intermediate write. In DUAL mode, the write of the
change log records containing the control blocks that job. A unit of work for an operating system. Jobs are
have been updated since the last checkpoint write. In defined by JCL statements.
DUPLEX mode (or DUAL mode where the change log
overflows the first track) the checkpoint write of the 4K job class. Any one of a number of job categories that
records. can be defined. With the classification of jobs and
direction of initiator/terminators to initiate specific
internal reader. A facility that transfers jobs to JES. classes of jobs, it is possible to control the mixture of
jobs that are performed concurrently.
interrupt. (1) *To stop a process in such a way that it
can be resumed. (2) In data transmission, to take an job control language (JCL). A programming language
action at a receiving station that causes the transmitting used to code job control statements.
station to terminate a transmission.
job control language (JCL) statements. Statements
IOT. input/output table placed into an input stream to define work to be done,
methods to be used, and the resources needed.
IPL. initial program load
job control statement. *A statement in a job that is
IPS. Installation performance specification used in identifying the job or describing its requirements
to the operating system.
J job entry subsystem (JES). An MVS facility that
receives jobs into the system and processes output data
JCL. Job control language
produced by the jobs. See also JES2 and JES3.
JCT. Job control table
job entry subsystem 2. See JES2.
JES2. Job entry subsystem 2. An MVS subsystem that
job entry subsystem 3. See JES3.
receives jobs into the system, converts them to internal
format, selects them for execution, processes their job output element (JOE). Information that describes
output, and purges them from the system. In an a unit of work for the output processor and represents
installation with more than one processor, each that unit of work for queuing purposes.
processor’s JES2 subsystem independently controls job
input, scheduling, and output processing. job priority. A value assigned to a job that is used as
a measure of the job’s relative importance while the job
contends with other jobs for system resources.
job separator pages. Those pages of printed output LRECL. Logical record length
that delimit jobs.
LSQA. Local system queue area
JOE. Job output element
LU. Logical unit
JOT. Job output table
M
K machine check interruption. An interruption that
keyword. A part of a command operand that consists occurs as a result of an equipment malfunction or error.
of a specific character string (such as DSNAME=).
MAS. See multi-access spool configuration.
keyword parameter. A parameter that consists of a
MCS. Multiple console support
keyword, followed by one or more values. Contrast with
positional parameter. See also parameter. member. A JES2 instance of a MVS system
Glossary 343
*Loosely, parallel processing. (3) Simultaneous network operator. (1) The person responsible for
execution of two or more sequences of instructions by a controlling the operation of a telecommunication
multiprocessor. network. (2) A VTAM application program authorized to
issue network operator commands.
multiprocessing system. A computing system
employing two or more interconnected processing units NIP. Nucleus initialization program.
to execute programs simultaneously.
NIT. The node information table, which is an internal
multiprocessor. (1) A computer employing two or JES2 control block containing information about each
more processing units under integrated control. (2) A NJE node.
system consisting of two or more CPs (or ALUs, or
processors) that can communicate without manual NJE. Network job entry
intervention.
NJE/TCP. Network job entry over TCP/IP
MVS. Multiple virtual storage.
NJH. Network job header
operator commands. Statements that system page mode environment checkpointing. That
operators may use to get information, alter operations, process which preserves the information necessary to
initiate new operations, or end operations. resume page-mode printing.
operator message. A message from an operating page mode printer. An AFP printer, such as the 3800
system directing the operator to perform a specific model 3 and 3820, that can print page mode data.
function, such as mounting a tape reel; or informing the
operator of specific conditions within the system, such pageable region. In MVS, a subdivision of the
as an error condition. pageable dynamic area that is allocated to a job step or
a system task that can be paged during execution.
operator orientation point. The generic name given Synonymous with V=V region.
to the point in the 3800 model 3 printing process at
which the data becomes visible to the operator, and is paging. In z/OS or System/390 virtual storage
therefore the point at which all operator commands are systems, the process of transferring pages between
directed. Synonymous with transfer station. central storage and external page storage.
output group. A set of a job’s output data sets that paging device. In z/OS or System/390 virtual storage
share output characteristics, such as class, destination, systems, a direct access storage device on which pages
and external writer. (and possibly other data) are stored.
output stream control. Synonymous with JES2 writer. parameter. (1) *A variable that is given a constant
value for a specific purpose or process. (2) See
output writer. A part of the job scheduler that keyword parameter, positional parameter.
transcribes specified output data sets onto a system
output device independently of the program that password. A unique string of characters that a
produced the data sets. program, computer operator, or user must supply to
meet security requirements for gaining access to data.
overlays. A collection of predefined data such as
lines, shading, text, boxes, or logos, that can be merged patch. *To modify a routine in a rough or expedient
with the variable data on a page while printing. way.
Glossary 345
poly-JES. Concurrent operation of multiple copies of queue. A line or list formed by items in a system
JES2 on a single MVS system to allow an installation to waiting for processing.
separate its primary production system(s) and test
system(s). quick start. A JES2 member restart in an existing
multi-access spool (MAS) configuration. The JES2
positional parameter. A parameter that must appear member previously ended without error.
in a specified location, relative to other parameters.
Contrast with keyword parameter. See also parameter. quiescing. *The process of bringing a device or a
system to a halt by rejection of new requests for work.
PPL. Purge parameter list
primary write. The write of the 4K records to the read 2. A read of the 4K page data records and any
down-level checkpoint data set to make it current. change log records not contained on the first track from
a checkpoint data set. Usually performed after a READ
Print Services Facility (PSF). An IBM licensed 1 as the second checkpoint I/O operation in a
program that produces printer commands from the data checkpoint cycle.
set to it. PSF programs run on the z/OS, OS/390, MVS,
VM, VSE, OS/2, AIX, and OS/400 operating platforms. reader. A program that reads jobs from an input device
For JES, PSF programs operates the 3800 model 3 and or data base file and places them on the job queue.
3820 printers. PSF operates as a functional subsystem.
real address. In virtual storage systems, the address
priority aging. A function of JES2 by which the longer of a location in central storage.
a job waits to be selected for processing, the greater
real storage. See central storage.
become its chances of being selected to run.
remote. RMT
private connection. A connection known only to the
two nodes making the connection. remote job entry (RJE). Submission of job control
statements and data from a remote terminal, causing
process mode. The mode in which SYSOUT data
the jobs described to be scheduled and executed as
exists and is to be processed by a JES output device.
though encountered in the input stream.
There are two IBM-defined process modes: line mode
and page mode. remote station. *Data terminal equipment for
communicating with a data processing system from a
processor storage. See central storage.
location that is time, space, or electrically distant.
program temporary fix (PTF). A temporary solution or
remote terminal. An input/output control unit and one
bypass for a problem diagnosed by IBM as the result of
or more input/output devices attached to a system
a defect in a current unaltered release of the program.
through a data link.
protocols. Rules for using communication lines.
remote terminal access method (RTAM). A facility
Protocols can identify the direction of data flow, where
that controls operations between the job entry
data begins and ends, how much data is being
subsystem (JES2) and remote terminals.
transmitted, and whether data or control information is
being sent. remote workstation. (1) *Data terminal equipment for
communicating with a data processing system from a
PSF. Print Services Facility
location that is time, space, or electrically distant.
PTF. Program temporary fix Synonymous with remote station. (2) A workstation that
is connected to a system by means of data transmission
PU. Physical unit. facilities.
session. (1) The period of time during which a user of spooling. The reading and writing of input and output
a terminal can communicate with an interactive system; streams on auxiliary storage devices, concurrently with
usually, the elapsed time from when a terminal is logged job execution, in a format convenient for later
on to the system until it is logged off the system. (2) processing or output operations.
The period of time during which programs or devices
SQA. System queue area
can communicate with each other. (3) In VTAM, the
period of time during which a node is connected to an SRM. System resources manager
application program.
Glossary 347
static connection. A connection (also called syntax. (1) *The structure of expressions in a
“predefined connection” in earlier releases) between two language. (2) The rules governing the structure of a
nodes created by either a JES2 initialization or an language.
operator command.
SYSIN. A system input stream; also, the name used as
STC. Started task control the data definition name of a data set in the input
stream.
step restart. A restart that begins at the beginning of a
job step. The restart may be automatic or deferred, SYSLOG. System log
where deferral involves resubmitting the job. Contrast
with checkpoint restart. SYSOUT. A system output stream; also, an indicator
used in data definition statements to signify that a data
subnet. Subset of a NJE network identified by an set is to be written on a system output unit.
eight-character ‘SUBNET’ name on the JES2 NODE
initialization statement. The grouping of nodes into sysplex. A set of MVS systems communicating and
“SubNets” is based on the assumption that if you have cooperating with each other through certain multisystem
access to any node in the subnet, you have access to hardware components and software services to process
them all. customer workloads.
text transparency. A provision that allows BSC to TSO. Time-sharing option. See Time Sharing Option
send and receive messages containing any or all of the Extensions (TSO/E).
256 character combinations in EBCDIC, including
transmission control characters. Transmission control TSO/E. Time Sharing Option Extensions
characters sent in a message are treated as data
TSU. Time-sharing user
unless they are preceded by the data link escape (DLE)
control character. TTE. Trace table entry
TGB. Track group block type font. In printing, a set of type that is of a
particular size and style (for example, 10-point century
TGBE. Track group block entry
school book).
tightly-coupled multiprocessing. Two computing
systems operating simultaneously under one control U
program while sharing resources.
UCB. Unit control block
Time Sharing Option Extensions (TSO/E). A
licensed program that is based on the Time Sharing UCS. Universal character set.
Option (TSO). It allows MVS users to interactively share
computer time and resources. unallocate. See deallocate.
time tolerance. The difference between the TOD unit. (1) *A device having a special function. (2) A
clocks on two adjacent nodes, beyond which the path basic element.
manager will not allow a session to be established.
unit address. The address of a particular device,
time-of-day clock. See TOD clock. specified at the time a system is installed; for example,
191 or 293.
TOD. Time-of-day
universal character set (UCS). A printer feature that
TOD clock. A timing device that counts units of time permits the use of a variety of character arrays.
based on the starting point of 00 hours, 00 minutes, and
00 seconds on January 1, 1900. Time-of-day (TOD) user identification (USERID). A 1-8 character symbol
information is used, for example, to monitor computer identifying a system user.
operations and events.
user table. An installation-defined table that is used to
token. Specifically defined for JES2 checkpoint extend, modify, or delete the JES2 default processing
processing as a checkpoint identifier that is used to specifications. See also table pair.
determine checkpoint I/O status.
USERID. User identification.
trace. (1) The record of a series of events. (2) To
record a series of a events as they occur. (3) A report
showing data relevant to a particular point in the
V
processing of a program. Traces are typically produced
V=R dynamic area. Synonymous with nonpageable
for analysis of program performance, but they can also
dynamic area.
be valuable diagnostic aids.
V=R region. Synonymous with nonpageable region.
Glossary 349
V=V region. Synonymous with pageable region.
W
warm start. A general term for a JES2 member
restart. See also hot start; quick start; single-member
warm start; all-member warm start.
WTO. Write-to-operator
X
XFER. Transfer
Numerics
3800 compatibility mode. Operating the 3800 model
3 printer as a 3800 Model 1 printer.
Overall, how satisfied are you with the information in this book?
How satisfied are you that the information in this book is:
When you send comments to IBM, you grant IBM a nonexclusive right to use or distribute your comments in any
way it believes appropriate without incurring any obligation to you. IBM or any other organizations will only use the
personal information that you supply to contact you about the issues that you state on this form.
Name Address
Company or Organization
Phone No.
___________________________________________________________________________________________________
Readers’ Comments — We’d Like to Hear from You Cut or Fold
SA22-7537-06 Along Line
_ _ _ _ _ _ _Fold
_ _ _and
_ _ _Tape
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _Please
_ _ _ _ _do
_ _not
_ _ staple
_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _Fold
_ _ _and
_ _ Tape
______
NO POSTAGE
NECESSARY
IF MAILED IN THE
UNITED STATES
IBM Corporation
Department 55JA, Mail Station P384
2455 South Road
Poughkeepsie, NY
12601-5400
_________________________________________________________________________________________
Fold and Tape Please do not staple Fold and Tape
Cut or Fold
SA22-7537-06 Along Line
Printed in USA
SA22-7537-06