EPLIST Back to Index page
 
Prolog 
Control Block Contents 
   EPLIST DSECT
Storage Layout 
Cross Reference (Contains links to field and bit definitions)
Programming Interface Information:
This page documents intended Programming Interfaces that
allow the customer to write programs to obtain the services of z/VM.


  EPLIST Prolog Top of page
 
 NAME       : EPLIST
 DESCRIPTION: Extended Parameter List DSECT
 DSECT      : EPLIST
 FUNCTION   : EPLIST maps the extended parameter list passed
              between modules. EPLIST is found in the EPLIST
              macro.
 
 
  EPLIST Control Block Content Top of page
 

 EPLIST DSECT Top of page
Hex Dec Type/Val Lng Label (dup) Comments ---- ---- --------- ---- -------------- -------- 0000 0 Structure EPLIST Extended Parameter List DSECT 0000 0 Address 4 EPLCMD ADDRESS OF COMMAND TOKEN. 0004 4 Address 4 EPLARGBG ADDR OF BEGINNING OF ARGUMENTS. 0008 8 Address 4 EPLARGND ADDR OF END OF ARGUMENTS. 000C 12 Address 4 EPLUWORD USER WORD 00000010 EPL4LNBY *-EPLIST 4 WORD HEADER LENGTH IN BYTES 00000002 EPL4LNDW (*-EPLIST+7)/8 4 WORD HEADER LENGTH IN DWORDS 0010 16 Address 4 EPARGLST ADDRESS OF FUNCTION ARGUMENT LIST. 0014 20 Address 4 EPFUNRET ADDRESS FOR RETURN OF FUNCTION DATA. 00000018 EPL6LNBY *-EPLIST 6 WORD HEADER LENGTH IN BYTES 00000003 EPL6LNDW (*-EPLIST+7)/8 6 WORD HEADER LENGTH IN DWORDS 0018 24 Address 4 * (2) PADDING (FOR USE WITH SCAN MACRO) 0020 32 Character 8 EPLSCANT (0) BEGINNING OF TOKENIZED PLIST BUILT BY SCAN MACRO. 0000000C EPLRSRVD EPLUWORD,4,C'A' (OLD NAME, FOR COMPATIBILITY) THE EXTENDED PLIST FLAGS INDICATE THE PRESENCE OF AN EXTENDED PLIST IN REGISTER 0. THE HIGH ORDER BYTE OF REGISTER 1 WILL CONTAIN EITHER EPLCMDFL OR EPLFNCFL TO INDICATE THE EXTENDED PLIST IS AVAILABLE. ONLY THE FIRST 4 WORDS OF THE EXTENDED PLIST ARE AVAILABLE WITH THESE CODES. IF THE HIGH ORDER BYTE OF REGISTER 1 CONTAINS EPFUNSUB, THEN THE INVOCATION IS AN EXTERNAL FUNCTION/SUBROUTINE CALL FROM REX. WITH THIS PLIST, ALL 6 WORDS OF THE PLIST ARE AVAILABLE. WORD 5 POINTS TO A LIST OF DOUBLE WORD ADLENS (ADDRESS-LENGTH PAIRS) WHICH DESCRIBE THE ARGUMENTS TO THE ROUTINE (EPARGLST). WORD 6 (EPFUNRET) IS THE LOCATION FOR THE CALLED ROUTINE TO STORE THE ADDRESS OF AN EVALBLOK TO RETURN DATA TO THE CALLING PROGRAM. .... 1.11 EPLCMDFL X'0B' EXTENDED PLIST AVAILABLE FLAG. .... ...1 EPLFNCFL X'01' EXTENDED PLIST AVAILABLE FLAG. .... .1.1 EPFUNSUB X'05' EXTERNAL FUNCTION PLIST AVAILABLE FLAG DEFINITIONS. EXCEPT AS NOTED, ONLY THE FIRST FOUR WORDS OF THE EXTENDED PLIST ARE AVAILABLE. EPLIST FLAG VALUE AVAIL? MEANING .... .... EPLFPROG X'00' N PROGRAM .... ...1 EPLFCMND X'01' Y ADDRESS COMMAND .... ..1. EPLFSBCM X'02' Y SUBCOM .... ..11 EPLFNNUE X'03' Y NO NUCEXT, EXTENDED .... .1.. EPLFNNUT X'04' N NO NUCEXT, TOKENIZED .... .1.1 EPLFRXFN X'05' Y REXX EXTERNAL FUNCTION, 6 WORD EXTENDED PLIST PRESENT .... .11. EPLFIMMD X'06' Y IMMEDIATE COMMAND .... 1.11 EPLFSRCH X'0B' Y COMMAND SEARCH ...1 .... EPLFEXEC X'10' N INVOKED BY BPX1EXC 1111 111. EPLFENDC X'FE' N END OF COMMAND 1111 1111 EPLFABEN X'FF' N ABEND OR NUCXDROP
 
 
  EPLIST Storage Layout Top of page
 
          
*** EPLIST - Extended Parameter List DSECT
*
*     +---------------------------+---------------------------+
*   0 |          EPLCMD           |         EPLARGBG          |
*     +---------------------------+---------------------------+
*   8 |         EPLARGND          |         EPLUWORD          |
*     +---------------------------+---------------------------+
*  10 |         EPARGLST          |         EPFUNRET          |
*     +---------------------------+---------------------------+
*  18 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*
*** EPLIST - Extended Parameter List DSECT
 
 
  EPLIST Cross Reference Top of page
 
 
Symbol         Dspl Value
-------------- ---- -----
EPARGLST       0010
EPFUNRET       0014
EPFUNSUB       0020 05
EPLARGBG       0004
EPLARGND       0008
EPLCMD         0000
EPLCMDFL       0020 0B
EPLFABEN       0020 FF
EPLFCMND       0020 01
EPLFENDC       0020 FE
EPLFEXEC       0020 10
EPLFIMMD       0020 06
EPLFNCFL       0020 01
EPLFNNUE       0020 03
EPLFNNUT       0020 04
EPLFPROG       0020 00
EPLFRXFN       0020 05
EPLFSBCM       0020 02
EPLFSRCH       0020 0B
EPLRSRVD       0020 0000000C
EPLSCANT       0020
EPLUWORD       000C
EPL4LNBY       000C 00000010
EPL4LNDW       000C 00000002
EPL6LNBY       0014 00000018
EPL6LNDW       0014 00000003
 
This information is based on z/VM 7.2.0 Last updated on 24 Jun 2020 at 09:36:23 EDT.
Copyright IBM Corporation, 1990, 2020