Change Ctl Desc (Tape) (CHGCTLTAP)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Controller Description (Tape) (CHGCTLTAP) command changes a controller description for a tape controller.
Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CTLD | Controller description | Name | Optional, Key, Positional 1 |
| RSRCNAME | Resource name | Name, *SAME, *NONE | Optional |
| ONLINE | Online at IPL | *SAME, *YES, *NO | Optional |
| AUTOCFG | Auto-configuration controller | *SAME, *YES, *NO | Optional |
| TEXT | Text 'description' | Character value, *SAME, *BLANK | Optional |
| Top |
Controller description (CTLD)
This is a required parameter.
Specifies the name of the controller description.
| Top |
Resource name (RSRCNAME)
Specifies the resource name that identifies the hardware this description represents. Use the WRKHDWRSC command to determine the resource name.
- *SAME
This value does not change.
- *NONE
No resource name is specified at this time. A resource name must be provided before the device can be varied on.
- resource-name
Specify the name to identify the physical devices on the system. Use the Work with Hardware Resources (WRKHDWRSC) command with *STG specified for the TYPE parameter to help determine the resource name.
| Top |
Online at IPL (ONLINE)
Specifies whether this object is automatically varied on at initial program load (IPL).
- *SAME
This value does not change.
- *YES
The controller is automatically varied on at IPL.
- *NO
The controller is not automatically varied on at IPL.
| Top |
Auto-configuration controller (AUTOCFG)
Specifies whether this controller description is the one which should have devices attached when they are automatically configured. Although there can be more than one controller description for each controller, only one description can be an automatic configuration controller. When new devices are automatically configured on that controller, they are attached to the automatic configuration controller description.
- *SAME
This value does not change.
- *NO
This is not an automatic configuration controller.
- *YES
This is an automatic configuration controller.
| Top |
Text 'description' (TEXT)
Specifies the text that briefly describes the object.
- *SAME
This value does not change.
- *BLANK
No text is specified.
- character-value
Specify no more than 50 characters of text, enclosed in apostrophes.
| Top |
Examples
CHGCTLTAP CTLD(TAP01) ONLINE(*NO)
This command changes the ONLINE parameter value to *NO for a tape controller named TAP01.
| Top |
| Top |