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 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 installed
- Where critical system messages are sent
- 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
- The message queue used by electronic customer support (ECS) programs
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:
- To use this command, you must have *ALLOBJ authority.
- 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.
- 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 |
| PTFGRPLVL | PTF group levels | 1-99999, *SAME, *NOMAX | 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 |
| 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 |
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.
| 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 |
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.
| 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 |