z/OS Messages

Messages are issued when unexpected events occur. Messages can have any of these severities:

Informational

The message confirms an event that was requested or describes another normal occurrence. Informational messages generally do not require any action. The identifier of an informational message ends with the letter I.

Warning

The message describes an event that might indicate a problem. Read the message text and determine whether the event is normal or a problem. The identifier of a warning message ends with the letter W.

Error

The message describes an event that requires a response. Read the message description and the suggested response. The identifier of an error message ends with the letter E.

Severe Error

The message describes an event that requires a response. Read the message description and the suggested response. The identifier of an error message ends with the letter S.

Unrecoverable Error

The message indicates that an unrecoverable error was encountered, and no requests were processed. Read the message description. The identifier of an error message ends with the letter U.

You can find a message description easily by entering its identifier into the Search box in the information center.

HCL Z Asset Optimizer Version 2.1.1 Messages

You can identify the type of message by the message prefix.

HZAL - Licensing messages

Message texts and explanations

All numeric completion codes of system services reported in these messages are in hexadecimal unless otherwise stated.

HZAL001I HZAL001I csid WARNING csid / pid / days

LICENCE HAS days DAYS REMAINING

Explanation: The software product licence will expire in about the indicated number of days.

System action: Processing continues.

Operator response: Notify installation management.

System programmer response: None.

Module: HZAZMON

HZAL002I csid PRODUCTpid IS NOTLICENSED FOR THIS SYSTEM.

Explanation: The software component will not continue processing because the product licence could not be successfully validated.

System action: Processing terminates.

Operator response: Notify installation management.

System programmer response: None.

Module: HZAZMON

HZAP - Inquisitor for z/OS messages and codes

Message texts and explanations

All numeric completion codes of system services reported in these messages are in hexadecimal unless otherwise stated.

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"

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 unrecognised data when looking for an 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

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

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"

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

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

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

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

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

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

System action: Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAPINQ

HZAP015I VOLUMES=volDATASETS=dsBAD-D/S=dsbad PROGRAMS=pgms

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

System action: Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAPINQ

HZAP016I ACCEPTED REQUEST NUMBER:rno

System action: Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAPINQ

HZAP017E DYNALLOC FAILURE: RC=rcERROR=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.

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=rcERROR=err INFO=inf VOLUME=vol

Explanation: A VTOC could not be dynamically allocated.

System action: Processing of this data set is terminated.

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.

System action: Termination continues.

Operator response: None required.

to exclude the data set from processing, or correct the cause of the abend.

System programmer response: None.

Module: HZAPINQ

System programmer response: None.

Module: HZAPINQ

HZAP021S INVALID OPERAND SUBPARAMETER

FOR spm

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

System action: Terminates with a condition code of 12.

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

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.

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.

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 OFHEX rc

Explanation: An unexpected return code was received 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

Explanation: The OPEN of the HZAPOUT file failed.

System action: Terminates with a condition code of 16.

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

System programmer response: None.

Module: HZAPINQ

HZAP026E I/O ERROR ENCOUNTEREDREADING VTOC OF VOLUME vol ONDEVICE dev

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

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

System programmer response: None.

Module: HZAPINQ

HZAP028U CANNOT OPEN HZAPDMP FILE

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

System action: Terminates with a condition code of 16.

Operator response: Ensure a usable HZAPDMP 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.

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 HCLsupport.

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 HZAP038I which details the cause.

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 VOLUMEvol

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 a program parameter of "DSNMSG" or "ALLMSG" is specified.

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 a program parameter of "DSNMSG" or "ALLMSG" is specified.

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 FORdsn

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 a program parameter of "DSNMSG" or "ALLMSG" is specified.

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 volONDEVICE dev

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

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.

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.

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.

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

Explanation: Neither an HZAPOUT nor an HZAPZIP 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

HZAP053U COMPRESSION SUBROUTINE ERROR

Explanation: While processing the HZAPZIP 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 "FULLDIR" OPERAND IGNORED FOR "SCANDIR" VERB

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

System action: The FULLDIR operand is ignored and processing continues.

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

System programmer response: None.

Module: HZAPINQ

HZAP056I date time COMMENCING SCANOF

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.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAPINQ

HZAP057E ABEND abend PROCESSING VTOCOFVOLUME 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 not usable.

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 OPERANDENCOUNTERED: op

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

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: HZAPIN

HZAP059W BINDER FAILURE FOR MEMBER mbrRC=rc RS=rs

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

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

Operator response: None required.

Module: HZAPIN

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.

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 INdsn

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 a program parameter of "PGMMSG" or "ALLMSG" is specified.

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.

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 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

System programmer response: None.

Module: HZAPINQ

