The Change Service Agent (CHGSRVAGT) command allows a user to change the operation of Service Agent in several functional areas. The function to be changed is specified by the Type (TYPE) parameter.

Parameters

Keyword	Description	Choices	Notes
TYPE	Type	*COVERAGE, *JOBLOG, *MASTERPWD, *PRBLOG, *PRBRPT, *PRDACTLOG, *SENDDATA, *THRESHOLD, *USERAUTH	Required, Positional 1
BLKPRBRPT	Block reporting	*YES, *NO	Optional
PERIOD	Block period	Element list	Optional
	Element 1: Start time and date	Element list
	Element 1: Start time	Time
	Element 2: Start date	Date
	Element 2: End time and date	Element list
	Element 1: End time	Time
	Element 2: End date	Date
IGNPRB	Ignore	*YES, *NO	Optional
CRTJOBLOG	Create job logs	*YES, *NO	Optional
ANZIMMED	Analyze immediately	*YES, *NO	Optional
ANZSTRDATE	Analysis start date	Date, *NOCHG	Optional
ANZSTRTIME	Analysis start time	Time, *NOCHG	Optional
ENBCVG	Enable coverage	*NO, *YES	Optional
CVGSTRTIME	Coverage start time	Time, 080000	Optional
CVGENDTIME	Coverage end time	Time, 200000	Optional
WEEKEND	Call over weekends	*YES, *NO	Optional
DATA	Data	*CHG, *ALL	Optional
CURPWD	Current password	Character value	Optional
NEWPWD	New password	Character value	Optional
VFYPWD	Verify password	Character value	Optional
SUBTYPE	Subtype	*DEVICE, *SYSREFCDE	Optional
ACTION	Action	*ADD, *CHG, *RMV	Optional
DEVICE	Device	Character value	Optional
CATEGORY	Category	*DASD, *TAPE, *PROCESSOR, *OPTICAL, *FSIOP, *OTHER	Optional
SENSEFMT	Sense byte format	0, 4, 2, 8, C	Optional
RPTERRCLS	Error classes	Values (up to 27 repetitions): Element list	Optional
	Element 1: Class	*PERMANENT, *THRESHOLD, *TEMPORARY, *STATISTICAL, *INFORMATIONAL, *SOFTWARE, *RECOVERABLE, *BUFFERED, *MACHINECHECK, *VARYON, *VARYOFF, *RECOVERED, *IOPDUMP, *LICINTCODE, *RESET, *QUALIFIED, *PREDANALYSIS, *DATAPROTECTION, *HDWREDUNDANCY, *ADDITIONAL1, *ADDITIONAL2, *ADDITIONAL3, *ADDITIONAL4, *ADDITIONAL5, *ADDITIONAL6, *ADDITIONAL7, *ADDITIONAL8
	Element 2: Report error	*YES, *NO
SYSREFCDE	System reference code	Character value, *RANGE	Optional
ADDACTIVE	Active	*YES, *NO	Optional
ADDTHRESH	Threshold	0-99, *NONE	Optional
ADDGROUP	Group	Character value	Optional
ADDTEXT	Text	Character value, *BLANK	Optional
CHGACTIVE	Active	*SAME, *YES, *NO	Optional
CHGTHRESH	Threshold	0-99, *SAME, *NONE	Optional
CHGGROUP	Group	Character value, *SAME	Optional
CHGTEXT	Text	Character value, *SAME, *BLANK	Optional
RANGE	System reference code range	Element list	Optional
	Element 1: Starting code	Character value, *FIRST
	Element 2: Ending code	Character value, *LAST
IBMID	Authorize users	Values (up to 2 repetitions): Character value	Optional

Top

Type (TYPE)

Specifies the type of change to be made.

This is a required parameter.

*PRBRPT

Problem reporting is to be changed by specifying the window of time during which product activity log entries should be ignored when Service Agent analyzes the product activity log.

This option is for use before a DASD pump or before other system maintenance which may generate product activity log entries. For example, during a DASD pump operation, errors may be put into the product activity log. When Service Agent analyzes the product activity log after the DASD pump operation, Service Agent reports the errors generated by the pump process.

