IMS Version 9

/ALLOCATE

Format

Read syntax diagramSkip visual syntax diagram>>-+-/ALLOCATE-+------------------------------------------------>
   '-/ALL------'

>----LU--luname--TPNAME--tpname--+--------------------+--------><
                                 '-MODE--+-modename-+-'
                                         '-NONE-----'

Environments and Keywords

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

Table 16. Valid Environments for the /ALLOCATE Command and Keywords
Command / Keywords DB/DC DBCTL DCCTL
/ALLOCATE X X
LU X X
MODE X X
TPNAME X X

Usage

/ALLOCATE is a multisegment command similar to the /OPNDST command for VTAM terminals. It causes IMS to allocate a conversation to the specified LUNAME and TPNAME if any output is queued in IMS for that destination. If no such output exists, the command has no effect and (in a nonshared-queues environment) an error message is issued.

The /ALLOCATE command is used for delivering asynchronous output when the LU 6.2 device is available. The command can be originated by the remote LU 6.2 device for this purpose.

/ALLOCATE requires an end-of-message (EOM) indicator. An end-of-segment (EOS) indicator must be included for all segments preceding the last segment. For more information, see Multisegment Command Input

After the syntax checking of the /ALLOCATE command is successfully completed, the DFS058 ALLOCATE COMMAND COMPLETED message is issued and processing of the command continues asynchronously.

LU
Specifies the LU name of the LU 6.2 application program that is to be allocated. A network-qualified LU name is optional for the LUNAME keyword
MODE
identifies the LOGON MODE table entry that VTAM uses to determine the session operating characteristics. NONE, which can be used as a MODE keyword parameter, resets the MODE field to its null state.

For more information on the MODE value, see IMS Version 9: Administration Guide: Transaction Manager.

TPNAME
Specifies the TP name of the LU 6.2 application program that is to be allocated.

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