HIS009I
MODIFY hisproc COMMAND FAILED. SPECIFIED PATH INACCESSIBLE. BPX1ACC SERVICE FAILED with RC=returncode, RSN=reasoncode.

Explanation

The MODIFY hisproc command failed. The specified (or default) file PATH is not accessible. The path either does not exist, or does not have the required read and write access attributes.

When the system issued the UNIX Systems Services BPX1ACC service to verify the PATH value, it failed and returned the listed return code and reason code. See the following list for return and reason code meanings:
RC=9C (EMVSINITIAL) and RSN=xxxx00F9
The HIS User ID, hisproc, has not been defined by the security product. When you add user hisproc, you must create an OMVS segment with a default HOME directory.
RC=81 (ENOENT)
The specified file PATH does not exist.
RC=86 (ENOSYS) or 6F (EACCES)
HIS cannot access the file path specified (or default) on the MODIFY hisproc command. The file path might not have the appropriate read or write access attributes for HIS to access it.

The ENOSYS error might be caused by HIS not having the correct authority to access the HOME directory.

Other return and reason codes
See z/OS UNIX System Services Messages and Codes for information about the return and reason codes.
See z/OS UNIX System Services Programming: Assembler Callable Services Reference for information about the BPX1ACC service.

If you did not specify a path on the command, or if a relative path is specified, the system uses the default path defined by the HOME directory of the OMVS segment when the hisproc user was added to the system (using the ADDUSER TSO command). You must create an OMVS segment with a default HOME directory when you set up the hardware instrumentation services (HIS) user. The default file path, if valid, is the path for all the output files of the MODIFY hisproc command. If you specify a file path on the MODIFY hisproc command, the command overrides the HOME directory value. For more information about defining OMVS segments, see z/OS UNIX System Services Planning.

In the message text:

hisproc
The name of the HIS catalogued startup procedure.
returncode
The return code from BPX1ACC.
reasoncode
The reason code from BPX1ACC.

System action

The system does not complete the command issued.

Operator response

Refer to the return code and reason code in the message for the exact cause of this error.

  • If you do not specify a path on the MODIFY hisproc command, verify that there is a default path defined on the HOME directory keyword in the OMVS segment of the hisproc user.
  • If you specify a relative path, verify that the full path (when concatenated with the HOME directory in the OMVS segment of the hisproc user) exists.
  • If the path exists, verify that the path has the proper read and write access attributes.
    Note: The path name is case sensitive.
You can display the home directory in the OMVS segment of the hisproc user by issuing the following TSO command: 
ListUser hisproc OMVS noracf

You can enter the path name in either absolute form (starting with a “/”), or relative form (without a “/”). If you use the relative form, the system uses the HOME directory of the OMVS segment for the hisproc user.

System programmer response

Ensure your HIS user ID, hisproc, is correctly defined:
  • If the HIS user ID, hisproc, has not been defined by the security product, add the hisproc user ID by the following TSO command, where the UID and HOME values are just examples: 
    ADDUSER hisproc OMVS(UID(25) HOME(’/user’))
  • Specify a HOME directory in the OMVS segment for the added hisproc user. The HOME directory is the default PATH for the MODIFY hisproc command.
  • Add an OMVS segment or HOME directory to the hisproc user by the following TSO command, where the UID and HOME values are just examples 
    ALTUSER hisproc OMVS(UID(25) HOME(’/user’))
  • Create the HOME directory (or any specific file path) using the mkdir OMVS command. Set up appropriate file access attributes with the chmod or chown OMVS commands.
If the problem was caused by a path or user ID setup error, you must correct the error and then stop (STOP hisproc) and restart (START hisproc) the HIS address space before beginning data collection again. If you do not stop and restart the HIS address space, the error can recur, even if you corrected it. You must restart the HIS address space for any of the following actions:
  • Defining a new path using mkdir
  • Modifying the access attributes of an existing path using chmod
  • Adding (ADDUSER) or altering (ALTUSER) the hisproc user ID. This includes (but is not limited to) altering the OMVS segment or the HOME directory

Problem determination

None.

Source

Hardware instrumentation services (HIS)

Module

HISPCMD

Routing code

-

Descriptor code

5

Parent topic: HIS messages