HZAP067E MCDS READ RC=rc RS=rs FORdsn

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.

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.

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.

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.

System action: The returned catalog entry is discarded.

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

System programmer response: None.

Module: HZAPINQ

HZAP072I BYPASS PROCESSING DATA SET dsn

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. This message is only issued when a program parameter of "DSNMSG" or "ALLMSG" is specified.

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

Operator response: None required.

System programmer response: None.

Module: HZAPINQ

HZAP073I NO DATA WAS EXTRACTED FROMdsn

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

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.

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

HZAP075W FDRABR ABEND abend CHECKING dsn

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

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: mbrdsn

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

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.

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.

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.

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 numbersincluded 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

HZAP083E 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 HZAPZIP or HZAPOUT file. This message is preceded by either an associated explanatorymessage, or by messages from IDCAMS detailing the results of the rename attempt.

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 DSNdsn

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

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 DSNdsn

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

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.

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=volCU-GROUPS=dsUSED-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.

System action: Processing continues.

Operator 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.

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.

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.

System programmer response: None.

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.

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.

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.

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.

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.

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=csircCATALOG RC=rc CATALOG RS=rs

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

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=rsMODULE=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

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

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

System action: Terminates with a condition code of 20.

Operator response: Inform the system programmer.

System programmer response: Contact HCL Support.

Module: HZAPINQ

HZAX - Inquisitor for z/OS UNIX messages and codes

Return codes

Message texts and explanations

All numeric completion codes of system services reported in these messages are in hexadecimal unless otherwise stated.

HZAX002I THE SPECIFIED DIRECTORY NAME DOES NOT START WITH A SLASH

Explanation: A record from file HZAXROOT was read and was found to start with a non-blank that is not a slash. It is reported in case processing errors result from the non-standard directory name.

System action: Processing continues.

Operator response: Correct the input if it is incorrect.

System programmer response: None.

Module: HZAXINQ

HZAX003I PROGRAM PARAMETER "parm" DISCARDED

Explanation: The program parameter contained some unrecognized data.

System action: The displayed part of the program parameter is ignored.

Operator response: Correct the program parameter.

System programmer response: None.

Module: HZAXINQ

HZAX004I FUNCTION func COMPLETEDWITH RC=rc ANDREASON=rs

Explanation: The named z/OS UNIX system service issued a negative return value.

System action: Processing continues.

Operator response: Determine the meaning of the return and reason codes, and correct the problem if appropriate. Information relating to the failing UNIX function can be found in the UNIX System Services Assembler Callable Services manual. Information relating to the Return Code and Reason Code of the failing UNIX function can be found in the UNIX System Services Messages and Codes manual.

System programmer response: None.

Module: HZAXINQ

HZAX006E 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 HZAXZIP or HZAXOUT file. If this message is not followed by an associated explanatory message then an IDCAMS report detailing the results of the rename attempt will have been written to SYSPRINT.

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: HZAXINQ

HZAX007E FUNCTION func FAILED, RC=rc, REASON=rs, FOR PATH pth

Explanation: The named z/OS UNIX system service issued a negative return value.

System action: Processing continues.

Operator response: Determine the meaning of the return and reason codes, and correct the problem if appropriate. Information relating to the failing UNIX function can be found in the UNIX System Services Assembler Callable Services manual. Information relating to the Return Code and Reason Code of the failing UNIX function can be found in the UNIX System Services Messages and Codes manual.

System programmer response: None.

Module: HZAXINQ

HZAX008E FUNCTION func WAS DENIED ACCESS TO PATH pth

Explanation: The named z/OS UNIX system service issued a return code of hexadecimal 6F which indicates that access was denied.

System action: Processing continues.

Operator response: Grant the user access to the parts of the UNIX file system to be scanned.

System programmer response: None.

Module: HZAXINQ

HZAX009S NO EXECUTABLE SOFTWARE FOUND- NO DATA FOR IMPORT WAS PRODUCED

Explanation: All scanning operations failed to find any programs or other executable software, 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: HZAXINQ

HZAX999U HZAMSG/HZAXMSG FAILURE -MSGID=msgid RC=rc RS=rs

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

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 HZAXMSG message module resides. If you cannot resolve this issue then contact HCLsupport.

Module: HZAXINQ

HZAZ - Usage Monitor messages

Message texts and explanations

All numeric completion codes of system services reported in these messages are in hexadecimal unless otherwise stated.

HZAZ001I USAGE MONITOR INITIALIZING

Explanation: The Usage Monitor has been started.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ002I csid DETECTED UNSUPPORTED OPERATING SYSTEM

System action: Processing terminates.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ003I csid USAGE MONITOR NOT APF AUTHORIZED

Explanation: The Usage Monitor needs to be executed in an APF authorized environment.

