如何用CICS读取VSAM文件？遇INVREQ错误（码16）求解决

问题详情 #

使用STARTBR及READNEXT功能读取VSAM文件全部记录时，触发错误码16，对应错误信息：
INVREQ: Read operation not permitted as it is not mentioned in the FCT. Record is locked

相关代码片段：

EXEC CICS READNEXT FILE(filename)
INTO (wa-recrd)
LENGTH(length of wa-recrd)
RIDFLD (record-index)
KEYLENGTH(length of record-index)
SYSID (node-name)
RESP (ws-resp)

解决步骤 #

• 检查FCT配置权限
  错误信息明确指出读取操作未在FCT中授权，需确认该VSAM文件的FCT条目：

  • 确保ACCESS属性包含READ权限，或者明确允许顺序读取（如READNEXT）操作；
  • 如果是跨节点访问（通过SYSID指定远程节点），同步检查远程节点的FCT配置是否一致。

• 排查记录锁定原因
  后半段错误提示记录被锁定，可从这些方向处理：

  • 查看是否有其他任务正在对该记录执行更新或排他性读取操作，等待锁定释放后重试，或优化其他任务逻辑以缩短锁定时间；
  • 检查VSAM文件的SHRLEVEL参数配置，确认是否允许并发读取操作。

• 验证STARTBR前置操作
  READNEXT必须依赖正确执行的STARTBR：

  • 确保STARTBR的FILE、RIDFLD、KEYLENGTH、SYSID参数与后续READNEXT完全匹配；
  • 通过RESP参数检查STARTBR是否执行成功，若STARTBR失败，后续READNEXT必然报错。

• 确认文件类型与读取方式适配
  不同类型的VSAM文件对顺序读取的要求不同：

  • KSDS、RRDS支持STARTBR+READNEXT的顺序读取方式；ESDS也支持，但需确保RIDFLD使用相对字节地址等符合ESDS的规则；
  • 若为KSDS，核对RIDFLD的起始位置是否正确，KEYLENGTH是否与文件定义的键长度一致。

内容的提问来源于stack exchange，提问作者Soraya