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

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

In the message text:

rc
return code from EXECIO
The program terminates and takes no actions.
Correct the JCL and provide a SYSIN DD with valid control statements.
None.
HZAICUST

HZAI002I

REQUIRED PARAMETER prm IS MISSING FROM SYSIN

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.
The program terminates and takes no actions.
Correct the SYSIN and supply the required parm.
None.
HZAICUST

HZAI003I

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

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.
The program continues and uses the default as documented in the message.
If the default value is to be overridden supply the parameter value in the HZASCUST Job SYSIN stream then resubmit.
None.
HZAICUST

HZAI004I

ALLOCATION OF DATASET dsn TO dd FAILED, RC=rc

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.
The program terminates and takes no actions.
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.
None.
HZAICUST

HZAI005I

func FAILED FOR rsc, RC=rc

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.
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.
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.
None.
HZAICUST

HZAI006I

MODEL DATASET SHZASAMP HAS NOT BEEN FOUND.

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

HZAI007I

CUSTOMIZATION TERMINATES ...

The HZAICUST program encountered an error during execution.
The program terminates and takes no further action.
Check the previous message which will identify the component causing the problem.
None.
HZAICUST

HZAI008I

prm PARAMETER VALUE pval IS > plen CHARACTERS.

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.
The program terminates and takes no actions.
Check the parameter in question and re-submit the HZASCUST JCL after correcting the length error.
None.
HZAICUST

HZAI009I

prm DATASET dsn WAS NOT FOUND ON SYSTEM systm

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.
The program terminates and takes no actions.
Check the parameter in question and re-submit the HZASCUST JCL after correcting the DSN error.
None.
HZAICUST

HZAI010I

verb STATEMENT VERB NOT ONE OF list

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.
The program terminates and takes no actions.
Update the statements to the program to correct the verb in error and supply a correct verb.
None.
HZAIKBT

HZAI011I

word NOT VALID FOR VERB verb

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.
The program terminates and takes no actions.
Update the statements to the program to correct the statement in error.
None.
HZAIKBT

HZAI012I

PARAMETER prm IS NOT A VALID HZASCUST PARAMETER

An invalid HZASCUST SYSIN parameter has been found.

In the message text:

prm
parameter that is invalid.
The program terminates.
Remove the invalid parameter from the HZASCUST Job SYSIN then resubmit.
None.
HZAICUST

HZAI013I

PARAMETER prm HAS A NULL VALUE

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.
The program terminates.
Ensure that the HZASCUST parameter has a valid parameter value in the HZASCUST Job SYSIN then resubmit.
None.
HZAICUST

HZAI014I

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

An HZASCUST parameter contains unbalanced quotes.

In the message text:

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

HZAI015I

DATASET dsn stat

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.
The HZAICUST program continues processing.
Informational message, no action required.
None.
HZAICUST

HZAI016I

UNMATCHED COMMENT DELIMITER IN HZASCUST STATEMENT: stmnt

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.
The program terminates and takes no actions.
Correct the HZASCUST SYSIN statements and provide valid comment delimiters, /* */.
None.
HZAICUST

HZAI017I

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

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.
The program terminates.
Ensure that the HZASCUST parameter has a value between A and Z, then resubmit the Job.
None.
HZAICUST

HZAI018I

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

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.
The program terminates and takes no actions.
Correct the parameter in error and rerun the HZASCUST Job.
None.
HZAICUST

HZAI019I

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

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.
The program terminates and takes no actions.
Correct the HZASCUST SYSIN statements and ensure that DBTYPE= is the first entry. Comment statements and blank lines may precede the DBTYPE= entry.
None.
HZAICUST

HZAI020I

TAILORING PARAMETERS:

HZAICUST progress message.
The program continues.
This is an informational progress message and no further action is required.
None.
HZAICUST

HZAI021I

CREATING POST-INSTALLATION DATASETS:

HZAICUST progress message.
The program continues.
This is an informational progress message and no further action is required.
None.
HZAICUST

HZAI022I

APPLYING TAILORING INFORMATION TO POST-INSTALLATION MEMBERS:

HZAICUST progress message.
The program continues.
This is an informational progress message and no further action is required.
None.
HZAICUST

HZAI023I

POST-INSTALLATION CUSTOMIZATION COMPLETE.

HZAICUST completion message.
The program ends successfully.
This is an informational progress message and no further action is required.
None.
HZAICUST

HZAI024I

PARAMETER prm CONTAINS AN EXTRANEOUS VALUE: xval

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).
The program terminates
Ensure that the Parameter value is correctly defined and that any comments are enclosed within comment delimiters.
None.
HZAICUST

HZAI025I

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

An HZASCUST parameter value contains no quotes.

In the message text:

prm
name of the parameter.
pval
parameter value.
The program terminates
Ensure that the parameter value is enclosed within single quotation marks then resubmit the HZASCUST Job.
None.
HZAICUST

HZAI026I

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

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.
The program terminates.
Ensure that the HZASCUST parameter has a value between A-Z or 0-9, then resubmit the Job.
None.
HZAICUST

HZAI027I

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

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.
The program terminates and takes no actions.
Correct the DBTYPE value and rerun the HZASCUST Job.
None.
HZAICUST

HZAI028I

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

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

In the message text:

db
duplicate Database name.
The program terminates and takes no actions.
Correct the HZASCUST SYSIN statements and provide unique values for both DB and DBGKB.
None.
HZAICUST

HZAI100I

prm MISSING FROM CONFIGURATION.

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

In the message text:

prm
parameter that is missing.
The program terminates and takes no actions.
Update the parameters in the TPARAM/SYSIN DD to add the missing parameter.
None.
HZAIKBT

HZAI107I

svc FROM rsc FAILED, RC=rc

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.
The program stops processing statements. No changes have been made.
Report this error to the System Programmer.
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.
HZAIKBT

HZAI108I

SQL verb FAILED, SQLCODE=sqlcode

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.
The program stops processing statements. The current statement changes to Db2 tables are backed out.
Report this error to the system programmer.
If you cannot resolve this issue, gather appropriate diagnostic materials and contact HCL support.
HZAIKBT

HZAI300I

ERROR WRITING TO ddn.

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

In the message text:

ddn
DDNAME of the file
The program terminates.
Check the return code and any preceding messages.
None.
HZAIKBT

HZAI301I

NUMBER OF LINES WRITTEN TO SWKBTXML DD IS ocnt.

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

In the message text:

ocnt
lines written to SWKBTXML DD.
The program continues and takes no actions.
Informational message, no action required.
None.
HZAIKBT

HZAI302I

SQL WARNING FOR warn.

SQL warning was issued from a command.

In the message text:

warn
SQL warning.
The program continues.
None.
None.
HZAIKBT

HZAI303I

SQL ERROR FOR err.

The XML Export Utility has encountered an error.

In the message text:

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

HZAI304I

err.

The XML Export Utility has encountered a DSNREXX error.

In the message text:

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

HZAI305I

INVALID SCHEMA sch.

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

In the message text:

sch
schema name
The program terminates and takes no actions.
Ensure that the correct Schema is being used.
None.
HZAIKBT

HZAI999U

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

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.
Terminates with a condition code of 20.
Inform the system programmer.
Contact HCL support.