Change Service Attributes (CHGSRVA)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

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

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.

Restrictions:

  1. To use this command, you must have *ALLOBJ 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.
Top

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
SNDDTAPKT Send data packet *SAME, *NO, *YES Optional
CRITMSGUSR Critical messages to user Single values: *SAME
Other values (up to 50 repetitions): Name, *SYSOPR, *SECOFR, *SECADM, *PGMR, *USER
Optional
Top

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.
Top

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.
Top

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.
Top

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.
Top

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.
Top

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.
Top

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.
*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. It is recommended that this value not be used for applying cumulative PTF packages. There is a risk of applying immediate PTFs to products that are in use. PTFs should only be applied to products that are not in use.
*IMMDLY
All immediate PTFs are applied, and delayed PTFs are marked for delayed apply, but a system IPL is not done. It is recommended that this value not be used for applying cumulative PTF packages. There is a risk of applying immediate PTFs to products that are in use. PTFs should only be applied to products that are not in use.
Top

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.
Top

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.
Top

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.
Top

Examples

Example 1: Specifying no Automatic Problem Analysis

CHGSRVA   ANZPRBAUTO(*NO)

This command changes the analyze problem automatically flag. Problem analysis will no longer 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.

Top

Error messages

*ESCAPE Messages

CPF8C66
Service attributes not changed.
CPF8C98
No authority to change certain service attributes.
CPF9899
Error occurred during processing of command.
Top