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.
 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 V4R2.0. Last updated on 30 Oct 2001 at 15:39:27 EDT.
Copyright IBM Corporation, 1990, 2001