Set Customization Data (SETCSTDTA)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Set Customization Data (SETCSTDTA) command can be used to copy and delete information in order to customize data, such as work area content and mouse double-click action values, for Graphical Operations support.

Using this command, administrators can set up users by getting information from a named user profile and copying it to other user profiles. Administrators can also remove the customized values for a named user, and choose to replace those customized values with data from a named user profile.

Note: Do not precede an entry with an asterisk unless that entry is a "special value" that is shown (on the display itself or in the help information) with an asterisk.

Error messages for SETCSTDTA

*ESCAPE Messages

CPF2204
User profile &1 not found.
CPF2217
Not authorized to user profile &1.
GUI0085
&1 does not have customization data.
GUI0087
Some user profiles did not have customization data copied successfully.
GUI0091
Some user profiles did not have customization data deleted successfully.
GUI0117
&1 is not valid for subset key.
Top

Parameters

Keyword Description Choices Notes
USRPRF User profile Values (up to 300 repetitions): Simple name Required, Positional 1
VALUE Customization data to use Simple name, *NONE Required, Positional 2
REPLACE Replace customization data *NO, *YES Optional, Positional 3
Top

User profile (USRPRF)

Specifies the names of the user profiles for which customized values are to be set or removed with the option to set them again. A maximum of 300 user profiles can be named.

You can enter multiple values for this parameter. If you are on an entry display and you need additional entry fields to enter these multiple values, type a plus sign (+) in the entry field opposite the phrase "+ for more", and press the Enter key.

This is a required parameter.

Top

Customization data to use (VALUE)

Specifies the customization data value to which the user profile named on the User profile prompt (USRPRF parameter) is to be set.

The possible values are:

*NONE
The customization data is to be removed from the user profile and no customization value is to be set.
user-profile
Specify the name of the user profile from which the customization value data is to be copied and set.

This is a required parameter.

Top

Replace customization data (REPLACE)

Specifies whether to replace existing customization data if the user profile named on the User profile prompt (USRPRF parameter) has customization data.

The possible values are:

*NO
The existing customization data is not replaced. An exception message is issued.
*YES
The existing customization data is replaced with the customization data from the user profile specified on the Customization data to use prompt (VALUE parameter).
Top

Examples

None
Top

Error messages

*ESCAPE Messages

CPF2204
User profile &1 not found.
CPF2217
Not authorized to user profile &1.
GUI0085
&1 does not have customization data.
GUI0087
Some user profiles did not have customization data copied successfully.
GUI0091
Some user profiles did not have customization data deleted successfully.
GUI0117
&1 is not valid for subset key.
Top