XPCCB (Cross-Partition Control Block) Macro

This macro sets up a cross-partition communication control block XPCCB.

Each connection or communication path between the two applications is represented by a unique XPCCB. The address of the XPCCB is indicated in the XPCC macro. The corresponding DSECT is generated with the MAPXPCCB macro. This mapping DSECT can be used to reference or modify the control block fields at execution time when setting up a z/VSE XPCC request or when checking the status of the XPCC connection.

Format

Read syntax diagramSkip visual syntax diagramnameXPCCB APPL= name,TOAPPL=nameANY,BUFFER=addr( addr, length),REPAREA=( addr, length),MECB=addr(S, addr),VERSION=1,VERSION=2

Requirements for the caller

RMODE:
24 or ANY

Parameters

APPL=name
Specifies the name of the application that requests XPCC service. It can be up to 8 bytes long and must not contain blanks or all binary zeros (printable characters are recommended). Application names that start with SYS are reserved for programs that are written by IBM®.
TOAPPL=name | ANY
Specifies the name of the application to which communication is to be established.

ANY indicates that an open communication link is to be set up, which means that any other application can link up. (ANY must not be used as application name.)

BUFFER=addr | (addr,length)
Specifies the address of one or more buffer areas for the data transmission request, where addr is a pointer to a list of 8-byte fields, as described under the BUFFER operand in the MAPXPCCB (Map Cross-Partition Control Block) Macro. If the list contains only one entry, it can be specified directly by (addr,length) instead of addr.
REPAREA=(addr,length)
Specifies, for the SENDR function, the address of the data area into which the reply is to be moved.
MECB=addr | (S,addr)
Specifies, for the CONNECT request, the address of a 'main ECB', which is always posted when any of the XPCC ECBs is posted. All tasks that wait for the MECB are taken out of the wait state.
VERSION=1 | 2
Indicates the version of the XPCCB. Two versions of the XPCCB are maintained: VERSION=1 is the default. VERSION=2 is required if the application wants to use the TIMEOUT, SENDI, or MECB functions of the XPCC support.