Change Service Agent Attr (CHGSRVAGTA)

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

The Change Service Agent Attr (CHGSRVAGTA) command allows a user to change the attributes of Service Agent.

Parameters

Keyword	Description	Choices	Notes
ENABLE	Enable	SAME, YES, NO, SRVINF, *PRBRPT	Optional, Positional 1
AUTORPT	Auto report	SAME, YES, *NO	Optional
AUTORPTRTY	Auto report retry	Element list	Optional
	Element 1: Retry	SAME, YES, *NO
	Element 2: Frequency	5-720, *SAME
	Element 3: Number of times to retry	1-999, SAME, NOMAX
	Element 4: Notify users	SAME, YES, *NO
PALANZ	Product activity log analysis	Element list	Optional
	Element 1: Enable	SAME, YES, *NO
	Element 2: Start hour	0-23, *SAME
	Element 3: Interval	*SAME, 1, 2, 3, 4, 6, 8, 12, 24
	Element 4: Send message	SAME, YES, *NO
RUNPTY	Run priority	1-99, *SAME	Optional
NOTIFYUSR	Notify user ID	Single values: *SAME Other values (up to 5 repetitions): Simple name	Optional
AUTOPTF	Auto PTF	Element list	Optional
	Element 1: Enable	SAME, YES, *NO
	Element 2: Schedule day	SAME, SUN, MON, TUE, WED, THU, FRI, SAT
	Element 3: Download PTFs	SAME, YES, NO, CVRLTR
SRVINF	Service information	Element list	Optional
	Element 1: Select information	ALL, PRBID, *SAME
	Element 2: Collect time	Time, SAME, CURRENT
	Element 3: Send time	Time, SAME, COLLECT
	Element 4: Connection verification timer	1-21, *SAME
	Element 5: Task hold interval	1-30, *SAME
SRVPVDID	Report problem to	Element list	Optional
	Element 1: Control point name	Communications name, SAME, IBMSRV
	Element 2: Network ID	Communications name, SAME, NETATR
LINECTL	Line control	Element list	Optional
	Element 1: Enable	SAME, YES, *NO
	Element 2: Configuration object	Values (up to 12 repetitions): Element list
	Element 1: Line description	Name, *SAME
	Element 2: Controller description	Name, SAME, ANY
	Element 3: Device description	Name, SAME, ANY
RPTRMTPRB	Report remote problem	SAME, YES, *NO	Optional
ACTPWD	Activation password	Character value, *SAME	Optional

Top

Enable (ENABLE)

Specifies whether Service Agent is enabled.

*SAME: The value does not change if it has been set. Otherwise, it is set to *YES.
*YES: Service Agent is enabled.
*NO: Service Agent is not enabled.

This is a required parameter.

Top

Auto report (AUTORPT)

Specifies whether service requests are to be placed automatically by Service Agent.

*SAME: The value does not change if it has been set. Otherwise, it is set to *YES.
*YES: Service Agent will automatically place service requests.
This function requires the use of the problem log filter. System value QPRBFTR will be changed to QS9FILTER.
*NO: Service Agent will not automatically place service requests. The users specified for the Notify user ID (NOTIFYUSR) parameter will receive messages about a problem that is discovered.

Top

Auto report retry (AUTORPTRTY)

Specifies whether service requests placed automatically by Service Agent are to be retried if an attempt fails, and if so, how they are to be retried.

Element 1: Retry

*SAME: The value does not change if it has been set. Otherwise, it is set to *YES.
*YES: Service requests placed automatically by Service Agent are retried.
*NO: Service requests placed automatically by Service Agent are not retried.

Element 2: Frequency

*SAME: The value does not change if it has been set. Otherwise, it is set to 15.
5-720: Specifies the frequency in minutes at which service requests placed automatically by Service Agent are retried.

Element 3: Number of times to retry

*SAME: The value does not change if it has been set. Otherwise, it is set to 3.
*NOMAX: Service requests placed automatically by Service Agent will be retried until successful.
1-999: Specify the number of times to retry service requests placed automatically by Service Agent.

Element 4: Notify users

*SAME: The value does not change if it has been set. Otherwise, it is set to *YES.
*YES: The users specified for the Notify user ID (NOTIFYUSR) parameter will receive a message when a service request placed automatically by Service Agent is retried.
*NO: No message will be sent when a service request placed automatically by Service Agent is retried.

Top

Product activity log analysis (PALANZ)

Specifies whether product activity log (PAL) analysis routines are run and errors are reported.

Before a problem found in the product activity log is reported, product activity log analysis routines are run. These analysis routines can be CPU intensive.

Element 1: Enable

