ISSUE PASS
z/OS® Communications Server 应用程序路由。
语法
条件: INVREQ , LENGERR 和 NOTALLOC
NOHANDLE、RESP 和 RESP2是常用选项,可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项.
描述
ISSUE PASS 在任务终止后将终端与 CICS® 断开连接,并将其传输到 LUNAME 选项中定义的 z/OS Communications Server 应用程序。
此命令要求在发出 AUTH=PASS 的 CICS 终端拥有系统的 z/OS Communications Server APPL 宏上编码 AUTH=PASS ,在可能使用此功能的任何终端的 RDO TYPETERM 资源定义中使用离散 Q=YES 或 RELREQ=YES。
如果指定的 LUNAME 是另一个 CICS 系统的名称,那么可以使用 EXTRACT LOGONMSG 命令来访问此命令所引用的数据。
由于 z/OS Communications Server 限制,用户数据的最大长度限制为 255 个字节。
选项
- FROM (数据区)
- 指定包含要传递到 LUNAME 选项中指定的应用程序的登录用户数据的数据区。 如果在 LUTYPE6.1 命令上指定了 ATTACHID ,那么可以省略此选项。
- LENGTH (data-value)
- 指定发出的数据的长度 (作为半字二进制值)。
- LOGMODE (data-value)
- 指定 z/OS Communications Server 用于建立新会话的 z/OS Communications Server 登录方式表条目的名称 (1-8 个字符)。
- LOGONLOGMODE
- 指定将在会话登录时使用正在使用的 z/OS Communications Server 登录方式表条目来建立新会话。注意:保存的日志模式名称来自 X'0D' CINIT 中的 z/OS Communications Server控制向量。 这是此系统中已知的日志方式名称。
如果正在使用持久会话 (SIT 中的 PSDINT=nnn) ,那么要被 ISSUE PASSed 的任何终端的 TYPETERM 定义都应该使用 RECOVOPTION (NONE) ,因为在持久会话重新启动期间未恢复登录 LOGMODE 名称。
如果既未提供 LOGMODE ,也未提供 LOGONLOGMODE ,那么将使用缺省 LOGMODE 建立新会话。
- LUNAME (名称)
- 指定要将终端传递到的 z/OS Communications Server 应用程序的名称 (1-8 个字符)。
- NOQUIESCE
- 指定用户可以选择从某些传递失败中恢复。
条件
- 16 INVREQ
- 如果该命令对正在使用的逻辑单元无效,那么将发生此错误。
缺省操作: 异常终止任务。
- 22 LENGERR
- 如果在 LENGTH 选项中提供了超出范围的值,那么将发生此情况。
缺省操作: 异常终止任务。
- 61 个 NOTALLOC
- 如果命令中指定的设施不是由应用程序拥有,那么将发生此情况。
缺省操作: 异常终止任务。