To prevent the analysis and reporting of these errors, use this feature before starting the Service Agent monitoring jobs before powering down the system to perform maintenance.

Note: Using this feature can prevent unnecessary problem reporting.

*MASTERPWD

The Service Agent master password is to be changed. Passwords for Service Agent are to be kept in confidence. The new password may be 6 - 8 characters in length and may contain any combination of alphanumeric characters. To change the password you must do the following:

1. Enter the current password.
2. Enter the new password.
3. Enter the new password again to verify it.
4. Press Enter to save the new password.

Note: The first time that a new password is created, it actually is an additional master password. This additional password may subsequently be changed by this procedure, but the original master password remains valid.

*PRBLOG

Problem log analysis is to be changed either to prevent any existing problems from being analyzed and reported, or to allow existing problems to be analyzed and reported. If Service Agent monitoring jobs have been ended for an extended period of time and are to be started again, this feature may be used to prevent reporting of problem log entries that occurred during the inactive period.

Note: This command should be issued while no Service Agent monitoring jobs are running. If this command is issued while Service Agent monitoring jobs are running, you must end and restart these jobs either by using the end jobs and start jobs options on the GO SERVICE main menu, or by using ENDSRVAGT TYPE(*SBSJOB) and STRSRVAGT TYPE(*SBSJOB).

*JOBLOG

Service Agent job logging is to be changed (set on or off).

*PRDACTLOG

Parameters to the next product activity log (PAL) analysis cycle are to be changed. These are the date and time from which PAL records are analyzed, and the time at which the next analysis cycle will be initiated.

Note: PAL routines must be active for this function. Use the Change Service Agent attributes (CHGSRVAGTA) command and specify PAL analysis parameters (PALANZ) to activate the PAL analysis routines.

*SENDDATA

The amount of service information to be sent is to be changed.

*COVERAGE

Offhours coverage is to be changed. This feature will cause Service Agent to stop reporting problems at the time specified for the Coverage end time (CVGENDTIME) parameter and resume reporting problems at the time specified for the Coverage start time (CVGSTRTIME) parameter. If Call over weekends (WEEKEND) parameter is set to *NO, Service Agent will stop reporting problems at the coverage end time on Friday and resume reporting problems at the coverage start time on Monday.

*THRESHOLD

Specifies that a change action is to be performed on a device or system reference code in the threshold table.

*USERAUTH

Specifies that user IDs will be authorized to access system information using the IBM Electronic Services web site. One or more values must be specified for the Authorize users (IBMID) parameter.

Block reporting (BLKPRBRPT)

Specifies whether Service Agent should ignore product activity log entries for a given period of time.

Note: This is a required parameter when TYPE(*PRBRPT) is specified.

*YES

Service Agent will ignore product activity log entries created during the given date and time range.

*NO

Service Agent will not ignore product activity log entries created after the present time, even if that period of time falls within the date and time range given in a previous use of this command with BLKPRBRPT(*YES).

Block period (PERIOD)

Specifies the period during which Service Agent should ignore product activity log entries.

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

Element 1: Start time and date

Specifies the time and date at which Service Agent should start ignoring product activity log entries.

Element 1: Start time

time

Specify the start time in the job time format.

Element 2: Start date

date

Specify the start date in the job date format.

Element 2: End time and date

Specifies the time and date at which Service Agent should stop ignoring product activity log entries.

Element 1: End time

time

Specify the end time in the job time format.

Element 2: End date

date

Specify the end date in the job date format.

Ignore (IGNPRB)

Specifies whether Service Agent will ignore existing problem log entries when Service Agent monitoring jobs are started.

Note: This is a required parameter when TYPE(*PRBLOG) is specified.

*YES

Service Agent will ignore existing problem log entries.

*NO

Service Agent will not ignore existing problem log entries.

Create job logs (CRTJOBLOG)

Specifies whether joblogs are created for jobs ran by the QSRVAGT user profile.

Note: This is a required parameter when TYPE(*JOBLOG) is specified.

*NO

No joblogs are created for Service Agent jobs unless a job ends abnormally.

*YES

A joblog is created for each of the Service Agent jobs ran by the QSRVAGT user profile.

