Change Ctl Desc (Tape) (CHGCTLTAP)

The Change Controller Description (Tape) (CHGCTLTAP) command changes a controller description for a tape controller.

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.

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.

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.

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.

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.

Examples

CHGCTLTAP   CTLD(TAP01)  ONLINE(*NO)

This command changes the ONLINE parameter value to *NO for a tape controller named TAP01.