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

HSII001I

READ FAILED FOR SYSIN, RC=rc

The HSIICUST 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.
HSIICUST

HSII002I

REQUIRED PARAMETER prm IS MISSING FROM SYSIN

The HSIICUST 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.
HSIICUST

HSII003I

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

The submitted HSISCUST 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 HSISCUST Job SYSIN stream then resubmit.
None.
HSIICUST

HSII004I

ALLOCATION OF DATASET dsn TO dd FAILED, RC=rc

The HSIICUST 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 HSIINST.
None.
HSIICUST

HSII005I

func FAILED FOR rsc, RC=rc

The HSIICUST 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 IBM support.
None.
HSIICUST

HSII006I

MODEL DATASET SHSISAMP HAS NOT BEEN FOUND.

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

HSII007I

CUSTOMIZATION TERMINATES ...

The HSIICUST 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.
HSIICUST

HSII008I

prm PARAMETER VALUE pval IS > plen CHARACTERS.

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

In the message text:

prm
name of HSISCUST 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 HSISCUST JCL after correcting the length error.
None.
HSIICUST

HSII009I

prm DATASET dsn WAS NOT FOUND ON SYSTEM systm

The HSIICUST 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 HSISCUST 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 HSISCUST JCL after correcting the DSN error.
None.
HSIICUST

HSII010I

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

HSII011I

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

HSII012I

PARAMETER prm IS NOT A VALID HSISCUST PARAMETER

An invalid HSISCUST SYSIN parameter has been found.

In the message text:

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

HSII013I

PARAMETER prm HAS A NULL VALUE

The submitted HSISCUST 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 HSISCUST parameter has a valid parameter value in the HSISCUST Job SYSIN then resubmit.
None.
HSIICUST

HSII014I

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

An HSISCUST 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 HSISCUST Job.
None.
HSIICUST

HSII015I

DATASET dsn stat

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

HSII016I

UNMATCHED COMMENT DELIMITER IN HSISCUST STATEMENT: stmnt

The HSIICUST program found an error in the comment delimiters passed from the HSISCUST SYSIN stream.

In the message text:

stmnt
statement where the error occurred.
The program terminates and takes no actions.
Correct the HSISCUST SYSIN statements and provide valid comment delimiters, /* */.
None.
HSIICUST

HSII017I

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

The HSISCUST 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 HSISCUST parameter has a value between A and Z, then resubmit the Job.
None.
HSIICUST

HSII018I

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

The HSIICUST 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 HSISCUST Job.
None.
HSIICUST

HSII019I

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

The HSIICUST program found an error in the first parameter passed from the HSISCUST SYSIN stream.

In the message text:

prm
statement where the error occurred.
The program terminates and takes no actions.
Correct the HSISCUST SYSIN statements and ensure that DBTYPE= is the first entry. Comment statements and blank lines may precede the DBTYPE= entry.
None.
HSIICUST

HSII020I

TAILORING PARAMETERS:

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

HSII021I

CREATING POST-INSTALLATION DATASETS:

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

HSII022I

APPLYING TAILORING INFORMATION TO POST-INSTALLATION MEMBERS:

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

HSII023I

POST-INSTALLATION CUSTOMIZATION COMPLETE.

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

HSII024I

PARAMETER prm CONTAINS AN EXTRANEOUS VALUE: xval

An HSISCUST 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.
HSIICUST

HSII025I

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

An HSISCUST 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 HSISCUST Job.
None.
HSIICUST

HSII026I

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

The HSISCUST 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 HSISCUST parameter has a value between A-Z or 0-9, then resubmit the Job.
None.
HSIICUST

HSII027I

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

The HSIICUST 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 HSISCUST Job.
None.
HSIICUST

HSII028I

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

The HSIICUST 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 HSISCUST SYSIN statements and provide unique values for both DB and DBGKB.
None.
HSIICUST

HSII100I

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

HSII107I

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 IBM support.
HSIIKBT

HSII108I

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 IBM support.
HSIIKBT

HSII300I

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

HSII301I

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

HSII302I

SQL WARNING FOR warn.

SQL warning was issued from a command.

In the message text:

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

HSII303I

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 IBM support.
HSIIKBT

HSII304I

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 IBM support.
HSIIKBT

HSII305I

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

HSII999U

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

HSIMSG was called to produce a message text, but the call failed.

In the message text:

msgid
identifier of the failing message.
rc
HSIMSG return code.
rs
HSIMSG reason code.
Terminates with a condition code of 20.
Inform the system programmer.
Contact IBM support.
HSIIINQ