SumTotal Logo
Pathlore Mainframe Site
 
Technical Support
Zaps & Patches
Order Forms
Documentation
Online Documentation

Getting Started

Product Memos

Frequently Asked
Questions


Technical Tips
Product Suggestions



Technical Tips

How to remove PHOENIX users from a course no longer on my system

With the introduction of PHOENIX release 7.9.0 the PHOENIX Course Manager facility was added.  Two of the new features under this facility are “List Users Registered to Nonexistent Programs” and “List Nonexistent Programs with Registered Users”.  These features will provide the supervisor with a list of old GSPUSER file entries (orphaned user-IDs) that were not deleted before the corresponding course was removed from the system.

To prevent the creation of orphaned users on a PHOENIX system an author should perform the following before removing the course from the system:

  1. Sign on as a supervisor.

  2. From the Type Command Line type "a (course name)" and press ENTER to go into author mode on the course to be removed.

  3. From the main author menu select “7  Administer course”

  4. From the “COURSE ADMINISTRATION” menu select “F2  Delete a class”.

  5. From the “Classes Allocated” list delete each allocated class by entering the class number into “Class to be deleted".  Also ensure that the “Remove student records” flag is set to “Y” before pressing ENTER.

  6. When all classes have been removed, then all students have now been removed.

  7. Press "F3 End" to return to the main author  menu and again to return to the Type Command Line.

  8. Enter "ss all" and press ENTER. All students should be deleted.  However, there may still be instructors or authors registered to the course.  Record the listed user-IDs.

  9. Type "ease" and press ENTER.

  10. From the author menu press "F9  Administer users"

  11. Respond to "Which class do you want (00 - 99)?" with "0" and press ENTER

  12. .
  13. Use "F9 Instructors and F10 Authors" to remove the remaining author and instructor user-IDs.

  14. Exit from the author menu back to the type command line remaining in author mode on the selected course.

  15. Enter "ss all" and press ENTER. All users should now be deleted.  If any author/instructors were missed, enter "ease", press ENTER and go to step 10 above.

Now that we know how to prevent the situation, how do we cleanup the GSPUSER file when we have neglected to remove the users before removing the program?  The solution below shows both how to get a list of orphaned user-IDs and how to remove them.  The general idea is to re-register the program as a non-ease course and remove the students using supervisor commands.  Removing authors and instructors involves a bit more work.  The procedure follows:

  1. Sign on to the PHOENIX system as a supervisor.

  2. If you are at the “Type Command Line”, enter “menu” to go to the “Supervisor Main Menu”.

  3. Select “F13 PHOENIX Course Manager”.

  4. Select “USERS INACTIVE” with an “x” and pressing ENTER.

  5. Select “NONEXISTENT PROGRAMS WITH REGISTERED USERS” with an “x” and pressing ENTER.  Record the list of nonexistent programs.

  6. Perform the following steps for each course on the “list of nonexistent programs”.

  7. From the "Type Command Line" re-register (course name)

  8. Enter "a (course name)" and press ENTER

  9. Enter "rms" and press ENTER.

  10. When prompted with "ENTER DELETE OPTIONS ->" enter "all" and press ENTER.

  11. You should receive a response such as “4 STUDENTS REMOVED.  etc.” with a prompt to “ENTER DELETE OPTIONS ->”.  Enter "end" and press ENTER.

  12. Enter "ss all" and press ENTER.  All students should be deleted.  However, there may still be instructors or authors registered to the course.  Record the listed user-IDs.

  13. Enter "ease" and press ENTER.

  14. Respond to "DO YOU WANT TO WRITE A CMI OR CAI COURSE" prompt with "cai" and press ENTER.

  15. Respond to "(course name) IS TO BE SET UP AS A CAI COURSE. OK TO VERIFY." with "ok" and press ENTER.

  16. From the author menu press F9  Administer users

  17. Respond to "Which class do you want (00 - 99)?" with "0" and press ENTER

  18. .
  19. Use "F9 Instructors and F10 Authors" to remove the remaining author and instructor user-IDs.

  20. Exit from the author menu back to the type command line remaining in author mode on the selected course.

  21. Enter "ss all" and press ENTER. All users should now be deleted.  If any author/instructors were missed, enter "ease", press ENTER and go to step 16 above.

  22. Remove the course by entering "remove program (course name)".

 

 

Submit your product suggestion.



Order Your Upgrade Today!


 

Click here to order a free PHOENIX/PREFERENCE documentation CD.