Initiates an advanced program-to-program communications (APPC) mapped conversation.
APPC conversations allow data to be sent and received between programs that are running in remote systems.
This is called Distributed Transaction Programming (DTP).
For guidance information about DTP, refer to the TXSeries for Multiplatforms Intercommunication Guide.

Sintaxe

Condições: INVREQ, SYSIDERR

Nota:

NOSUSPEND is ignored on TXSeries for Multiplatforms.

Descrição:

ALLOCATE requests a conversation with a remote region. CICS returns the four-byte CONVID (conversation identifier) in the EIBRSRCE field of the EIB.
The application program uses the CONVID in all subsequent commands that relate to the conversation.

If the session is not available, the application is suspended until one is available; this is the default action.

Nota:

If no session is available and the NOQUEUE qualifier has been specified with the ALLOCATE command, the occurrence of the SYSBUSY condition is delayed until the application issues the CONNECT PROCESS command.

Opções:

NOQUEUE
• Overrides the default action, which is to suspend the program, when no session is available.
• NOQUEUE specifies that if no session is available, CICS does not suspend the application program but returns control to the program instruction that follows the command.
• A SYSBUSY condition occurs on a later CONNECT PROCESS command.
• See CONNECT PROCESS for further information.
• Nota:
  • If a HANDLE CONDITION is active for the SYSBUSY condition when the CONNECT PROCESS command is executed, the HANDLE CONDITION overrides both the default setting and the NOQUEUE option. Control passes to the program in the label field that is supplied with the HANDLE CONDITION.
  • However, if the HANDLE CONDITION is set to either NOHANDLE or RESP, the HANDLE CONDITION is negated and the default setting or the NOQUEUE qualifier takes effect.

NOSUSPEND
• An alternative keyword for NOQUEUE. It has the same meaning in CICS.
• However, NOSUSPEND has no effect in TXSeries for Multiplatforms.

PROFILE(name)
• Specifies the name (maximum of eight characters) of a mode that is defined to the local SNA software.
• This mode contains a set of session-processing options that CICS uses during the conversation.
• If you do not specify this option, CICS uses a default mode name.
• For more information, see the TXSeries for Multiplatforms Intercommunication Guide.
• Note:
  • The PROFILE option is ignored over TCP/IP connections.

STATE(cvda)
• Gets the state of the current conversation. CICS returns the CICS-Value Data Area (CVDA) value ALLOCATED.
• See STATE.

SYSID(name)
• Specifies the name of a Communications Definition (CD) entry that defines the location of the system in which the remote program resides.
• The name of the SYSID can be up to four characters long.

Condições

INVREQ
• Occurs if the CD entry that is requested in the SYSID option is defined with a ConnectionType that does not support APPC conversations.
• Ação pré-definida: Terminates the task abnormally.

SYSIDERR
• Occurs if a problem occurs with the communications configuration that prevents the ALLOCATE from proceeding.
• For example:
  • The connection that is named in the SYSID option is not the name of a CD entry.
  • The SYSID option references a CD entry that is incorrectly configured.
  • The SYSID option references a CD entry that is marked as out of service.
• Ação pré-definida: Terminates the task abnormally.

Informação relacionadas

• CONNECT PROCESS
• CICS-value data areas (CVDA)
• TXSeries for Multiplatforms Administration Reference
• TXSeries for Multiplatforms Intercommunication Guide