HZAP - Inquisitor for z/OS® messages and codes

These messages are issued by the Inquisitor.

Return codes

Table 1. Return codes and their meaning
Return code	Description
0	No errors encountered. All requests processed successfully.
4	Input/Output error in one or more program libraries.
8	Error - Data collection is incomplete. Processing continues. The error is in a system service such as OPEN or DYNALLOC. Data that is collected can be processed normally.
12	Syntax error.
16	Unrecoverable error. No requests processed. Unusable file or unsupported Operating System.
20	Disastrous error. No requests processed. SYSPRINT file cannot be used.

Message suffix codes

Table 2. Message suffix codes and associated condition codes
Suffix	Meaning	Raises minimum condition code to:
I	Information message	0
W	Warning message	4
E	Error message	8
S	Severe error message	12
U	Unrecoverable error message	16

Message texts and explanations: All numeric completion codes of system services reported in these messages are in hexadecimal unless otherwise stated.

HZAP000U

NO USABLE SYSPRINT FILE

Explanation: The OPEN of the SYSPRINT file failed. Note: This message is issued by WTO with ROUTCDE=(2,11). All other messages are written to the SYSPRINT file.

System action Terminates with a condition code of 20.

Operator response: Ensure a usable SYSPRINT file is allocated. The program overrides any unacceptable DCB values.

System programmer response: None.

Module: HZAPINQ

HZAP001U

CANNOT OPEN SYSIN FILE

Explanation: The OPEN of the SYSIN file failed.

System action Terminates with a condition code of 16.

Operator response: Ensure a usable SYSIN file is allocated.

System programmer response: None.

Module: HZAPINQ

HZAP004S

UNKNOWN VERB "verb"

Explanation: Parsing detected unrecognized data when looking for a verb.

In the message text:

verb: name of the encountered verb.

System action Terminates with a condition code of 12.

Operator response: Correct the SYSIN file contents and rerun the program.

System programmer response: None.

Module: HZAPINQ

HZAP005S

UNKNOWN OPERAND "op"

Explanation: Parsing detected unrecognized data when looking for an operand.

In the message text:

op: name of the encountered operand.

System action Terminates with a condition code of 12.

Operator response: Correct the SYSIN file contents and rerun the program.

System programmer response: None.

Module: HZAPINQ

HZAP006S

UNEXPECTED OPEN PARENTHESIS ENCOUNTERED

Explanation: Parsing detected an open parenthesis at an unexpected location.

System action Terminates with a condition code of 12.

Operator response: Correct the SYSIN file contents and rerun the program.

System programmer response: None.

Module: HZAPINQ

HZAP007S

UNEXPECTED CLOSE PARENTHESIS ENCOUNTERED

Explanation: Parsing detected a close parenthesis at an unexpected location.

System action Terminates with a condition code of 12.

Operator response: Correct the SYSIN file contents and rerun the program.

System programmer response: None.

Module: HZAPINQ

HZAP008S

EXPECTED OPEN PARENTHESIS MISSING

Explanation: Parsing did not detect the expected open parenthesis.

System action Terminates with a condition code of 12.

Operator response: Correct the SYSIN file contents and rerun the program.

System programmer response: None.

Module: HZAPINQ

HZAP009S

EXPECTED CLOSE PARENTHESIS MISSING

Explanation: Parsing did not detect the expected close parenthesis.

System action Terminates with a condition code of 12.

Operator response: Correct the SYSIN file contents and rerun the program.

System programmer response: None.

Module: HZAPINQ

HZAP010U

OPERATING SYSTEM NOT SUPPORTED - CODE "code"

Explanation: The value of the byte at CVTDCB was not X'9B'.

In the message text:

code: hexadecimal value of first byte of CVTDCB.

System action Terminates with a condition code of 16.

Operator response: This version of the Inquisitor cannot be run on this Operating System. If necessary, gather appropriate diagnostic materials and contact HCL support.

System programmer response: None.

Module: HZAPINQ

HZAP011I

MISSING CLOSE PARENTHESIS ASSUMED

Explanation: End-of-file was detected for SYSIN before an expected close parenthesis was detected.

System action The request is accepted and processing continues.

Operator response: Correct the SYSIN file contents to avoid this message.

System programmer response: None.

Module: HZAPINQ

HZAP012S

MISSING OPERAND SUBPARAMETER FOR spm

Explanation: A required subparameter of an operand was not specified.

In the message text:

spm: name of the operand being processed.

System action Terminates with a condition code of 12.

Operator response: Correct the SYSIN file contents and rerun the program.

System programmer response: None.

Module: HZAPINQ

HZAP013S

E-O-F INSTEAD OF EXPECTED CONTINUATION

Explanation: End-of-file was detected for SYSIN instead of an expected record required to continue the current statement being parsed.

System action Terminates with a condition code of 12.

Operator response: Correct the SYSIN file contents and rerun the program.

System programmer response: None.

Module: HZAPINQ

HZAP014I

COMPLETED REQUEST NUMBER rno - PROCESSING STATISTICS ARE:

Explanation: Processing of a request has been completed. One or more messages follow containing the statistics for the request.

In the message text:

rno: sequence number of the request.

System action Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAPINQ

HZAP015I

VOLUMES=vol DATASETS=ds BAD-D/S=dsbad PROGRAMS=pgms

Explanation: Processing of a request has been completed. Statistics related to the request are shown.

In the message text:

vol: count of volumes scanned for this request.
ds: count of data sets successfully processed.
dsbad: count of data sets which could not be processed.
pgms: count of programs processed for this request.

System action Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAPINQ

HZAP016I

ACCEPTED REQUEST NUMBER rno

Explanation: Parsing of a request has been completed successfully. The request is stored for subsequent processing.

In the message text:

rno: sequence number of the request.

System action Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAPINQ

HZAP017E

DYNALLOC FAILURE: RC=rc ERROR=err INFO=inf VOLUME=vol

