Use the RACONVRT command as an aid in converting from SYS1.UADS to the RACF® data base. During the conversion process, RACONVRT does not migrate the TSO command that was specified on the previous logon. Therefore, the command field in the logon panel contains no data the first time the user logs on after the conversion is complete. If the user specifies a command in the TSO command field on the logon panel, TSO/E saves that command for the next logon. For detailed information about the command, see z/OS TSO/E Customization.

The syntax of the RACONVRT command is:

• All parameters are keyword parameters.
• RACONVRT is an authorized command.
• If RACF is installed and active, you require RACF SPECIAL authority to issue the command.
• If RACF is not installed or active, you require ACCOUNT authority to issue the command.

ALL

Convert all entries in SYS1.UADS to the RACF data base

When converting a large number of entries, the system may not be able to obtain enough storage to process all entries. RACONVRT processing then terminates with a message. It is, therefore, recommended to issue several RACONVRT commands with the INCLUDE/ EXCLUDE parameters whenever a large number of entries are to be converted.

INCLUDE

Convert the specified entries (user IDs) in SYS1.UADS to the RACF data base

EXCLUDE

Do not convert the specified entries (user IDs) in SYS1.UADS to the RACF data base; however, convert all those not specified

userid

The user ID of an existing entry in SYS1.UADS that you are converting to the RACF data base

userid:userid

A range of user IDs of existing entries in SYS1.UADS that you are converting to the RACF data base

value:

 

1. 1-7 alphanumeric characters, beginning with an alphabetic or special character
2. 1-6 alphanumeric characters, beginning with an alphabetic or special character and appended with an asterisk (*) - a set of user IDs

If a user ID has not logged on and off since changes were made to its SYS1.UADS entry, RACONVRT will not include an account number or procedure in the ADDUSER or ALTUSER command for that user ID. When a user ID logs off, the default account number and procedure are saved in SYS1.UADS. RACONVRT uses these defaults when creating the ADDUSER or ALTUSER command to add the user ID to RACF. If the user ID has not logged on and off since changes were made to SYS1.UADS, then defaults do not exist for the user ID in SYS1.UADS. This causes RACONVRT to create an ADDUSER or ALTUSER command without the ACCT or PROC operands.