z/OS Communications Server: SNA Programming
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Vector lists

z/OS Communications Server: SNA Programming
SC27-3674-00

Vector lists provide an open-ended interface for application programs to exchange information with VTAM®. Each vector list contains a 2-byte length field followed by a set of contiguous vectors in random order, as shown in Figure 1.

Figure 1. Format of a vector list
The diagram shows the format of a vector list. A vector list has 2 fields. The first field indicates the total length of the vector list including this 2-byte field itself. The second field contains the vectors.

Each vector in the vector list is a set of contiguous data containing a length field, an identifier, and a value field containing vector data. The fields containing vector data can have trailing blanks. Some vector lists are built before or during OPEN processing, while others are built during processing of the APPCCMD macroinstruction.  Table 1 shows the vector lists available to VTAM applications, the macroinstruction with which they are associated, and their function.

Table 1. Vector lists
Name Pointer Macroinstruction DSECT Purpose Page
Access- Method- Support ACBAMSVL field in the ACB OPEN ACB ISTAMSVL Supplies information to the application about the VTAM that opened the ACB For more information about this vector list, see The access-method-support vector list.
Resource- Information ACBRIVL field in the ACB OPEN ACB ISTRIVL Supplies information to the application about the resources available to the application. For more information about this vector list, see Resource-information vector list.
Application- ACB ACBAVPTR field in the ACB OPEN ACB ISTVACBV Supplies information to VTAM about the application's capabilities. For more information about this vector list, see Vector lists supplying information to VTAM.
VTAM- APPCCMD VTRINA field in the RPL extension APPCCMD ISTAPCVL Supplies information to the application about a particular conversation with a partner LU. For more information about this vector list, refer to z/OS Communications Server: SNA Programmer's LU 6.2 Guide.
Application- APPCCMD VTROUTA field in the RPL extension APPCCMD ISTAPCVL Supplies information to VTAM about a particular request on a conversation with a partner LU  
There are two types of vector lists associated with OPEN processing:
  • Those used by the application program to supply information to VTAM
  • Those used by VTAM to supply information to the application program.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014