Change Service Attributes (CHGSRVA)

The Change Service Attributes (CHGSRVA) command is used to specify:

• The connection number to report to external support
• The connection number to call back this system
• Whether problem analysis routines should run automatically when a failure occurs
• How the specified service provider should be notified of problems
• The connection number to the service provider

• When PTFs should be applied
• Whether PTF save files and cover letter should be copied into *SERVICE when PTFs are loaded from a tape or optical device
• The maximum number of levels of a PTF group to keep on the system

• Whether PTF groups should be ordered automatically
• The list of PTF groups to order automatically
• Whether additional data should be sent to the service provider

• The message queue used by electronic customer support (ECS) programs

• Where critical system messages are sent

The values specified for the parameters of this command are saved when the Save System (SAVSYS) command is run, and can be restored to the system when the operating system is reinstalled. The service attributes are also saved when the Save System Information (SAVSYSINF) command is run, and can be restored during system recovery (not upgrade or migration) using the Restore System Information (RSTSYSINF) command.

Restrictions:

1. To use this command, you must have Service (*SERVICE) special authority.
2. The system specified by the RPTSRVPVD parameter must currently exist on the list of service providers (use the Work with Service Providers (WRKSRVPVD) command to display the list of service providers defined for your system.) If the system specified is not defined on the list of service providers, an error message is returned, and the values of all parameters remain unchanged.
3. The user profiles that are specified for the CRITMSGUSR parameter must currently exist on the system; otherwise, an error message is returned and the values remain unchanged. The Work with User Profiles (WRKUSRPRF) command can be used to display a list of user profiles that exist on the system.

Parameters

Keyword	Description	Choices	Notes
SYSDSBRPT	System disabled reporting	Character value, *SAME	Optional
SYSDSBCB	System disabled call back	Character value, *SAME	Optional
ANZPRBAUTO	Analyze problem automatically	*SAME, *NO, *YES	Optional
RPTPRBAUTO	Report problem automatically	*SAME, *NO, *YES	Optional
RPTSRVPVD	Report problem to	Single values: *SAME, *IBMSRV, *SELECT Other values: Element list	Optional
	Element 1: Control point name	Communications name
	Element 2: Network ID	Communications name, *LCLNETID
SRVPVDCNN	Service provider connection	Character value, *SAME	Optional
PTFINSTYP	PTF install type	*SAME, *DLYIPL, *DLYALL, *IMMONLY, *IMMDLY	Optional
CPYPTF	Copy PTFs	*SAME, *NO, *YES	Optional
PTFGRPLVL	PTF group levels	1-99999, *SAME, *NOMAX	Optional
ORDPTFAUTO	Order PTFs automatically	*SAME, *NO, *YES	Optional
ORDPTFGRP	Order PTF groups	Single values: *SAME Other values (up to 20 repetitions): Character value, *CUMPKG, *ALLGRP, *HIPERGRP, *DB2GRP, *BRSGRP, *JVAGRP, *HTTPGRP, *PFRGRP	Optional
SNDDTAPKT	Send data packet	*SAME, *NO, *YES	Optional
ECSMSGQ	ECS message queue	Single values: *SAME Other values: Qualified object name	Optional
	Qualifier 1: ECS message queue	Name
	Qualifier 2: Library	Name
CRITMSGUSR	Critical messages to user	Single values: *SAME Other values (up to 50 repetitions): Name, *SYSOPR, *SECOFR, *SECADM, *PGMR, *USER	Optional

System disabled reporting (SYSDSBRPT)

Specifies the complete electronic connection number used for automatic reporting to external support when this system is disabled.

*SAME

The value does not change.

connection-number

Specify the entire sequence of numbers required to dial including international access codes, country or region codes, area codes, and exchange codes.

System disabled call back (SYSDSBCB)

Specifies the complete electronic connection number used to call this system from external support when this system is disabled.

*SAME

The value does not change.

connection-number

Specify the entire sequence of numbers required to dial including international access codes, country or region codes, area codes, and exchange codes.

Analyze problem automatically (ANZPRBAUTO)

