HZAI - REXX utility messages

These messages are issued by the REXX utility.

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 - Incomplete data. Processing continues. OPEN or other system service error.
12 Syntax error.
16 Unrecoverable error.
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.

HZAI001I

READ FAILED FOR SYSIN, RC=rc

Explanation: The HZAICUST program could not read commands from the SYSIN DDname.

In the message text:

rc
return code from EXECIO
System action: The program terminates and takes no actions.
Operator response: Correct the JCL and provide a SYSIN DD with valid control statements.
System programmer response: None.
Module: HZAICUST

HZAI002I

REQUIRED PARAMETER prm IS MISSING FROM SYSIN

Explanation: The HZAICUST program did not find the required parm in the SYSIN supplied by the user.

In the message text:

prm
name of the parm that is missing.
System action: The program terminates and takes no actions.
Operator response: Correct the SYSIN and supply the required parm.
System programmer response: None.
Module: HZAICUST

HZAI003I

THE DEFAULT VALUE "prm=dft" IS BEING USED.

Explanation: The submitted HZASCUST Job SYSIN did not contain this parameter and the default value will now be used.

In the message text:

prm
name of the parameter.
dft
supplied default.
System action: The program continues and uses the default as documented in the message.
Operator response: If the default value is to be overridden supply the parameter value in the HZASCUST Job SYSIN stream then resubmit.
System programmer response: None.
Module: HZAICUST

HZAI004I

ALLOCATION OF DATASET dsn TO dd FAILED, RC=rc

Explanation: The HZAICUST program could not allocate the dataset to the ddname.

In the message text:

dsn
name of the dataset that failed allocation.
dd
DD name to be allocated.
rc
return code from the allocate command.
System action: The program terminates and takes no actions.
Operator response: Check the return code from the allocate command in the TSO commands manual. Correct the options and try running the program again. The probable option in error is HZAINST.
System programmer response: None.
Module: HZAICUST

HZAI005I

func FAILED FOR rsc, RC=rc

Explanation: The HZAICUST program could not perform a required ISPF function because an error occurred during the function execution.

In the message text:

func
name of ISPF function that failed.
rsc
resource that caused the failure.
rc
return code from the ISPF function.
System action: The program terminates and takes no actions. The program may have written out JCL and parameter members. These members should be treated as suspect as they might contain errors in them due to the nature of this error.
Operator response: Check that the options specified do not exceed the field length requirements of the various options. If you cannot resolve this issue, gather appropriate diagnostic materials and contact HCL support.
System programmer response: None.
Module: HZAICUST

HZAI006I

MODEL DATASET SHZASAMP HAS NOT BEEN FOUND.

Explanation: The HZAICUST program could not find the SHZASAMP dataset created during installation.
System action: The program terminates and takes no actions.
Operator response: Check that the HZA option is correctly specified and that the installation target libraries are available to the customization program.
System programmer response: None.
Module: HZAICUST

HZAI007I

CUSTOMIZATION TERMINATES ...

Explanation: The HZAICUST program encountered an error during execution.
System action: The program terminates and takes no further action.
Operator response: Check the previous message which will identify the component causing the problem.
System programmer response: None.
Module: HZAICUST

HZAI008I

prm PARAMETER VALUE pval IS > plen CHARACTERS.

Explanation: The HZAICUST program found a parameter value with a length greater than the allowed value for that parm.

In the message text:

prm
name of HZASCUST parameter that failed.
pval
contents of the PARM.
plen
length of Parameter value.
System action: The program terminates and takes no actions.
Operator response: Check the parameter in question and re-submit the HZASCUST JCL after correcting the length error.
System programmer response: None.
Module: HZAICUST

HZAI009I

prm DATASET dsn WAS NOT FOUND ON SYSTEM systm

Explanation: The HZAICUST program found a parameter value, which requires a Dataset name. This Dataset name could not be found on the system.

In the message text:

prm
name of HZASCUST parameter that failed.
dsn
dataset name associated with the PARM.
systm
Operating System name.
System action: The program terminates and takes no actions.
Operator response: Check the parameter in question and re-submit the HZASCUST JCL after correcting the DSN error.
System programmer response: None.
Module: HZAICUST

HZAI010I

verb STATEMENT VERB NOT ONE OF list

Explanation: During syntax parsing for a statement the verb found does not match any of the valid verbs for the program.

In the message text:

verb
word that is not a valid verb.
list
list of valid verbs.
System action: The program terminates and takes no actions.
Operator response: Update the statements to the program to correct the verb in error and supply a correct verb.
System programmer response: None.
Module: HZAIKBT

HZAI011I

word NOT VALID FOR VERB verb

Explanation: During syntax parsing for a statement, a word was found that does not match the syntax of the statement for the verb that is being processed.

In the message text:

word
word that is not valid for the statement syntax for a verb.
verb
the verb of the statement that encountered the error.
System action: The program terminates and takes no actions.
Operator response: Update the statements to the program to correct the statement in error.
System programmer response: None.
Module: HZAIKBT

HZAI012I

PARAMETER prm IS NOT A VALID HZASCUST PARAMETER

