CHGSRVA (Change Service Attributes)

CHGSRVA Command syntax diagram

 

Purpose

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

The values specified on 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. This command is shipped with public *EXCLUDE authority, which authorizes SECOFR, QSRV, or QSRVBAS profiles to use it. A user having one of these profile types may authorize other users to use this command.

  2. The system specified on 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 on 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.

 

Optional Parameters

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-name: Specify the entire sequence of numbers required to dial including international access codes, country or region codes, area codes, and exchange codes.

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-name: Specify the entire sequence of numbers required to dial including international access codes, country or region codes, area codes, and exchange codes.

ANZPRBAUTO
Specifies whether problem analysis routines 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 will be 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 do not run automatically at the time of failure.

*YES: Problem analysis routines run automatically at the time of failure.

RPTPRBAUTO
Specifies whether notification of problems that have been automatically analyzed are 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 does not automatically receive notification of local system problems.

*YES: The service provider automatically receives notification of local system problems.

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

Notification of problems are automatically sent to the system specified on 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.

Element 1: Control Point Name

control-point-name: Specify the control point name of the service provider to be notified of local system problems.

Element 2: Network ID

*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 to be notified of local system problems.

SRVPVDCNN
Specifies the complete electronic connection number to the service provider.

*SAME: The value does not change.

connection-name: Specify the entire sequence of numbers required to dial.

PTFINSTYP
Specifies when a PTF is applied. The value specified on this parameter is used when applying a PTF using either the Install Program Temporary Fix (INSPTF) command, or the Program Temporary Fix (PTF) menu (option 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.

*IMMDLY: All immediate PTFs are applied, and delayed PTFs are marked for delayed apply, but a system IPL is not done.

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

*SAME: The value does not change.

*YES: A maximum of 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.

CRITMSGUSR
Specifies users, or classes of users, that can receive a break message when the system detects a critical condition, such as a direct-access storage device (DASD) failure.

The values specified on this parameter should be specified sequentially, in order of priority (highest to lowest). If the system detects a critical condition, it attempts to send a break message indicating the nature of the problem to the user, or class of users, indicated by the value with the highest priority.

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

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

Note: This parameter is valid only if ANZPRBAUTO(*YES) is specified.

*SAME: The value does not change.

*SYSOPR: All users of the system operator (*SYSOPR) user class receive a message when a critical message is sent.

*SECOFR: All users of the security officer (*SECOFR) user class receive a message when a critical message is sent.

*SECADM: All users of the security administrator (*SECADM) user class receive a message when a critical message is sent.

*PGMR: All users of the programmer (*PGMR) user class receive a message when a critical message is sent.

*USER: All users of the user (*USER) user class receive a message when a critical message is sent.

user-name: Specify the name of the user profile to receive a message when a critical message is sent.

Examples for CHGSRVA

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.

Error messages for CHGSRVA

*ESCAPE Messages

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