CRTDEVTAP (Create Device Description (Tape))

CRTDEVTAP Command syntax diagram

 

Purpose

The Create Device Description (Tape) (CRTDEVTAP) command creates a device description for a tape device. More information about using this command is in the Local Device Configuration book.

 

Required Parameters

DEVD
Specifies the name of the device description being created.

TYPE
Specifies the type of device this description represents. Any of the following types, listed in numeric order, are valid:
2440     3570     6344     6366     6380    9348
3422     3590     6346     6368     6390
3430     6341     6347     6369     7208
3480     6342     6348     6378     9346
3490     6343     6349     6379     9347
MODEL
Specifies the model number of the device type for this description.

*ANY: This value is for 3490 device types.

0001: This model number is for a 6341, 6342, 6343, 6344, 6346, 6347, 6348, 6349, 6366, 6368, 6369, 6378, 6379, 6380, 6390 9346, 9347, or 9348 device type.

0002: This model number is for a 7208, 9346, or 9348 device type.

0012: This model number is for a 7208 device type.

A01: This model number is for a 3422 or 3430 device type.

A12: This model number is for a 2440 device type.

B00: This model number is for a 3570 device type.

B01: This model number is for a 3422, 3430, or 3570 device type.

B11: This model number is for a 3480, 3570, or 3590 device type.

B1A: This model number is for a 3570 or 3590 device type.

B22: This model number is for a 3480 device type.

C00: This model number is for a 3570 device type.

C01: This model number is for a 3570 device type.

C11: This model number is for a 3570 device type.

C1A: This model number is for a 3570 device type.

RSRCNAME
Specifies the resource name that describes the automatic call unit port.

Note: Use the Work with Hardware Resources (WRKHDWRSC) command with *STG specified on the TYPE parameter to determine the resource name.

SWTSET
Specifies a 1-character switch setting field with a value ranging from 0 through F.

Note: This parameter is required for a device type of 3422, 3430, 3480, or 3490, but is not allowed for other device types. Valid values for a 3422, 3480 or 3490 device type ranges from 0 through F. Valid values for a 3430 device type range from 0 through 3.

 

Optional Parameters

ONLINE
Specifies whether this object is automatically varied on at initial program load (IPL).

*YES: The object is automatically varied on at IPL.

*NO: This object is not automatically varied on at IPL.

CTL
Specifies the name of the controller description to which this object is attached.

Note: This parameter is valid only for 3422, 3430, 3480 and 3490 device types.

ASSIGN
Specifies whether the tape drive is assigned to the system when it is varied on.

*YES: The tape drive is assigned when the device is varied on.

*NO: The tape drive is not assigned when the device is varied on.

UNLOAD
Specifies whether the tape drive is unloaded when the device is varied off.

*YES: The tape drive is unloaded when the device is varied off.

*NO: The tape drive is not unloaded when the device is varied off. The tape is rewound, but not past the beginning-of-tape marker.

MSGQ
Specifies the name of the message queue to which messages are sent.

*SYSOPR: Messages are sent to the system operator message queue (QSYS/QSYSOPR).

message-queue-name: Specify the name of the message queue to which operational messages are sent.

The name of the message queue can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

AUT
Specifies the authority given to users who do not have specific authority to the device description, who are not on an authorization list, and whose user group has no specific authority to the device description.

*LIBCRTAUT: The authority for the object is the same as the create authority for QSYS. The create authority for QSYS can be displayed by using the Display Library Description (DSPLIBD) command. If the create authority is changed with the Change Library (CHGLIB) command, the new authority does not affect existing objects.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the device description.

*USE: The user can perform basic operations on the device description, such as running a program or reading a file. The user cannot change the device description. *USE authority provides object operational authority, read authority, and execute authority.

*EXCLUDE: The user cannot access the device description.

authorization-list-name: Specify the name of the authorization list used.

TEXT
Specifies the text that briefly describes the device file. More information on this parameter is in Commonly used parameters.

*BLANK: Text is not specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Example for CRTDEVTAP

CRTDEVTAP   DEVD(TAP01)  TYPE(9347)  MODEL(0001)
  RSRCNAME(TAP01)

This command creates a device description for a tape drive named TAP01. It is a 9347 Model 0001 tape drive with a resource name of TAP01.

Error messages for CRTDEVTAP

*ESCAPE Messages

CPF261A
Device description &1 not created due to errors.