Skip to main contentIBM ZLPN Documentation

Executing ADDUROM to Define a NEW TSO User ID

"ADDUROM" is a rexx exec/clist written to more easily define/add TSO Userids to your IIC-Dallas z/OS system. The following information is a step by step process to help.

Note: The userids contained in the initial documents you were sent are “NOT TSO USER IDs”. If you have not already defined TSO ids on your z/OS system, use the z/OS userid “IBMUSER” with the initial password of “IBMUSER” to logon to TSO to define new TSO userids. If for some reason you cannot logon using “IBMUSER” because the password is incorrect, then from the userid you used to IPL/Boot your system issue the following command:

send YourzOSGuest \cp vinput vmsg s racfur

This command resets the password for “IBMUSER” to “IBMUSER”. You should then be able to logon to TSO using the “IBMUSER” TSO userid.

  1. On "ISPF Primary Option Menu" "Option ===>":

    • Type 6 then hit enter proceed to the "ISPF Command Shell" panel where you can enter TSO or Workstation commands.

  2. On the "ISPF Command Shell" panel "===>"

    • type the ADDUROM command.

  3. You will receive a message about this command.

This message provides. some general information about what you are about to do and about this command Please read it for information which may affect you. We are constantly changing to better accommodate your IIC-Dallas experience.

Messages and prompts take several screens. When a TSO session screen is full you will notice "***" at the lower left of the screen, simply hit enter to continue to the next screen. Remember you will be prompted for information so make sure you do not inadvertently clear your screen and miss a prompt.

  1. Once you reach the end of this info message, if you want to continue, enter Y.

The next sections represent the prompts you will receive to create your new UserID

Please enter userid.

  1. Type the TSO userid you wish to add to your system.

    THE NEW ID MUST BE SEVEN CHARACTERS in length due to security requirements

    ==> userid1

Please enter the user name.

  1. This is the name name of the user you are adding. It will be truncated to 25 characters.

    ==> John Doe

Please enter the default group.

  1. Our default group is "GROUP1." use this group.

    ==> group1

Please enter the TSO account number.

  1. Our default account number is "FB3" use this account number.

    ==> fb3

Please enter the TSO procedure name.

  1. If you have created a "WORKING" TSO logon procedure name or have been told to use a specific procedure name, then simply input that procedure name, otherwise use SPFPROCE

    If you do not enter a "WORKING START PROC" then this user will NOT be able to logon to TSO.

    ==> spfproce

If this user should be SYSTEM SPECIAL enter a Y.

  1. Users with the "SPECIAL" attribute have authority to add or modify security attributes. Since our environment is NOT a productions environment type Y unless there is a reason you do not want this userid to have this authority.

    Otherwise hit ENTER to continue.

    ==> y

    OR hit Enter

If this user should be SYSTEM OPERATIONS enter a Y.

  1. Users with the "OPERATIONS" attribute have more restricted security attributes. If you already have "SPECIAL" then this attribute is not required. What this attribute does allow is access to all datasets regardless of racf security for these datasets.

    Otherwise hit ENTER to continue.

    ==> y

    OR hit Enter

If this user should have access to OpenEdition MVS enter a Y.

  1. OpenEdition (OMVS) is also know as Unix System Services (USS) for z/OS. If this userid will be using USS then type "Y",

    Otherwise hit ENTER to continue.

    ==> y

    OR hit Enter

Please enter the OpenEdition UID.

Note: The OpenEdition UID must be a positive integer from 0 to 2147483647. More than one TSO userid may have the same OpenEdition UID.

  1. A UID of 0 (zero) indicates a superuser with special security privileges that will bypass all security checks in OpenEdition.

    Select the appropriate UID for this userid. Because this is NOT a production environment we use 0

    ==> 0

Please enter the OpenEdition HOME directory.

Note: The OpenEdition HOME directory is the user's initial directory pathname, which will be the current working directory when the user enters the OpenEdition environment via the OMVS command or BPXBATCH. The default is "/" (root directory).

Note: This program does NOT create the home directory.

  1. Remember USS is case sensitive. The currently defined /u directory is very small. If you have not done so we recommend you define a Hierarchical File system or zFS file system large enough to support the files you will be creating. You can them create a directory under the root and mount your file system there for your userid.

    Otherwise use /u as the base user directory.

    ==> /u/userid1

Please enter the OpenEdition PROGRAM name (shell name).

Note: The OpenEdition PROGRAM name is the path name of the shell program to be run when entering the OpenEdition environment via the OMVS command or BPXBATCH. A system default shell will be used if you do not specify a name here.

  1. Please use /bin/sh

    ==> /bin/sh

  2. You will then see the command used to define this userid:

113 *-* "ADDUSER" USERP NAMEP GRPP TSOP REST OMVS >>> "ADDUSER ( USERID1 )
PASSWORD( USERID1 ) NAME('JOHN DOE ') DFLTGRP( GROUP1 ) OWNER( GROUP1 ) TSO (
ACCTNUM( FB3 ) PROC( SPFPROCE ) SIZE(100000) UNIT(SYSDA)) SPECIAL OPERATIONS
OMVS(UID(0) HOME('/u/userid1') PROGRAM('/bin/sh'))"

  1. If this user should be added to the SYS1.UADS dataset enter a Y

    • The userid does not need to be added to SYS1.UADS. Simply hit Enter

  2. If this user should be added as an alias to the master catalog so all user datasets will be cataloged a user catalog please enter a Y.

    The is the recommended definition.

    ==> y

  3. The default user catalog is CATALOG.USERAA . If you want to change this name please type your new name and press the enter key. Otherwise, just press the enter key.

    If you have not define your own user catalog and wish to use the default, simply hit ENTER. Otherwise type the name of your user catalog and then hit Enter.

  4. Your will then see the command used to define the alias.

"DEFINE ALIAS (NAME('USERID1') RELATE('CATALOG.USERAA'))"

Do you want to add another userid?
  1. Finally, you will see the prompt to create another new user. Enter Y to continue - anything else to stop.