Programming Interface Information: This page documents intended Programming Interfaces that allow the customer to write programs to obtain the services of z/VM.

#### IPARML

Prolog

Control Block Contents
IPARML DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### IPARML Prolog

     Name       : IPARML
     Description: IUCV/APPC parameter list and external
                  interrupt mapping DSECT.
     COPYRIGHT -
                  5654-A17 (C) COPYRIGHT IBM CORP. - 1985, 2001
                  LICENSED MATERIALS - PROPERTY OF IBM
     DSECT      : IPARML
     Function   : To map the parameter list used when an IUCV or
                  APPC/VM function is issued, and to map the
                  external interrupt buffer when an IUCV or APPC/VM
                  external interrupt is reflected to a virtual
                  machine or a CP System Service.
     Located by : Parameter list address is specified by a user
                  virtual machine.
                  External interrupt is specified by the user
                  virtual machine and maintained in IUCBFAD1
                  IUCBFAD2 fields in HCPIUCVB.
     Created by : User virtual machine:
                  -Parameter list passed on most IUCV functions.
     Deleted by : User virtual machine.
     NOTES      : ANY CHANGES TO IPARML COPY SHOULD ALSO BE MADE IN THE
                  INTERNAL CMS VERSION, DMSIPMLP, TO KEEP THE MAPPING IN
                  SYNC BETWEEN CP AND CMS.  THE CMS BILINGUAL MACRO,
                  DMSIPML, USES THE ASSEMBLER COPY FUNCTION TO INCLUDE
                  IPARML COPY WHEN INVOKED FROM AN ASSEMBLER MODULE.

#### IPARML Control Block Content

