CHGPRF (Change Profile)

CHGPRF Command syntax diagram

 

Purpose

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

 

Restrictions

  1. Object management (*OBJMGT) authority and use (*USE) authority are required to change the user profile.

  2. *USE authority is required to the current library, program, menu, job description, message queue, print device, output queue, and the ATTN key handling program.

 

Optional Parameters

ASTLVL
Specifies which user interface to use.

*SAME: The value does not change.

*SYSVAL: The assistance level defined for the system 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, the options keys and the function keys are not displayed. If a command does not have an advanced (*ADVANCED) level, the intermediate (*INTERMED) level is used.

CURLIB
Specifies the name of the library being used as the current library for jobs initiated by this user profile.

Note: If *PARTIAL or *YES is specified for the LMTCPB parameter in the user profile, the user cannot change the current library.

*SAME: The value does not change.

*CRTDFT: The user has no current library. If objects are created into the current library using *CURLIB on a create command, the QGPL library is used as the default current library.

current-library-name: Specify the name of the library that, after the user signs on the system, becomes the current library.

INLPGM
Specifies, for an interactive job, the qualified name of the program that is called whenever a new routing step is started that has QCL or QCMD as the request processing program. If *PARTIAL or *YES is specified on the LMTCPB parameter in the user profile, the program value cannot be changed. 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.

*SAME: The value does not change.

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

The name of the program can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

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

INLMNU
Specifies the qualified name of the menu displayed when the user signs on. If *YES is specified on the LMTCPB parameter in the user profile, the user cannot change the menu.

A system/36 environment menu can be specified as the initial menu 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.

*SAME: The value does not change.

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

The name of the menu can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

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

KBDBUF
Specifies the keyboard buffering value to be used when a job is initialized for this user profile. The new value takes effect the next time the user signs on. If the type-ahead feature is active, the keystrokes can be buffered. If the attention key buffering option is active, the attention key is buffered like any other key. If the attention key is not active, the attention key is not buffered and is sent to the system even if the display station is input inhibited. The keyboard buffer value can also be set by a user application using the QWSSETWS program. More information is in Application Program Interfaces (APIs) topic in the Information Center.

*SAME: The value does not change.

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

*NO: The type-ahead feature and attention key buffering option are not active for this user profile.

*TYPEAHEAD: The type-ahead feature is active for this user profile.

*YES: The type-ahead feature and attention key buffering option are active for this user profile.

JOBD
Specifies the name of 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.

*SAME: The job description value does not change.

The name of the job description can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

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

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

*SAME: The value does not change.

*NONE: No document password is assigned to this user.

document-password: Specify a document password 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 invalid.

MSGQ
Specifies the qualified name of the message queue to which messages are sent.

Note: The message queue is created, if it does not already exist, when the user signs on. If the message queue parameter is changed by using the change user profile command, then that message queue is also created.

*SAME: The value does not change.

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

The name of the message queue can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

message-queue-name: Specify the name of the message queue that is used by this user.

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

*SAME: The value does not change.

*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 installed). The delivery mode cannot be changed to *BREAK if the message queue is also being used by another job.

*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 installed) 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.

*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.

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 on 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 on the 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 to or greater than the value specified here. Otherwise, the message is held in the queue until it is requested.

*SAME: The value does not change.

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

PRTDEV
Specifies the qualified name of the default printer device for this job. If OUTQ(*DEV) is specified, the file is placed on an output queue with the same name as the printer.

*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.

print-device-name: Specify the name of a printer used to print the output for this user.

OUTQ
Specifies the qualified name of the output queue.

*SAME: The value does not change.

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

*DEV: An output queue name with the same name as that specified in the PRTDEV parameter is used as the output queue for this user profile.

The name of the output queue can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

output-queue-name: Specify the output queue name that identifies the output queue associated with this user profile.

ATNPGM
Specifies the qualified name of the program that is the 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 on the LMTCPB parameter in the user profile, the ATTN key handling program cannot be changed.

*SAME: The value does not change.

*ASSIST: QEZMAIN is used.

*SYSVAL: The system value QATNPGM is used.

*NONE: No ATTN key handling program is used by this user.

The name of the ATTN key handling program can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

program-name: Specify the name of the ATTN key handling program used by this user.

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

*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.

The name of the sort sequence table can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

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

LANGID
Specifies the language identifier used for this user.

*SAME: The language identifier does not change.

*SYSVAL: The system value QLANGID is used.

language-identifier: Specify the language identifier. More information on valid language identifiers is in the Globalization topic in the Information Center.

CNTRYID
Specifies the country or region identifier used for this user.

*SAME: The country or region identifier does not change.

*SYSVAL: The system value QCNTRYID is used.

country-identifier: Specify the country or region identifier from the country or region code table. More information on this parameter is in Commonly used parameters.

CCSID
Specifies the coded character set identifier (CCSID) 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 CCSID does not change.

*SYSVAL: The system value QCCSID is used.

*HEX: The CCSID 65535 is used.

coded-character-set-identifier: Specify the CCSID. More information on valid CCSIDs is in the Globalization topic in the Information Center.

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

*SAME: The CHRID control does not change.

*SYSVAL: The value in the QCHRIDCTL system value will be 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.

SETJOBATR
Specifies which job attributes are taken from the locale specified in the LOCALE parameter when the job is initiated.

*SAME: The value does not change.

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

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

Any combination of the following values can be specified:

*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.

USROPT
Specifies level of help information detail the user sees 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.

*SAME: The value does not change.

*NONE: Detailed information is not shown.

*CLKWD: Parameter keywords are shown instead of the possible parameter values when a control language (CL) command is displayed.

*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.

*HLPFULL: Help text is shown on a full display rather than in a window.

*NOSTSMSG: Status messages are not displayed when sent to the user.

*STSMSG: Status messages are displayed when sent to the user.

*PRTMSG: A message is sent to this user's message queue when a spooled file for this user is printed or help by the printer writer.

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.

'locale path name': Specify the path name of the locale to be assigned for this user. See path names for more information on specifying path names.

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.

Note: This parameter is only used with the integrated file system. It cannot be used to set the home directory for IBM OS/2 Warp Server for AS/400.

*SAME: The value does not change.

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

'home-directory-path-name': Specify the path name of the home directory to assign to this user. See path names for more information on specifying path names.

TEXT
Specifies the text that briefly describes the user profile named in the USRPRF parameter. More information is in Commonly used parameters.

*SAME: The value does not change.

*BLANK: Text is not specified.

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

Example for CHGPRF 

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:

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

Error messages for CHGPRF

*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.