Specifies whether problem analysis routines will run automatically at the time of failure. Problem analysis routines are programs that attempt to isolate or correct the problem. If problem analysis routines are run automatically, they are run at the time of failure as a background batch job. If problem analysis routines are not run automatically at the time of failure, they can be run manually from the QSYSOPR message queue, or by using the Work with Problems (WRKPRB) command.

*SAME

The value does not change.

*NO

Problem analysis routines will not run automatically at the time of failure.

*YES

Problem analysis routines will run automatically at the time of failure.

Report problem automatically (RPTPRBAUTO)

Specifies whether notification of problems that have been automatically analyzed will be sent to the service provider specified on the RPTSRVPVD parameter.

If automatic problem notification is specified, it is run as a background batch job at the time of failure. If automatic problem notification is not specified, problems can be manually reported to a service provider from the QSYSOPR message queue, or by using the Work with Problems (WRKPRB) command.

*SAME

The value does not change.

*NO

The service provider will not automatically receive notification of local system problems.

*YES

The service provider will automatically receive notification of local system problems.

Report problem to (RPTSRVPVD)

Specifies the name of the service provider to receive automatic notification of problems.

Notification of problems will automatically be sent to the system specified by this parameter when RPTPRBAUTO(*YES) is specified. This system 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.

*SAME

The value does not change.

*IBMSRV

IBM Service Support is the service provider.

*SELECT

A list of service providers is shown from which the user can select the control-point-name and network-id.

The possible Control Point Name value is:

control-point-name

Specify the control point name of the service provider that will be notified of local system problems.

The possible Network ID values are:

*LCLNETID

The network ID of the service provider is the same as that of the local system.

network-id

Specify the network ID of the service provider that is notified of local system problems.

Service provider connection (SRVPVDCNN)

Specifies the complete electronic connection number to the service provider.

*SAME

The value does not change.

connection-number

Specify the entire sequence of numbers required to dial including international access codes, country or region codes, area codes, and exchange codes.

PTF install type (PTFINSTYP)

Specifies when a PTF should be applied. The value specified for this parameter is used when applying a PTF using either the INSPTF command, or the Program Temporary Fix (PTF) menu (options 7 or 8).

*SAME

The value does not change.

*DLYIPL

All PTFs are marked for delayed apply, and a system IPL is done. It is recommended that this value be used for applying cumulative PTF packages.

*DLYALL

All PTFs are marked for delayed apply, and a system IPL is not done.

*IMMONLY

All immediate PTFs are applied. Delayed PTFs are not marked for delayed apply, and a system IPL is not done.

*IMMDLY

All immediate PTFs are applied, and delayed PTFs are marked for apply at the next system IPL.

Copy PTFs (CPYPTF)

Specifies whether to copy PTF save files and cover letters into *SERVICE when PTFs are loaded from a tape or optical device. PTF save files must be in *SERVICE when distributing PTFs to other systems or when using the Save System Information (SAVSYSINF) command.

*SAME

The value does not change.

*YES

PTF save files and cover letters that do not already exist are copied into *SERVICE when PTFs are loaded from tape or optical.

*NO

PTF save files and cover letters are not copied into *SERVICE when PTFs are loaded from tape or optical.

PTF group levels (PTFGRPLVL)

Specifies the maximum number of levels of a PTF group to keep on the system. When the number of levels of the PTF group on the system exceeds this value, the lowest levels of the PTF group will automatically be deleted, leaving only this number of levels of the PTF group on the system.

*SAME

The value does not change.

*NOMAX

All levels of a PTF group should be kept on the system.

1-99999

Specify the number of levels of a PTF group to keep on the system.

Order PTFs automatically (ORDPTFAUTO)

Specifies whether PTF groups should be ordered automatically.

*SAME

The value does not change.

*YES

The QORDPTFGRP job is scheduled to order PTF groups once a month. The frequency, scheduled day, and scheduled time of job QORDPTFGRP can be changed with the Change Job Schedule Entry (CHGJOBSCDE) command. The Send PTF Order (SNDPTFORD) command is used to order the latest level of the PTF groups when the scheduled job is run. The PTF groups will be downloaded as save files and the list of PTF groups to order will be retrieved from the Order PTF groups (ORDPTFGRP) service attribute.

