Change Profile (CHGPRF)

Where allowed to run: All environments (*ALL)
Threadsafe: No

The Change Profile (CHGPRF) command allows a user to change some of the values currently specified in the user profile.

Restrictions:

You must have object management (*OBJMGT) and use (*USE) authority to the user profile being changed.
You must have *USE authority to the current library, program, menu, job description, message queue, print device, output queue, and the ATTN key handling program if changing any of those user profile values.

Parameters

Keyword	Description	Choices	Notes
ASTLVL	Assistance level	SAME, SYSVAL, BASIC, INTERMED, *ADVANCED	Optional
CURLIB	Current library	Name, SAME, CRTDFT	Optional
INLPGM	Initial program to call	Single values: SAME, NONE Other values: Qualified object name	Optional
	Qualifier 1: Initial program to call	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
INLMNU	Initial menu	Single values: SAME, SIGNOFF Other values: Qualified object name	Optional
	Qualifier 1: Initial menu	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
TEXT	Text 'description'	Character value, SAME, BLANK	Optional
KBDBUF	Keyboard buffering	SAME, SYSVAL, NO, TYPEAHEAD, *YES	Optional
JOBD	Job description	Single values: *SAME Other values: Qualified object name	Optional
	Qualifier 1: Job description	Name, QDFTJOBD
	Qualifier 2: Library	Name, LIBL, CURLIB
DOCPWD	Document password	Name, SAME, NONE	Optional
MSGQ	Message queue	Single values: SAME, USRPRF Other values: Qualified object name	Optional
	Qualifier 1: Message queue	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
DLVRY	Delivery	SAME, NOTIFY, BREAK, HOLD, *DFT	Optional
SEV	Severity code filter	0-99, *SAME	Optional
PRTDEV	Print device	Name, SAME, WRKSTN, *SYSVAL	Optional
OUTQ	Output queue	Single values: SAME, WRKSTN, *DEV Other values: Qualified object name	Optional
	Qualifier 1: Output queue	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
ATNPGM	Attention program	Single values: SAME, NONE, SYSVAL, ASSIST Other values: Qualified object name	Optional
	Qualifier 1: Attention program	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
SRTSEQ	Sort sequence	Single values: SAME, SYSVAL, HEX, LANGIDSHR, *LANGIDUNQ Other values: Qualified object name	Optional
	Qualifier 1: Sort sequence	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
LANGID	Language ID	Character value, SAME, SYSVAL	Optional
CNTRYID	Country or region ID	Character value, SAME, SYSVAL	Optional
CCSID	Coded character set ID	Integer, SAME, SYSVAL, *HEX	Optional
CHRIDCTL	Character identifier control	SAME, SYSVAL, DEVD, JOBCCSID	Optional
SETJOBATR	Locale job attributes	Single values: SAME, SYSVAL, NONE Other values (up to 6 repetitions): CCSID, DATFMT, DATSEP, DECFMT, SRTSEQ, *TIMSEP	Optional
LOCALE	Locale	Path name, SAME, NONE, SYSVAL, C, *POSIX	Optional
USROPT	User options	Single values: SAME, NONE Other values (up to 7 repetitions): CLKWD, EXPERT, ROLLKEY, NOSTSMSG, STSMSG, HLPFULL, *PRTMSG	Optional
HOMEDIR	Home directory	Path name, USRPRF, SAME	Optional

Top

Assistance level (ASTLVL)

Specifies which user interface to use.

*SAME: The value does not change.

*SYSVAL: The assistance level defined in the system value QASTLVL is used.

*BASIC: The Operational Assistant user interface is used.

*INTERMED: The system interface is used.
*ADVANCED: The expert system interface is used. To allow for more list entries, option keys and function keys are not displayed. If a command does not have an advanced (*ADVANCED) level, the intermediate (*INTERMED) level is used.

Top

Current library (CURLIB)

Specifies the name of the current library associated with the job being run.

