ALLOCATE

Acquire a session to a remote APPC logical unit for use by an APPC mapped conversation.

ALLOCATE

SYSID(systemname)
[ PROFILE(name) ]
[ PARTNER(name) ]
[ STATE(cvda) ]

Options

PARTNER

specifies the name (8 characters) of a set of definitions that include the names of a remote LU (NETNAME) and a communication profile to be used on the allocated session. You can use this option as an alternative to specifying SYSID and PROFILE explicitly.

PROFILE

specifies the name (1-8 characters) of a set of session-processing options that are to be used during the execution of mapped commands for the session specified in the SYSID option. If you specify SYSID and omit PROFILE, a default profile (DFHCICSA) is selected.

STATE

gets the state of the current conversation. The cvda value returned by CICS is ALLOCATED.

SYSID

specifies the name (1-4 characters) by which the remote APPC LU is known to this CICS. This option requests that one of the sessions to the named system is to be allocated.