Explanation: A data set could not be dynamically allocated. See message HZAP080I for the name of the dataset that incurred the problem.

In the message text:

rc: return code of the DYNALLOC macro.
err: dynamic allocation return code (DARC).
inf: dynamic allocation information code.
vol: volume serial number of the data set.

System action Processing of this data set is terminated.

Operator response: If necessary, rerun when the file is available for use. Note: The meanings of many DARC values are usually available in Appendix A of the ISPF Tutorial.

System programmer response: None.

Module: HZAPINQ

HZAP018W

VTOC DYNALLOC FAILURE: RC=rc ERROR=err INFO=inf VOLUME=vol

Explanation: A VTOC could not be dynamically allocated.

In the message text:

rc: return code of the DYNALLOC
err: dynamic allocation return code (DARC).
inf: dynamic allocation information code.
vol: volume serial number of the data set.

System action Processing of this volume is terminated.

Operator response: If necessary, rerun when the VTOC is available for use to process this volume. Note: The meanings of many DARC values are usually available in Appendix A of the ISPF Tutorial.

System programmer response: None.

Module: HZAPINQ

HZAP020I

ocnt INQUISITOR OUTPUT RECORDS WRITTEN

Explanation: Processing has concluded and all data files have been closed.

In the message text:

ocnt: number of records written.

System action Termination continues.

Operator response: None required.

System programmer response: None.

Module: HZAPINQ

HZAP021S

INVALID OPERAND SUBPARAMETER FOR spm

Explanation: The specified subparameter of an operand was not valid.

In the message text:

spm: name of the operand being processed.

System action Terminates with a condition code of 12.

Operator response: Correct the SYSIN file contents and rerun the program.

System programmer response: None.

Module: HZAPINQ

HZAP022W

I/O ERR MEMBER mbr IN dsn

Explanation: An I/O error was encountered while reading the contents of a load module.

In the message text:

mbr: name of the program being processed.
dsn: name of the data set being processed.

System action Processing of this member continues.

Operator response: None required.

System programmer response: None.

Module: HZAPINQ

HZAP023W

ABEND abend IN OPEN FOR dsn

Explanation: An abnormal end occurred while opening a data set.

In the message text:

abend: hexadecimal system abend and reason
dsn: name of the data set being processed.

System action Processing of this data set is terminated.

Operator response: None required, but you may wish to exclude the data set from processing, or correct the cause of the abend.

System programmer response: None.

Module: HZAPINQ

HZAP024S

BAD UCBSCAN RETURN CODE OF HEX rc

Explanation: An unexpected return code was received from UCBSCAN.

In the message text:

rc: hexadecimal return code from UCBSCAN

System action Processing of volume scanning for this request is terminated.

Operator response: Rerun the program when no dynamic reconfiguration changes are being implemented.

System programmer response: None.

Module: HZAPINQ

INQP025U

CANNOT OPEN INQPOUT FILE

Explanation: The OPEN of the INQPOUT file failed.

System action Terminates with a condition code of 16.

Operator response: Ensure that the allocated INQPOUT file is usable, or omit the INQPOUT file in favour of using the INQPZIP file.

System programmer response: None.

Module: HZAPINQ

HZAP026E

I/O ERROR ENCOUNTERED READING VTOC OF VOLUME vol ON DEVICE dev

Explanation: An I/O error was encountered while reading a VTOC.

In the message text:

vol: volume serial number being processed.
dev: device number of the volume.

System action Processing of this track of the VTOC is terminated.

Operator response: None required, but you may wish to exclude the volume from processing, or correct the cause of the I/O error.

System programmer response: None.

Module: HZAPINQ

INQP028U

CANNOT OPEN INQPDMP FILE

Explanation: The OPEN of the INQPDMP file failed after DUMPTEXT was specified.

System action Terminates with a condition code of 16.

Operator response: Ensure a usable INQPDMP file is allocated, or remove all DUMPTEXT operand's from the contents of the SYSIN file. The DUMPTEXT operand should only be specified at the request of HCL support.

System programmer response: None.

Module: HZAPINQ

HZAP029I

TEXT-DUMPS=cnt

Explanation: Processing of a request with DUMPTEXT specified has completed. This message follows HZAP015I.

In the message text:

cnt: count of load module text blocks written.

System action Processing continues.

Operator response: None required. The DUMPTEXT operand should only be specified at the request of HCL support.

System programmer response: None.

Module: HZAPINQ

HZAP030I

"DUMPTEXT" OPERAND IGNORED FOR "SCANDIR" VERB

Explanation: A DUMPTEXT operand was encountered for a SCANDIR request. That is, the possible dumping of load module text blocks was specified in a request which does not have access to text blocks.

System action The DUMPTEXT operand is ignored and processing continues.

Operator response: Remove the DUMPTEXT operand to avoid this message. The DUMPTEXT operand should only be specified at the request of HCL support.

System programmer response: None.

Module: HZAPINQ

HZAP031I

BAD SELECTION CRITERIA FOR dsn

Explanation: Processing of a data set was specified but attributes did not match other selection criteria also specified in the request. This message is followed by HZAP015I which details the cause.

In the message text:

dsn: name of the data set being processed.

System action Processing of this data set is terminated.

Operator response: If this data set is a program library which should be processed by the Inquisitor then modify or remove the conflicting selection criteria.

System programmer response: None.

Module: HZAPINQ

HZAP032I

OBTAIN FAILED RC=rc VOLUME vol

Explanation: The system could not read the VTOC entry for the data set named in the HZAP033I message which follows this message. This message is only issued when DSNMSG or ALLMSG is specified in the program parameter.

In the message text:

rc: hexadecimal return code of the OBTAIN macro.
vol: volume serial number being processed.

System action Processing of this data set is terminated.

Operator response: Ensure the relevant catalog entry is correct. Ensure the relevant volume is online and available to the system. Ensure there is no I/O error in the relevant volume's VTOC. If necessary, gather appropriate diagnostic materials and contact HCL support.

