HSIX - Inquisitor for z/OS UNIX messages and codes

These messages are issued by the Inquisitor for z/OS and UNIX.

Return codes
Table 1. Return codes and their meaning
Return code Description
0 No errors encountered. All requests processed successfully.
4 Warning issued.
8 Error - Incomplete data. Processing continues. OPEN or other system service error.
12 Syntax error.
16 Unrecoverable error.
20 The zip I/O subroutine returned an error indication.
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.

HSIX002I

THE SPECIFIED DIRECTORY NAME DOES NOT START WITH A SLASH

A record from file HSIXROOT 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.
Processing continues.
Correct the input if it is incorrect.
None.
HSIXINQ

HSIX003I

PROGRAM PARAMETER "parm" DISCARDED

The program parameter contained some unrecognized data.

In the message text:

parm
parameter in error.
The displayed part of the program parameter is ignored.
Correct the program parameter.
None.
HSIXINQ

HSIX004I

FUNCTION func COMPLETED WITH RC=rc AND REASON=rs

The named z/OS® UNIX® System Service issued a negative return value.

In the message text:

func
function name.
rc
hexadecimal return code.
rs
hexadecimal reason code.
Processing continues.
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.
None.
HSIXINQ

HSIX006E

RENAME FAILED FOR DATA SET dsn

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 HSIXZIP or HSIXOUT 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.

In the message text:

dsn
name of the HSIXZIP or HSIXOUT data set.
The output data set retains its original name.
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.
None.
HSIXINQ

HSIX007E

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

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

In the message text:

func
function name.
rc
hexadecimal return code.
rs
hexadecimal reason code.
pth
path in error.
Processing continues.
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.
None.
HSIXINQ

HSIX008E

FUNCTION func WAS DENIED ACCESS TO PATH pth

The named z/OS UNIX System Service issued a return code of hexadecimal 6F which indicates that access was denied.

In the message text:

func
function name.
pth
path in error.
Processing continues.
Grant the user access to the parts of the UNIX file system to be scanned.
None.
HSIXINQ

HSIX009S

NO EXECUTABLE SOFTWARE FOUND - NO DATA FOR IMPORT WAS PRODUCED

All scanning operations failed to find any programs or other executable software, so no data suitable for subsequent processing was created.
Terminates with a condition code of 12.
Correct any selection criteria errors and rerun the job.
None.
HSIXINQ

HSIX010U

MISSING HSIXOUT AND HSIXZIP FILES

Neither an HSIXOUT nor an HSIXZIP file is allocated. At least one output file is required.
Terminates with a condition code of 16.
Specify an output file and rerun the job.
None.
HSIXINQ

HSIX999U

HSIMSG/HSIXMSG FAILURE - 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.
Ensure Joblib/Steplib contains the library where the HSIXMSG message module resides. If you cannot resolve this issue, contact IBM support.
HSIXINQ