*SAME: The value does not change if it has been set. Otherwise, it is set to *YES.
*YES: Product activity log analysis routines are run. A problem from the product activity log is reported.
*NO: Product activity log analysis routines are not run. A problem from the product activity log is not reported. There will be no media analysis data or product activity log data available for reports.

Element 2: Start hour

Specifies the base hour of the day used to determine when product activity log (PAL) analysis runs. PAL analysis will run at the intervals specified using the Start hour parameter as the base hour. PAL analysis will run 10 minutes after the hour.

For example, 00 means to base the start hour at midnight. With the PAL analysis interval is 4, it will run at 00:10, 04:10, 08:10 and 12:10.

*SAME: The value does not change if it has been set. Otherwise, it is set to 00.
0-23: Specify the base hour to determine when PAL analysis runs.

Element 3: Interval

Specifies how often, in hours, to check the product activity log for problems to report.

*SAME: The value does not change if it has been set. Otherwise, it is set to 4.
1: Service Agent checks the product activity log every hour.
2: Service Agent checks the product activity log every 2 hours.
3: Service Agent checks the product activity log every 3 hours.
4: Service Agent checks the product activity log every 4 hours.
6: Service Agent checks the product activity log every 6 hours.
8: Service Agent checks the product activity log every 8 hours.
12: Service Agent checks the product activity log every 12 hours.
24: Service Agent checks the product activity log every 24 hours.

Element 4: Send message

Specifies whether a message should be sent to the list of users to receive Service Agent messages each time Service Agent begins analyzing the product activity log.

*SAME: The value does not change if it has been set. Otherwise, it is set to *YES.
*YES: The users identified in the Notify user ID (NOTIFYUSR) parameter will receive messages each time Service Agent starts a product activity log analysis cycle. A record will also be created in the Service Agent audit log.
*NO: Service Agent will not send messages to users each time it starts a product activity log analysis cycle. A record will still be created in the Service Agent audit log.

Top

Run priority (RUNPTY)

Specifies the run priority for Service Agent. Run priority is a value ranging from 1 (highest priority) through 99 (lowest priority) that represents the importance of the job when it competes with other jobs for the machine resources.

*SAME: The value does not change if it has been set. Otherwise, it is set to 51.
1-99: Specify the run priority for Service Agent.

Top

Notify user ID (NOTIFYUSR)

Specifies the user profiles to receive messages about Service Agent activity.

Note: In addition to any user profiles you specify, the system operator (QSYSOPR) and QSRV user profiles will also receive messages. It is not possible to prevent messages from being sent to the QSYSOPR and QSRV user profiles.

Single values

*SAME: The value does not change.

Other values (up to 5 repetitions)

simple-name: Specify the user profile names of the users to receive Service Agent messages.

Top

Auto PTF (AUTOPTF)

Specifies whether Service Agent will electronically (using ECS) check the system or logical partition to determine if PTFs deemed critical by IBM Service are on the system or logical partition. If PTFs are needed, fix request entries containing the PTF numbers to be ordered will be created into the problem log.

Element 1: Enable

*SAME: The value does not change if it has been set. Otherwise, it is set to *YES.
*YES: The function is enabled.
*NO: The function is not enabled.

Element 2: Schedule day

Specifies the day of the week the automatic PTF processing is to take place and whether any PTFs identified as being needed by the system or logical partition are downloaded to the system or logical partition.

This value may not be set correctly if your system or logical partition is not using the Gregorian calendar.

Note: The available days from which to choose are shown when F4 is pressed. This provides an even distribution of the IBM Service system resources, thereby maintaining high availability of the IBM Service system.

The day of the week can be selected, however the time of day cannot, for the same reason stated above. This automatic PTF function may not run at the same time of day each time it runs.

*SAME: The value does not change if it has been set. Otherwise, it is set to the first day of those described above.
*SUN: The function will run on Sunday.
*MON: The function will run on Monday.
*TUE: The function will run on Tuesday.
*WED: The function will run on Wednesday.
*THU: The function will run on Thursday.
*FRI: The function will run on Friday.
*SAT: The function will run on Saturday.

Element 3: Download PTFs

*SAME: The value does not change if it has been set. Otherwise, it is set to *YES.
*YES: The PTFs that are found to be needed during the automatic PTF processing will be downloaded to the system or logical partition.
Note: PTFs that are downloaded will NOT be loaded or applied.
*NO: The PTFs that are found to be needed during the automatic PTF processing will not be downloaded to the system or logical partition. Fix request entries containing the PTF numbers to be ordered will exist in the problem log.
*CVRLTR: The PTF cover letters for the PTFs that are found to be needed during the automatic PTF processing will be downloaded to the system or logical partition. Fix request entries containing the PTF numbers to be ordered will exist in the problem log, but only the associated cover letters will be ordered.

