z/OS Communications Server: SNA Programmer's LU 6.2 Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


RPL control block and APPC extension

z/OS Communications Server: SNA Programmer's LU 6.2 Guide
SC27-3669-00

Application programs request LU 6.2 services from VTAM® with the APPCCMD macroinstruction. The APPCCMD macroinstruction uses a request parameter list (RPL) to describe its requests to VTAM and to provide necessary processing information. The RPL is a control block that LU 6.2 application programs use frequently. It must be specified on each APPCCMD or other macroinstruction issued by the application to request VTAM services.

Application programs can explicitly set RPL fields themselves and specify only the address of the RPL on the VTAM macroinstruction, or they can use operands on the macroinstruction that cause VTAM to set the relevant RPL fields for a particular operation. As with any RPL-based request, the application program can specify an exit routine to receive control when the operation completes.

For APPCCMD requests, an RPL extension is used with the RPL. An RPL APPC extension supports only LU 6.2 functions. This extension is not appended to the RPL but is pointed to by the AAREA field in the RPL. In effect, the RPL for APPCCMD macroinstructions consists of a linked data structure. VTAM supplies the macroinstruction ISTRPL6 to create this extension and the DSECT ISTRPL6X to enable the application program to refer to its fields symbolically.

The following keyword operands for the RPL are valid for APPCCMD macroinstructions:
  • ACB
  • AAREA
  • AREA
  • AREALEN
  • BRANCH
  • ECB
  • EXIT
  • OPTCD
  • RECLEN
All other information in the RPL that pertains to LU 6.2 functions is in the extension. The length of the extension is found in AAREALN. The length is determined and the length field properly initialized by the APPCCMD macroinstruction. The application program does not need to modify this field.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014