Return Error Values
Return Parameters
First Parameter | first word (two characters) of the ASCII fourcharacter error |
| code (for example, •DS" of DS04). For serious errors, this is a |
| numeric error code, and the second and third parameters |
| (below) are meaningless. |
Second Parameter | second word (two characters) of the ASCII fourcharacter error |
| code. |
Third Parameter | number of node reporting the error. |
Remote Interactive Sessions
Remote I/O Mapping allows you to gain access to the remote command interpreters (CI or FMGR). This •virtual terminal" capability allows you to establish a session at a remote node and interact with the command interpreter as if the terminal were connected directly to the remote node.
To set up a remote interactive session, you must perform the following tasks:
DRun IOMAP from REMAT to establish an LU map at the remote node.
DRun SYSAT to get the remote system's attention and logon prompt.
DLogon to the remote node.
These steps are described in the following subsections.
Establishing the Map
Use REMAT to switch to the node at which you want to establish an interactive session. Then, run IOMAP at the remote node, mapping an LU at that node to your terminal's LU at your node.
Get the Remote System's Attention
The next step is to get the remote system's attention. You can use SYSAT to do this, or to set the break bit of a program on a remote node. In gaining system attention on a particular LU, SYSAT has the effect of someone striking a key on a terminal to get a logon (or break mode) prompt.
RU,SYSAT,attentionLU,remoteNode
SYSAT causes the remote node to give its breakmode prompt or the logon prompt on the attentionLU. The attentionLU on the remote node must be a mappable LU. At least one map must have been set up at the specified node for this request to work.
138 Remote I/O Mapping