Note: PTF groups can only be ordered automatically if the universal connection is configured. Use the Send Service Request (SNDSRVRQS) command specifying ACTION(*TEST) to verify the communications link to the remote service support system.

*NO

PTF groups are not ordered automatically. If the QORDPTFGRP job is currently scheduled to order PTF groups, it will be removed.

Order PTF groups (ORDPTFGRP)

Specifies the PTF groups to order when ORDPTFAUTO(*YES) is specified to automatically order PTF groups.

*SAME

The value does not change.

*CUMPKG

Order the latest level of the Cumulative PTF package group (SF99vrm) for the operating system release that is installed on the system. The HIPER and DB2 for IBM i PTF groups are automatically included in the order when the Cumulative PTF package group is specified.

*ALLGRP

Order the latest level of all PTF groups for the installed operating system release, except the Cumulative PTF package group. This special value is not allowed with any PTF group except the Cumulative PTF package group (*CUMPKG or SF99vrm).

*HIPERGRP

Order the latest level of the HIPER PTF group for the operating system release that is installed on the system.

*DB2GRP

Order the latest level of the DB2 for IBM i PTF group for the operating system release that is installed on the system.

*BRSGRP

Order the latest level of the Backup Recovery Solutions PTF group for the operating system release that is installed on the system.

*HTTPGRP

Order the latest level of the IBM HTTP Server for i PTF group for the operating system release that is installed on the system.

*JVAGRP

Order the latest level of the Java PTF group for the operating system release that is installed on the system.

*PFRGRP

Order the latest level of the Performance Tools PTF group for the operating system release that is installed on the system.

name

Specify the name of the PTF group to order.

Send data packet (SNDDTAPKT)

Specifies whether additional data collected by the program that detects the problem should be sent to the service provider when a problem is reported.

*SAME

The value does not change.

*YES

Up to 2000 bytes of additional data is sent to the service provider when a problem is reported.

*NO

Additional data is not sent to the service provider when a problem is reported.

ECS message queue (ECSMSGQ)

Specifies the message queue to be used by electronic customer support (ECS) programs to send message when resuming PTF orders.

Single values

*SAME

The value does not change.

Qualifier 1: ECS message queue

name

Specifies the name of the message queue being used.

Qualifier 2: Library

name

Specifies the library that contains the message queue.

Critical messages to user (CRITMSGUSR)

Specifies users, or classes of users, that can receive a break message when the system detects a critical condition, such as a DASD failure.

The values specified for this parameter are entered sequentially, in order of priority (highest to lowest). In the event the system detects a critical condition, it will attempt to send a break message indicating the nature of the problem to the user, or class of users, specified in the entry with the highest priority.

When the entry specifies a user name, a break message is sent only if the user is signed on. When the entry specifies a user class, a break message is sent to all users of that class that are currently signed on.

In the event that none of the users specified by the entry are currently signed on, the next entry is checked. This process continues until either a break message can be sent, or the last entry is checked.

*SAME

The value does not change.

*SYSOPR

All users of user class *SYSOPR will receive a message when a critical message is sent.

*SECOFR

All users of user class *SECOFR will receive a message when a critical message is sent.

*SECADM

All users of user class *SECADM will receive a message when a critical message is sent.

*PGMR

All users of user class *PGMR will receive a message when a critical message is sent.

*USER

All users of user class *USER receive a message when a critical message is sent.

user-name

Specify the name of the user profile that receives a message when a critical message is sent.

Examples

Example 1: Specifying no Automatic Problem Analysis

CHGSRVA   ANZPRBAUTO(*NO)

This command changes the Analyze problem automatically service attribute to indicate problem analysis will not be run at the point of failure.

Example 2: Changing the Service Provider

CHGSRVA   RPTSRVPVD(PARIS *LCLNETID)

This command changes the name of the service provider. The new service provider has a control point name of PARIS, and the same network ID as the local system.

Error messages

*ESCAPE Messages

CPF8C66

Service attributes not changed.

CPF9899

Error occurred during processing of command.