System programmer response: None.

Module: HZAPINQ

HZAP033I

OBTAIN FAILED FOR DATA SET dsn

Explanation: The system could not read the VTOC entry for the data set on the volume named in the previous HZAP032I message. This message is only issued when DSNMSG or ALLMSG is specified in the program parameter.

In the message text:

dsn: name of the data set being processed.

System action Processing of this data set is terminated.

Operator response: Ensure the relevant catalog entry is correct. Ensure the relevant volume is online and available to the system. Ensure there is no I/O error in the relevant volumes VTOC. If necessary, gather appropriate diagnostic materials and contact HCL support.

System programmer response: None.

Module: HZAPINQ

HZAP034I

REFER DATE WAS date FOR dsn

Explanation: A load library was opened. The reference date of the data set before the OPEN is reported in this message. This message is only issued when DSNMSG or ALLMSG is specified in the program parameter.

In the message text:

date: the Julian reference date from the VTOC entry.
dsn: name of the data set being processed.

System action Processing of this data set continues.

Operator response: None required.

System programmer response: None.

Module: HZAPINQ

HZAP036E

OPEN ERROR ENCOUNTERED READING VTOC OF VOLUME vol ON DEVICE dev

Explanation: The VTOC of the volume shown could not be opened.

In the message text:

vol: volume serial number being processed.
dev: device number of the volume.

System action Processing of this track of the VTOC is terminated.

Operator response: None required, but you may wish to exclude the volume from processing, or correct the cause of the I/O error.

System programmer response: None.

Module: HZAPINQ

HZAP037E

SECURITY ACCESS DENIED FOR dsn

Explanation: A RACROUTE macro determined the program had insufficient security access to read the data set.

In the message text:

dsn: name of the data set being processed.

System action Processing of this data set is terminated.

Operator response: Contact Security Administration to obtain sufficient security access to read the data set or exclude the data set from processing.

System programmer response: None.

Module: HZAPINQ

HZAP038I

BAD SELECTION CRITERIA WAS dsn

Explanation: Processing of a data set was specified but attributes did not match other selection criteria also specified in the request. This message follows HZAP031I which shows the data set name.

In the message text:

dsn: cause of the data set processing failure.

System action Processing of this data set is terminated.

Operator response: If this data set is a program library which should be processed by the Inquisitor then modify or remove the conflicting selection criteria.

System programmer response: None.

Module: HZAPINQ

HZAP039S

ALL POSSIBLE DATA SETS ARE EXCLUDED

Explanation: An exclusion mask has been specified which excludes all possible data sets included by a selection mask. Both masks are shown after this message.

System action Terminates with a condition code of 12.

Operator response: Modify or remove the conflicting selection criteria.

System programmer response: None.

Module: HZAPINQ

HZAP040S

ALL POSSIBLE DASD VOLUMES ARE EXCLUDED

Explanation: An exclusion mask has been specified which excludes all possible DASD volumes included by a selection mask. Both masks are shown after this message.

System action Terminates with a condition code of 12.

Operator response: Modify or remove the conflicting selection criteria.

System programmer response: None.

Module: HZAPINQ

HZAP041S

ALL POSSIBLE PROGRAMS ARE EXCLUDED

Explanation: An exclusion mask has been specified which excludes all possible programs included by a selection mask. Both masks are shown after this message.

System action Terminates with a condition code of 12.

Operator response: Modify or remove the conflicting selection criteria.

System programmer response: None.

Module: HZAPINQ

HZAP042S

ALL POSSIBLE MODULES ARE EXCLUDED

Explanation: An exclusion mask has been specified which excludes all possible modules included by a selection mask.

System action Terminates with a condition code of 12.

Operator response: Modify or remove the conflicting selection criteria. If no CSECT-level records are required then omit both MODULE and XMODULE operands.

System programmer response: None.

Module: HZAPINQ

HZAP043I

"MODULE"/"CSECT" OPERAND IGNORED FOR "SCANDIR" VERB

Explanation: A MODULE operand was encountered for a SCANDIR request. That is, the output of program structure data was requested in a request which does not have access to this data.

System action The MODULE operand is ignored and processing continues.

Operator response: Remove the MODULE operand to avoid this message.

System programmer response: None.

Module: HZAPINQ

HZAP044I

"XMODULE"/"XCSECT" OPERAND IGNORED FOR "SCANDIR" VERB

Explanation: An XMODULE operand was encountered for a SCANDIR request. That is, the output of program structure data was implied in a request which does not have access to this data.

System action The XMODULE operand is ignored and processing continues.

Operator response: Remove the XMODULE operand to avoid this message.

System programmer response: None.

Module: HZAPINQ

HZAP045I

THE "XDSNAME" MASK IS NOT A SUBSET OF ANY "DSNAME" MASK

Explanation: The mask specified in the XDSNAME operand excludes possible values not included in the DSNAME operand. This message is issued to highlight possible inconsistencies in a request.

System action Processing continues.

Operator response: Specify the XDSNAME operand as a further qualification of the DSNAME operand to avoid this message.

System programmer response: None.

Module: HZAPINQ

HZAP046I

THE "XVOLUME" MASK IS NOT A SUBSET OF ANY "VOLUME" MASK

Explanation: The mask specified in the XVOLUME operand excludes possible values not included in the VOLUME operand. This message is issued to highlight possible inconsistencies in a request.

System action Processing continues.

Operator response: Specify the XVOLUME operand as a further qualification of the VOLUME operand to avoid this message.

System programmer response: None.

Module: HZAPINQ

HZAP047I

THE "XPROGRAM" MASK IS NOT A SUBSET OF ANY "PROGRAM" MASK

Explanation: The mask specified in the XPROGRAM operand excludes possible values not included in the PROGRAM operand. This message is issued to highlight possible inconsistencies in a request.