Specifies the name of the library to be used as the current library for this user. If *PARTIAL or *YES is specified for the Limit capabilities (LMTCPB) parameter of the Create User Profile (CRTUSRPRF) or Change User Profile (CHGUSRPRF) command, the user cannot change the current library at sign-on or with the Change Profile (CHGPRF) command.

*SAME: The value does not change.

*CRTDFT: This user has no current library. The library QGPL is used as the default current library.

name: Specify the name of the library to use as the current library for this user.

Top

Initial program to call (INLPGM)

Specifies, for an interactive job, the program called whenever a new routing step is started that has QCMD as the request processing program. If *PARTIAL or *YES is specified for the Limit capabilities (LMTCPB) parameter, the program value cannot be changed at sign on or by using the Change Profile (CHGPRF) command. No parameters can be passed to the program.

A System/36 environment procedure name can be specified as the initial program if the procedure is a member of the file QS36PRC (in the library list or specified library) and if either of the following conditions are true:

*S36 is specified on the SPCENV parameter.
*SYSVAL is specified on the SPCENV parameter and the system value, QSPCENV, is *S36.

Single values

*SAME: The value does not change.

*NONE: No program is called when the user signs on. If a menu name is specified in the Initial menu (INLMNU) parameter, that menu is displayed.

Qualifier 1: Initial program to call

name: Specify the name of the program that is called when the user signs on.

Qualifier 2: Library

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB: The current library for the job is used to locate the program. If no library is specified as the current library for the job, QGPL is used.
name: Specify the name of the library where the initial program is located.

Top

Initial menu (INLMNU)

Specifies the initial menu displayed when the user signs on the system if the user's routing program is the command processor QCMD. If *YES is specified for the Limit capabilities (LMTCPB) parameter, the user cannot change the menu either at sign-on or with the Change Profile (CHGPRF) command.

A System/36 environment menu can be specified as the initial menu if either of the following conditions are true:

*S36 is specified for the Special environment (SPCENV) parameter.
*SYSVAL is specified on the SPCENV parameter and the system value, QSPCENV, is *S36.

Single values

*SAME: The value does not change.

*SIGNOFF: The system signs off the user when the program completes. This is intended for users authorized only to run the program.

Qualifier 1: Initial menu

name: Specify the name of the initial menu called after the user signs on the system.

Qualifier 2: Library

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB: The current library for the job is used to locate the menu. If no library is specified as the current library for the job, QGPL is used.
name: Specify the nameof the library where the initial menu is located.

Top

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*SAME: The value does not change.

*BLANK: No text is specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Top

Keyboard buffering (KBDBUF)

Specifies the keyboard buffering value to be used when a job is initialized for this user profile. If the type-ahead feature is active, you can buffer your keyboard strokes. If the attention key buffering option is active, the attention key is buffered as any other key. If it is not active, the attention key is not buffered and is sent to the system even if the display station is input-inhibited. This value can also be set by a user application. More information is in the APIs topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.

*SAME: The value does not change.

*SYSVAL: The system value, QKBDBUF, is used to determine the keyboard buffering value.

*NO: The type-ahead feature and attention key buffering option are not active.
*TYPEAHEAD: The type-ahead feature is active, but the attention key buffering option is not.
*YES: The type-ahead feature and attention key buffering option are active.

Top

Job description (JOBD)

Specifies the job description used for jobs that start through subsystem work station entries. If the job description does not exist when the user profile is created or changed, a library qualifier must be specified, because the job description name is kept in the user profile.

Single values

*SAME: The value does not change.

Qualifier 1: Job description

name: Specify the name of job description used for the work station entries whose job description parameter values indicate the user JOBD(*USRPRF).

Qualifier 2: Library

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB: The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is used.
name: Specify the name of the library to be searched.

Top

Document password (DOCPWD)

Specifies the document password that allows Document Interchange Architecture (DIA) document distribution services users protect personal distributions from being used by people who work on their behalf.