System action: Processing terminates.

Operator response: See System Programmer to correct the error.

System programmer response: APF authorize the load libraries that the Usage monitor runs from.

Module: HZAZMON

HZAZ005I csid USAGE MONITOR ALREADY ACTIVE

Explanation: The Usage Monitor is already running. Only one concurrent copy can run in an operating system image.

System action: Processing terminates. The established Usage Monitor task continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

Explanation: A QEDIT issued to set up MODIFY command processing has failed.

System action: Processing terminates.

Operator response: Notify the system programmer.

System programmer response: Gather appropriate diagnostic materials and contact HCL support.

Module: HZAZMON

HZAZ007I csid USAGE MONITOR MODULEmodFAILED - RC=rc

Explanation: A Usage Monitor subroutine has failed.

System action: Processing terminates.

Operator response: Notify the system programmer.

System programmer response: Gather appropriate diagnostic materials and contact HCL support.

Module: HZAZMON

HZAZ008I csid USAGE MONITOR INITIALIZED-

ASID asid SET IN AVT avt

Explanation: An Anchor Vector Table (AVT) has been acquired or reacquired, and has been updated for the current server address space, which has completed initialization.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ009I DATA WRITTEN TO DSN=dsn

Explanation: Usage Monitor data has been written to the named data set.

System action: Processing continues.

Operator response: Transfer the named data set to the system where the database resides so it can be processed.

System programmer response: None.

Module: HZAZMON

HZAZ010E csid USAGE MONITOR - WRITER TASK ENDED - RC=rc

Explanation: A writer task has ended with a non-zero return code.

System action: Processing continues.

Operator response: Notify the system programmer.

System programmer response: Gather appropriate diagnostic materials and contact HCL support.

Module: HZAZMON

HZAZ011E csid USAGE MONITOR - WRITER TASK ABENDED - Sabend

Explanation: A writer task has ended abnormally.

System action: Processing continues.

Operator response: Notify the system programmer.

System programmer response: Local reasons for system abends should be investigated. If necessary, gather appropriate diagnostic materials and contact HCL support.

Module: HZAZMON

HZAZ012I **DATA LOSS** UNUSABLE DSN=dsn

Explanation: It is likely that Usage Monitor data has been lost because of unexpected behaviour by a writer task. Any compressed output data that has been written will probably be unusable.

System action: Processing continues.

Operator response: Examine any preceding messages to determine the likely cause of the writer task error. If the output data set is complete it can be used, otherwise if the data is compressed it is unusable. If the data set is empty then this fact can be noted and the data set can be deleted. Unless retaining an unusable data set for diagnosis reasons it can be deleted.

System programmer response: Investigate anywriter task abends.

Module: HZAZMON

HZAZ013I csid USAGE MONITOR-

UNRECOGNISEDPROGRAM PARAMETER IGNORED

Explanation: An unrecognised program parameter was specified.

System action: Processing continues.

Operator response: Remove or correct the program parameter.

System programmer response: None.

Module: HZAZMON

HZAZ014I csid USAGE MONITOR - COULD NOT OPEN FILE HZAZIN

Explanation: The HZAZIN file could not be opened by the Usage Monitor.

System action: Processing terminates.

Operator response: Supply or correct the HZAZIN DD statement in the JCL.

System programmer response: None.

Module: HZAZMON

HZAZ015I csid USAGE MONITOR - COULD NOT OPEN FILE HZAZMSG

Explanation: The HZAZMSG file could not be opened by the Usage Monitor.

System action: Processing terminates.

Operator response: Supply or correct the HZAZMSG DD statement in the JCL.

System programmer response: None.

Module: HZAZMON

HZAZ016I csid USAGEMONITOR

TERMINATING - INVALID OR MISSING HZAZIN DATA

Explanation: At least one HZAZIN input statement was invalid, or input required to be present in the HZAZIN file was missing.

System action: Processing terminates.

Operator response: Examine the HZAZMSG output report. Correct any invalid statements. Ensure a valid data set name prefix was specified.

System programmer response: None.

Module: HZAZMON

HZAZ017I csid USAGEMONITOR

TERMINATING - NOW WRITING CAPTURED DATA

Explanation: A STOP command has been encountered. The current repository contents are written before the Usage Monitor terminates.

System action: The Usage Monitor starts a writer task and waits for its completion before terminating.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ018I csid USAGE MONITOR HAS NOW TERMINATED

Explanation: The Usage Monitor has now freed resources and is about to terminate.

System action: Processing terminates.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ019I csid USAGE MONITOR REPOSITORY FULL - NOW SWITCHING

Explanation: The current Usage Monitor data collection repository is full.

