IMS Version 9

/IAM

Format

Read syntax diagramSkip visual syntax diagram>>-/IAM--------------------------------------------------------->

>--+-DONE----------------------------------------------------+-><
   +-LTERM--ltermname--+------------+------------------------+
   |                   '-(password)-'                        |
   '-PTERM--+------------+--LTERM--ltermname--+------------+-'
            '-(password)-'                    '-(password)-'

Environments and Keywords

Table 63 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.

Table 63. Valid Environments for the /IAM Command and Keywords
Command / Keywords DB/DC DBCTL DCCTL
/IAM X X
DONE X X
LTERM X X
PTERM X X

Usage

/IAM is used to sign on to IMS from a terminal that is on a non-VTAM attached switched communication line. This command (without the DONE keyword) must be entered before any input transaction codes or terminal commands are accepted.

The terminal operator has five chances to sign on. If signon is not accomplished after five tries, IMS sends the operator a message indicating that the line is being disconnected. IMS disconnects the line and restores the line to answering status.

/IAM is not supported for Network Terminal Option devices.

DONE
Requests that IMS disconnect your terminal.
LTERM
Indicates this command automatically accomplishes the attachment of a user logical terminal named ltermname to the switched (dialup) communication line over which the call was received from the remote terminal.

If the first four characters of the ltermname parameter are INQU, the connection is completed with the inquiry logical terminal associated with the line/pterm that received the call.

PTERM [password] LTERM ltermname [password]
All logical terminals associated with the user in which logical terminal ltermname exists are signed on to the terminal entering the command. This form of /IAM is required if conversational transactions are to be entered.

Examples

Example 1 for /IAM Command

Entry ET:

  /IAM LTERM SMITH

Response ET:

  DFS058I  IAM COMMAND COMPLETED

Explanation: Logical terminal SMITH is signed on to IMS.

Example 2 for /IAM Command

Entry ET:

  /IAM LTERM INQU

Response ET:

  DFS058I  IAM COMMAND COMPLETED

Explanation: The inquiry logical terminal associated with the line/pterm that received the call is signed on to IMS.

Example 3 for /IAM Command

Entry ET:

  /IAM PTERM (DOLLY) LTERM SUE (GIRL)

Response ET:

  DFS058I  IAM COMMAND COMPLETED

Explanation: All logical terminals associated with the user to which LTERM SUE belongs are signed on to IMS.

Go to the previous page Go to the next page

IBM Confidential

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright: IBM Corporation 1974, 2004 Copyright IBM Corporation 1974, 2004  timestamp Last updated: March, 2004