System action Processing continues.

Operator response: Specify the XPROGRAM operand as a further qualification of the PROGRAM operand to avoid this message.

System programmer response: None.

Module: HZAPINQ

HZAP048I

THE "XMODULE" MASK IS NOT A SUBSET OF ANY "MODULE" MASK

Explanation: The mask specified in the XMODULE operand excludes possible values not included in the MODULE operand. This message is issued to highlight possible inconsistencies in a request.

System action Processing continues.

Operator response: Specify the XMODULE operand as a further qualification of the MODULE operand to avoid this message.

System programmer response: None.

Module: HZAPINQ

HZAP049I

THE "XSTOGROUP" MASK IS NOT A SUBSET OF ANY "STOGROUP" MASK

Explanation: The mask specified in the XSTOGROUP operand excludes possible values not included in the STOGROUP operand. This message is issued to highlight possible inconsistencies in a request.

System action Processing continues.

Operator response: Specify the XSTOGROUP operand as a further qualification of the STOGROUP operand to avoid this message.

System programmer response: None.

Module: HZAPINQ

HZAP050I

MODULES=cnt

Explanation: Processing of a request with MODULE specified has completed. This message follows HZAP015I.

In the message text:

cnt: count of CSECTs processed in this request.

System action Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAPINQ

HZAP051I

******** PARSE ONLY REQUEST PROCESSED - NO ACTION TAKEN ********

Explanation: Processing of a SCANCMD request has completed.

System action Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAPINQ

INQP052U

MISSING INQPOUT AND INQPZIP FILES

Explanation: Neither an INQPOUT nor an INQPZIP file is allocated. At least one output file is required.

System action Terminates with a condition code of 16.

Operator response: Specify an output file and rerun the job.

System programmer response: None.

Module: HZAPINQ

INQP053U

COMPRESSION SUBROUTINE ERROR

Explanation: While processing the INQPZIP file the compression subroutine encountered an error. The error message from the compression subroutine immediately follows this message.

System action Terminates with a condition code of 16.

Operator response: Correct the error described in the message from the compression subroutine. If necessary, gather appropriate diagnostic materials and contact HCL support.

System programmer response: None.

Module: HZAPINQ

HZAP054I

"FULLIDR" OPERAND IGNORED FOR "SCANDIR" VERB

Explanation: A FULLIDR operand was encountered for a SCANDIR request. That is, the processing of load module member contents was specified in a request which does not have access to this data.

System action The FULLIDR operand is ignored and processing continues.

Operator response: Remove the FULLIDR operand to avoid this message.

System programmer response: None.

Module: HZAPINQ

HZAP056I

date time COMMENCING SCAN OF VOLUME vol ON UNIT unit

Explanation: A request without the CATALOG keyword began processing a DASD volume. This message provides feedback on the progress of long-running Inquisitor requests.

In the message text:

date: date of message.
time: time of message.
vol: serial number of volume.
unit: device number of volume.

System action Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAPINQ

HZAP057E

ABEND abend PROCESSING VTOC OF VOLUME vol ON UNIT unit

Explanation: A request without the CATALOG keyword attempted to process a DASD volume VTOC and the OPEN or CLOSE abended. The volume may not be usable.

In the message text:

abend: hexadecimal system abend and reason codes.
vol: serial number of volume.
unit: device number of volume being processed.

System action Processing of this volume is terminated.

Operator response: Vary the volume offline, and/or reformat the volume. Institute any appropriate volume recovery procedures.

System programmer response: None.

Module: HZAPINQ

HZAP058S

DUPLICATE OPERAND ENCOUNTERED: op

Explanation: An input request was found to have the indicated operand specified more than once.

In the message text:

op: name of the duplicate operand

System action Terminates with a condition code of 12.

Operator response: Correct the SYSIN file contents and rerun the program.

System programmer response: None.

Module: HZAPINQ

HZAP059W

BINDER FAILURE FOR MEMBER mbr RC=rc RS=rs

Explanation: The Binder could not successfully process a member of a PDSE.

In the message text:

mbr: name of the member being processed.
rc: hexadecimal Binder FDA API return code.
rs: hexadecimal Binder FDA API reason code.

System action Terminates data collection for this member, writes out data already collected and continues processing the next member.

Operator response: None required.

System programmer response: The Binder Fast Data Access API return and reason codes provide more detailed indication of the cause.

Module: HZAPINQ

HZAP060S

SYMBOL SUBSTITUTION FAILURE - ASASYMBP RC=rc

Explanation: The system symbol substitution routine could not successfully perform symbol substitution. Data before and after substitution is shown in the SYSPRINT file.

In the message text:

rc: hexadecimal return code.

System action Terminates with a condition code of 12.

Operator response: Correct or remove the symbols in control statement input.

System programmer response: None.

Module: HZAPINQ

HZAP061I

pgm NON-REEDITABLE IN dsn

Explanation: A program object in a PDSE was encountered which cannot be processed by the Program Binder. The program was bound with the NE or OVLY attribute. This message is only issued when PGMMSG or ALLMSG is specified in the program parameter.

In the message text:

pgm: name of program which cannot be processed.
dsn: name of the data set being processed.

System action Further data collection for this member is terminated.

Operator response: None required.

System programmer response: None.

Module: HZAPINQ

HZAP062S

THE CATALOG REQUEST NEEDS EXACTLY ONE DSNAME MASK

Explanation: A request with the CATALOG operand either omitted the DSNAME operand or specified more than one DSNAME mask.

System action Terminates with a condition code of 12.

Operator response: Correct the SYSIN file contents and rerun the program. To process multiple data set name masks via the CATALOG specify a separate Inquisitor request for each mask. There is no programmed limit to the number of requests which can be processed in a single Inquisitor run.

System programmer response: None.

Module: HZAPINQ

HZAP063S

ALL POSSIBLE STORAGE GROUPS ARE EXCLUDED