Analyze immediately (ANZIMMED)

Specifies whether the next analysis cycle should start immediately.

Note: This parameter is valid only when TYPE(*PRDACTLOG) is specified.

*YES

Service Agent product activity log analysis is started immediately.

*NO

Service Agent product activity log analysis is started automatically at the next scheduled date and time. The scheduled date and time can be changed by using the Analysis start date (ANZSTRDATE) and Analysis start time (ANZSTRTIME) parameters provided, or by using the Change Service Agent settings option on the SERVICE menu.

Analysis start date (ANZSTRDATE)

Specifies the date at which analysis is to begin.

Note: This parameter is valid only when TYPE(*PRDACTLOG) is specified.

*NOCHG

The ending date of the previous analysis cycle is used as the starting date for the next cycle.

date

Specify the start date in the job date format. This will indicate that the date at which analysis is to begin is to change. An additional field is provided to specify a new time if desired. All product activity log records with time stamps from this date and time to the current date and time are included in the analysis.

Specifying a new date and/or time causes all existing data on the Media Analysis Report and the Product Activity Log Monthly Summary to be removed. The data will be recreated from the records included in the next analysis cycle. This parameter can therefore be used to modify the starting date for these cumulative reports. These reports can be accessed by selecting the Customer Reports menu option on the SERVICE menu. This parameter has the same effect on the product activity log reports available on the SERVICECE menu.

Analysis start time (ANZSTRTIME)

Specifies the time at which analysis is to begin.

Note: This parameter is valid only when TYPE(*PRDACTLOG) is specified.

*NOCHG

The ending time of the previous analysis cycle is used as the starting time for the next cycle.

time

Specify the start time in the job date format. This will indicate that the time at which analysis is to begin is to change. An additional field is provided to specify a new date if desired. All product activity log records with time stamps from this date and time to the current date and time are included in the analysis.

Specifying a new time and date causes all existing data on the Media Analysis Report and the Product Activity Log Monthly Summary to be removed. The data will be recreated from the records included in the next analysis cycle. This parameter can therefore be used to modify the starting time for these cumulative reports. These reports can be accessed by selecting the Customer Reports menu option on the SERVICE menu. This parameter has the same effect on the product activity log reports available on the SERVICECE menu.

Enable coverage (ENBCVG)

Specifies whether the offhours coverage feature is to be used.

Note: This parameter is valid only when TYPE(*COVERAGE) is specified.

*NO

The offhours coverage feature is not used.

*YES

The offhours coverage feature is used.

Coverage start time (CVGSTRTIME)

Specifies the time at which coverage is to begin.

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

time

Specify the start time in the job time format.

Coverage end time (CVGENDTIME)

Specifies the time at which coverage is to end.

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

time

Specify the end time in the job time format.

Call over weekends (WEEKEND)

Specifies whether service requests are to be placed during the weekend.

Note: This parameter is valid only when ENBCVG(*YES) is specified.

*YES

Service requests will be placed between the time specified for the Coverage end time (CVGENDTIME) on Friday and the time specified for the Coverage start time (CVGSTRTIME) parameter on Monday.

*NO

Service requests will not be placed between the time specified for CVGENDTIME on Friday and the time specified for CVGSTRTIME on Monday.

Data (DATA)

Indicates the amount of service information to be sent.

Note: This is a required parameter when TYPE(*SENDDATA) is specified.

*CHG

Only the service information types that have changed is sent.

*ALL

All service information is sent whether it has changes or not. This value is in effect for the next time Service Agent sends service information, after which it will be returned to the default of *CHG.

Current password (CURPWD)

Specifies the current value of the master password. This may be either the original master password or the additional value already created.

Note: This is a required parameter when TYPE(*MASTERPWD) is specified.

character-value

Specify the master password.

New password (NEWPWD)

Specifies the new password you want to use to sign on to the CE menu. This password must be 6 - 8 characters in length and may contain any combination of alphanumeric characters. The first time that a new password is created, it actually is an additional master password. This additional password may subsequently be changed by this procedure, but the original master password remains in force.

It is recommended that you not use the same password that you use for your user profile.

