START_BROWSE_PROGRAM 调用

START_BROWSE_PROGRAM 返回一个令牌,该令牌使您能够开始浏览程序定义, (可选) 从指定程序的定义开始。

START_BROWSE_PROGRAM

DFHPGISX [CALL,]
      [CLEAR,]
      [IN,
      FUNCTION(START_BROWSE_PROGRAM),
      [PROGRAM_NAME(name8 | string | 'string'),]
      [OUT,
      BROWSE_TOKEN(name4)
      RESPONSE(name1 | *),
      REASON(name1 | *)]

此命令是线程安全的。

BROWSE_TOKEN (name4)
返回要在 GET_NEXT_PROGRAM 调用上使用的令牌,以启动程序定义的顺序浏览。
name4
用于接收 4 字节令牌的位置的名称。
PROGRAM_NAME (name8 | string | 'string ')
指定要首先查看其定义的程序的名称。 浏览序列按字母顺序排列。 如果没有具有指定名称的程序,那么 CICS® 将以字母顺序返回下一个定义的令牌。 如果未指定程序,那么 CICS 将返回第一个定义的令牌。
name8
包含 8 字节程序名的位置的名称。
字符串(string)
用于命名程序的字符串。
"string"
用引号括起的字符串。 通过空白填充或截断将字符串长度设置为 8。

START_BROWSE_PROGRAM 的 RESPONSE 和 REASON 值

RESPONSE 推理
确定
EXCEPTION  
DISASTER ABEND
  INVALID_DIRECTORY
  位置错误
INVALID
KERNERROR
PURGED