ARC0195I
TYPE type, KEY key, FIXCDS option, ERROR=error

Explanation

A FIXCDS command failed. The control data set record type is type. The control data set record key is key. The name of the option specified on the FIXCDS command is DISPLAY, PATCH, ADD MDS, DELETE, ASSIGNED, EXPAND, NEWKEY, CREATE, VERIFY, PATCH ENTRY, DELETE ENTRY, VERIFY ENTRY, PATCH GENERATION or DISPLAY GENERATION. Type error has several inserts indicating a specific error condition.
  • CDS ACCESS ERROR — There was an error in reading, writing, or deleting a control data set record.
  • {CREATE | DELETE | NEWKEY} MCU RECORD — The FIXCDS command cannot be used to create, delete or change a new key of the MCDS user record.
  • INVALID KEY LENGTH
    • Either no key was entered on the command or a key with more than the allowable characters was entered on the command.
    • The DFSMShsm internal key for the record does not match the external key of the record after the external key was converted.
  • INVALID OFFSET OR LENGTH
    • The offset or length value entered on the FIXCDS DISPLAY command addresses an area beyond the end of the record specified in the command.
    • The length value entered on the FIXCDS CREATE or FIXCDS ADDMIGRATEDDATASET command is incorrect. Either a value was entered less than the size of the record specified in the command, or the value was greater than the maximum size for the data portion of any DFSMShsm record (1976 bytes).
    • The length of the data patched into the record specified in the FIXCDS PATCH or FIXCDS CREATE command is 0, or the data extends beyond the end of the record when patched into the record starting at the indicated offset in the command.
    • The length value specified on the FIXCDS EXPAND command causes the record specified in the command to exceed the maximum supported record size of 1976 bytes.
  • INVALID RECORD TYPE
    • No record type was entered in the command.
    • The record type entered was not one of the recognized DFSMShsm record types.
    • The option was ADDMIGRATEDDATASET or ASSIGNEDBIT, but the record type entered was not a D (data set).
  • NEW KEY EXISTS—The key specified on the FIXCDS NEWKEY command already exists as the key of another record in the control data set.
  • PATCH MCU AUTHORIZATION FIELDS—The FIXCDS command cannot be used to patch any authorization control fields in the MCDS user record.
  • PATCH VSAM PASSWORD—The offset specified in the FIXCDS PATCH command causes an overlay of the VSAM password storage area in the MCD or MCB record.
  • VERIFY FAILED—The data specified in the FIXCDS VERIFY command did not match the data in the control data set record at the specified location.
  • ENTRY EXISTS—The key specified on the FIXCDS ENTRY command exists as the entry name of another record entry in the specified control data set record.
  • ENTRY NOT FOUND—The key specified on the FIXCDS ENTRY command was not found in the specified control data set record.
  • NO SPACE—The control data set record specified on the FIXCDS CREATE ENTRY command does not have enough space remaining to add the requested entry.
  • RECORD EXISTS—The control data set record specified already exists.
  • PATCH MCL RECORD KEY—The offset specified for either the FIXCDS PATCH or FIXCDS CREATE command specified in the first 2 bytes of the MCL record data area. This area is not changeable.
  • MCD RECORD NOT FOUND—The associated MCD record was not found for the data set name specified on the FIXCDS CREATE command. An associated MCD record must already exist for the MCL record creation. FIXCDS PATCH or FIXCDS CREATE command specified in the first 2 bytes of the MCL record data area. This area is not changeable.
  • MCD RECORD NOT FOUND—The associated MCD record was not found for the data set name specified on the FIXCDS CREATE command. An associated MCD record must already exist for the MCL record creation.
  • INVALID OPERATION
    • The VERIFY parameter is only valid when used alone or with the PATCH, DELETE, or DISPLAY parameters.
    • The ENTRY parameter is valid only when specified with BVR or TTOC records.
    • The GENERATE keyword only is valid when used with the PATCH or DISPLAY parameters and specified with the MCB record.
  • RECORD NOT FOUND—The indicated record was not found; you could not delete or update it.
  • RECORD IN USE—The indicated record was in use; you could not delete or update it.
  • NEWKEY MCL RECORD—You could not use the FIXCDS NEWKEY command to change the MCL record. If an MCL record is desired for a different data set, use the FIXCDS CREATE command.

System action

The FIXCDS request fails. DFSMShsm processing continues.

Programmer response

Verify the original command, correct the input parameters where necessary, and reissue the command. Should this message recur, notify the system programmer. If error is CDS ACCESS ERROR, the error is probably caused by a system problem. If the error is one of the following, the error is probably a user error.
  • INVALID KEY LENGTH
  • INVALID OFFSET OR LENGTH
  • PATCH VSAM PASSWORD
  • INVALID RECORD TYPE
Other values for error indicate either a user or a system problem.
  • You can modify the contents of the authorization control fields in the MCU record by entering the AUTH command with the DBA (USER) or DBA (CONTROL) parameters.
  • You can create the MCU record by entering the AUTH command with the DBA (USER) or DBA (CONTROL) parameters.
  • You can delete the MCU record by entering the AUTH command with the REVOKE parameter.
  • You cannot use the FIXCDS NEWKEY command for user (MCU) records. To authorize a person who is not currently authorized for DFSMShsm commands, use the AUTH command to create a new MCU record for the user. If the other user should no longer be authorized, use the AUTH command to revoke the user's authorization.
  • You cannot use the FIXCDS CREATE or PATCH command to change the first 2 bytes of the MCL record. If you change these 2 bytes, you also chang the data set name associated with the record. If you need an MCL record for a different data set, use the FIXCDS CREATE command.

Source

DFSMShsm

Parent topic: ARC messages