• The Four Hundred
  • Subscribe
  • Media Kit
  • Contributors
  • About Us
  • Contact
Menu
  • The Four Hundred
  • Subscribe
  • Media Kit
  • Contributors
  • About Us
  • Contact
  • Admin Alert: More On Porting User Profiles Between IBM i Partitions

    August 13, 2014 Joe Hertvik

    After receiving reader email about my recent tip on how to port IBM i user profiles from one partition to another, I found there were two items that deserved more explanation and correction: 1) Restoring user profiles for multiple users; and 2) related parameters and objects that a restored profile needs. Here are some corrections and additional information that fill in the gaps that were missing from my previous article.

    Correcting How To Use RSTAUT For Multiple Restored User Profiles

    Reader David Miller asked me to clarify what I meant when I said the following about restoring private authorities for restored user profiles by using the Restore Authority (RSTAUT) command.

    Unlike the RSTUSRPRF command, RSTAUT will only restore authorities for one user at a time, meaning you’ll have to run one RSTAUT command for each profile you’re restoring. You can’t restore authorities for multiple user profiles or wildcard profile names.

    My mistake was in saying that you aren’t able to run one RSTAUT command to restore all private authorities for multiple users that were ported from one partition to another.

    I was wrong. You can do it.

    After looking at the command again, I realized that you can restore private authorities for all the users you ported between machines with one RSTAUT command.

    Here’s how to do it.

    David Miller pointed out that he has used RSTAUT in this capacity several times and that when he runs RSTAUT with no parameters, it restores all user profile authority with one brush stroke.

    When you run RSTAUT with no parameters, your IBM i system actually runs the following command.

    RSTAUT USRPRF(*ALL)
    

    According to IBM‘s RSTAUT documentation, running the command with the user profile parameter equal to *ALL will restore private authorities for “all of the user profiles that are restored but do not have their private authorities restored. This includes user profiles that were restored using multiple previous Restore User Profile (RSTUSRPRF) commands.”

    Correcting my previous statement, this means you can do the following when moving multiple user profiles from one partition to another.

    1. Use several Restore User Profile (RSTUSRPRF) commands to restore one or more user profiles from a source system to a target system.
    2. Use one RSTAUT USRPRF(*ALL) command on your target system, to restore all the private authorities for each of the user profiles you restored in step 1. Per IBM, this will allow you to restore all of the authorities for the profiles that were restored. No other private authority restoration will be performed.

    In addition, RSTAUT offers two more features for restoring private authorities for multiple user profiles. You can restore authorities for a specific list of restored user profiles by running RSTAUT this way.

    RSTAUT USRPRF(USER1 USER2 USER3 etc)
    

    Where user1, user2, user3 would be equal to exact user names.

    Using this syntax, you can specify an exact list of users to restore private authorities for. And RSTAUT will only restore private authorities for the users who are specifically listed in this command.

    You can also specify wildcard characters when restoring private authorities. Simply run RSTAUT using this syntax.

    RSTAUT USRPRF(USER*)
    

    This command will restore private authorities for any user profile that starts with the wildcard string ending in an ‘*”. For this command, RSTAUT would restore private authorities for any user profile name that starts with the string USER.

    My apologies for this mistake in my original article. You can restore private authorities for multiple user profiles using just one command, as I learned this week from David Miller.

    What A Restored User Profile Needs

    Another reader checked in asking what I was referring to as the last step in restoring a user profile to a new system: checking referenced parameters inside a restored profile to see if the profile refers to any objects that aren’t present on the new system. He asked for further explanation as to what I meant when I referred to “parameters inside a restored user profile.”

    All user profiles have a number of parameters that refer to other objects on the partition. These referenced objects may or may not be present on your target machine when you restore a user profile.

    Because of this, you should use the Change User Profile (CHGUSRPRF) command or the IBM i Access for Windows’ System i Navigator program (OpsNav) to double-check that the following user profile parameters in your restored profiles are present on your target machine. A restored user profile may have trouble signing on if it references a parameter that doesn’t exist on your target partition.

    For restored profiles, check these user profile parameters to make sure they reference valid IBM i objects on your target system.

    • Initial program to call (INLPGM)–The program called when a user profile starts an interactive session on your IBM i partition.
    • Initial menu (INLMNU)–The initial menu that the user sees after signing on to an interactive session.
    • Job description (JOBD)–The job description that’s used for jobs that start through subsystem work station entries, using this profile.
    • Message queue (MSGQ)–The message queue assigned to the user profile where messages about the signed-on profile are sent.
    • Attention program (ATNPGM)–The program that interactive sessions use when the user presses the Attention (ATTN) key.

    If you’re restoring a profile for your DR system, this may not be an issue as all of these referenced parameters may already be present on both the DR box (target) and on the source box. But if you’re porting a profile that has never been present on the target system, you may need to recreate one or more of these objects that the restored profile is pointing to or change the user profile to point to another object that is present on your system.

    Generally, you should review any restored user profiles and check all parameters that reference a library to see if those values are still valid.

    Why Not Use A Third-Party Package For Porting Users?

    One vendor wrote in asking why I didn’t discuss using a third-party package for porting profiles between partitions. He stated that his product and several competitors’ products allow you to easily move profiles between partitions and provide additional capabilities. The question was why I didn’t bring up those products.

    While I like and use several third-party products, I only occasionally mention and advocate their use in my Four Hundred Guru columns. The Admin Alert column and my Four Hundred Guru tips provide techniques that can be used by all IBM i administrators. I’m writing admin tips for everyone using only the common tools that IBM provides: the commands, APIs, and configurations included with the IBM i operating system along with some free utilities IBM provides. This creates a do-it-yourself (DIY) focus for Admin Alert that spotlights native solutions and mostly precludes the use of third-party packages.

    While I love and use several third-party packages myself, this column will continue to mainly focus on DIY solutions that are accessible to all IBM i shops. As appropriate, I’ll mention third-party packages for particular solutions but overall, most solutions are do-it-yourself affairs that all IBM i administrators can use.

    Joe Hertvik is an IBM i subject matter expert (SME) and the owner of Hertvik Business Services, a content strategy company that provides white papers, case studies, blogging, and social media services for B2B software companies. Joe also runs a data center and help desk for several companies. Joe has written the Admin Alert column since 2002.

    RELATED STORY

    Porting A User Profile From One IBM i Machine To Another



                         Post this story to del.icio.us
                   Post this story to Digg
        Post this story to Slashdot

    Share this:

    • Reddit
    • Facebook
    • LinkedIn
    • Twitter
    • Email

    Tags:

    Sponsored by
    Raz-Lee Security

    Protect Your IBM i and/or AIX Servers with a Free Virus Scan

    Cyber threats are a reality for every platform, including IBM i and AIX servers. No system is immune, and the best defense is prompt detection and removal of viruses to prevent costly damage. Regulatory standards across industries mandate antivirus protection – ensure your systems are compliant and secure.

    Get My Free Virus Scan

    Share this:

    • Reddit
    • Facebook
    • LinkedIn
    • Twitter
    • Email

    Sponsored Links

    Linoma Software:  FREE Webinar: Managed File Transfer 101.
    System i Developer:  Upgrade your skills at the RPG & DB2 Summit in Minneapolis, Sept 30 - Oct 2.
    COMMON:  Join us at the COMMON 2014 Fall Conference & Expo in Indianapolis, Oct 27-29

    More IT Jungle Resources:

    System i PTF Guide: Weekly PTF Updates
    IBM i Events Calendar: National Conferences, Local Events, and Webinars
    Breaking News: News Hot Off The Press
    TPM @ EnterpriseTech: High Performance Computing Industry News From ITJ EIC Timothy Prickett Morgan

    IBM Cooks Up Online Consultant Shopping Power8 Packs More Punch Than Expected

    Leave a Reply Cancel reply