System action: A new repository is created and used for subsequent data collection. A writer task is initiated for the full repository.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ020I csid THE SPECIFIED NUMBER WAS TOO SMALL

Explanation: The numeric value of a command subparameter was too small to be valid in the command context.

System action: The command is discarded.

Operator response: Correct the numeric value and reissue the command.

System programmer response: None.

Module: HZAZMON

HZAZ021I csid THE SPECIFIED NUMBER WAS TOO LARGE

Explanation: The numeric value of a command subparameter was too large to be valid in the command context.

System action: The command is discarded.

Operator response: Correct the numeric value and reissue the command.

System programmer response: None.

Module: HZAZMON

HZAZ022I csid PASSIVE MODE SET FROM PROGRAM PARAMETER

Explanation: PASSIVE was specified in the program parameter.

System action: The Usage Monitor starts in passive mode unless overridden by input from the HZAZIN file.

Operator response: Set the Usage Monitor into collection mode to start data collection.

System programmer response: None.

Module: HZAZMON

HZAZ023I csid PROGRAM NAME MASKmask

NOT ADDED - ALREADY IN TABLE

Explanation: A command to add a program name mask to a program mask table was issued, but the mask was already present in the table.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ024I csid PROGRAM NAME MASKmask

ADDED TO TABLE

Explanation: A command to add a program name mask to a program mask table was issued, and the mask was added successfully.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ025I csid PROGRAM NAME MASK mask NOT DELETED - NOT FOUND IN TABLE

Explanation: A command to delete a program name mask from a program mask table was issued, but the mask was not present in the table.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ026I csid PROGRAM NAME MASKmask

DELETED FROM TABLE

Explanation: A command to delete a program name mask to a program mask table was issued, and the mask was deleted successfully.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ027I ECSA APPEARS TO BE EXHAUSTED - INCREASE SIZE FOR NEXT IPL

Explanation: The Usage Monitor has attempted to acquire storage from ECSA, but was given CSA storage by the system. This indicates that there is insufficient ECSA for the current workloads, and that it should be increased for the next IPL.

System action: Processing continues.

Operator response: Notify the system programmer.

System programmer response: Add around 50 to 100 megabytes to the ECSA size in the system IPL parameters. Check the capacity of the COMMON page data set.

Module: HZAZMON

HZAZ028I ECSA AND CSA APPEAR TO BE EXHAUSTED - INCREASE ECSA NEXT IPL

Explanation: The Usage Monitor has attempted to acquire some common storage, but the requested amount was unavailable. This indicates that there is insufficient ECSA for the current workloads, and that it should be increased for the next IPL.

System action: Processing continues.

Operator response: Notify the system programmer.

System programmer response: Add around 50 to 100 megabytes to the ECSA size in the system IPL parameters. Close some applications using CSA. If necessary, commence orderly shutdown and reIPL before the system crashes. Check the capacity of the COMMON page data set.

Module: HZAZMON

HZAZ029I csid THERE IS CURRENTLY NO EXCLUDE TABLE

Explanation: A request was made to change or display the program name mask exclude table, but there is currently no exclude table.

System action: Processing continues.

Operator response: None required. The EXC command may be used to create a table.

System programmer response: None.

Module: HZAZMON

HZAZ030I csid USAGE MONITOR - NO DATA COLLECTED SO SKIPPING WRITE

Explanation: Before a writer task was initiated to output the contents of a Usage Monitor repository, it was found that the repository contained no data, and that therefore data output processing could be omitted.

In the message text:

csid

current system identifier.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ031I csid INITIATINGREPOSITORY SWITCH

Explanation: A switch (SWI) command was issued and the requested action is being initiated.

System action: Processing continues.

Operator response: None required.

Module: HZAZMON

HZAZ032I csid cmd COMMAND UNKNOWN

Explanation: A command was issued but was not recognised.

System action: The command is ignored. Processing continues.

Operator response: If necessary, correct and reissue the command.

System programmer response: None.

Module: HZAZMON

HZAZ033I csid cmd COMMANDPROCESSED

Explanation: A command was issued and has been processed successfully.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ034I csid cmd COMMAND HAS INVALID OPERAND

Explanation: A command was issued but an invalid operand was encountered.

System action: The command is ignored. Processing continues.

Operator response: If necessary, correct and reissue the command.

System programmer response: None.

Module: HZAZMON

HZAZ035I csid cmd COMMAND FAILED

Explanation: A command was issued but insufficient resources were available to execute it successfully.

System action: The command is ignored. Processing continues.

Operator response: Try again after more resources become available.

System programmer response: None.

Module: HZAZMON

HZAZ036I csid cmd COMMAND CAUSED NO CHANGE

