Specifications

44 IBM System z Personal Development Tool: Volume 3 Additional Topics

3.11 Enabling TSO users for OMVS

Current releases of the z/OS AD system provide “built-in” userids such as ADCDA, ADCDB,

ADCDC, and so forth. For some releases these userids are not enabled for Unix System

Services (also known as OMVS). You can enable these userids with the steps described

here.

Logon to TSO as ibmuser or adcdmst. These two userids have RACF® SPECIAL authority.

Issue the following command from the TSO READY prompt or from ISPF option 6:

alg test omvs(gid(100))

For current AD systems, the ADCDx userids are in RACF group TEST. This command

assigns Unix System Services group ID 100 to the RACF group named test. OMVS users

must be a member of a valid OMVS group and this command creates the needed OMVS

group. Group ID 100 is arbitrary and could be any unassigned group number.

Next, issue a TSO command such as the following:

alu adcde omvs(uid(105) program(/bin/sh) home(/u/adcde))

In this example, we are enabling userid adcde for OMVS usage; this could be any one of the

existing userids in the AD system. We are assigning uid 105 for this user. This number is

arbitrary, provided it does not duplicate an existing OMVS uid number in your system. For

simplicity, we often assign OMVS uids using this pattern:

USER UID

adcda 101

adcdb 102

adcdc 103

adcdd 104

etc etc

There is no requirement to use this pattern, but it is a convenient way to avoid duplicating

numeric uids for the built-in users in the AD system.

The last step is to invoke OMVS, using a userid that is already valid for OMVS. This step is

easier if the userid is a superuser (with numeric uid 0). Users ibmuser and adcdmst have this

characteristic in recent AD releases. From the OMVS prompt issue commands such as:

mkdir /u/adcde

This command creates a Unix System Services home directory for user adcde. A home

directory is needed in order to log into Unix System Services with the OMVS command.

Once the user is enabled for Unix System Services functions, one of the following methods

can be used to begin using Unix System Services:

1. Log on to TSO (using a 3270 emulator) and enter an omvs command from the READY

prompt or from ISPF option 6. This produces a common UNIX shell environment, adapted

to 3270 terminals.

2. Log on to TSO (using a 3270 emulator) and enter an ish command from ISPF option 6.

This produces a UNIX shell that is unique to z/OS and 3270 terminals.

3. Assuming you have connectivity to z/OS TCP/IP from your PC Linux system, you can use

a command (from a Linux command window) such as telnet 10.1.1.2 1023 to connect

directly to Unix System Services. The IP address in the command (10.1.1.2 in this

z/OS can also provide automatic UID numbers for Unix System Services users, but this may require additional

setup that is beyond the scope of these brief instructions.