Keywords › HOME Keyword (MODLUSER)—Define a Prototype HOME Subdirectory

HOME Keyword (MODLUSER)—Define a Prototype HOME Subdirectory

Valid on z/OS and z/VM.

Use the HOME keyword to add a prototype HOME directory to an ACID specified by the MODLUSER control option. The specified directory is used for users that do not have an OMVS segment. When a session user attempts to use UNIX Systems Services (USS) but does not have USS credentials, the UNIQUSER and MODLUSER control options dynamically provide the credentials in the user’s ACID. The HOME keyword in a MODLUSER ACID provides a fixed or variable directory name that is copied into the HOME keyword of the session ACID.

This keyword has the following format:

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

acid

Specifies the ACID that you identified with the MODLUSER control option. This ACID contains a model for a default OMVS segment.

/sub1/sub2/…./subn

Specifies one or more valid USS directories. The first character of each specified directory must be a forward-slash (/). Successive subdirectories in this subdirectory must each begin with a forward-slash(/).

Range: 1 to 1024 characters

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

You can use a variable (&acid) to represent a subdirectory. When the USS credentials are copied from the MODLUSER to the OMVS segment of the session ACID, this variable is replaced by the session ACID. When you use this variable, the following rules apply:

• The variable should be used only as a MODLUSER prototype. Do not use the variable in a session ACID.
• Using the variable as the final subdirectory in the HOME directory string makes the value compatible with the USS “automount” generic substitution. If you use the variable in a position other than the final specified subdirectory, or you do not use automount, ensure that the HOME directory generated for the session ACID has been created with appropriate mkdir command and has been primed with appropriate security flags or HFSSEC permissions.

  Note: For information about automount, see the z/OS release UNIX Systems Services Planning Guide.

• Specifying &ACID substitutes an uppercase version of the session ACID. Specifying &acid substitutes a lowercase version of the session ACID.

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: Use a Variable When Defining a Prototype Subdirectory to a MODLUSER ACID

This example indicates that the prototype subdirectory /u/a1/&acid is now connected to MODL02:

TSS ADDTO(MODL02) HOME(/u/a1/&acid)

CA Top Secret will copy OMVS credentials from MODL02 in the following situation:

• UNIQUSER(YES) and MODLUSER(MODL02) are set as control options.
• USER05 has no USS credentials but attempts to perform USS services.

This subdirectory contains the lowercase symbolic variable; therefore, the new HOME for USER05 will be /u/a1/user05.

Example: Define a Specific Prototype Subdirectory to a MODLUSER ACID

This example connects a specific uppercase prototype to MODLUSER ACID MODL02:

TSS ADD(MODL02) HOME(/LIFE/OF/PI)

CA Top Secret will copy OMVS credentials from MODL02 in the following situation:

• UNIQUSER(YES) and MODLUSER(MODL02) are set as control options.
• USER05 has no USS credentials but attempts to perform USS services.

The new HOME for USER05 will be /LIFE/OF/PI.

Example: Remove a HOME Directory Specification from a MODLUSER

To remove a HOME directory specification from a MODLUSER, you may specify HOME with or without an operand. This example shows syntax for both methods:

TSS REMOVE(MODL02) HOME(/LIFE/OF/PI)
TSS REMOVE(MODL02) HOME