Explanation: An invalid HZASCUST SYSIN parameter has been found.

In the message text:

prm
parameter that is invalid.
System action: The program terminates.
Operator response: Remove the invalid parameter from the HZASCUST Job SYSIN then resubmit.
System programmer response: None.
Module: HZAICUST

HZAI013I

PARAMETER prm HAS A NULL VALUE

Explanation: The submitted HZASCUST Job SYSIN has encountered a parameter with a NULL value.

In the message text:

prm
name of the parameter that is null.
System action: The program terminates.
Operator response: Ensure that the HZASCUST parameter has a valid parameter value in the HZASCUST Job SYSIN then resubmit.
System programmer response: None.
Module: HZAICUST

HZAI014I

PARAMETER VALUE FOR prm HAS UNBALANCED QUOTES, PARAMETER VALUE IS pval

Explanation: An HZASCUST parameter contains unbalanced quotes.

In the message text:

prm
name of the parameter with unbalanced quotes.
pval
parameter value.
System action: The program terminates
Operator response: Ensure that the Parameter value is enclosed within single quotation marks then resubmit the HZASCUST Job.
System programmer response: None.
Module: HZAICUST

HZAI015I

DATASET dsn stat

Explanation: The HZAICUST program identifies the status of the output datasets that it is going to use.

In the message text:

dsn
name of output dataset.
stat
status of the output dataset.
System action: The HZAICUST program continues processing.
Operator response: Informational message, no action required.
System programmer response: None.
Module: HZAICUST

HZAI016I

UNMATCHED COMMENT DELIMITER IN HZASCUST STATEMENT: stmnt

Explanation: The HZAICUST program found an error in the comment delimiters passed from the HZASCUST SYSIN stream.

In the message text:

stmnt
statement where the error occurred.
System action: The program terminates and takes no actions.
Operator response: Correct the HZASCUST SYSIN statements and provide valid comment delimiters, /* */.
System programmer response: None.
Module: HZAICUST

HZAI017I

PARAMETER prm MUST HAVE THE 1ST CHARACTER AS A VALUE BETWEEN A AND Z

Explanation: The HZASCUST Job has encountered a parameter in the SYSIN DD stream where the first character is not alphabetic. This parameter value must start with a value between A and Z.

In the message text:

prm
name of the parameter that has a non alphabetic first character.
System action: The program terminates.
Operator response: Ensure that the HZASCUST parameter has a value between A and Z, then resubmit the Job.
System programmer response: None.
Module: HZAICUST

HZAI018I

prm VALUE pval MUST BE WITHIN THE VALID RANGE OF val1 TO val2

Explanation: The HZAICUST program encountered a parameter that was outside the valid range of values allowed.

In the message text:

prm
name of the parameter in error.
pval
value of parameter in error.
val1
minimum value of valid range.
val2
maximum value of valid range.
System action: The program terminates and takes no actions.
Operator response: Correct the parameter in error and rerun the HZASCUST Job.
System programmer response: None.
Module: HZAICUST

HZAI019I

DBTYPE MUST BE THE FIRST PARM IN THE SYSIN STREAM. CURRENT VALUE IS prm

Explanation: The HZAICUST program found an error in the first parameter passed from the HZASCUST SYSIN stream.

In the message text:

prm
statement where the error occurred.
System action: The program terminates and takes no actions.
Operator response: Correct the HZASCUST SYSIN statements and ensure that DBTYPE= is the first entry. Comment statements and blank lines may precede the DBTYPE= entry.
System programmer response: None.
Module: HZAICUST

HZAI020I

TAILORING PARAMETERS:

Explanation: HZAICUST progress message.
System action: The program continues.
Operator response: This is an informational progress message and no further action is required.
System programmer response: None.
Module: HZAICUST

HZAI021I

CREATING POST-INSTALLATION DATASETS:

Explanation: HZAICUST progress message.
System action: The program continues.
Operator response: This is an informational progress message and no further action is required.
System programmer response: None.
Module: HZAICUST

HZAI022I

APPLYING TAILORING INFORMATION TO POST-INSTALLATION MEMBERS:

Explanation: HZAICUST progress message.
System action: The program continues.
Operator response: This is an informational progress message and no further action is required.
System programmer response: None.
Module: HZAICUST

HZAI023I

POST-INSTALLATION CUSTOMIZATION COMPLETE.

Explanation: HZAICUST completion message.
System action: The program ends successfully.
Operator response: This is an informational progress message and no further action is required.
System programmer response: None.
Module: HZAICUST

HZAI024I

PARAMETER prm CONTAINS AN EXTRANEOUS VALUE: xval

Explanation: An HZASCUST parameter contains an extraneous value.

In the message text:

prm
name of the parameter with an extraneous value.
xval
the extraneous value(s).
System action: The program terminates
Operator response: Ensure that the Parameter value is correctly defined and that any comments are enclosed within comment delimiters.
System programmer response: None.
Module: HZAICUST

HZAI025I

PARAMETER VALUE FOR prm MUST BE IN QUOTES, PARAMETER VALUE IS pval

Explanation: An HZASCUST parameter value contains no quotes.

