Int 68 Fn 02  - Appc/pc - Connection Control - Allocate                    [N]

   AH = 02h subfn 0100h
   DS:DX -> control block

Return: control block updated

See Also: AH=02h/SF=0500h

Format of control block:
Offset Size    Description
 00h 12 BYTEs  reserved
 0Ch   WORD    0100h (verb "Allocate" or "MC_Allocate")
 0Eh   BYTE    1 if MC_ (mapped conversation) form of verb
       0 if basic verb
 0Fh  5 BYTEs  reserved (0)
 14h   WORD    (big-endian) primary return code (see below)
 16h   DWORD   (big-endian) error code (see below)
 1Ah  8 BYTEs  (big-endian) TP_ID
 22h   DWORD   (big-endian) conversation ID
 26h   BYTE    (MC_Allocate only) 0 basic conversation
                  1 mapped conversation
 27h   BYTE    SYNC_LEVEL (00h none, 01h confirm)
 28h   WORD    0000h
 2Ah   BYTE    00h RETURN_CONTROL: when session allocated
       01h RETURN_CONTROL: immediate
       02h RETURN_CONTROL: when session free
 2Bh  8 BYTEs  00h
 33h  8 BYTEs  (big-endian) partner logical unit name
 3Bh  8 BYTEs  (big-endian) mode name
 43h 65 BYTEs  (counted string) TP name
 84h   BYTE    security (00h none, 01h same, 02h pgm)
 85h 11 BYTEs  00h
 90h 11 BYTEs  (counted string) password
 9Bh 11 BYTEs  (counted string) user ID
 A6h   WORD    PIP_DATA length
 A8h   DWORD   pointer to PIP_DATA

Values for primary return code:
 0000h successful
 0001h parameter check
 0002h state check
 0003h allocation error
 0005h deallocate abended
 0006h deallocate abended program
 0007h deallocate abended SVC
 0008h deallocate abended timer
 0009h deallocate normal return
 000Ah data posting blocked
 000Bh posting not active
 000Ch PROG_ERROR_NO_TRUNC
 000Dh PROG_ERROR_TRUNC
 000Eh PROG_ERROR_PURGING
 000Fh CONV_FAILURE_RETRY
 0010h CONV_FAILURE_NO_RETRY
 0011h SVC_ERROR_NO_TRUNC
 0012h SVC_ERROR_TRUNC
 0013h SVC_ERROR_PURGING
 0014h unsuccessful
 0018h CNOS partner logical unit reject
 0019h conversation type mixed
 F001h APPC disabled
 F002h APPC busy
 F003h APPC abended
 F004h incomplete

Values for error code:
 0001h bad TP ID
 0002h bad conversation ID
 0004h allocation error, no retry
 0005h allocation error, retry
 0006h data area crosses segment boundary
 0010h bad TPN length
 0011h bad CONV length
 0012h bad SYNC level
 0013h bad security selection
 0014h bad return control
 0015h SEC_TOKENS too big
 0016h PIP_LEN incorrect
 0017h no use of SNASVCMG
 0018h unknown partner mode
 0031h confirm: SYNC_NONE
 0032h confirm: bad state
 0033h confirm: NOT_LL_BDY
 0041h confirmed: bad state
 0051h deallocate: bad type
 0052h deallocate: flush bad state
 0053h deallocate: confirm bad state
 0055h deallocate: NOT_LL_BDY
 0057h deallocate: log LL_WRONG
 0061h flush: not send state
 0091h post on receipt: invalid length
 0092h post on receipt: not in receive state
 0093h post on receipt: bad fill
 00A1h prepare to receive:invalid type
 00A2h prepare to receive: unfinished LL
 00A3h prepare to receive: not in send state
 00B1h receive and wait: bad state
 00B2h receive and wait: NOT_LL_BDY
 00B5h receive and wait: bad fill
 00C1h receive immediate: not in receive state
 00C4h receive immediate: bad fill
 00E1h request to send: not in receive state
 00F1h send data: bad LL
 00F2h send data: not in send state
 0102h send error: log LL wrong
 0103h send error: bad type
 0121h test: invalid type
 0122h test: not in receive state