Explanation: An exclusion mask has been specified which excludes all possible storage groups included by the selection mask. Both masks are shown after this message.

System action Terminates with a condition code of 12.

Operator response: Modify or remove the conflicting selection criteria.

System programmer response: None.

Module: HZAPINQ

HZAP064W

ABEND abend FOR mbr IN dsn

Explanation: A subtask processing a program object from a PDSE has abended. The abend probably occurred in the Program Binder API.

In the message text:

abend: hexadecimal system abend code.
mbr: name of the member being processed.
dsn: name of the data set being processed.

System action Data collected for this member so far is retained. Other Data Management abends may follow, especially in CLOSE processing, which are unrecoverable and may abend the main Inquisitor task.

Operator response: Exclude the programs causing the failure and rerun the Job.

System programmer response: None.

Module: HZAPINQ

HZAP065S

MCDS FILE FAILED VERIFICATION

Explanation: The MCDS data definition (DD) was found to be unusable by the Inquisitor. One or more of the following is true: 1) The MCDS file could not be opened. Message HZAP066E follows. 2) The MCDS file is not a VSAM key-sequenced data set (KSDS). 3) The KSDS relative key position (RKP) is not zero (0). 4) The KSDS key length is not forty-four (44).

System action Terminates with a condition code of 12.

Operator response: Either ensure that the Inquisitor has read access to DFHSM's MCDS, or change the Inquisitor request(s) so that the MCDS is not required. MCDS access is required if either or both of the REMIGRATE and NOML2 keywords are specified.

System programmer response: None.

Module: HZAPINQ

HZAP066E

MCDS OPEN ERROR - RC=rc RS=rs

Explanation: The OPEN of the MCDS data definition (DD) was not successful.

In the message text:

rc: VSAM OPEN hexadecimal return code.
rs: VSAM OPEN hexadecimal reason code.

System action Issues message HZAP065S and terminates with a condition code of 12.

Operator response: Either ensure that the Inquisitor has read access to DFHSM's MCDS, or modify the Inquisitor request(s) so that the MCDS is not required. MCDS access is required if either or both of the REMIGRATE and NOML2 keywords are specified.

System programmer response: None.

Module: HZAPINQ

HZAP067E

MCDS READ RC=rc RS=rs FOR dsn

Explanation: The MCDS record of a data set cataloged on volume MIGRAT could not be read. Either the record is missing or there was an I/O error.

In the message text:

rc: VSAM GET hexadecimal return code.
rs: VSAM GET hexadecimal reason code.
dsn: name of data set cataloged on volume MIGRAT.

System action Processing of this data set is terminated.

Operator response: If the data set is not really migrated then correct the catalog entry. If the MCDS is corrupt then begin recovery procedures.

System programmer response: None.

Module: HZAPINQ

HZAP068W

CATALOG RC=rc RS=rs,modid cat

Explanation: The Catalog Search Interface returned an entry which is flagged as being in error by Catalog Management.

In the message text:

rc: Catalog Management decimal return code.
rs: Catalog Management decimal reason code.
modid: Catalog Management module identifier.
cat: name of catalog entry in error.

System action Processing of this data set is terminated.

Operator response: Correct the catalog entry. Refer to the System Messages manual for message IDC3009I to find out the meaning of the Catalog Management error codes.

System programmer response: None.

Module: HZAPINQ

HZAP069U

PROGRAM IS NOT APF AUTHORIZED

Explanation: The Inquisitor has determined that it is not running in an APF authorized environment, and PARM=NOAPF was not specified.

System action Terminates with a condition code of 20.

Operator response: Ensure that the HZAPINQ program is run in an APF authorized environment, or specify PARM=NOAPF in the JCL.

System programmer response: None.

Module: HZAPINQ

HZAP070E

BAD BLKSIZE AFTER OPEN FOR dsn

Explanation: A BPAM DCB was opened for the named PDS, but despite the VTOC entry indicating a suitable blocksize, the blocksize in the DCB after the OPEN was not positive.

In the message text:

dsn: name of the data set being processed.

System action Processing of member contents for this data set is terminated to avoid an S002-30 abend.

Operator response: The PDS is probably corrupt and should be deleted. Recreate it from a backup if appropriate.

System programmer response: None.

Module: HZAPINQ

HZAP071W

IGNORING INVALID DSNAME IN dsn

Explanation: The Catalog Search Interface (CSI) returned a data set name with invalid characters. Although VTOC entries can contain keys that are not valid data set names, such entries cannot be cataloged. Therefore the entry returned from the CSI does not represent an actual data set.

In the message text:

dsn: name of the catalog being processed.

System action The returned catalog entry is discarded.

Operator response: Ensure that the named catalog is not corrupt and contains no invalid entries.

System programmer response: None.

Module: HZAPINQ

HZAP072I

BYPASS PROCESSING DATA SET dsn DUE TO patn NAME PATTERN MATCH

Explanation: The name of the data set indicated that it does not contain programs which would normally be executed, and therefore the Inquisitor skipped processing it. The matching name pattern will be one of DLIB (distribution library), RELFILE (SMP/E relative file), SMPLTS (SMP/E Load Temporary Store library) or IMS LIBRARY. This message is only issued when DSNMSG or ALLMSG is specified in the program parameter.

In the message text:

dsn: name of the data set being bypassed.
patn: matching data set type name pattern.

System action The data set is not opened, and no data from it is collected.

Operator response: None required, but if the data set must be processed then specify its name in an inclusion mask without any generic masking characters, either by adding this mask to the existing request, or by adding an additional request to the same Inquisitor run.

System programmer response: None.

Module: HZAPINQ

HZAP073I

NO DATA WAS EXTRACTED FROM dsn

Explanation: The data set contained no members eligible for selection. This message is only issued when DSNMSG or ALLMSG is specified in the program parameter.

In the message text:

dsn: name of the processed data set.

System action The data set was opened, but no data from it is collected.