In the message text:

prm
name of the parameter.
pval
parameter value.
System action: The program terminates
Operator response: Ensure that the parameter value is enclosed within single quotation marks then resubmit the HZASCUST Job.
System programmer response: None.
Module: HZAICUST

HZAI026I

PARAMETER prm MUST BE A VALUE BETWEEN A-Z OR 0-9

Explanation: The HZASCUST Job has encountered a parameter in the SYSIN DD stream where the 1st character is not alphanumeric. This parameter value must be a value between A-Z or 0-9

In the message text:

prm
name of the parameter that has a non alphanumeric first character.
System action: The program terminates.
Operator response: Ensure that the HZASCUST parameter has a value between A-Z or 0-9, then resubmit the Job.
System programmer response: None.
Module: HZAICUST

HZAI027I

prm VALUE pval FAILED. VALUE MUST BE Db2, SQLITE OR REMOTE.

Explanation: The HZAICUST program encountered an invalid DBTYPE value.

In the message text:

prm
name of the parameter in error.
pval
value of parameter in error.
System action: The program terminates and takes no actions.
Operator response: Correct the DBTYPE value and rerun the HZASCUST Job.
System programmer response: None.
Module: HZAICUST

HZAI028I

PARAMETERS DB AND DBGKB CANNOT HAVE THE SAME DATABASE NAME: db

Explanation: The HZAICUST program found that the values of DB and DBGKB are the same.

In the message text:

db
duplicate Database name.
System action: The program terminates and takes no actions.
Operator response: Correct the HZASCUST SYSIN statements and provide unique values for both DB and DBGKB.
System programmer response: None.
Module: HZAICUST

HZAI100I

prm MISSING FROM CONFIGURATION.

Explanation: The utility requires the parameter in the TPARAM/SYSIN stream.

In the message text:

prm
parameter that is missing.
System action: The program terminates and takes no actions.
Operator response: Update the parameters in the TPARAM/SYSIN DD to add the missing parameter.
System programmer response: None.
Module: HZAIKBT

HZAI107I

svc FROM rsc FAILED, RC=rc

Explanation: An error has occurred executing the service for the resource specified. The service issued the return code mentioned.

In the message text:

svc
service that failed.
rsc
resource that failed.
rc
return code from service.
System action: The program stops processing statements. No changes have been made.
Operator response: Report this error to the System Programmer.
System programmer response: For "EXECIO READ" service, this means that the resource specified (ddname) is missing or empty. If you cannot resolve this issue, gather appropriate diagnostic materials and contact HCL support.
Module: HZAIKBT

HZAI108I

SQL verb FAILED, SQLCODE=sqlcode

Explanation: An error has occurred executing the SQL verb for the table specified.

In the message text:

verb
SQL verb and table name.
sqlcode
SQLCODE from failing statement.
System action: The program stops processing statements. The current statement changes to Db2 tables are backed out.
Operator response: Report this error to the system programmer.
System programmer response: If you cannot resolve this issue, gather appropriate diagnostic materials and contact HCL support.
Module: HZAIKBT

HZAI300I

ERROR WRITING TO ddn.

Explanation: The XML Export utility has a problem writing the XML file.

In the message text:

ddn
DDNAME of the file
System action: The program terminates.
Operator response: Check the return code and any preceding messages.
System programmer response: None.
Module: HZAIKBT

HZAI301I

NUMBER OF LINES WRITTEN TO SWKBTXML DD IS ocnt.

Explanation: Number of lines written to SWKBTXML DD by the XML Export utility.

In the message text:

ocnt
lines written to SWKBTXML DD.
System action: The program continues and takes no actions.
Operator response: Informational message, no action required.
System programmer response: None.
Module: HZAIKBT

HZAI302I

SQL WARNING FOR warn.

Explanation: SQL warning was issued from a command.

In the message text:

warn
SQL warning.
System action: The program continues.
Operator response: None.
System programmer response: None.
Module: HZAIKBT

HZAI303I

SQL ERROR FOR err.

Explanation: The XML Export Utility has encountered an error.

In the message text:

err
SQL Error.
System action: The program terminates and takes no actions.
Operator response: Examine the SQL return code to determine the cause of the error. Inform the system programmer.
System programmer response: If you cannot resolve this issue, then gather appropriate diagnostic materials and contact HCL support.
Module: HZAIKBT

HZAI304I

err.

Explanation: The XML Export Utility has encountered a DSNREXX error.

In the message text:

err
DSNREXX error.
System action: The program terminates and takes no actions.
Operator response: Examine the preceding error messages to determine the error. Inform the system programmer.
System programmer response: If you cannot resolve this issue, gather appropriate diagnostic materials and contact HCL support.
Module: HZAIKBT

HZAI305I

INVALID SCHEMA sch.

Explanation: The XML Export Utility has encountered a problem with an invalid schema.

In the message text:

sch
schema name
System action: The program terminates and takes no actions.
Operator response: Ensure that the correct Schema is being used.
System programmer response: None.
Module: HZAIKBT

HZAI999U

MODULE HZAMSG 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: Contact HCL support.