OSCaR Commands › OSCaR Command Syntax › OPEN

OPEN

Purpose

Establishes a conversation.

Syntax

►►─── OPEN CONVersation ──────────────────────────────────────────────────────►

 ►─┬────────────────────────────────────────┬─────────────────────────────────►
   └─ LU-NAME lu-name ─┬──────────────────┬─┘
                       └─ MODE mode-name ─┘

 ►─┬──────────────────────────────────────────────────────────────────────────►─
   └─ TRANSACTION task-code ─┬────────────────────────────────────────────┬───
                             └─ SECURITY user-id ─┬─────────────────────┬─┘
                                                  └─ PASSWORD password ─┘

─►────────────────────────────────────────────┬───────────────────────── . ───►◄
  ─┬────────────────────────────────────────┬─┘
   └─ LU-NAME lu-name ─┬──────────────────┬─┘
                       └─ MODE mode-name ─┘

Parameters

TRANSACTION task-code

Indicates that the dialog runs as a client; task-code names the task to be invoked on the remote logical unit.

If task-code names a mainframe CA ADS dialog, it must be defined on the remote logical unit as invoking program ADSORUN1.

SECURITY user-id

Specifies the identifier of user to be signed on to the remote logical unit.

If SECURITY is not specified, signon is performed with no user identifier.

PASSWORD password

Specifies the password associated with user-id during signon to the remote logical unit. If PASSWORD is not specified, signon is performed with no password.

LU-NAME lu-name

Specifies a field or string that identifies the 1- through 8-character name of the logical unit used by the remote dialog.

Lu-name must match the logical unit name of an APPC line defined to the local CA IDMS/DC system.

If LU-NAME is not specified, lu-name is the value of the ADSLUNAM attribute for the user session.

MODE mode-name

Specifies the name used by the remote logical unit to select the mode of transmission for the conversation.

Mode-name is either a 1- through 8-character mode name or a variable containing the mode name.

If MODE is not specified, mode-name is the value of the ADSMODE attribute for the user session. If there is no ADSMODE attribute, the value is the default mode name defined by the DLOGMOD parameter within the VTAM definition. If there is no default mode in the VTAM definition, the dialog aborts.

Usage

Placement of OPEN CONVERSATION

OPEN must be the first APPC command encountered in an OSCaR dialog.

OPEN CONVERSATION with No Parameters

If no parameters are specified on OPEN CONVERSATION, the dialog runs as a server.