Top

Service information (SRVINF)

Specifies service information is to be collected and sent to IBM, the time at which service information collection is to start, the time at which service information is to be sent, and how often the connection to IBM is automatically tested.

Element 1: Select information

Specify that service information is to be sent to IBM.

*SAME: The value does not change if it has been set. Otherwise, it is set to *ALL.
*ALL: All service information is sent to IBM.

Element 2: Collect time

Specify the time at which the service information collection is to start.

*SAME: The value does not change if it has been set. Otherwise, it is set to *CURRENT.
*CURRENT: The service information collection is to start at the current time.
time: The time at which the service information collection is to start. Specify the time in the job time format.

Element 3: Send time

Specify the time at which the service information is to be sent to IBM.

*SAME: The value does not change.

*COLLECT: The service information will be sent immediately after it is collected.
time: The time at which the service information is to be sent. Specify the time in the job time format.

Element 4: Connection verification timer

Specify how often, in days, the connection to IBM will automatically be tested.

*SAME: The value does not change if it has been set. Otherwise, it is set to 7.
1-21: How often, in days, the connection to IBM will automatically be tested.

Element 5: Task hold interval

Specify the minimum number of days a Service Agent collection task or send task is kept after it has run. After this time interval, the task will be deleted. The time interval starts as soon as the task has run.

*SAME: The value does not change if it has been set. Otherwise, it is set to 7.
1-30: The number of days the tasks are kept.

Top

Report problem to (SRVPVDID)

Specifies the name of the service provider to receive automatic notification of a problem.

Notification of a problem will automatically be sent to the system or logical partition specified by this parameter when AUTORPT(*YES) is specified. This system or logical partition must be in the list of service providers. Use the Work with Service Providers (WRKSRVPVD) command to see the service providers defined for your system or logical partition.

Element 1: Control point name

*SAME: The value does not change if it has been set. Otherwise, it is set to *IBMSRV.
*IBMSRV: IBM Service is the service provider.
communications-name: Specify the control point name of the service provider that will be notified of a local system problem.

Element 2: Network ID

*SAME: The value does not change if it has been set. Otherwise, it is set to *NETATR.
*NETATR: The service provider is in the local network.
communications-name: Specify the network ID of the service provider that is notified of a local system problem.

Top

Line control (LINECTL)

For ECS configurations that use a line description, Service Agent can vary off a line description that is in connect pending status which shares the same resource as the ECS line description. After the service request has completed, the specified configuration objects will be varied back on. This program will not take any action for any other line status.

Element 1: Enable

*SAME: The value does not change if it has been set. Otherwise, it is set to *NO.
*YES: The line control feature is enabled.
*NO: The line control feature is not enabled.

Element 2: Configuration object

Each configuration object specified has three elements: line, controller, and device description name. Up to twelve sets of configuration objects can be specified.

Note: You must ensure the device is attached to the controller and the controller is attached to the line for all configuration object entries.

Element 1: Line description

*SAME: The value does not change.

name: The name of the line description that is to be varied off.

Element 2: Controller description

*SAME: The value does not change.
*ANY: Any controller description attached to the line description will be varied off.
name: The name of the controller description that is to be varied off.

Element 3: Device description

*SAME: The value does not change.
*ANY: Any device description attached to the controller description will be varied off.
name: The name of the device description that is to be varied off.

Top

Report remote problem (RPTRMTPRB)

Specifies whether this system or logical partition reports problems on behalf of a network of systems or logical partitions.

*SAME: The value does not change if it has been set. Otherwise, it is set to *NO.
*NO: This system or logical partition does not report problems in the problem log that were sent from a remote system or logical partition in a network environment.
*YES: This system or logical partition reports problems in the problem log that were sent from a remote system or logical partition in a network environment.
Note: This system or logical partition must be the host system or host logical partition. To enable this function, System Manager for IBM i must be installed and configured.

Top

Activation password (ACTPWD)

Specifies the current value of the activation password.

Note: This is a required parameter when RPTRMTPRB(*YES) is specified.

*SAME: The value does not change.
character-value: Specify the current value of the activation password. Your IBM Service Representative can provide you with the current activation password.

Top

Examples

CHGSRVAGTA   ENABLE(*YES)  AUTORPT(*YES)  NOTIFYUSR(SMITH)

This command changes enables problem reporting and service information collection and transmission and specifies the user profile SMITH to receive Service Agent messages.

Top

Error messages

*ESCAPE Messages

CPF9899: Error occurred during processing of command.

Top