*SAME: The value does not change.

*NONE: No document password is used by this user.

name: Specify the document password to be assigned to this user. The password must range from 1 through 8 alphanumeric characters (letters A through Z and numbers 0 through 9). The first character of the document password must be alphabetic; the remaining characters can be alphanumeric. Embedded blanks, leading blanks, and special characters are not valid.

Top

Message queue (MSGQ)

Specifies the message queue to which messages are sent.

Note: The message queue is created, if it does not already exist. The user profile specified for the User profile (USRPRF) parameter is the owner of the message queue.

Single values

*SAME: The value does not change.

*USRPRF: A message queue with the same name as that specified for the USRPRF parameter is used as the message queue for this user. This message queue is located in the QUSRSYS library.

Qualifier 1: Message queue

name: Specify the name of the message queue to be used with this profile.

Qualifier 2: Library

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB: The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is used.
name: Specify the name of the library to be searched.

Top

Delivery (DLVRY)

Specifies how messages are sent to the message queue for this user are to be delivered.

*SAME: The value does not change.

*NOTIFY: The job to which the message queue is assigned is notified when a message arrives at the message queue. For interactive jobs at a work station, the audible alarm is sounded (if the alarm feature is set) and the Message Waiting light is turned on. The delivery mode cannot be changed to *NOTIFY if the message queue is also being used by another job.

*HOLD: The messages are held in the message queue until they are requested by the user or program.
*BREAK: The job to which the message queue is assigned is interrupted when a message arrives at the message queue. If the job is an interactive job, the audible alarm is sounded (if the alarm feature is set). The delivery mode cannot be changed to *BREAK if the message queue is also being used by another job.
*DFT: The default reply to the inquiry message is sent. If no default reply is specified in the message description of the inquiry message, the system default reply, *N, is used.

Top

Severity code filter (SEV)

Specifies the lowest severity code that a message can have and still be delivered to a user in break or notify mode. Messages arriving at the message queue whose severities are lower than the severity code specified for this parameter do not interrupt the job or turn on the audible alarm or the message-waiting light; they are held in the queue until they are requested by using the Display Message (DSPMSG) command. If *BREAK or *NOTIFY is specified for the Delivery (DLVRY) parameter, and is in effect when a message arrives at the queue, the message is delivered if the severity code associated with the message is equal or greater then the value specified here. Otherwise, the message is held in the queue until it is requested.

*SAME: The value does not change.

0-99: Specify a severity code ranging from 00 through 99.

Top

Print device (PRTDEV)

Specifies the default printer device for this user. If the printer file used to create printed output specifies to spool the data, the spooled file is placed on the device's output queue, which is named the same as the device.

Note: This assumes the defaults are specified for the Output queue (OUTQ) parameter for the printer file, job description, user profile and workstation.

*SAME: The value does not change.

*WRKSTN: The printer assigned to the user's work station is used.

*SYSVAL: The value specified in the system value QPRTDEV is used.
name: Specify the name of a printer that is to be used to print the output for this user.

Top

Output queue (OUTQ)

Specifies the output queue to be used by this user profile. The output queue must already exist when this command is run.

Single values

*SAME: The value does not change.

*WRKSTN: The output queue assigned to the user's work station is used.

*DEV: The output queue associated with the printer specified for the Print device (PRTDEV) parameter is used. The output queue has the same name as the printer. (The printer file DEV parameter is determined by the CRTPRTF, CHGPRTF, or the OVRPRTF command).
Note: This assumes the defaults are specified for the Output queue (OUTQ) parameter for the printer file, job description, user profile and workstation.

Qualifier 1: Output queue

name: Specify the name of the output queue to be used by this user profile.

Qualifier 2: Library

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB: The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is used.
name: Specify the name of the library to be searched.

Top

Attention program (ATNPGM)

