/ALLOCATE command
Use the /ALLOCATE command 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 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 non-shared-queues environment) an error message is issued.
Environment
The following table lists the environments (DB/DC, DBCTL, and DCCTL) in which you can use the command and keywords.
| Command / Keywords | DB/DC | DBCTL | DCCTL |
|---|---|---|---|
| /ALLOCATE | X | X | |
| LUNAME | X | X | |
| MODE | X | X | |
| TPNAME | X | X |
Syntax
Keywords
The following keywords apply to the ALLOCATE command:
- LUNAME
- 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.
- TPNAME
- Specifies the TP name of the LU 6.2 application program that is to be allocated.
Usage notes
/ALLOCATE requires an end-of-message (EOM) indicator. An end-of-segment (EOS) indicator must be included for all segments preceding the last segment.
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.
This command can be issued to an IMSplex using the Batch SPOC utility.