Vectors returned to the application

When an application specifies the VTRINA and VTRINL parameters on an APPCCMD macroinstruction, VTAM® can return the following vectors:

Local-Nonce Vector: This vector contains the nonce (random data) that the local application will use to generate an encrypted password for the session on which the vector was returned. The vector can be returned on an APPCCMD CONTROL=PREALLOC macroinstruction. The vector ID is X'13'.
Name-Change Vector: This vector indicates whether the partner LU is known by a name other than the one that was provided on the APPCCMD macroinstruction. This vector can be returned on the following macroinstructions:
- APPCCMD CONTROL=ALLOC
- APPCCMD CONTROL=OPRCNTL,QUALIFY=CNOS
- APPCCMD CONTROL=PREALLOC
This vector can also be returned on an ATTN CNOS exit. The vector ID is X'18'.
Partner-Application-Capabilities Vector: This vector provides information about functions supported by the partner LU. This vector can be returned on the following macroinstructions:
- APPCCMD CONTROL=ALLOC
- APPCCMD CONTROL=PREALLOC
- APPCCMD CONTROL=OPRCNTL, QUALIFY=CNOS
- APPCCMD CONTROL=OPRCNTL, QUALIFY=DISPLAY
- APPCCMD CONTROL=RCVFMH5
This vector can also be returned on the ATTN CNOS exit. The vector ID is X'1A'
Partner's-DCE-Capability Vector This vector indicates whether the partner LU supports third party authentication (DCE security). If the partner does support DCE security, it indicates which type of authentication mechanism it uses. Valid authentication mechanisms include:
- DCE authentication
- Kryptoknight
- Kerberos V5
- DCE Performance Mechanism
This vector can be returned on the following macroinstructions:
- APPCCMD CONTROL=PREALLOC
- APPCCMD CONTROL=RCVFMH5
- APPCCMD CONTROL=OPRCNTL, QUALIFY=CNOS
- APPCCMD CONTROL=OPRCNTL, QUALIFY=DISPLAY
This vector can also be returned on an ATTN CNOS exit. The vector ID is X'12'.
Partner's-Nonce Vector: This vector contains the nonce (random data) that the local application will use to verify the partner's encrypted password for the session on which the vector was returned. The vector can be returned on an APPCCMD CONTROL=PREALLOC macroinstruction. The vector ID is X'14'.
PCID Vector: This vector provides the procedure correlation identifier of the session that is being used by a conversation. This vector can be returned on the following macroinstructions:
- APPCCMD CONTROL=ALLOC
- APPCCMD CONTROL=PREALLOC
- APPCCMD CONTROL=RCVFMH5
The vector ID is X'17'.
Receive-FMH_5-Sequence-Number Vector: This vector contains the sequence number that the local application will use to verify the partner's encrypted password for the session on which the vector was returned. The vector can be returned on an APPCCMD CONTROL=RCVFMH5 macroinstruction. The vector ID is X'16'.
Send-FMH_5-Sequence-Number Vector: This vector contains the sequence number that the local application will use to generate an encrypted password for the session on which the vector was returned. The vector can be returned on an APPCCMD CONTROL=PREALLOC macroinstruction. The vector ID is X'15'.
Session-Information Vector: This vector provides information relevant to applications using CSM storage for sending and receiving data. This vector can be returned on the following macroinstructions:
- APPCCMD CONTROL=ALLOC
- APPCCMD CONTROL=PREALLOC
- APPCCMD CONTROL=RCVFMH5
The vector ID is X'19'.
VTAM-to-APPL-Required-Information Vector: This vector indicates whether VTAM was able to return vector information successfully and the minimum length required to contain the vectors. The application can obtain the length required to contain the VTAM-APPCCMD vector list from the APPCCMD-vector-area-length vector, which can be found in the resource-information vector list.
This vector is returned only when other VTAM-APPCCMD vectors are returned. The vector ID is X'10'.

Refer to z/OS Communications Server: SNA Programmer's LU 6.2 Reference for more information about the fields contained in these vectors.

Note: The vector length requested by the application on the VTRINL parameter must be large enough to accept the 2-byte length field of the VTAM-APPCCMD vector list plus the VTAM-to-APPL-required-information vector. Otherwise, VTAM returns an RCPRI, RCSEC combination of X'002C', X'002F', PARAMETER_ERROR— VECTOR_AREA_LENGTH_INSUFFICIENT.