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

Explanation: The HSIICUST 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: HSIICUST

HSII002I

REQUIRED PARAMETER prm IS MISSING FROM SYSIN

Explanation: 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.
System action: The program terminates and takes no actions.
Operator response: Correct the SYSIN and supply the required parm.
System programmer response: None.
Module: HSIICUST

HSII003I

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

Explanation: 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.
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 HSISCUST Job SYSIN stream then resubmit.
System programmer response: None.
Module: HSIICUST

HSII004I

ALLOCATION OF DATASET dsn TO dd FAILED, RC=rc

Explanation: 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.
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 HSIINST.
System programmer response: None.
Module: HSIICUST

HSII005I

func FAILED FOR rsc, RC=rc

Explanation: 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.
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 IBM support.
System programmer response: None.
Module: HSIICUST

HSII006I

MODEL DATASET SHSISAMP HAS NOT BEEN FOUND.

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

HSII007I

CUSTOMIZATION TERMINATES ...

Explanation: The HSIICUST 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: HSIICUST

HSII008I

prm PARAMETER VALUE pval IS > plen CHARACTERS.

Explanation: 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.
System action: The program terminates and takes no actions.
Operator response: Check the parameter in question and re-submit the HSISCUST JCL after correcting the length error.
System programmer response: None.
Module: HSIICUST

HSII009I

prm DATASET dsn WAS NOT FOUND ON SYSTEM systm

Explanation: 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.
System action: The program terminates and takes no actions.
Operator response: Check the parameter in question and re-submit the HSISCUST JCL after correcting the DSN error.
System programmer response: None.
Module: HSIICUST

HSII010I

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

HSII011I

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

HSII012I

PARAMETER prm IS NOT A VALID HSISCUST PARAMETER

Explanation: An invalid HSISCUST 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 HSISCUST Job SYSIN then resubmit.
System programmer response: None.
Module: HSIICUST

HSII013I

PARAMETER prm HAS A NULL VALUE

Explanation: 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.
System action: The program terminates.
Operator response: Ensure that the HSISCUST parameter has a valid parameter value in the HSISCUST Job SYSIN then resubmit.
System programmer response: None.
Module: HSIICUST

HSII014I

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

Explanation: An HSISCUST 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 HSISCUST Job.
System programmer response: None.
Module: HSIICUST

HSII015I

DATASET dsn stat

Explanation: 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.
System action: The HSIICUST program continues processing.
Operator response: Informational message, no action required.
System programmer response: None.
Module: HSIICUST

HSII016I

UNMATCHED COMMENT DELIMITER IN HSISCUST STATEMENT: stmnt

Explanation: 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.
System action: The program terminates and takes no actions.
Operator response: Correct the HSISCUST SYSIN statements and provide valid comment delimiters, /* */.
System programmer response: None.
Module: HSIICUST

HSII017I

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

Explanation: 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.
System action: The program terminates.
Operator response: Ensure that the HSISCUST parameter has a value between A and Z, then resubmit the Job.
System programmer response: None.
Module: HSIICUST

HSII018I

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

Explanation: 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.
System action: The program terminates and takes no actions.
Operator response: Correct the parameter in error and rerun the HSISCUST Job.
System programmer response: None.
Module: HSIICUST

HSII019I

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

Explanation: 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.
System action: The program terminates and takes no actions.
Operator response: Correct the HSISCUST 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: HSIICUST

HSII020I

TAILORING PARAMETERS:

Explanation: HSIICUST 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: HSIICUST

HSII021I

CREATING POST-INSTALLATION DATASETS:

Explanation: HSIICUST 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: HSIICUST

HSII022I

APPLYING TAILORING INFORMATION TO POST-INSTALLATION MEMBERS:

Explanation: HSIICUST 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: HSIICUST

HSII023I

POST-INSTALLATION CUSTOMIZATION COMPLETE.

Explanation: HSIICUST 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: HSIICUST

HSII024I

PARAMETER prm CONTAINS AN EXTRANEOUS VALUE: xval

Explanation: 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).
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: HSIICUST

HSII025I

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

Explanation: An HSISCUST 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 HSISCUST Job.
System programmer response: None.
Module: HSIICUST

HSII026I

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

Explanation: 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.
System action: The program terminates.
Operator response: Ensure that the HSISCUST parameter has a value between A-Z or 0-9, then resubmit the Job.
System programmer response: None.
Module: HSIICUST

HSII027I

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

Explanation: 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.
System action: The program terminates and takes no actions.
Operator response: Correct the DBTYPE value and rerun the HSISCUST Job.
System programmer response: None.
Module: HSIICUST

HSII028I

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

Explanation: The HSIICUST 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 HSISCUST SYSIN statements and provide unique values for both DB and DBGKB.
System programmer response: None.
Module: HSIICUST

HSII100I

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

HSII107I

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

HSII108I

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

HSII300I

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

HSII301I

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

HSII302I

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

HSII303I

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

HSII304I

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

HSII305I

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

HSII999U

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

Explanation: 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.
System action: Terminates with a condition code of 20.
Operator response: Inform the system programmer.
System programmer response: Contact IBM support.
HSIIINQ