Cooperative Processing Commands › ALLOCATE

ALLOCATE

Purpose

Begins a conversation between an CA ADS dialog and a remote dialog or program. The FORMAT/NOFORMAT setting on the ALLOCATE command must match the FORMAT/NOFORMAT setting on the CONTROL SESSION command.

Syntax

►►─── ALLOCATE LU-NAME name ──┬──────────────────┬────────────────────────────►
                              └─ MODE-NAME name ─┘

 ►─── TPN task-code-name ─────────────────────────────────────────────────────►

 ►──┬───────────────────────────────────────────────────┬─────────────────────►
    └─ SECURITY ─┬─ NONE ◄ ───────────────────────────┬─┘
                 ├─ SAME ─────────────────────────────┤
                 └─ PGM USER-ID id PASSWORD password ─┘

 ►──┬───────────────────────────┬───────┬─ FORMAT ◄ ─┬────────────────────────►
    └─ SYNC-LEVEL ─┬─ NONE ◄ ──┬┘       └─ NOFORMAT ─┘
                   └─ CONFIRM ─┘

 ►──┬─────────────────────────┬─────────┬──────────────────────────┬─── . ────►◄
    └─ LOCAL VERSION version ─┘         └─ REMOTE VERSION version ─┘

Parameters

LU-NAME name

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

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

MODE-NAME name

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

Name Is either a 1- through 8-character mode name or a variable containing the mode name.

If omitted, CA IDMS/DC uses the mode name defined to the APPC line.

TPN task-code-name

A variable or string that contains or specifies the name of the remote program to be initiated by the ALLOCATE command.

If trying to initiate a mainframe CA ADS task, the task-code-name must be a 1- through 8-character task code defined to the remote CA IDMS/DC system that invokes ADSORUN1.

SECURITY

Provides security information to the remote program.

NONE

Specifies that no security information is required for the conversation.

NONE is the default for SECURITY.

SAME

Specifies that the signon user ID is passed to the remote program. The following considerations apply:

• This signon does not work if a password is required to sign on to a separate CA IDMS/DC or CICS system
• This password does not allow you to sign on to the same CA IDMS/DC system (CA IDMS/DC will not support 2 LTEs signed on for the same user at the same time)

PGM USER-ID id

Specifies the user ID of the user who runs the application.

Id is either a 1- through 32-character user ID or a field containing a user ID.

PASSWORD password

Introduces the password of the user who runs the application.

Password is either a 1- through 8-character password or a field containing a password.

This information is used to sign on to the remote logical unit.

SYNC-LEVEL

Introduces the level of synchronization to use for the conversation.

NONE

Specifies that no confirmation commands can be used.

CONFIRM

Specifies that confirmation commands can be used.

FORMAT

Specifies that data will be converted by APPC presentation services before the receiving program sees it:

• Text is converted between ASCII and EBCDIC.
• Numbers are converted between mainframe and PC format.

FORMAT is the default when neither FORMAT or NOFORMAT is specified.

NOFORMAT

Specifies that no data will be converted. If data conversion is required, you must code any data translation or conversion.

LOCAL VERSION version

Specifies either a 1- through 32-character local program version identifier or a field containing a version ID sent to the remote program.

REMOTE VERSION version

Specifies a variable of at least 32 characters to receive the version identifier sent by the remote program.

Example

In order to allocate a conversation with another CA ADS dialog on a different CA IDMS/DC system, code:

ALLOCATE LU-NAME 'S75LU1' TPN 'DLG1' SECURITY NONE
   SYSNC-LEVEL NONE NOFORMAT.

S75LU1 is the logical unit name of an APPC line defined to the local CA IDMS/DC system, and DLG1 is the task code that initiates an CA ADS dialog on the remote CA IDMS/DC system. Security and confirmation are not being used, and conversion is not needed between 2 mainframe applications.