Explanation: A command was issued but the state to be set by the command was found to already exist.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ037I csid cmd COMMANDREJECTED

Explanation: A recognised command was issued at a time when the Usage Monitor is unable to process the

command.

System action: The command is ignored. Processing continues.

Operator response: Try again after the Usage Monitor has freed the resources.

System programmer response: None.

Module: HZAZMON

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ039I csid REPOSITORY SWITCH HAS BEEN QUEUED

Explanation: A repository switch was triggered by a SWI or STOP command, or by the current repository becoming full, but a writer task is already active. This message is followed by message HZAZ040I which shows the creation timestamp of the active writer task.

Operator response: Check that there are sufficient resources to dispatch the Usage Monitor address space. Check that there are no serialization problems with system components such as device allocation which could be inhibiting writer task processing.

System programmer response: None.

HZAZ040I csid WAITING FOR WRITER TASK ATTACHED ts

ts

Time stamp of write task.

Operator response: Check that there are sufficient resources to dispatch the Usage Monitor address space. Check that there are no serialization problems with system components such as device allocation which could be inhibiting writer task processing.

System programmer response: None.

Explanation: A D-A command was issued to display the current output dynamic allocation parameters, which are shown after this message.

csid

current system identifier.

System action: The data is displayed and processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

Explanation: A D-I command was issued to display the current system identifier which is to be contained in output header records.

csid

current system identifier.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ043I csid DATA DISCARDED DUE TO ECSA STORAGE LIMIT

Explanation: The Usage Monitor has detected for the first time in the life of the repository or since a CSA setting change that program usage event data has been discarded due to the ECSA storage usage limit being reached. This limit was set with the CSAcommand.

In the message text:

csid

current system identifier.

Operator response: Adjust the Usage Monitor CSA limit as appropriate for the particular system. Ensure that the ECSA size has been generously defined for the system, and that the common page data set size is adequate. Ensure that the Usage Monitor address space is running at a higher priority than all CPU-bound workloads. Generally, monitors need to run at a higher priority than the workloads being monitored.

System programmer response: None.

Module: HZAZMON

HZAZ044I csidSWITCH-AND-WRITE

TIME-OF-DAY IS SET TO hh:mm

Operator response: None required.

System programmer response: None.

Module: HZAZMON

csid

current system identifier.

area

purpose of the memory object.

token

storage token of the memory object.

addr

storage address of the memory object.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ046I csid DELETED areatoken-addr

Operator response: None required.

Module:HZAZMON

HZAZ047I csid USAGE MONITOR -ATTACHING

WRITER SEQ-NO-seqnbr

Operator response: None required.

HZAZ048I csid USAGE MONITOR -IDENTIFY FAILED HEX RC=rc

In the message text:

System action: Processing terminates.

Operator response: Notify the system programmer.

System programmer response: Investigate why an IDENTIFY macro would fail with that return code.

Module: HZAZMON

HZAZ049I csid DATA SET NAME MASK NOT DEACTIVATED, NOT FOUND IN LIST

Explanation: A command to delete a data set name mask from a data set name mask list was issued, but the mask was not present in the list.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ050I csid DATA SET NAME MASKmask

LIST list

Explanation: A D-D command was issued to display the data set name mask include and exclude lists.

These header and trailer lines mark the start and end of the lists.

In the message text:

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ053I csid MONITORINGUNIX

PROGRAMS? ans

Explanation: Either a USS command was issued to change the UNIX program monitoring status or a D-S command was issued. When the answer is YES the usage of programs fetched from UNIX files is monitored. When the answer is NO only the usage of programs from PDS and PDSE libraries is monitored.

In the message text:

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ054I csid MONITORING LINK PACK AREA PROGRAMS? ans

Explanation: Either an LPA command was issued to change the LPA program monitoring status or a D-S command was issued. When the answer is YES the usage of programs residing in the Link Pack Area is monitored. When answer is NO only the usage of programs loaded into address space regions (and sometimes into CSA) is monitored.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ056I csid PREFER VOLUME SYMBOL OVER SERIAL? ans

Explanation: Either a SYM command was issued to change the volume symbol status or a D-S command was issued. When the answer is YES a matching system static symbol which evaluates to the volume serial is collected instead of the volume serial if such a symbol exists, otherwise the actual volume serial is collected. When the answer is NO the captured volume serial number is always output. A YES setting may be useful to improve data matching when system software platform volume switches take place.

In the message text:

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ058I csid FILE HZAZIN ISNOT

ALLOCATED - CANNOT PERFORM REFRESH

Explanation: A REF command was issued to refresh settings from commands in the HZAZIN file, but the HZAZIN file had been freed, and was no longer allocated to the Usage Monitor.

In the message text:

System action: The refresh operation is suppressed and processing continues.