Operator response: None required.

System programmer response: None.

Module: HZAPINQ

HZAP074S

ABRIN OR ABRPRINT FILES NOT ALLOCATED

Explanation: A request had ABRMIG and/or ABRARC specified but at least one of the required ABRIN and ABRPRINT files was not defined in the JCL.

System action Terminates with a condition code of 12.

Operator response: Ensure the required files are pre-allocated for the Inquisitor.

System programmer response: None.

Module: HZAPINQ

HZAP075W

FDRABR ABEND abend CHECKING dsn

Explanation: An abend occurred during ABR processing while checking a data set which may have been archived.

In the message text:

abend: hexadecimal system abend code.
dsn: name of the data set being processed.

System action Processing of this data set is terminated.

Operator response: Ensure the catalog entry for the data set is correct.

System programmer response: None.

Module: HZAPINQ

HZAP076E

BAD LOAD abend-rs: mbr dsn

Explanation: The Inquisitor attempted to load a product tag data module from the named data set, but LOAD issued the displayed abend code.

In the message text:

abend: abend code returned by LOAD.
rs: abend reason code returned by LOAD.
mbr: name of the member containing the tag data.
dsn: name of the data set containing the tag data module.

System action Processing continues with the next member in the data set.

Operator response: Verify that the named data set contains no unusable modules. If necessary, delete any modules that are of no further use.

System programmer response: None.

Module: HZAPINQ

HZAP077W

ISITMGD RC=rc RS=rs FOR dsn

Explanation: The Inquisitor executed an ISITMGD macro for the named data set, but ISITMGD issued a non-zero return code.

In the message text:

rc: decimal return code issued by ISITMGD.
rs: hexadecimal reason code issued by ISITMGD.
dsn: name of the data set being processed.

System action Processing continues with the next data set.

Operator response: Consult the applicable DFSMS Macro Instructions for Data Sets manual to determine the meaning of the ISITMGD return and reason codes. Ensure that the named data set is a valid and accessible partitioned data set. If necessary, gather appropriate diagnostic materials and contact HCL support.

System programmer response: None.

Module: HZAPINQ

HZAP078W

DESERV RC=rc RS=rs FOR dsn

Explanation: The Inquisitor executed a DESERV FUNC=GET_ALL macro for the named data set, but DESERV issued a non-zero return code.

In the message text:

rc: decimal return code issued by DESERV.
rs: decimal reason code issued by DESERV.
dsn: name of the data set being processed.

System action Processing continues with the next data set.

Operator response: Consult the applicable DFSMS Macro Instructions for Data Sets manual to determine the meaning of the DESERV return and reason codes. Ensure that the named data set is a valid and accessible partitioned data set. If necessary, gather appropriate diagnostic materials and contact HCL support.

System programmer response: None.

Module: HZAPINQ

HZAP080I

DYNALLOC FAILURE: DSN=dsn

Explanation: A data set could not be dynamically allocated.

In the message text:

dsn: name of the data set being processed.

System action Depends upon other messages associated with this message.

Operator response: None required.

System programmer response: None.

Module: HZAPINQ

HZAP081S

ALL POSSIBLE DEVICE NUMBERS ARE EXCLUDED

Explanation: An exclusion mask has been specified which excludes all possible device numbers included by a selection mask. Both masks are shown after this message.

System action Terminates with a condition code of 12.

Operator response: Modify or remove the conflicting selection criteria.

System programmer response: None.

Module: HZAPINQ

HZAP082I

THE "XDEVICE" MASK IS NOT A SUBSET OF ANY "DEVICE" MASK

Explanation: The mask specified in the XDEVICE operand excludes possible values not included in the DEVICE operand. This message is issued to highlight possible inconsistencies in a request.

System action Processing continues.

Operator response: Specify the XDEVICE operand as a further qualification of the DEVICE operand to avoid this message.

System programmer response: None.

Module: HZAPINQ

INQP083E

RENAME FAILED FOR DATA SET dsn

Explanation: The rename operation to add one or more extra low-level qualifiers to a data set name as specified by the LLQ program parameter setting did not succeed. The named data set is allocated to either the INQPZIP or INQPOUT file. This message is preceded by either an associated explanatory message, or by messages from IDCAMS detailing the results of the rename attempt.

In the message text:

dsn: name of the INQPZIP or INQPOUT data set.

System action The output data set retains its original name.

Operator response: Ensure that the specified LLQ string length does not exceed 44 bytes, that any symbols used are valid for this system, and that resultant data set names are not longer than 44 bytes. Examine associated messages to determine the reason for the rename failure.

System programmer response: None.

Module: HZAPINQ

HZAP084I

ABEND abend OPENING DSN dsn

Explanation: An abnormal end occurred while opening a data set.

In the message text:

abend: hexadecimal system abend and reason
dsn: name of the data set being processed.

System action Processing of this data set is terminated.

Operator response: None required, but you may wish to correct the cause of the abend.

System programmer response: None.

Module: HZAPINQ

HZAP085I

ABEND abend CLOSING DSN dsn

Explanation: An abnormal end occurred while closing a data set.

In the message text:

abend: hexadecimal system abend and reason
dsn: name of the data set being processed.

System action Processing of this data set is terminated.

Operator response: None required, but you may wish to correct the cause of the abend.

System programmer response: None.

Module: HZAPINQ

HZAP086S

NO PROGRAMS OR TAG DATA FOUND - NO DATA FOR IMPORT WAS PRODUCED

Explanation: All scanning operations failed to find any executable programs or program tag data, so no data suitable for subsequent processing was created.

System action Terminates with a condition code of 12.

Operator response: Correct any selection criteria errors and rerun the job.

System programmer response: None.

Module: HZAPINQ

HZAP087I

SKIP INACCESSIBLE DATA SET dsn

Explanation: The named data set was encountered on an SMS-managed volume, but no matching catalog entry could be located, which means that the data set cannot be successfully allocated by any job.