Specifies the program to be used as the Attention (ATTN) key handling program for this user. The ATTN key handling program is called when the ATTN key is pressed during an interactive job. The program is active only when the user routes to the system-supplied QCMD command processor. The ATTN key handling program is set on before the initial program (if any) is called and it is active for both program and menu. If the program changes the ATNPGM (by using the SETATNPGM command), the new program remains active only for the duration of the program. When control returns and QCMD calls the menu, the original ATTN key handling program becomes active again. If the SETATNPGM command is run from the menus or an application is called from the menus, the new ATTN key handling program that is specified overrides the original ATTN key handling program. If *YES or *PARTIAL is specified for the Limit capabilities (LMTCPB) parameter on the Create User Profile (CRTUSRPRF) or Change User Profile (CHGUSRPRF) command, the ATTN key handling program cannot be changed.

Single values

*SAME: The value does not change.

*SYSVAL: The system value QATNPGM is used.

*NONE: No ATTN key handling program is used by this user.
*ASSIST: The Operational Assistant ATTN key handling program, QEZMAIN, is used.

Qualifier 1: Attention program

name: Specifies the name of the ATTN key handling program to be used for this user profile.

Qualifier 2: Library

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB: The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is used.
name: Specify the name of the library to be searched.

Top

Sort sequence (SRTSEQ)

Specifies the sort sequence table to be used for string comparisons for this profile.

Single values

*SAME: The value does not change.

*SYSVAL: The system value QSRTSEQ is used.

*HEX: A sort sequence table is not used. The hexadecimal values of the characters are used to determine the sort sequence.
*LANGIDUNQ: A unique-weight sort table is used.
*LANGIDSHR: A shared-weight sort table is used.

Qualifier 1: Sort sequence

name: Specify the name of the sort sequence table to be used with this profile.

Qualifier 2: Library

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB: The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is used.
name: Specify the name of the library to be searched.

Top

Language ID (LANGID)

Specifies the language identifier to be used for this user.

*SAME: The value does not change.

*SYSVAL: The system value QLANGID is used.

language-identifier: Specify the language identifier to be used. More information on valid language identifiers is in the i5/OS globalization topic collection in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/ .

Top

Country or region ID (CNTRYID)

Specifies the country or region identifier to be used for this user.

*SAME: The value does not change.

*SYSVAL: The system value QCNTRYID is used.

character-value: Specify a country or region identifier. To see a complete list of identifiers when prompting this command, position the cursor on the field for this parameter and press F4 (Prompt).

Top

Coded character set ID (CCSID)

Specifies the coded character set identifier (CCSID) to be used for this user.

A CCSID is a 16-bit number identifying a specific set of encoding scheme identifiers, character set identifiers, code page identifiers, and additional coding-related information that uniquely identifies the coded graphic representation used.

Note: If the value for CCSID is changed, the change does not affect jobs that are currently running.

*SAME: The value does not change.

*SYSVAL: The system value QCCSID is used.

*HEX: The CCSID 65535 is used.
identifier: Specify the CCSID to be used for this user profile. More information on valid CCSIDs is in the Globalization information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/infocenter.

Top

Character identifier control (CHRIDCTL)

Specifies the character identifier control (CHRIDCTL) for the job. This attribute controls the type of coded character set identifier (CCSID) conversion that occurs for display files, printer files and panel groups. The *CHRIDCTL special value must be specified for the Character identifier (CHRID) parameter on the create, change, or override commands for display files, printer files, and panel groups before this attribute will be used.

*SAME: The value does not change.

*SYSVAL: The system value QCHRIDCTL is used.

*DEVD: The *DEVD special value performs the same function as on the CHRID command parameter for display files, printer files, and panel groups.
*JOBCCSID: The *JOBCCSID special value performs the same function as on the CHRID command parameter for display files, printer files, and panel groups.

Top

Locale job attributes (SETJOBATR)

Specifies which job attributes are to be taken from the locale specified for the Locale (LOCALE) parameter when the job is initiated.

Single values