Note: This is a required parameter when TYPE(*MASTERPWD) is specified.

character-value

Specify the new password.

Verify password (VFYPWD)

Specifies the new password again to make sure that you have entered it correctly. If the password you enter here is different from the one you entered in the previous field, an error message is displayed and your password remains the same as it was before you attempted to change it.

Note: This is a required parameter when TYPE(*MASTERPWD) is specified.

character-value

Specify the new password again, for verification.

Subtype (SUBTYPE)

Specifies the type of entry to be changed in the threshold table.

Note: This is a required parameter when TYPE(*THRESHOLD) is specified.

*DEVICE

A device entry is to be changed.

*SYSREFCDE

A system reference code entry is to be changed.

Action (ACTION)

Specifies the type of change action to be performed on the threshold table entry.

Note: This is a required parameter when a value is specified for the Subtype (SUBTYPE) parameter.

*ADD

A threshold table entry is added.

*CHG

A threshold table entry is changed.

*RMV

A threshold table entry is removed.

Device (DEVICE)

Specifies the device to be added to or changed in the Service Agent threshold table, or the device that is associated with the system reference code to be added to, changed in, or removed from the Service Agent threshold table.

A list of the current devices may be displayed by using the Work with Threshold Table option from the SERVICE menu.

Note: This is a required parameter when TYPE(*THRESHOLD) is specified.

character-value

Specify the four character device type associated with the threshold table or system reference code. For example, DEVICE(2420) might be specified for a 2420 tape device.

Category (CATEGORY)

Specifies the category of device added or changed in the Service Agent threshold table.

Note: This is a required parameter when SUBTYPE(*DEVICE) is specified and ACTION(*ADD) or ACTION(*CHG) is specified.

*DASD

The device is a DASD device.

*TAPE

The device is a tape device.

*PROCESSOR

The device is a processor.

*OPTICAL

The device is an optical device.

*FSIOP

The device is an FSIOP device.

*OTHER

The device is other than one of the above listed devices.

Sense byte format (SENSEFMT)

Specifies the format of the volume statistical data for tape devices.

Note: This parameter is valid only when CATEGORY(*TAPE) is specified.

0

The device does not report removable media statistics.

4

The format is for a 1/4" cartridge tape device.

2

The format is for a 1/2" reel tape device.

8

The format is for an 8 mm tape device.

C

The format is for a 1/2" cartridge tape device.

Error classes (RPTERRCLS)

Specifies whether or not Service Agent processes an error of the specified class for this device.

Note: This parameter is valid only when SUBTYPE(*DEVICE) is specified and ACTION(*ADD) or ACTION(*CHG) is specified.

Element 1: Class

Specifies the class of error.

*PERMANENT

A permanent error.

*THRESHOLD

A threshold error.

*TEMPORARY

A temporary error.

*STATISTICAL

A statistical error.

*INFORMATIONAL

An informational error.

*SOFTWARE

A software error.

*RECOVERABLE

A recoverable error.

*BUFFERED

A buffered error.

*MACHINECHECK

A machine check error.

*VARYON

A vary on error.

*VARYOFF

A vary off error.

*RECOVERED

A recovered error.

*IOPDUMP

An IOP dump error.

*LICINTCODE

A licensed internal code error.

*RESET

A reset error.

*QUALIFIED

A qualified error.

*PREDANALYSIS

A predictive analysis error.

*DATAPROTECTION

A data protection error.

*HDWREDUNDANCY

A hardware redundancy error.

*ADDITIONAL1

First additional error.

*ADDITIONAL2

Second additional error.

*ADDITIONAL3

Third additional error.

*ADDITIONAL4

Fourth additional error.

*ADDITIONAL5

Fifth additional error.

*ADDITIONAL6

Sixth additional error.

*ADDITIONAL7

Seventh additional error.

*ADDITIONAL8

Eighth additional error.

Element 2: Report error

Specifies whether an error of this class is to be reported for this device.

*YES

An error of this class is reported.

*NO

An error of this class is not reported.

System reference code (SYSREFCDE)

Specifies the system reference code added, changed, or removed from the threshold table.

Note: This parameter is required when SUBTYPE(*SYSREFCDE) is specified.