Operator response: Ensure FREE=CLOSE is not specified in the HZAZIN JCL DD statement. Recycle the Usage Monitor to refresh the settings if necessary.

System programmer response: None.

Module: HZAZMON

HZAZ059I csid REFRESH PERFORMED WITH NO ERRORS

Explanation: A REF command was issued to refresh settings from commands in the HZAZIN file. All commands in the HZAZIN file were completed successfully.

In the message text:

csid

current system identifier.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ060I csid REFRESH PERFORMED BUT ERROR(S) FOUND

Explanation: A REF command was issued to refresh settings from commands in the HZAZIN file. At least one command in the HZAZIN file resulted in an error.

In the message text:

csid

current system identifier.

System action: Processing terminates.

Operator response: Examine the output in the HZAZMSG file to determine the problem(s).

System programmer response: None.

Module: HZAZMON

HZAZ063I csid COLLECTING"UNKNOWN" EVENTS? ans

Explanation: Either a UNK command was issued or a D-S command was issued. When the answer is YES this message indicates that the Usage Monitor logs events with incomplete data which would not normally be collected. Data base content is not affected.

In the message text:

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ064I csid WILL WRITER TASK COMPRESS THE DATA? ans

Explanation: Either a ZIP command was issued to change the output compression setting or a D-S command was issued. When the answer is YES the writer task writes compressed data to reduce I/O volumes.

In the message text:

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ065I csid WILL WRITER TASK CORRECT LINKLIST DSN? ans

Explanation: Either an LLC command was issued or a D-S command was issued. When the answer is YES the writer task will perform a BLDL for programs known to have been fetched from the link list, and each output record for such programs will be altered to reflect the link list data set name that the writer task found the program in.

In the message text:

csid

current system identifier.

ans

YES or NO.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ066I csid nbr IDLE ELEMENT(S) "LOST" DUE TO ZERO POINTER

Explanation: The Usage Monitor was terminating normally when a storage accounting discrepancy was discovered. The storage for the idle element chain was being freed when it was found to be terminated by a zero pointer before the expected number of elements had been processed. The most probable cause is a storage overlay. This may or may not represent a Usage Monitor logic error. The size of common storage which may be unusable until the next IPL can be calculated by multiplying the element count by the size of an element.

In the message text:

System action: Termination continues.

Operator response: Detemine if the size of the potentional loss of common storage is likely to impact upon system stablility, and take the appropraite action. Ensure that all appropriate maintenance has been applied.

System programmer response: None.

Module: HZAZMON

HZAZ068I csid COLLECTING JOBACCOUNTS

NOW? ans

Explanation: A D-S command was issued. When the answer is YES job account data is currently being collected as program usage events are recorded. When the answer is NO job account data is not being collected currently.

In the message text:

csid

current system identifier.

ans

YES or NO.

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ069I csid COLLECTING JOBACCOUNTSLATER? ans

Explanation: Either a JAC command was issued or a D-S command was issued. When the answer is YES job account data will be collected after the next Usage Monitor collection repository switch. If the answer is NO job account data will not be collected from that time onwards.

In the message text:

System action: Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAZMON

HZAZ070I csid COLLECTING REGISTERED PRODUCT DATA NOW? ans

Explanation: A D-S command was issued. When the answer is YES registered software product data from SMF is currently being collected by the Usage Monitor. When the answer is NO then this SMF data is not being currently collected.

In the message text:

System action: Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAZMON

HZAZ071I csid COLLECTINGREGISTERED PRODUCT DATA LATER? ans

Explanation: Either a PRS command was issued or a D-S command was issued. When the answer is YES registered software product data from SMF will be collected after the next Usage Monitor collection repository switch. When the answer is NO this SMF data will not be collected after the next switch.

In the message text:

System action: Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAZMON

HZAZ072I csid COLLECTINGDYNAMIC

CAPACITY DATA NOW? ans

Explanation: A D-S command was issued. When the answer is YES hardware capacity information is currently being collected by the Usage Monitor. When the answer is NO hardware capacity information is not being currently collected.

In the message text:

System action: Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAZMON

HZAZ073I csid COLLECTINGDYNAMIC

CAPACITY DATA LATER? ans

Explanation: Either a CAP command was issued or a D-S command was issued. When the answer is YES the Usage Monitor will collect hardware capacity information after the next Usage Monitor collection repository switch. When the answer is NO the hardware capacity information will not be collected after the next switch.

In the message text:

System action: Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAZMON

HZAZ074I csid OUTPUT NAMES OFCOLLECTEDUSERS? ans

Explanation: Either a UNM command was issued or a D-S command was issued. When the answer is YES collected user names will be included in the data output by the Usage Monitor writer task. When the answer is NO user names will not be written to the output data set. Even if the answer is YES, no user names will be output if no user information was collected.