In the message text:

dsn: name of the data set being skipped.

System action The data set is bypassed and processing continues.

Operator response: None required, but you may wish to either catalog the data set to make it accessible, or delete it to reclaim the disk space.

System programmer response: None.

Module: HZAPINQ

HZAP088I

DEVICES=vol CU-GROUPS=ds USED-CHPIDS=dsbad

Explanation: Processing of a SCANDEV request has been completed. Counts of online I/O devices, device groups and used channel paths are shown. A group of devices with the same device type, control unit, and CHPID connectivity generates one CU record. A CP record is generated for each online CHPID connected to at least one online I/O device.

In the message text:

vol: count of online I/O devices discovered.
ds: count of CU records written.
dsbad: count of CP records written.

System action Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAPINQ

HZAP089E

INSUFFICIENT AUTHORIZATION TO PROCESS "SCANDEV" REQUEST

Explanation: To process a SCANDEV request either the Inquisitor must be APF authorized or the user must have UPDATE access to the IOSCDR entity in the FACILITY security class.

System action Processing continues with the next request.

Operator response: Get the appropriate authorization, or omit the SCANDEV request.

System programmer response: None.

Module: HZAPINQ

HZAP090I

EXCESSIVE DESERV DELAY FOR dsn

Explanation: This message is issued when a DESERV macro has not returned control to the Inquisitor after 15 minutes. This might indicate that the data set being processed is corrupt and unusable.

In the message text:

dsn: name of the data set being scanned.

System action Processing continues, possibly without making any further progress.

Operator response: If the scan does not progress, and the delay is not caused by contention with other work, cancel the job. Either delete the data set, or add an exclusion to the Inquisitor control statement before rerunning the job.

System programmer response: None.

Module: HZAPINQ

HZAP091I

IGNORING OLD TAG MEMBER mem IN DATA SET=dsn

Explanation: This message is issued when a tag member made by the defunct Tagger program HZATAGP is encountered. The Inquisitor will not collect any information from or about this member.

In the message text:

mem: name of the found tag member.

Explanation:

In the message text:

dns: name of the data set being scanned.

System action Processing continues.

Operator response: The tag member can be safely deleted. Local tagging functions are now available in the Analyzer which can directly update the data base.

HZAP092I

ANOTHER JOB HOLDS dsn =time / dsn

Explanation: This message is issued when a library to be scanned is found to be exclusively allocated to another job, and therefore cannot be scanned.

In the message text:

time: time of message.
dns: name of the unavailable data set.

System action Processing continues. If the data set does not become available before the processing of the request completes, an error or warning condition will be raised. The default error condition can be reduced to a warning condition by specifying the INUSEWARN keyword in the request statement.

Operator response: If necessary, and if message HZAP093I is not issued for this data set, rerun the scan when the data set is available.

HZAP093I

RETRY SUCCESS FOR vol / dsn =vol / dsn

Explanation: This message is issued when a library to be scanned was previously found to be exclusively allocated to another job, but has now become available and has been processed.

In the message text:

vol: serial number of volume.
dns: name of the unavailable data set.

System action Processing continues.

Operator response: None.

HZAP094W

RETRY FAILURE FOR vol / dsn =vol / dsn

Explanation: This message is issued when a library to be scanned was previously found to be exclusively allocated to another job, and the data set retried. INUSEWARN was specified on the request.

In the message text:

vol: serial number of volume.
dns: name of the unavailable data set.

System action Processing continues.

Operator response: If necessary, rerun the scan when the data set is available.

HZAP095E

RETRY FAILURE FOR vol / dsn =vol / dsn

Explanation: This message is issued when a library to be scanned was previously found to be exclusively allocated to another job, and the data set remains unavailable when the allocation was retried. INUSEWARN was not specified on the request.

In the message text:

vol: serial number of volume.
dns: name of the unavailable data set.

System action Processing continues.

Operator response: If necessary, rerun the scan when the data set is available.

HZAP097E

CATALOG SEARCH INTERFACE ERROR RC=csirc

Explanation: A request with the CATALOG keyword was specified, and the Catalog Search Interface encountered an error.

In the message text:

csirc: return code from the Catalog Search Interface.

System action Processing catalog entries for the request is terminated.

Operator response: Correct any related catalog errors.

System programmer response: None.

Module: HZAPINQ

HZAP098E

CATALOG SEARCH INTERFACE ERROR RC=csirc CATALOG RC=rc CATALOG RS=rs

Explanation: A request with the CATALOG keyword was specified, and the Catalog Search Interface encountered an error.

In the message text:

csirc: return code from the Catalog Search Interface.
rc: return code from Catalog Management.
rs: reason code from Catalog Management.

System action Processing catalog entries for the request is terminated.

Operator response: Correct any related catalog errors.

System programmer response: None.

Module: HZAPINQ

HZAP099E

CATALOG SEARCH INTERFACE ERROR RC=csirc CATALOG RC=rc CATALOG RS=rs MODULE=modid

Explanation: A request with the CATALOG keyword was specified, and the Catalog Search Interface encountered an error.

In the message text:

csirc: return code from the Catalog Search Interface.
rc: return code from Catalog Management.
rs: reason code from Catalog Management.
modid: module identifier.

System action Processing catalog entries for the request is terminated.

Operator response: Correct any related catalog errors.

System programmer response: None.

Module: HZAPINQ

HZAP100I

PROGRAM HZAPVMAP COMPLETED WITH RC=rc

Explanation: The HZAPVMAP program was invoked to process the optional DASDMAP file, and HZAPVMAP issued the return code shown. A return code of zero indicates success. A return code of 8 indicates that the DASDMAP DD was allocated, but a problem was encountered trying to process it.

In the message text:

rc: decimal return code from HZAPVMAP.

System action Processing continues.

Operator response: If necessary, investigate any I/O errors associated with the data set allocated to DASDMAP.

