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

Explanation: 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.
System action: Processing continues.
Operator response: Correct the input if it is incorrect.
System programmer response: None.
Module: HSIXINQ

HSIX003I

PROGRAM PARAMETER "parm" DISCARDED

Explanation: The program parameter contained some unrecognized data.

In the message text:

parm
parameter in error.
System action: The displayed part of the program parameter is ignored.
Operator response: Correct the program parameter.
System programmer response: None.
Module: HSIXINQ

HSIX004I

FUNCTION func COMPLETED WITH RC=rc AND REASON=rs

Explanation: 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.
System action: Processing continues.
Operator response: 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.
System programmer response: None.
Module: HSIXINQ

HSIX006E

RENAME FAILED FOR DATA SET dsn

Explanation: 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.
System action: The output data set retains its original name.
Operator response: 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.
System programmer response: None.
Module: HSIXINQ

HSIX007E

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

Explanation: 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.
System action: Processing continues.
Operator response: 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.
System programmer response: None.
Module: HSIXINQ

HSIX008E

FUNCTION func WAS DENIED ACCESS TO PATH pth

Explanation: 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.
System action: Processing continues.
Operator response: Grant the user access to the parts of the UNIX® file system to be scanned.
System programmer response: None.
Module: HSIXINQ

HSIX009S

NO EXECUTABLE SOFTWARE FOUND - NO DATA FOR IMPORT WAS PRODUCED

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

HSIX010U

MISSING HSIXOUT AND HSIXZIP FILES

Explanation: Neither an HSIXOUT nor an HSIXZIP file is allocated. At least one output file is required.
System action: Terminates with a condition code of 16.
Operator response: Specify an output file and rerun the job.
System programmer response: None.
Module: HSIXINQ

HSIX999U

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