In the message text:

csid

current system identifier.

ans

YES or NO.

System action: Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAZMON

HZAZ075I csid COLLECTINGUSERINFORMATION NOW? ans

Explanation: A D-S command was issued. When the answer is YES the identifier and name of each program user is currently being collected by the Usage Monitor. When the answer is NO these user details are not being currently collected. In the message text:

In the message text:

csid

current system identifier.

ans

YES or NO.

System action: Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAZMON

HZAZ076I csid COLLECTING USER INFORMATION LATER?ans

Explanation: Either a JNM command was issued or a D-S command was issued. When the answer is YES the names of jobs using programs will be collected after the next Usage Monitor collection repository switch. When the answer is NO only generic address space type data such as JOB, STC and TSU will be collected after the next switch instead of individual job names.

In the message text:

System action: Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAZMON

HZAZ077I csid COLLECTING JOB NAMESNOW?

ans

Explanation: A D-S command was issued. When the answer is YES the names of jobs using programs are currently being collected by the Usage Monitor. When the answer is NO only generic address space type data such as JOB, STC and TSU is currently being collected instead of individual job names.

In the message text:

System action: Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAZMON

HZAZ078I csid COLLECTING JOB NAMES LATER?ans

Explanation: Either a JNM command was issued or a D-S command was issued. When the answer is YES the names of the jobs using programs will be collected after the next Usage Monitor collection switch. When the answer is NO only generic address space type data such as JOB, STC and TSU will be collected after the next switch instead of individual job names.

In the message text:

System action: Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAZMON

HZAZ079I csid ALLOWING CICS EVENT COLLECTION? ans

Explanation: A D-S command was issued. When the answer is YES this message indicates that CICS event collection from suitably customized CICS regions is enabled. When the answer is NO CICS generated program usage information will not be collected.

In the message text:

System action: Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAZMON

HZAZ080I csid dsn

Explanation: Displays the dataset name mask for a D-D command.

In the message text:

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

HZAZ081I csid MONITORING PREVIOUSLY RUNNING PROGRAMS? ans

Explanation: A D-S command was issued. When the answer is YES this message indicates usage data for programs resident in the regions of jobs which are older than the current Usage Monitor repository and which have SMF interval recording active will be collected. When the answer is NO there will be no usage data collected for programs which were running before the current repository was created and do not terminate before the repository collection period ends.

In the message text:

System action: Processing continues.

Operator response: None required.

System programmer response: None.

Module: HZAZMON

Operator response: None required.

System programmer response: None.

HZAZ083I csid ADJUSTING FOR HYPERVISOR TIME OFFSET? ans

Explanation: Either a HOF or a D-S command was issued. When the answer is YES the message indicates that timestamps in collected data will be adjusted by subtracting the hypervisor time offset from the z/OS date and time. When the answer is NO the unaltered local z/OS date and time will be used in the collected data.

Operator response: None required.

System programmer response: None.

HZAZ85I csid cmd NO LONGER SUPPORTED

Explanation: A command was issued that is no longer a functional Usage Monitor command.

In the message text:

csid

current system identifier.

cmd

name of the issued command.

System action: The command is ignored. Processing continues.

Operator response: Do not issue this command.

System programmer response: None.

Module: HZAZMON

HZAZ201I DYNALLOC FAILURE RC=rc

ERROR=s99error INFO=s99info DSN=dsn

Explanation: The writer task could not dynamically allocate a new output data set.

System action: Processing of the repository is terminated, and the data lost.

Operator response: Correct the cause of the allocation failure. If necessary, use the DSN, PRI, SEC and UNT commands to customize the allocation request for your installation. Note: The meanings of most DARC values are usually available in Appendix A of the ISPF Tutorial.

System programmer response: None.

Module: HZAZ0203

HZAZ202I USAGE MONITOR - COMPRESSION SUBROUTINE ERROR

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

System action: Processing of the repository is terminated, and the data lost.

Operator response: Correct the error described in the message from the compression subroutine. If you cannot resolve this issue then gather appropriate diagnostic materials and contact HCL support.

System programmer response: None.

Module: HZAZ0203 c

HZAZ203I USAGE MONITOR - SORT FAILED -

RC=rc

Explanation: While sorting repository data the SORT task ended with a non-zero condition code which is taken to mean that the sort was not successful. This message is followed by message HZAZ205I.

System action: The output data set is closed, and the writing of unsorted data to the same data set is attempted.

Operator response: Consult the documentation of the SORT utility. The contents of the SORT report file (DDNAME=SYSOUT) may be helpful.

System programmer response: None.

Module: HZAZ0203