*SAME: The value does not change.

*SYSVAL: The system value, QSETJOBATR, is used to determine which job attributes are taken from the locale.

*NONE: No job attributes are taken from the locale.

Other values

*CCSID: The coded character set identifier from the locale is used. The CCSID value from the locale overrides the user profile CCSID.
*DATFMT: The date format from the locale is used.
*DATSEP: The date separator from the locale is used.
*DECFMT: The decimal format from the locale is used.
*SRTSEQ: The sort sequence from the locale is used. The sort sequence from the locale overrides the user profile sort sequence.
*TIMSEP: The time separator from the locale is used.

Top

Locale (LOCALE)

Specifies the path name of the locale that is assigned to the LANG environment variable for this user.

*SAME: The value does not change.

*SYSVAL: The system value QLOCALE is used to determine the locale path name to be assigned for this user.

*NONE: No locale path name is assigned for this user.
*C: The C locale path name is assigned for this user.
*POSIX: The POSIX locale path name is assigned for this user.
'path-name': Specify the path name of the locale to be assigned for this user.

Top

User options (USROPT)

Specifies the level of help information detail to be shown and the function of the Page Up and Page Down keys by default. The system shows several displays that are suitable for the inexperienced user. More experienced users must perform an extra action to see detailed information. When values are specified for this parameter, the system presents detailed information without further action by the experienced user.

Single values

*SAME: The value does not change.

*NONE: Detailed information is not shown.

Other values

*CLKWD: Parameter keywords are shown instead of the possible parameter values when a control language (CL) command is prompted.
*EXPERT: More detailed information is shown when the user is performing display and edit options to define or change the system (such as edit or display object authority).
*ROLLKEY: The actions of the Page Up and Page Down keys are reversed.
*NOSTSMSG: Status messages are not displayed when sent to the user.
*STSMSG: Status messages are displayed when sent to the user.
*HLPFULL: Help text is shown on a full display rather than in a window.
*PRTMSG: A message is sent to this user's message queue when a spooled file for this user is printed or held by the printer writer.

Top

Home directory (HOMEDIR)

Specifies the path name of the home directory for this user profile. The home directory is the user's initial working directory. The working directory, associated with a process, is used during path name resolution in the directory file system for path names that do not begin with a slash (/). If the home directory specified does not exist when the user signs on, the user's initial working directory is the root (/) directory.

*SAME: The value does not change.

*USRPRF: The home directory assigned to the user will be /home/USRPRF, where USRPRF is the name of the user profile.

'path-name': Specify the path name of the home directory to be assigned to this user.

For more information on specifying path names, refer to "Object naming rules" in the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.

Top

Examples

CHGPRF   INLPGM(ARLIB/DSPMENU)

In this example, JJADAMS wants to change his user profile.

This command makes the following changes to the user profile named JJADAMS:

Changes the first program to start, following a successful sign-on, to a program names DSPMENU, which is located in a library named ARLIB.

All the other command parameters default to *SAME and do not change.

Top

Error messages

*ESCAPE Messages

CPF22EC: Unable to process request for user profile &1.
CPF22E1: USROPT parameter cannot specify *STSMSG and *NOSTSMSG.
CPF22F1: Coded character set identifier &1 not valid.
CPF22F4: CCSID value &1 not compatible with the system.
CPF2209: Library &1 not found.
CPF2213: Not able to allocate user profile &1.
CPF2225: Not able to allocate internal system object.
CPF2228: Not authorized to change user profile.
CPF2242: Object &1 type *&2 not found in library list.
CPF2244: Object &1 type *&2 cannot be found.
CPF2294: Initial program value cannot be changed.
CPF2295: Initial menu value cannot be changed.
CPF2296: Attention program value cannot be changed.
CPF2297: Current library value cannot be changed.
CPF9802: Not authorized to object &2 in &3.
CPF9820: Not authorized to use library &1.
CPF9825: Not authorized to device &1.

Top