Change Service Tools User ID (CHGSSTUSR)

The Change Service Tools User ID (CHGSSTUSR) command changes information associated with a service tools user ID.

Restrictions:

• You must have security administrator (*SECADM) and service (*SERVICE) special authorities.
• The requesting service tools user ID must have the Service Tool user functional privilege "Service Tools Security".

Parameters

Keyword	Description	Choices	Notes
REQUSRID	Requesting SST user ID	Character value	Required, Key, Positional 1
REQPWD	Requesting SST user ID pwd	Character value	Required, Key, Positional 2
USRID	Service tools user ID	Character value	Required, Key, Positional 3
USERINFO	Service tools user ID info	Element list	Optional
	Element 1: Password	Character value, *SAME
	Element 2: Status	*SAME, *ENABLED, *DISABLED
	Element 3: Set password to expired	*SAME, *NO, *YES
	Element 4: Text 'description'	Character value, *SAME, *BLANK
	Element 5: Linked profile	Simple name, *SAME, *NONE
PRIVILEGES	Privileges	Element list	Optional
	Element 1: Disk units - operations	*SAME, *YES, *NO
	Element 2: Disk units - administration	*SAME, *YES, *NO
	Element 3: Disk units - read only	*SAME, *YES, *NO
	Element 4: System partitions - operations	*SAME, *YES, *NO
	Element 5: System partitions - admin	*SAME, *YES, *NO
	Element 6: Partition remote panel key	*SAME, *YES, *NO
	Element 7: Operator panel functions	*SAME, *YES, *NO
	Element 8: Operating system IPL	*SAME, *YES, *NO
	Element 9: Install	*SAME, *YES, *NO
	Element 10: Performance data collector	*SAME, *YES, *NO
	Element 11: Hardware service manager	*SAME, *YES, *NO
	Element 12: Display/Alter/Dump	*SAME, *YES, *NO
	Element 13: Main storage dump	*SAME, *YES, *NO
	Element 14: Product activity log	*SAME, *YES, *NO
	Element 15: License Internal Code log	*SAME, *YES, *NO
	Element 16: License Internal Code fixes	*SAME, *YES, *NO
	Element 17: Trace	*SAME, *YES, *NO
	Element 18: DST environment	*SAME, *YES, *NO
	Element 19: Remote service support	*SAME, *YES, *NO
	Element 20: Service tools security	*SAME, *YES, *NO
	Element 21: Service tools save and restore	*SAME, *YES, *NO
	Element 22: Debug	*SAME, *YES, *NO
	Element 23: System capacity - operations	*SAME, *YES, *NO
	Element 24: System capacity - admin	*SAME, *YES, *NO
	Element 25: System security	*SAME, *YES, *NO
	Element 26: Start service tools	*SAME, *YES, *NO
	Element 27: Take over console	*SAME, *YES, *NO

Top

Requesting SST user ID (REQUSRID)

The service tools user ID that will be used to make the specified changes. This user ID must have the Service Tool user functional privilege "Service Tools Security".

This is a required parameter.

Requesting SST user ID pwd (REQPWD)

The password for the requesting service tools user ID.

This is a required parameter.

Service tools user ID (USRID)

The service tools user ID to be changed.

This is a required parameter.

Service tools user ID info (USERINFO)

Specifies the changes to be made to the service tools user ID.

Element 1: Password

The password that allows the service tools user to sign on.

*SAME

The value does not change.

'password'

The password associated with the service tools user ID.

Element 2: Status

The status of the service tools user ID.

*SAME

The value does not change.

*ENABLED

The service tools user ID is valid for sign on.

*DISABLED

The service tools user ID is not valid for sign on until an authorized user enables it.

Element 3: Set password to expired

The password for the service tools user ID is set to expired. The user is required to change the password to sign on.

*SAME

The value does not change.

*NO

The password is not set to expired.

*YES

The password is set to expired.

Element 4: Text 'description'

Specifies the text that briefly describes the object.

*SAME

The value does not change.

*BLANK

No text is specified.

'description'

Specify no more than 64 characters of text, enclosed in apostrophes.

Element 5: Linked profile

The name of the user profile that is linked to the service tools user ID.

*SAME

The value does not change.

*NONE

A user profile is not linked to the service tools user ID.

'profile name'

The name of the user profile.

Privileges (PRIVILEGES)

The service tools user function privileges associated with the user ID.

The allowed values for the privileges are:

*SAME

The value does not change.

*YES

The service tools user ID has the privilege.

*NO

The service tools user ID does not have the privilege.

Element 1: Disk units - operations

Privilege to perform disk operator service functions.

Element 2: Disk units - administration

Privilege to perform disk unit administrator service functions.

Element 3: Disk units - read only

Privilege to perform disk read only service functions.

Element 4: System partitions - operations

Privilege to perform system partition operator service functions.

Element 5: System partitions - admin

Privilege to perform system partition administrator service functions.

Element 6: Partition remote panel key

Privilege to change a panel key for the specified partition where it is secured.

Element 7: Operator panel functions

Privilege to use the operator panel functions.

Element 8: Operating system IPL

Privilege to perform an IPL.

Element 9: Install

Privilege to perform a system install.

Element 10: Performance data collector

Privilege to perform performance data collector service functions.

Element 11: Hardware service manager

Privilege to perform hardware resource management service functions.

Element 12: Display/Alter/Dump

Privilege to work with Display/Alter/Dump.

Element 13: Main storage dump

Privilege to perform a main storage dump.

Element 14: Product activity log

Privilege to view and work with the product activity log.

Element 15: License Internal Code log

Privilege to view and work with the Licensed Internal Code (LIC) log.

Element 16: License Internal Code fixes

Privilege to load Licensed Internal Code (LIC) PTFs.

Element 17: Trace

Privilege to read and perform the trace service functions.

Element 18: DST environment

Privilege to change the Dedicated Service Tools (DST) environment.

Element 19: Remote service support

Privilege to configure and connect to the system using the Remote Service Support interface.

Element 20: Service tools security

Privilege to work with and change Licensed Internal Code (LIC) security values.

Element 21: Service tools save and restore

Privilege to perform save and restore service security functions.

Element 22: Debug

Privilege to use the service debug tools.

Element 23: System capacity - operations

Privilege to perform system capacity operations service functions.

Element 24: System capacity - admin

Privilege to perform system capacity administration service functions.

Element 25: System security

Privilege to perform security service functions and to work with security lock down values.

Element 24: Start service tools

Privilege to sign-on and work with SST.

Element 27: Take over console

Privilege for a LAN console user to take over the console from another LAN console user.

Examples

Example 1: Change a service tools user ID to be linked to a user profile

CHGSSTUSR REQUSRID(SSTUSR) REQPWD(SSTPWD) USRID(NEWSSTUSER)
           USERINFO(() *SAME *SAME *SAME USER1)

This command changes service tools user ID NEWSSTUSR to be linked to user profile USER1. When USER1 is running an IBM i interface that requires service tools privileges it will use the privileges associated with NEWSSTUSR.

Error messages

*ESCAPE Messages

CPF222E

&1 special authority is required.

CPF225B

Service tools ID &1 not correct.

CPF225C

Requesting service tools ID not correct.

CPF225D

Requesting service tools ID password not correct.

CPF4AB3

Error occurred for service tools ID. Reason code &1.

CPF4AB7

Service tools user ID password cannot be changed.

CPF4AD2

New password not valid. Reason code &1.