Reconcile the intended mapping(s) with any HZAP101I messages that immediately follow. If necessary, correct the assignments and rerun the job.

System programmer response: None.

Module: HZAPINQ

HZAP101I

VOLUMES MATCHING "v-mask" WILL BE MAPPED TO"v-name"

Explanation: The HZAPVMAP program has extracted the displayed logical volume mapping from the DASDMAP file.

In the message text:

v-mask: volume serial selection mask.

v-name: assigned logical volume name.

System action Processing continues.

Operator response: Verify that the displayed logical volume mapping is as intended. Note that while the Usage Monitor also calls program HZAPVMAP, it does not externalize the results, so trial executions of the HZAPINQ program should be used to test new logical volume mapping assignments before the resulting data is imported into the data base.

System programmer response: None.

Module: HZAPINQ

HZAP102U

DSPSERV CREATE RC=rc RS=rs

Explanation:

The Inquisitor executed a DSPSERV CREATE macro to acquire storage to hold collected data, but DSPSERV issued a non-zero return code.

In the message text:

rc: hexadecimal DSPSERV return code.

rs: hexadecimal DSPSERV reason code.

System action

Program HZAPINQ abends with user abend code 29 and with the reason code returned by DSPSERV.

Operator response:

Consult the applicable MVS Programming: Assembler Services Reference manual to determine the meaning of the DSPSERV return and reason codes. Ensure that the job is permitted to acquire numerous data spaces and gigabytes of data space storage.

System programmer response:

Inspect and, if necessary, alter the DSLIMITNUM and DSLIMITSIZE settings in the SMFLIMxx PARMLIB member that are applied to this job.

Module: HZAPINQ

HZAP103I

type QUEUE MAXIMUM=count

Explanation:

This message is issued when volume-scanning subtasks queue collected data about items such as data sets and programs for processing by the main task. The maximum queue length for each item type is reported.

In the message text:

type: item type - refer to message HZAP104I for possible values.

count: maximum queue length.

System action

Processing continues.

Operator response:

None.

System programmer response:

None.

Module: HZAPINQ

HZAP104I

type DATA SPACE FREE STORAGE ADDRESS IS addr

Explanation:

This message is issued when volume-scanning subtasks use data space storage to queue collected data for processing by the main task. The start address of unused virtual storage in the relevant data space is reported. Pages above this address were not referenced. This message indicates how much data space storage was used by the request. The used storage is also reported as a percentage of the total data space size to provide capacity feedback.

In the message text:

type: item type. The following data categories might be reported:

DATASET - contains details of data sets selected for scanning.
PROGRAM - contains details of programs scanned by subtasks.
PGMTEXT - contains eyecatchers and character strings from programs scanned by subtasks.
SECTION - contains details of control sections and LE compile units extracted from programs scanned by subtasks. The data space to hold this item type is only created for SCANPGM FULLIDR requests.

addr: 8-digit hexadecimal virtual storage address followed by a percentage in parentheses.

System action

Processing continues.

Operator response:

None.

System programmer response:

None.

Module: HZAPINQ

HZAP105I

USED DATA SPACE PAGES:size

Explanation:

This message is issued when volume-scanning subtasks use data space storage to queue collected data for processing by the main task. It reports the maximum amount of virtual storage across all data spaces created by the main task for this request that needed to be backed in central and/or auxiliary storage by the system. This storage quantity is also expressed as a percentage to indicate how much of the data space storage that SMF may report as being allocated was actually used. The small data space that may be created by each volume-scanning subtask is not included in these numbers.

In the message text:

size: virtual storage size, followed by a percentage in parentheses.

System action

Processing continues.

Operator response:

None.

System programmer response:

None.

Module: HZAPINQ

INQP106I

bytes COMPRESSED DATA BYTES WRITTEN TO ddname

Explanation:

This message is issued after closing the named output DD which contains compressed (zipped) data. The reported compressed data byte count matches the count contained in the zip file headers, so the count does not include the size of the zip headers. The reported DD name will be INQPZIP unless HZAPINQ was invoked by another program which supplied a DD override parameter.

In the message text:

bytes: byte count.
ddname: output DD name.

System action

Processing continues.

Operator response:

None.

System programmer response:

None.

Module: HZAPINQ

HZAP107I

NUMBER OF CONCURRENT DATA SPACES LIMIT IS limit

Explanation:

This message is issued when a relatively low concurrent data space count limit is detected. Ensure that active SMFLIMxx PARMLIB settings do not unduly limit storage access for the job. The Inquisitor uses data space storage to reduce the dependency on large region size availability, and depending on the actual request, may allocate up to MAXTASKS+4 data spaces.

In the message text:

limit: maximum allowed data space count.

System action

Processing continues.

Operator response:

None.

System programmer response:

None.

Module: HZAPINQ

HZAP108I

DATA SPACE STORAGE LIMIT IS limit MB

Explanation:

This message is issued when a relatively low data space storage limit is detected. Ensure that active SMFLIMxx PARMLIB settings do not unduly limit storage access for the job. The Inquisitor uses data space storage to reduce the dependency on large region size availability, and depending on the actual request, may allocate up to four 2 GB and MAXTASKS 16648 KB data spaces.

In the message text:

limit: maximum allowed data megabyte count.

System action

Processing continues.

Operator response:

None.

System programmer response:

None.

Module: HZAPINQ

HZAP999U

MODULE HZAPMSG FAILED - MSGID=msgid RC=rc RS=rs

Explanation: HZAMSG was called to produce a message text, but the call failed.

In the message text:

msgid: identifier of the failing message.
rc: HZAMSG return code.
rs: HZAMSG reason code.

System action Terminates with a condition code of 20.

Operator response: Inform the system programmer.

System programmer response:Ensure JOBLIB/STEPLIB contains the library where the HZAPMSG message module resides. If you cannot resolve this issue, contact HCL support.

Module: HZAPINQ