#### IPARML DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      IPARML         IUCV/APPC parameter list and
                                            external
    0000    0 Signed       2 IPPATHID (0)   IUCV/APPCVM COMMUNICATION PATHID
    0000    0 Bitstring    1 IPMASK (0)     ENABLE MASK
              1... ....      IPSNDN         X'80' ENABLE FOR NON-PRIORITY
                                            MESSAGES
              .1.. ....      IPSNDP         X'40' ENABLE FOR PRIORITY
                                            MESSAGES
              ..1. ....      IPRPYN         X'20' ENABLE FOR NON-PRIORITY
                                            REPLIES
              ...1 ....      IPRPYP         X'10' ENABLE FOR PRIORITY REPLIES
              .... 1...      IPCTRL         X'08' ENABLE FOR IUCV CONTROL
                                            INTERRUPT
    0000    0 Bitstring    1 IPCMASK        ENABLE CONTROL MASK
              1... ....      IPCLPC         X'80' ENABLE FOR PENDING
                                            CONNECTION
              .1.. ....      IPCLCC         X'40' ENABLE FOR COMPLETE
                                            CONNECTION
              ..1. ....      IPCLPS         X'20' ENABLE FOR SEVER INTERRUPT
              ...1 ....      IPCLPQ         X'10' ENABLE FOR QUIESCE
                                            INTERRUPT
              .... 1...      IPCLPR         X'08' ENABLE FOR RESUME INTERRUPT
    0001    1 Bitstring    1 *
    0002    2 Bitstring    1 IPFLAGS1       FLAGS BYTE
              1... ....      IPALL          X'80' QUIESCE, RESUME, SEVER ALL
              1... ....      IPRMDATA       X'80' MESSAGE IS IN PARAMETER
                                            LIST
              1... ....      IPDELAY        X'80' RETURN PURGED MSGBK/IXBLKS
              1... ....      IPAPPCPG       X'80' PURGE allowed
                                            (connect/senddata)
              .1.. ....      IPQUSCE        X'40' CONNECT IN QUIESCE MODE
              .1.. ....      IPBUFLST       X'40' INDICATES BUFFER LIST
                                            OPTION
              .1.. ....      IPMSGRET       X'40' RETURN PURGED MSGBK/IXBLKS
              .1.. ....      IPFLUSH        X'40' PARTNER ISSUED SENDDATA
                                            FLUSH=YES
              .1.. ....      IPSYNCSN       X'40' SYNCHRONOUS SEND REQUESTED
                                            - MPI
              ..1. ....      IPPRTY         X'20' PRIORITY MESSAGE OR REPLY
              ..1. ....      IPQPRTY        X'20' PRIORITY HIGH FOR CONNECT
              ..1. ....      IPNLUWOK       X'20' SENDER OF FORGET SUPPORTS
                                            SENDLUW
              ..1. ....      IPURGBKR       X'20' SEVER PURGED BKOUT_REQ
                                            INTERRUPT
              ...1 ....      IPNORPY        X'10' ONE WAY PROTOCOL
              ...1 ....      IPKEEP         X'10' SEVER KEEP=YES
              ...1 ....      IPRESYNC       X'10' INVOKER SPECIFIED
                                            RESYNC=YES
              ...1 ....      IPLRECL        X'10' LOGICAL RECORD IN PROGRESS
              ...1 ....      IPVERIFY       X'10' Remote target VERIFY needed
              .... 1...      IPAPPC         X'08' APPC protocol used on path
              .... 1...      IPANSLST       X'08' INDICATES ANSWER LIST
                                            OPTION
              .... .1..      IPFGMID        X'04' MESSAGE ID SPECIFIED
              .... .1..      IPCNTRL        X'04' INDICATES CONTROL BUFFER
                                            OPTION
              .... .1..      IPSYNC         X'04' SYNCHRONOUS SEND REQUEST
                                            (INPUT)
              .... ..1.      IPREMOTE       X'02' PATH INCLUDES A COMSRV V.M.
              .... ..1.      IPFGPID        X'02' PATH ID SPECIFIED
              .... ..1.      IPAPPCSN       X'02' AN APPCVM SEND FUNCTION
                                            ISSUED
              .... ..1.      IPSYNCFL       X'02' SEVER ISSUED DURING SYNCPT
              .... ...1      IPFGMCL        X'01' MESSAGE CLASS SPECIFIED
              .... ...1      IPFREPTH       X'01' SEVER ISSUED TO FREE UP
                                            PATH ID
              .... ...1      IPLOCAL        X'01' IUCV CONNECT ON LOCAL SYS
                                            ONLY
              .... ...1      IPWIN          X'01' SENDBACK MUST WIN IF CRASH
    0003    3 Bitstring    1 IPTYPE (0)     EXTERNAL INTERRUPT CODE
              00000001       IPTYPPC        X'01' EXT INT TYPE - PENDING
                                            CONNECTION
              00000002       IPTYPCC        X'02' EXT INT TYPE - CONNECTION
                                            COMP.
              00000003       IPTYPSV        X'03' EXT INT TYPE - SEVERED
                                            CONNECTION
              00000004       IPTYPQS        X'04' EXT INT TYPE - QUIESCED
                                            CONN.
              00000005       IPTYPRS        X'05' EXT INT TYPE - RESUMED
                                            CONNECTION
              00000006       IPTYPRP        X'06' EXT INT TYPE - INCOMING
                                            PRTY RPLY
              00000007       IPTYPRNP       X'07' EXT INT TYPE - INCOMING
                                            REPLY
              00000008       IPTYPMP        X'08' EXT INT TYPE - INCOMING
                                            PRTY MSG
              00000009       IPTYPMNP       X'09' EXT INT TYPE - INCOMING
                                            MESSAGE .
              00000081       IPTYPPCA       X'81' APPC INT - PENDING
                                            CONNECTION
              00000082       IPTYPCCA       X'82' APPC INT - CONNECTION
                                            COMPLETE
              00000083       IPTYPSVA       X'83' APPC INT - SEVER INTERRUPT
              00000087       IPTYPFCA       X'87' APPC INT - FUNCTION
                                            COMPLETE
              00000088       IPTYPSRA       X'88' APPC INT - SENDREQ
                                            INTERRUPT
              00000089       IPTYPMPA       X'89' APPC INT - INCOMING MESSAGE
              0000008A       IPTYPBKR       X'8A' APPC INT - BACKOUT REQUIRED
    0003    3 Bitstring    1 IPCPSYS (0)    CP SYSTEM ON THE INVOKER= PARM
         RETURN CODES DEFINED TO IUCV GENERAL USAGE
    0003    3 Bitstring    1 IPRCODE        RETURN CODE
              00000001       IPRCNPTH       1 INVALID PATH ID
              00000002       IPRCNSND       2 PATH QUIESCED - NO SENDS
                                            ALLOWED Notes : IPRCNSND will
                                            also be issued if, during SEND
                                            processing, it is determined that
                                            the Target has severed the path
                                            or a SEVER is in progress.
              00000003       IPRCMSCT       3 MESSAGE LIMIT EXCEEDED
              00000004       IPRCNPTY       4 PRTY MESSAGES NOT ALLOWED ON
                                            PATH
              00000005       IPRCRCVS       5 BUFFER TOO SHORT FOR MESSAGE
              00000006       IPRCPRTC       6 FETCH PROTECTION EXCEPTION
              00000007       IPRCADRC       7 ADDRESSING EXCEPTION
              00000008       IPRCNODT       8 MSGID FND, BUT CLASS/PATH
                                            INVALID
              00000009       IPRCPRGD       9 MESSAGE HAS BEEN PURGED
              0000000A       IPRCMSLN       10 MESSAGE LENGTH NEGITIVE
              0000000B       IPRCNLOG       11 TARGET IS NOT LOGGED ON
              0000000C       IPRCNTRG       12 TARGET HAS NOT DECLARED A
                                            BUFFER
              0000000D       IPRC2MYI       13 INVOKER MAX CONNECTIONS
                                            EXCEEDED
              0000000E       IPRC2MYT       14 TARGET MAX CONNECTIONS
                                            EXCEEDED
              0000000F       IPRCBADR       15 NOT AUTHORIZED TO CONNECT TO
                                            TARG
              00000010       IPRCINSV       16 INVALID CP SYSTEM SERVICE NAME
              00000011       IPRCBDFN       17 INVALID FUNCTION CODE
              00000012       IPRCBDLM       18 INVALID MSGLIMIT
              00000013       IPRCHSBF       19 ALREADY HAS DECLARED A BUFFER
              00000014       IPRCPTSV       20 PATH HAS BEEN SEVERED
              00000015       IPRCNPRM       21 PARAM. LIST MESSAGE NOT
                                            ALLOWED
              00000016       IPRCSLST       22 SEND LIST INVALID
              00000017       IPRCNLEN       23 NEGATIVE LENGTH IN LIST
              00000018       IPRCTLEN       24 TOTAL LENGTH IS NOT LIST
                                            LENGTH INVALID TOTAL LIST LENGTH
              00000019       IPRCPLST       25 PRMMSG & BUF/ANSLIST NOT
                                            ALLOWED
              0000001A       IPRCBBND       26 BUFFER LIST NOT D-WORD ALIGNED
              0000001B       IPRCABND       27 ANSWER LIST NOT D-WORD ALIGNED
              0000001C       IPRCNCTL       28 NO CONTROL BUFFER EXISTS
              0000001D       IPRCCSRV       29 NOT AUTHORIZED AS COMM. SERVER
              0000001E       IPRCNAPP       30 APPC FUNCTION ON AN IUCV PATH
              0000001F       IPRCAPPC       31 APPC PATH TRIED AN IUCV ONLY
                                            FUNC
              00000020       IPRCCONN       32 INVALID FUNC. FROM CONNECT
                                            STATE
              00000021       IPRCSEND       33 INVALID FUNC. FROM SEND STATE
              00000022       IPRCRECV       34 INVALID FUNC. FROM RECEIVE
                                            STATE
              00000023       IPRCCONF       35 INVALID FUNC. FROM CONFIRM
                                            STATE
              00000024       IPRCSEVR       36 INVALID FUNC. FROM SEVER STATE
              00000025       IPRCSYNC       37 CONN. ESTABLISHED SYNCLVL=NONE
              00000026       IPRCSNOP       38 INV. SEND FUNC. CODE
                                            (IPSENDOP)
              00000027       IPRCCENL       39 INV. CONNECTION EXTENSION LEN.
              00000028       IPRCLUNM       40 INVALID LU_NAME SPECIFIED
              00000029       IPRCMODE       41 INVALID MODE NAME SPECIFIED
              0000002A       IPRCIRLN       42 INVOKER HAD INVALID LOGICAL
                                            RECORD LENG
              0000002B       IPRCTRLN       43 TARGET HAD INVALID LOGICAL
                                            RECORD LENGT
              0000002C       IPRCITRN       44 INVOKER TRUNCATED LOGICAL
                                            RECORD
              0000002D       IPRCTTRN       45 TARGET TRUNCATED LOGICAL
                                            RECORD
              0000002E       IPRCSEVC       46 INVALID SEVER CODE SPECIFIED
              0000002F       IPRCSECR       47 INVALID SECURITY FIELDS
                                            PROVIDED
              00000030       IPRCNFCT       48 FUNCTION NOT SUPPORTED FOR CSS
              00000031       IPRCNSEC       49 RESOURCE DOESN'T ACCEPT
                                            SECURITY(NONE)
              00000032       IPRCALOC       50 INVALID ALLOCATION DATA
                                            PROVIDED
              00000033       IPRCFUNL       51 INVALID FUNCTION - LOG_DATA
                                            PENDING
              00000034       IPRCPASS       52 NO APPCPASS STATEMENT
              00000035       IPRCTPLN       53 TPN LENGTH IS INVALID
              00000036       IPRCTPNI       54 TPN INVALID
              00000037       IPRCLDLN       55 INVALID LOG_DATA LENGTH
              00000038       IPRCWAIT       56 WAIT=YES FUNCTION TO SELF NOT
                                            VALID
              00000039       IPRCIPLN       57 INVALID LENGTH FOR PIP
                                            VARIABLE
              0000003A       IPRCICSL       58 INVALID VM COMM SERVER AREA
                                            LENGTH
              0000003B       IPRCIGDS       59 INVALID GDS ID WITHIN PIP
                                            VARIABLE
              0000003C       IPRCGDSL       60 LENGTHS INVALID FOR PIP
                                            VARIABLE
              0000003D       IPRCNAUT       61 Not authorized to specify an
                                            ALTID
              0000003E       IPRCOBUF       62 CONTROL AND INTERRUPT BUFFERS
                                            OVERLAP
              0000003F       IPRCILUW       63 INVALID LUWID LENGTH
              00000040       IPRCINET       64 INVALID FULLY QUAL LU NETWORK
                                            NAME
              00000041       IPRCNLUW       65 SYNCLVL=SYNCPT WITH NO LUWID
              00000042       IPRCIRES       66 INVALID RESID WITH
                                            PRIORITY=HIGH
              00000043       IPRCISYN       67 INVALID SYNCLVL:
                                            SYNCPT+CONFIRM
              00000044       IPRCIRST       68 INVALID FUNCTION FROM RESET
                                            STATE
              00000045       IPRCIDFR       69 INV FUNCTION FROM
                                            DEFER_RECEIVE STATE
              00000046       IPRCIDFS       70 INV FUNCTION FROM DEFER_SEVER
                                            STATE
              00000047       IPRCIPRP       71 INV FUNCT FROM
                                            PREPARE_RECEIVED STATE
              00000048       IPRCISRC       72 INV FUNCTION FROM
                                            SOLICITED_REQUEST_
                                            COMMIT_RECEIVED STATE
              00000049       IPRCIURC       73 INVALID FUNCTION FROM
                                            UNSOLICITED_
                                            REQUEST_COMMIT_RECEIVED STATE
              0000004A       IPRCICMT       74 INV FUNCT FROM
                                            COMMITTED_RECEIVED STATE
              0000004B       IPRCIBRV       75 INV FUNCT FROM
                                            BACKOUT_RECEIVED STATE
              0000004C       IPRCIBRQ       76 INV FUNCT FROM
                                            BACKOUT_REQUIRED STATE
              0000004D       IPRCBSIP       77 SIP ON/OFF INVALID ON
                                            NON-SYNCPT PATH
              0000004E       IPRCISO2       78 INVALID VALUE IN IPSNDOP2 OR
                                            IPSIPCD
              0000004F       IPRCSPFU       79 INVALID FUNCTION ON SYNCPT
                                            PATH
              00000050       IPRCLDSP       80 APPCVM SEVER WITH LOG DATA IS
                                            PENDING
              00000051       IPRCISIP       81 INV FUNCT WHILE SYNCPOINT IN
                                            PROGRESS
              00000052       IPRCSPSV       82 INVALID SEVER CODE DURING
                                            SYNCPOINT
              00000053       IPRCNSIP       83 INV FUNCT UNLESS SYNCPOINT IN
                                            PROGRESS
              00000054       IPRCNEWL       84 PARTNER DOESN'T SUPPORT NEW
                                            LUWID
              00000055       IPRCIBKR       85 RIP INVALID ON BKOUT FROM
                                            CURRENT STATE
              00000056       IPRCSCTL       86 SYNCPT CONNECT BUT NO CONTROL
                                            BUFFER
              00000057       IPRCKEEP       87 KEEP=YES INVALID AFTER
                                            PREVIOUS SEVER
              00000058       IPRCBACK       88 SENDBACK/SENDERR INVALID FOR
                                            SENDLUW
              00000059       IPRCSYNT       89 SYNCPT CONNECT TO TSAF NOT
                                            ALLOWED
              0000005A       IPRCRTRY       90 FCI MISSED FOR CCS SERV
                                            MACHINE
              0000005B       IPRMCSDA       91 VIRT MACHINE CHECK IN SEND
                                            DATA AREA
              0000005C       IPRMCRDA       92 VIRT MACHINE CHECK IN RECEIVE
                                            DATA AREA
              0000005D       IPRMCADA       93 VIRT MACHINE CHECK IN ANSWER
                                            DATA AREA
              0000005E       IPRMCRPA       94 VIRT MACHINE CHECK IN REPLY
                                            DATA AREA
              0000005F       IPRCADRF       95 ADDRESSING/FETCH PROTECTION
                                            EXCP IN OUR ADDRESS SPACE (ISFC
                                            USES THIS)
              00000060       IPRBIGSN       96 The send length was larger
                                            than that allowed via ISFC.
              00000061       IPRBIGRP       97 The reply length was larger
                                            than that allowed via ISFC.
    0004    4 Signed       2 IPMSGLIM (0)   MESSAGE LIMIT
    0004    4 Signed       2 IPPIPLEN (0)   PIP VARIABLE LENGTH
    0004    4 Signed       4 IPMSGID (0)    MESSAGE IDENTIFICATION
    0004    4 Bitstring    2 IPCODE (0)     ERROR/SEVER CODE
              00IPCODE       IPCDDFLT       X'0610' DEFAULT SEVER CODE
                                            LOG_DATA LENGTH MINIMUMS AND
                                            MAXIMUMS
              .... 1...      IPMINLOG       8 MINIMUM LOG_DATA LENGTH
              00IPCODE       IPMAXLOG       600 MAXIMUM LOG_DATA LENGTH
    0004    4 Bitstring    1 IPQCODE        IUCV QUERY QRYTYPE=IPQCONN output
              00000000       IPQCNNOT       0 Path is Not Connected
              00000001       IPQCNPND       1 Path is Connection Pending
              00000002       IPQCNCTD       2 Path is Connected
              00000003       IPQCNSEV       3 Path is Severed
    0005    5 Bitstring    1 IPQFLAGS       IUCV QUERY QRYTYPE=IPQCONN output
              1... ....      IPQAPPC        X'80' Path is APPC/VM
              .1.. ....      IPQCMSRV       X'40' Connected to a Comm. Server
                                            VM
              ..1. ....      IPQISFC        X'20' Connected to SYSTEM (CP
                                            ISFC)
              ...1 ....      IPQCPSVC       X'10' Connected to a CP System
                                            Service
    0006    6 Bitstring    1 IPFLAGS2 (0)   APPC FLAGS
              1... ....      IPWAIT         X'80' WAIT=YES SPECIFIED
              1... ....      IPINVOKE       X'80' INVOKE THE RESOURCE
              .1.. ....      IPLVLCF        X'40' SENDCNF/SENDCNFD OK ON PATH
              .1.. ....      IPCHGDIR       X'40' DIRECT=RECEIVE SPECIFIED
              .1.. ....      IPNOFLSH       X'40' FLUSH=NO SPECIFIED BY
                                            PARTNER
              ..1. ....      IPCOMSRV       X'20' ACTING ON BEHALF OF ANOTHER
                                            VM
              ..1. ....      IPPIP          X'20' PIP=YES FOR RECEIVE
              ...1 ....      IPTYPSVC       X'10' TYPE=SVC FOR SENDERR
              ...1 ....      IPMAPPED       X'10' MAPPED CONVERSATION
              .... 1...      IPFMH5         X'08' FMH5 PROVIDED ON CONNECT
              .... .1..      IPLOGDOK       X'04' LOG_DATA=YES SPECIFIED
              .... ..1.      IPIMMED        X'02' RETURN=IMMED SPECIFIED
              .... ...1      IPSYNCPT       X'01' SYNCPT FLOWS ALLOWED ON
                                            PATH
    0006    6 Bitstring    1 IPWHATRC       WHAT RECEIVED CODE
              00000000       IPCOMP         X'00' FUNCTION COMPLETED NORMALLY
              00000001       IPDATA         X'01' ONLY DATA WAS RECEIVED
              00000002       IPSEND         X'02' INDICATES NOW IN SEND STATE
              00000003       IPERROR        X'03' PARTNER ISSUED SENDERR
              00000004       IPCNFRM        X'04' PARTNER ISSUED SENDCNF
                                            TYPE=NORM
              00000005       IPCNFSEV       X'05' PARTNER ISSUED SENDCNF
                                            TYPE=SEVER
              00000006       IPCNFRMD       X'06' PARTNER ISSUED SENDCNFD
              00000008       IPSNORM        X'08' PARTNER ISSUED SEVER
                                            TYPE=NORMAL
              00000009       IPSABEND       X'09' PARTNER ISSUED SEVER
                                            TYPE=ABEND
              0000000B       IPALLOCD       X'0B' ALLOCATE DATA BEING
                                            RECEIVED
              0000000C       IPSNDCNF       X'0C' PARTNER ISSUED SENDCNF
                                            TYPE= PREPRECV
              0000000D       IPLGDATA       X'0D' LOG_DATA WAS RECEIVED
              0000000E       IPPIPDAT       X'0E' PIP DATA WAS RECEIVED
              0000000F       IPPREPAR       X'0F' PREPARE WAS RECEIVED
              00000010       IPREQCOM       X'10' REQUEST_COMMIT WAS RECEIVED
              00000011       IPCOMMTD       X'11' COMMITED WAS RECEIVED
              00000012       IPFORGET       X'12' FORGET WAS RECEIVED
              00000013       IPHEURMX       X'13' HEURISTIC_MIXED WAS
                                            RECEIVED
              00000014       IPBACK         X'14' BACKOUT WAS RECEIVED
              00000015       IPCNFBK        X'15' BACKOUT WAS CONFIRMED
              00000016       IPLUWID        X'16' NEW_LUWID WAS RECEIVED
              000000FF       IPSSRCE        X'FF' SOURCE ISSUED SEVER
    0007    7 Bitstring    1 IPQTYPE (0)    IUCV QUERY QRYTYPE NOTES : SOME
                                            OF THE EQUATES USED IN IPSENDOP
                                            ARE ALSO USED IN IPWHATRC WITH
                                            SLIGHTLY DIFFERENT MEANINGS ANY
                                            RESERVED VALUES PERTAIN ONLY TO
                                            IPWHATRC
              00000000       IPQBFLN        X'00' QUERY APPC/VM buffer
                                            lengths
              00000001       IPQCONN        X'01' QUERY Connection for
                                            IPPATHID
    0007    7 Bitstring    1 IPSENDOP       SEND OPTION CODE
              .... ..1.      IPSNDRCV       X'02' SENDDATA RECEIVE=YES
                                            REQUESTED
              .... .111      IPREQSND       X'07' SENDREQ REQUESTED
              .... 1.1.      IPRECV         X'0A' RECEIVE FUNCTION BEING
                                            COMPLETED
              .... 11..      IPPREPRC       X'0C' SENDCNF TYPE=PREPRECV
                                            REQUESTED
    0008    8 Character    8 IPVMID (0)     TARGET VIRTUAL MACHINE ID
    0008    8 Signed       4 IPTRGPTR (0)   Target class pointer for PLAS
    0008    8 Bitstring    4 IPTRGCLS (0)   TARGET CLASS
    0008    8 Bitstring    4 IPAUDIT (0)    AUDIT TRAIL
    0008    8 Bitstring    1 IPAUDIT1       AUDIT TRAIL BYTE 1
              1... ....      IPADRPLE       X'80' REPLY TOO LONG FOR BUFFER
              .1.. ....      IPADSNPX       X'40' PROTECTION EXCEPTION ON
                                            SEND BUFF
              ..1. ....      IPADSNAX       X'20' ADDRESSING EXCEPTION ON
                                            SEND BUFF
              ...1 ....      IPADANPX       X'10' PROTECTION EXCEPTION ANSWER
                                            BUFF
              .... 1...      IPADANAX       X'08' ADDRESSING EXCEPTION ANSWER
                                            BUFF
              .... .1..      IPADRJCT       X'04' MESSAGE WAS R ED
              .... ..1.      IPADPRMD       X'02' REPLY SENT IN PARAMETER
                                            LIST
              .... ...1      IPADPGNR       X'01' MESSAGE PURGED ON SEND OR
                                            RECEIVE QUEUE
              .111 1...      IPADMSK1       IPADSNPX+IPADSNAX+IPADANPX+IPADAN
                                            AX APPC MASK
    0009    9 Bitstring    1 IPAUDIT2       AUDIT TRAIL BYTE 2
              1... ....      IPADRCPX       X'80' PROTECTION EXCEPTION
                                            RECEIVE BUFF
              .1.. ....      IPADRCAX       X'40' ADDRESSING EXCEPTION
                                            RECEIVE BUFF
              ..1. ....      IPADRPPX       X'20' PROTECTION EXCEPTION REPLY
                                            BUFF
              ...1 ....      IPADRPAX       X'10' ADDRESSING EXCEPTION REPLY
                                            BUFF
              .... 1...      IPADSVRD       X'08' PATH WAS SEVERED
              .... .1..      IPADRLST       X'04' INVALID RECEIVE/REPLY LIST
              1111 .1..      IPADMSK2       IPADRCPX+IPADRCAX+IPADRPPX+IPADRP
                                            AX+IPADRLST APPC MASK MASK OF
                                            VALID APPC AUDIT FLAGS
    000A   10 Bitstring    1 IPAUDIT3       AUDIT TRAIL BYTE 3
              1... ....      IPADBLEN       X'80' BAD LENGTH IN SEND BUFFER
                                            LIST
              .1.. ....      IPADALEN       X'40' INVALID SEND / ANSWER
                                            BUFFERLIST SUCH AS BAD ADDRESS OR
                                            LENGTH
              ..1. ....      IPADBTOT       X'20' INVALID TOTAL SEND BUFFER
                                            LENGTH
              ...1 ....      IPADATOT       X'10' INVALID TOTAL SEND ANSWER
                                            LENGTH
              .... 1...      IPADTINV       X'08' PARTNER=INV. LOG. REC.
                                            DATALENG
              .... .1..      IPADIINV       X'04' INVALID LOGICAL RECORD IN
                                            DATASTR
              .... ..1.      IPADTTRN       X'02' PARTNER HAS STARTED A SEND
                                            BUT TRIED TO GO INTO RECEIVE
                                            STATE BEFORE SEND IS FINISHED
              .... ...1      IPADITRN       X'01' RECEIVE STATE ATTEMPTED
                                            BEFORE SEND IS FINISHED
              1111 1111      IPADMSK3       IPADBLEN+IPADALEN+IPADBTOT+IPADAT
                                            OT+IPADTINV+IPADIINV+IP
                                            ADTTRN+IPADITRN MASK OF VALID
                                            APPC AUDIT FLAGS
    000B   11 Bitstring    1 IPASYRC        AUDIT TRAIL BYTE 4 ASYCHRONOUS
              0000003B       IPGDSINV       IPRCIGDS INVLD GDS ID WITHIN PIP
                                            VARIABLE
              0000003C       IPGDSLEN       IPRCGDSL LENGTHS INVALID FOR PIP
                                            VARIABLE SUBFIELD LENGTH OR SUM
                                            OF SUBFIELD
              0000005B       IPMCSNDA       IPRMCSDA MACHINE CHECK IN SEND
                                            DATA AREA
              0000005C       IPMCRECA       IPRMCRDA MACHINE CHECK IN RECEIVE
                                            AREA
              0000005D       IPMCANSA       IPRMCADA MACHINE CHECK IN ANSWER
                                            DATA AREA
              0000005E       IPMCRPYA       IPRMCRPA MACHINE CHECK IN REPLY
                                            DATA AREA
              000000FF       IPADMSK4       X'FF' 255 ASYNCHRONOUS CODES
                                            ALLOWED
    000C   12 Bitstring    8 IPRMMSG (0)    MESSAGE DATA IN PARAMETER LIST
    000C   12 Signed       4 IPRMMSG1 (0)   FIRST FULLWORD OF PRMLIST DATA
    000C   12 Address      4 IPBFADR1       ADDRESS OF BUFFER
    0010   16 Signed       4 IPRMMSG2 (0)   SECOND FULLWORD OF PRMLIST DATA
    0010   16 Signed       4 IPBFLN1F (0)   FULLWORD LENGTH OF IPBFADR1
    0010   16 Signed       4 IPIPXMLN (0)   Maximum IPARMLX length.
    0010   16 Character   16 IPUSER (0)     USER DATA
    0010   16 Bitstring    8 IPRESID (0)    TARGET RESOURCE ID
    0010   16 Signed       2 *
    0012   18 Signed       2 IPBFLN1        HALFWORD LENGTH OF IPBFADR1
    0014   20 Signed       4 IPVMDBK (0)    ORIGIN VMDBK FOR DCLBFR FROM CP
    0014   20 Signed       4 IPIUCVBK (0)   IUCVBLOK ADDR FROM DCLBFR BY CP
    0014   20 Signed       4 IPSRCPTR (0)   Source class pointer for PLAS
    0014   20 Signed       4 IPSRCCLS       SOURCE CLASS
    0018   24 Signed       4 IPVMDUSR (0)   ADDR OF PRIVATE SERVER'S USERID
    0018   24 Signed       4 IPMSGTAG       MESSAGE TAG
    001C   28 Address      4 IPBFADR2       ADDRESS OF BUFFER 2
    0020   32 Character    8 IPTARGET (0)   Target Node ID
    0020   32 Character    8 IPINVOK (0)    Invoker userid
    0020   32 Signed       4 IPBFLN2F (0)   FULLWORD LENGTH OF IPBFADR2
    0020   32 Signed       2 *              RESERVED
    0022   34 Signed       2 IPBFLN2        HALFWORD LENGTH OF IPBFADR2
         NOTES : IPNEXT IS USED INTERNALLY FOR QUEUING PENDING INTERRUPTS. THE
         FIELDS DEFINED OVER IT CAN ONLY BE FILLED IN AFTER THE INTERRUPT IS
         DEQUEUED (AND IPNEXT IS NO LONGER USED). THE FIELDS DEFINED OVER IT
         CANNOT BE USED WHILE THE PENDING INTERRUPT IS QUEUED.
    0024   36 Bitstring    1 IPPOLLFG (0)   INTERRUPT POLLING CONTROL FLAG
              00000080       IPNOPOLL       X'80' NO REPLIES/MESSAGES TO POLL
    0024   36 Bitstring    1 IPSIPFG (0)    CURRENT SYNCPT IN PROGRESS FLAG
              00000000       IPSIPOFF       X'00' SYNCPOINT IN PROGRESS FLAG
                                            OFF
              00000001       IPSIPON        X'01' SYNCPOINT IN PROGRESS FLAG
                                            IS ON
    0024   36 Bitstring    1 IPSIPCD        SET/RESET SYNCPT IN PROGRESS FLAG
              00000000       IPNONE         X'00' DO NOT CHANGE SYNCPOINT IN
                                            PROG
              00000001       IPSIPSET       X'01' SET THE SYNCPOINT IN
                                            PROGRESS FLG
              00000002       IPSIPRST       X'02' RESET SYNCPOINT IN PROGRESS
                                            FLAG
    0025   37 Bitstring    1 IPSTATE        CURRENT STATE
              00000000       IPENDING       X'00' FUNCTION IS PENDING ON THE
                                            PATH
              00000001       IPRESET        X'01' PATH IN RESET STATE
              00000002       IPCONNCT       X'02' PATH IN CONNECT STATE
              00000003       IPSENDST       X'03' PATH IN SEND STATE
              00000004       IPRECVST       X'04' PATH IN RECEIVE STATE
              00000005       IPCONFRM       X'05' PATH IN CONFIRM STATE
              00000006       IPSEVER        X'06' PATH IN SEVER STATE
              00000007       IPDEFRCV       X'07' PATH IN DEFER_RECEIVE STATE
              00000008       IPDEFSVR       X'08' PATH IN DEFER_SEVER STATE
              00000009       IPREPARE       X'09' PATH IN PREPARE_RECEIVED
                                            STATE
              0000000A       IPSRQCMT       X'0A' PATH IN STATE ... .
                                            SOLICITED_REQUEST_COMMIT_RECEIVED
              0000000B       IPURQCMT       X'0B' PATH IN STATE ... .
                                            UNSOLICITED_REQUEST_COMMIT_RECEIV
                                            ED
              0000000C       IPCOMMIT       X'0C' PATH IN COMMITTED_RECEIVED
                                            STATE
              0000000D       IPBKOUT        X'0D' PATH IN BACKOUT_RECEIVED
                                            STATE
              0000000E       IPBKREQ        X'0E' PATH IN BACKOUT_REQUIRED
                                            STATE
    0026   38 Bitstring    1 IPWHTRC2 (0)   WHAT RECEIVED FLAG 2
    0026   38 Bitstring    1 IPSPCMOD       SYNCPT CONTROL MODIFIER RECEIVED
    0027   39 Bitstring    1 IPSYCLVL (0)   SYNCHRONIZATION LEVEL FOR PATH
              00000000       IPSYCNON       X'00' INDICATES SYNCLVL=NONE
              00000001       IPSYCCNF       X'01' INDICATES SYNCLVL=CONFIRM
              00000002       IPSYCSP        X'02' INDICATES SYNCLVL=SYNCPT
    0027   39 Bitstring    1 IPSNDOP2       SEND OPTIONS FLAGE 2
              00000003       IPTPSEND       X'03' SEND STATE REQUESTED
              00000004       IPTPRECV       X'04' RECEIVE STATE REQUESTED
              00000006       IPTPSEVR       X'06' SEVER STATE REQUESTED
              0000000E       IPTPBKRQ       X'0E' BACKOUT_REQUIRED STATE
                                            REQUESTED
              0000000F       IPTPSVAB       X'0F' SEVER_ABEND_REQUIRED STATE
              00000005       IPSIZE         (*-IPARML+7)/8 IPARML SIZE IN
                                            DOUBLE WORDS
         NOTES : Following fields are for internal CP use only. They are not
         presented to the virtual machine.
    0028   40 Character    8 IPINVOKR (0)   Invoker userid
    0028   40 Signed       4 *              Reserved space for IPINVOKR
    002C   44 Signed       4 IPNEXT         Address of next pending ext int
              00000006       IPTSIZE        (*-IPARML+7)/8 IPARML full size
                                            in double words
         IUCV function IPARML formats (On NON APPC/VM paths) (NOT changed as a
         result of APPC/VM support)
         END OF IPARML LAYOUTS