*RANGE

Specify a range of system reference codes to be changed.

Note: *RANGE is valid only when ACTION(*CHG) is specified. When *RANGE is specified, values must be specified for the System reference code range (RANGE) parameter.

character-value

Specify the system reference code added, changed, or removed from the threshold table.

Active (ADDACTIVE)

Specifies whether or not Service Agent reports errors for a system reference code for this device.

Note: This parameter is required when SUBTYPE(*SYSREFCDE) and ACTION(*ADD) are specified.

*YES

Service Agent reports the errors for this system reference code for this device.

*NO

Service Agent does not report errors for this system reference code for this device.

Threshold (ADDTHRESH)

Specifies the number of times this system reference code must occur within a seven day period for Service Agent to report this error from the product activity log.

Note: This parameter is required when SUBTYPE(*SYSREFCDE) and ACTION(*ADD) are specified.

*NONE or 0

This error is not reported from the product activity log.

1-99

Specify a threshold value.

Group (ADDGROUP)

Specifies the group to which this system reference code belongs.

Note: This parameter is required when SUBTYPE(*SYSREFCDE) and ACTION(*ADD) are specified.

character-value

Specify the one-character group identifier.

Text (ADDTEXT)

Specifies the text that briefly describes the system reference code.

Note: This parameter is valid only when SUBTYPE(*SYSREFCDE) and ACTION(*ADD) are specified.

*BLANK

No text is specified.

character-value

Text to describe the system reference code.

Active (CHGACTIVE)

Specifies whether or not Service Agent reports errors for this system reference code for this device.

Note: This parameter is valid only when SUBTYPE(*SYSREFCDE) and ACTION(*CHG) are specified.

*SAME

The value does not change.

*YES

Service Agent reports the errors for this system reference code for this device.

*NO

Service Agent does not report the errors for this system reference code for this device.

Threshold (CHGTHRESH)

Specifies the number of times this system reference code must occur in a seven day period for Service Agent to report this error from the product activity log.

Note: This parameter is valid only when SUBTYPE(*SYSREFCDE) and ACTION(*CHG) are specified.

*SAME

The value does not change.

*NONE or 0

This error is not reported from the product activity log.

1-99

Specify a threshold value.

Group (CHGGROUP)

Specifies the group to which this system reference code belongs.

Note: This parameter is valid only when SUBTYPE(*SYSREFCDE) and ACTION(*CHG) are specified.

*SAME

The value does not change.

character-value

Specify a one character group identifier.

Text (CHGTEXT)

Specifies the text that briefly describes the system reference code.

Note: This parameter is valid only when SUBTYPE(*SYSREFCDE) and ACTION(*CHG) are specified.

*SAME

The value does not change.

*BLANK

No text is specified.

character-value

Text to describe the system reference code.

System reference code range (RANGE)

Specifies the starting and ending system reference codes to be changed.

Note: This parameter is required when SYSREFCDE(*RANGE) is specified.

Element 1: Starting code

*FIRST

System reference codes are to be changed starting with the first system reference code for the device.

character-value

Specify the first system reference code to be changed.

Element 2: Ending code

*LAST

System reference codes are to be changed ending with the last system reference code for the device.

character-value

Specify the last system reference code to be changed.

Authorize users (IBMID)

Specifies the IBM IDs that will be authorized to access service information using the IBM Electronic Services web site. IBM provides personalized web functions that use information collected by IBM Electronic Service Agent. To use these functions, users sign in using their IBM ID (user ID) that they obtain from IBM. To register for an IBM ID, go to the My IBM Profile (https://www.ibm.com/account/profile) web site.

Examples

CHGSRVAGT   TYPE(*THRESHOLD)  SUBTYPE(*SYSREFCDE)  ACTION(*ADD)
            DEVICE(9337)  SYSREFCDE(3050)
            ADDACTIVE(*YES)  ADDTHRESH(0)
            ADDTEXT('DISK DVC RET WRN RSP TO IOP')

This command adds system reference code 3050 to the 9337 device in the threshold table with a threshold limit of 0.

Error messages

*ESCAPE Messages

CPF9899

Error occurred during processing of command.