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  

Control Block Contents  
   EPLIST DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


EPLIST Prolog

 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


EPLIST DSECT

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

          
*** EPLIST - Extended Parameter List DSECT
*
*     +---------------------------+---------------------------+
*   0 |          EPLCMD           |         EPLARGBG          |
*     +---------------------------+---------------------------+
*   8 |         EPLARGND          |         EPLUWORD          |
*     +---------------------------+---------------------------+
*  10 |         EPARGLST          |         EPFUNRET          |
*     +---------------------------+---------------------------+
*  18 |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
*
*** EPLIST - Extended Parameter List DSECT

 

EPLIST Cross Reference

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 V6R1.0.
Last updated on 23 Oct 2009 at 11:00:57 EDT.
Copyright IBM Corporation, 1990, 2008