#### IPARML Storage Layout

    *** IPARML - IUCV/APPC parameter list and external
    *
    *     +------+------+------+------+------+------+------+------+
    *   0 |:MASK |//////|:LAGS1|:CODE |:CODE |:FLAGS|:HATRC|:ENDOP|
    *     +------+------+------+------+------+------+------+------+
    *   8 |:UDIT1|:UDIT2|:UDIT3|:SYRC |         IPBFADR1          |
    *     +------+------+------+------+---------------------------+
    *  10 |/////////////|  IPBFLN1    |         IPSRCCLS          |
    *     +-------------+-------------+---------------------------+
    *  18 |         IPMSGTAG          |         IPBFADR2          |
    *     +-------------+-------------+------+------+------+------+
    *  20 |/////////////|  IPBFLN2    |:IPCD |:TATE |:PCMOD|:NDOP2|
    *     +-------------+-------------+------+------+------+------+
    *  28 |///////////////////////////|          IPNEXT           |
    *     +---------------------------+---------------------------+
    *  30
    *
    *** IPARML - IUCV/APPC parameter list and external

#### IPARML Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    IPADALEN       000A 40
    IPADANAX       0008 08
    IPADANPX       0008 10
    IPADATOT       000A 10
    IPADBLEN       000A 80
    IPADBTOT       000A 20
    IPADIINV       000A 04
    IPADITRN       000A 01
    IPADMSK1       0008 78
    IPADMSK2       0009 F4
    IPADMSK3       000A FF
    IPADMSK4       000B 000000FF
    IPADPGNR       0008 01
    IPADPRMD       0008 02
    IPADRCAX       0009 40
    IPADRCPX       0009 80
    IPADRJCT       0008 04
    IPADRLST       0009 04
    IPADRPAX       0009 10
    IPADRPLE       0008 80
    IPADRPPX       0009 20
    IPADSNAX       0008 20
    IPADSNPX       0008 40
    IPADSVRD       0009 08
    IPADTINV       000A 08
    IPADTTRN       000A 02
    IPALL          0002 80
    IPALLOCD       0006 0000000B
    IPANSLST       0002 08
    IPAPPC         0002 08
    IPAPPCPG       0002 80
    IPAPPCSN       0002 02
    IPASYRC        000B
    IPAUDIT        0008
    IPAUDIT1       0008
    IPAUDIT2       0009
    IPAUDIT3       000A
    IPBACK         0006 00000014
    IPBFADR1       000C
    IPBFADR2       001C
    IPBFLN1        0012
    IPBFLN1F       0010
    IPBFLN2        0022
    IPBFLN2F       0020
    IPBKOUT        0025 0000000D
    IPBKREQ        0025 0000000E
    IPBUFLST       0002 40
    IPCDDFLT       0004 00IPCODE
    IPCHGDIR       0006 40
    IPCLCC         0000 40
    IPCLPC         0000 80
    IPCLPQ         0000 10
    IPCLPR         0000 08
    IPCLPS         0000 20
    IPCMASK        0000
    IPCNFBK        0006 00000015
    IPCNFRM        0006 00000004
    IPCNFRMD       0006 00000006
    IPCNFSEV       0006 00000005
    IPCNTRL        0002 04
    IPCODE         0004
    IPCOMMIT       0025 0000000C
    IPCOMMTD       0006 00000011
    IPCOMP         0006 00000000
    IPCOMSRV       0006 20
    IPCONFRM       0025 00000005
    IPCONNCT       0025 00000002
    IPCPSYS        0003
    IPCTRL         0000 08
    IPDATA         0006 00000001
    IPDEFRCV       0025 00000007
    IPDEFSVR       0025 00000008
    IPDELAY        0002 80
    IPENDING       0025 00000000
    IPERROR        0006 00000003
    IPFGMCL        0002 01
    IPFGMID        0002 04
    IPFGPID        0002 02
    IPFLAGS1       0002
    IPFLAGS2       0006
    IPFLUSH        0002 40
    IPFMH5         0006 08
    IPFORGET       0006 00000012
    IPFREPTH       0002 01
    IPGDSINV       000B 0000003B
    IPGDSLEN       000B 0000003C
    IPHEURMX       0006 00000013
    IPIMMED        0006 02
    IPINVOK        0020
    IPINVOKE       0006 80
    IPINVOKR       0028
    IPIPXMLN       0010
    IPIUCVBK       0014
    IPKEEP         0002 10
    IPLGDATA       0006 0000000D
    IPLOCAL        0002 01
    IPLOGDOK       0006 04
    IPLRECL        0002 10
    IPLUWID        0006 00000016
    IPLVLCF        0006 40
    IPMAPPED       0006 10
    IPMASK         0000
    IPMAXLOG       0004 00IPCODE
    IPMCANSA       000B 0000005D
    IPMCRECA       000B 0000005C
    IPMCRPYA       000B 0000005E
    IPMCSNDA       000B 0000005B
    IPMINLOG       0004 08
    IPMSGID        0004
    IPMSGLIM       0004
    IPMSGRET       0002 40
    IPMSGTAG       0018
    IPNEXT         002C
    IPNLUWOK       0002 20
    IPNOFLSH       0006 40
    IPNONE         0024 00000000
    IPNOPOLL       0024 00000080
    IPNORPY        0002 10
    IPPATHID       0000
    IPPIP          0006 20
    IPPIPDAT       0006 0000000E
    IPPIPLEN       0004
    IPPOLLFG       0024
    IPPREPAR       0006 0000000F
    IPPREPRC       0007 0C
    IPPRTY         0002 20
    IPQAPPC        0005 80
    IPQBFLN        0007 00000000
    IPQCMSRV       0005 40
    IPQCNCTD       0004 00000002
    IPQCNNOT       0004 00000000
    IPQCNPND       0004 00000001
    IPQCNSEV       0004 00000003
    IPQCODE        0004
    IPQCONN        0007 00000001
    IPQCPSVC       0005 10
    IPQFLAGS       0005
    IPQISFC        0005 20
    IPQPRTY        0002 20
    IPQTYPE        0007
    IPQUSCE        0002 40
    IPRBIGRP       0003 00000061
    IPRBIGSN       0003 00000060
    IPRCABND       0003 0000001B
    IPRCADRC       0003 00000007
    IPRCADRF       0003 0000005F
    IPRCALOC       0003 00000032
    IPRCAPPC       0003 0000001F
    IPRCBACK       0003 00000058
    IPRCBADR       0003 0000000F
    IPRCBBND       0003 0000001A
    IPRCBDFN       0003 00000011
    IPRCBDLM       0003 00000012
    IPRCBSIP       0003 0000004D
    IPRCCENL       0003 00000027
    IPRCCONF       0003 00000023
    IPRCCONN       0003 00000020
    IPRCCSRV       0003 0000001D
    IPRCFUNL       0003 00000033
    IPRCGDSL       0003 0000003C
    IPRCHSBF       0003 00000013
    IPRCIBKR       0003 00000055
    IPRCIBRQ       0003 0000004C
    IPRCIBRV       0003 0000004B
    IPRCICMT       0003 0000004A
    IPRCICSL       0003 0000003A
    IPRCIDFR       0003 00000045
    IPRCIDFS       0003 00000046
    IPRCIGDS       0003 0000003B
    IPRCILUW       0003 0000003F
    IPRCINET       0003 00000040
    IPRCINSV       0003 00000010
    IPRCIPLN       0003 00000039
    IPRCIPRP       0003 00000047
    IPRCIRES       0003 00000042
    IPRCIRLN       0003 0000002A
    IPRCIRST       0003 00000044
    IPRCISIP       0003 00000051
    IPRCISO2       0003 0000004E
    IPRCISRC       0003 00000048
    IPRCISYN       0003 00000043
    IPRCITRN       0003 0000002C
    IPRCIURC       0003 00000049
    IPRCKEEP       0003 00000057
    IPRCLDLN       0003 00000037
    IPRCLDSP       0003 00000050
    IPRCLUNM       0003 00000028
    IPRCMODE       0003 00000029
    IPRCMSCT       0003 00000003
    IPRCMSLN       0003 0000000A
    IPRCNAPP       0003 0000001E
    IPRCNAUT       0003 0000003D
    IPRCNCTL       0003 0000001C
    IPRCNEWL       0003 00000054
    IPRCNFCT       0003 00000030
    IPRCNLEN       0003 00000017
    IPRCNLOG       0003 0000000B
    IPRCNLUW       0003 00000041
    IPRCNODT       0003 00000008
    IPRCNPRM       0003 00000015
    IPRCNPTH       0003 00000001
    IPRCNPTY       0003 00000004
    IPRCNSEC       0003 00000031
    IPRCNSIP       0003 00000053
    IPRCNSND       0003 00000002
    IPRCNTRG       0003 0000000C
    IPRCOBUF       0003 0000003E
    IPRCODE        0003
    IPRCPASS       0003 00000034
    IPRCPLST       0003 00000019
    IPRCPRGD       0003 00000009
    IPRCPRTC       0003 00000006
    IPRCPTSV       0003 00000014
    IPRCRCVS       0003 00000005
    IPRCRECV       0003 00000022
    IPRCRTRY       0003 0000005A
    IPRCSCTL       0003 00000056
    IPRCSECR       0003 0000002F
    IPRCSEND       0003 00000021
    IPRCSEVC       0003 0000002E
    IPRCSEVR       0003 00000024
    IPRCSLST       0003 00000016
    IPRCSNOP       0003 00000026
    IPRCSPFU       0003 0000004F
    IPRCSPSV       0003 00000052
    IPRCSYNC       0003 00000025
    IPRCSYNT       0003 00000059
    IPRCTLEN       0003 00000018
    IPRCTPLN       0003 00000035
    IPRCTPNI       0003 00000036
    IPRCTRLN       0003 0000002B
    IPRCTTRN       0003 0000002D
    IPRCWAIT       0003 00000038
    IPRC2MYI       0003 0000000D
    IPRC2MYT       0003 0000000E
    IPRECV         0007 0A
    IPRECVST       0025 00000004
    IPREMOTE       0002 02
    IPREPARE       0025 00000009
    IPREQCOM       0006 00000010
    IPREQSND       0007 07
    IPRESET        0025 00000001
    IPRESID        0010
    IPRESYNC       0002 10
    IPRMCADA       0003 0000005D
    IPRMCRDA       0003 0000005C
    IPRMCRPA       0003 0000005E
    IPRMCSDA       0003 0000005B
    IPRMDATA       0002 80
    IPRMMSG        000C
    IPRMMSG1       000C
    IPRMMSG2       0010
    IPRPYN         0000 20
    IPRPYP         0000 10
    IPSABEND       0006 00000009
    IPSEND         0006 00000002
    IPSENDOP       0007
    IPSENDST       0025 00000003
    IPSEVER        0025 00000006
    IPSIPCD        0024
    IPSIPFG        0024
    IPSIPOFF       0024 00000000
    IPSIPON        0024 00000001
    IPSIPRST       0024 00000002
    IPSIPSET       0024 00000001
    IPSIZE         0027 00000005
    IPSNDCNF       0006 0000000C
    IPSNDN         0000 80
    IPSNDOP2       0027
    IPSNDP         0000 40
    IPSNDRCV       0007 02
    IPSNORM        0006 00000008
    IPSPCMOD       0026
    IPSRCCLS       0014
    IPSRCPTR       0014
    IPSRQCMT       0025 0000000A
    IPSSRCE        0006 000000FF
    IPSTATE        0025
    IPSYCCNF       0027 00000001
    IPSYCLVL       0027
    IPSYCNON       0027 00000000
    IPSYCSP        0027 00000002
    IPSYNC         0002 04
    IPSYNCFL       0002 02
    IPSYNCPT       0006 01
    IPSYNCSN       0002 40
    IPTARGET       0020
    IPTPBKRQ       0027 0000000E
    IPTPRECV       0027 00000004
    IPTPSEND       0027 00000003
    IPTPSEVR       0027 00000006
    IPTPSVAB       0027 0000000F
    IPTRGCLS       0008
    IPTRGPTR       0008
    IPTSIZE        002C 00000006
    IPTYPBKR       0003 0000008A
    IPTYPCC        0003 00000002
    IPTYPCCA       0003 00000082
    IPTYPE         0003
    IPTYPFCA       0003 00000087
    IPTYPMNP       0003 00000009
    IPTYPMP        0003 00000008
    IPTYPMPA       0003 00000089
    IPTYPPC        0003 00000001
    IPTYPPCA       0003 00000081
    IPTYPQS        0003 00000004
    IPTYPRNP       0003 00000007
    IPTYPRP        0003 00000006
    IPTYPRS        0003 00000005
    IPTYPSRA       0003 00000088
    IPTYPSV        0003 00000003
    IPTYPSVA       0003 00000083
    IPTYPSVC       0006 10
    IPURGBKR       0002 20
    IPURQCMT       0025 0000000B
    IPUSER         0010
    IPVERIFY       0002 10
    IPVMDBK        0014
    IPVMDUSR       0018
    IPVMID         0008
    IPWAIT         0006 80
    IPWHATRC       0006
    IPWHTRC2       0026
    IPWIN          0002 01

This information is based on z/VM V4R3.0. Last updated on 30 Apr 2002 at 18:35:13 EDT.
Copyright IBM Corporation, 1990, 2002