Programming Interface Information:
This page documents intended Programming Interfaces that allow the customer to write programs to obtain the services of z/VM. |
IPARML
Control Block Contents
IPARML DSECT
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' IPSNDN ENABLE FOR NON-PRIORITY MESSAGES .1.. .... IPSNDP X'40' IPSNDP ENABLE FOR PRIORITY MESSAGES ..1. .... IPRPYN X'20' IPRPYN ENABLE FOR NON-PRIORITY REPLIES ...1 .... IPRPYP X'10' IPRPYP ENABLE FOR PRIORITY REPLIES .... 1... IPCTRL X'08' IPCTRL ENABLE FOR IUCV CONTROL INTERRUPT 0000 0 Bitstring 1 IPCMASK ENABLE CONTROL MASK 1... .... IPCLPC X'80' IPCLPC ENABLE FOR PENDING CONNECTION .1.. .... IPCLCC X'40' IPCLCC ENABLE FOR COMPLETE CONNECTION ..1. .... IPCLPS X'20' IPCLPS ENABLE FOR SEVER INTERRUPT ...1 .... IPCLPQ X'10' IPCLPQ ENABLE FOR QUIESCE INTERRUPT .... 1... IPCLPR X'08' IPCLPR ENABLE FOR RESUME INTERRUPT 0001 1 Bitstring 1 * 0002 2 Bitstring 1 IPFLAGS1 FLAGS BYTE 1... .... IPALL X'80' IPALL QUIESCE, RESUME, SEVER ALL 1... .... IPRMDATA X'80' IPRMDATA MESSAGE IS IN PARAMETER LIST 1... .... IPDELAY X'80' IPDELAY RETURN PURGED MSGBK/IXBLKS 1... .... IPAPPCPG X'80' IPAPPCPG PURGE allowed (connect/senddata) .1.. .... IPQUSCE X'40' IPQUSCE CONNECT IN QUIESCE MODE .1.. .... IPBUFLST X'40' IPBUFLST INDICATES BUFFER LIST OPTION .1.. .... IPMSGRET X'40' IPMSGRET RETURN PURGED MSGBK/IXBLKS .1.. .... IPFLUSH X'40' IPFLUSH PARTNER ISSUED SENDDATA FLUSH=YES .1.. .... IPSYNCSN X'40' IPSYNCSN SYNCHRONOUS SEND REQUESTED - MPI ..1. .... IPPRTY X'20' IPPRTY PRIORITY MESSAGE OR REPLY ..1. .... IPQPRTY X'20' IPQPRTY PRIORITY HIGH FOR CONNECT ..1. .... IPNLUWOK X'20' IPNLUWOK SENDER OF FORGET SUPPORTS SENDLUW ..1. .... IPURGBKR X'20' IPURGBKR SEVER PURGED BKOUT_REQ INTERRUPT ...1 .... IPNORPY X'10' IPNORPY ONE WAY PROTOCOL ...1 .... IPKEEP X'10' IPKEEP SEVER KEEP=YES ...1 .... IPRESYNC X'10' IPRESYNC INVOKER SPECIFIED RESYNC=YES ...1 .... IPLRECL X'10' IPLRECL LOGICAL RECORD IN PROGRESS ...1 .... IPVERIFY X'10' IPVERIFY Remote target VERIFY needed .... 1... IPAPPC X'08' IPAPPC APPC protocol used on path .... 1... IPANSLST X'08' IPANSLST INDICATES ANSWER LIST OPTION .... .1.. IPFGMID X'04' IPFGMID MESSAGE ID SPECIFIED .... .1.. IPCNTRL X'04' IPCNTRL INDICATES CONTROL BUFFER OPTION .... .1.. IPSYNC X'04' IPSYNC SYNCHRONOUS SEND REQUEST (INPUT) .... ..1. IPREMOTE X'02' IPREMOTE PATH INCLUDES A COMSRV V.M. .... ..1. IPFGPID X'02' IPFGPID PATH ID SPECIFIED .... ..1. IPAPPCSN X'02' IPAPPCSN AN APPCVM SEND FUNCTION ISSUED .... ..1. IPSYNCFL X'02' IPSYNCFL SEVER ISSUED DURING SYNCPT .... ...1 IPFGMCL X'01' IPFGMCL MESSAGE CLASS SPECIFIED .... ...1 IPFREPTH X'01' IPFREPTH SEVER ISSUED TO FREE UP PATH ID .... ...1 IPLOCAL X'01' IPLOCAL IUCV CONNECT ON LOCAL SYS ONLY .... ...1 IPWIN X'01' IPWIN SENDBACK MUST WIN IF CRASH 0003 3 Bitstring 1 IPTYPE (0) EXTERNAL INTERRUPT CODE 00000001 IPTYPPC X'01' IPTYPPC EXT INT TYPE - PENDING CONNECTION 00000002 IPTYPCC X'02' IPTYPCC EXT INT TYPE - CONNECTION COMP. 00000003 IPTYPSV X'03' IPTYPSV EXT INT TYPE - SEVERED CONNECTION 00000004 IPTYPQS X'04' IPTYPQS EXT INT TYPE - QUIESCED CONN. 00000005 IPTYPRS X'05' IPTYPRS EXT INT TYPE - RESUMED CONNECTION 00000006 IPTYPRP X'06' IPTYPRP EXT INT TYPE - INCOMING PRTY RPLY 00000007 IPTYPRNP X'07' IPTYPRNP EXT INT TYPE - INCOMING REPLY 00000008 IPTYPMP X'08' IPTYPMP EXT INT TYPE - INCOMING PRTY MSG 00000009 IPTYPMNP X'09' IPTYPMNP EXT INT TYPE - INCOMING MESSAGE . 00000081 IPTYPPCA X'81' IPTYPPCA APPC INT - PENDING CONNECTION 00000082 IPTYPCCA X'82' IPTYPCCA APPC INT - CONNECTION COMPLETE 00000083 IPTYPSVA X'83' IPTYPSVA APPC INT - SEVER INTERRUPT 00000087 IPTYPFCA X'87' IPTYPFCA APPC INT - FUNCTION COMPLETE 00000088 IPTYPSRA X'88' IPTYPSRA APPC INT - SENDREQ INTERRUPT 00000089 IPTYPMPA X'89' IPTYPMPA APPC INT - INCOMING MESSAGE 0000008A IPTYPBKR X'8A' IPTYPBKR 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 IPRCNPTH INVALID PATH ID 00000002 IPRCNSND 2 IPRCNSND 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 IPRCMSCT MESSAGE LIMIT EXCEEDED 00000004 IPRCNPTY 4 IPRCNPTY PRTY MESSAGES NOT ALLOWED ON PATH 00000005 IPRCRCVS 5 IPRCRCVS BUFFER TOO SHORT FOR MESSAGE 00000006 IPRCPRTC 6 IPRCPRTC FETCH PROTECTION EXCEPTION 00000007 IPRCADRC 7 IPRCADRC ADDRESSING EXCEPTION 00000008 IPRCNODT 8 IPRCNODT MSGID FND, BUT CLASS/PATH INVALID 00000009 IPRCPRGD 9 IPRCPRGD MESSAGE HAS BEEN PURGED 0000000A IPRCMSLN 10 IPRCMSLN MESSAGE LENGTH NEGITIVE 0000000B IPRCNLOG 11 IPRCNLOG TARGET IS NOT LOGGED ON 0000000C IPRCNTRG 12 IPRCNTRG TARGET HAS NOT DECLARED A BUFFER 0000000D IPRC2MYI 13 IPRC2MYI INVOKER MAX CONNECTIONS EXCEEDED 0000000E IPRC2MYT 14 IPRC2MYT TARGET MAX CONNECTIONS EXCEEDED 0000000F IPRCBADR 15 IPRCBADR NOT AUTHORIZED TO CONNECT TO TARG 00000010 IPRCINSV 16 IPRCINSV INVALID CP SYSTEM SERVICE NAME 00000011 IPRCBDFN 17 IPRCBDFN INVALID FUNCTION CODE 00000012 IPRCBDLM 18 IPRCBDLM INVALID MSGLIMIT 00000013 IPRCHSBF 19 IPRCHSBF ALREADY HAS DECLARED A BUFFER 00000014 IPRCPTSV 20 IPRCPTSV PATH HAS BEEN SEVERED 00000015 IPRCNPRM 21 IPRCNPRM PARAM. LIST MESSAGE NOT ALLOWED 00000016 IPRCSLST 22 IPRCSLST SEND LIST INVALID 00000017 IPRCNLEN 23 IPRCNLEN NEGATIVE LENGTH IN LIST 00000018 IPRCTLEN 24 IPRCTLEN TOTAL LENGTH IS NOT LIST LENGTH INVALID TOTAL LIST LENGTH 00000019 IPRCPLST 25 IPRCPLST PRMMSG & BUF/ANSLIST NOT ALLOWED 0000001A IPRCBBND 26 IPRCBBND BUFFER LIST NOT D-WORD ALIGNED 0000001B IPRCABND 27 IPRCABND ANSWER LIST NOT D-WORD ALIGNED 0000001C IPRCNCTL 28 IPRCNCTL NO CONTROL BUFFER EXISTS 0000001D IPRCCSRV 29 IPRCCSRV NOT AUTHORIZED AS COMM. SERVER 0000001E IPRCNAPP 30 IPRCNAPP APPC FUNCTION ON AN IUCV PATH 0000001F IPRCAPPC 31 IPRCAPPC APPC PATH TRIED AN IUCV ONLY FUNC 00000020 IPRCCONN 32 IPRCCONN INVALID FUNC. FROM CONNECT STATE 00000021 IPRCSEND 33 IPRCSEND INVALID FUNC. FROM SEND STATE 00000022 IPRCRECV 34 IPRCRECV INVALID FUNC. FROM RECEIVE STATE 00000023 IPRCCONF 35 IPRCCONF INVALID FUNC. FROM CONFIRM STATE 00000024 IPRCSEVR 36 IPRCSEVR INVALID FUNC. FROM SEVER STATE 00000025 IPRCSYNC 37 IPRCSYNC CONN. ESTABLISHED SYNCLVL=NONE 00000026 IPRCSNOP 38 IPRCSNOP INV. SEND FUNC. CODE (IPSENDOP) 00000027 IPRCCENL 39 IPRCCENL INV. CONNECTION EXTENSION LEN. 00000028 IPRCLUNM 40 IPRCLUNM INVALID LU_NAME SPECIFIED 00000029 IPRCMODE 41 IPRCMODE INVALID MODE NAME SPECIFIED 0000002A IPRCIRLN 42 IPRCIRLN INVOKER HAD INVALID LOGICAL RECORD LENG 0000002B IPRCTRLN 43 IPRCTRLN TARGET HAD INVALID LOGICAL RECORD LENGT 0000002C IPRCITRN 44 IPRCITRN INVOKER TRUNCATED LOGICAL RECORD 0000002D IPRCTTRN 45 IPRCTTRN TARGET TRUNCATED LOGICAL RECORD 0000002E IPRCSEVC 46 IPRCSEVC INVALID SEVER CODE SPECIFIED 0000002F IPRCSECR 47 IPRCSECR INVALID SECURITY FIELDS PROVIDED 00000030 IPRCNFCT 48 IPRCNFCT FUNCTION NOT SUPPORTED FOR CSS 00000031 IPRCNSEC 49 IPRCNSEC RESOURCE DOESN'T ACCEPT SECURITY(NONE) 00000032 IPRCALOC 50 IPRCALOC INVALID ALLOCATION DATA PROVIDED 00000033 IPRCFUNL 51 IPRCFUNL INVALID FUNCTION - LOG_DATA PENDING 00000034 IPRCPASS 52 IPRCPASS NO APPCPASS STATEMENT 00000035 IPRCTPLN 53 IPRCTPLN TPN LENGTH IS INVALID 00000036 IPRCTPNI 54 IPRCTPNI TPN INVALID 00000037 IPRCLDLN 55 IPRCLDLN INVALID LOG_DATA LENGTH 00000038 IPRCWAIT 56 IPRCWAIT WAIT=YES FUNCTION TO SELF NOT VALID 00000039 IPRCIPLN 57 IPRCIPLN INVALID LENGTH FOR PIP VARIABLE 0000003A IPRCICSL 58 IPRCICSL INVALID VM COMM SERVER AREA LENGTH 0000003B IPRCIGDS 59 IPRCIGDS INVALID GDS ID WITHIN PIP VARIABLE 0000003C IPRCGDSL 60 IPRCGDSL LENGTHS INVALID FOR PIP VARIABLE 0000003D IPRCNAUT 61 IPRCNAUT Not authorized to specify an ALTID 0000003E IPRCOBUF 62 IPRCOBUF CONTROL AND INTERRUPT BUFFERS OVERLAP 0000003F IPRCILUW 63 IPRCILUW INVALID LUWID LENGTH 00000040 IPRCINET 64 IPRCINET INVALID FULLY QUAL LU NETWORK NAME 00000041 IPRCNLUW 65 IPRCNLUW SYNCLVL=SYNCPT WITH NO LUWID 00000042 IPRCIRES 66 IPRCIRES INVALID RESID WITH PRIORITY=HIGH 00000043 IPRCISYN 67 IPRCISYN INVALID SYNCLVL: SYNCPT+CONFIRM 00000044 IPRCIRST 68 IPRCIRST INVALID FUNCTION FROM RESET STATE 00000045 IPRCIDFR 69 IPRCIDFR INV FUNCTION FROM DEFER_RECEIVE STATE 00000046 IPRCIDFS 70 IPRCIDFS INV FUNCTION FROM DEFER_SEVER STATE 00000047 IPRCIPRP 71 IPRCIPRP INV FUNCT FROM PREPARE_RECEIVED STATE 00000048 IPRCISRC 72 IPRCISRC INV FUNCTION FROM SOLICITED_REQUEST_ COMMIT_RECEIVED STATE 00000049 IPRCIURC 73 IPRCIURC INVALID FUNCTION FROM UNSOLICITED_ REQUEST_COMMIT_RECEIVED STATE 0000004A IPRCICMT 74 IPRCICMT INV FUNCT FROM COMMITTED_RECEIVED STATE 0000004B IPRCIBRV 75 IPRCIBRV INV FUNCT FROM BACKOUT_RECEIVED STATE 0000004C IPRCIBRQ 76 IPRCIBRQ INV FUNCT FROM BACKOUT_REQUIRED STATE 0000004D IPRCBSIP 77 IPRCBSIP SIP ON/OFF INVALID ON NON-SYNCPT PATH 0000004E IPRCISO2 78 IPRCISO2 INVALID VALUE IN IPSNDOP2 OR IPSIPCD 0000004F IPRCSPFU 79 IPRCSPFU INVALID FUNCTION ON SYNCPT PATH 00000050 IPRCLDSP 80 IPRCLDSP APPCVM SEVER WITH LOG DATA IS PENDING 00000051 IPRCISIP 81 IPRCISIP INV FUNCT WHILE SYNCPOINT IN PROGRESS 00000052 IPRCSPSV 82 IPRCSPSV INVALID SEVER CODE DURING SYNCPOINT 00000053 IPRCNSIP 83 IPRCNSIP INV FUNCT UNLESS SYNCPOINT IN PROGRESS 00000054 IPRCNEWL 84 IPRCNEWL PARTNER DOESN'T SUPPORT NEW LUWID 00000055 IPRCIBKR 85 IPRCIBKR RIP INVALID ON BKOUT FROM CURRENT STATE 00000056 IPRCSCTL 86 IPRCSCTL SYNCPT CONNECT BUT NO CONTROL BUFFER 00000057 IPRCKEEP 87 IPRCKEEP KEEP=YES INVALID AFTER PREVIOUS SEVER 00000058 IPRCBACK 88 IPRCBACK SENDBACK/SENDERR INVALID FOR SENDLUW 00000059 IPRCSYNT 89 IPRCSYNT SYNCPT CONNECT TO TSAF NOT ALLOWED 0000005A IPRCRTRY 90 IPRCRTRY FCI MISSED FOR CCS SERV MACHINE 0000005B IPRMCSDA 91 IPRMCSDA VIRT MACHINE CHECK IN SEND DATA AREA 0000005C IPRMCRDA 92 IPRMCRDA VIRT MACHINE CHECK IN RECEIVE DATA AREA 0000005D IPRMCADA 93 IPRMCADA VIRT MACHINE CHECK IN ANSWER DATA AREA 0000005E IPRMCRPA 94 IPRMCRPA VIRT MACHINE CHECK IN REPLY DATA AREA 0000005F IPRCADRF 95 IPRCADRF ADDRESSING/FETCH PROTECTION EXCP IN OUR ADDRESS SPACE (ISFC USES THIS) 00000060 IPRBIGSN 96 IPRBIGSN The send length was larger than that allowed via ISFC. 00000061 IPRBIGRP 97 IPRBIGRP 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' IPCDDFLT DEFAULT SEVER CODE LOG_DATA LENGTH MINIMUMS AND MAXIMUMS .... 1... IPMINLOG 8 IPMINLOG MINIMUM LOG_DATA LENGTH 00IPCODE IPMAXLOG 600 IPMAXLOG MAXIMUM LOG_DATA LENGTH 0004 4 Bitstring 1 IPQCODE IUCV QUERY QRYTYPE=IPQCONN output 00000000 IPQCNNOT 0 IPQCNNOT Path is Not Connected 00000001 IPQCNPND 1 IPQCNPND Path is Connection Pending 00000002 IPQCNCTD 2 IPQCNCTD Path is Connected 00000003 IPQCNSEV 3 IPQCNSEV Path is Severed 0005 5 Bitstring 1 IPQFLAGS IUCV QUERY QRYTYPE=IPQCONN output 1... .... IPQAPPC X'80' IPQAPPC Path is APPC/VM .1.. .... IPQCMSRV X'40' IPQCMSRV Connected to a Comm. Server VM ..1. .... IPQISFC X'20' IPQISFC Connected to SYSTEM (CP ISFC) ...1 .... IPQCPSVC X'10' IPQCPSVC Connected to a CP System Service 0006 6 Bitstring 1 IPFLAGS2 (0) APPC FLAGS 1... .... IPWAIT X'80' IPWAIT WAIT=YES SPECIFIED 1... .... IPINVOKE X'80' IPINVOKE INVOKE THE RESOURCE .1.. .... IPLVLCF X'40' IPLVLCF SENDCNF/SENDCNFD OK ON PATH .1.. .... IPCHGDIR X'40' IPCHGDIR DIRECT=RECEIVE SPECIFIED .1.. .... IPNOFLSH X'40' IPNOFLSH FLUSH=NO SPECIFIED BY PARTNER ..1. .... IPCOMSRV X'20' IPCOMSRV ACTING ON BEHALF OF ANOTHER VM ..1. .... IPPIP X'20' IPPIP PIP=YES FOR RECEIVE ...1 .... IPTYPSVC X'10' IPTYPSVC TYPE=SVC FOR SENDERR ...1 .... IPMAPPED X'10' IPMAPPED MAPPED CONVERSATION .... 1... IPFMH5 X'08' IPFMH5 FMH5 PROVIDED ON CONNECT .... .1.. IPLOGDOK X'04' IPLOGDOK LOG_DATA=YES SPECIFIED .... ..1. IPIMMED X'02' IPIMMED RETURN=IMMED SPECIFIED .... ...1 IPSYNCPT X'01' IPSYNCPT SYNCPT FLOWS ALLOWED ON PATH 0006 6 Bitstring 1 IPWHATRC WHAT RECEIVED CODE 00000000 IPCOMP X'00' IPCOMP FUNCTION COMPLETED NORMALLY 00000001 IPDATA X'01' IPDATA ONLY DATA WAS RECEIVED 00000002 IPSEND X'02' IPSEND INDICATES NOW IN SEND STATE 00000003 IPERROR X'03' IPERROR PARTNER ISSUED SENDERR 00000004 IPCNFRM X'04' IPCNFRM PARTNER ISSUED SENDCNF TYPE=NORM 00000005 IPCNFSEV X'05' IPCNFSEV PARTNER ISSUED SENDCNF TYPE=SEVER 00000006 IPCNFRMD X'06' IPCNFRMD PARTNER ISSUED SENDCNFD 00000008 IPSNORM X'08' IPSNORM PARTNER ISSUED SEVER TYPE=NORMAL 00000009 IPSABEND X'09' IPSABEND PARTNER ISSUED SEVER TYPE=ABEND 0000000B IPALLOCD X'0B' IPALLOCD ALLOCATE DATA BEING RECEIVED 0000000C IPSNDCNF X'0C' IPSNDCNF PARTNER ISSUED SENDCNF TYPE= PREPRECV 0000000D IPLGDATA X'0D' IPLGDATA LOG_DATA WAS RECEIVED 0000000E IPPIPDAT X'0E' IPPIPDAT PIP DATA WAS RECEIVED 0000000F IPPREPAR X'0F' IPPREPAR PREPARE WAS RECEIVED 00000010 IPREQCOM X'10' IPREQCOM REQUEST_COMMIT WAS RECEIVED 00000011 IPCOMMTD X'11' IPCOMMTD COMMITED WAS RECEIVED 00000012 IPFORGET X'12' IPFORGET FORGET WAS RECEIVED 00000013 IPHEURMX X'13' IPHEURMX HEURISTIC_MIXED WAS RECEIVED 00000014 IPBACK X'14' IPBACK BACKOUT WAS RECEIVED 00000015 IPCNFBK X'15' IPCNFBK BACKOUT WAS CONFIRMED 00000016 IPLUWID X'16' IPLUWID NEW_LUWID WAS RECEIVED 000000FF IPSSRCE X'FF' IPSSRCE 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' IPQBFLN QUERY APPC/VM buffer lengths 00000001 IPQCONN X'01' IPQCONN QUERY Connection for IPPATHID 0007 7 Bitstring 1 IPSENDOP SEND OPTION CODE .... ..1. IPSNDRCV X'02' IPSNDRCV SENDDATA RECEIVE=YES REQUESTED .... .111 IPREQSND X'07' IPREQSND SENDREQ REQUESTED .... 1.1. IPRECV X'0A' IPRECV RECEIVE FUNCTION BEING COMPLETED .... 11.. IPPREPRC X'0C' IPPREPRC 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' IPADRPLE REPLY TOO LONG FOR BUFFER .1.. .... IPADSNPX X'40' IPADSNPX PROTECTION EXCEPTION ON SEND BUFF ..1. .... IPADSNAX X'20' IPADSNAX ADDRESSING EXCEPTION ON SEND BUFF ...1 .... IPADANPX X'10' IPADANPX PROTECTION EXCEPTION ANSWER BUFF .... 1... IPADANAX X'08' IPADANAX ADDRESSING EXCEPTION ANSWER BUFF .... .1.. IPADRJCT X'04' IPADRJCT MESSAGE WAS REJECTED .... ..1. IPADPRMD X'02' IPADPRMD REPLY SENT IN PARAMETER LIST .... ...1 IPADPGNR X'01' IPADPGNR MESSAGE PURGED ON SEND OR RECEIVE QUEUE .111 1... IPADMSK1 IPADSNPX+IPADSNAX+IPADANPX+IPADAN AX IPADMSK1 APPC MASK 0009 9 Bitstring 1 IPAUDIT2 AUDIT TRAIL BYTE 2 1... .... IPADRCPX X'80' IPADRCPX PROTECTION EXCEPTION RECEIVE BUFF .1.. .... IPADRCAX X'40' IPADRCAX ADDRESSING EXCEPTION RECEIVE BUFF ..1. .... IPADRPPX X'20' IPADRPPX PROTECTION EXCEPTION REPLY BUFF ...1 .... IPADRPAX X'10' IPADRPAX ADDRESSING EXCEPTION REPLY BUFF .... 1... IPADSVRD X'08' IPADSVRD PATH WAS SEVERED .... .1.. IPADRLST X'04' IPADRLST INVALID RECEIVE/REPLY LIST 1111 .1.. IPADMSK2 IPADRCPX+IPADRCAX+IPADRPPX+IPADRP AX+IPADRLST IPADMSK2 AP MASK OF VALID APPC AUDIT FLAGS 000A 10 Bitstring 1 IPAUDIT3 AUDIT TRAIL BYTE 3 1... .... IPADBLEN X'80' IPADBLEN BAD LENGTH IN SEND BUFFER LIST .1.. .... IPADALEN X'40' IPADALEN INVALID SEND / ANSWER BUFFERLIST SUCH AS BAD ADDRESS OR LENGTH ..1. .... IPADBTOT X'20' IPADBTOT INVALID TOTAL SEND BUFFER LENGTH ...1 .... IPADATOT X'10' IPADATOT INVALID TOTAL SEND ANSWER LENGTH .... 1... IPADTINV X'08' IPADTINV PARTNER=INV. LOG. REC. DATALENG .... .1.. IPADIINV X'04' IPADIINV INVALID LOGICAL RECORD IN DATASTR .... ..1. IPADTTRN X'02' IPADTTRN PARTNER HAS STARTED A SEND BUT TRIED TO GO INTO RECEIVE STATE BEFORE SEND IS FINISHED .... ...1 IPADITRN X'01' IPADITRN 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 IPGDSINV INVLD GDS ID WITHIN PIP VARIABLE 0000003C IPGDSLEN IPRCGDSL IPGDSLEN LENGTHS INVALID FOR PIP VARIABLE SUBFIELD LENGTH OR SUM OF SUBFIELD 0000005B IPMCSNDA IPRMCSDA IPMCSNDA MACHINE CHECK IN SEND DATA AREA 0000005C IPMCRECA IPRMCRDA IPMCRECA MACHINE CHECK IN RECEIVE AREA 0000005D IPMCANSA IPRMCADA IPMCANSA MACHINE CHECK IN ANSWER DATA AREA 0000005E IPMCRPYA IPRMCRPA IPMCRPYA MACHINE CHECK IN REPLY DATA AREA 000000FF IPADMSK4 X'FF' IPADMSK4 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' IPNOPOLL NO REPLIES/MESSAGES TO POLL 0024 36 Bitstring 1 IPSIPFG (0) CURRENT SYNCPT IN PROGRESS FLAG 00000000 IPSIPOFF X'00' IPSIPOFF SYNCPOINT IN PROGRESS FLAG OFF 00000001 IPSIPON X'01' IPSIPON SYNCPOINT IN PROGRESS FLAG IS ON 0024 36 Bitstring 1 IPSIPCD SET/RESET SYNCPT IN PROGRESS FLAG 00000000 IPNONE X'00' IPNONE DO NOT CHANGE SYNCPOINT IN PROG 00000001 IPSIPSET X'01' IPSIPSET SET THE SYNCPOINT IN PROGRESS FLG 00000002 IPSIPRST X'02' IPSIPRST RESET SYNCPOINT IN PROGRESS FLAG 0025 37 Bitstring 1 IPSTATE CURRENT STATE 00000000 IPENDING X'00' IPENDING FUNCTION IS PENDING ON THE PATH 00000001 IPRESET X'01' IPRESET PATH IN RESET STATE 00000002 IPCONNCT X'02' IPCONNCT PATH IN CONNECT STATE 00000003 IPSENDST X'03' IPSENDST PATH IN SEND STATE 00000004 IPRECVST X'04' IPRECVST PATH IN RECEIVE STATE 00000005 IPCONFRM X'05' IPCONFRM PATH IN CONFIRM STATE 00000006 IPSEVER X'06' IPSEVER PATH IN SEVER STATE 00000007 IPDEFRCV X'07' IPDEFRCV PATH IN DEFER_RECEIVE STATE 00000008 IPDEFSVR X'08' IPDEFSVR PATH IN DEFER_SEVER STATE 00000009 IPREPARE X'09' IPREPARE PATH IN PREPARE_RECEIVED STATE 0000000A IPSRQCMT X'0A' IPSRQCMT PATH IN STATE ... SOLICITED_REQUEST_COMMIT_RECEIVED 0000000B IPURQCMT X'0B' IPURQCMT PATH IN STATE ... UNSOLICITED_REQUEST_COMMIT_RECEIV ED 0000000C IPCOMMIT X'0C' IPCOMMIT PATH IN COMMITTED_RECEIVED STATE 0000000D IPBKOUT X'0D' IPBKOUT PATH IN BACKOUT_RECEIVED STATE 0000000E IPBKREQ X'0E' IPBKREQ 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' IPSYCNON INDICATES SYNCLVL=NONE 00000001 IPSYCCNF X'01' IPSYCCNF INDICATES SYNCLVL=CONFIRM 00000002 IPSYCSP X'02' IPSYCSP INDICATES SYNCLVL=SYNCPT 0027 39 Bitstring 1 IPSNDOP2 SEND OPTIONS FLAGE 2 00000003 IPTPSEND X'03' IPTPSEND SEND STATE REQUESTED 00000004 IPTPRECV X'04' IPTPRECV RECEIVE STATE REQUESTED 00000006 IPTPSEVR X'06' IPTPSEVR SEVER STATE REQUESTED 0000000E IPTPBKRQ X'0E' IPTPBKRQ BACKOUT_REQUIRED STATE REQUESTED 0000000F IPTPSVAB X'0F' IPTPSVAB 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
Copyright IBM Corporation, 1990, 2009