Volume 14, Number 18 -- August 13, 2014
THIS ISSUE SPONSORED BY:

SEQUEL Software
WorksRight Software
QUERY FILE for IBM i

Table of Contents

  • The Geezer’s Guide to Free-Form RPG, Part 5: File Definitions
  • Do It Now!
  • Admin Alert: More On Porting User Profiles Between IBM i Partitions

Content archive

  • The Four Hundred
  • Four Hundred Stuff
  • Four Hundred Guru

Recent Posts

  • POWERUp 2025 –Your Source For IBM i 7.6 Information
  • Maxava Consulting Services Does More Than HA/DR Project Management – A Lot More
  • Guru: Creating An SQL Stored Procedure That Returns A Result Set
  • As I See It: At Any Cost
  • IBM i PTF Guide, Volume 27, Number 19
  • IBM Unveils Manzan, A New Open Source Event Monitor For IBM i
  • Say Goodbye To Downtime: Update Your Database Without Taking Your Business Offline
  • i-Rays Brings Observability To IBM i Performance Problems
  • Another Non-TR “Technology Refresh” Happens With IBM i TR6
  • IBM i PTF Guide, Volume 27, Number 18

Subscribe

To get news from IT Jungle sent to your inbox every week, subscribe to our newsletter.

Pages

  • About Us
  • Contact
  • Contributors
  • Four Hundred Monitor
  • IBM i PTF Guide
  • Media Kit
  • Subscribe

Search

Copyright © 2025 IT Jungle