Update Device Microcode (QTAUPDDV) API


  Required Parameter Group:

1 Device name Input Char(10)
2 Source path name Input Char(*)

  Optional Parameter Group:

3 Length of source path name Input Binary(4)
4 Format Name Input Char(8)
5 Error code I/O Char(*)

  Default Public Authority: *EXCLUDE

  Threadsafe: No

The Update Device Microcode (QTAUPDDV) API provides an interface for updating device microcode from a code image stored in an Integrated File System (IFS) stream file.

The QTAUPDDV API only supports self-configuring, stand alone tape devices. The Retrieve Device Capabilities (QTARDCAP) API can be used to determine if the tape device is a self-configured tape device. Other types of devices are currently not supported by this API. This API can be used for a tape device within a media library if the device is deallocated from the library.

Note: Incorrect use of this API can cause damage to the tape device.


Authorities and Locks

API Public Authority
*EXCLUDE
Special Authority
*SERVICE
Directory Access Authority
*X
Stream File Access Authority
*R
Device Description Authority
*CHANGE
Device Description Lock
*EXCLRD

Required Parameter Group

Device name
INPUT; CHAR(10)

The name of the device for which for which the code image is to be updated.

Source path name.
INPUT; CHAR(*)

The path name for the code image.


Optional Parameter Group

Length of source path name.
INPUT; BINARY(4)

The length of the source path name provided. Valid values range from 1 through 32048 or -1. If this parameter is omitted, the source path name is assumed to be a simple blank terminated path name. Use -1 if the length is in the LG-type structure.

Format name
INPUT; CHAR(8)

The format of the source path name parameter. If this parameter is omitted the source path name is assumed to be a simple blank terminated path name in the current CCSID.

TAUD0100
The source path name is a simple path name in the current CCSID.

TAUD0200
The source path name is a LG-type path name structure. For more information on this structure, see Path name format.

Error code
I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter. If this parameter is omitted, any problems will result in escape messages to the application.


Error Messages

Message ID Error Message Text
CPFA0A9 E Object not found. Object is *.
CPFA09C E Not authorized to object.
CPF222E E * special authority is required.
CPF24B4 E Severe error while addressing parameter list.
CPF3C1D E Length specified in parameter * not valid.
CPF3C21 E Format name * is not valid.
CPF3C90 E Literal value cannot be changed.
CPF3CF1 E Error code parameter not valid.
CPF6B35 E File member is in use.
CPF6708 E Command ended due to error.
CPF671F E Parameter list not correct.
CPF67C2 E Path name structure field * not valid.
CPF67C8 E Command faild for device *. Reason code *.
CPF8068 E Error detected while processing file.
CPF9802 E Not authorized to object * in *.
CPF9814 E Device &1 not found.


API introduced: V5R4

[ Back to top | Miscellaneous APIs | APIs by category ]