HZAZ204I USAGE MONITOR - SORT ABENDED

- ABEND CODE=abend

Explanation: While sorting repository data the SORT task ended abnormally. This message is followed by message HZAZ205I.

In the message text:

System action: The output data set is closed, and the writing of unsorted data to the same data set is attempted.

Operator response: Investigate why such an abend could occur. The contents of the SORT report file (DDNAME=SYSOUT) may be helpful.

System programmer response: None.

Module: HZAZ0203

HZAZ205I USAGE MONITOR - UNSORTED DATA WILL BE WRITTEN

Explanation: The sorting of output data has failed so the data is now written unsorted.

System action: The message is preceded by either HZAZ203I or HZAZ204I. After the SORT task ended the output data set has been closed and reopened. Repository data is about to be written to the output data set.

Operator response: Investigate why the sort failed.

System programmer response: None.

Module: HZAZ0203

HZAZ206I errmsg

Explanation: The HZASHRNK compression routine issued an error message which is displayed.

In the message text:

System action: The message is preceded by message HZAZ202I.

Operator response: Examine the message for further information.

System programmer response: None.

Module: HZAZ0203

HZAZ207I mb MB NOT AVAILABLE - IARV64 RC=rcREASON=rs

Explanation: The writer task tried to acquire extra storage to assist with sorting data, but the requested storage was not available.

System action: Processing continues. Some output records may not be in sort order.

Operator response: Investigate the IARV64 feedback. If appropriate, increase MEMLIMIT for the Usage Monitor.

System programmer response: None.

Module: HZAZ0203

HZAZ301I DESERV FUNC=EXIT RC=rc

REASON=rs

Explanation: DESERV FUNC=EXIT issued a non-zero return code.

System action: The DESERV exit is not installed.

Operator response: Notify the system programmer.

System programmer response: Research the DESERV feedback to determine why the exit could not be installed.

Module: HZAZ0303

HZAZ302I CSVDYNEX ADD (excd)RC=rc

REASON=rs

Explanation: CSVDYNEX ADD issued a non-zero return code. An exit could not be dynamically defined for the named exit point.

System action: The SMF exit is not installed.

Operator response: Notify the system programmer.

System programmer response: Research the CSVDYNEX feedback to determine why the exit could not be installed. Ensure that IEFU84 is an active SMF exit for the system or subsystem. If you cannot resolve this issue then gather appropriate diagnostic materials and contact HCL support.

Module: HZAZ0303

Explanation: The examined SVC table entry did not have the expected attributes.

System action: The SVC intercept is not installed.

Operator response: Notify the system programmer.

System programmer response: Gather appropriate diagnostic materials and contact HCL support.

Module: HZAZ0303

HZAZ306I BAD statnm ENTRY PGM=pgm JOB=jbn USER=user ID=id DATE=dateREJECTED

Explanation: An invalid work element has been detected and some of its contents are displayed.

System action: Attempted to dump some data to HZAZSNAP if the file is allocated, and will then try to free the work element without processing its contents.

Operator response: Notify the system programmer.

System programmer response: The problem is indicative of a storage overlay. Gather appropriate diagnostic materials and contact HCL support.

Module: HZAZ3060

HZAZ307I csid SCAN OF volume VTOCABENDED

-S cde

Explanation: A scan of the named volume abended with the reported abend code. The scan was performed to find the data set name of a program library that is in use.

System action: Processing continues.

Operator response: Notify the system programmer.

System programmer response: Check the named volume for error conditions. If necessary, gather appropriate diagnostic materials and contact HCL support.

Module: HZAZMON

HZAZ310I MODULE mod INSTALLEDAT

ADDRESS loadpt SIZE size

Explanation: The Usage Monitor has dynamically loaded a module into common storage and will now register it in DLPA.

mod

module name.

loadpt

module load point.

size

module size.

System action: Processing continues.

Operator response: None.

System programmer response: None.

Module: HZAZ0303

HZAZ311I CSVDYLPA RC=rc RS=rs FORmod

Explanation: The Usage Monitor attempted to register a newly installed module in DLPA, but CSVDYLPA issued a non-zero return code.

rc

decimal return code issued by CSVDYLPA.

rs

hexadecimal reason code issued by CSVDYLPA.

mod

name of the module being registered.

System action: Processing continues.

Operator response: Notify the system programmer.

System programmer response: Investigate why the named module could not be registereed in the current DLPA configuration.

Module: HZAZ0303

HZAZ999U HZAMSG/HZAZMSG FAILURE -

MSGID=msgid RC=rc RS=rs

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

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 HZAZMSG message module resides. If you cannot resolve this issue then gather appropriate diagnostic materials and contact HCL support.

Module: HZAZMON