Change Server Auth Entry (CHGSVRAUTE)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Server Authentication Entry (CHGSVRAUTE) command changes existing authentication information entries for a user profile. The authentication information is for use by application requesters in connecting to application servers.
Restrictions: You must have security administrator (*SECADM) special authority, and object management (*OBJMGT) and use (*USE) authorities to the user profile for which the server authentication entry is to be changed, or else be signed on under that user profile, to run this command.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| USRPRF | User profile | Simple name, *CURRENT | Required, Positional 1 |
| SERVER | Server | Character value | Required, Positional 2 |
| USRID | User ID | Character value, *SAME, *USRPRF | Optional |
| PASSWORD | User password | Character value, *SAME, *NONE | Optional |
| Top |
User profile (USRPRF)
Specifies the user profile for which the server authentication entry is to be changed.
- *CURRENT
- The server authentication entry will be changed for the current user profile.
- name
- Specify the name of the user profile for which the server authentication entry is to be changed.
| Top |
Server (SERVER)
Specifies the name of the application server for which the entry is to be changed. You can specify a maximum of 200 characters.
Note: Refer to the documentation for the server that you are using to determine if there are any values that have special meaning. For example, the server name QDDMSERVER has special meaning if you are using the Distributed Data Management (DDM) server.
| Top |
User ID (USRID)
Specifies the user name for which requests will be made to the application server.
- *SAME
- The user ID specified on connection requests to the server does not change.
- *USRPRF
- The name specified in the user profile parameter will be the user ID specified on connection requests to the server.
- 'user-name'
- The user ID to be used on connection requests. Specify no more than 1000 characters.
| Top |
User password (PWD)
Specifies the password to be used to authenticate the user when the client attempts to connect to the server.
Note: If the retain server security data (QRETSVRSEC) system value is set to 0 (do not retain data), then the password will not be saved in the entry.
- *SAME
- The password does not change.
- *NONE
- No password is supplied.
- 'password'
- Spcify the password associated with the user ID. Specify no more than 696 characters.
| Top |
Examples
Example 1: Changing a default remote user ID and password for the current user
CHGSVRAUTE USRPRF(*CURRENT) SERVER(*ANY) USRID('JOHN')
PASSWORD('XU53W4')
This command changes a server authentication entry for the currently signed on user specifying that for connection requests to any server for which there is no specific authentication entry, a remote user ID of JOHN and a password of XU53W4 is to be used.
Example 2: Changing an entry for another user for a specific server
CHGSVRAUTE USRPRF(SUSAN) SERVER('MPLS_RDB') USRID(*SAME)
PASSWORD('S23084')
This command changes the password for the user SUSAN when connecting to the server named MPLS_RDB.
| Top |
Error messages
*ESCAPE Messages
- CPF2204
- User profile &1 not found.
- CPF2213
- Not able to allocate user profile &1.
- CPF2222
- Storage limit is greater than specified for user profile &1.
- CPF225E
- Server authentication entry does not exist.
- CPF225F
- Not all information stored.
- CPF226C
- Not authorized to perform function.
| Top |