IBM OS/2 LAN Server REXX Utility DLL


Inf-HTML [About][Toc][Index] 0.9b (c) 1995 Peter Childs


NETHOMEDIR Set Info


The function modifies a home directory definition.   
Syntax 


MyRc = NetSetInfo(NETHOMEDIR, dcName, userId, homeDir)

  
Parameters 
The parameters required are: 
dcName            The computer name of the domain controller 
userId            The name of the userid 
homeDir           The home directory specification. It must respect one of 
                  the following rules: 
    1. homeDir is set to a none value, the home directory is removed 
    2. a drive assignment is required, the homeDir value must include: 

       
         x:\machineID\Y$\pathname
         !  !         !  !
         !  !         !  The path to the home directory
         !  !         The drive on the server holding the home directory
         !  The computer name of the server
         The drive to be assigned
       
       
       For example, the userid home directory has to be located on the 
       server FILESRV on drive D and directory \FILES\USERID. The userid 
       will have the home directory assigned as the Y drive. This requires 
       the following definition of the home directory: 

       Y:\FILESRV\D$\FILES\USERID
       
       
    3. a drive assignment is not required, the homeDir value must include: 
       

       
         \\machineID\Y$\pathname
           !         !  !
           !         !  The path to the home directory
           !         The drive on the server holding the home directory
           The computer name of the server
       
       
       
       For example, the userid home directory has to be located on the 
       server THESRV on drive F and directory \FILES\USERS\SHARED. The 
       userid will have the home directory assigned as the first free 
       drive. This requires the following definition of the home 
       directory: 

       \\THESRV\F$\FILES\USERS\SHARED
       
                  
  
Note 
The dcName can be specified as '' for a local domain controller. 
The administrator is responsible for the following: 
 1. Making sure the home directory exist 
 2. Creating required access to the directory 
 3. Removing a home directory if required 
  
Example   


/* Set a home director for a userid */
call RxFuncAdd 'LoadLsRxutFuncs', 'LSRXUT', 'LoadLsRxutFuncs'
call LoadLsRxutFuncs

NETHOMEDIR = 230
dcName     = '\\ILIDC'
userId     = 'WS222B'
homeDir    = 'Y:\ILIDC\D$\SHARED\FILES'

/* Remove home directory parameter */
/* homeDir    = '' */

MyRc = NetSetInfo(NETHOMEDIR, dcName, userId, homeDir)

if myRc <> '0' then do
 say 'Got error from NetSetInfo() ' myRc
 call DropLsRxutFuncs
 call RxFuncDrop 'LoadLsRxutFuncs'
 exit 9
end
else do
 say
 say "Home directory definition modified successfully"
end

call DropLsRxutFuncs
call RxFuncDrop 'LoadLsRxutFuncs'

exit 0

  
Example Output   


Home directory definition modified successfully



Inf-HTML End Run - Successful