Keywords › HOME Keyword (Session User)—Define USS Entry Subdirectory

HOME Keyword (Session User)—Define USS Entry Subdirectory

Valid on z/OS and z/VM.

Use the keyword to specify a valid HOME directory for entry into UNIX Systems Services (USS).

A session or batch job that enters a USS shell or uses a USS callable service performs an implicit change-directory command to the HOME directory. Subsequent processing depends on the value of the HFSSEC control option:

• If HFSSEC(OFF) is set, the security bits of the directory are checked against the security bits of the session user.
• If HFSSEC(ON) is set, the HOME directory permissions established for the user (and associated profiles) are validated.

Violations cause the session to terminate or cause the service to return an error.

This keyword has the following format:

TSS ADDTO(acid) HOME(/sub1/sub2/…./subn)

acid

Specifies the ACID to which you are defining the USS entry subdirectory.

/sub1/sub2/…./subn

Specifies a valid USS directory. The first character must always be forward-slash (/). Successive subdirectories in this subdirectory must begin with a forward-slash (/).

Range: 1 to 1024 characters

Note: For information about allowable characters, see the IBM Unix Systems Services Command Reference.

This keyword is used with:

• The commands ADDTO, REMOVE, REPLACE, and WHOHAS
• The ACID types User, DCA, VCA, ZCA, LSCA, and SCA
• ACID(MAINTAIN) authority

Example: Define a USS Subdirectory for an ACID

This example indicates that subdirectory ABC0021 is now connected to USER02:

TSS ADDTO(USER02) HOME(/ABC0021)

Example: Remove a Subdirectory Definition from an ACID

This example removes the connection between a subdirectory and an ACID:

TSS REMOVE(USER02) HOME(/ABC0021)